Esta función ya no se recomienda. Aunque es posible que algunos navegadores aún lo admitan, es posible que ya se haya eliminado de los estándares web relevantes, que esté en proceso de ser eliminado o que solo se conserve por motivos de compatibilidad. Evite su uso y actualice el código existente si es posible; consulte la tabla de compatibilidad al final de esta página para guiar su decisión. Tenga en cuenta que esta función puede dejar de funcionar en cualquier momento.

Cuando un documento HTML se ha cambiado a designMode, su document objeto expone un execCommand método para ejecutar comandos que manipulen la región editable actual, como entradas de formulario o contentEditable elementos.

La mayoría de los comandos afectan la selección del documento (negrita, cursiva, etc.), mientras que otros insertan nuevos elementos (agregan un enlace) o afectan una línea completa (sangría). Cuando usas contentEditable, execCommand() afecta al elemento editable actualmente activo.

Sintaxis

document.execCommand(aCommandName, aShowDefaultUI, aValueArgument)

Valor devuelto

A Boolean es decir false si el comando no es compatible o está desactivado.

Nota: document.execCommand() solo devoluciones true si se invoca como parte de la interacción del usuario. No puede usarlo para verificar la compatibilidad del navegador antes de llamar a un comando. Desde Firefox 82, anidado document.execCommand() las llamadas siempre volverán false.

Parámetros

aCommandName

A DOMString especificando el nombre del comando a ejecutar. Consulte Comandos para obtener una lista de posibles comandos.

aShowDefaultUI

A Boolean indicando si se debe mostrar la interfaz de usuario predeterminada. Esto no está implementado en Mozilla.

aValueArgument

Para los comandos que requieren un argumento de entrada, es un DOMString proporcionar esa información. Por ejemplo, insertImage requiere la URL de la imagen para insertar. Especificar null si no se necesita ningún argumento.

Comandos

backColor

Cambia el color de fondo del documento. En styleWithCss modo, afecta el color de fondo del bloque contenedor. Esto requiere un cadena de valor que se pasará como argumento de valor. Tenga en cuenta que Internet Explorer utiliza esto para establecer el color de fondo del texto.

bold

Activa o desactiva la negrita para la selección o en el punto de inserción. Internet Explorer usa el etiqueta en lugar de .

ClearAuthenticationCache

Borra todas las credenciales de autenticación de la caché.

contentReadOnly

Hace que el documento de contenido sea de solo lectura o editable. Esto requiere un valor booleano verdadero / falso como argumento de valor. (No es compatible con Internet Explorer).

copy

Copia la selección actual al portapapeles. Las condiciones para tener este comportamiento habilitado varían de un navegador a otro y han evolucionado con el tiempo. Consulte la tabla de compatibilidad para determinar si puede usarlo en su caso.

createLink

Crea un hipervínculo a partir de la selección, pero solo si hay una selección. Requiere un URI cadena como un argumento de valor para el hipervínculo href. El URI debe contener al menos un solo carácter, que puede ser un espacio en blanco. (Internet Explorer creará un enlace con un null valor.)

cut

Elimina la selección actual y la copia al portapapeles. Cuando este comportamiento está habilitado varía entre los navegadores y sus condiciones han evolucionado con el tiempo. Consulte la tabla de compatibilidad para conocer los detalles de uso.

decreaseFontSize

Agrega un etiqueta alrededor de la selección o en el punto de inserción. (No es compatible con Internet Explorer).

defaultParagraphSeparator

Cambia el separador de párrafos que se utiliza cuando se crean nuevos párrafos en regiones de texto editables. Ver Diferencias en la generación de marcas para más detalles.

delete

Elimina la selección actual.

enableAbsolutePositionEditor

Habilita o deshabilita el sujetador que permite mover elementos absolutamente posicionados. El capturador está deshabilitado de forma predeterminada desde Firefox 64 (error 1490641).

enableInlineTableEditing

Habilita o deshabilita los controles de inserción y eliminación de filas / columnas de la tabla. Los controles están deshabilitados por defecto desde Firefox 64 (error 1490641).

enableObjectResizing

Habilita o deshabilita los controladores de cambio de tamaño en imágenes, tablas y elementos absolutamente posicionados y otros objetos de tamaño variable. Los identificadores están deshabilitados de forma predeterminada desde Firefox 64 (error 1490641).

fontName

Cambia el nombre de la fuente para la selección o en el punto de inserción. Esto requiere una cadena de nombre de fuente (como "Arial") como argumento de valor.

fontSize

