Document : méthode queryCommandEnabled()
Obsolète
Évitez d'utiliser cette fonctionnalité dans de nouveaux projets.
The execCommand() method is "not implemented consistently or fully by user agents, and it is not expected that this will change in the foreseeable future."
Cette fonctionnalité peut être candidate à la suppression des standards web ou des navigateurs.
Envisagez d'utiliser plutôt les fonctionnalités suivantes : Async clipboard ou contenteditable.
Non standard: Cette fonctionnalité n'est pas standardisée. Nous déconseillons d'utiliser des fonctionnalités non standard en production, car leur prise en charge par les navigateurs est limitée, et elles peuvent être modifiées ou supprimées. Toutefois, elles peuvent constituer une alternative appropriée dans certains cas où aucune option standard n'existe.
Note :
Bien que la méthode execCommand() soit obsolète, si vous décidez de l'utiliser pour les raisons indiquées sur cette page, vous devriez vérifier la disponibilité de la commande avec queryCommandEnabled() pour garantir la compatibilité.
La méthode queryCommandEnabled() de l'interface Document indique si la commande d'édition définie est activée par le navigateur.
Syntaxe
queryCommandEnabled(command)
Paramètres
command-
La commande pour laquelle déterminer la prise en charge.
Valeur de retour
Retourne une valeur booléenne qui est true si la commande est activée et false si elle ne l'est pas.
Notes
- Pour les commandes
"cut"et"copy", la méthode ne retourne vrai que lorsqu'elle est appelée depuis un processus initié par l'utilisateur·ice. - La commande
"paste"retournefalsenon seulement si la fonctionnalité est indisponible, mais aussi si le script qui l'appelle n'a pas les privilèges suffisants pour effectuer l'action.
Exemples
const flg = document.queryCommandEnabled("SelectAll");
if (flg) {
document.execCommand("SelectAll", false, null); // la commande est activée, on l'exécute
}
Spécifications
Cette fonctionnalité ne fait partie d'aucune spécification actuelle. Elle n'est plus destinée à devenir un standard. Il existe un brouillon non officiel de la spécification W3C execCommand (angl.).
Compatibilité des navigateurs
Voir aussi
- La méthode
document.execCommand() - La méthode
document.queryCommandSupported()