更新 TextBlockBuilder
+43
-5
@@ -4,11 +4,12 @@
|
|||||||
|
|
||||||
支持TMP的26个富文本标签,以及更多动态包裹器,更可自行扩展更多包裹器类型。
|
支持TMP的26个富文本标签,以及更多动态包裹器,更可自行扩展更多包裹器类型。
|
||||||
使用包裹器进行文本拼接的优点:
|
使用包裹器进行文本拼接的优点:
|
||||||
1. 通过编辑器实现语法检查,如果直接编写长串的复杂富文本,可能会由于不起眼的语法问题导致引擎不识别,而转写为包裹器格式,则可以降低低级错误的出现。
|
1. 通过编辑器实现语法检查,如果直接编写长串的复杂富文本,可能会由于不起眼的语法问题导致引擎不识别,而转写为包裹器格式,则可以降低低级错误的出现,从我个人的使用情况来看,只要语法检查铜过就不会出现引擎无法识别的情况。
|
||||||
2. 快速复用富文本,如果使用字面量的富文本字符串,则需要自行实现大篇文本拼接,或单独编写一个方法来实现这个固定格式的输出;
|
2. 快速复用富文本,如果使用字面量的富文本字符串,则需要自行实现大篇文本拼接,或单独编写一个方法来实现这个固定格式的输出;
|
||||||
* 包裹器支持参数填充,也支持使用反射,委托等方式自动获取上下文参数。
|
* 包裹器支持参数填充,也支持使用反射,委托等方式自动获取上下文参数。
|
||||||
* 包裹器的返回值类型一致,可以存放在同一个数据结构中。
|
* 包裹器的返回值类型一致,可以存放在同一个数据结构中。
|
||||||
* 包裹器拥有完整的数据结构语法,可以动态添加和移除标签结构。
|
* 包裹器拥有完整的数据结构语法,可以动态添加和移除标签结构。
|
||||||
|
* 包裹器有大量语法糖可供选择。
|
||||||
3. 包裹器多种语法,满足绝大部分使用情况。<span style="color: orange;">(如果不喜欢下面的new语法,可以先翻到后面查阅#框架语法)</span>
|
3. 包裹器多种语法,满足绝大部分使用情况。<span style="color: orange;">(如果不喜欢下面的new语法,可以先翻到后面查阅#框架语法)</span>
|
||||||
|
|
||||||
## 基本语法
|
## 基本语法
|
||||||
@@ -229,15 +230,53 @@ private static TextBlockParam param => new("") { NumberValue = 1.23, TextSize =
|
|||||||
|
|
||||||
拼接框架函数最多支持10个参数,超出后也可以使用 `+` 链接两个框架函数。
|
拼接框架函数最多支持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` 名称和值在同一行中,但是两侧对齐,适合用在 值和数字关联的场景中。
|
||||||
富文本格式是这样的:
|
富文本格式:
|
||||||
```
|
```
|
||||||
<link=行程><line-height=0><align=left><color=#FFFFFFFF>行程(mm)</color></align>
|
<link=行程><line-height=0><align=left><color=#FFFFFFFF>行程(mm)</color></align>
|
||||||
<align=right><size=26><b><u>--</u></b></size></align></line-height></link>
|
<align=right><size=26><b><u>--</u></b></size></align></line-height></link>
|
||||||
@@ -251,7 +290,6 @@ private static TextBlockParam param => new("") { NumberValue = 1.23, TextSize =
|
|||||||
new AlignBlock(left, new ColorBlock(Color.white, "行程(mm)")), "\n",
|
new AlignBlock(left, new ColorBlock(Color.white, "行程(mm)")), "\n",
|
||||||
new AlignBlock(right, new SizeBlock(26, new BBlock(new UBlock(new NumberValueBlock(-1, 0)))))
|
new AlignBlock(right, new SizeBlock(26, new BBlock(new UBlock(new NumberValueBlock(-1, 0)))))
|
||||||
}));
|
}));
|
||||||
|
|
||||||
```
|
```
|
||||||
|
|
||||||
* 基础框架语法:
|
* 基础框架语法:
|
||||||
|
|||||||
Reference in New Issue
Block a user