diff --git a/TextBlockBuilder.md b/TextBlockBuilder.md
index 1b299c7..bb965b9 100644
--- a/TextBlockBuilder.md
+++ b/TextBlockBuilder.md
@@ -83,11 +83,11 @@ _blockBuilder.ToString(); // 结果:重量1.23kg
* 如果参数列表数量多于需求,在匹配时将不会关注这部分内容。
* 如果参数与包裹器期望的值类型不一致,那么会忽略,注意包裹器不会尝试去寻找其他位置上的值是否能够填入,它是严格按照索引一一对应的。
-另外,你会注意到:
+另外,你可能希望了解的:
* 关于体积:可以看到相比直接写富文本格式,这样写的体积更大。但对于开始不了解富文本格式的情况下,这个功能可以当作一种拼写检查。
* 关于安全:包裹器允许链式语法赋值,隐式反向赋值,部分模块也会使用反射,生成树等功能,这可能会在部分平台上被认为是不安全的;同时过度使用隐式语法也可能导致维护,调试困难。
* 关于性能:这种做法可能比较浪费内存,所以使用时注意要声名在当前作用域的全局用作静态,或持实例唯一。同时在使用过程中可能存在部分可能会频繁装拆箱的操作,不过这些基本上对性能影响微乎其微。
-* 关于文本拼接:所有要拼接文本的地方都用了stringbuilder。
+* 关于文本拼接:所有要拼接文本的地方都用了stringbuilder,不会产生多余的文本对象。
## 自定义Block示例
@@ -150,7 +150,7 @@ public class MyBlock : TextBlockBuilder // 继承自TextBlockBuilder
所以这里也提供了可以隐藏这些new语句的方法,当然考虑到各位可能会对性能存疑,所以我特意基于对象池来实现各种获取操作,不管这对性能是否有所提升,都可以暂时堵住其他随意质疑你这么写的人的嘴巴。
> 起因是我向其他人推荐这个写法,就有人会有这个疑问,说在java中如果这么new对象,怕是要被老板约谈。
> 嘛,说的也没错,其实我也不喜欢这样去写,但设计之初没有太多选择,需要先建立一个基本的框架,否则这些进阶语法都免谈。
-> 我早之前也写了语法逆向,尝试将一个富文本转为blocker,不过这样性能消耗有点大。
+> 我早之前也写了语法逆向,尝试将一个富文本转为blocker,不过这样性能消耗有点大,而且仔细想想有点奇怪。
需要注意的是,框架语法是基于上述的文本包裹器语法实现的,在彻底了解框架语法前建议先从基础的繁琐的包裹器语法开始了解。
@@ -173,12 +173,10 @@ using Color = UnityEngine.Color;
> 也可以使用`BuildBlockByAgent`获取,但它会返回一个object类型的TextBlockBuilder对象,但是会保留框架,也就是你可以重复使用这个框架去生成blockBuilder。
> 除非你已经完全了解如何使用框架,否则无论如何,都建议使用`BuildBlockByAgentOnce`来构建,
-### 框架语法说明:
-
> 在框架上使用构建方法返回的文本包裹器,在内容上与直接使用new block的做法生成的内容几乎一致。
> 但框架格式在细节处理上相比直接使用文本包裹器相比,可能会产生更多的嵌套块用于处理特殊语法,通常这不会影响最终的使用。
-#### 嵌套框架语法 NestBlocker
+### 嵌套框架语法 NestBlocker
使用`NestBlocker`可以快速拼接多个嵌套块,下面是一个示例:
@@ -306,7 +304,7 @@ _blockBuilder.LaunchDelaySetAction();
}));
```
-* 基础框架语法:
+* 等效框架语法:
``` csharp
private TextBlockBuilder _tripCardBlockBuilder =
ID(RichTextHelper.Stroke, LineHeight(0,
@@ -406,7 +404,7 @@ private static TextBlockBuilder GetBlockBuilder(string id, string label) => ID(i
};
```
-* 基础框架语法
+* 等效框架语法
```csharp
public static readonly TextBlockBuilder RiskLegendBuilder1 = Pure(
LineHeight(0, ID(RiskSourceLogRed, Align(left,
@@ -432,6 +430,27 @@ private static TextBlockBuilder GetBlockBuilder(string id, string label) => ID(i
).BuildBlockByAgentOnce();
```
+* 高级框架语法:
+ ``` csharp
+ public static readonly TextBlockBuilder RiskLegendBuilder = Pure(
+ LegendPartblock(RiskSourceLogRed, "#FF797C", "重大风险"),
+ LegendPartblock(RiskSourceLogRed, "#FF851B", "较大风险"),
+ LegendPartblock(RiskSourceLogRed, "#FAE361", "一般风险"),
+ LegendPartblock(RiskSourceLogRed, "#43B1FF", "低风险")
+ ).BuildBlockByAgentOnce();
+
+ private static IBlockAgentBase LegendPartblock(string id, string colorString, string riskType)
+ {
+ var param = new TextBlockParam("") { ID = id, Align = left, ColorString = colorString, TextSize = 10 };
+ var param2 = new TextBlockParam("") { Pos = 80, Units = percent };
+ return LineHeight(0, NestBlocker(param,
+ NestBlocker(param, Label("●")) + $" {riskType}\n" +
+ NestBlocker(param2, Value(0, -1) + "个")) +
+ LineHeight(10, Label("\n")) * "\n");
+ }
+ ```
+
+
## 注意事项
注意在与包裹器交互时,传入参数尽量不要为null,这样分辨不出来类型,在大多数包裹器上会产生报错。