Lorsqu'un document HTML passe endesignMode, l'objetdocument correspondant expose une méthodeexecCommand() permettant d'exécuter des commandes manipulant la région éditable courante tels queles champs de formulaire ou les élémentscontentEditable.

La plupart des commandes affectent lasélection du document (mise en gras, italique, etc.), tandis qued'autres insèrent de nouveaux éléments (un lien) ou modifient toute une ligne (indentation). Lorsqu'onutilisecontentEditable,execCommand() affecte l'élément éditablecourant.

Syntaxe

document.execCommand(aCommandName, aShowDefaultUI, aValueArgument);

Valeur de retour

Un booléen (Boolean) qui vautfalse si la commande n'est pasprise en charge ou si elle est désactivée.

Paramètres

aCommandName

Une chaîne de caractèresDOMString indiquant le nom de la commande àexécuter. VoirCommandes pour une liste de commandes possibles.

aShowDefaultUI

Un booléen (Boolean) indiquant si l'interface utilisateur par défautdevrait être affichée. Ce n'est pas implémenté par Mozilla.

aValueArgument

Pour les commandes utilisant un argument en entrée, il s'agit d'une chaîneDOMStringqui fournit cette information. On pourra, par exemple,insertImage utilisel'URL de l'image à insérer. On utiliseranull si aucun argument n'est utilisé.

Commandes

backColor

Modifie la couleur d'arrière-plan du document. Avec le modestyleWithCss cela affecte la couleur d'arrière-plan du bloc englobant. Une chaîne de caractères décrivant une valeur<color> doit être passée en argument. On notera qu'Internet Explorer utilise ceci pour la couleur d'arrière-plan du texte.

bold

Active ou désactive la mise en gras pour la sélection ou à partir du point d'insertion Internet Explorer utilise la balise<strong> plutôt que<b>.

ClearAuthenticationCache

Supprime toutes les informations d'authentificationcredentials) du cache.

contentReadOnly

Rend le contenu du document en lecture seule ou éditable en fonction du booléen passé en argument (n'est pas pris en charge par Internet Explorer)

copy

Copie la sélection courante vers le presse-papier. Les conditions pour obtenir ce comportement peuvent varier d'un navigateur à l'autre. Veuillez voir le tableau de compatibilité ci-après.

createLink

Crée un hyperlien à partir de la sélection (sous réserve qu'il y en ait une). Une chaîne de caractères formant un URI est nécessaire comme argument afin de fournir la valeur de l'attributhref. L'URI doit contenir au moins un caractère (qui peut être un blanc). (Internet Explorer créera un lien avec une valeurnull.)

cut

Coupe le contenu de la sélection courante et le copie dans le presse-papier. Les conditions pour obtenir ce comportement peuvent varier d'un navigateur à l'autre. Veuillez voir le tableau de compatibilité ci-après.

decreaseFontSize

Ajoute une balise<small> autour de la sélection ou au point d'insertion. (Non pris en charge par Internet Explorer.)

defaultParagraphSeparator

Modifie le séparateur de paragraphe utilisé lorsque de nouveaux paragraphes sont créés dans les zones de texte éditables. VoirDifférences dans la génération du balisage pour plus de détails.

delete

Supprimer la sélection courante.

enableAbsolutePositionEditor

Active ou désactive la poignée qui permet de déplacer les éléments positionnés de façon absolue. Celle-ci est désactivée par défaut depuis Firefox 64 (bug Firefox 1490641).

enableInlineTableEditing

Active ou désactive les contrôles pour l'insertion ou la suppression des lignes ou colonnes de tableau. Les contrôles sont désactivés par défaut depuis Firefox 64 (bug Firefox 1490641).

enableObjectResizing

Active ou désactive les contrôles permettant de redimensionner les images, tableaux ou les éléments positionnés de façon absolue. Les poignées sont désactivées par défaut depuis Firefox 64 (bug Firefox 1490641).

fontName

Modifie le nom de la police pour la sélection ou à partir du point d'insertion. La valeur fournie en argument doit être un nom de police (ex."Arial").

fontSize

Modifie la taille de la police pour la sélection ou à partir du point d'insertion. La valeur fournie en argument doit être un entier compris entre 1 et 7.

foreColor

Modifie la couleur de la police pour la sélection ou à partir du point d'insertion. La valeur passée en argument doit être une chaîne de caractères décrivant une couleur exprimée en notation hexadécimale.

formatBlock

Ajoute un élément HTML de bloc autour de la ligne contenant la sélection courante et remplace l'éventuel élément de bloc englobant s'il en existe un (pour Firefox,<blockquote> fera exception et englobera n'importe quel bloc). L'argument passé doit être un nom de balise. Tous les éléments de bloc peuvent en théorie être utilisés. (Internet Explorer et Edge ne prennent en charge que les balisesH1 àH6,ADDRESS, etPRE qui doivent être passées entre chevrons :"<H1>".)

forwardDelete

Supprime un caractère à la position du curseur. Le comportement obtenu est le même que lorsqu'on appuie sur la toucheSuppr d'un clavier Windows.

heading

Ajoute un élément de titre autour de la sélection ou au niveau du point d'insertion. L'argument doit être le nom d'une balise de titre ("H1" à"H6"). (Non pris en charge par Internet Explorer et Safari.)

hiliteColor

Modifie la couleur d'arrière-plan pour la sélection ou à partir du point d'insertion. La valeur passée en argument doit être une chaîne de caractères définissant une couleur etuseCSS doit valoirtrue. (Non pris en charge par Internet Explorer.)

increaseFontSize

Ajoute une balise<big> autour de la sélection ou à partir du point d'insertion. (Non pris en charge par Internet Explorer).

indent

Augmente l'indentation de la ligne contenant la sélection ou le point d'insertion. Pour Firefox, si la sélection s'étend sur plusieurs lignes ayant différents niveaux d'indentation, seules les lignes les moins indentées seront décalées.

insertBrOnReturn

Contrôle si la toucheEntrée insère un élément<br> ou si le bloc courant est scindé en deux. (Non pris en charge par Internet Explorer.)

insertHorizontalRule

Insère un élément<hr> au point d'insertion ou remplace la sélection courante par cet élément.

insertHTML

Insère un élément au point d'insertion en supprimant la sélection. Une chaîne de caractères HTML valide doit être fournie en argument. (Non pris en charge par Internet Explorer.)

insertImage

Insère une image au point d'insertion en supprimant la sélection. L'argument doit être une chaîne de caractères indiquant l'URL à utiliser pour l'attributsrc de l'image. Les prérequis de cette valeur sont les mêmes que pourcreateLink.

insertOrderedList

Crée uneliste numérotée ordonnée pour la sélection ou à partir du point d'insertion.

insertUnorderedList

Crée uneliste non-ordonnée pour la sélection ou à partir du point d'insertion.

insertParagraph

Insère unparagraphe autour de la sélection pour la ligne courante. (Internet Explorer insère un paragraphe au point d'insertion et supprime la sélection.)

insertText

Insère le texte indiqué au point d'insertion (quitte à supprimer l'éventuelle sélection courante).

italic

Active ou désactive la mise en italique pour la sélection ou à partir du point d'insertion. (Internet Explorer utilisera l'élément<em> plutôt que<i>.)

justifyCenter

Centre la sélection ou le point d'insertion.

justifyFull

Justifie la sélection ou le point d'insertion.

justifyLeft

Justifie à gauche la sélection ou le point d'insertion.

justifyRight

Justifie à droite la sélection ou le point d'insertion.

outdent

Effectue un retrait d'indentation pour la ligne courante.

paste

Colle le contenu du presse-papier au point d'insertion (et remplace éventuellement la sélection actuelle). Fonctionnalité désactivée pour le contenu web.

redo

Rejoue l'action annulée par la précédente commandeundo.

removeFormat

Supprime toute mise en forme pour la sélection courante.

selectAll

Sélectionne l'ensemble du contenu de la région éditable.

strikeThrough

Active ou désactive la rayure de la sélection ou à partir d'un point d'insertion.

subscript

Active ou désactivela mise en indice pour la sélection ou au point d'insertion

superscript

Active ou désactivela mise en exposant pour la sélection ou au point d'insertion

underline

Active ou désactivele soulignement pour la sélection ou au point d'insertion.

undo

Annule la dernière commande exécutée.

unlink

Retire l'ancre de l'hyperlien sélectionné.

useCSSObsolète

Active/désactive l'utilisation de balises HTML ou de CSS pour le balisage généré. La valeur de l'argument doit être un booléen. Note : cet argument possède une logique inversée (false permet d'utiliser CSS ettrue permet d'utiliser HTML). Cette valeur n'est pas prise en charge par Internet Explorer et a été dépréciée en faveur destyleWithCSS.

styleWithCSS

Remplace la commandeuseCSS.true modifie/génère des attributsstyle dans le balisage tandis quefalse génère des éléments HTML de présentation.

Exemple

Un exemple d'utilisation est disponiblesur CodePen.

Spécifications

Compatibilité des navigateurs

Voir aussi

• HTMLElement.contentEditable
• document.designMode
• L'édition HTML dans Firefox
• Documentation des incohérencesnavigateur dans Scribe qui indique les bugs liés àdocument.execCommand.