You need to enable JavaScript to run this app. 如何在Unity中将TextMeshPro的StyleTags转换为实际RichText标签?
优惠活动
大模型
产品
解决方案
定价
更多

如何在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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.09 15:24:09