Cambia el tamaño de fuente para la selección o en el punto de inserción. Esto requiere un número entero de 1–7 como argumento de valor.

foreColor

Cambia un color de fuente para la selección o en el punto de inserción. Esto requiere una cadena de valor de color hexadecimal como argumento de valor.

formatBlock

Agrega un elemento HTML a nivel de bloque alrededor de la línea que contiene la selección actual, reemplazando el elemento de bloque que contiene la línea si existe (en Firefox,

es la excepción: envolverá cualquier elemento de bloque que lo contenga). Requiere una cadena de nombre de etiqueta como argumento de valor. Se pueden utilizar prácticamente todos los elementos a nivel de bloque. (Internet Explorer y Edge solo admiten etiquetas de encabezado H1–H6, ADDRESS, y PRE, que debe estar envuelto entre paréntesis angulares, como "

".)

forwardDelete

Elimina el carácter delante del cursorposición, idéntica a presionar la tecla Suprimir en un teclado de Windows.

heading

Agrega un elemento de título alrededor de una línea de selección o punto de inserción. Requiere la cadena de nombre de etiqueta como argumento de valor (es decir, "H1", "H6"). (No es compatible con Internet Explorer y Safari).

hiliteColor

Cambia el color de fondo de la selección o en el punto de inserción. Requiere una cadena de valor de color como argumento de valor. useCSS debe ser true para que esto funcione. (No es compatible con Internet Explorer).

increaseFontSize

Agrega un etiqueta alrededor de la selección o en el punto de inserción. (No es compatible con Internet Explorer).

indent

Sangra la línea que contiene la selección o el punto de inserción. En Firefox, si la selección abarca varias líneas en diferentes niveles de sangría, solo se sangrarán las líneas menos sangradas de la selección.

insertBrOnReturn

Controla si la tecla Intro inserta un
elemento, o divide el elemento de bloque actual en dos. (No es compatible con Internet Explorer).

insertHorizontalRule

Inserta un

---

elemento en el punto de inserción, o reemplaza la selección con él.

insertHTML

Inserta una cadena HTML en el punto de inserción (elimina la selección). Requiere una cadena HTML válida como argumento de valor. (No es compatible con Internet Explorer).

insertImage

Inserta una imagen en el punto de inserción (elimina la selección). Requiere una cadena de URL para la imagen src como argumento de valor. Los requisitos para esta cadena son los mismos que createLink.

insertOrderedList

Crea un lista ordenada numerada para la selección o en el punto de inserción.

insertUnorderedList

Crea un lista desordenada con viñetas para la selección o en el punto de inserción.

insertParagraph

Inserta un párrafo alrededor de la selección o la línea actual. (Internet Explorer inserta un párrafo en el punto de inserción y elimina la selección).

insertText

Inserta el texto sin formato proporcionado en el punto de inserción (elimina la selección).

italic

Activa o desactiva la cursiva para la selección o en el punto de inserción. (Internet Explorer usa el elemento en lugar de .)

justifyCenter

Centra el punto de selección o inserción.

justifyFull

Justifica la selección o el punto de inserción.

justifyLeft

Justifica la selección o el punto de inserción a la izquierda.

justifyRight

Justifica a la derecha la selección o el punto de inserción.

outdent

Supera la línea que contiene la selección o el punto de inserción.

paste

Pega el contenido del portapapeles en el punto de inserción (reemplaza la selección actual). Deshabilitado para contenido web.

redo

Rehace el comando deshacer anterior.

removeFormat

Elimina todo el formato de la selección actual.

selectAll

Selecciona todo el contenido de la región editable.

strikeThrough

Activa o desactiva el tachado para la selección o en el punto de inserción.

subscript

Alterna subíndice on / off para la selección o en el punto de inserción.

superscript

Alterna sobrescrito on / off para la selección o en el punto de inserción.

underline

Alterna subrayar on / off para la selección o en el punto de inserción.

undo

Deshace el último comando ejecutado.

unlink

Elimina el elemento de anclaje desde un hipervínculo seleccionado.

useCSS Esta API obsoleta ya no debería usarse, pero probablemente seguirá funcionando.

Alterna el uso de etiquetas HTML o CSS para el marcado generado. Requiere un valor booleano verdadero / falso como argumento de valor.

NOTA: Este argumento es lógicamente al revés (es decir, use false para usar CSS, true para usar HTML) y no es compatible con Internet Explorer. Esto se ha desaprobado a favor de styleWithCSS.

styleWithCSS

Reemplaza el useCSS mando. true modifica / genera style atributos en el marcado, falso genera elementos de presentación.