2010年9月22日

smarty用法

在smarty可以使用{$variable|cat:"要合併的字串"}來將變數及字串合併。(在PHP要這樣使用-$variable . "要合併的字串")

其語法:{$variable|函數名稱:參數…}

主要函數說明:

capitalize 英文字首大寫
    {$variable|capitalize} 每個單字中若有非英文字母者不轉換
    {$variable|capitalize:true}

cat 字串合併
    {$variable|cat:"字串內容"}

count_characters算字串長度
    {$variable|count_characters} 不計算空白及標點符號。
    {$variable|count_characters:true}

count_paragraphs計算段落數
    {$variable|count_paragraphs}

count_sentences 計算句數
    {$variable|count_sentences}

count_words 計算單字數
    {$variable|count_words}

default 設定變數預設值
    {$variable|default:"字串內容"} 變數無內容時的預設值

date_format 轉換時間格式
    {$variable| date_format:"時間格式字串"} 設定時間的格式 (時間參數請參照官網)

string_format 轉換數字格式
    {$variable|string_format:"%.2f"} 傳回小數點兩位
    {$variable|string_format:"%d"} 傳回整數

escape將字串轉換成編碼
    {$variable|escape} 預設為參數"html"
    {$variable|escape:"html"} 將 & " ' < > 等字元轉換為編碼
    {$variable|escape:"htmlall"} 轉換所有的html
    {$variable|escape:"url"} 轉換成url編碼
    {$variable|escape:"quotes"} 轉換引號
    {$variable|escape:"hex"} 轉換16進位(網址)
    {$variable|escape:"hexentity"} 轉換16進位(字串)

upper轉成大寫
    {$variable|upper}

lower 轉成小寫
    {$variable|lower}

nl2br 將換行字元取代html的
    {$variable|nl2br}

replace 取代字串
    {$variable|replace:"被取代的字串":"取代成的字串"}

regex_replace 使用正規式取代字串

    {$variable|replace:"正規式":"取代成的字串"}

truncate 裁切字串
    {$variable|truncate} 預設長度為前80字元
    {$variable|truncate:數字} 自訂裁切的長度,預設的字串結尾為"..."
    {$variable|truncate:數字:"字串"} 自訂結尾的字串
    {$variable|truncate:數字:"字串":true} 長度計算包含結尾字串的長度

spacify 在字串的每個字元間插入空白
{$variable|spacify} 在每個字元之間插入一個空白
{$variable|spacify:"字串內容"} 在每個字元之間插入自訂的字串

strip 除去多餘的空白

    {$variable|strip} 除去多餘1個以上的空白
    {$variable|strip:"字串內容"} 將空白換成自訂的字串

strip_tags 除去html的標籤
    {$variable|strip_tags}

indent設定縮排
    {$variable|indent} 預設的縮排為四格空白
    {$variable|indent:數目} 縮排格空白數
    {$variableindent:數目:"字串內容"} 自訂縮排的字串(非空白)

wordwrap 設定文字邊界
    {$variable|wordwrap:長度} 設定每行文字的字數
    {$variable|wordwrap:長度:"換行字串"} 設定換行結尾的字串
    {$variable|wordwrap:長度:"換行字串":true} 長度計算不包含換行的字串