Langage de programmation - JavaScript - Références des bibliothèques et cadres d'application - jQuery

attr	jQuery
JavaScript	Version 1.0+

Syntaxe

.attr(attributeName);	Version 1.0+
.attr(attributeName, value);	Version 1.0+
.attr(map);	Version 1.0+
.attr( attributeName, function(index, attr) );	Version 1.1+

Paramètres

Nom	Description
attributeName	Ce paramètre permet d'indiquer le nom de l'attribut à demander ou fixer (si le paramètre «value» existe).
value	Ce paramètre permet d'indiquer la valeur à fixer dans l'attribut.
function(index, attr)	Ce paramètre permet d'indiquer une fonction retournant la valeur à fixe.
map	Ce paramètre permet d'indiquer un tableau à cartographier.

Description

Cette méthode permet de demander la valeur de l'attribue pour le premier élément de l'ensemble de correspondance d'éléments.

Remarques

A partir de la version 1.6 de jQuery, vous devrez plutôt utiliser la syntaxe suivante pour les cases à cocher :


		.prop('checked',true)

car celle-ci est obsolète


		.attr('checked','checked')

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).

Exemples

L'exemple suivant permet de remplacer le lien du «HREF» de «www.google.com» par «gladir.com» :


									
<html>

<head>

<script src="//ajax.googleapis.com/ajax/libs/jquery/1.9.0/jquery.min.js"></script> 

</head>

<body>

<a href="http://www.google.com" rel="external" class="mon-gladir">

Ceci est un lien.

</a>

<script>

jQuery('.mon-gladir').attr('href', "http://www.gladir.ca/");

</script>

</body>

</html>

Prenons pour acquis le code HTML suivant :




<div id="bigbox1">

 <p gladir-size="300x200,300x250,300x300">1</p>

 <p>2</p>

 <p>3</p>

 <p>4</p>

</div>

L'exemple suivant permettra de changer l'attribut supplémentaire «gladir-size» de la valeur «300x200,300x250,300x300» pour «300x200» :



<script src="//ajax.googleapis.com/ajax/libs/jquery/1.9.0/jquery.min.js"></script> 

<script>

$("#bigbox1 p").attr('gladir-size',$("#bigbox1 p").attr('gladir-size').substr(0,$("#bigbox1 p").attr('gladir-size').indexOf(',')));

document.write($("#bigbox1 p").attr('gladir-size'));

</script>

on obtiendra le résultat suivant :

300x200

Dernière mise à jour : Vendredi, le 30 octobre 2015

Section courante

A propos

Section administrative du site

attr

Syntaxe

Paramètres

Description

Remarques

Exemples