数字输入框 (IntegerField)

数字输入框用于输入整数数值。

基本用法

gui_config.add_argument(
    "integer",
    metavar="数字整数框",
    help="只能输入整数",
    type=int,
    default=1,
    widget="IntegerField",
    validate="integer_verify",
    gooey_options={
        "min": 0,  # 最小值
        "max": 100,  # 最大值
        "step": 1,  # 步长
        "stepStrictly": False,  # 是否只能输入步长的倍数
        "controls": True,  # 是否显示控制按钮
        "controlsPosition": "right",  # 控制按钮位置
        "placeholder": "请输入整数",  # 占位文本
        "size": "large"
    }
)

属性

属性名	说明	类型	默认值
min	允许的最小值	number	-
max	允许的最大值	number	-
step	步长	number	1
stepStrictly	是否只能输入步长的倍数	boolean	false
controls	是否显示控制按钮	boolean	true
controlsPosition	控制按钮位置	string	'right'
placeholder	输入框占位文本	string	-
size	输入框大小	string	'default'

使用场景

数字输入框适用于需要用户输入整数值的场景，例如：

• 数量输入
• 年龄输入
• 分数或等级输入
• 计数值设置

最佳实践

1. 设置合理的最小值和最大值，限制用户输入范围
2. 使用步长控制数值的精度和增减量
3. 对于较大范围的数值，可以关闭 stepStrictly 以允许用户直接输入
4. 对于需要精确控制的数值，可以启用 stepStrictly 限制为步长的倍数

与浮点数输入框的区别

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

• 数字输入框只能输入整数值，不支持小数
• 使用时需要设置 type=int 参数
• 步长默认为1，适合整数增减