排版
排版库包含帮助您以语义相关的方式格式化文本的方法。
加载库
与 CodeIgniter 中的所有服务一样,它可以通过 Config\Services
加载,但您通常不需要手动加载它。
<?php
$typography = \Config\Services::typography();
可用的静态函数
以下函数可用
- autoTypography($str[, $reduce_linebreaks = false])
- 参数:
$str (
string
) – 输入字符串$reduce_linebreaks (
bool
) – 是否将多个双换行符缩减为两个
- 返回值:
HTML 格式的排版安全字符串
- 返回类型:
string
格式化文本,使其在语义和排版上都是正确的 HTML。
使用示例
<?php $string = $typography->autoTypography($string);
注意
排版格式可能很费处理器,尤其是在格式化大量内容时。如果您选择使用此函数,您可能需要考虑 缓存 您的页面。
- formatCharacters($str)
- 参数:
$str (
string
) – 输入字符串
- 返回值:
带有格式化字符的字符串。
- 返回类型:
string
此函数主要将双引号和单引号转换为花括号实体,但它还会转换 em 破折号、双空格和与号。
使用示例
<?php $string = $typography->formatCharacters($string);
- nl2brExceptPre($str)
- 参数:
$str (
string
) – 输入字符串
- 返回值:
带有 HTML 格式换行符的字符串
- 返回类型:
string
将换行符转换为
<br />
标签,除非它们出现在<pre>
标签内。此函数与本机 PHPnl2br()
函数相同,只是它忽略了<pre>
标签。使用示例
<?php $string = $typography->nl2brExceptPre($string);