通用属性
各组件均可使用如下通用属性, 为组件添加标题, 图标, 指定配置保存位置等. 这些通用属性在具体的组件中可能有不同的作用.
| 键 | 类型 | 描述 | 条件 |
|---|---|---|---|
| cell | 字符串 | 组件类型 | - |
| label | 字符串 | 显示标签 | 可选, 可本地化 |
| defaults | 字符串 | 配置分区标识符, 即该组件配置存储的名称 | - |
| key | 字符串 | 配置键名 | defaults != nil |
| default | 字符串 | 配置默认值 | - |
| value | 基本类型 | 配置值 | 可选 |
| icon | 字符串 | 图标文件名 | 可选 |
| readonly | 布尔型 | 组件是否只读 | 可选 |
| height | 数值 | 组件的高度 | 可选 |
cell 为组件类型, 不同类型代表不同的 XUI 组件, 如 Button, Switch, Link 等.
label 为组件标题, 通常显示在组件左侧.
default 为组件默认值, 若 value 为 nil, 则使用 default 的值填充 value.
icon 为图标, 显示在 label 左侧. 若设置为 res/16.png, 建议同时准备 res/16@2x.png 和 res/16@3x.png, 实际尺寸须分别为原来的 2 倍和 3 倍.
readonly 如果为 true, 则组件的值只读, 不能被修改和置空. 也不能链接到子界面.