heros/doc/mvvm/VMLabel.md

VM Label

介绍

VM组件文本监听，用于处理 Label 的监听问题。监听watchPath 路径 数值的变动情况，变动Label文本内容。使用模板模式，还可以将输入的字符串格式化。可以监听多路径，来同时在一个label上显示多个数据源的信息。

编辑器属性

• Template Mode - 多路径模板模式，开启后可以监听多路径，并且可以设置文本模板

• Watch Path - 绑定数值监听路径

• Watch PathArr - 绑定数值监听的路径数组 (多路径模板模式开启后出现)

• Label Type - 只读属性，自动绑定cc.Label 或者 cc.RichText，你可以在脚本修改自己定义的Label

关于模板解析

使用 {{0}} {{1}} {{2}} 方式设置模板内容（设置label 的 String 默认值）。在运行时，会动态的获取多路径监听的值，按数组内index 顺序替换掉 {{index}}。你可以额外添加修饰符号来格式化信息源，比如 {{0:int}} 会将数字内容以整数显示，{{0:time}} 以时间格式显示时间戳 等。

以下是目前支持的格式化内容:

• int - 只显示整数部分
• fix(n) -显示小数位数
• kmbt - 以 K M B T 单位 缩短数字长度
• per - 显示百分比
• sep - 以千位分号分割数字
• limit(n) - 限制文本字符长度

自定义模板格式

所有 文本格式处理 都放在 StringFormat 类中，你可以根据自定义需要修改其中的函数。