先记住一条规则
界面应用的写法始终是同一件事:状态写在字段里,Build() 根据字段拼出一棵界面树。交互回调改字段,框架重跑 Build(),界面就更新了。下面所有能力都建立在这条规则上。
控件清单
在 using static Codenest.Ui; 之后可以直接调用:
| 控件 | 写法 | 说明 |
|---|---|---|
| 纵向 / 横向 | Column(...) / Row(...) |
布局容器,可传间距 Column(14, ...) |
| 网格 | Grid(列数, ...) |
2 到 6 列等宽网格,Grid(2, 卡片A, 卡片B) |
| 卡片 | Card(...) |
带边框和背景的分组 |
| 文本 | Text / Title / Subtitle / Muted / Bold |
不同字号层级 |
| 按钮 | Button("文字", () => ...) / PrimaryButton(...) |
主按钮高亮 |
| 输入 | Field(值, 新值 => ...) / MultilineField(...) |
回车或失焦时回调 |
| 开关 | Switch("标签", 布尔值, 值 => ...) |
切换时回调新的布尔值 |
| 复选 | Checkbox("标签", 布尔值, 值 => ...) |
可独立勾选 |
| 单选 | RadioGroup(string[], 下标, 下标 => ...) |
一组里选一个 |
| 分段选择 | Segmented(string[], 下标, 下标 => ...) |
顶部分段切换 |
| 滑块 | Slider(值, 最小, 最大, 值 => ...) |
拖动时回调小数 |
| 评分 | Rating(1 到 5, 值 => ...) |
点击星星回调整数 |
| 列表项 | ListItem("标题", "副标题") / ListItem("标题", "副标题", "尾部") |
第三参给尾注;带回调重载可点击 |
| 进度条 | Progress(0 到 100) |
超出范围自动截断 |
| 标签 | Badge("文字") / Badge("文字", "ok") |
颜色可选 info、ok、warn |
| 图片 | Image("地址") / Image("地址", "说明") |
支持 http(s) 与 data: 地址 |
| 视频 | Video("地址") / Video("地址", 自动播放, 循环) |
带播放控件;自动播放需静音 |
| 头像 | Avatar("文字") / Avatar("文字", "图片地址") |
没有图片时显示首字 |
| 图标 | Icon("字符", 字号) |
用 emoji 或符号充当图标 |
| 链接 | Link("文字", "地址") |
点击用系统浏览器打开 |
| 加载 | Loading("文字") / Spinner() |
转圈提示 |
| 代码块 | Code("代码文字") |
等宽字体展示一段代码 |
| 提示条 | Note("文字") / Note("文字", "ok") |
颜色可选 info、ok、warn |
| 其它 | Divider() / Spacer(8) |
分隔线与固定留白 |
一个开关加进度条的例子:
bool sound = true;
int done = 3;
return Column(
Progress(done * 100.0 / 7),
Switch("每日提醒", sound, value => sound = value),
Badge("已完成 " + done + " 天", "ok")
);
组件速查
这里只放一张总览表;每个控件的完整签名、取值与示例已整理成独立一篇:
下表按用途列出全部控件,点上方链接看详细用法。
| 控件 | 写法 | 说明 |
|---|---|---|
| 纵向 / 横向 | Column(...) / Row(...) |
布局容器,可传间距 Column(14, ...) |
| 网格 | Grid(列数, ...) |
2 到 6 列等宽网格 |
| 卡片 | Card(...) |
带边框和背景的分组 |
| 文本 | Text / Title / Subtitle / Muted / Bold |
不同字号层级 |
| 按钮 | Button(...) / PrimaryButton(...) |
主按钮高亮 |
| 输入 | Field(...) / MultilineField(...) |
回车或失焦时回调 |
| 开关 / 复选 | Switch(...) / Checkbox(...) |
切换与勾选 |
| 单选 / 分段 | RadioGroup(...) / Segmented(...) |
一组里选一个 |
| 滑块 / 评分 | Slider(...) / Rating(...) |
拖动与点击取值 |
| 列表 / 进度 | ListItem(...) / Progress(...) |
列表项与进度条 |
| 标签 / 提示条 | Badge(...) / Note(...) |
颜色可选 info、ok、warn |
| 图片 / 视频 | Image(...) / Video(...) |
支持网址与 data: |
| 头像 / 图标 | Avatar(...) / Icon(...) |
首字与符号 |
| 其它 | Link / Loading / Code / Divider / Spacer |
链接、加载、代码块、分隔与留白 |
一个开关加进度条的例子:
bool sound = true;
int done = 3;
return Column(
Progress(done * 100.0 / 7),
Switch("每日提醒", sound, value => sound = value),
Badge("已完成 " + done + " 天", "ok")
);
自定义样式
任何组件都可以在末尾链式调用 Styled(...),传入一个 Style 覆盖外观。样式只影响外观,不影响行为,没设置的项沿用默认值:
Text("红色大字")
.Styled(new Style { Color = "#e11d48", FontSize = 20, Bold = true }),
Text("蓝底白字")
.Styled(new Style { Color = "#ffffff", Background = "#2563eb", Padding = 10, Radius = 10 }),
Card(
Subtitle("带边框的卡片"),
Text("容器也能设置边框与圆角")
).Styled(new Style { Border = "#6dc4fd", Radius = 16, Padding = 16 })
Style 可用的字段:
| 字段 | 含义 | 取值 |
|---|---|---|
Color |
文字颜色 | "#rrggbb" |
Background |
背景色 | "#rrggbb" |
FontSize |
字号 | 像素数,如 20 |
Bold / Italic / Underline |
粗体 / 斜体 / 下划线 | true / false |
Align |
文字对齐 | "left" / "center" / "right" |
Padding / Margin |
内 / 外边距 | 像素数 |
Radius |
圆角 | 像素数 |
Opacity |
不透明度 | 0 到 1 |
Width |
宽度 | 百分比,0 到 100 |
Border |
边框颜色 | "#rrggbb" |
完整示例
新建项目时选 常用控件 模板可以看到表单控件的组合,选 图片与视频 看媒体与网格,选 自定义样式 看 Styled 的用法。