MDN wants to talk to developers like you: https://qsurvey.mozilla.com/s3/8d22564490d8

document.execCommand

Voir Édition de texte riche dans Mozilla.


Lorsqu'un document HTML est passé à designMode, l'objet document expose la méthode execCommand qui permet d'exécuter des commandes pour manipuler le contenu de la zone modifiable. La plupart des commandes affectent la sélection du document (gras, italique, etc.), tandis que d'autres ajoutent de nouveaux éléments (ajout d'un lien) ou affectent une ligne entière (indentation). Lorsque vous utilisez contentEditable, l'appel execCommand() affectera l'élément modifiable actuellement actif.

Syntax

bool = document.execCommand(aCommandNameaShowDefaultUIaValueArgument)

Valeur retournée

Un Boolean qui est à false si la commande n'est pas supportée on désactivée.

Paramètres

aCommandName
DOMString spécifie le nom de la commande à exécuter ​​​​​​. Voir Commands pour la liste des commandes possibles .

aShowDefaultUI
Un Boolean indiquant si l'interface utilistaeur par défaut doit être affichée. Ce n'est pas implémenter à Mozilla.

aValueArguments
Pour les commandes qui nécessitent un argument (par exemple insertImage pour laquelle l'URL de l'image est insérer), il s'agit d'une DOMString fournissant ces informations. Spécifiez null si aucun argument n'est nécessaire.

Commandes

backColor
Change la couleur d'arrière-plan du document. En mode styleWithCss, il affecte plutôt la couleur de fond du bloc contenant. Cela nécessite une chaîne de valeurs <color> pour être transmise en tant qu'argument de valeur. Notez que Internet Explorer utilise cette option pour définir la couleur d'arrière-plan du texte.

bold
Ajoute ou enlève l'affichage bold de la sélection ou au point d'insertion. Internet Explorer utilise la balise <strong> au lieux de <b>.

contentReadOnly
Rend le  contenue du document en lecture seule ou modifiable. Cela nécessite qu'un booléen true / false soit transmis en tant qu'argument de valeur. (Non pris en charge par Internet Explorer.)

copy
Copie la sélection courante dans le presse papier. Les conditions d'activation de ce comportement varient d'un navigateur à l'autre et ont évolué au fil du temps. Vérifiez la table de compatibilité pour déterminer si vous pouvez l'utiliser dans votre cas.

createLink
Crée un lien d'ancrage à partir de la sélection, uniquement s'il existe une sélection. Cela nécessite que la chaîne URI HREF soit transmise en tant qu'argument de valeur. L'URI doit contenir au moins un caractère unique, qui peut être un espace blanc. (Internet Explorer créera un lien avec une valeur URI nulle.)

cut
Coupe et copie la sélection courante dans le presse papier. Les conditions d'activation de ce comportement varient d'un navigateur à l'autre et ont évolué au fil du temps. Vérifiez la table de compatibilité pour déterminer si vous pouvez l'utiliser dans votre cas.

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

delete
Supprime la sélection courante

enableInlineTableEditing
Active ou désactive les commandes d'insertion et de suppression des lignes et des colonnes du tableau. (Non pris en charge par Internet Explorer.)

enableObjectResizing
Active ou désactive les poignées de redimensionnement des images et autres objets redimensionnables. (Non pris en charge par Internet Explorer.)

fontName
Modifie le nom de police de la sélection ou du point d'insertion. Cela nécessite une chaîne de nom de police ("Arial" par exemple) à transmettre comme un argument de valeur.

fontSize
Modifie la taille de police pour la sélection ou au point d'insertion. Cela nécessite que la taille d'une police HTML (1-7) soit transmise en tant qu'argument de valeur.

foreColor
Modifie une couleur de police pour la sélection ou au point d'insertion. Cela nécessite qu'une chaîne de valeurs de couleur soit transmise en tant qu'argument de valeur.

formatBlock
Ajoute une balise HTML style bloc autour de la ligne contenant la sélection en cours, en remplaçant l'élément bloc contenant la ligne si elle existe (dans Firefox, BLOCKQUOTE est l'exception - il enroule tout élément bloc contenant). Nécessite la saisie d'une chaîne de nom d'étiquette comme argument de valeur. Pratiquement toutes les étiquettes de style de bloc peuvent être utilisées (par exemple "<h1>", "<p>", "<dl>", "<blockquote>"). (Internet Explorer ne prend en charge que les balises de titre H1 - H6, ADDRESS et PRE, qui doivent également inclure les délimiteurs de balises <>, tels que "<H1>".)

forwardDelete
Supprime le caractère avant la position du curseur. Il est le même que frapper la touche de suppression.

