関数リファレンス/wp enqueue scriptのソースを表示

{{NeedTrans|一部}}
__TOC__

== 説明 ==

スクリプトファイルがまだインクルードされていない場合、また、すべての依存するスクリプトが登録済みの場合、依存関係に従った適切なタイミングでファイルを生成されたページにリンクします。スクリプトのリンクは、[[関数リファレンス/wp_register_script|wp_register_script()]] 関数ですでに登録済みのハンドル、またはこの関数に必要なパラメータを与えることで行えます。

これは WordPress が生成するページに JavaScript をリンクする際に推奨されている方法です。

== 使い方 ==

 <?php wp_enqueue_script( $handle, $src, $deps, $ver, $in_footer ); ?>

この関数を呼び出す際に使うべきアクション[[Glossary#Hook|フック]]についての情報は[[#注|注]]セクションをご覧ください。

== パラメータ<span id="Parameters"></span> ==

{{Parameter|$handle|文字列|スクリプトのハンドルとして使われる名前。特別なケースとして、文字列に '?' という記号が含まれている場合、それより前の部分は登録されたハンドルとして参照され、それより後の部分はクエリストリングとして URL に追加される。このような特別な場合、バージョンを使用する必要がある。}}

{{Parameter|$src|文字列|スクリプトの URL。例: <code><nowiki>http://example.com/wp-content/themes/my-theme/my-theme-script.js</nowiki></code>。ローカルスクリプトの URL は絶対に直接書き込むべきではない。代わりに [[関数リファレンス/plugins_url|plugins_url]] ([[Glossary#Plugin|プラグイン]]向け) と [[関数リファレンス/get_template_directory_uri|get_template_directory_uri]] ([[Glossary#Themes|テーマ]]向け) を使って適切な URL を取得する。リモートのアセットはプロトコルに影響されない URL で指定できる。例: <code>//otherdomain.com/js/their-script.js</code>。「[[#Default_Scripts_Included_and_Registered_by_WordPress|WordPress に含まれ登録されているデフォルトスクリプト]]」を参照。|オプション|false}}

{{Parameter|$deps|配列|このスクリプトが依存するスクリプトのハンドルの配列、つまり、このスクリプトより前に読み込まれる必要があるスクリプト。このパラメータは、<tt>$handle</tt> のスクリプトが <tt>[[関数リファレンス/wp_register_script|wp_register_script()]]</tt> を使って登録されていない場合のみに必要。デフォルトのハンドルはすべて小文字。|オプション|array()}}

{{Parameter|$ver|文字列|クエリストリングとしてファイルパスの最後に連結される、スクリプトのバージョン番号を指定する文字列 (存在する場合) 。バージョンが指定されていない場合は ''false'' に設定され、WordPress は自動的に現在の WordPress のバージョン数と同じバージョン番号を追加する。''null'' に設定した場合はバージョン番号は追加されない。このパラメータはキャッシングに関わらず正しいバージョンがクライアントに送信されるようにするために使う。したがって、バージョン番号があってそれがスクリプトに意味を持つ場合は含めるべきである。|オプション|false}}

{{Parameter|$in_footer|真偽値|スクリプトは通常 HTML ドキュメントの <tt><head></tt> に置かれるが、もしこのパラメータが ''true'' の場合 <tt></body></tt> 終了タグの前に配置される。テーマ内の適切な位置に <tt>[[関数リファレンス/wp footer|wp_footer()]]</tt> テンプレートタグが含まれていることが必須となる。|オプション|false}}

== 戻り値 ==

{{Return||void|この関数には戻り値はありません。}}

== 用例 ==

== フックを使う ==

ひとつのアクションフックでスクリプトとスタイルをエンキューする。

<pre>
/**
 * スクリプトとスタイルを正しくエンキューする方法
 */
function theme_name_scripts() {
	wp_enqueue_style( 'style-name', get_stylesheet_uri() );
	wp_enqueue_script( 'script-name', get_template_directory_uri() . '/js/example.js', array(), '1.0.0', true );
}

add_action( 'wp_enqueue_scripts', 'theme_name_scripts' );
</pre>

=== script.aculo.us ライブラリをリンクする<span id="Link_the_script.aculo.us_Library"></span> ===

以下は、 ''scriptaculous'' ハンドルで、WordPressによって [[#Default_Scripts_Included_and_Registered_by_WordPress|すでにインクルード、登録されている]] script.aculo.us ライブラリとをリンクさせる基本的な使い方の例です。

<pre>
<?php
function my_scripts_method() {
    wp_enqueue_script( 'scriptaculous' );
}

add_action( 'wp_enqueue_scripts', 'my_scripts_method' ); // wp_enqueue_scripts アクションフックはフロントエンドのみでリンク
?>
</pre>

上記の例は script.aculo.us ライブラリとフロントエンドでのみリンクします。 ライブラリが[[Administration Screens|管理画面]] で必要な場合、代わりに [[Plugin_API/Action_Reference/admin_enqueue_scripts|admin_enqueue_scripts]] アクション [[Glossary#Hook|フック]] を使用することができます。ですが、この場合、 ''全て'' の管理画面でエンキューしてしまい、プラグインやコアとのコンフリクトを生み、究極的にはWordPressの管理画面でのエクスペリエンスを損なう可能性があります。それよりも、必要な各画面でのみリンクするべきです。例に関しては、 [[#Link_Scripts_Only_on_a_Plugin_Administration_Screen|プラグイン管理画面のみでスクリプトをリンクする]] セクションを参照してください。

=== jQuery に依存するテーマのスクリプトをリンクする<span id="Link_a_Theme_Script_Which_Depends_on_jQuery"></span> ===

テーマにインクルードされる JavaScript ファイルは、ある関数や変数を使うために、別の JavaScript ファイルが予め読み込まれている必要性を持つことがよくあります。[[#Parameters|<tt>$deps</tt> パラメータを利用して]]、<tt>wp_enqueue_script()</tt> と <tt>[[関数リファレンス/wp_register_script|wp_register_script()]]</tt> は新しいスクリプトを登録するときに依存先を指定できます。これにより WordPress は、新しいスクリプトをリンクする前にこれらの依存先を HTML ページへリンクします。もし依存先を表す[[#Default_Scripts_Included_and_Registered_by_WordPress|ハンドル]]が[[関数リファレンス/wp_deregister_script|登録されていない]]場合、WordPress は新しいスクリプトをリンクしません。次の例は ''custom_script.js'' テーマスクリプトが jQuery ライブラリを必要とする場合です:

<pre>
<?php
/**
 * Enqueue a script with jQuery as a dependency.
 */
function wpdocs_scripts_method() {
    wp_enqueue_script( 'custom-script', get_stylesheet_directory_uri() . '/js/custom_script.js', array( 'jquery' ) );
}
add_action( 'wp_enqueue_scripts', 'wpdocs_scripts_method' );
?>
</pre>

=== script.aculo.us に依存するプラグインのスクリプトをリンクする<span id="Link_a_Plugin_Script_That_Depends_on_scriptaculous"></span> ===

次の例は[[Writing a Plugin#Plugin_Files|プラグインファイル]]内での使用を想定したもので、script.aculo.us ライブラリに依存する新しいプラグインスクリプトを登録およびリンクします。依存先については[[#Link_a_Theme_Script_Which_Depends_on_jQuery|上の例]]を見てください。

<pre>
/**
 * Enqueue script with script.aculo.us as a dependency.
 */
function my_scripts_method() {
    wp_enqueue_script( 'newscript', plugins_url( '/js/newscript.js' , __FILE__ ), array( 'scriptaculous' ) );
}
add_action( 'wp_enqueue_scripts', 'my_scripts_method' );
</pre>

=== プラグイン管理画面のみでスクリプトをリンクする ===

次の例はスクリプトを特定の[[管理画面]]でのみリンクします。これは[[#Link_the_script.aculo.us_Library|最初の例]]のコードの下で説明したシナリオと対になるものです。

<pre>
<?php
/**
 * プラグインのスクリプトを登録する。
 */
function wpdocs_plugin_admin_init() {
    // スクリプトを登録。
    wp_register_script( 'my-plugin-script', plugins_url( '/script.js', __FILE__ ) );
}
add_action( 'admin_init', 'wpdocs_plugin_admin_init' );
 
/**
 * プラグインの管理画面を追加する。
 */
function wpdocs_plugin_admin_menu() {
    /* プラグインのサブメニューと管理画面を追加 */
    $page_hook_suffix = add_submenu_page( 'edit.php',   // サブメニューの親ページ。
        __( 'My Plugin', 'my-textdomain' ),             // サブメニューのタイトル。
        __( 'My Plugin', 'my-textdomain' ),             // 画面のタイトル。
        'manage_options',                               // サブメニューのアクセスに必要な権限。
        'my_plugin-options',                            // 画面の URL で使うスラッグ。
        'wpdocs_plugin_manage_menu'                     // 画面を表示するために呼び出す関数。
    );
 
    /*
     * 取得した $page_hook_suffix を使って、スクリプトをリンクする関数をフックする。
     * このフックはプラグインの管理画面でのみ起動される。
     * 参照: https://developer.wordpress.org/reference/hooks/admin_print_scripts-hook_suffix/
     */
    add_action( "admin_print_scripts-{$page_hook_suffix}", 'wpdocs_plugin_admin_scripts');
}
add_action( 'admin_menu', 'wpdocs_plugin_admin_menu' );
 
/**
 * 登録済みスクリプトを管理画面へエンキューする。
 */
function wpdocs_plugin_admin_scripts() {
    // 登録済みスクリプトをページへリンク。
    wp_enqueue_script( 'my-plugin-script' );
}
 
/**
 * プラグインの管理画面を表示するためのコールバック。
 */
function wpdocs_plugin_manage_menu() {
    // プラグインの管理画面を表示。
}
</pre>

=== 子テーマから依存関係のないスクリプトを読み込む ===

フッターで、依存関係のない同じコールバック関数にスクリプトを登録してエンキューします。 詳細については、 [[関数リファレンス/wp_register_script| wp_register_script()]] を参照してください。 この例では、 <tt>google_analytics_object.js</tt> は Google アナリティクスのトラッキングコードが書かれたファイルです。

<pre>
<?php
add_action( 'wp_enqueue_scripts', 'child_add_scripts' );

/**
 * JavaScript ライブラリに依存しないスクリプトを登録してエンキューする。
 */
function child_add_scripts() {
    wp_register_script(
        'google-analytics',
        get_stylesheet_directory_uri() . '/google_analytics_object.js',
        false,
        '1.0',
        true
    );

    wp_enqueue_script( 'google-analytics' );
}
</pre>

== jQuery noConflict ラッパー ==

WordPress に含まれる jQuery ライブラリは [http://docs.jquery.com/Using_jQuery_with_Other_Libraries ''noConflict()''] モードに設定されます ({{Trac|wp-includes/js/jquery/jquery.js}} を参照) 。これは WordPress に含まれる他の JavaScript ライブラリとの互換性の問題を防ぐためです。
''noConflict'' モードの場合、以下のような書き方で jQuery を使用できます。

<pre>
jQuery(document).ready(function(){
    jQuery(#somefunction) ...
});
</pre>

しかし、下記のようにコードを書くとエラーが発生するか、他のライブラリの <tt>$()</tt> が使用されてしまいます。

<pre>
$(document).ready(function(){
     $(#somefunction) ...
});
</pre>

どうしても <tt>jQuery()</tt> の代わりに <tt>$()</tt> を使いたければ、以下のようにラッパーで囲むと使うことができます。

<pre>
jQuery(document).ready(function($) {
    // この関数内では $() を jQuery() のエイリアスとして利用可能です
    // そして、$() を使う他のライブラリはこの関数内では利用できません
});
</pre>

このラッパーによって、あなたのコードは DOM の構築終了時に実行されます。何らかの理由で [http://api.jquery.com/ready/ DOM ready] イベントを待たずにすぐコードを実行したい場合は、代わりに以下のラッパーメソッドを使用できます。

<pre>
(function($) {
    // この関数内では $() を jQuery() のエイリアスとして利用可能です
    // そして、$() を使う他のライブラリはこの関数内では利用できません
})(jQuery);
</pre>

あるいは、以下のように定義すれば <tt>jQuery()</tt> のように書く代わりに <tt>$j()</tt> というショートカットを使えます。このとき <tt>$()</tt> は他のライブラリのものとして使えます。

<pre>
var $j = jQuery;
</pre>

== WordPress に含まれ登録されているデフォルトスクリプト<span id="Default Scripts Included and Registered by WordPress"></span> ==

デフォルトでは、WordPress には WordPress 自体が使用するスクリプトの他に多くのスクリプトが含まれています。 一部を以下の表に挙げます。

<code>$handle</code>パラメータの代わりに使用できる名前の詳細なリストについては、[[関数リファレンス/wp_register_script#Handles and Their Script Path Registered by WordPress|ハンドルと WordPress で登録済みのスクリプトのパス]]を参照してください。

<!--For a detailed list of names that can be used in place of the <code>$handle</code> parameter, see [[関数リファレンス/wp_register_script#Handles and Their Script Paths Registered by WordPress|Handles and Their Script Paths Registered by WordPress]].-->

[[Version 3.5]] で、WordPress は縮小されたスクリプトとスタイルの命名規則が変更されました。[[Version 3.5]] 以前は、縮小されたスクリプトとスタイルには '' .js ''および '' .css ''という拡張子がつけられており、縮小されていなかったスクリプトには '' .dev.js ''および '' .dev.css ''という拡張子がつけられていました。変更後の拡張子は、縮小されたファイルの場合は '' .min.js ''および '' .min.css ''、縮小されていないファイルの場合はそれぞれ '' .js ''および '' .css ''になりました。

{| class="wikitable" style="width:100%;"
|-
! width="25%" | '''名前'''
! width="35%" | '''ハンドル'''
! width="40%" | '''必要なファイル *'''
|-
| [http://www.defusion.org.uk/ Image Cropper]
| Image cropper (not used in core, see jcrop)
|-
| [http://deepliquid.com/content/Jcrop.html Jcrop]
| jcrop
|-
| [http://code.google.com/p/swfobject/ SWFObject]
| swfobject
|-
| [http://swfupload.org/ SWFUpload]
| swfupload
|-
| [http://swfupload.org/ SWFUpload Degrade]
| swfupload-degrade
|-
| [http://swfupload.org/ SWFUpload Queue]
| swfupload-queue
|-
| [http://swfupload.org/ SWFUpload Handlers]
| swfupload-handlers
|-
| [http://jquery.com/ jQuery]
| jquery
| json2 (for AJAX calls)
|-
| [http://plugins.jquery.com/project/form/ jQuery Form]
| jquery-form
| jquery
|-
| [http://plugins.jquery.com/project/color/ jQuery Color]
| jquery-color
| jquery
|-
| [http://masonry.desandro.com/ jQuery Masonry]
| jquery-masonry
| jquery
|-
| [http://masonry.desandro.com/ Masonry (native Javascript)]
| masonry
|-
| [http://jqueryui.com/ jQuery UI Core]
| jquery-ui-core
| jquery
|-
| [http://jqueryui.com/widget/ jQuery UI Widget]
| jquery-ui-widget
| jquery
|-
| [http://jqueryui.com/demos/accordion/ jQuery UI Accordion]
| jquery-ui-accordion
| jquery
|-
| [http://jqueryui.com/demos/autocomplete/ jQuery UI Autocomplete]
| jquery-ui-autocomplete
| jquery
|-
| [http://jqueryui.com/demos/button/ jQuery UI Button]
| jquery-ui-button
| jquery
|-
| [http://jqueryui.com/demos/datepicker/ jQuery UI Datepicker]
| jquery-ui-datepicker
| jquery
|-
| [http://jqueryui.com/demos/dialog/ jQuery UI Dialog]
| jquery-ui-dialog
| jquery
|-
| [http://jqueryui.com/demos/draggable/ jQuery UI Draggable]
| jquery-ui-draggable
| jquery
|-
| [http://jqueryui.com/demos/droppable/ jQuery UI Droppable]
| jquery-ui-droppable
| jquery
|-
| [http://jqueryui.com/menu/ jQuery UI Menu]
| jquery-ui-menu
| jquery
|-
| jQuery UI Mouse
| jquery-ui-mouse
| jquery
|-
| [http://jqueryui.com/demos/position/ jQuery UI Position]
| jquery-ui-position
| jquery
|-
| [http://jqueryui.com/demos/progressbar/ jQuery UI Progressbar]
| jquery-ui-progressbar
| jquery
|-
| [http://jqueryui.com/demos/selectable/ jQuery UI Selectable]
| jquery-ui-selectable
| jquery
|-
| [http://jqueryui.com/demos/resizable/ jQuery UI Resizable]
| jquery-ui-resizable
| jquery
|-
| [http://jqueryui.com/selectmenu/ jQuery UI Selectmenu]
| jquery-ui-selectmenu
| jquery
|-
| [http://jqueryui.com/demos/sortable/ jQuery UI Sortable]
| jquery-ui-sortable
| jquery
|-
| [http://jqueryui.com/demos/slider/ jQuery UI Slider]
| jquery-ui-slider
| jquery
|-
| [http://jqueryui.com/demos/tooltip/ jQuery UI Tooltips]
| jquery-ui-tooltip
| jquery
|-
| [http://jqueryui.com/demos/tabs/ jQuery UI Tabs]
| jquery-ui-tabs
| jquery
|-
| [http://jqueryui.com/effect/ jQuery UI Effects]
| jquery-effects-core
| jquery
|-
| [http://jqueryui.com/effect/ jQuery UI Effects - Blind]
| jquery-effects-blind
| jquery-effects-core
|-
| [http://jqueryui.com/effect/ jQuery UI Effects - Bounce]
| jquery-effects-bounce
| jquery-effects-core
|-
| [http://jqueryui.com/effect/ jQuery UI Effects - Clip]
| jquery-effects-clip
| jquery-effects-core
|-
| [http://jqueryui.com/effect/ jQuery UI Effects - Drop]
| jquery-effects-drop
| jquery-effects-core
|-
| [http://jqueryui.com/effect/ jQuery UI Effects - Explode]
| jquery-effects-explode
| jquery-effects-core
|-
| [http://jqueryui.com/effect/ jQuery UI Effects - Fade]
| jquery-effects-fade
| jquery-effects-core
|-
| [http://jqueryui.com/effect/ jQuery UI Effects - Fold]
| jquery-effects-fold
| jquery-effects-core
|-
| [http://jqueryui.com/effect/ jQuery UI Effects - Highlight]
| jquery-effects-highlight
| jquery-effects-core
|-
| [http://jqueryui.com/effect/ jQuery UI Effects - Pulsate]
| jquery-effects-pulsate
| jquery-effects-core
|-
| [http://jqueryui.com/effect/ jQuery UI Effects - Scale]
| jquery-effects-scale
| jquery-effects-core
|-
| [http://jqueryui.com/effect/ jQuery UI Effects - Shake]
| jquery-effects-shake
| jquery-effects-core
|-
| [http://jqueryui.com/effect/ jQuery UI Effects - Slide]
| jquery-effects-slide
| jquery-effects-core
|-
| [http://jqueryui.com/effect/ jQuery UI Effects - Transfer]
| jquery-effects-transfer
| jquery-effects-core
|-
| [http://mediaelementjs.com/ MediaElement.js (WP 3.6+)]
| wp-mediaelement
| jquery
|-
| [http://trainofthoughts.org/blog/2007/02/15/jquery-plugin-scheduler/ jQuery Schedule]
| schedule
| jquery
|-
| [https://web.archive.org/web/20111017233444/http://plugins.jquery.com/project/suggest jQuery Suggest]
| suggest
| jquery
|-
| [http://codex.wordpress.org/ThickBox ThickBox]
| thickbox
|-
| [http://cherne.net/brian/resources/jquery.hoverIntent.html jQuery HoverIntent]
| hoverIntent
| jquery
|-
| [http://plugins.jquery.com/project/hotkeys jQuery Hotkeys]
| jquery-hotkeys
| jquery
|-
| [http://code.google.com/p/tw-sack/ Simple AJAX Code-Kit]
| sack
|-
| [http://www.alexking.org QuickTags]
| quicktags
|-
| [https://github.com/automattic/Iris Iris (Colour picker)]
| iris
| jquery
|-
| [http://acko.net/dev/farbtastic Farbtastic (deprecated)]
| farbtastic
| jquery
|-
| [http://mattkruse.com ColorPicker (deprecated)]
| colorpicker
| jquery
|-
| [http://tinymce.moxiecode.com/ Tiny MCE]
| tiny_mce
|-
| Autosave
| autosave
|-
| WordPress AJAX Response
| wp-ajax-response
|-
| List Manipulation
| wp-lists
|-
| WP Common
| common
|-
| WP Editor
| editorremov
|-
| WP Editor Functions
| editor-functions
|-
| AJAX Cat
| ajaxcat
|-
| Admin Categories
| admin-categories
|-
| Admin Tags
| admin-tags
|-
| Admin custom fields
| admin-custom-fields
|-
| Password Strength Meter
| password-strength-meter
|-
| Admin Comments
| admin-comments
|-
| Admin Users
| admin-users
|-
| Admin Forms
| admin-forms
|-
| XFN
| xfn
|-
| Upload
| upload
|-
| PostBox
| postbox
|-
| Slug
| slug
|-
| Post
| post
|-
| Page
| page
|-
| Link
| link
|-
| Comment
| comment
|-
| Threaded Comments
| comment-reply
|-
| Admin Gallery
| admin-gallery
|-
| Media Upload
| media-upload
|-
| Admin widgets
| admin-widgets
|-
|  Word Count
| word-count
|-
| Theme Preview 
| theme-preview
|-
| [https://github.com/douglascrockford/JSON-js JSON for JS]
| json2
|-
| [http://www.plupload.com/ Plupload Core]
| plupload
|-
| [http://www.plupload.com/example_all_runtimes.php Plupload All Runtimes]
| plupload-all
|-
| [http://www.plupload.com/example_all_runtimes.php Plupload HTML4]
| plupload-html4
|-
| [http://www.plupload.com/example_all_runtimes.php Plupload HTML5]
| plupload-html5
|-
| [http://www.plupload.com/example_all_runtimes.php Plupload Flash]
| plupload-flash
|-
| [http://www.plupload.com/example_all_runtimes.php Plupload Silverlight]
| plupload-silverlight
|-
| [http://underscorejs.org/ Underscore js]
| underscore
|-
| [http://backbonejs.org/ Backbone js]
| backbone
|}

{| class="wikitable" style="width:100%;"
|-
! colspan=4 | '''WordPressから削除されたもの'''
|-
! width="25%" | '''名前'''
! width="30%" | '''ハンドル'''
! width="20%" | '''削除されたバージョン'''
! width="25%" | '''代替え'''
|-
| [http://script.aculo.us Scriptaculous Root]
| scriptaculous-root
| WP 3.5
| Google Version
|-
| [http://script.aculo.us Scriptaculous Builder]
| scriptaculous-builder
| WP 3.5
| Google Version
|-
| [http://script.aculo.us Scriptaculous Drag &amp; Drop]
| scriptaculous-dragdrop
| WP 3.5
| Google Version
|-
| [http://script.aculo.us Scriptaculous Effects]
| scriptaculous-effects
| WP 3.5
| Google Version
|-
| [http://script.aculo.us Scriptaculous Slider]
| scriptaculous-slider
| WP 3.5
| Google Version
|-
| [http://script.aculo.us/ Scriptaculous] Sound
| scriptaculous-sound
| WP 3.5
| Google Version
|-
| [http://script.aculo.us Scriptaculous Controls]
| scriptaculous-controls
| WP 3.5
| Google Version
|-
| [http://script.aculo.us Scriptaculous]
| scriptaculous
| WP 3.5
| Google Version
|-
| [http://www.prototypejs.org/ Prototype Framework]
| prototype
| WP 3.5
| Google Version
|-
|}

'''このリストは完璧ではありません。''' 登録済みファイルの完璧なリストについては管理UIで <tt>$GLOBALS['wp_scripts']</tt> で調べてください。また、登録されたスクリプトは、ページによって変わる場合があります。

--------

''*必要なファイルに関する記述は完璧ではありません。''

== 注 ==

* 例のように、サイトのフロントエンドで呼び出す場合は、[[関数リファレンス/wp_enqueue_script|wp_enqueue_scripts]] アクション[[用語集#フック|フック]]を使用して関数を呼び出す必要があります。[[管理画面]]で呼び出すには、[[関数リファレンス/admin_enqueue_scripts|admin_enqueue_scripts]] /[[:en:Function_Reference/admin_enqueue_scripts|en]] アクションフックを使用します。ログイン画面では [[関数リファレンス/login_enqueue_scripts| login_enqueue_scripts]] /[[:en:Function_Reference/login_enqueue_scripts|en]] アクションフックを使用します。アクションフックの外側で呼び出すと問題が発生する可能性があります。詳細については [http://core.trac.wordpress.org/ticket/11526 ticket #11526] を参照してください。
<!--The function should be called using the [[Plugin API/Action Reference/wp_enqueue_scripts|wp_enqueue_scripts]] action [[Glossary#Hook|hook]] if you want to call it on the front-end of the site, like in the [[#Examples|examples above]]. To call it on the [[Administration Screens|administration screens]], use the [[Plugin_API/Action_Reference/admin_enqueue_scripts|admin_enqueue_scripts]] action hook. For the [[Login Screen|login screen]], use the [[Plugin_API/Action_Reference/login_enqueue_scripts|login_enqueue_scripts]] action hook. Calling it outside of an action hook can lead to problems, see the [http://core.trac.wordpress.org/ticket/11526 ticket #11526] for details.-->
* [[Version 3.3|バージョン3.3]]より前の場合、この関数を [[プラグイン API/アクションフック一覧/wp_head|wp_head]] または [[プラグイン API/アクションフック一覧/wp_print_scripts|wp_print_scripts]] /[[Plugin_API/Action_Reference/wp_print_scripts|en]] アクションフック以降で呼び出すと何の効果もありません。<tt>$in_footer</tt> パラメータを ''true'' にしてあってもファイルをエンキューするには遅すぎるためです。
<!-- Prior to [[Version 3.3]], the function will have no effect if it is called using the [[Plugin_API/Action_Reference/wp_head|wp_head]] or [[Plugin_API/Action_Reference/wp_print_scripts|wp_print_scripts]] action hooks or later, as this is too late to enqueue the files even if the <tt>$in_footer</tt> parameter is set to ''true''. -->
* [[Version 3.3|バージョン3.3]]のとき、この関数をページの途中（<tt>[[プラグイン API/アクションフック一覧/wp footer|wp_footer()]]</tt> テンプレートタグより前）または [[プラグイン API/アクションフック一覧/wp_head|wp_head]] アクションフックから呼び出すことができます。このようにするとスクリプトは <tt>$in_footer</tt> パラメータが ''true'' であるかのようにフッターへ入ります。
<!-- As of [[Version 3.3]], the function can be called mid-page (before the <tt>[[Plugin API/Action Reference/wp footer|wp_footer()]]</tt> template tag) or using the [[Plugin_API/Action_Reference/wp_head|wp_head]] action hook. This will place the script in the footer as if the <tt>$in_footer</tt> parameter was set to ''true''. -->
* もし、登録済みのハンドルを異なるパラメータを付けて登録またはエンキューしようとすると、新しいパラメータは無視されます。そうするには、<tt>[[関数リファレンス/wp_deregister_script|wp_deregister_script()]]</tt> を使った後、スクリプトを新しいパラメータを付けて登録してください。
* ハンドル ''jquery-ui-core'' には jQuery UI Effects が'''含まれません'''。
* この関数は、現在のテーマが <tt>[[関数リファレンス/wp_head|wp_head()]]</tt> と <tt>[[関数リファレンス/wp_footer|wp_footer()]]</tt> を使う前提で正しく動作します。これらの関数を呼び出さない古いテーマでは正しく動作しないかもしれません。昔のテーマをデバッグするとき覚えておくと良いでしょう。
* 使用: <tt>WP_Scripts::add()</tt>, <tt>WP_Scripts::add_data()</tt>, <tt>WP_Scripts::enqueue()</tt>。
* グローバルの使用: (<tt>不明な型</tt>) <tt>$wp_scripts</tt>。

== 更新履歴 ==

* Since: [[Version 2.6|2.6]] (BackPress version: r16)

== ソースファイル ==

<tt>wp_enqueue_script()</tt> は {{Trac|wp-includes/functions.wp-scripts.php}} にあります。

== リソース ==

* [http://www.prelovac.com/vladimir/best-practice-for-adding-javascript-code-to-wordpress-plugin Best practice for adding JavaScript code to WordPress plugins]
*[http://planetozh.com/blog/2008/04/how-to-load-javascript-with-your-wordpress-plugin/ How To: Load Javascript With Your WordPress Plugin]
*[http://noteslog.com/post/how-to-load-javascript-in-wordpress-plugins/ How to load JavaScript in WordPress plugins]
*[http://www.devlounge.net/articles/using-javascript-and-css-with-your-wordpress-plugin  Using JavaScript and CSS with your WordPress Plugin]
* [http://www.lost-in-code.com/platforms/wordpress/wordpress-using-javascript-libraries-with-your-plugin-or-theme/ Using Javascript libraries with your Wordpress plugin or theme]
* [http://www.ericmmartin.com/5-tips-for-using-jquery-with-wordpress/ 5 Tips For Using jQuery with WordPress]
* [http://beerpla.net/2010/01/13/wordpress-plugin-development-how-to-include-css-and-javascript-conditionally-and-only-when-needed-by-the-posts/ How to Include CSS and JavaScript Conditionally, and Only When Needed by the Posts]
* [http://fusi0n.org/coding/make-your-wordpress-plugins-use-a-different-version-of-a-bundled-javascript-library Make Your WordPress Plugins Use a Different Version of a Bundled JavaScript Library] Replacing built-in JavaScript libraries is usually a bad idea. Do this only on sites you administer personally.
* [http://scribu.net/wordpress/optimal-script-loading.html How to load JavaScript like a WordPress Master] Highly recommended.
* [http://justintadlock.com/archives/2009/08/06/how-to-disable-scripts-and-styles How to disable scripts and styles]
* [http://twentyfiveautumn.com/2012/03/14/loading-javascript-on-the-frontend-with-your-wordpress-plugin/ Loading javascript on the frontend with your WordPress plugin]
* [http://www.cybersprocket.com/?s=wordpress+javascript JavaScript Tips and Tricks for WordPress 3.x]
* [[:en:ThickBox|Developing for WordPress's customized version of ThickBox]]
* [http://generatewp.com/register_script/ WordPress Script Registration Generator]

== 関連資料 ==
{{Enqueue Functions Related}}

{{Tag Footer}}
{{DEFAULTSORT:Wp_enqueue_script}}

{{原文|Function Reference/wp_enqueue_script|149792}}<!-- 2015-02-23T12:57:55‎ Michalbluma 版 -->

[[Category:関数]]

[[en:Function Reference/wp_enqueue_script]]
[[es:Referencia de Funciones/wp_enqueue_script]]
[[ko:Function Reference/wp_enqueue_script]]
[[ru:Справочник по функциям/wp_enqueue_script]]
[[zh-cn:函数参考/wp_enqueue_script]]