docs: clarify layout bounds and retained image text flow

This commit is contained in:
2026-11-12 20:41:16 +08:00
parent 0c4bd06231
commit 45b0b53d4f
6 changed files with 21 additions and 2 deletions
+4
View File
@@ -95,6 +95,8 @@ impl Sizing {
/// 将 [最小宽, 最小高, 最大宽, 最大高] 收窄,供子内容测量和文本换行使用。
/// 固定尺寸限制最大可用空间;最后缩小最小约束以保持 min <= max。这里不直接计算最终盒子。
pub fn available(self, mut constraints: [f32; 4]) -> [f32; 4] {
// layout::shape/child_constraints 先调用这里;返回仍是边框盒约束,border/padding 由布局调用方随后扣除。
// Auto 的自身 min 不在这里抬高父最小值;最终 resolve 再应用自身 min/max,避免提前把内容测量冻结成分配尺寸。
// 先套自身 max,再应用 Fixed;Auto/Fill 在测量阶段保留父级允许的空间。
constraints[2] = constraints[2].min(self.max_width);
constraints[3] = constraints[3].min(self.max_height);
@@ -112,6 +114,7 @@ impl Sizing {
}
/// 结合内容期望尺寸、轴策略和父级约束求最终盒子尺寸;无界轴不能解析 fill。
/// layout::measure_shape 的 Shape::Sized 路径调用;intrinsic 已包含该形状的有效内缩量,不在这里重复加 padding/border。
pub fn resolve(self, intrinsic: Size, constraints: [f32; 4]) -> Result<Size> {
/// 针对单个尺寸轴应用约束与边界规则,供双轴尺寸求解复用。
fn axis(
@@ -137,6 +140,7 @@ impl Sizing {
}
};
// 先满足自身 min/max,再服从父级上限;父级空间比 min 小时,父级上限优先。
// min/max 的合法性由模型预检;这个数值助手不修复反向上下限,不能把任意未校验 Sizing 直接送进 clamp。
Ok(value.clamp(min, max).min(available))
}
// 横纵轴分别求解,只取父最大分配 constraints[2/3];输入的最小约束不在此额外强加。