玄铁声明式 UI 库
详细教程、控件参考与使用禁区请参阅:12_UI库编程指南.md
基于渲染库的声明式界面框架:界面 = 状态的函数。引入方式:
引 "UI"。
最小示例
xuantie
引 "UI" 予 UI
引 "渲染" 予 R
设 状态 = UI.造状态({"计数": 0})
UI.应用(状态, 函(s) {
返 UI.列([
UI.文本("计数器演示", {"字号": 28}),
UI.文本("当前: " & UI.态取(s, "计数"), {"字号": 20}),
UI.按钮("点我 +1", {"点击": 函() {
UI.态设(s, "计数", UI.态取(s, "计数") + 1)
}})
], {"内边距": 20, "间距": 12})
}, {"宽": 640, "高": 420, "标题": "我的应用", "字体": "HarmonyOS_Sans_SC_Regular.ttf"})
核心 API 概览
| 类别 | 代表性 API |
|---|---|
| 框架 | UI.应用(状态, 构建函, 选项)、UI.刷新(...)(嵌入手动循环);完整用法见 12 UI 库编程指南 |
| 状态 | UI.造状态、UI.态取、UI.态设、UI.态观、UI.态设批(各自独立详情页) |
| 容器 | UI.列、UI.行、UI.叠、UI.弹性、UI.空白、UI.滚动容器 |
| 控件 | UI.文本、UI.按钮、UI.矩形、UI.输入栏(单行文本框:占位/光标/选区/IME 跟随/剪贴板);另见 UI.多行编辑 |
| 边距 | UI.全边(v)、UI.四边(上,右,下,左)(详见 内边距、外边距),选项中也可直接写裸数字 |
| 颜色 | UI.色彩["主题" 等]、UI.色(r,g,b,a)(相关选项键:底色、字色) |
| 字体 | 应用 选项 "字体"/"字库字号"(自动加载卸载)、UI.设字体(须窗口初始化后);相关选项键:字号、字距 |