当前位置：首页 > news >正文

【Unity中固定宽度文本截断与省略号处理方案】

news 2026/6/14 23:45:52

在UI设计中经常遇到文本内容超出固定宽度的情况，需要实现自动截断并添加省略号的效果。以下是几种实用解决方案：

一：Text组件的自动处理

Unity的Text组件自带水平溢出处理功能：

在Inspector面板找到Text组件
设置Horizontal Overflow为Truncate
勾选Best Fit选项并设置最小/最大字号
这种简单方案适合单行文本处理

对于多行文本，需要更灵活的解决方案。

二：使用TextMeshPro的Ellipsis功能

TextMeshPro提供更专业的文本处理能力：

using TMPro; TMP_Text textComponent = GetComponent<TMP_Text>(); textComponent.overflowMode = TextOverflowModes.Ellipsis; textComponent.enableWordWrapping = false;

设置overflowMode为Ellipsis
关闭自动换行功能
调整字体大小和边距确保布局合理

三：截断算法

1. 当需要更精确控制时，可以使用以下算法：

public static string TruncateWithEllipsis(string input, int maxLength) { if (string.IsNullOrEmpty(input) || input.Length <= maxLength) { return input; } return input.Substring(0, maxLength - 3) + "..."; }

通过字符串操作手动截断
保留3个字符位置给省略号
可结合字体宽度计算进行更精确处理

2. 基于文本渲染宽度动态截断的扩展方法，适用于UI文本控件

public static class StringExtensions { public static string TruncateByWidth(this string text, float maxWidth, Text uiText, string ellipsis = "...") { if (string.IsNullOrEmpty(text)) return text; var settings = uiText.GetGenerationSettings(uiText.rectTransform.rect.size); var textGen = new TextGenerator(); // 如果文本宽度已经小于最大宽度，直接返回 if (textGen.GetPreferredWidth(text, settings) <= maxWidth) return text; var sb = new StringBuilder(); int left = 0, right = text.Length, best = 0; // 二分查找最佳长度 while (left <= right) { int mid = (left + right) / 2; sb.Clear(); sb.Append(text, 0, mid); sb.Append(ellipsis); if (textGen.GetPreferredWidth(sb.ToString(), settings) <= maxWidth) { best = mid; left = mid + 1; } else { right = mid - 1; } } sb.Clear(); sb.Append(text, 0, best); sb.Append(ellipsis); return sb.ToString(); } }

参数

text：待处理的原始字符串
maxWidth：最大允许渲染宽度
uiText：Unity的Text组件实例
ellipsis：省略符号

实现要点

使用TextGenerator计算文本渲染宽度
二分查找确定最佳截断长度
适用于动态字体或富文本场景

调用方式：

//文本对象 private Text _rechargeInfo; //文本内容 private string _contentStr; //设置固定宽度，可根据自己需求改 private int _defaultWidth = 100; private void Start() { //初始化 _contentStr="你是我的前世今生，我爱你一生一世"; //调用扩展方法 _rechargeInfo.text = StringExtensions.TruncateByWidth(_contentStr, _defaultWidth , _rechargeInfo); }