通用屬性
各元件均可使用如下通用屬性,用於新增標題、圖示、指定設定儲存位置等。這些通用屬性在不同元件中可能有不同的作用。
| 鍵 | 類型 | 描述 | 條件 |
|---|---|---|---|
| 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,則元件的值只讀,不能被修改和置空。也不能連結到子介面。