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,这样分辨不出来类型,在大多数包裹器上会产生报错。