先记住一条规则

界面应用的写法始终是同一件事:状态写在字段里,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")
);

组件速查

这里只放一张总览表;每个控件的完整签名、取值与示例已整理成独立一篇:

➡️ UI 组件速查:全部控件与示例

下表按用途列出全部控件,点上方链接看详细用法。

控件 写法 说明
纵向 / 横向 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 的用法。

相关