Typography 类

Typography 库包含一些方法用于帮助您以语义相关的方式设置文本格式。

加载类库

与 CodeIgniter 的所有其他服务一样,可以通过 Config\Services 来加载,通常不需要手动加载:

$typography = \Config\Services::typography();

可用的静态方法

以下的方法是可用的:

autoTypography()

autoTypography($str[, $reduce_linebreaks = FALSE])
参数:
  • $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);