CodeIgniter4 Typography 类
Typography 库包含一些方法用于帮助您以语义相关的方式设置文本格式。
加载类库
与 CodeIgniter 的所有其他服务一样,可以通过 Config\Services
来加载,通常不需要手动加载:
$typography = \Config\Services::typography();
可用的静态方法
以下的方法是可用的:
autoTypography
($str[, $reduce_linebreaks = FALSE])
autoTypography()
参数: | $str (string) – Input string |
---|---|
$reduce_linebreaks (bool) – 是否将多个双重换行减少为两个 | |
返回: | HTML 格式化的排版安全的字符串 |
返回类型: | string |
格式化文本使其成为语义和排版正确的 HTML 。
使用示例:
$string = $typography->autoTypography($string);
注解
格式排版可能会消耗大量处理器资源,特别是在排版大量内容时。 如果你选择使用这个函数的话, 你可以考虑 缓存 你的页面。
formatCharacters()
formatCharacters
($str)
参数: | $str (string) – Input string |
---|---|
返回: | 带有格式化字符的字符串 |
返回类型: | string |
将双引号或单引号转成正确的实体,也会转化—破折号,双空格和&符号。
使用示例:
$string = $typography->formatCharacters($string);
nl2brExceptPre()
nl2brExceptPre
($str)
参数: | $str (string) – Input string |
---|---|
返回: | 带有 HTML 格式化换行符的字符串 |
返回类型: | string |
将换行转换为 <br /> 标签, 忽略 <pre> 标签中的换行符。 这个函数和PHP原生的 nl2br()
函数是一样的, 但忽略 <pre> 标签。
使用示例:
$string = $typography->nl2brExceptPre($string);