Codeigniter 3 中文开发手册
简体中文(ZH-CN) English(EN) 繁体中文(ZH-TW) 日本語(JA) 한국어(KO) Melayu(MS) Français(FR) Deutsch(DE)
directory search
Array Array Helper Benchmarking Benchmarking Class Caching Caching Driver Calendaring Calendaring Class CAPTCHA CAPTCHA Helper Config Config Class Cookie Cookie Helper Database Connecting to your Database Custom Function Calls Database Caching Class Database Configuration Database Forge Class Database Metadata Database Quick Start: Example Code Database Reference Database Utility Class DB Driver Reference Generating Query Results Queries Query Builder Class Query Helper Methods Transactions Date Date Helper Directory Directory Helper Download Download Helper Email Email Class Email Helper Encrypt Encrypt Class Encryption Encryption Library File File Helper File Uploading File Uploading Class Form Form Helper Form Validation Form Validation FTP FTP Class Functions compatibility_functions common_functions HTML HTML Helper HTML Table HTML Table Class Image Manipulation Image Manipulation Class Inflector Inflector Helper Input Input Class Javascript Javascript Class Language Language Class Language Helper Loader Loader Class Migrations Migrations Class Number Number Helper Output Output Class Pagination Pagination Class Path Path Helper Security Security Class Security Helper Session Session Library Shopping Cart Shopping Cart Class Smiley Smiley Helper String String Helper Template Parser Template Parser Class Text Text Helper Trackback Trackback Class Typography Typography Class Typography Helper Unit Testing Unit Testing Class URI URL User Agent XML XML-RPC and XML-RPC Server Zip Encoding Zip Encoding Class XML-RPC and XML-RPC Server Classes XML Helper User Agent Class URL Helper URI Class

©
This document uses PHP Chinese website manual Release

characters

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

  • 使用印刷类

    • 初始化类

  • 类参考

使用印刷类

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排版安全的字符串

返回类型：

串

  • $ str（string） - 输入字符串

  • $ reduce_linebreaks（bool） - 是否减少后续的换行符

返回：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>中的段落（寻找双行换行来标识段落）。

  • 除了那些出现在<pre>标签中的单行换行，单行换行转换为<br />。

  • 块级元素（如<div>标记）不包含在段落内，但其包含的文本如果包含段落。

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

  • 撇号转换为卷曲撇号实体。

  • 双破折号（或者像这个或者像这样）被转换成em-dashes。

  • 在一个单词之前或之后的三个连续时间段被转换为省略号（...）。

  • 句子之后的双空格转换为非空格来模仿双空格。

用法示例：

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

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

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

注意

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

format_characters($str)

参数：

$ str（string） - 输入字符串

返回：

格式化的字符串

返回类型：

串

  • $ str（string） - 输入字符串

返回：格式化的字符串
Return type:  string
This method is similar to `auto_typography()` above, except that it only does character conversion:

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

  • 撇号转换为卷曲撇号实体。

  • 双破折号（或者像这个或者像这样）被转换成em-dashes。

  • 在一个单词之前或之后的三个连续时间段被转换为省略号（...）。

  • 句子之后的双空格转换为非空格来模仿双空格。

用法示例：

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

nl2br_except_pre($str)

参数：

$ str（string） - 输入字符串

返回：

格式化的字符串

返回类型：

串

  • $ str（string） - 输入字符串

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);

Previous article： Next article：