docs: explain layout example constraints and protocol calls
This commit is contained in:
@@ -2,9 +2,11 @@
|
||||
// 运行时在只读求解中跟踪这些读取,事件修改模型后重新布局;布局方法不能直接改业务字段。
|
||||
// 保存宽度与左偏移;两字段只在事件回调中修改。
|
||||
class Metrics {
|
||||
// width 提供 measure 输出,left 提供 arrange 的首子槽 x;模型状态不是 Mount 的派生几何副本。
|
||||
width: Number
|
||||
left: Number
|
||||
// 同时改变测量和排列依赖,整帧需收敛后一起发布新尺寸/位置。
|
||||
// button.on 的绑定事件回调写入两个字段,方法返回后的刷新把受影响布局合并到同一帧。
|
||||
function expand(self: Metrics, event: Event): Unit {
|
||||
self.width = 260
|
||||
self.left = 68
|
||||
@@ -15,7 +17,9 @@ class MeasuredRect: RectBlock {
|
||||
// 首次测量前结构 Mount 链接已建立,因此可从 parent.block 读取当前出现位置的父策略。
|
||||
// 此阶段还不能查询最终 bounds,返回值使用 MeasureResult 名义类型。
|
||||
function measure(self: MeasuredRect, mount: Mount, constraints: Constraints): MeasureResult {
|
||||
// 从当前出现而非共享 rect 查父 Mount,同一 MeasuredRect 换父容器时可读取不同的 metrics。
|
||||
parent = mount.parent()
|
||||
// 父 Block 需要符合示例的 metrics 约定;MeasureResult 宽高随后仍由宿主按当前 Constraints 检查和钳制。
|
||||
return MeasureResult(parent.block.metrics.width, 60)
|
||||
}
|
||||
}
|
||||
@@ -24,16 +28,22 @@ class OffsetColumn: Column {
|
||||
metrics: Metrics
|
||||
// Arrangement 里的 x 是当前排列使用的坐标;读取 metrics.left 成为排列依赖。
|
||||
function arrange(self: OffsetColumn, mount: Mount, geometry: Bounds): Arrangement {
|
||||
// 保留原生 Column 对全部孩子的槽分配,临时结果可修改,不在 arrange 中写 self.metrics。
|
||||
positions = Column.arrange(self, mount, geometry)
|
||||
// 这里直接覆盖排列结果坐标为 metrics.left,不是给 geometry.x 再加相对位移;其他槽保持原生结果。
|
||||
positions.children.at(0).x = self.metrics.left
|
||||
return positions
|
||||
}
|
||||
}
|
||||
// 将原生参数与源字段传给具体子类,button 事件更新模型,Page.render 建立完整展示关系。
|
||||
metrics = Metrics(200, 44)
|
||||
// 原生矩形构造参数仍提供绘制载荷,实际测量被源覆盖为模型宽度和固定高 60。
|
||||
rect = MeasuredRect(80, 20, 0, "#526AC7")
|
||||
button = Button("更新布局")
|
||||
// 首个孩子是 rect,metrics 是 Column 子类新增字段,不是额外的视觉子项。
|
||||
root = OffsetColumn(24, 16, rect, TextBlock("尺寸来自源码 measure,位置来自源码 arrange"), button, metrics)
|
||||
// 保存监听连接使按钮操作同一个模型;布局方法由宿主协议调用,不由事件回调直接手工调用。
|
||||
connection = button.on("click", metrics.expand)
|
||||
page = Page()
|
||||
// 先建立出现树和临时 Mount 上下文,再运行 measure/arrange,源方法才能在求解阶段查看父关系。
|
||||
page.render(root)
|
||||
|
||||
Reference in New Issue
Block a user