Document.execCommand()

Sintaxis

execCommand(aCommandName, aShowDefaultUI, aValueArgument);

Parmetros

aCommandName

Una String que especifica el nombre del comando a ejecutar. Vea Comandos para una lista de posibles comandos.

aShowDefaultUI

Un Boolean que indica si la interfaz de usuario por defecto se debe mostrar. Esto no se ha implementado en Mozilla.

aValueArgument

Una String representando algunos comandos (como insertImage) requiere un argumento valor extra (url de la imagen). Pasar un argumento de null si no se necesita ningn argumento.

Comandos

backColor

Cambia el color de fondo del documento. En el modo styleWithCss, afecta el color de fondo del bloque que contiene. Esto requiere una cadena con el valor del color de fondo que se pasa como un valor de argumento. (Internet Explorer utiliza esta opcin para definir el color de fondo del texto.)

bold

Pone las negritas o las quita para la seleccin o en el punto de insercin. (Internet Explorer utiliza la etiqueta STRONG en lugar de B.)

contentReadOnly

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

copy

Copia la seleccin actual en el portapapeles. Capacidad del Portapapeles debe estar habilitado en el archivo de preferencias user.js. Vea

createLink

Crea un vnculo de anclaje a partir de la seleccin, slo si hay una seleccin. Esto requiere la cadena HREF URI que se pasa como un argumento de valor. El URI debe contener al menos un solo carcter, el cual puede ser un espacio en blanco. (Internet Explorer crear un enlace con un nulo valor URI.)

cut

Corta la seleccin y lo copia en el portapapeles actual. Capacidad del Portapapeles debe estar habilitado en el archivo de preferencias user.js. Vea

decreaseFontSize

Aade una etiqueta SMALL alrededor de la seleccin o en el punto de insercin. (No es compatible con Internet Explorer.)

delete

Elimina la seleccin actual.

enableInlineTableEditing

Activa o desactiva la fila de la tabla y los controles de insercin y supresin de columna. (No es compatible con Internet Explorer.)

enableObjectResizing

Activa o desactiva los controladores de tamao en imgenes y otros objetos de tamao variable. (No es compatible con Internet Explorer.)

fontName

Cambia el nombre de la fuente para la seleccin o en el punto de insercin. Esto requiere una cadena de nombre de la fuente ("Arial", por ejemplo) que se pasa como un valor de argumento.

fontSize

Cambia el tamao de fuente para la seleccin o en el punto de insercin. Esto requiere un tamao de fuente HTML (1-7) que se pasa como un valor de argumento.

foreColor

Cambia un color de fuente para la seleccin o en el punto de insercin. Esto requiere una cadena de valor de color que se pasa como un valor de argumento.

formatBlock

Aade una etiqueta HTML de estilo bloque alrededor de la lnea que contiene la seleccin actual, reemplazando el elemento de bloque que contiene la lnea si existe (en Firefox, BLOCKQUOTE es la excepcin - que envolver cualquier elemento de bloque que contiene). Requiere una cadena de etiqueta-nombre que se pasa como un argumento de valor. Prcticamente todas las etiquetas de estilo bloque se pueden utilizar (por ejemplo. "H1", "P", "DL", "BLOCKQUOTE"). (Internet Explorer slo admite etiquetas de ttulo H1 - H6, direccin y PRE, que tambin debe incluir los delimitadores de etiquetas <>, como "<H1>".)

forwardDelete

Elimina el character delante de la posicin del cursor cursor. Es lo mismo que pulsar la tecla suprimir.

heading

Aade una etiqueta de encabezado en torno a una seleccin, o la lnea en el punto de insercin. Requiere la cadena de nombre de etiqueta que se pasa como un valor de argumento (es decir, "H1", "H6"). (No es compatible con Internet Explorer y Safari.)

hiliteColor

Cambia el color de fondo para la seleccin o el punto de insercin. Requiere una cadena de valores de color que se pasa como un valor de argumento. UseCSS debe estar encendido para que esto funcione. (No es compatible con Internet Explorer.)

increaseFontSize

Aade una etiqueta BIG alrededor de la seleccin o en el punto de insercin. (No es compatible con Internet Explorer.)

indent

Indenta la lnea que contiene el punto de seleccin o insercin. En Firefox, si la seleccin abarca varias lneas en los diferentes niveles de indentacin sern indentadas slo las lneas menos indentadas en la seleccin.

insertBrOnReturn

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

insertHorizontalRule

Inserta una regla horizontal en el punto de insercin (borra la seleccin).

insertHTML

Inserta una cadena HTML en el punto de insercin (borra la seleccin). Requiere una cadena HTML vlido que se ha pasado como un valor de argumento. (No es compatible con Internet Explorer.)

insertImage

Inserta una imagen en el punto de insercin (borra la seleccin). Requiere la cadena de imagen SRC URI que se pasa como un argumento de valor. El URI debe contener al menos un solo carcter, que puede ser un espacio en blanco. (Internet Explorer crear un enlace con un nulo valor URI.)

insertOrderedList

Crea una lista ordenada con nmeros para la seleccin o en el punto de insercin.

insertUnorderedList

Crea una lista desordenada con vietas para la seleccin o en el punto de insercin.

insertParagraph

Inserta un prrafo en torno a la seleccin o la lnea actual. (Internet Explorer inserta un prrafo en el punto de insercin y elimina la seleccin.)

insertText

Inserta el texto plano expedido en el punto de insercin (borra la seleccin).

italic

Alterna cursiva para la seleccin o el punto de insercin. (Internet Explorer utiliza la etiqueta de EM en lugar de I.)

justifyCenter

Centra el punto de seleccin o insercin.

justifyFull

Justifica el punto de seleccin o insercin.

justifyLeft

Justifica la seleccin o insercin punto a la izquierda.

justifyRight

Justifica la seleccin o el punto de insercin a la derecha.

outdent

Anula la sangra de la lnea que contiene la seleccin o el punto de insercin.

paste

Pega el contenido del portapapeles en el punto de insercin (reemplaza la seleccin actual). Capacidad del Portapapeles debe estar habilitado en el archivo de preferencias user.js. Ver

redo

Rehace el anterior comando deshecho.

removeFormat

Quita todo el formato de la seleccin actual.

selectAll

Selecciona todo el contenido de la regin editable.

strikeThrough

Alterna tachado para la seleccin o el punto de insercin.

subscript

Alterna subndice para la seleccin o el punto de insercin.

superscript

Alterna exponente para la seleccin o el punto de insercin.

underline

Alterna subrayado para la seleccin o el punto de insercin.

undo

Deshace el ltimo comando ejecutado.

unlink

Elimina la etiqueta de ancla de un enlace ancla seleccionado.

useCSS

Alterna el uso de etiquetas HTML o CSS para el marcado generado. Requiere un booleano verdadero / falso como valor del argumento. NOTA: Este argumento es lgicamente hacia atrs (es decir, si se usa falso a usar CSS, entonces es verdadero a usar HTML). (No compatible con Internet Explorer.) Esto ha quedado obsoleto; utilice el comando styleWithCSS en su lugar.

styleWithCSS

Reemplaza el comando useCSS; el argumento funciona como se esperaba, es decir, si es verdadero modifica / genera atributos de estilo en el marcado, falso genera elementos de formato.

Ejemplo

(Este artculo est actualmente incompleto y carece de un ejemplo.)

Especificaciones

Compatibilidad del Navegador

Vea tambin

• document.contentEditable
• document.designMode
• Edicin de texto enriquecido en Mozilla