説明
WordPressの管理画面ではAJAXを使って何らかの処理を行う際、数秒間の空き時間にアイコンがクルクル回る「スピナー」を表示しているところがある。今作っているプラグインでこの「スピナー」を使いたくなったので、実装方法を調べてみた。
「スピナー」の実体
まずは「スピナー」を表示しているページとして、「クラシックエディター」の更新ウィジェットがある。
「更新」ボタンを押し、ブラウザの開発者向け機能を使って「スピナー」を表示中のHTMLコードを確認してみた（以下は便宜上タブなどを除外）。
<div id="publishing-action">
<span class="spinner is-active"></span>
input name="original_publish" type="hidden" id="original_publish" value="更新">
<input name="save" type="submit" class="button button-primary button-large" id="publish" value="更新">
</div>
これによると、「スピナー」の実態はspan要素だった。通常時はspinnerクラスが指定され、アイコンが回転している状態ではis-activeクラスが追加されていた。
2つのクラスのスタイルは、/wp-admin/css/common.cssにて次のように定義されている。
.spinner {
background: url(../images/spinner.gif) no-repeat;
background-size: 20px 20px;
display: inline-block;
visibility: hidden;
float: right;
vertical-align: middle;
opacity: 0.7;
filter: alpha(opacity=70);
width: 20px;
height: 20px;
margin: 4px 10px 0;
}
.spinner.is-active,
.loading-content .spinner {
visibility: visible;
}
spinnerクラスは背景画像にアニメーションGIFが指定され標準では非表示。これをis-activeクラスを追加することで背景画像が表示される仕組みになっている。
実装してみた
さっそく「スピナー」を表示したいところにspan要素を追加。ここではid属性値として'update-spinner'を指定している。
<span id="update-spinner" class="spinner"></span>ボタンをクリックした際のJavaScriptコードは次のような感じ。AJAXリクエストの前にis-activeクラスを追加し、レスポンスが返ってきたらis-activeクラスを削除している。
$( '#update-spinner' ).addClass( 'is-active' );
var params = {
action: ajax_action,
_ajax_nonce: ajax_nonce,
_wp_http_referer: http_referer,
param: param,
};
$.post( ajaxurl, params, function( response ) {
// レスポンスを処理
}, 'json' )
.always( function ( data ) {
$( '#update-spinner' ).removeClass( 'is-active' );
} );
管理画面向けの場合は/wp-admin/css/common.cssは読み込まれているので、ほかに手間はいらない。「スピナー」の実装はとてもお手軽のようだ。
最終更新 : 2019年05月14日 10:20
お勧め
wp_default_editor（2011年6月21日 更新）
string wp_default_editor( )
デフォルトの投稿エディタタイプを取得する。
delete_user_meta（2019年6月7日 更新）
bool delete_user_meta( int $user_id, string $meta_key [ , mixed $meta_value = '' ] )
ユーザメタ情報（拡張情報）を削除する。
get_header（2018年5月27日 更新）
void get_header( [ string $name = null ] )
ヘッダパーツを記述したメインヘッダファイルheader.php（またはサブヘッダファイルheader-???.php）を読み込む。
add_action（2018年5月27日 更新）
bool add_action( string $tag, mixed $function_to_add [ , int $priority = 10 [ , int $accepted_args = 1 ] ] )
WordPressシステムの関数にアクション関数を追加する。
delete_option（2019年4月24日 更新）
bool delete_option( string $option )
サイトオプションを削除する。