esc_html__

説明

string esc_html__( string $text [ , string $domain = 'default' )
エスケープ処理した翻訳テキストを取得する。

パラメータ

  • $text
    翻訳するテキストを指定。
  • $domain
    ドメイン名を指定(省略時は'default')。

返り値

パラメータ$textについて現在のロケールに応じた翻訳テキストをエスケープ処理して返す。翻訳テキストが見つからなかった場合は$textをエスケープ処理して返す。


注意

__ esc_html関数の合わせ技で、すぐに表示する場合はesc_html_e関数が使える。また似たような関数として esc_attr__もある。

翻訳テキストにはhtmlタグが含まれる場合があり、当然のことながらこの関数の返り値はそれらもエスケープ処理を行う。


使用例

  • エスケープ処理した翻訳テキストを取得して表示する。
    <?php echo '<p>' . esc_html__( 'As follows', 'DOMAIN' ) . '</p>'; ?>

フィルター

実行するフィルターはありません。

アクション

実行するアクションはありません。

ソースファイル

/wp-includes/l10n.php

最終更新 : 2018年11月07日 10:25



お勧め

5.3の新機能:クエリーログに任意の項目を追加できる新フィルター(2019年10月23日 更新)

5.3 RC2」が公開され、正式リリースまであと20日。公式ディレクトリにプラグインを公開していることもあり、5.3に関する開発者向けの情報「Miscellaneous Developer Focused Changes in 5.3」を読んでいる。

Login rebuilder 2.7.4の変更内容を紹介(2022年7月6日 更新)

Login rebuilder 2.7.4では、ダッシュボードの「ログインのログ」ウィジェット内に現在のユーザー(管理者のみ)のログイン状況を簡潔なメッセージで表示するようにした。

ショートコードを含んだページを表示する前に何か処理する(2014年5月28日 更新)

固定ページまたは投稿ページに独自のフォームを埋め込む。入力→登録の2段階のフォームなら著名なプラグイン「Contact Form 7」を利用すればいいのだが、クライアントの依頼は入力→確認→登録の3段階で組み込む要素が特化していたので、独自の実装方法を考えることになった。

プラグインの設定ページもレスポンシブ対応(2014年6月3日 更新)

レスポンシブ対応したWordPressの管理画面。プラグインやテーマのカスタマイズで管理画面を拡張しているなら、切り替わるタイミングはきっちり押さえておきたいところではないだろうか。

oEmbed対応サイトを整理した(2023年8月9日 更新)

投稿記事にTwitterやYouTubeのURL(アドレス)を記述したとき、表示されるページにはリンクとしてではなく、埋め込んだURLの内容が表示される。この仕組み(機能)はoEmbedというもので、対応サイトは随時バージョンアップしている。