固定面板 layout-fixed-panel
2026年7月20日大约 3 分钟
固定面板 layout-fixed-panel
定位容器,把内容钉在指定位置 / 尺寸。
- 类型串:
layout-fixed-panel默认尺寸:[400, 300]分类:布局
实时预览
下面渲染的是真实组件(与编辑器 / 运行时同源)。修改右侧「样式参数」,左侧预览实时更新;点击底部「全页面查看」可放大。
属性
下表为本组件特有的属性;
position/size/opacity/background/border/ 联动选中 / 筛选等通用参数见组件手册总览。
basic
| 属性 | 名称 | 类型 | 默认 | 说明 |
|---|---|---|---|---|
fluid-justify-content | 主轴对齐 | select | flex-start | 可选:flex-start / flex-end / center / space-around / space-between / space-evenly |
fluid-align-items | 交叉轴对齐 | select | flex-start | 可选:flex-start / center / flex-end / stretch |
fluid-gap-value | 间隙 | number(min=0,unit=px) | 0 | |
children-no-events | 内部组件穿透 | boolean | false | |
child-state-follow | 内部组件状态跟随 | boolean | false | |
child-select-exclusive | 内部组件选中互斥 | boolean | false | |
canvas-grow | 随画布增长 | select(radioGroup) | reflow | 页面开「自动填充剩余空间」时:reflow 吃满剩余空间 / scale 保持设计比例 |
scrollbar
| 属性 | 名称 | 类型 | 默认 | 说明 |
|---|---|---|---|---|
show-scrollbar | 显示滚动条 | boolean | false | |
scrollbar-size | 滚动条宽度 | number(unit=px,min=0) | 3 | |
scrollbar-color | 滚动条颜色 | color | #a5a5a5 | |
scrollbar-bg-color | 滚动条背景颜色 | color | transparent | |
use-panel-scale | 启用面板缩放 | boolean | false | |
panel-scale | 缩放倍率 | number<float>(min=0.1,step=0.1) | 1 | |
panel-content-fit | 内容自适应缩放 | select | none | 可选:none / contain / cover / stretch |
adaptive-view
| 属性 | 名称 | 类型 | 默认 | 说明 |
|---|---|---|---|---|
adaptive-view | 自适应视图 | boolean | false | |
magnification-ratio | 放大倍率 | number(min=100,unit=%) | 200 | |
icon-img | 复位图标 | file(format=image) | — | |
icon-size | 图标大小 | number(min=0,unit=px) | 16 | |
icon-color | 图标颜色 | color | #bfbfbf | |
icon-position | 图标位置 | select | right_top | 可选:right_top / left_top / right_bottom / left_bottom |
icon-offset | 图标偏移 | vector<X,Y>(unit=px) | [5,5] |
animation-display
| 属性 | 名称 | 类型 | 默认 | 说明 |
|---|---|---|---|---|
animation-display | 播放旋转 | boolean | false | |
animation-type | 旋转方向 | select(radioGroup) | anti-clockwise | 可选:anti-clockwise / clockwise |
animation-delay | 延迟 | number<float>(unit=秒) | 0 | |
animation-duration | 单圈时长 | number<float>(min=0.1,unit=秒) | 4 | |
animation-loop | 循环 | boolean | true |
数据绑定
无组件特有数据绑定字段(纯样式 / 布局 / 装饰)。
事件
触发器
触发器在预览 / 播放态生效(编辑态点击 = 选中组件)。写在本组件
options.interactions的groups[].trigger里。
| 触发器 | 名称 | 触发时机 | payload(供动作公式 {:字段} 取值) |
|---|---|---|---|
click | 点击 | 点击本组件时触发 | 无 |
mouseEnter | 鼠标移入 | 指针移入组件时触发 | 无 |
mouseLeave | 鼠标移出 | 指针移出组件时触发 | 无 |
appear | 入场 | 组件出现时触发(配合进场动画) | 无 |
disappear | 离场 | 组件消失时触发(配合退场动画) | 无 |
receiveBehaviorEvent | 接收行为事件 | 收到 sendBehaviorEvent 动作或宿主 ctx.emit 投递的事件时触发(按 eventName 匹配) | 发送方携带的 data |
动作
触发器命中后执行的动作。本组件既可发起动作(配在自己的交互里),也可作为其它组件动作的目标。
| 动作 | 名称 | 说明 |
|---|---|---|
changeOption | 修改设置 | 把本组件(或其它组件)的某个属性改为静态值 / 公式动态值 |
switchState | 切换状态 | 切到多状态里的某个状态(state:"" 回默认态) |
appear / disappear | 进 / 退场动画 | 对目标 opacity 做 0↔100 插值的显隐动画 |
完整动作清单(switchScreen / switchWindow / openUrl / sendBehaviorEvent / transfer / executeScript / requestApi 等)与持久化写法见事件交互。
示例
{
"type": "layout-fixed-panel",
"uid": "w_layout_fixed_panel",
"options": {
"position": [40, 40],
"size": [400, 300]
}
}