prop |
jQuery |
|---|---|
| JavaScript | Version 1.6+ |
Syntaxe
| .prop( propertyName ); | 1.5+ |
| .prop( propertyName, value ); | 1.6+ |
| .prop( propertyName, function(index, oldPropertyValue) ); | 1.6+ |
Paramètres
| Nom | Description |
|---|---|
| propertyName | Ce paramètre permet d'indiquer le nom de la propriété. |
| value | Ce paramètre permet d'indiquer la valeur de la propriété. |
| function(index, oldPropertyValue) | Ce paramètre permet de retourner la valeur à fixer. |
Description
Cette méthode permet de demander la valeur d'une propriété du premier élément dans l'ensemble d'éléments correspondant.
Remarques
- Avant la version 1.6 (1.5 et inférieur) de jQuery, vous devrez utiliser la syntaxe suivante pour les cases à cocher :
- Attribut vs propriété : Des tests de performances ont révélé que l'utilisation de propriété (prop) plutôt que l'attribut (attr) améliorait considérablement les performances pour les plupart des navigateurs Web (Chrome, Safari, Firefox, Opera,...) sauf pour le navigateur Web IE7. Devant ses faits accablant, il est donc fortement recommandé d'utiliser cette méthode plutôt que l'attribut (attr).
.attr('checked','checked')
plutôt que
.prop('checked',true)
Exemples
L'exemple suivant permet de sélectionner le troisième élément de la liste (premier élément = 0, deuxième élément = 1, troisième élément = 2,...) :
- <!DOCTYPE html>
- <html>
- <head>
- <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.6/jquery.min.js"></script>
- </head>
- <body>
- <select id="MyOption">
- <option value="AA">AA</option>
- <option value="BB">BB</option>
- <option value="CC">CC</option>
- <option value="CC">DD</option>
- </select>
- <script>
- jQuery("#MyOption").prop('selectedIndex', 2);
- </script>
- </body>
- </html>
L'exemple suivant permet de cocher automatiquement la case à cocher «macaseacocher» :
- <!DOCTYPE html>
- <html>
- <head>
- <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.6/jquery.min.js"></script>
- </head>
- <body>
- <input type="checkbox" id="macaseacocher" name="macaseacocher" value="mavaleur"> Case cocher automatiquement
- <script>
- jQuery('#macaseacocher').prop('checked',true);
- </script>
- </body>
- </html>
Dernière mise à jour : Dimanche, le 1 mars 2015