如何在Unity中将TextMeshPro的StyleTags转换为实际RichText标签?
TextMeshPro 自定义样式标签转换实现方法
核心逻辑
整体实现不需要侵入TextMeshPro的内置解析流程,核心分三步完成:建立样式映射规则、正则精准匹配目标标签、按规则替换得到最终可解析的TMP富文本字符串。
1. 预定义样式映射表
首先需要把所有自定义style标签对应的实际富文本标签,整理成可配置的映射关系。因为Unity原生不支持字典序列化,实际开发中可以用两个平行的可序列化列表实现配置能力:
- 列表1存样式名称,对应
<style=XXX>里的XXX内容,比如Title - 列表2存该样式对应的实际起始标签串,比如
<size=125%><align=center>
配置完成后把这组映射存在全局可访问的位置,不用每次替换都重新加载配置。
2. 正则匹配规则
为了避免误伤正常文本,不要用简单的字符串查找替换,用精准匹配style标签的正则规则:@"<style=([^>]+)>"
规则说明:
- 只匹配以
<style=开头的标准TMP样式标签结构 - 捕获组
([^>]+)提取标签内的样式名,仅匹配到第一个>之前的非空内容,不会和文本里的其他富文本标签混淆 - 兼容性覆盖带空格、无引号的常规style标签写法
3. 替换流程实现
写通用的替换工具方法,流程如下:
- 遍历输入的原始文本,用上面的正则找出所有匹配到的style标签
- 对每个匹配项,提取捕获组里的样式名,去提前配置好的映射表里找对应的实际标签值
- 如果映射表存在该样式:把整个匹配到的原
<style=XXX>标签,替换成映射表对应的实际标签串 - 如果映射表不存在该样式:保留原标签不做替换,避免出现文本内容丢失
可直接复用的C#实现示例:
// rawText为带style标签的原始TMP文本,styleMap为提前配置的样式映射字典 public static string ConvertStyleTags(string rawText, Dictionary<string, string> styleMap) { var styleTagRegex = new Regex(@"<style=([^>]+)>"); return styleTagRegex.Replace(rawText, match => { // 提取匹配到的样式名称 var styleName = match.Groups[1].Value; // 存在对应配置则替换为实际标签,否则保留原标签 return styleMap.TryGetValue(styleName, out var actualTag) ? actualTag : match.Value; }); }
实际替换执行的过程示例:
原始文本:
<style=Title>This is a Title (...)
正则匹配到的完整标签串:<style=Title>,提取到的样式名为Title
从映射表查到Title对应的实际标签为<size=125%><align=center>
替换完成后的最终文本:<size=125%><align=center>This is a Title (...)
常见注意事项
- 如果你的文本中使用了带闭合标签的style写法,比如
</style=Title>,可以额外补充一组正则匹配这类闭合标签,根据样式的实际配置替换成对应的闭合逻辑,避免样式异常延伸到后续文本 - 不要用无规则的全字符串替换,否则容易把文本里偶然出现的和style标签格式一致的普通内容误替换
- 对映射表做内存缓存,不要每次替换文本都重新读取配置文件,减少运行时性能消耗
内容的提问来源于stack exchange,提问作者Bugzzi Snu
相关产品推荐
相关产品推荐

