docs: clarify UI registration signatures and visual snapshot fields
This commit is contained in:
@@ -27,6 +27,7 @@ pub struct UiNode {
|
||||
pub sizing: crate::box_model::Sizing,
|
||||
// 单边可选覆盖值;None 表示沿用 kind 的统一 padding,不代表边距为零。
|
||||
pub padding_edges: [Option<f32>; 4],
|
||||
// 四边边框厚度;layout::insets 将其与有效 padding 相加,内容盒、相机锚点及绘制共用该内缩量。
|
||||
pub border: crate::layout::Insets,
|
||||
// 留原始颜色字符串供显示列表解码;颜色变更也必须使 shallow_eq 为 false。
|
||||
pub border_color: String,
|
||||
@@ -86,6 +87,7 @@ impl UiNode {
|
||||
}
|
||||
|
||||
/// model::snapshot 缓存重建节点后调用,判断可否保留旧 Arc;返回 true 不会修改任何节点或 VM 对象。
|
||||
/// 缓存调用方仍会用本轮读取重建依赖/父边;这里只证明视觉值可复用,不能证明依赖来源没有变化。
|
||||
pub fn shallow_eq(&self, other: &Self) -> bool {
|
||||
// 先比较所有公共视觉/协议配置,任一变化都不能复用旧节点 Arc,即使子内容完全相同。
|
||||
if self.surface != other.surface
|
||||
@@ -286,13 +288,18 @@ pub enum UiKind {
|
||||
},
|
||||
// 旧 Page Canvas 模式的兼容投影,位置数组与孩子顺序一致,页面级 Surface 保存其相机。
|
||||
Canvas {
|
||||
// 页面根中每个孩子的业务位置,保持与 children 同长度同顺序;Surface 再统一变换到页面视图。
|
||||
positions: Vec<[f32; 2]>,
|
||||
// 业务组成提取的不可变子树;数组顺序决定遍历/绘制顺序,不按 x/y 自动排序。
|
||||
children: Vec<Arc<UiNode>>,
|
||||
},
|
||||
// 按钮是有子内容的容器,不把标签文本硬编码进 UiKind;交互资格另由 UiNode 标志表达。
|
||||
Button {
|
||||
// 内容与边框之间的统一内边距;单边覆盖仍优先使用 UiNode.padding_edges。
|
||||
padding: f32,
|
||||
// 多个内容孩子的主轴间距,不含父节点外 margin 或按钮边框厚度。
|
||||
gap: f32,
|
||||
// 标签只是其中一个普通 Text 子树,按钮没有独立的硬编码文字字段。
|
||||
children: Vec<Arc<UiNode>>,
|
||||
},
|
||||
// 文字叶节点保留源字号等级与颜色文本;排版及最终设备比例由后续布局/显示列表转换处理。
|
||||
@@ -306,20 +313,30 @@ pub enum UiKind {
|
||||
},
|
||||
// 纯绘制叶节点;几何尺寸与圆角供布局/显示列表共用,不含托管对象句柄。
|
||||
Rect {
|
||||
// 自然宽高用于测量;父安排与盒尺寸策略仍可给实际出现分配其他尺寸。
|
||||
width: f32,
|
||||
height: f32,
|
||||
// 圆角半径影响显示列表的矩形命令,不给孩子增加布局空间。
|
||||
radius: f32,
|
||||
// 已校验格式的填充色字符串,与 UiNode.border_color 分别控制填充和边框。
|
||||
color: String,
|
||||
},
|
||||
// Column 沿纵轴累加孩子位置,Row 沿横轴;二者都保存统一内边距和孩子间距。
|
||||
Column {
|
||||
// 容器默认内边距,最终内容内缩还包括单边覆盖与边框厚度。
|
||||
padding: f32,
|
||||
// 相邻孩子间沿纵向增加的空隙,首尾不额外增加一份 gap。
|
||||
gap: f32,
|
||||
// 当前组成顺序;节点可共享 Arc,但每次出现的 Mount 和几何另行建立。
|
||||
children: Vec<Arc<UiNode>>,
|
||||
},
|
||||
// 横排容器与 Column 使用相同盒模型,但 gap 和弹性分配沿水平主轴计算。
|
||||
Row {
|
||||
// 统一内边距,由 layout::insets 与单边覆盖/边框合成有效值。
|
||||
padding: f32,
|
||||
// 横向相邻孩子间距,不是孩子自身宽度或两边 margin 的替代值。
|
||||
gap: f32,
|
||||
// 源组成的逻辑顺序,不因视觉位置变化而重排 slot。
|
||||
children: Vec<Arc<UiNode>>,
|
||||
},
|
||||
// 无视觉内容的间隔叶节点,提供布局占用尺寸。
|
||||
@@ -328,10 +345,14 @@ pub enum UiKind {
|
||||
Scroll {
|
||||
// axis 指定允许消费的滚动方向;实际可消费距离还取决于具体 Mount 的内容/视口范围。
|
||||
axis: crate::scroll::Axis,
|
||||
// 有限视口的自然尺寸;内容可能大于视口,溢出范围和偏移由布局与 Mount 派生。
|
||||
width: f32,
|
||||
height: f32,
|
||||
// 内容布局的统一内边距,与视口外 margin 分开。
|
||||
padding: f32,
|
||||
// 内容子项的纵向间隔,保持与原生滚动容器布局规则一致。
|
||||
gap: f32,
|
||||
// 当前内容树;滚动仅改变出现投影,不把移动后的坐标写入共享 UiNode。
|
||||
children: Vec<Arc<UiNode>>,
|
||||
},
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user