云策 WordPress 开发者社区

块编辑器开发文档

PluginBlockSettingsMenuItem

查看官方原文 ↗
💡 云策文档标注

概述

PluginBlockSettingsMenuItem 是一个用于在 WordPress 区块编辑器的“更多选项”区域添加新菜单项的组件。它允许开发者自定义菜单项，根据用户设置显示在区块控制区或顶部工具栏中。

关键要点

  • PluginBlockSettingsMenuItem 用于扩展区块设置菜单，支持添加自定义菜单项。
  • 菜单项的位置取决于用户设置，可出现在区块控制区或顶部工具栏。
  • 通过 allowedBlocks 属性可以限制菜单项仅对特定区块类型生效。

代码示例

import { registerPlugin } from '@wordpress/plugins';
import { PluginBlockSettingsMenuItem } from '@wordpress/editor';

const PluginBlockSettingsMenuGroupTest = () => (
    <PluginBlockSettingsMenuItem
        allowedBlocks={ [ 'core/paragraph' ] }
        icon="smiley"
        label="Menu item text"
        onClick={ () => {
            alert( 'clicked' );
        } }
    />
);

registerPlugin( 'block-settings-menu-group-test', {
    render: PluginBlockSettingsMenuGroupTest,
} );
📄 原文内容

This slot allows for adding a new item into the More Options area.
This will either appear in the controls for each block or at the Top Toolbar depending on the users setting.

Example

import { registerPlugin } from '@wordpress/plugins';
import { PluginBlockSettingsMenuItem } from '@wordpress/editor';

const PluginBlockSettingsMenuGroupTest = () => (
    <PluginBlockSettingsMenuItem
        allowedBlocks={ [ 'core/paragraph' ] }
        icon="smiley"
        label="Menu item text"
        onClick={ () => {
            alert( 'clicked' );
        } }
    />
);

registerPlugin( 'block-settings-menu-group-test', {
    render: PluginBlockSettingsMenuGroupTest,
} );

Location

Location