[WordPress] 管理画面にカラーピッカー(wp_color_picker)を表示する

カラーピッカー

管理画面でプラグインの設定などでカラーピッカーを表示したい場合、wp_color_pickerを使用します。

初期表示

[色を選択]ボタンを押下すると…

色をクリックするとテキストフィールドにカラーコードが入力されます。便利。

実装

まずは外部jsファイルを作成し、そのなかでwp_color_pickerの処理を記述します。
階層は [wp-content/plugins/プラグインの名前/js] の配下に。
ファイル名は[color-picker.js]としました。（プラグインで使用の場合）

color-picker.js

(function( $ ) {
    var options = {
        defaultColor: false,
        change: function(event, ui){},
        clear: function() {},
        hide: true,
        palettes: true
    };
    $('.color-picker').wpColorPicker(options);
})( jQuery );

オプションの設定は

• defaultColor — デフォルトのカラーです。デフォルト色を設定したい場合はカラーコードの文字列を記述します。
• change — カラー変更時のイベントです。
• clear — カラークリア時のイベントです。
• hide — 画面ロード時にカラーピッカーを隠すか否か。
• paletters — カラーパレットの表示方法です。

外部jsファイルの読み込み

add_action('admin_enqueue_scripts', 'admin_scripts');
function admin_scripts($hook) {
    wp_enqueue_script('colorpicker-script',
    plugins_url('js/color-picker.js', __FILE__),
    array( 'wp-color-picker' ), false, true);
}

wp_enqueue_scriptでjsファイルを読み込みます。

テキストフィールドの記述

<input type="text" name="color" class="color-picker" value="" >

外部jsファイルに記述したクラス名を合わせます。
value値には入力済みのカラーコードを記述したりします。

まとめ

表示方法はとても簡単でした。
また、WordPress3.5からIris-Color-Pickerというプラグインが出たようですね。
(違いがよくわかりません…)