块编辑器开发文档

💡 云策文档标注

概述

ToolbarGroup 是 WordPress 组件库中的一个组件,用于在 Toolbar 内创建控件子组,帮助组织和管理工具栏按钮。

关键要点

  • ToolbarGroup 用于在 Toolbar 中分组控件,如按钮,提升界面组织性。
  • 它接受所有 HTML 属性,并传递给底层元素,便于自定义样式和行为。
  • ToolbarGroup 的子组件可以是 ToolbarButton 或 ToolbarItem,支持灵活组合。

代码示例

import { Toolbar, ToolbarGroup, ToolbarButton } from '@wordpress/components';
import { paragraph, formatBold, formatItalic, link } from '@wordpress/icons';

function MyToolbar() {
    return (
        <Toolbar label="Options">
            <ToolbarGroup>
                <ToolbarButton icon={ paragraph } label="Paragraph" />
            </ToolbarGroup>
            <ToolbarGroup>
                <ToolbarButton icon={ formatBold } label="Bold" />
                <ToolbarButton icon={ formatItalic } label="Italic" />
                <ToolbarButton icon={ link } label="Link" />
            </ToolbarGroup>
        </Toolbar>
    );
}

📄 原文内容

A ToolbarGroup can be used to create subgroups of controls inside a Toolbar.

Usage

import { Toolbar, ToolbarGroup, ToolbarButton } from '@wordpress/components';
import { paragraph, formatBold, formatItalic, link } from '@wordpress/icons';

function MyToolbar() {
    return (
        <Toolbar label="Options">
            <ToolbarGroup>
                <ToolbarButton icon={ paragraph } label="Paragraph" />
            </ToolbarGroup>
            <ToolbarGroup>
                <ToolbarButton icon={ formatBold } label="Bold" />
                <ToolbarButton icon={ formatItalic } label="Italic" />
                <ToolbarButton icon={ link } label="Link" />
            </ToolbarGroup>
        </Toolbar>
    );
}

Props

ToolbarGroup will pass all HTML props to the underlying element.

Related components