通用属性
各组件均可使用如下通用属性,用于添加标题、图标、指定配置保存位置等。这些通用属性在不同组件中可能有不同的作用。
| 键 | 类型 | 描述 | 条件 |
|---|---|---|---|
| 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/[email protected] 和 res/[email protected],实际尺寸须分别为原来的 2 倍和 3 倍。
readonly 如果为 true,则组件的值只读,不能被修改和置空。也不能链接到子界面。