From 5068fd4633111cc5603d43702c87ed6b2996175c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E6=9D=8E=E8=8B=A5=E8=BE=B0?= Date: Tue, 14 Oct 2025 16:51:15 +0800 Subject: [PATCH] =?UTF-8?q?=E6=9B=B4=E6=96=B0=20TextBlockBuilder?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- TextBlockBuilder.md | 100 ++++++++++++++++++++++++++++++++++++++++++-- 1 file changed, 97 insertions(+), 3 deletions(-) diff --git a/TextBlockBuilder.md b/TextBlockBuilder.md index d201b42..1b299c7 100644 --- a/TextBlockBuilder.md +++ b/TextBlockBuilder.md @@ -205,7 +205,7 @@ private static TextBlockParam param = TextBlockParam.Default.SetDifferenceByEmpt > 值得注意的是,如果需要获得默认值,构造参数中需要填入一个名称 > 这个名称并不重要,所以我都是直接用空字符串代替,如果不填写则全部使用空值,在设置valueBlock时可能会导致行为不及预期等问题,注意辨别。 -嵌套框架语法制作最多10个参数。 +嵌套框架语法最多支持10个参数。 ### 拼接框架语法 SpreadBlocker @@ -228,7 +228,21 @@ private static TextBlockParam param => new("") { NumberValue = 1.23, TextSize = > 实际上使用 default/null 代替 Empty() 也是可以的,区别是引用为空的框架成员不会被框架处理,而实际存在但内容为空的框架会被其他框架处理,知道最终的构建步骤中才会被文本包裹器忽略。 > 总之这些方式最终的表现都是一样的,可以随意使用。 -拼接框架函数最多支持10个参数,超出后也可以使用 `+` 链接两个框架函数。 +拼接框架函数最多支持10个参数,超出后也可以使用 `+`或`*` 链接两个框架函数。 + +``` csharp +// 错误:这样会与string的运算混淆,返回的类型会被认为是string。 +"前缀" + Value(123) + "后缀" + +// 正确:使用 * 强制拼接框架和字符串 +"前缀" + Value(123) * "后缀" + +// 错误:使用 + 拼接的结果是 IBlockLinkAgent ,只能支持 BuildBlockByAgent +(Value(123) + "后缀").BuildBlockByAgentOnce() + +// 正确:使用 * 强制拼接会尝试返回 BlockBuilderAgent 类型,只要运算符的两者至少有一个是 BlockBuilderAgent 即可 +(Value(123) * "后缀").BuildBlockByAgentOnce() +``` ## 延迟赋值 @@ -273,7 +287,7 @@ _blockBuilder.LaunchDelaySetAction(); 这里提供更多的示例参考: -#### 带有名称的值 +### 带有名称的值 结果长这样:`行程(mm) 123.45` 名称和值在同一行中,但是两侧对齐,适合用在 值和数字关联的场景中。 富文本格式: @@ -338,6 +352,86 @@ private TextBlockBuilder _gearOilTempCardBlockBuilder = GetBlockBuilder(RichText private static TextBlockBuilder GetBlockBuilder(string id, string label) => ID(id, LineHeight(0, NestBlocker(LeftDataParam, Label(label)) + "\n", NestBlocker(RightDataParam))).BuildBlockByAgentOnce(); ``` +### 无序列表 + +结果长这样: + +``` +● 重大风险 3个 +● 较大风险 3个 +● 一般风险 3个 +● 低风险 30个 +``` + +富文本格式: +``` +● 重大风险 + 3个 + +● 较大风险 + 3个 + +● 一般风险 + 3个 + +● 低风险 + 30个 + +``` + +* 文本包裹器语法 + ```csharp + public static readonly TextBlockBuilder RiskLegendBuilder = new TextBlockBuilder() + { + new LineHeightBlock(0, new IDBlock(RiskSourceLogRed, new AlignBlock(left, + new MacroMath.ColorBlock("#FF797C", new SizeBlock(10, "●")), " 重大风险\n", + new PosBlock(80, percent, + new UBlock(new NumberValueBlock(0, -1), "个"))))), + new LineHeightBlock(10, "\n"), "\n", + new LineHeightBlock(0, new IDBlock(RiskSourceLogOrange, new AlignBlock(left, + new MacroMath.ColorBlock("#FF851B", new SizeBlock(10, "●")), " 较大风险\n", + new PosBlock(80, percent, + new UBlock(new NumberValueBlock(0, -1), "个"))))), + new LineHeightBlock(10, "\n"), "\n", + new LineHeightBlock(0, new IDBlock(RiskSourceLogYellow, new AlignBlock(left, + new MacroMath.ColorBlock("#FAE361", new SizeBlock(10, "●")), " 一般风险\n", + new PosBlock(80, percent, + new UBlock(new NumberValueBlock(0, -1), "个"))))), + new LineHeightBlock(10, "\n"), "\n", + new LineHeightBlock(0, new IDBlock(RiskSourceLogWhite, new AlignBlock(left, + new MacroMath.ColorBlock("#43B1FF", new SizeBlock(10, "●")), " 低风险\n", + new PosBlock(80, percent, + new UBlock(new NumberValueBlock(0, -1), "个"))))), + new LineHeightBlock(10, "\n"), "\n", + }; + ``` + +* 基础框架语法 + ```csharp + public static readonly TextBlockBuilder RiskLegendBuilder1 = Pure( + LineHeight(0, ID(RiskSourceLogRed, Align(left, + Color("#FF797C", Size(10, Label("●"))) + " 重大风险\n", + Pos(80, percent, + U( Value(0, -1) + "个"))))), + LineHeight(10, Label("\n")) + "\n", + LineHeight(0, ID(RiskSourceLogOrange, Align(left, + Color("#FF851B", Size(10, Label("●"))) + " 较大风险\n", + Pos(80, percent, + U( Value(0, -1) + "个"))))), + LineHeight(10, Label("\n")) + "\n", + LineHeight(0, ID(RiskSourceLogYellow, Align(left, + Color("#FAE361", Size(10, Label("●"))) + " 一般风险\n", + Pos(80, percent, + U( Value(0, -1) + "个"))))), + LineHeight(10, Label("\n")) + "\n", + LineHeight(0, ID(RiskSourceLogWhite, Align(left, + Color("#43B1FF", Size(10, Label("●"))) + " 低风险\n", + Pos(80, percent, + U( Value(0, -1) + "个"))))), + LineHeight(10, Label("\n")) + "\n" + ).BuildBlockByAgentOnce(); + ``` + ## 注意事项 注意在与包裹器交互时,传入参数尽量不要为null,这样分辨不出来类型,在大多数包裹器上会产生报错。