説明
パラメータ
- $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
関連
お勧め
プラグインのロード順を制御する(2014年6月9日 更新)
これまでプラグインがどのような順番でロードされるか意識していなかったのだが、とある自作プラグインを他のプラグインよりも先にロードさせたくなったので調べてみた。
5.3の機能強化:カスタムフィールドキーの条件指定が使いやすくなる(2019年11月19日 更新)
5.3 RC4もリリースされ、正式リリースまであと1週間。5.3の変更点を確認していると、WP_Meta_Queryクラスが変更されていた。これは「Expanded meta key comparison operators in 5.3」で紹介されており、さまざまな条件指定が追加されていた。
HTML entities button:プラグイン作ってみました(2021年4月28日 更新)
以前投稿した「HTML編集モードに定型文ボタンを追加する」をアレンジして、HTML編集モードに特殊文字(HTMLエンティティ)を挿入できるボタン、顔文字を挿入できるボタン、過去の投稿ページのリンクを挿入できるボタンを追加するプラグインを作ってみました。HTML編集モードの作業効率を向上させるプラグインです。2.1.0では「Dashiconsの挿入」を追加しました。HTML編集モードをメインに使用されている方は、お試しあれ。更新ボタンの横にスピナーを実装する(2019年5月14日 更新)
WordPressの管理画面ではAJAXを使って何らかの処理を行う際、数秒間の空き時間にアイコンがクルクル回る「スピナー」を表示しているところがある。今作っているプラグインでこの「スピナー」を使いたくなったので、実装方法を調べてみた。
「順序」をtextからnumberに変更してみた(2018年5月27日 更新)
固定ページの編集画面の「投稿の属性」ウィジェットには、ページの並び替えに使用できる「順序」のinput要素がある。この「順序」のinput要素はtype属性が'text'となっており、編集の際にIMEが有効になってしまう場合がある。ページの編集頻度が多くなると、その都度IMEをオフにするのがやや面倒になってくる。