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