この記事は最後に更新してから1年以上経過しています。
説明
標準で用意されているスタイルを知っておくことで、独自に用意するスタイルを軽減でき、機能拡張した部分の見た目は違和感が少なくなる。そんな共通要素のスタイルのひとつが「メッセージ」だ。メッセージにはいくつかの意味合いがあり、用途に応じてすぐに使い分けすることになる。今回はそんなメッセージ向けのスタイルをざっくりまとめてみた。
メッセージの基本スタイル
管理画面向けのプラグインでは、ユーザーの操作に対応してさまざまなメッセージを出力する。管理画面向けのスタイルは標準で読み込まれており、プラグインで簡単にすぐに利用できる。メッセージはdiv要素とp要素で構成するのが一般的で、div要素にはnoticeクラスなどを指定する。
<div class="notice notice-success notice-alt">メッセージ
青字のクラスで色味を選択し、赤字のnotice-altクラスを指定した場合は同系色の別バリエーションとなる。
| noticeクラス | 出力イメージ |
|---|---|
| .notice-success |  |
| .notice-success.notice-alt |  |
| .notice-warning |  |
| .notice-warning.notice-alt |  |
| .notice-error |  |
| .notice-error.notice-alt |  |
| .notice-info |  |
| .notice-info.notice-alt |  |
この8種類が基本形になり、クラス指定にはエイリアスもあるがここでは割愛する。
非表示ボタンを付ける
応用例の1つとして、div要素にis-dismissibleクラスを追加することで、ユーザーがメッセージを非表示にできるボタン（アイコン）を付けることができる。
メッセージ
この内容を実際に出力すると次のような表示となる。
開発者は、ボタン部分のHTML要素だけでなく、クリック時にこのメッセージを非表示にするスクリプトも用意する必要はない。
最終更新 : 2019年07月30日 14:23
お勧め
wp_print_inline_script_tag（2021年4月19日 更新）
void wp_print_inline_script_tag( string $javascript [ , array $attributes = array() ] )
インラインJavaScriptを含むscript要素を出力する。
register_rest_route（2022年8月17日 更新）
bool register_rest_route( string $namespace, string $route [ , array $args = array() [ , bool $override = false ] ] )
REST APIのルートを登録する。
wp_determine_option_autoload_value（2024年7月22日 更新）
string wp_determine_option_autoload_value( string $option, mixed $value, mixed $serialized_value, boo l |string $autoload )
自動ロードのトリガー値を取得する。
single_tag_title（2018年5月27日 更新）
string single_tag_title( [ string $prefix = '' [ , bool $display = true ] ] )
投稿タグアーカイブページの投稿タグ名を取得し、パラメータ$displayがtrueならば表示する。$displayがfalseの場合は、文字列として返す。
home_url（2023年3月31日 更新）
string home_url( [ string $path = '' [ , string $scheme = null ] ] )
現在のブログ（サイト）のホームURLを取得する。ホームURLは、管理者ページの「設定」-「一般」の「サイトのアドレス(URL)」のこと。