更新 TextBlockBuilder

2025-10-14 16:51:15 +08:00
parent 7c7e6c3cf5
commit 5068fd4633
+97 -3
@@ -205,7 +205,7 @@ private static TextBlockParam param = TextBlockParam.Default.SetDifferenceByEmpt
> <span style="color: orange;">值得注意的是,如果需要获得默认值,构造参数中需要填入一个名称</span>
> 这个名称并不重要,所以我都是直接用空字符串代替,如果不填写则全部使用空值,在设置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<AlignBlock, ColorBlock>(LeftDataParam, Label(label)) + "\n", NestBlocker<AlignBlock, SizeBlock, BBlock, UBlock, NumberValueBlock>(RightDataParam))).BuildBlockByAgentOnce();
```
### 无序列表
结果长这样:
```
● 重大风险 3个
● 较大风险 3个
● 一般风险 3个
● 低风险 30个
```
富文本格式:
```
<line-height=0><align=left><color=#FF797C><size=10>●</size></color> 重大风险
<pos=80%><u>3个</u></line-height><line-height=10>
</line-height>
<line-height=0><align=left><color=#FF851B><size=10>●</size></color> 较大风险
<pos=80%><u>3个</u></line-height><line-height=10>
</line-height>
<line-height=0><align=left><color=#FAE361><size=10>●</size></color> 一般风险
<pos=80%><u>3个</u></line-height><line-height=10>
</line-height>
<line-height=0><align=left><color=#3EE2EE><size=10>●</size></color> 低风险
<pos=80%><u>30个</u></line-height><line-height=10>
</line-height>
```
* 文本包裹器语法
```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,这样分辨不出来类型,在大多数包裹器上会产生报错。