add |
jQuery |
|---|---|
| JavaScript | Version 1.0+ |
Syntaxe
| .add(selecteur); | Version 1.0+ |
| .add(elements); | Version 1.0+ |
| .add(html); | Version 1.0+ |
| .add(jQueryObject); | Version 1.3.2+ |
| .add(selecteur, contexte); | Version 1.4+ |
Paramètres
| Nom | Description |
|---|---|
| selecteur | Ce paramètre permet d'indiquer une expression de sélecteur. |
| elements | Ce paramètre permet d'indiquer un ou plusieurs éléments à ajouter à l'ensemble des éléments correspondant. |
| html | Ce paramètre permet d'indiquer un fragment de code source HTML à ajouter à l'ensemble des éléments correspondant. |
| jQueryObject | Ce paramètre permet d'indiquer un objet jQuery à ajouter à l'ensemble des éléments correspondant. |
| contexte | Ce paramètre permet d'indiquer le point dans le document dans lequel le sélecteur doit commencer sa recherche de correspondance. Ce paramètre est similaire à la méthode «$(selecteur,contexte)». |
Description
Cette méthode permet d'ajouter des éléments à l'ensemble de correspondance d'éléments.
Remarques
- Étant donné un objet jQuery représentant un ensemble d'éléments DOM, la méthode .add() construit un nouvel objet jQuery à partir de l'union de ces éléments et de ceux passés dans la méthode. Les paramètres de la méthode .add() peut être à peu près tout ce que $() accepte, y compris une expression de sélecteur jQuery, des références à des éléments DOM ou un extrait HTML.
- Vous ne devriez pas supposer que cette méthode ajoute les éléments à la collection existante dans l'ordre où ils sont passés à la méthode .add(). Lorsque tous les éléments sont membres du même document, la collection résultante de .add() sera triée dans l'ordre du document; c'est-à-dire, par ordre d'apparition de chaque élément dans le document. Si la collection se compose d'éléments de différents documents ou de ceux ne figurant dans aucun document, l'ordre de tri n'est pas défini. Pour créer un objet jQuery avec des éléments dans un ordre bien défini et sans trier les frais généraux, utilisez la signature $(array_of_DOM_elements).
Exemple
Voici un exemple montrant comment changer la couleur du paragraphe (à l'origine blanc sur fond blanc) où il est écrit «Bonjour» :
on obtiendra le résultat suivant :
Bonjour
Dernière mise à jour : Dimanche, le 1 mars 2015