# @elementor/editor-floating-panels 中文文档

规范地址：https://npmcn.com/package/%40elementor/editor-floating-panels/

版本：4\.4\.1
npm 元数据更新时间：2026-11-16T15:12:07.734Z
中文译文更新时间：2026-11-16T15:17:30.625Z
软件包许可：GPL-3\.0-or-later

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40elementor/editor-floating-panels
原文对照：https://npmcn.com/package/%40elementor/editor-floating-panels/?lang=original
项目主页：https://elementor.com/
源码仓库：https://github.com/elementor/elementor

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：339 kB，42 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：8 个
- peer 依赖：react ^18\.3\.1，react-dom ^18\.3\.1
- 首次发布：2026-07-06T10:19:08.748Z
- 最新版本发布：2026-11-16T15:12:07.379Z
- 近 30 天下载量：7562（2026-10-14 至 2026-11-12，npm 官方下载统计）
- 已发布版本数：223（近 12 个月 223 个）

## 中文简介

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

## 安装

```sh
npm install @elementor/editor-floating-panels
```

也可以使用：`pnpm add @elementor/editor-floating-panels`、`yarn add @elementor/editor-floating-panels`、`bun add @elementor/editor-floating-panels`

## README

# 编辑器浮动面板

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

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

## 使用量

```ts
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-start` | `insetInlineStart`, (中文(简体) ), `insetBlockStart` | `{ insetInlineStart: 24, insetBlockStart: 80 }` |
| `block-start-inline-end` | `insetInlineEnd`, (中文(简体) ), `insetBlockStart` | `{ insetInlineEnd: 24, insetBlockStart: 80 }` |
| `block-end-inline-start` | `insetInlineStart`, (中文(简体) ), `insetBlockEnd` | `{ insetInlineStart: 24, insetBlockEnd: 80 }` |
| `block-end-inline-end` | `insetInlineEnd`, (中文(简体) ), `insetBlockEnd` | `{ insetInlineEnd: 24, insetBlockEnd: 80 }` |

右下锁定示例 :

```ts
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 是什么？

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

### 如何安装 @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 和提交记录判断。

