docs: define interpreted runtime and typed resource presentation
This commit is contained in:
+18
-20
@@ -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)
|
||||
|
||||
Reference in New Issue
Block a user