docs: define interpreted runtime and typed resource presentation

This commit is contained in:
2026-10-08 00:55:00 +08:00
parent 941942c7e1
commit 861fef5ec0
19 changed files with 246 additions and 183 deletions
+18 -20
View File
@@ -1,18 +1,17 @@
# 12. UI 组件
本章是官方基础组件的用法参考,定义本文 UI 草案中的参数、默认值和展示效果。示例是 `bob:shop.ui` 场景 render 内的节点片段。
本章保留官方基础组件的参数、默认值和展示效果提案。组件用于组成普通函数返回的界面值,资源与结果的呈现方式见[资源访问与呈现](11-resource-access-and-presentation.md)。
官方库的 key 和引用形式尚未定义,来源约定见[场景与渲染树](11-scenes-and-render-trees.md)。用户库提供的组件则以其实际声明为准。
官方库的 key、引用形式、组件构造表达式和界面类型尚未定义。本章示例是 `bob:shop.ui` 的界面结构示意,不是源码,也不表示官方组件属于该用户库或必然免导入可用。用户库提供的组件以其实际声明为准。
## 12.1 Column
Column 从上到下排列子节点。
```endorphin
Column(gap: 12, padding: 24) {
Text("First")
Text("Second")
}
```text
Column:gap 为 12,padding 为 24
Text:内容为 First
Text:内容为 Second
```
| 参数 | 值类型 | 默认值 | 含义 |
@@ -28,11 +27,10 @@ Column(gap: 12, padding: 24) {
Row 从左到右排列子节点。
```endorphin
Row(gap: 8, padding: 4) {
Text("Left")
Text("Right")
}
```text
Row:gap 为 8,padding 为 4
Text:内容为 Left
Text:内容为 Right
```
| 参数 | 值类型 | 默认值 | 含义 |
@@ -48,8 +46,8 @@ Row(gap: 8, padding: 4) {
Spacer 占据布局空间,不显示可见内容。
```endorphin
Spacer(size: 16)
```text
Spacer:size 为 16
```
| 参数 | 值类型 | 默认值 | 含义 |
@@ -64,14 +62,14 @@ Spacer(size: 16)
Text 显示字符串内容。
```endorphin
Text("Product")
Text("Shop", role: .title)
```text
Text:内容为 Product
Text:内容为 Shop,role 为 .title
```
| 参数 | 值类型 | 默认值 | 含义 |
| --- | --- | --- | --- |
| 第一个位置参数 | 字符串 | `""` | 显示的文本 |
| 文本内容 | 字符串 | `""` | 显示的文本;正式参数名与传入方式待定 |
| `role` | 符号值 | 普通文本角色 | `.title` 表示标题视觉角色 |
**子节点:** 不接受。
@@ -82,8 +80,8 @@ Text("Shop", role: .title)
数字布局参数表达逻辑尺寸,本文不将其等同于设备像素。单位、数值范围、负数、显式尺寸、溢出、主题与文字测量规则列于[规范状态](../appendices/specification-status.md#ui)。
Preflight 检查组件名称、参数数量与类型、子节点约束;inflight 保持组件规定的内容和排列效果。未知参数、错误类型或不支持的子节点不能通过静默忽略获得有效语义。
组件声明与构造规则确定后,Preflight 据此检查名称、输入类型和子节点约束;inflight 保持组件规定的内容和排列效果。未知参数、错误类型或不支持的子节点不能通过静默忽略获得有效语义。
本章组件参数与默认值属于 UI 提案,确定程度与其他语言主题一起记录在规范状态附录。
[上一章:场景与渲染树](11-scenes-and-render-trees.md) · [附录:形式文法](../appendices/formal-grammar.md) · [目录](../README.md)
[上一章:资源访问与呈现](11-resource-access-and-presentation.md) · [附录:形式文法](../appendices/formal-grammar.md) · [目录](../README.md)