@elementor/editor-floating-panels

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

元素编辑器的通用浮动面板框架,为画布上渲染面板提供原始. 面板可以在取景口内被自由拖取并调整尺寸,而不受任何具体特征关注.

中文使用文档
文档目录6 节
  1. 使用量
  2. isDraggable
  3. isResizable
  4. isDocked
  5. keepMounted
  6. defaults

编辑器浮动面板

元素编辑器的通用浮动面板框架,为画布上渲染面板提供原始. 面板可以在取景口内被自由拖取并调整尺寸,而不受任何具体特征关注.

面板被粘住,幸存的重载。 国家将打开/关闭、位置、大小和z-index存储在 localStorage。 。 。 .

使用量

import {
    createFloatingPanel,
    init,
    registerFloatingPanel,

    FloatingPanelBody,
    FloatingPanelFooter,
    FloatingPanelHeader,
} from '@elementor/editor-floating-panels';

init();

const myPanel = createFloatingPanel( {
    id: 'my-panel',
    title: 'My Panel',
    icon: MyIcon,
    component: MyPanelComponent,
    isDraggable: true,
    isResizable: true,
    defaults: {
        width: 320,
        height: 480,
        minWidth: 240,
        minHeight: 320,
        corner: 'block-start-inline-start',
        initialPosition: {
            insetBlockStart: 80,
            insetInlineStart: 200
        },
    },
} );

registerFloatingPanel( myPanel.panel );

function MyPanelComponent() {
    return (
        <>
            <FloatingPanelHeader
                panelId="my-panel"
                title="My Panel"
                actions={ [ /* ... */ ] }
            />
            <FloatingPanelBody>
                { /* ... */ }
            </FloatingPanelBody>
            <FloatingPanelFooter>
                { /* ... */ }
            </FloatingPanelFooter>
        </>
    );
}

isDraggable

何时 isDraggable 实值 true,面板头可以充当拖动柄——用户可以自由地将面板重新定位. 何时 false (默认),信头在不拖动互动的情况下制作,面板留在其上 initialPosition (见 defaults.initialPosition) (中文(简体) ).

通过程序定位 setPosition 从 useFloatingPanelActions 无论工作 isDraggable。 。 。 .

isResizable

何时 isResizable 实值 true在面板上渲染出边缘和角大小调整的手柄——用户可以在取景口和定义的最小值范围内自由调整手柄大小 defaults (单位:千美元)minWidth 编号 : minHeight) (中文(简体) ). 何时 false (默认),不调整控件大小,且面板保持已宣布或持续大小.

程序大小 setSize 从 useFloatingPanelActions 无论工作 isResizable。 。 。 .

isDocked

何时 isDocked 实值 true,面板被固定在内侧端,只要它开放,导航器在停靠时也是一样。 它使用它的宽度和上行栏下的全部高. 编辑器缩小了宽度 内缘可被拖取来改变宽度. 宽度是跨重载的。 面板不能移动或被拆除,而且 isDraggable 或者说 isResizable 不添加浮控。 关闭面板后隐藏并返回宽度到画布上. 省略后,面板会保留上个浮动行为.

keepMounted

何时 keepMounted 实值 true,关闭面板后隐藏并保留其组件。 当面板主机为必须保持会话的 Iframe 时使用 。 省略或 false中,关闭面板卸载组件.

openFloatingPanel( id ) 财务报告和审定财务报表 closeFloatingPanel( id ) 打开并关闭外部的注册面板 React.

defaults

defaults 需要并定义面板的初始尺寸和(可选的)其初始位置.

外地目的
width初始面板宽度( 像素).
height初始面板高 (像素).
minWidth面板最小宽度可以调整为.
minHeight面板最小高度可以调整为.
corner (可选)视港角锚. 一个 block-start-inline-start, (中文(简体) ), block-start-inline-end, (中文(简体) ), block-end-inline-start, (中文(简体) ), block-end-inline-end默认 : block-start-inline-start。 。 。 .
initialPosition (可选)两个相匹配的插件上的偏移 corner. 只在不存在持续立场时使用。 其他密钥被忽略 .

尺寸使用物理名称( E)width编号 :height),因为 Elementor 只在水平写入模式下制作. 位置使用逻辑内置名称,因为它是方向敏感(如RTL).

LogicalPosition 存储全部四个插件( e)insetInlineStart, (中文(简体) ), insetInlineEnd, (中文(简体) ), insetBlockStart, (中文(简体) ), insetBlockEnd) (中文(简体) ). 只匹配对 corner 用于渲染和交互; 非活动内设为 0。 。 。 .

corner活动设置默认 initialPosition
block-start-inline-startinsetInlineStart, (中文(简体) ), insetBlockStart{ insetInlineStart: 24, insetBlockStart: 80 }
block-start-inline-endinsetInlineEnd, (中文(简体) ), insetBlockStart{ insetInlineEnd: 24, insetBlockStart: 80 }
block-end-inline-startinsetInlineStart, (中文(简体) ), insetBlockEnd{ insetInlineStart: 24, insetBlockEnd: 80 }
block-end-inline-endinsetInlineEnd, (中文(简体) ), insetBlockEnd{ insetInlineEnd: 24, insetBlockEnd: 80 }

右下锁定示例 :

defaults: {
    width: 360,
    height: 600,
    minWidth: 280,
    minHeight: 400,
    corner: 'block-end-inline-end',
    initialPosition: {
        insetBlockEnd: 80,
        insetInlineEnd: 24
    },
}

当持续状态存在时 position, (中文(简体) ), corner,以及 size 覆盖 initialPosition, (中文(简体) ), corner, (中文(简体) ), width,以及 height。调整最小尺寸(minWidth编号 :minHeight)总是来源于 defaults。 。 。 .

打电话 init() 一次在编辑靴子, 在此之前 任意 createFloatingPanel 呼叫,以注册切片,同步持续状态,并将主机挂入编辑器的顶部位置.

版本与发布记录

@elementor/editor-floating-panels 共发布 223 个版本,首次发布于 2026/07/06;过去 12 个月发布了 223 个版本。最新版本附带 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 天前

其他发布通道:beta → 4.4.0-beta3,build → 4.5.0-1192。

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

@elementor/editor-floating-panels 是什么?

元素编辑器的通用浮动面板框架,为画布上渲染面板提供原始. 面板可以在取景口内被自由拖取并调整尺寸,而不受任何具体特征关注.

如何安装 @elementor/editor-floating-panels?

在项目目录运行 npm install @elementor/editor-floating-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-floating-panels 支持 TypeScript 吗?

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

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

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

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

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

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

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

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

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