更新 MacroMath

2025-07-02 11:00:54 +08:00
parent 11b04a2772
commit 487fb67738
+29 -22
@@ -63,7 +63,7 @@ objects.Join(obj => obj.ToString())
空判断,空格判断,相等判断,字符集判断
## 格式包裹
## 格式包裹器
支持TMP的26个富文本标签,或者自行扩展更多包裹器。
包裹器可以依靠多态模型来构建文本,而不依赖字面量构建。下面是一个示例:
@@ -73,44 +73,51 @@ _blockBuilder = new TextBlockBuilder(
new ColorBlock(Color.white, "重量"),
new DelegateBlock(() => value.ToString()),
new SizeBlock(20, "kg")));
_blockBuilder.ToString(); // <color=white>重量</color>3.14<size=20>kg</size>
```
* ● `TextBlockBuilder` 是所有blocker的基类,使用它包裹所有文本将起到单纯拼接文本的作用;
* ● TextBlockBuilder 里的三个block的作用是使用相应的富文本标签包裹,根据标签的类型,包裹器会自动决定标签格式。
* ● `DelegateBlock`的作用是通过委托来实时获取一个变量,示例中直接获取value的文本值,拼接到结果中。
* ● TextBlockBuilder 可以不依靠如`DelegateBlock`这样的包裹器,可以直接将返回字符串类型的方法委托传入,blocker 会自动识别;前提是开启对应 blocker 里的`compatibility`兼容性检查,但这会带来额外的性能开销,如果没有特别的需求,建议还是使用类似`DelegateBlock`这样的预设值包裹进行多态封装,也会更安全。
最后这样获取文本:
```
_blockBuilder.ToString(); // <color=white>重量</color>3.14<size=20>kg</size>
```
值得注意的是,目前文本包裹器没有脏标记逻辑,所以每次获取值会重新计算所有的成员。
### 高级语法包裹
在新的更新中,包裹器支持域写法,同时可以省略部分参数:
### 进阶包裹语法
在新的更新中,包裹器支持域写法,初始化函数中的部分参数可以省略不写,这会替换为常规的默认颜色。
使用域写法而不是写在初始化参数中会更具有可读性,两种写法可以混用,初始化中的参数会优先设置。
```
_blockBuilder = new TextBlockBuilder()
{
new ColorBlock() // 默认值就是白色
{ "重量" },
new BBlock(new SizeBlock(16, new ColorBlock("重量"))),
new NumberValueBlock(3.14f),
new SizeBlock(20) // 默认单位为像素
new SizeBlock(20)
{ "kg" }
};
_blockBuilder.ToString(); // <color=white>重量</color>3.14<size=20>kg</size>
_blockBuilder.ToString(); // <B><size=16><color=white>重量</color></size><b>3.14<size=20>kg</size>
```
这里的作用与上面的示例完全一致,更新的包裹器中支持自动填入更多的默认值了,比如颜色默认为白色等,并且具有更多的值写法。
虽然看起来更长了,但是对于较复杂的格式来说可以有更强的可读性,建议这样写。
同时,委托包裹器并不是唯一设置动态参数的方式:
* ● `SetParamters`:在根包裹器上使用赋值方法,可以将一系列值一一对应地填入到后续一系列包裹器中。
* ● `RefernceBlock`:反射包裹器允许传入一个对象,以及成员名称来访问属性 (字段,访问器,方法均可) 。
* ● `ValueBlock`:值包裹器,搭配`SetParamters`来设置值,目标需要实现Tostring方法。
* ● `NumberValueBlock`数值类型包裹器,搭配`SetParamters`来设置值,设置值会自动限制在最大最小范围内,如果给定的参数是字符串类型,将尝试通过默认的格式化方法转为数值。
#### 反射包裹器
在实际使用时,只有`ValueBlock`这样的纯值包裹器默认会从`SetParamters`参数列表中获取值,
使用 `RefernceBlock` 在目标对象上直接访问一个指定名称的成员,如字段,访问器,方法。
#### 值包裹器
使用 `ValueBlock` 作为一个占位符,在执行ToString时将会直接将里面的文本值填充到位。
在根包裹器上使用`.SetParamters()`方法时,此包裹器默认会占用索引,并尝试将对应的值序列化为文本保存起来。
初始化时还可以指定`name`这个名称用于查找。
#### 数值包裹器
使用 `NumberValueBlock` 作为一个带有数值检查的占位符,需要初始时填入默认值。
在初始化时,可以同时指定数值钳制范围,当通过`.SetParamters()`方法设置数值时,将会自动钳制数值在这个数值范围内。
或在初始化时,指定`enableInvalidValue`,当`.SetParamters()`方法设置数值超出范围时,将会标记为无效值,此时输出的内容将是`invalidString`的内容,默认是`--`。
#### 包裹器赋值
使用`.SetParamters()`在根包裹器上向其中的所有成员赋值。
实际使用时,只有`ValueBlock`这样的纯值包裹器默认会从`SetParamters`参数列表中获取值,
其他包裹器需要手动通过`SetParameterization`设置为参数化包裹器,否则不会响应参数列表。
就像这样:
```