工具栏按钮

ToolbarButton可用于向工具栏添加操作,通常位于工具栏工具栏组用于创建通用接口时。如果使用它将控件添加到自定义块中,则应考虑使用块控件.

它与按钮组件。使用工具栏按钮将确保工具栏中按钮的样式正确,并且工具栏中的键盘交互与WAI-ARIA工具栏模式.

用法

要创建通用接口,您需要在工具栏组件。

从“@wordpress/components”导入{Toolbar,ToolbarButton};从“@wordpress/icons”导入{edit};函数MyToolbar(){返回(<工具栏标签=“选项”><工具栏按钮icon={edit}label=“编辑”onClick={()=>警报(“编辑”)}/></工具栏>);}

内部块控件

如果正在处理自定义块,并且希望将控件添加到块工具栏,则应使用块控件而不是。可选地将其包装为工具栏组.

从“@wordpress/block-editor”导入{BlockControls};从“@wordpress/components”导入{ToolbarGroup,ToolbarButton};从“@wordpress/icons”导入{edit};函数Edit(){返回(<块控制><工具栏组><工具栏按钮icon={edit}label=“编辑”onClick={()=>警报(“编辑”)}/></工具栏组></块控制>);}

道具

此组件接受按钮的相同API除以下部件外:

容器类名:一串

要应用于按钮容器的可选附加类名。

  • 必需:否

下标:一串

按钮的可选下标。

  • 必需:否
  • 如果要实现控件以选择分组为图标按钮的选项,可以使用工具栏组件,它已经处理了此策略。
  • ToolbarButton可以与其他元素一起使用,例如下拉菜单在弹出菜单中显示选项。