Textヘルパー

Textヘルパーには、テキスト処理に関する便利な機能があります。リンク付与やテキストの抜粋・ハイライトや切り取り処理など。

autoLinkEmails

テキスト内のメールアドレスを抽出して、リンクを付ける
[php]
<?php
$my_text = 'For more information regarding our world-famous pastries and desserts, contact info@example.com';
echo $this->Text->autoLinkEmails($my_text);
?>
// HTML
For more information regarding our world-famous pastries and desserts,
contact <a href="mailto:info@example.com">info@example.com</a>
[/php]

autoLinkUrls

テキスト内のリンクを抽出して、リンクを付ける (https, http, ftp, nntpが対象)

highlight

特定のテキストをハイライト表示する
[php]
<?php
$last_sentence = 'Highlights $needle in $haystack using the $options['format'] string specified or a default string.';
echo $this->Text->highlight($last_sentence, 'using',array('format'=>'<span class="highlight">\1</span>');
?>
// HTML
Highlights $needle in $haystack <span class="highlight">using</span> the $options['format'] string specified or a default string.
[/php]

"look for a needle in a haystack"で「干し草の山の中にある1本の針を探す」という意味になる。

autoLink

テキスト内のリンク(https, http, ftp, nntp)とメールアドレスを抽出して、リンクを付ける。

$htmlOptionsの使い方によっては、使える?

excerpt

テキスト内から抜粋する
[php]
<?php
$last_paragraph =
'Extracts an excerpt from $haystack surrounding the $needle with a number of characters on each side determined by $radius, and suffixed with $ending.
This method is especially handy for search results.
The query string or keywords can be shown within the resulting document.';
echo $this->Text->excerpt(
$last_paragraph,
'method',
50
);
?>
// HTML
mined by $radius, and suffixed with $ending. This method is especially handy for search results. The query...
[/php]

対象のテキスト$haystackから$needleを中心にして前後文字数($radius)

stripLinks

テキスト内のリンクをはずす。

toList

配列データからカンマ区切りのリストを出力する。最後の2項目は"and"で出力する。
[php]
<?php
echo $this->Text->toList($colors);
?>
// HTML
red, orange, yellow, green, blue, indigo and violet
[/php]

truncate

長くなったテキストを指定の長さに切り取ります。
どうやら、省略後の文字数(&length)には'ending'の文字列分も含まれるようです。"..."とすると最大47文字表示になります。
[php]
<?php
$my_text = '';
echo $this->Text->truncate(
$my_text, // 対象のテキスト
50, // トランケートする文字数
array(
'ending' => '...',// (デフォルト：'...') テキストの終わりを表すサイン
'exact' => true // (デフォルト:true) falseの場合、単語の途中で切り取らず単語の終りで区切る
'html' => false // (デフォルト:false) trueの場合、htmlタグを切り取らない
)
);
?>
[/php]

Related

テキストから指定文字数で抜粋「excerpt」「truncate」「tail」 テキストから指定文字をハイライト「highlight」・配列をリストに展開「toList」・二重改行を<p>タグへ変換「autoParagraph」 テキストから自動的にリンクを付与「autoLink」と除去「stripLinks」 Htmlヘルパー Formヘルパーのinputタグのdiv/labelなどの設定 複数ファイルアップロード ネストしたリストを出力「nestedList」 recursive設定によるfind()性能改善