数字输入#

这个元素是基于Quasar框架中的QInput组件。

你可以使用validation参数来定义一个验证规则的字典,例如{'Too small!': lambda value: value < 3}。第一个失败的规则的键将作为错误消息显示。或者,你可以传递一个返回可选错误消息的可调用对象。要禁用每次值更改时的自动验证,你可以使用without_auto_validation方法。

  • label: 数字输入的显示名称

  • placeholder: 如果没有输入值,显示的文本

  • value: 字段的初始值

  • min: 允许的最小值

  • max: 允许的最大值

  • precision: 允许的小数位数(默认:无限制,负数:小数点前的位数)

  • step: 步进按钮的步进大小

  • prefix: 在显示值前添加的前缀

  • suffix: 在显示值后添加的后缀

  • format: 用于格式化显示值的字符串,如 "%.2f"

  • on_change: 当值改变时执行的回调函数

  • validation: 验证规则的字典或返回可选错误消息的可调用对象

from nicegui import ui

ui.number(label='Number', value=3.1415927, format='%.2f',
          on_change=lambda e: result.set_text(f'you entered: {e.value}'))
result = ui.label()

# ui.run()

clearable#

clearable 属性是 Quasar 框架中的一个特性,它为输入框添加了一个清除按钮,用于清空文本。

from nicegui import ui

i = ui.number(value=42).props('clearable')
ui.label().bind_text_from(i, 'value')

# ui.run()
<nicegui.elements.label.Label at 0x7f1d50997610>

小数点后位数#

你可以使用 precision 参数来指定小数位数。负值表示小数点前的位数。当输入失去焦点、当像 minmaxprecision 这样的清理参数发生变化,或者当手动调用 sanitize() 函数时,会进行四舍五入。

from nicegui import ui

n = ui.number(value=3.14159265359, precision=5)
n.sanitize()

# ui.run()