编辑器浮动面板
元素编辑器的通用浮动面板框架,为画布上渲染面板提供原始. 面板可以在取景口内被自由拖取并调整尺寸,而不受任何具体特征关注.
面板被粘住,幸存的重载。 国家将打开/关闭、位置、大小和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-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 } |
右下锁定示例 :
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 呼叫,以注册切片,同步持续状态,并将主机挂入编辑器的顶部位置.