La fonction execCommand est une fonction utilisée dans les éditeurs dit WYSIWYG. Elle permet de modifier la sélection de l'utilisateur. Elle accepte trois paramètres :
Le premier est l'identifiant de la commande (voir ci-bas).
Le deuxième est une valeur booléenne. Indiquer true, si vous souhaitez qu'une interface apparaissent s'il y a lieu. Indiquer false (la valeur par défaut) si vous ne le souhaitez pas.
Le troisième est un argument et est utilisé pour certains identifiants.
Liste des identifiants[]
- 2D-Position : Permets aux éléments ayant comme style de position absolute d'être déplacé par glisser-déposé.
- absolutePosition : Mets l'élément en style de position absolute.
- backColor : Ajoute ou supprime une couleur de fond à la sélection. Attend comme argument la couleur.
- blockDirLTR : change le sens de lecture vers un lecture de gauche à droite.
- blockDirRTL : change le sens de lecture vers un lecture de droite à gauche.
- bold : Mets la sélection en caractère gras ou le contraire si le texte est déjà en gras.
- browseMode : rend le block non éditable (preview)
- clearAuthenticationCache : Supprime les traces d'authentification dans le cache.
- contentReadOnly : Mets le document en lecture seule ou non. Attend une valeur booléenne comme argument. (Non supporté par Internet Explorer)
- copy : Mets la sélection dans le presse-papier.
- createBookmark : Mets une ancre dans la page. Attend comme argument le nom de l'ancre.
- createLink : Crée un hyperlien. Attend comme argument l'adresse du lien.
- cut : Coupe la sélection.
- decreaseFontSize : Rétrécit la taille du texte.
- delete : Supprime la sélection.
- dirLTR : Change le sens de lecture du texte (de gauche a droite)
- dirRTL : Change le sens de lecture du texte (de droite a gauche)
- editMode : mes le block definie en contenu editable
- fontName : Ajoute, change ou supprime la police de la sélection. Attend comme argument le nom de la police.
- fontSize : Change la taille de la sélection. Attend comme argument la taille de la police (nombre entre 1 et 7)
- foreColor : Change la couleur du texte. Attend comme argument la couleur.
- formatBlock : Ajoute des balises autour de la sélection. Attend comme argument la sélection.*
- heading : Mets la sélection en titre. Attend comme paramètre la balise du titre (H1 à H6).
- hiliteColor : Mets une couleur de fond à la sélection. Comme backColor.
- increaseFontSize : Augmente la taille de la police.
- indent : Indente la sélection d'une tabulation vers la droite.
- inlineDirLTR : Insère un élément ayant comme style display inline et ayant comme sens d'écriture de gauche à droite.
- inlineDirRTL : Insère un élément ayant comme style display inline et ayant comme sens d'écriture de droite à gauche.
- insertButton : Insère devient le texte d'un bouton.
- insertFieldset : insère les balises <fielset>
- insertIFrame : insère une frame
- insertHorizontalRule : insère une ligne horizontale.
- insertHTML : insère du code HTML. Attend comme paramètre du code HTML. Ne fonctionne plus sur Internet Explorer 11.
- insertImage : insère une image. Attend comme paramètre l'adresse de l'image
- insertInputButton : Insère un Input ayant comme type un bouton
- insertInputCheckbox : Insère un Input ayant comme type une case à cocher
- insertInputFileUpload : Insère un Input ayant comme type un champ pour télécharger
- insertInputHidden : Insère un Input ayant comme type un champ caché
- insertInputPassword : Insère un Input ayant comme type un champ de mot de passe
- insertInputRadio : Insère un Input ayant comme type un bouton "radio"
- insertInputReset : Insère un Input ayant comme type un bouton effacer.
- insertInputSubmit : Insère un Input ayant comme type un bouton envoyer.
- insertInputText : Insère un Input ayant comme type un champ de saisie.
- insertMarquee : insère la balise <marquee>
- insertOrderedList : transforme la ligne où la souris en une liste ordonnée (numéros) ou le contraire.
- insertParagraph : insère un paragraphe.
- insertSelectDropdown : insère la balise <select>
- insertSelectListbox : insère une balise <select> à choix multiple
- insertTextArea : insère la balise <textarea>
- insertUnorderedList : transforme la ligne où la souris en une liste désordonnée ou le contraire.
- italic : mets le texte en italique ou le contraire.
- justifyCenter : rends la ligne centrée
- justifyFull : rends la ligne justifié. Non supporté.
- justifyLeft : rends la ligne alignée à gauche.
- justifyNone : enlève l'alignement
- justifyRight : rends la ligne alignée à droite.
- liveResize : Demande comme argument une valeur booléenne. Si la valeur est true, lorsque l'utilisateur redimmensionnera un élément sur IE, l'élément sera redimmensionné durant le mouvement de souris. Si la valeur est false, l'élément ne sera redimensionné que lorsque l'utilisateur relâchera le bouton de la souris. Internet Explorer seulement.
- multipleSelection : Attend comme argument une valeur booléenne. Si la valeur est true, la sélection multiple sera permise à l'aide des touches CTRL et SHIFT. Si la valeur est false, la sélection multiple sera interdite.
- open : inconnu
- outdent : ôte une indentation.
- overWrite : Attend comme argument une valeur booléenne. Si la valeur est true, le texte insérer remplacera la sélection. Si la valeur est false, le texte sera insérer.
- paste : colle le contenu du presse-papier.
- playImage : Inconnu
- print : permet d'imprimer la page. (Non supporté. Préférez window.print )
- redo : refait la dernière opération effacé.
- refresh : recharge le document. (Non supporté. Préférez window.reload)
- removeFormat : ôte les balises de format de la sélection.
- removeParaFormat : Inconnu
- saveAs : Permet de sauvegarder la page
- selectAll : Sélectionne le document.
- sizeToControl : inconnu
- sizeToControlHeight : inconnu
- sizeToControlWidth : inconnu
- stop : inconnu
- stopImage : inconnu
- strikeThrough : rend le texte sélectionné barré ou le contraire s'il l'est déjà.
- styleWithCSS : Attend comme argument une valeur booléenne. Si la valeur est true, s'il est possible, les prochaines utilisations d'execCommand utiliseront les styles CSS. Par exemple, pour italic, la balise utilisée sera <span style="font-style: italic";>. Si la valeur est false, s'il est possible, les prochaines utilisations d'execCommand utiliseront les balises HTML. Par exemple, pour italic, la balise utilisée sera <i>.
- subscript : rend le texte sélectionné en indice ou le contraire s'il l'est déjà
- superscript : rend le texte sélectionné en exposant ou le contraire s'il l'est déjà
- unBookmark : ôte les ancres de la sélection.
- underline : rend le texte sélectionné souligné ou le contraire s'il l'est déjà.
- undo : ôte la dernière modification du document.
- unlink : supprime les liens de la sélection.
- unselect : Déselectionne le document
- useCSS : Déprécié. Attend comme argument une valeur booléenne. Si la valeur est false, les CSS seront utilisé. Si la valeur est true, les balises HTML seront utilisés. Préféré styleWithCSS.
Notes[]
Cette liste contient la liste complètes des valeurs possible pour execCommand. Par contre, ceux-ci ne sont pas toujours compatible avec tous les navigateurs ou ne sont pas supportés complétement. Les résultats et le code généré dépend de chaque navigateur. Avant de les utiliser, vérifier leur compatibilité (voir lien ci-bas)...
Exemple[]
<html>
<body>
<button onclick="document.execCommand('createLink',false,'javascript:')">Liens (exemple avec argument)</button>
<button onclick="document.execCommand('bold',false,'')">Gras</button><br>
<div contentEditable=true style='border:1px solid black'>Insérer du texte ici</div>
</body>
</html>