SSRichText

January 4, 2026 · View on GitHub

Unity UGUI RichText

实现思路来自:ZUIRichText

GIF解码思路来自:UnityGifGIF图解和压缩详解

使用的图标来自: 阿里图标库大头贴 阿里图标库多彩小植物

使用的GIF图来自网络

支持

Unity版本:Unity2020或以上经过测试可用,Unity2019及以下或Unity6均未测试

支持的富文本标签:

标签效果注释
<b></b>粗体unity原生
<i></i>斜体unity原生
<size></size>大小unity原生
<color=red></color>颜色unity原生
<s></s>删除线颜色与字体颜色相同,线宽根据字体大小动态变化
<outline=red></outline>描边<outline=red>或<outline=#ffffffff>设置颜色
<shadow=rt></shadow>阴影lt、rt、lb、rb分别表示左上、右上、左下、右下的阴影方向
<icon=xxxx/>图标需要配合IconProvider使用
<underline=red></underline>下划线<underline=red>或<underline=#ffffffff>设置颜色
<link=url></link>链接url可以填写具体的链接地址
<gif=xxxx/>动图需要配合GifDecoder和LoadManager使用
<gradient lt=red rt=red lb=red rb=red></gradient>渐变需要填写四个顶点(四角)的颜色

支持富文本点击事件:

标签事件消息参数备注
<link=url></link>OnClicktype, url-
<icon=xxxx/>OnClicktype, iconName-
<gif=xxxx/>OnClicktype, gifName-
默认OnClicktype, 文本内容包含outline、underline、shadow以及原生支持的color、size、b、i

使用方法

通过upm安装custom package

  1. 打开Unity Package Manager
  2. 点击+ -> Add package from git URL...
  3. 填写git URL:https://github.com/SlipperSoar/SSRichText.git?path=/Assets/SSRichText

通过.unitypackage安装

  1. 前往releases下载.unitypackage
  2. 拖入UnityEditor

已实现或规划中功能

  • outline描边标签
  • shadow阴影标签
  • underline下划线标签
  • icon图标标签
  • link标签
  • 富文本点击事件
  • GIF显示在富文本
  • s删除线标签
  • GIF的文本渲染到帧图上(文本扩展块不参与画面渲染)
  • gradient渐变

效果图

效果