Page Contents

Text

TextHelper はビューにおいてテキストをより便利で使いやすくするメソッドを持っています。 リンクを有効にする、 URL をフォーマットする、選択した単語やフレーズの例外を作成する、テキストの塊からキーワードをハイライトする、テキストの長さを段階的に切り詰める、といったことを補助します。

autoLinkEmails

autoLinkEmails(string $text, array $htmlOptions=array())

$text の中にある電子メールアドレスに、 $htmlOptions のオプションの定義に一致するよう、リンクを設けます。 $htmlOptions については HtmlHelper::link() を参照してください。

$my_text = 'For more information regarding our world-famous pastries and desserts, contact [email protected]';
$linked_text = $text->autoLinkEmails($my_text);

Output:

For more information regarding our world-famous pastries and desserts,
contact <a href="mailto:[email protected]">info@example.com</a>

autoLinkUrls

autoLinkUrls(string $text, array $htmlOptions=array())

autoLinkEmails() と同じように動作します。このメソッドは https 、 http 、 ftp 、 または nntp から始まる文字列を探し、それらに適切なリンクを設定します。 Same as in autoLinkEmails(), only this method searches for strings that start with https, http, ftp, or nntp and links them appropriately.

excerpt

excerpt(string $haystack, string $needle, int $radius=100, string $ending="...")

$haystack から $needle の周りを、 $radius で決定した文字数だけ抜粋し、接尾辞として $ending を加えます。このメソッドは、検索結果を表示する時に特に便利です。クエリ文字列やキーワードを結果の文書中に見せることができます。

echo $text->excerpt($last_paragraph, 'method', 50);

Output:

mined by $radius, and suffixed with $ending. This method is especially handy for
search results. The query...

highlight

highlight(string $haystack, string $needle, $highlighter='<span class="highlight">\1</span>')

$haystack 中の $needle を $highlighter 文字列を使ってハイライトします。

echo $text->highlight($last_sentence, 'using');

Output:

Highlights $needle in $haystack <span class="highlight">using</span>
the $highlighter string specified.

toList

toList(array $list, $and='and')

カンマ区切りのリストを作成します。最後の二つのアイテムは‘and’で指定したもので結合します。

echo $text->toList($colors);

Output:

red, orange, yellow, green, blue, indigo and violet

truncate

truncate(string $text, int $length=100, array $options)

テキストが $length で指定したものより長かったら、$lengthの長さで切り捨て接尾辞に 'ending' を加えます。もし 'exact' が false に指定されていたら、切り詰めは次の単語の最後で行われます。'html'がtrueに指定されていたら、HTMLタグは尊重され、切り落とされることがなくなります。

$optionsは全てのオプションパラメータを渡すために使われます。また、デフォルトとして以下のキーを保持しています。これはらすべて省略可能です。

array(
    'ending' => '...',
    'exact' => true,
    'html' => false
)

echo $text->truncate(
    'The killer crept forward and tripped on the rug.',
    22,
    '...',
    false
);

Output:

The killer crept...

trim

trim()

truncateの別名です。