基本控制

基本控制是用于为处理用户输入的组件生成标签和帮助文本的组件。

用法

从“@wordpress/components”导入{BaseControl,使用BaseControlProps};//为文本区域输入呈现“BaseControl”const MyCustomTextareaControl=({children,…baseProps})=>(//“useBaseControlProps”是一个方便的钩子,用于获取“BaseControl”的道具`//以及内部控制本身。也就是说,它负责生成唯一的“id”,//将其与“label”和“help”元素正确关联。const{baseControlProps,controlProps}=使用基本控制属性(baseProps);返回(<BaseControl{…baseControlProps}__nextHasNoMarginBottom={true}><文本区域{…controlProps}>{子}</text区域></BaseControl(基本控制)>););

道具

组件接受以下道具:

身份证件

HTML身份证件控件元素的基本控制)正在为其生成标签和帮助文本。这是必要的,以方便地将标签与该元素关联。

建议使用使用基本控制属性hook,它负责生成唯一的身份证件为你。否则,如果您选择传递显式身份证件对于这个道具,您负责确保身份证件.

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

标签

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

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

隐藏标签来自视觉

如果为true,标签将仅对屏幕阅读器可见。

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

帮助

控件的附加说明。包含描述的元素将通过一个咏叹调描述人属性。

  • 类型:反应节点
  • 必需:否

类名

要添加到包装器div的任何其他类。

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

儿童

要在BaseControl中显示的内容。

  • 类型:元素
  • 必需:是

__next无边距底部

开始选择新的无边距样式,这将成为未来版本的默认样式。

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

基本控制。可视化标签

基本控制。可视标签用于在基本控制组件。

它应该只在BaseControl中呈现的子对象已经可以使用标签的情况下使用,例如按钮,但我们希望为该部分添加一个与标签等效的视觉标签基本控制如果标签道具通过了。

用法

从“@wordpress/components”导入{BaseControl};const MyBaseControl=()=>(<BaseControl help=“此按钮已贴上标签。”><基本控制。VisualLabel>作者</BaseControl。视觉标签><Button>选择作者</Button></BaseControl(基本控制)>);

道具

类名

要添加到包装器div的任何其他类。

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

儿童

要在中显示的内容基本控制。可视标签.

  • 类型:元素
  • 必需:是