数字控件

此功能仍处于实验阶段。“实验性”意味着这是一个早期的实施,可能会发生重大的突破性变化。

NumberControl是一种增强的HTML输入[type=“number]元素。

用法

从“@wordpress/components”导入{__terialNumberControl作为NumberControl};常量示例=()=>{const[value,setValue]=使用状态(10);返回(<数字控制isShiftStepEnabled={true}onChange={setValue}shiftStep={10}value={value}/>);};

道具

拖动方向

确定拖动轴以增加/减少值。
使用说明:n个|e(电子)||w个

  • 类型:字符串
  • 必需:否
  • 违约:n个

拖动阈值

如果已启用拖动是真的,这控制了二甲苯在值更改之前已被拖动。

  • 类型:编号
  • 必需:否
  • 违约:10

自旋控件

要显示的旋转控件的类型。这些按钮允许用户
快速增加和减少数字。

  • “无”–不显示旋转控件。
  • “本机”–使用浏览器的本机HTML输入控制。
  • “自定义”–使用加号和减号图标按钮。
    • 类型:字符串
    • 必需:否
    • 违约:“本地”

已启用拖动

如果为true,则启用鼠标拖动手势以增加/减少数值。霍尔丁SHIFT(轮班)而拖动将使值增加shiftStep(换档步骤).

  • 类型:布尔值
  • 必需:否

ShiftStep已启用

如果为true,请按向上向下以及SHIFT(轮班)键将按shiftStep(换档步骤)值。

  • 类型:布尔值
  • 必需:否
  • 违约:真的

标签

如果添加此属性,将使用label属性作为内容生成标签。

  • 类型:字符串
  • 必需:否

标签位置

标签的位置(顶部,,底部,或边缘).

  • 类型:字符串
  • 必需:否

最大值

最大值价值允许。

  • 类型:编号
  • 必需:否
  • 违约:无穷

最小值

最小值价值允许。

  • 类型:编号
  • 必需:否
  • 违约:-无限

onChange(更改时)

只要输入值更改,就会触发回调。

回调收到两个参数:

  1. newValue(新值):输入的新值
  2. 额外的:对象包含,在事件键,原始浏览器事件。

注意,作为回调的第一个参数接收的值是保证为有效值(例如,它可能超出[最小值,最大值]道具,或与)。为了检查值的有效性,请检查事件。目标?。有效性有效属性。

  • 类型:(newValue,extra)=>无效
  • 必需:否

必修的

如果真的在控件的最小/最大范围内强制使用有效数字。如果允许使用空字符串作为有效值。

  • 类型:布尔值
  • 必需:否
  • 违约:

shiftStep(换档步骤)

SHIFT(轮班)按键被按住。该偏移值是值。例如,如果值为5、和shiftStep(换档步骤)10,每个跳转将增加/减少50.

  • 类型:编号
  • 必需:否
  • 违约:10

金额价值递增/递减时发生更改。这也是验证中的一个因素价值必须是的倍数(偏移量为最小值(如有规定)有效。接受特殊字符串值任何这将使验证约束无效,并导致步进操作增加/减少1.

  • 类型:数字|“any”
  • 必需:否
  • 违约:1