浮点数输入框 (DecimalField)

浮点数输入框用于输入小数。

基本用法

gui_config.add_argument(
    "decimal",
    metavar="数字浮点框",
    help="只能输入浮点数",
    default=0.1,
    widget="DecimalField",
    gooey_options={
        "min": -5.0,  # 最小值
        "max": 5.0,  # 最大值
        "step": 0.1,  # 步长
        "precision": 2,  # 精度，小数位数
        "controls": True,  # 是否显示控制按钮
        "placeholder": "请输入浮点数",  # 占位文本
        "size": "large"
    }
)

属性

属性名	说明	类型	默认值
min	允许的最小值	number	-
max	允许的最大值	number	-
step	步长	number	0.1
precision	精度，小数位数	number	2
controls	是否显示控制按钮	boolean	true
placeholder	输入框占位文本	string	-
size	输入框大小	string	'default'

使用场景

浮点数输入框适用于需要用户输入带小数的数值的场景，例如：

• 金额输入
• 价格设置
• 百分比输入
• 科学计算中的浮点数值
• 尺寸、重量等物理量

最佳实践

1. 设置合理的精度(precision)，避免小数位数过多导致用户困惑
2. 设置适当的步长(step)，使增减按钮的调整更加合理
3. 设置最小值和最大值，限制用户输入在合理范围内
4. 对于金融相关的输入，建议精度设置为2，符合货币习惯

与整数输入框的区别

浮点数输入框(DecimalField)与整数输入框(IntegerField)的主要区别在于：

• 浮点数输入框可以输入小数
• 需要通过precision属性控制小数位数
• 默认步长通常为0.1，适合小数增减