@elementor/editor-panels

中文文档
4.4.1发布于 2026/11/16GPL-3.0-or-laterTypeScriptESM + CJS构建来源已验证近 30 天下载 1.3万

[!WARNING] > This package is under development and not ready for production use.

原始使用文档

Editor Panels

[!WARNING] This package is under development and not ready for production use.

Usage

Creating panel contains 3 steps:

  1. Creating the panel component
// components/my-panel.tsx
import { Panel, PanelHeader, PanelHeaderTitle, PanelBody } from '@elementor/editor-panels';

export default function MyPanel() {
    return (
        <Panel>
            <PanelHeader>
                <PanelHeaderTitle>{ /* Panel title */ }</PanelHeaderTitle>
            </PanelHeader>
            <PanelBody>
                { /* Here should be all the content of the panel */ }
            </PanelBody>
        </Panel>
    );
}
  1. Creating an instance of the panel
// panel.ts
import { createPanel } from '@elementor/editor-panels';
import MyPanel from './components/my-panel';

export const {
    panel,
    usePanelStatus,
    usePanelActions,
} = createPanel( {
    id: 'my-panel',
    component: MyPanel
} );
  1. Registering the panel
// init.ts
import { registerPanel } from '@elementor/editor-panels';
import { panel } from './panel';

function init() {
    registerPanel( panel );
}
// index.ts
import init from './init';

init();

Using panel actions and state

To change or read the state of a panel (open/close), you can use 2 hooks that are being returned from the createPanel() function. Let's assume that we have a button that should open the panel when clicked, and close it when clicked again.

// components/my-panel-button.tsx
import { usePanelStatus, usePanelActions } from '../panel';

export default function MyPanelButton() {
    const { isOpen, isBlocked } = usePanelStatus();
    const { open, close } = usePanelActions();

    return (
        <button onClick={ isOpen ? close : open } disabled={ isBlocked }>
            { isOpen ? 'Close panel' : 'Open panel' }
        </button>
    );
}

版本与发布记录

@elementor/editor-panels 共发布 1,155 个版本,首次发布于 2023/06/11;过去 12 个月发布了 858 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
4.4.1latest2026/11/16今天
4.5.0-1192build2026/11/16今天
4.5.0-11912026/11/16今天
4.5.0-11902026/11/16今天
4.5.0-11892026/11/16今天
4.5.0-11882026/11/151 天前

其他发布通道:manual → 4.1.0-manual,4.2-beta1 → 4.2.0-beta1,beta → 4.4.0-beta3,build → 4.5.0-1192。

关于 @elementor/editor-panels 的常见问题

@elementor/editor-panels 是什么?

[!WARNING] > This package is under development and not ready for production use.

如何安装 @elementor/editor-panels?

在项目目录运行 npm install @elementor/editor-panels,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:react(^18.3.1)、react-dom(^18.3.1)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@elementor/editor-panels 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@elementor/editor-panels 支持 ESM 还是 CommonJS?

同时提供 ES Module 与 CommonJS 入口,import 和 require() 都可以使用,打包工具会自动选择合适的版本。

@elementor/editor-panels 可以商用吗?

@elementor/editor-panels 使用 GPL-3.0-or-later 许可。强 Copyleft:分发包含该代码的软件时,整个作品需以 GPL-3.0 兼容许可开源,并附带专利与反锁定条款。仅内部使用不触发此义务。以上为概括,不构成法律意见,请以许可原文为准。

@elementor/editor-panels 的下载量有多少?

根据 npm 官方下载统计,@elementor/editor-panels 在 2026/10/14 – 2026/11/12 这 30 天内被下载 12,653 次,日均约 422 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@elementor/editor-panels 还在维护吗?

最新版本 4.4.1 发布于 2026/11/16(今天);至今共发布 1155 个版本,其中过去 12 个月发布了 858 个;首次发布于 2023/06/11。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。