English | 简体中文 | 繁體中文 | Русский язык | Français | Español | Português | Deutsch | 日本語 | 한국어 | Italiano | بالعربية

Méthode jQuery prop()

jQuery HTML/Méthodes CSS

La méthode prop() de jQuery permet d'obtenir ou de définir les attributs et les valeurs des éléments sélectionnés.

Lorsque vous utilisez la méthode prop()Obtenirlorsque vous définissez la valeur de l'attribut, il retourneraLe premier élément sélectionnévaleur.

Utilisez la méthode prop()Définirlorsque vous définissez la valeur de l'attribut, il seraTous les éléments sélectionnésDéfinir une ou plusieurs valeurs d'attribut/paires de valeurs.

Pour obtenir ou définir des attributs HTML, utilisezattr()Méthode.

Pour supprimer un attribut, utilisezremoveProp()Méthode.

Syntaxe :

Obtenir la valeur de l'attribut :

$(selector).prop(property)

Définir l'attribut et la valeur :

$(selector).prop(property, value)

Définir plusieurs attributs et valeurs :

$(selector).prop({property:value, property:value, ...})

Définir l'attribut et la valeur en utilisant une fonction

$(selector).prop(property, function(index, currentValue))

Exemple

Obtenir la valeur de l'attribut checked du case à cocher :

$("input:checkbox").change(function(){
  $("strong").text($(this).prop("checked"));
});
Vérifiez et voyez‹/›

Définir la valeur de l'attribut sélectionné du case à cocher :

$("button").click(function(){
  $("input:checkbox").prop("checked", true);
});
Vérifiez et voyez‹/›

Désactiver tous les cases à cocher sur la page :

$(document).ready(function(){
  $("input:checkbox").prop("disabled", true);
});
Vérifiez et voyez‹/›

prop() et attr()

La différence entre prop() et attr() peut être importante dans certains cas.

La méthode prop() fournit une méthode explicite pour récupérer la valeur de l'attribut, tandis que attr() récupère l'attribut.

L'exemple suivant montre la différence entre prop() et attr():

$("input:checkbox").change(function(){
  $(this).prop("checked");
  $(this).attr("checked");
});
Vérifiez et voyez‹/›

Valeur du paramètre

ParamètresDescription
propertySpécifier le nom de l'attribut
valueSpécifier la valeur de l'attribut
function(index, currentValue)Spécifier une fonction qui renvoie la valeur de l'attribut à définir
  • Index -Recevoir la position de l'index de l'élément dans le groupe mentionné

  • currentValue-Recevoir la valeur actuelle de l'attribut de l'élément sélectionné

jQuery HTML/Méthodes CSS