在线文档教程

印刷类 | Typography Class

Typography Class

印刷术类提供了帮助您设置文本格式的方法。

  • 使用印刷类

使用印刷类

Initializing the Class

像CodeIgniter中的大多数其他类一样,Typography类在您的控制器中使用以下$this->load->library()方法进行初始化:

$this->load->library('typography'

加载后,Typography库对象将可用:

$this->typography

类参考

class CI_Typography$protect_braced_quotes = FALSE

将Typography库与Template Parser库结合使用时,通常可能需要在大括号内保护单引号和双引号。要启用此功能,请将protect_braced_quotes类属性设置为TRUE。

用法示例:

$this->load->library('typography' $this->typography->protect_braced_quotes = TRUE;

auto_typography($str[, $reduce_linebreaks = FALSE])

参数:$ str(string) - 输入字符串$ reduce_linebreaks(bool) - 是否减少后续换行符
返回:HTML排版安全的字符串
返回类型:

  • $ strstring) - 输入字符串

返回:HTML排版安全的字符串

Return type: string

Formats text so that it is semantically and typographically correct HTML. Takes a string as input and returns it with the following formatting:

  • 环绕<p> </ p>中的段落(寻找双行换行来标识段落)。

用法示例:

$string = $this->typography->auto_typography($string

有一个可选参数,用于确定解析器是否应将连续两次以上的换行符减少到两个。传递布尔值TRUE以启用缩减换行符:

$string = $this->typography->auto_typography($string, TRUE

注意

印刷格式化可能是处理器密集型的,特别是如果您有很多内容被格式化。如果您选择使用此方法,则可能需要考虑缓存页面。

format_characters($str)

参数:$ str(string) - 输入字符串
返回:格式化的字符串
返回类型:

  • $ strstring) - 输入字符串

返回:格式化的字符串

Return type: string

This method is similar to `auto_typography()` above, except that it only does character conversion:

  • 报价转换为正确面对的卷烟报价实体,除了那些出现在标签内的报价实体。

用法示例:

$string = $this->typography->format_characters($string

nl2br_except_pre($str)

参数:$ str(string) - 输入字符串
返回:格式化的字符串
返回类型:

  • $ strstring) - 输入字符串

Returns: Formatted string

Return type: string

Converts newlines to <br /> tags unless they appear within <pre> tags. This method is identical to the native PHP `nl2br()` function, except that it ignores <pre> tags.

用法示例:

$string = $this->typography->nl2br_except_pre($string