Mise en file d'attente d'un script.

Description

Enregistre le script si $src fourni (n'écrase PAS), et le met en file d'attente.

Voir aussi

  • WP_Dependencies::add()
  • WP_Dependencies::add_data()
  • WP_Dependencies::enqueue()

Paramètres

$handle

(chaîne de caractères)(Obligatoire)Nom du script. Doit être unique.

$src

(chaîne de caractères)(Facultatif)URL complète du script, ou chemin du script relatif au répertoire racine de WordPress.

Valeur par défaut : ''

$deps

(chaîne de caractères[])(Facultatif) Un tableau de gestionnaires de script enregistrés dont ce script dépend.

Valeur par défaut : array()

$ver

(chaîne de caractères|bool|null)(Facultatif) Chaîne spécifiant le numéro de version du script, s'il en a un, qui est ajouté à l'URL en tant que chaîne de requête à des fins de suppression du cache. Si version est défini à false, un numéro de version est automatiquement ajouté égal à la version actuelle installée de WordPress. Si elle est définie à null, aucune version n'est ajoutée.

Valeur par défaut : false

$in_footer

(bool)(Facultatif) Si le script doit être mis en file d'attente avant au lieu de dans le . Par défaut, 'false'.

Valeur par défaut : false

Plus d'informations

Utilisation

wp_enqueue_script($handle,$src,$deps,$ver,$in_footer);

Lie un fichier script à la page générée au bon moment en fonction des dépendances du script, si le script n'a pas déjà été inclus et si toutes les dépendances ont été enregistrées. Vous pouvez soit lier un script avec un handle préalablement enregistré à l'aide de la commande wp_register_script() soit fournir à cette fonction tous les paramètres nécessaires pour lier un script.

C'est la méthode recommandée pour lier le JavaScript à une page générée par WordPress.

Notes

  • La fonction doit être appelée en utilisant la fonction wp_enqueue_scripts action hook si vous voulez l'appeler sur le front-end du site, comme dans les exemples ci-dessus. Pour l'appeler sur les écrans d'administration, utilisez le crochet d'action admin_enqueue_scripts. Pour l'écran de connexion, utilisez le crochet d'action login_enqueue_scripts. Le fait de l'appeler en dehors d'un crochet d'action peut entraîner des problèmes, cf. ticket #11526 pour plus de détails.
  • Si vous essayez d'enregistrer ou de mettre en file d'attente un handle déjà enregistré avec des paramètres différents, les nouveaux paramètres seront ignorés. Au lieu de cela, utilisez wp_deregister_script() et enregistrer à nouveau le script avec les nouveaux paramètres.
  • jQuery UI Effects est pas inclus avec le jquery-ui-core poignée.
  • Cette fonction s'appuie sur l'utilisation de wp_head() et wp_footer() par le thème actif. Cela signifie qu'il peut ne pas fonctionner avec quelques très anciens thèmes qui n'appellent pas ces fonctions. Il est utile de garder cela à l'esprit lors du débogage de thèmes anciens.
  • Utilise : WP_Scripts::add(), WP_Scripts::add_data() et WP_Scripts::enqueue().
  • Utilise le global : (type inconnu) $wp_scripts.

Scripts et bibliothèques JS par défaut inclus et enregistrés par WordPress.

Par défaut, l'installation de WordPress inclut de nombreuses bibliothèques javascript populaires et des scripts couramment utilisés par les développeurs web en plus des scripts utilisés par WordPress lui-même. Certains d'entre eux sont répertoriés dans le tableau ci-dessous.

Pour une liste détaillée des noms qui peuvent être utilisés à la place de l'icône de la bibliothèque. $handle paramètre, voir wp_register_script().

Nom du script Manipulation Dépendance nécessaire * Version du script Licence
Coupeur d'images Découpeur d'image (non utilisé dans le noyau, voir jcrop).
Jcrop jcrop 0.9.12 MIT
SWFObject swfobject 2.2-20120417 MIT
SWFUpload swfupload 2201-20110113 MIT
Dégradation de SWFUpload swfupload-degrade 2201 MIT
File d'attente SWFUpload swfupload-queue 2201 MIT
Gestionnaires de SWFUpload swfupload-handlers 2201-20110524 MIT
jQuery jquery json2 (pour les appels AJAX) 1.12.4 MIT + (MIT OU BSD)
Formulaire jQuery jquery-form jquery 4.2.1 MIT ou LGPLv3
jQuery Color jquery-color jquery 2.1.2 MIT+CC0 + (MIT OU GPLv2)
jQuery Masonry jquery-masonry jquery 3.1.2b MIT
Masonry (Javascript natif) maçonnerie images chargées 3.1.2b MIT
jQuery UI Core jquery-ui-core jquery 1.11.4 MIT + CC0 + (MIT OU GPLv2)
Widget jQuery UI jquery-ui-widget jquery 1.11.4 MIT + CC0 + (MIT OU GPLv2)
Accordéon jQuery UI jquery-ui-contrordion jquery 1.11.4 MIT + CC0 + (MIT ou GPLV2)
JQUERY UI APPRENDRE jQuery-ui-Auto-complete jquery 1.11.4 MIT + CC0 + (MIT ou GPLV2)
bouton jQuery ui jQuery-Ui-Button jquery 1.11.4 MIT + CC0 + (MIT ou GPLV2)
jQuery ui datepicker jQuery-ui-datepicker jquery 1.11.4 MIT + CC0 + (MIT ou GPLV2)
boîte de dialogue jQuery UI jQuery-ui-dialog jquery 1.11.4 MIT + CC0 + (MIT ou GPLV2)
jQuery ui draggable jQuery-ui-draggable jquery 1.11.4 MIT + CC0 + (MIT ou GPLV2)
jQuery ui droppable jQuery-ui-droppable jquery 1.11.4 MIT + CC0 + (MIT ou GPLV2)
menu jquery ui jQuery-ui-menu jquery 1.11.4 MIT + CC0 + (MIT ou GPLV2)
Souris jQuery UI JQUERY-UI-MOUSE jquery 1.11.4 MIT + CC0 + (MIT ou GPLV2)
position jquery ui position jquery-ui jquery 1.11.4 MIT + CC0 + (MIT ou GPLV2)
Barbar de progression de jQuery jquery-ui-prrogressbar jquery 1.11.4 MIT + CC0 + (MIT ou GPLV2)
jQuery ui sélectionnable jQuery-UI-sélectionnable jquery 1.11.4 MIT + CC0 + (MIT ou GPLV2)
jQuery ui resizable jQuery-ui-résiSable jquery 1.11.4 MIT + CC0 + (MIT ou GPLV2)
jQuery ui SelectMenu jQuery-Ui-SelectMenu jquery 1.11.4 MIT + CC0 + (MIT ou GPLV2)
jQuery ui sortable jQuery-ui-sortable jquery 1.11.4 MIT + CC0 + (MIT ou GPLV2)
curseur jquery ui jQuery-ui-slider jquery 1.11.4 MIT + CC0 + (MIT ou GPLV2)
JQUERY UI SPINNER jQuery-Ui-Spinner jquery 1.11.4 MIT + CC0 + (MIT ou GPLV2)
Infactualités jQuery UI jQuery-ui-tooltip jquery 1.11.4 MIT + CC0 + (MIT ou GPLV2)
onglets jQuery UI jquery-ui-tabs jquery 1.11.4 MIT + CC0 + (MIT ou GPLV2)
effets d'interface utilisateur jQuery jquery-effets-core jquery 1.11.4 MIT + CC0 + (MIT ou GPLV2)
Effets de l'interface utilisateur de jQuery - aveugle jquery-effets aveugle jquery-effets-core 1.11.4 MIT + CC0 + (MIT ou GPLV2)
Effets de l'interface utilisateur de jQuery - Bounce jquery-effets-rebond jquery-effets-core 1.11.4 MIT + CC0 + (MIT ou GPLV2)
Effets de l'interface utilisateur jQuery - Clip jQuery-Effects-Clip jquery-effets-core 1.11.4 MIT + CC0 + (MIT ou GPLV2)
Effets de l'interface utilisateur de jQuery - Drop jquery-effets-drop jquery-effets-core 1.11.4 MIT + CC0 + (MIT ou GPLV2)
Effets de l'interface utilisateur de jQuery - exploser jQuery-Effects-Explose jquery-effets-core 1.11.4 MIT + CC0 + (MIT ou GPLV2)
Effets de l'interface utilisateur de jQuery - Fade jquery-effets-fade jquery-effets-core 1.11.4 MIT + CC0 + (MIT ou GPLV2)
Effets de l'interface utilisateur de jQuery - pli jquery-effets jquery-effets-core 1.11.4 MIT + CC0 + (MIT ou GPLV2)
Effets de l'interface utilisateur de jQuery - Soulignement jquery-effets-highlight jquery-effets-core 1.11.4 MIT + CC0 + (MIT ou GPLV2)
Effets de l'interface utilisateur jQuery - Pulsate jquery-effets pulsé jquery-effets-core 1.11.4 MIT + CC0 + (MIT ou GPLV2)
Effets de l'interface utilisateur de jQuery - échelle jQuery-Effects-échelle jquery-effets-core 1.11.4 MIT + CC0 + (MIT ou GPLV2)
Effets de l'interface utilisateur de jQuery - Shake jquery-effets-shake jquery-effets-core 1.11.4 MIT + CC0 + (MIT ou GPLV2)
Effets de l'interface utilisateur de jQuery - diapositive jQuery-Effects-Slide jquery-effets-core 1.11.4 MIT + CC0 + (MIT ou GPLV2)
Effets de l'interface utilisateur de jQuery - Transfert jquery-effets-transfer jquery-effets-core 1.11.4 MIT + CC0 + (MIT ou GPLV2)
MediaElement.js (WP 3.6+) WP-Mediaelement jquery 4.2.6-78496d1 Mit
calendrier jQuery programme jquery 20m / 1.0.1 Mit
jQuery suggère suggérer jquery 1.1-20110113 Domaine public
Boîte épais boîte épais 3.1-20121105 MIT ou GPLV3
jQuery hoverIntent hover-intint jquery 1.8.1 Mit
jQuery jquery-hotkeys jquery 0.2.0 MIT ou GPLV2
Simple ajax code-kit sac 1.6.1 Licence X11
Quicktags Quicktags 1.3 LGPL2.1
Iris (sélecteur de couleurs) iris jquery 1.0.7 Gplv2
Farbtastic (déprécié) farbtastique jquery 1.2 Gplv3
ColorPicker (déprécié) pipette à couleurs jquery v2 Copyright de l'auteur
Petit MCE wp-tinymce 4.9.4 LGPL2.1
Sauvegarde automatique autosave
Réponse AJAX de WordPress wp-ajax-response
Manipulation de listes wp-lists
WP Common commun
WP Editor editorremov
Fonctions de l'éditeur WP fonctions-éditeur
Chat AJAX ajaxcat
Catégories administratives admin-categories
Balises d'administration admin-tags
Champs personnalisés de l'administrateur admin-custom-fields
Compteur de force du mot de passe password-strength-meter
Commentaires de l'administrateur admin-comments
Utilisateurs de l'Admin admin-users
Formulaires d'administration admin-forms
XFN xfn
Télécharger télécharger
PostBox boîte postale
Slug limace
Post post
Page page
Lien lien
Commentaire commentaire
Commentaires en file d'attente commentaire-réponse
Galerie de l'administrateur admin-gallery
Téléchargement de médias media-upload
Widgets d'administration admin-widgets
Compte de mots compte de mots
Aperçu du thème theme-preview
JSON pour JS json2 2015-05-03 Domaine public
Plupload Core plupload 2.1.9 GPLv2
Plupload All Runtimes plupload-all 2.1.1 GPLv2
Plupload HTML4 plupload-html4 2.1.1 GPLv2
Plupload HTML5 plupload-html5 2.1.1 GPLv2
Plupload Flash plupload-flash 2.1.1 GPLv2
Plupload Silverlight plupload-silverlight 2.1.1 GPLv2
Underscore js underscore 1.8.3 MIT
Backbone js backbone jquery, underscore 1.4.0 MIT
imagesLoaded imagesloaded 3.2.0 MIT
CodeMirror wp-codemirror 5.29.1-alpha-ee20357 MIT
imgAreaSelect imgareaselect jquery 0.9.8 MIT ET GPL
Retiré du noyau
Nom du script Manipulation Version supprimée Remplacé par
Racine de Scriptaculous scriptaculous-root WP 3.5 Version Google
Scriptaculous Builder scriptaculous-builder WP 3.5 Version Google
Scriptaculous Drag & Drop scriptaculous-dragdrop WP 3.5 Version Google
Effets de Scriptaculous scriptaculous-effects WP 3.5 Version Google
Scriptaculous Slider scriptaculous-slider WP 3.5 Version Google
Scriptaculous Son scriptaculous-son WP 3.5 Version Google
Contrôles Scriptaculous scriptaculous-controls WP 3.5 Version Google
Scriptaculous scriptaculous WP 3.5 Version Google
Cadre de travail Prototype prototype WP 3.5 Version Google

La liste est loin d'être complète. Pour une liste complète des fichiers enregistrés, inspectez $GLOBALS['wp_scripts'] dans l'interface utilisateur d'administration. Les scripts enregistrés pourraient changer par page demandée.

* Les dépendances listées ne sont pas complètes.

Source

Fichier : wp-includes/functions.wp-scripts.php

functionwp_enqueue_script($handle,$src='',$deps=array(),$ver=false,$in_footer=false){_wp_scripts_maybe_doing_it_wrong(__FUNCTION__,$handle);$wp_scripts=wp_scripts();if($src||$in_footer){$_handle=explode('?',$handle);if($src){$wp_scripts->add($_handle[0],$src,$deps,$ver);}if($in_footer){$wp_scripts->add_data($_handle[0],'group',1);}}$wp_scripts->enqueue($handle);}

Related

Utilise

Utilisations Description
wp-includes/functions.wp-scripts.php : wp_scripts()

Initialise $wp_scripts s'il n'a pas été défini.

Utilisé par

Utilisé par Description
wp-includes/class-wp-block.php : WP_Block::render()

Génère la sortie de rendu pour le bloc.

wp-includes/script-loader.php : wp_enqueue_editor_block_directory_assets()

Met en file d'attente les actifs requis pour le répertoire de blocs au sein de l'éditeur de blocs.

wp-includes/script-loader.php : enqueue_editor_block_styles_assets()

Fonction responsable de la mise en file d'attente des actifs nécessaires à la fonctionnalité des styles de bloc sur l'éditeur.

wp-includes/script-loader.php : wp_enqueue_registered_block_scripts_et_styles()

Met en file d'attente les scripts de bloc et les styles enregistrés, en fonction du contexte rendu actuel (ne met en file d'attente que les scripts de l'éditeur lorsqu'il est dans le contexte de l'éditeur).

wp-admin/includes/post.php : the_block_editor_meta_boxes()

Rend les formulaires des boîtes méta.

wp-admin/includes/meta-boxes.php : register_et_do_post_meta_boxes()

Enregistre les méta-boîtes de post par défaut, et exécute la fonction de. do_meta_boxes actions.

wp-admin/includes/class-wp-privacy-policy-content.php : WP_Privacy_Policy_Content::notice()

Ajout d'un avis avec un lien vers le guide lors de l'édition de la page de politique de confidentialité.

wp-includes/general-template.php : wp_enqueue_code_editor()

Enqueue les actifs nécessaires à l'éditeur de code pour les paramètres donnés.

wp-includes/widgets/class-wp-widget-media-gallery.php : WP_Widget_Media_Gallery::enqueue_admin_scripts()

Charge les fichiers médias requis pour le gestionnaire de médias et les scripts pour les widgets médias.

wp-includes/widgets/class-wp-widget-custom-html.php : WP_Widget_Custom_HTML::enqueue_admin_scripts()

Charge les scripts et les styles requis pour le contrôle du widget.

wp-includes/widgets/class-wp-widget-text.php : WP_Widget_Text::enqueue_admin_scripts()

Charge les scripts et les styles requis pour le contrôle du widget.

wp-includes/widgets/class-wp-widget-media-audio.php : WP_Widget_Media_Audio::enqueue_admin_scripts()

Charge les fichiers médias requis pour le gestionnaire de médias et les scripts pour les widgets médias.

wp-includes/widgets/class-wp-widget-media-audio.php : WP_Widget_Media_Audio::enqueue_preview_scripts()

Mise en file d'attente des scripts de prévisualisation.

wp-includes/widgets/class-wp-widget-media-video.php : WP_Widget_Media_Video::enqueue_preview_scripts()

Mise en file d'attente des scripts d'aperçu.

wp-includes/widgets/class-wp-widget-media-video.php : WP_Widget_Media_Video::enqueue_admin_scripts()

Charge les scripts et les styles requis pour le contrôle du widget.

wp-includes/widgets/class-wp-widget-media.php : WP_Widget_Media::enqueue_admin_scripts()

Charge les scripts et les styles requis pour le contrôle du widget.

wp-includes/widgets/class-wp-widget-media-image.php : WP_Widget_Media_Image::enqueue_admin_scripts()

Charge les fichiers médias requis pour le gestionnaire de médias et les scripts pour les widgets médias.

wp-includes/theme.php : the_custom_header_markup()

Imprime le balisage d'un en-tête personnalisé.

wp-includes/customize/class-wp-customize-selective-refresh.php : WP_Customize_Selective_Refresh::enqueue_preview_scripts()

Met en file d'attente les scripts d'aperçu.

wp-includes/embed.php : wp_oembed_add_host_js()

Ajoute le JavaScript nécessaire pour communiquer avec les iframes intégrées.

wp-includes/customize/class-wp-customize-cropped-image-control.php : WP_Customize_Cropped_Image_Control::enqueue()

Mise en file d'attente des scripts/styles liés au contrôle.

wp-includes/class-wp-customize-nav-menus.php : WP_Customize_Nav_Menus::customize_preview_enqueue_deps()

Mise en file d'attente des scripts pour l'aperçu du Customizer.

wp-includes/class-wp-customize-nav-menus.php : WP_Customize_Nav_Menus::enqueue_scripts()

Mise en file d'attente des scripts et des styles pour le volet Customizer.

wp-admin/includes/dashboard.php : wp_dashboard_setup()

Enregistre les widgets du tableau de bord.

wp-admin/includes/class-wp-internal-pointers.php : WP_Internal_Pointers::enqueue_scripts()

Initialise les nouveaux pointeurs de fonctionnalités.

wp-admin/includes/template.php : do_accordion_sections()

Fonction de modèle d'accordéon de boîte méta.

wp-admin/includes/media.php : wp_media_upload_handler()

Gère le processus de téléchargement des médias.

wp-admin/includes/media.php : media_upload_gallery()

Récupère l'ancien formulaire de téléchargement de médias dans une iframe.

wp-admin/includes/comment.php : enqueue_comment_hotkeys_js()
wp-admin/includes/class-custom-image-header.php : Custom_Image_Header::js_includes()

Configurer la file d'attente pour les fichiers JavaScript.

wp-admin/includes/class-custom-background.php : Custom_Background::admin_load()

Configurer la file d'attente pour les fichiers CSS et JavaScript.

wp-includes/class-wp-customize-manager.php : WP_Customize_Manager::enqueue_control_scripts()

Mise en file d'attente des scripts pour les contrôles de personnalisation.

wp-includes/class-wp-customize-manager.php : WP_Customize_Manager::customize_preview_init()

Imprimer les paramètres JavaScript.

wp-includes/general-template.php : add_thickbox()

Met en file d'attente les js et css par défaut de ThickBox.

wp-includes/functions.php : wp_auth_check_load()

Chargement du contrôle d'authentification pour surveiller si l'utilisateur est toujours connecté.

wp-includes/class-wp-admin-bar.php : WP_Admin_Bar::initialize()
wp-includes/media.php : wp_enqueue_media()

Met en file d'attente tous les scripts, styles, paramètres et modèles nécessaires pour utiliser toutes les API JS de médias.

wp-includes/media.php : wp_video_shortcode()

Construit la sortie du shortcode vidéo.

wp-includes/media.php : wp_playlist_scripts()

Sort et met en file d'attente les scripts et styles par défaut pour les listes de lecture.

wp-includes/media.php : wp_audio_shortcode()

Construit la sortie du shortcode audio.

wp-includes/customize/class-wp-customize-header-image-control.php : WP_Customize_Header_Image_Control::enqueue()
wp-includes/customize/class-wp-customize-color-control.php : WP_Customize_Color_Control::enqueue()

Mise en file d'attente des scripts/styles pour le sélecteur de couleurs.

wp-includes/class-wp-customize-widgets.php : WP_Customize_Widgets::enqueue_scripts()

Met en file d'attente les scripts et les styles pour le panneau Customizer et exporte les données vers JavaScript.

wp-includes/class-wp-customize-widgets.php : WP_Customize_Widgets::customize_preview_enqueue()

Met en file d'attente les scripts pour l'aperçu du Customizer.

wp-includes/class-wp-editor.php : _WP_Editors::enqueue_scripts()

Changelog

Version Description
2.1.0 Introduit.