diff --git a/TextBlockBuilder.md b/TextBlockBuilder.md index 933f000..d201b42 100644 --- a/TextBlockBuilder.md +++ b/TextBlockBuilder.md @@ -4,11 +4,12 @@ 支持TMP的26个富文本标签,以及更多动态包裹器,更可自行扩展更多包裹器类型。 使用包裹器进行文本拼接的优点: -1. 通过编辑器实现语法检查,如果直接编写长串的复杂富文本,可能会由于不起眼的语法问题导致引擎不识别,而转写为包裹器格式,则可以降低低级错误的出现。 +1. 通过编辑器实现语法检查,如果直接编写长串的复杂富文本,可能会由于不起眼的语法问题导致引擎不识别,而转写为包裹器格式,则可以降低低级错误的出现,从我个人的使用情况来看,只要语法检查铜过就不会出现引擎无法识别的情况。 2. 快速复用富文本,如果使用字面量的富文本字符串,则需要自行实现大篇文本拼接,或单独编写一个方法来实现这个固定格式的输出; * 包裹器支持参数填充,也支持使用反射,委托等方式自动获取上下文参数。 * 包裹器的返回值类型一致,可以存放在同一个数据结构中。 * 包裹器拥有完整的数据结构语法,可以动态添加和移除标签结构。 + * 包裹器有大量语法糖可供选择。 3. 包裹器多种语法,满足绝大部分使用情况。(如果不喜欢下面的new语法,可以先翻到后面查阅#框架语法) ## 基本语法 @@ -229,15 +230,53 @@ private static TextBlockParam param => new("") { NumberValue = 1.23, TextSize = 拼接框架函数最多支持10个参数,超出后也可以使用 `+` 链接两个框架函数。 +## 延迟赋值 -### 其他示例 +一般对于单独的我会使用属性进行一次封装: + +``` csharp +_blockBuilder = Color(Color.white, Label("Hello world"), Value(0)) // 定义 + .BuildBlockByAgentOnce() // 构建 + +public float Text +{ + set => TMPText.text = _blockBuilder.SetParamters(value).ToString(); +} +``` + +封装后直接向 Text 赋值就可以一次性完成格式化到文本赋值的过程。 +很方便,但是不够优雅。 + +这里提供一种延迟赋值的语法: + +``` csharp +_blockBuilder = Color(Color.white, Label("Hello world"), Value(0)) // 定义 + .BuildBlockByAgentOnce() // 构建 + .LoadDelaySetAction(a => TMPText.text = a); // 设定延迟委托 + +// 使用launch来激活一次延迟事件 +_blockBuilder.SetParamters(value).LaunchDelaySetAction(); +``` + +但这样还需要每次赋值时重新构建一遍参数列表,不够方便,可以将参数换成委托,或者使用反射实现的框架: + +``` csharp +_blockBuilder = Color(Color.white, Label("Hello world"), Delegate(() => value)) // 定义 + .BuildBlockByAgentOnce() // 构建 + .LoadDelaySetAction(a => TMPText.text = a); // 设定延迟委托 + +// 这样直接调用launch就可以了 +_blockBuilder.LaunchDelaySetAction(); +``` + +## 更多示例 这里提供更多的示例参考: #### 带有名称的值 -结果长这样:`行程(mm) 123.45` 名称和值在同一行中,但是两侧对齐,适合用在 值和数字关联的场景中 -富文本格式是这样的: +结果长这样:`行程(mm) 123.45` 名称和值在同一行中,但是两侧对齐,适合用在 值和数字关联的场景中。 +富文本格式: ``` 行程(mm) -- @@ -251,7 +290,6 @@ private static TextBlockParam param => new("") { NumberValue = 1.23, TextSize = new AlignBlock(left, new ColorBlock(Color.white, "行程(mm)")), "\n", new AlignBlock(right, new SizeBlock(26, new BBlock(new UBlock(new NumberValueBlock(-1, 0))))) })); - ``` * 基础框架语法: