StringHelper
用于渲染经过处理的字符串的 HTML 辅助类。
抽象
| 自版本 |
1.6 |
|---|---|
| 包 |
Joomla CMS |
方法
缩写
缩写超过指定字符限制的文本字符串。此行为将在文本中插入省略号，替换可变大小的部分以确保字符串不超过定义的最大长度。此方法支持 UTF-8。
abridge( text, length = 50, intro = 30) :
静态
例如，它将“Really long title”转换为“Really...title”。
请注意，此方法不扫描 HTML 标签，因此可能会破坏它们。
| 自版本 |
1.6 |
|---|
参数
- 文本
string要缩写的文本。- 长度
int文本的最大长度（默认为 50）。- 简介
int简介文本的最大长度（默认为 30）。
响应
string缩写后的文本。
截断
截断超过指定字符限制的文本块并关闭所有打开的 HTML 标签。该方法可以选择不截断单个单词，它将找到限制内的第一个空格并在该点截断。此方法支持 UTF-8。
truncate( text, length, noSplit = true, allowHtml = true) :
静态
| 自版本 |
1.6 |
|---|
参数
- 文本
string要截断的文本。- 长度
int文本的最大长度。- 不分割
bool如果在截止点处不分割单词（默认值：true）。- 允许 HTML
bool允许输出中包含 HTML 标签，并关闭所有打开的标签（默认值：true）。
响应
string截断后的文本。
复杂截断
扩展截断方法以处理更复杂情况的方法
truncateComplex( html, maxLength, noSplit = true) :
静态
目标是获得适当长度的纯文本字符串，并尽可能多地保留 HTML，并正确关闭所有标签。
| 注意 |
如果选择的最大长度为 3 或更少，并且文本的字符数超过该数字，则将显示省略号。此方法不会从格式错误的 HTML 创建有效的 HTML。 |
|---|---|
| 自版本 |
3.1 |
参数
- html
string要截断的简介文本内容- 最大长度
int要呈现的最大字符数- 不分割
bool如果在截止点处不分割单词（默认值：true）。
响应
string截断后的字符串。如果字符串被截断，则会在末尾添加省略号 (...)。