タイポグラフィ

タイポグラフィライブラリには、テキストを意味的に関連する形式でフォーマットするのに役立つメソッドが含まれています。

ライブラリの読み込み

CodeIgniter のすべてのサービスと同様に、Config\Services を介して読み込むことができますが、通常は手動で読み込む必要はありません。

<?php

$typography = \Config\Services::typography();

利用可能な静的関数

以下の関数が利用可能です。

autoTypography($str[, $reduce_linebreaks = false])
パラメーター:
  • $str (string) – 入力文字列

  • $reduce_linebreaks (bool) – 複数の改行を2つに減らすかどうか

戻り値:

HTML 形式のタイポグラフィセーフ文字列

戻り値の型:

文字列

テキストを意味的およびタイポグラフィ的に正しい HTML になるようにフォーマットします。

使用例

<?php

$string = $typography->autoTypography($string);

注意

タイポグラフィのフォーマットは、特にフォーマットされるコンテンツが多い場合、プロセッサに負荷がかかる可能性があります。この関数を使用する場合は、ページのキャッシングを検討することをお勧めします。

formatCharacters($str)
パラメーター:
  • $str (string) – 入力文字列

戻り値:

フォーマットされた文字を含む文字列。

戻り値の型:

文字列

この関数は、主に二重引用符と単一引用符を中括弧エンティティに変換しますが、em ダッシュ、二重スペース、アンパサンドも変換します。

使用例

<?php

$string = $typography->formatCharacters($string);
nl2brExceptPre($str)
パラメーター:
  • $str (string) – 入力文字列

戻り値:

HTML 形式の改行を含む文字列

戻り値の型:

文字列

改行を <br /> タグに変換しますが、<pre> タグ内にある場合は変換しません。この関数は、<pre> タグを無視することを除いて、ネイティブ PHP の nl2br() 関数と同じです。

使用例

<?php

$string = $typography->nl2brExceptPre($string);