CodeIgniter 使用手冊版本 2.2.0


Typography 類別

Typography 類別可以幫忙做文字的格式化

初始化類別

就像大多數在 CI 中的類別一樣,在控制器中初始化 Typography 類別使用 $this->load->library 函數:

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

載入之後,Typography 類別可以這樣使用: $this->typography

auto_typography()

為了語義上的表達與 HTML 排版上的正確性,因此需要做格式化文字的動作,在輸入一個字串後它將回傳以下的格式:

範例:

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

參數

有一個參數可以決定是否將超過二個以上的換行轉換成只有二個,參數值為: TRUEFALSE

預設值為: FALSE

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

注意: 當有大量的內容要格式化時,你可以考慮將網頁做 caching

format_characters()

這個函數與 auto_typography 非常相似,但它只做:

範例:

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

nl2br_except_pre()

將換行加上 <br /> 標籤,除非它出現在 <pre> 標籤的裡面,這個函數與 PHP 原生函數 nl2br() 相同,差別在對於 <pre> 的忽略與否

範例:

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

protect_braced_quotes

當你在 Template Parser 這個類別中使用 Typography 做格式化時,將 protect_braced_quotes 設定為 TRUE,可防止引號被轉換

範例:

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