説明
パラメータ
- $handleスクリプトのハンドル名を指定。
- $srcスクリプトのパス名を指定(省略時はfalse)。
- $deps関連するスクリプトのハンドル名を配列で指定(省略時はarray())。
- $varスクリプトのバージョンを指定(省略時はfalse)。
$in_footer$argswp_footerで出力する場合はtrueを指定(省略時はfalse)。[6.3.0]'strategy'、'in_footer'キーを持つ連想配列を指定(省略時はarray())
返り値
返り値はありません。注意
このwp_enqueue_script関数の呼び出しは、原則的にinitアクションの実行後に行うことになり、テーマで表示するページ向けなら'wp_enqueue_scripts'アクションを、管理ページ向けなら'admin_enqueue_scripts'アクションを利用する。キューに入れたスクリプトは wp_head関数または wp_footer関数(実際はその中のアクション)によって出力される。
スクリプトはグローバル変数$wp_scriptsのプロパティregisteredに連想配列として登録される。デフォルトで登録されているスクリプトは次の通りである(3.3時点)。
[5.2.0]'clipboard'が追加された。
[6.3.0]第5パラメータがbool型から連想配列に変更になった。連想配列は'strategy'と'in_footer'が有効であり、'strategy'の値は'defer'または'async'が、'in_footer'はtrueまたはfalseを指定できる。第5パラメータが配列以外の場合、その値はboolでキャストされ、キー'in_footer'の値となり、互換性が維持されている。ハンドル名(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 |
clipboard | /wp-admin/js/clipboard.js | utils, jquery | 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' ) ); ?>
- テーマ独自スクリプト'mytheme-js'を$wp_scriptsに登録後、フッター出力としてキューに入れる。<?php wp_enqueue_script( 'mytheme-js', get_template_directory_uri().'/js/mytheme.js', array(), false, true ); ?>
フィルター
実行するフィルターはありません。アクション
実行するアクションはありません。ソースファイル
/wp-includes/functions.wp-scripts.php最終更新 : 2023年08月09日 14:21
関連
お勧め
6.2に追加されるsearch_columnsパラメータが便利(2023年3月30日 更新)
バージョン6.2では記事検索機能を備えたWP_Queryクラスにsearch_columnsパラメータが追加される。標準のキーワード検索では、タイトル(post_title)、本文(post_content)、抜粋(post_excerpt)が対象になっているが、search_columnsパラメータを使うと対象を絞り込めるようになる。
固定ページのURLの拡張子をhtmlに変更する(2013年3月9日 更新)
固定ページについて、URLを静的ページっぽく拡張子htmlに変更したいという要望を受けることがある。これまでは「.html on PAGES」というプラグインを使っていて特に不満があったわけではないのだが、今回ひょんなことから簡単に対応できることがわかったので、メモ書きしておく。KUSANAGIでマルチサイト(サブドメイン)を試した(2019年8月6日 更新)
本サイトはサブディレクトリタイプのマルチサイト機能を採用して構築しているが、これまでサブドメインタイプは利用した経験はない。マルチサイト機能のサブドメインタイプは以前から1度は試してみたいと思っており、今回実際にサイトを構築してみた。
Fotepo:プラグイン作ってみました(2019年9月19日 更新)
仕事柄、Chromeの「デベロッパーツール」を使ってページのフォントを変更することがある。そんな時、無効なフォント名を指定してしまったり、フォント名をまちがえることがあり、もう少しお手軽にできないかと思って作ったのが今回紹介するプラグイン「Fotepo」である。
カテゴリー専用の投稿一覧と新規投稿メニューを追加する(2012年1月23日 更新)
サイト更新の1クリックを省くため、特定カテゴリーの投稿に対して同じようにメニューを追加してみた。カスタム投稿タイプの専用投稿メニューみたいな感じである。