xwidget-fields —— 组件声明的字段全表(自动生成)
这张表直接来自编辑器的
.xwidget契约表:每一个字段、它在哪儿编、写了会怎样。规则与写法见numable docs xwidget;不在本表里的字段写了不生效,也不报错。
| 字段 | 必填 | 在哪儿编 | 说明 |
|---|---|---|---|
version |
是 | 画布工作区 | 文件格式版本,固定写 2 |
title |
是 | 组件表单 | 组件名字。仪表盘、添加组件面板、桌面小组件列表里显示的就是它 |
sub |
— | 组件表单 | 副标题 |
layout |
是 | 组件表单 | 尺寸码:十位=宽几格、个位=高几格(22 = 两宽两高) |
i18n |
— | 「编辑翻译」入口 | title/sub 的语言覆盖(B 表);params 是数据,不本地化 |
params |
— | 组件表单 | 实例参数:同一个组件装两份、各看不同对象,靠的就是这一层。只放标量 |
events.onClick |
— | 组件表单 | 整个组件点击 桌面小组件上点这个组件 = 开 App 后 replay 这条绑定,导航串与动作流两种形态都支持。 |
events.onEdit |
— | 组件表单 | 长按「编辑参数」·可空 绑动作流时:用 singleValue / xform 收值,再 widget.updateParams 写回。绑路由时:页型 html / xpage / form 均可。 |
jobs |
— | 组件表单 | 用户长按此组件时，「添加提醒」中列出以下规则。组件参数可预填到提醒中。 每项包含规则 id 与参数映射。参数可取组件参数或固定值；数据源输出在用户添加提醒时尚不存在，不能用于映射。未声明时，组件长按菜单中不显示「添加提醒」。 |
canvas.source |
是 | 画布工作区 | 这个组件画成什么样 —— 指向一个 .rcn |
canvas.depends |
— | 画布工作区 | 这个组件的数据从哪来 —— 一条或多条取数流绑定 |
canvas.refresh.interval |
— | 画布工作区 | 窗口 HH:MM-HH:MM@秒 或 裸秒 |
canvas.refresh.at |
— | 画布工作区 | 每日时点 HH:MM |
canvas.refresh.tz |
— | 画布工作区 | IANA 时区 |
canvas.onEdit |
— | 写了不生效 | 写在这里不生效(没有任何平台读它)。长按编辑要挂在顶层的 events.onEdit 上 |
「在哪儿编」说的是桌面端编辑器里的位置;直接写文件时,它只影响这个键放在文件的哪一层。