wp_enqueue_script
(r16以降)
wp_enqueue_script - スクリプトを出力用のキューに入れる
wp_enqueue_script - スクリプトを出力用のキューに入れる
説明
void wp_enqueue_script( string $handle [ , string $src = false [ , array $deps = array() [ , string $ver = false [ , bool $in_footer = false ] ] ] ] )
スクリプト（JavaScript）の重複出力を回避するために、使用するスクリプトを出力用のキューに入れる。パラメータ$srcが指定された場合は、グローバル変数$wp_scriptsに登録してから出力用のキューに入れる。
パラメータ
- $handleスクリプトのハンドル名を指定。
- $srcスクリプトのパス名を指定（省略時はfalse）。
- $deps関連するスクリプトのハンドル名を配列で指定（省略時はarray()）。
- $varスクリプトのバージョンを指定（省略時はfalse）。
- $in_footerwp_footerで出力する場合はtrueを指定（省略時はfalse）。
返り値
返り値はありません。注意
このwp_enqueue_script関数の呼び出しは、原則的にinitアクションの実行後に行うこと。キューに入れたスクリプトはwp_head関数またはwp_footer関数（実際はその中のアクション）によって出力される。スクリプトはグローバル変数$wp_scriptsのプロパティregisteredに連想配列として登録される。デフォルトで登録されているスクリプトは次の通りである（3.3時点）。
| ハンドル名(handle) | パス名(src) | 関連するスクリプト(deps) | バージョン(ver) | 出力関数 |
|---|---|---|---|---|
| utils | /wp-admin/js/utils.js | - | 20101110 | wp_head |
| common | /wp-admin/js/common.js | jquery, hoverIntent, utils | 20111130 | wp_head, wp_footer |
| sack | /wp-includes/js/tw-sack.js | - | 1.6.1 | wp_footer |
| quicktags | /wp-includes/js/quicktags.js | - | 20111114 | wp_footer |
| colorpicker | /wp-includes/js/colorpicker.js | prototype | 3517m | wp_head |
| editor | /wp-admin/js/editor.js | utils, jquery | 20111117 | wp_head, wp_footer |
| wp-fullscreen | /wp-admin/js/wp-fullscreen.js | jquery | 20111116 | wp_head, wp_footer |
| prototype | /wp-includes/js/prototype.js | - | 1.6.1 | wp_head |
| wp-ajax-response | /wp-includes/js/wp-ajax-response.js | jquery | 20091119 | wp_head, wp_footer |
| wp-pointer | /wp-includes/js/wp-pointer.js | jquery-ui-widget, jquery-ui-position | 20111129a | wp_head, wp_footer |
| autosave | /wp-includes/js/autosave.js | schedule, wp-ajax-response | 20111129 | wp_head, wp_footer |
| wp-lists | /wp-includes/js/wp-lists.js | wp-ajax-response | 20110521 | wp_head, wp_footer |
| scriptaculous-root | /wp-includes/js/scriptaculous/wp-scriptaculous.js | prototype | 1.8.3 | wp_head |
| scriptaculous-builder | /wp-includes/js/scriptaculous/builder.js | scriptaculous-root | 1.8.3 | wp_head |
| scriptaculous-dragdrop | /wp-includes/js/scriptaculous/dragdrop.js | scriptaculous-builder, scriptaculous-effects | 1.8.3 | wp_head |
| scriptaculous-effects | /wp-includes/js/scriptaculous/effects.js | scriptaculous-root | 1.8.3 | wp_head |
| scriptaculous-slider | /wp-includes/js/scriptaculous/slider.js | scriptaculous-effects | 1.8.3 | wp_head |
| scriptaculous-sound | /wp-includes/js/scriptaculous/sound.js | scriptaculous-root | 1.8.3 | wp_head |
| scriptaculous-controls | /wp-includes/js/scriptaculous/controls.js | scriptaculous-root | 1.8.3 | wp_head |
| scriptaculous | - | scriptaculous-dragdrop, scriptaculous-slider, scriptaculous-controls | 1.8.3 | wp_head |
| cropper | /wp-includes/js/crop/cropper.js | scriptaculous-dragdrop | 20070118 | wp_head |
| jquery | /wp-includes/js/jquery/jquery.js | - | 1.7.1 | wp_head |
| jquery-ui-core | /wp-includes/js/jquery/ui/jquery.ui.core.min.js | jquery | 1.8.16 | wp_head, wp_footer |
| jquery-effects-core | /wp-includes/js/jquery/ui/jquery.effects.core.min.js | jquery | 1.8.16 | wp_head, wp_footer |
| jquery-effects-blind | /wp-includes/js/jquery/ui/jquery.effects.blind.min.js | jquery-effects-core | 1.8.16 | wp_head, wp_footer |
| jquery-effects-bounce | /wp-includes/js/jquery/ui/jquery.effects.bounce.min.js | jquery-effects-core | 1.8.16 | wp_head, wp_footer |
| jquery-effects-clip | /wp-includes/js/jquery/ui/jquery.effects.clip.min.js | jquery-effects-core | 1.8.16 | wp_head, wp_footer |
| jquery-effects-drop | /wp-includes/js/jquery/ui/jquery.effects.drop.min.js | jquery-effects-core | 1.8.16 | wp_head, wp_footer |
| jquery-effects-explode | /wp-includes/js/jquery/ui/jquery.effects.explode.min.js | jquery-effects-core | 1.8.16 | wp_head, wp_footer |
| jquery-effects-fade | /wp-includes/js/jquery/ui/jquery.effects.fade.min.js | jquery-effects-core | 1.8.16 | wp_head, wp_footer |
| jquery-effects-fold | /wp-includes/js/jquery/ui/jquery.effects.fold.min.js | jquery-effects-core | 1.8.16 | wp_head, wp_footer |
| jquery-effects-highlight | /wp-includes/js/jquery/ui/jquery.effects.highlight.min.js | jquery-effects-core | 1.8.16 | wp_head, wp_footer |
| jquery-effects-pulsate | /wp-includes/js/jquery/ui/jquery.effects.pulsate.min.js | jquery-effects-core | 1.8.16 | wp_head, wp_footer |
| jquery-effects-scale | /wp-includes/js/jquery/ui/jquery.effects.scale.min.js | jquery-effects-core | 1.8.16 | wp_head, wp_footer |
| jquery-effects-shake | /wp-includes/js/jquery/ui/jquery.effects.shake.min.js | jquery-effects-core | 1.8.16 | wp_head, wp_footer |
| jquery-effects-slide | /wp-includes/js/jquery/ui/jquery.effects.slide.min.js | jquery-effects-core | 1.8.16 | wp_head, wp_footer |
| jquery-effects-transfer | /wp-includes/js/jquery/ui/jquery.effects.transfer.min.js | jquery-effects-core | 1.8.16 | wp_head, wp_footer |
| jquery-ui-accordion | /wp-includes/js/jquery/ui/jquery.ui.accordion.min.js | jquery-ui-core, jquery-ui-widget | 1.8.16 | wp_head, wp_footer |
| jquery-ui-autocomplete | /wp-includes/js/jquery/ui/jquery.ui.autocomplete.min.js | jquery-ui-core, jquery-ui-widget, jquery-ui-position | 1.8.16 | wp_head, wp_footer |
| jquery-ui-button | /wp-includes/js/jquery/ui/jquery.ui.button.min.js | jquery-ui-core, jquery-ui-widget | 1.8.16 | wp_head, wp_footer |
| jquery-ui-datepicker | /wp-includes/js/jquery/ui/jquery.ui.datepicker.min.js | jquery-ui-core | 1.8.16 | wp_head, wp_footer |
| jquery-ui-dialog | /wp-includes/js/jquery/ui/jquery.ui.dialog.min.js | jquery-ui-resizable, jquery-ui-draggable, jquery-ui-button, jquery-ui-position | 1.8.16 | wp_head, wp_footer |
| jquery-ui-draggable | /wp-includes/js/jquery/ui/jquery.ui.draggable.min.js | jquery-ui-core, jquery-ui-mouse | 1.8.16 | wp_head, wp_footer |
| jquery-ui-droppable | /wp-includes/js/jquery/ui/jquery.ui.droppable.min.js | jquery-ui-draggable | 1.8.16 | wp_head, wp_footer |
| jquery-ui-mouse | /wp-includes/js/jquery/ui/jquery.ui.mouse.min.js | jquery-ui-widget | 1.8.16 | wp_head, wp_footer |
| jquery-ui-position | /wp-includes/js/jquery/ui/jquery.ui.position.min.js | jquery | 1.8.16 | wp_head, wp_footer |
| jquery-ui-progressbar | /wp-includes/js/jquery/ui/jquery.ui.progressbar.min.js | jquery-ui-widget | 1.8.16 | wp_head, wp_footer |
| jquery-ui-resizable | /wp-includes/js/jquery/ui/jquery.ui.resizable.min.js | jquery-ui-core, jquery-ui-mouse | 1.8.16 | wp_head, wp_footer |
| jquery-ui-selectable | /wp-includes/js/jquery/ui/jquery.ui.selectable.min.js | jquery-ui-core, jquery-ui-mouse | 1.8.16 | wp_head, wp_footer |
| jquery-ui-slider | /wp-includes/js/jquery/ui/jquery.ui.slider.min.js | jquery-ui-core, jquery-ui-mouse | 1.8.16 | wp_head, wp_footer |
| jquery-ui-sortable | /wp-includes/js/jquery/ui/jquery.ui.sortable.min.js | jquery-ui-core, jquery-ui-mouse | 1.8.16 | wp_head, wp_footer |
| jquery-ui-tabs | /wp-includes/js/jquery/ui/jquery.ui.tabs.min.js | jquery-ui-core, jquery-ui-widget | 1.8.16 | wp_head, wp_footer |
| jquery-ui-widget | /wp-includes/js/jquery/ui/jquery.ui.widget.min.js | jquery | 1.8.16 | wp_head, wp_footer |
| jquery-form | /wp-includes/js/jquery/jquery.form.js | jquery | 2.73 | wp_head, wp_footer |
| jquery-color | /wp-includes/js/jquery/jquery.color.js | jquery | 2.0-4561m | wp_head, wp_footer |
| suggest | /wp-includes/js/jquery/suggest.js | jquery | 1.1-20110113 | wp_head, wp_footer |
| schedule | /wp-includes/js/jquery/jquery.schedule.js | jquery | 20m | wp_head, wp_footer |
| jquery-query | /wp-includes/js/jquery/jquery.query.js | jquery | 2.1.7 | wp_head, wp_footer |
| jquery-serialize-object | /wp-includes/js/jquery/jquery.serialize-object.js | jquery | 0.2 | wp_head, wp_footer |
| jquery-hotkeys | /wp-includes/js/jquery/jquery.hotkeys.js | jquery | 0.0.2m | wp_head, wp_footer |
| jquery-table-hotkeys | /wp-includes/js/jquery/jquery.table-hotkeys.js | jquery, jquery-hotkeys | 20090102 | wp_head, wp_footer |
| thickbox | /wp-includes/js/thickbox/thickbox.js | jquery | 3.1-20111117 | wp_head, wp_footer |
| jcrop | /wp-includes/js/jcrop/jquery.Jcrop.js | jquery | 0.9.8-20110113 | wp_head, wp_footer |
| swfobject | /wp-includes/js/swfobject.js | - | 2.2 | wp_head |
| plupload | /wp-includes/js/plupload/plupload.js | - | 1511-20111112 | wp_head |
| plupload-html5 | /wp-includes/js/plupload/plupload.html5.js | plupload | 1511-20111112 | wp_head |
| plupload-flash | /wp-includes/js/plupload/plupload.flash.js | plupload | 1511-20111112 | wp_head |
| plupload-silverlight | /wp-includes/js/plupload/plupload.silverlight.js | plupload | 1511-20111112 | wp_head |
| plupload-html4 | /wp-includes/js/plupload/plupload.html4.js | plupload | 1511-20111112 | wp_head |
| plupload-all | - | plupload, plupload-html5, plupload-flash, plupload-silverlight, plupload-html4 | 1511-20111112 | wp_head |
| plupload-handlers | /wp-includes/js/plupload/handlers.js | plupload-all, jquery | 20111120 | wp_head |
| swfupload | /wp-includes/js/swfupload/swfupload.js | - | 2201-20110113 | wp_head |
| swfupload-swfobject | /wp-includes/js/swfupload/plugins/swfupload.swfobject.js | swfupload, swfobject | 2201a | wp_head |
| swfupload-queue | /wp-includes/js/swfupload/plugins/swfupload.queue.js | swfupload | 2201 | wp_head |
| swfupload-speed | /wp-includes/js/swfupload/plugins/swfupload.speed.js | swfupload | 2201 | wp_head |
| swfupload-all | /wp-includes/js/swfupload/swfupload-all.js | - | 2201a | wp_head |
| swfupload-handlers | /wp-includes/js/swfupload/handlers.js | swfupload-all, jquery | 2201-20110524 | wp_head |
| comment-reply | /wp-includes/js/comment-reply.js | - | 20090102 | wp_head |
| json2 | /wp-includes/js/json2.js | - | 2011-02-23 | wp_head |
| imgareaselect | /wp-includes/js/imgareaselect/jquery.imgareaselect.js | jquery | 0.9.6-20110515 | wp_head, wp_footer |
| password-strength-meter | /wp-admin/js/password-strength-meter.js | jquery | 20101027 | wp_head, wp_footer |
| user-profile | /wp-admin/js/user-profile.js | jquery, password-strength-meter | 20110628 | wp_head, wp_footer |
| admin-bar | /wp-includes/js/admin-bar.js | - | 20111130 | wp_footer |
| wplink | /wp-includes/js/wplink.js | jquery, wpdialogs | 20111128 | wp_head, wp_footer |
| wpdialogs | /wp-includes/js/tinymce/plugins/wpdialogs/js/wpdialog.js | jquery-ui-dialog | 20110528 | wp_head, wp_footer |
| wpdialogs-popup | /wp-includes/js/tinymce/plugins/wpdialogs/js/popup.js | wpdialogs | 20110421 | wp_head, wp_footer |
| word-count | /wp-admin/js/word-count.js | jquery | 20110515 | wp_head, wp_footer |
| media-upload | /wp-admin/js/media-upload.js | thickbox | 20110930 | wp_head, wp_footer |
| hoverIntent | /wp-includes/js/hoverIntent.js | jquery | 20090102 | wp_head, wp_footer |
「関連するスクリプト(deps)」のハンドル名のスクリプトは、それらがwp_enqueue_script関数にて指定されていない場合でも自動的に出力されるものになる。例えば、wp_enqueue_script( 'jquery-ui-tabs' )を指定した場合は、次のようにwp-head関数で'jquery'が、wp-footer関数で'jquery-ui-core'、'jquery-ui-widget'、'jquery-ui-tabs'のスクリプトが出力される。
<head>
<script type='text/javascript' src='http://localhost/wp/wp-includes/js/jquery/jquery.js?ver=1.7.1'></script>
</head>
<body class="home">
<!-- 中略 -->
<footer>
<script type='text/javascript' src='http://localhost/wp/wp-includes/js/jquery/ui/jquery.ui.core.min.js?ver=1.8.16'></script>
<script type='text/javascript' src='http://localhost/wp/wp-includes/js/jquery/ui/jquery.ui.widget.min.js?ver=1.8.16'></script>
<script type='text/javascript' src='http://localhost/wp/wp-includes/js/jquery/ui/jquery.ui.tabs.min.js?ver=1.8.16'></script>
</footer>
</body>
使用例
- jQueryをキューに入れる。<?php wp_enqueue_script( 'jquery' ); ?>
- テーマ独自スクリプト'mytheme-js'を$wp_scriptsに登録後、キューに入れる。<?php wp_enqueue_script( 'mytheme-js', get_template_directory_uri().'/js/mytheme.js' ); ?>
- テーマ独自スクリプト'mytheme-js'とjQueryをキューに入れる。<?php wp_enqueue_script( 'mytheme-js', get_template_directory_uri().'/js/mytheme.js', array( 'jquery' ) ); ?>
フィルター
実行するフィルターはありません。アクション
実行するアクションはありません。ソースファイル
/wp-includes/functions.wp-scripts.php関連
- did_action - アクションが実行済みか調べる
- wp_enqueue_style - スタイルシートを出力用のキューに入れる
お勧めコンテンツ
スマートフォン向けの振り分けを自前で行う（2011年11月2日 登録）
PC向けのサイトをスマートフォン対応する場合、WPtouchやktai styleに代表されるスマートフォン対応のテンプレート切り替えプラグインを使用するのが一般的。そういったプラグインはテンプレート切り替え以外の機能も備えており、そういった機能は必ずしも必要ではない。そんなわけで、ここでは超シンプルなスマートフォン向けのテンプレート切り替えを実現する方法を紹介する。index.htmlでアーカイブページを表示させる（2011年10月14日 登録）
静的なサイトでは、各ディレクトリにindex.htmlファイルを置き、そのディレクトリの内容を紹介することが多い。WordPressで構築したサイトも同様にできないかと考え、試行錯誤してみた（こんなことを考えてるのは自分だけだろうか！？）。query_posts（WP_Queryクラス）で'tax_query'を使いこなす（2011年9月8日 登録）
2日にわたって投稿した「query_posts（WP_Queryクラス）でカテゴリーを絞り込む」「query_posts（WP_Queryクラス）で投稿タグを絞り込む」の続き。今日はカテゴリーや投稿タグ以外ののタクソノミーによる絞り込み、複数のタクソノミーの絞り込みの組み合わせについてまとめてみる。
最終更新日時 : 2011-12-26 15:34