heading
Ajoute une balise de titre autour d'une ligne de sélection ou d'insertion. Nécessite que la chaîne de nom d'étiquette soit transmise en tant qu'argument de valeur (c'est-à-dire "<h1>", "<h6>"). (Non pris en charge par Internet Explorer et Safari.)

hiliteColor
Modifie la couleur d'arrière-plan de la sélection ou du point d'insertion. Nécessite une chaîne de valeurs de couleur à transmettre comme argument de valeur. UseCSS doit être activé pour que cela fonctionne. (Non pris en charge par Internet Explorer.)

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

indent
Décale la ligne contenant le point de sélection ou d'insertion. Dans Firefox, si la sélection s'étend sur plusieurs lignes à différents niveaux d'indentation, seules les lignes les moins indentées de la sélection seront indentées.

insertBrOnReturn
Contrôle si la touche Entrée insère une balise br ou divise l'élément de bloc courant en deux. (Non pris en charge par Internet Explorer.)

insertHorizontalRule
Insère une ligne horizontale au point d'insertion. (Supprime la sélection)

insertHTML
Insère une chaîne HTML au point d'insertion (supprime la sélection). Nécessite une chaîne HTML valide à transmettre en tant qu'argument de valeur. (Non pris en charge par Internet Explorer.)

insertImage
Insère une image au point d'insertion (supprime la sélection). Nécessite l'image SRC URI chaîne à passer comme un argument de valeur. L'URI doit contenir au moins un caractère unique, qui peut être un espace blanc. (Internet Explorer créera un lien avec une valeur URI nulle.)

insertOrderedList
Crée une liste numérotée pour la sélection ou le point d'insertion.

insertUnorderedList
Crée une liste non triée à puces pour la sélection ou au point d'insertion.

insertParagraphe
Insère un paragraphe autour de la sélection ou de la ligne en cours. (Internet Explorer insère un paragraphe au point d'insertion et supprime la sélection.)

insertText
Insère le texte brut donné au point d'insertion (supprime la sélection).

italic
Active / désactive l'italique pour la sélection ou le point d'insertion. (Internet Explorer utilise la balise EM au lieu de I.)

justifyCenter
Centre le point de sélection ou d'insertion.

justifyFull
Justifie le point de sélection ou d'insertion.

justifyLeft
Justifie le point de sélection ou d'insertion vers la gauche.

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

outdent
Augmente la ligne contenant le point de sélection ou d'insertion.

paste
Colle le contenu du Presse-papiers au point d'insertion (remplace la sélection en cours). La fonctionnalité Presse-papiers doit être activée dans le fichier de préférences user.js. Voir [1].

redo
Rétablit la commande d'annulation précédente.

removeFormat
Supprime tout le formatage de la sélection en cours.

selectAll
Sélectionne tout le contenu de la zone modifiable.

strikeTrough
Active ou désactive le barré pour la sélection ou le point d'insertion.

subscript
Active ou désactive l'indice sur la sélection ou au point d'insertion.

superscript
Activer / désactiver le surlignage pour la sélection ou le point d'insertion.

underline
Active ou désactive le soulignement pour la sélection ou le point d'insertion.

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

unlink
Supprime la balise d'ancrage d'un lien d'ancrage sélectionné.

useCSS 
Active / désactive l'utilisation de balises HTML ou CSS pour le balisage généré. Nécessite un argument booléen vrai / faux comme argument de valeur. REMARQUE: Cet argument est logiquement inverse (c.-à-d. Utiliser false pour utiliser CSS, true pour utiliser HTML). (Non pris en charge par Internet Explorer.) Cela a été obsolète; Utilisez plutôt la commande styleWithCSS.

styleWithCSS
Remplace la commande useCSS; Argument fonctionne comme prévu, c'est-à-dire true modifie / génère des attributs de style dans le balisage, false génère des éléments de mise en forme.

Exemples

Un exemple d'utilisation sur CodePen.

Spécificités

Specification Status Comment
HTML Editing APIs
La définition de 'execCommand' dans cette spécification.
Brouillon de l'éditeur Initial definition

Compatibilités des navigateurs

        
Feature Chrome Edge Firefox (Gecko) Internet Explorer Opera Safari
Basic support (Oui) (Oui) (Oui)[1] ? ? (Oui)
insertBrOnReturn Pas de support Pas de support (Oui) Pas de support Pas de support Pas de support
copy/cut 43 (Oui) 41 (41) 9 29 10

[1] Avant Firefox 41, la capacité du presse-papiers devait être activée dans le fichier de préférences user.js. Voir Un bref guide des préférences Mozilla pour plus d'informations. Si la commande n'était pas prise en charge ou activée, execCommand déclenchait une exception au lieu de renvoyer false.In Firefox 41 et versions ultérieures, la capacité du presse-papiers est activée par défaut dans n'importe quel gestionnaire d'événements capable de faire apparaître une fenêtre (scripts semi-approuvés).

Voir ailleurs

Étiquettes et contributeurs liés au document

Étiquettes : 
 Contributeurs à cette page : ebear, fscholz, teoli, bfn
 Dernière mise à jour par : ebear,