<input type="color">
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Les éléments <input>
de type "color"
permettent de sélectionner une couleur via une interface (un sélecteur de couleur) ou en saisissant le code hexadécimal de la couleur au format "#rrggbb"
. Ce format de valeur peut être utilisé en CSS.
L'apparence du contrôle de sélection des couleurs peut grandement varier d'un navigateur à un autre et d'un système d'exploitation à un autre. Pour certains navigateurs, seul un champ textuel sera affiché afin de saisir le code de la couleur (avec des mécanismes de validation vérifiant le format), pour d'autres, ce sera le sélecteur de couleur du système d'exploitation qui sera utilisé et pour d'autres encore, ce sera un sélecteur de couleur spécifique.
Exemple interactif
Valeur
L'attribut value
d'un élément <input type="color">
est une chaîne de caractères sur 7 caractères qui correspond au code de la couleur en représentation hexadécimale RGB. Autrement dit, le premier caractère est un croisillon (#) , les deux suivants indiquent la composante rouge (R) de la couleur, les deux suivants indiquent la couleur verte (G pour Green en anglais) et les deux suivants indiquent la composante bleue (B) de la couleur. La valeur respecte nécessairement ce format et n'est jamais vide.
Note :
Si la valeur saisie n'est pas un code hexadécimal RGB d'une couleur opaque valide, c'est la valeur "#000000"
(c'est-à-dire la couleur noire) qui sera utilisée. Il est notamment impossible d'utiliser les noms de couleurs CSS ou des fonctions CSS afin de définir cette valeur. Il faut garder à l'esprit que HTML et CSS sont deux langages séparés, définis par des spécifications distinctes. De plus, les couleurs avec un canal alpha ne sont pas prises en charges, utiliser un code avec une notation sur 9 caractères entraînera également l'utilisation de "#000000"
.
Utiliser les contrôles de saisie des couleurs
Les éléments <input type="color">
sont simples à utiliser (notamment en raison du faible nombre d'attributs qu'ils gèrent).
Fournir une couleur par défaut
Il est possible de créer un sélecteur de couleur qui emploie une valeur par défaut :
<input type="color" value="#ff0000" />
Si aucune valeur n'est indiquée, c'est "#000000"
qui sera utilisée par défaut (la couleur noire). Comme indiqué dans la note ci-avant, la valeur de cet attribut doit être de la forme "#rrggbb"
. Pour les couleurs dans un autre format (couleurs nommées CSS ou couleurs calculées à l'aide des fonctions rgb()
ou rgba()
), il faudra les convertir au format hexadécimal avant de les utiliser pour value
.
Détecter le changement de couleur
Comme pour les différents éléments <input>
, deux évènements peuvent être utilisés afin de détecter une modification de la couleur : input
et change
. input
est déclenché sur l'élément <input>
à chaque fois que la couleur change. L'évènement change
est déclenché lorsque l'utilisateur ferme le sélecteur de couleur. Dans tous les cas, il est possible de déterminer la nouvelle valeur de l'élément grâce à value
.
colorPicker.addEventListener("input", updateFirst, false);
colorPicker.addEventListener("change", watchColorPicker, false);
function watchColorPicker(event) {
document.querySelectorAll("p").forEach(function (p) {
p.style.color = event.target.value;
});
}
Sélectionner la valeur
Si l'implémentation du navigateur n'affiche pas de sélecteur de couleur mais un champ texte, il est possible de sélectionner la valeur du texte avec la méthode select()
. Si le navigateur affiche un sélecteur de couleur, select()
ne fera rien. Soyez conscient⋅e de ce comportement afin d'adapter votre code à ce cas.
colorWell.select();
Validation
La valeur d'un tel champ est considérée invalide si l'interface utilisateur ne parvient pas à convertir la saisie de l'utilisateur en une notation hexadécimale sur sept caractères et en minuscules. Si c'est le cas, la pseudo-classe CSS :invalid
sera appliquée à l'élément.
Exemples
HTML
Le fragment de code HTML utilisé est relativement simple. On utilise quelques paragraphes descriptifs ainsi qu'un élément <input>
de type "color"
dont l'identifiant est "colorWell"
(c'est la valeur de cette couleur qu'on utilisera pour changer la couleur du texte des paragraphes).
<p>
Un exemple qui illustre l'utilisation de
<code><input type="color"></code>.
</p>
<label for="colorWell">Couleur :</label>
<input type="color" value="#ff0000" id="colorWell" />
<p>
Vous pouvez ici voir que la couleur du premier paragraphe changer lorsqu'on
ajuste la valeur dans le sélecteur. Pour cela, on utilise l'évènement
<code>input</code>. Lorsqu'on ferme le sélecteur, l'évènement
<code>change</code> est déclenché et on applique la modification est appliquée
à l'ensemble des paragraphes.
</p>
JavaScript
Tout d'abord, on établit certains variables : une pour la couleur du sélecteur et une autre couleur pour la couleur par défaut. On ajoute un gestionnaire load
afin de lancer les actions de démarrage lorsque la page est chargée.
var colorWell;
var defaultColor = "#0000ff";
window.addEventListener("load", startup, false);
Initialisation
Lorsque la page est chargée, l'évènement "load"
est déclenché et la fonction startup()
est donc appelée :
function startup() {
colorWell = document.querySelector("#colorWell");
colorWell.value = defaultColor;
colorWell.addEventListener("input", updateFirst, false);
colorWell.addEventListener("change", updateAll, false);
colorWell.select();
}
Dans cette fonction, on utilise la variable colorWell
déclarée plus haut et on remplit sa valeur avec la valeur par défaut (la valeur de defaultColor
). Ensuite, on indique les gestionnaires d'évènements : input
appellera updateFirst()
et change
appellera updateAll()
qui seront détaillés ensuite.
Enfin, on appelle select()
afin de sélectionner le texte du champ si le contrôle est un champ texte.
Réagir suite aux modifications de couleurs
On dispose de deux fonctions qui gèrent les modifications de couleurs. La fonction updateFirst()
permet de répondre à l'évènement input
et modifie la couleur du premier paragraphe dans le document en utilisant la nouvelle valeur saisie. Étant donné que les évènements input
ont lieu à chaque fois qu'un ajustement est fait, cette fonction sera appelée sans cesse lorsque le sélecteur de couleur est utilisé.
function updateFirst(event) {
var p = document.querySelector("p");
if (p) {
p.style.color = event.target.value;
}
}
Lorsque le sélecteur est fermé, cela signifie que la valeur ne sera plus modifié avant une prochaine ouverture du sélecteur. Un évènement change
est alors envoyé et cela déclenche alors l'appel de la fonction updateAll()
:
function updateAll(event) {
document.querySelectorAll("p").forEach(function (p) {
p.style.color = event.target.value;
});
}
Cela permet de modifier la couleur de chaque bloc <p>
du document afin que la couleur (cf. color
) soit celle sélectionnée dans le contrôle. Pour récupérer cette valeur, on utilise l'objet event.target
.
Résultat
Résumé technique
Spécifications
Specification |
---|
HTML Standard # color-state-(type=color) |
Compatibilité des navigateurs
BCD tables only load in the browser