Méthode prop
La méthode prop permet d'obtenir et
de modifier une propriété d'un élément.
Il est important de ne pas confondre les propriétés et les attributs des éléments.
Lors de la création de l'arbre DOM, les attributs sont convertis
en propriétés DOM correspondantes des éléments. Leurs
noms ne coïncident pas toujours, pas plus que leurs valeurs.
Certaines propriétés peuvent également ne pas avoir
d'attributs correspondants, elles peuvent être
obtenues et définies uniquement en utilisant la méthode
prop, par exemple la propriété
tagName. Pour
obtenir les attributs d'un élément, utilisez la méthode
attr.
Syntaxe
Obtenir la valeur d'une propriété :
$(sélecteur).prop(nom de la propriété);
Modifier la valeur d'une propriété :
$(sélecteur).prop(nom de la propriété, nouvelle valeur);
Modifier les valeurs de plusieurs propriétés :
$(sélecteur).prop({première_propriété: nouvelle_valeur, deuxième_propriété: nouvelle_valeur, ...});
Application d'une fonction à chaque élément de l'ensemble :
$(sélecteur).prop(nom de la propriété, function(numéro dans l'ensemble, valeur actuelle de la propriété));
Exemple
Dans l'exemple suivant, nous obtiendrons un paragraphe par son id
et afficherons à l'écran la valeur de sa propriété className :
<p id="test" class="aaa">text</p>
let value = $('#test').prop('className');
console.log(value);
Exemple
Modifions simultanément les propriétés
className et disabled :
<input type="checkbox" class="aaa" id="test" />
$("#test").prop({ className: 'bbb', disabled: 'true' });
Voir aussi
-
la méthode
removeProp,
qui permet de supprimer les propriétés des éléments -
la méthode
attr,
qui permet de travailler avec les attributs des éléments
