Funciones de edición generales

Puede acceder a las funciones de edición generales en la ventana del documento. Con ellas, podrá insertar texto, HTML y objetos; aplicar, cambiar y quitar el formato de fuente y carácter; modificar etiquetas y atributos; y mucho más.

Disponibilidad

Dreamweaver 3.

Descripción

Se aplica a la selección el tipo de formato de carácter especificado. Si la selección es un punto de inserción, se aplica el formato de carácter especificado a cualquier texto escrito posteriormente.

Argumentos

tagName

• El argumento tagName es el nombre de la etiqueta asociada al formato de carácter. Debe ser una de las siguientes cadenas: “b”, “cite”, “code”, “dfn”, “em”, “i”, “kbd”, “samp”, “s”, “strong”, “tt”, “u” o “var”.

Valor devuelto

Ninguno.

dom.applyFontMarkup()

Disponibilidad

Dreamweaver 3.

Descripción

Se aplica a la selección actual la etiqueta FONT, así como el atributo y valor especificados.

Argumentos

attribute, value

• El argumento attribute debe ser “face”, “size” o “color”.

• El argumento value es el valor que se asignará al atributo, por ejemplo, “Arial, Helvetica, sans-serif”, “5” o “#FF0000”.

Valor devuelto

Ninguno.

dom.deleteSelection()

Disponibilidad

Dreamweaver 3.

Descripción

Se elimina la selección del documento.

Argumentos

Ninguno.

Valor devuelto

Ninguno.

dom.editAttribute()

Disponibilidad

Dreamweaver 3.

Descripción

Se muestra la interfaz adecuada para editar el atributo especificado del documento. En la mayoría de los casos, dicha interfaz es un cuadro de diálogo. Esta función solo es válida en el documento activo.

Argumentos

attribute

• attribute es una cadena que especifica el atributo de etiqueta que va a editar.

Valor devuelto

Ninguno.

dom.exitBlock()

Disponibilidad

Dreamweaver 3.

Descripción

Se sale del párrafo o bloque de encabezado actual y se deja el punto de inserción fuera de todos los elementos del bloque.

Argumentos

Ninguno.

Valor devuelto

Ninguno.

dom.getCharSet()

Disponibilidad

Dreamweaver 4.

Descripción

Se obtiene el atributo charset de la metaetiqueta del documento.

Argumentos

Ninguno.

Valor devuelto

La identidad de codificación del documento. Por ejemplo, para un documento Latin1, la función devuelve iso-8859-1.

dom.getFontMarkup()

Disponibilidad

Dreamweaver 3.

Descripción

Se obtiene el valor del atributo especificado de la etiqueta FONT para la selección actual.

Argumentos

attribute

• El argumento attribute debe ser “face”, “size” o “color”.

Valor devuelto

Una cadena que contiene el valor del atributo especificado o una cadena vacía si el atributo no está definido.

dom.getLineFromOffset()

Disponibilidad

Dreamweaver MX.

Descripción

Se detecta el número de línea de un desplazamiento de caracteres específico en el texto (el código HTML o JavaScript) del archivo.

Argumentos

offset

• El argumento offset es un entero que representa la ubicación de los caracteres desde el principio del archivo.

Valor devuelto

Entero que representa el número de línea del documento.

dom.getLinkHref()

Disponibilidad

Dreamweaver 3.

Descripción

Se obtiene el vínculo que rodea a la selección actual. Esta función equivale a ejecutar un bucle en los elementos principales y secundarios del nodo actual hasta que se encuentra un vínculo y, a continuación, llamar a la función getAttribute('HREF') del vínculo.

Argumentos

Ninguno.

Valor devuelto

Una cadena que contiene el nombre del archivo vinculado expresado como una URL file://.

dom.getLinkTarget()

Disponibilidad

Dreamweaver 3.

Descripción

Se obtiene el destino del vínculo que rodea a la selección actual. Esta función equivale a ejecutar un bucle en los elementos principales y secundarios del nodo actual hasta que se encuentra un vínculo y, a continuación, llamar a la función getAttribute('TARGET')del vínculo.

Argumentos

Ninguno.

Valor devuelto

Una cadena que contiene el valor del atributo TARGET para el vínculo o una cadena vacía si no se especifica ningún destino.

dom.getListTag()

Disponibilidad

Dreamweaver 3.

Descripción

Se obtiene el estilo de la lista seleccionada.

Argumentos

Ninguno.

Valor devuelto

Una cadena que contiene la etiqueta asociada a la lista (“ul”, “ol” o “dl”) o una cadena vacía si no se asocia ninguna etiqueta a la lista. Este valor siempre se devuelve en minúscula.

dom.getTextAlignment()

Disponibilidad

Dreamweaver 3.

Descripción

Se obtiene la alineación del bloque que contiene la selección.

Argumentos

Ninguno.

Valor devuelto

Una cadena que contiene el valor del atributo ALIGN para la etiqueta asociada al bloque o una cadena vacía si el atributo ALIGN no se ha establecido para la etiqueta. Este valor siempre se devuelve en minúscula.

dom.getTextFormat()

Disponibilidad

Dreamweaver 3.

Descripción

Se obtiene el formato de bloque del texto seleccionado.

Argumentos

Ninguno.

Valor devuelto

Una cadena que contiene la etiqueta de bloque asociada al texto (por ejemplo, “p”, “h1”, “pre”, etc.) o una cadena vacía si no se asocia ninguna etiqueta de bloque a la selección. Este valor siempre se devuelve en minúscula.

dom.hasCharacterMarkup()

Disponibilidad

Dreamweaver 3.

Descripción

Se comprueba si la selección ya contiene el formato de carácter especificado.

Argumentos

markupTagName

• El argumento markupTagName es el nombre de la etiqueta que está comprobando. Debe ser una de las siguientes cadenas: “b”, “cite”, “code”, “dfn”, “em”, “i”, “kbd”, “samp”, “s”, “strong”, “tt”, “u” o “var”.

Valor devuelto

Un valor booleano que indica si toda la selección tiene el formato de carácter especificado. La función devuelve el valor false si solo una parte de la selección contiene el formato especificado.

dom.indent()

Disponibilidad

Dreamweaver 3.

Descripción

Se aplica sangría a la selección mediante etiquetas BLOCKQUOTE. Si la selección es un elemento de lista, la función aplica sangría y convierte el elemento seleccionado en una lista anidada. Esta lista anidada es del mismo tipo que la lista principal y contiene un elemento: la selección original.

Argumentos

Ninguno.

Valor devuelto

Ninguno.

dom.insertHTML()

Disponibilidad

Dreamweaver 3.

Descripción

Se inserta contenido HTML en el documento en el punto de inserción actual.

Argumentos

contentToInsert, {bReplaceCurrentSelection}

• El argumento contentToInsert es el contenido que desea insertar.

• El argumento bReplaceCurrentSelection, que es opcional, es un valor booleano que indica si el contenido debe sustituir a la selección actual. Si el argumento bReplaceCurrentSelection tiene el valor true, el contenido reemplaza la selección actual. Si el valor es false, el contenido se inserta después de la selección actual.

Valor devuelto

Ninguno.

Ejemplo

El siguiente código inserta la cadena HTML <b>130</b> en el documento actual:

El resultado aparece en la ventana del documento.

dom.insertObject()

Disponibilidad

Dreamweaver 3.

Descripción

Se inserta el objeto especificado y se le solicitan los parámetros al usuario si es preciso.

Argumentos

objectName

• El argumento objectName es el nombre de un objeto de la carpeta de configuración o de objetos.

Valor devuelto

Ninguno.

Ejemplo

Con una llamada a la función dom.insertObject('Button'), se inserta un botón de formulario en el documento activo después de la selección actual. Si no se selecciona nada, esta función inserta el botón en el punto de inserción actual.

dom.insertText()

Disponibilidad

Dreamweaver 3.

Descripción

Se inserta contenido de texto en el documento en el punto de inserción actual.

Argumentos

contentToInsert, {bReplaceCurrentSelection}

• El argumento contentToInsert es el contenido que desea insertar.

• El argumento bReplaceCurrentSelection, que es opcional, es un valor booleano que indica si el contenido debe sustituir a la selección actual. Si el argumento bReplaceCurrentSelection tiene el valor true, el contenido reemplaza la selección actual. Si el valor es false, el contenido se inserta después de la selección actual.

Valor devuelto

Ninguno.

Ejemplo

El siguiente código inserta el texto &lt;b&gt;130&lt;/b&gt; en el documento actual:

Los resultados aparecen en la ventana del documento.

dom.newBlock()

Disponibilidad

Dreamweaver 3.

Descripción

Se crea un nuevo bloque con la misma etiqueta y los mismos atributos del bloque que contiene la selección actual, o se crea un nuevo párrafo si el puntero se encuentra fuera de todos los bloques.

Argumentos

Ninguno.

Valor devuelto

Ninguno.

Ejemplo

Si la selección actual está dentro de un párrafo centrado, con la llamada a la función dom.newBlock() se inserta <p align="center"> después del párrafo actual.

dom.notifyFlashObjectChanged()

Disponibilidad

Dreamweaver 4.

Descripción

Se indica a Dreamweaver que el archivo de objeto Flash actual ha cambiado. Dreamweaver actualiza la vista previa, cambia el tamaño como sea necesario y conserva la proporción de altura y anchura del tamaño original.

Argumentos

Ninguno.

Valor devuelto

Ninguno.

dom.outdent()

Disponibilidad

Dreamweaver 3.

Descripción

Se elimina la sangría de la selección.

Argumentos

Ninguno.

Valor devuelto

Ninguno.

dom.removeCharacterMarkup()

Disponibilidad

Dreamweaver 3.

Descripción

Se elimina de la selección el tipo de formato de carácter especificado.

Argumentos

tagName

• El argumento tagName es el nombre de la etiqueta asociada al formato de carácter. Debe ser una de las siguientes cadenas: “b”, “cite”, “code”, “dfn”, “em”, “i”, “kbd”, “samp”, “s”, “strong”, “tt”, “u” o “var”.

Valor devuelto

Ninguno.

dom.removeFontMarkup()

Disponibilidad

Dreamweaver 3.

Descripción

Se elimina de la etiqueta FONT el atributo especificado y su valor. Si con ello se queda solamente la etiqueta FONT, también se elimina la etiqueta FONT.

Argumentos

attribute

• El argumento attribute debe ser “face”, “size” o “color”.

Valor devuelto

Ninguno.

dom.resizeSelection()

Disponibilidad

Dreamweaver 3.

Descripción

Cambia el tamaño del objeto seleccionado de acuerdo con las dimensiones especificadas.

Argumentos

newWidth, newHeight

• El argumento newWidth especifica la nueva anchura a la que la función establecerá el objeto seleccionado.

• El argumento newHeight especifica la nueva altura a la que la función establecerá el objeto seleccionado.

Valor devuelto

Ninguno.

dom.setAttributeWithErrorChecking()

Disponibilidad

Dreamweaver 3.

Descripción

Se define el atributo especificado con el valor especificado para la selección actual y se le pregunta al usuario si el valor es del tipo incorrecto o si está fuera de rango. Esta función solo es válida en el documento activo.

Argumentos

attribute, value

• El argumento attribute especifica los atributos que hay que definir para la selección actual.

• El argumento value especifica el valor que hay que definir para el atributo.

Valor devuelto

Ninguno.

dom.setLinkHref()

Disponibilidad

Dreamweaver 3.

Descripción

La selección se convierte en un vínculo de hipertexto o se cambia el valor URL de la etiqueta HREF que contiene la selección actual.

Argumentos

linkHREF

• El argumento linkHREF es la URL (ruta relativa al documento, ruta relativa a la raíz o URL absoluta) de la que se compone el vínculo. Si se omite este argumento, aparece el cuadro de diálogo Seleccionar archivo HTML.

Valor devuelto

Ninguno.

Activación

Consulte dom.canSetLinkHref().

dom.setLinkTarget()

Disponibilidad

Dreamweaver 3.

Descripción

Se define el destino del vínculo que rodea la selección actual. Esta función equivale a ejecutar un bucle en los elementos principales y secundarios del nodo actual hasta que se encuentra un vínculo y, a continuación, llamar a la función setAttribute('TARGET') del vínculo.

Argumentos

{linkTarget}

• El argumento linkTarget, que es opcional, es una cadena que representa el nombre de marco, el nombre de la ventana o uno de los destinos reservados (“_self”, “_parent”, “_top” o “_blank”). Si se omite el argumento, aparece el cuadro de diálogo Establecer destino.

Valor devuelto

Ninguno.

dom.setListBoxKind()

Disponibilidad

Dreamweaver 3.

Descripción

Se cambia el tipo del menú SELECT seleccionado.

Argumentos

kind

• El argumento kind debe ser “menu” o “cuadro de lista”.

Valor devuelto

Ninguno.

dom.showListPropertiesDialog()

Disponibilidad

Dreamweaver 3.

Descripción

Se abre el cuadro de diálogo Propiedades de lista.

Argumentos

Ninguno.

Valor devuelto

Ninguno.

Activación

Consulte dom.canShowListPropertiesDialog().

dom.setListTag()

Disponibilidad

Dreamweaver 3.

Descripción

Se define el estilo de la lista seleccionada.

Argumentos

listTag

• El argumento listTag es la etiqueta asociada a la lista. Debe ser “ol”, “ul”, “dl” o una cadena vacía.

Valor devuelto

Ninguno.

dom.setTextAlignment()

Disponibilidad

Dreamweaver 3.

Descripción

Se asigna el valor especificado al atributo ALIGN del bloque que contiene la selección.

Argumentos

alignValue

• El argumento alignValue debe ser “left”, “center” o “right”.

Valor devuelto

Ninguno.

dom.setTextFieldKind()

Disponibilidad

Dreamweaver 3 (en desuso desde Dreamweaver CS5.5).

Descripción

Se define el formato del campo de texto seleccionado.

Argumentos

fieldType

• El argumento fieldType debe ser “input”, “textarea” o “password”.

Valor devuelto

Ninguno.

dom.setTextFormat()

Disponibilidad

Dreamweaver 4.

Descripción

Se define el formato de bloque del texto seleccionado.

Argumentos

blockFormat

• El argumento blockFormat es una cadena que especifica uno de los siguientes formatos: “” (sin formato), “p”, “h1”, “h2”, “h3”, “h4”, “h5”, “h6” o “pre”.

Valor devuelto

Ninguno.

dom.showFontColorDialog()

Disponibilidad

Dreamweaver 3.

Descripción

Se abre el cuadro de diálogo Selector de color.

Argumentos

Ninguno.

Valor devuelto

Ninguno.

dreamweaver.deleteSelection()

Disponibilidad

Dreamweaver 3.

Descripción

Se elimina la selección del documento activo o del panel Sitio; en Macintosh, se elimina el cuadro de texto seleccionado en un cuadro de diálogo o un panel flotante.

Argumentos

Ninguno.

Valor devuelto

Ninguno.

Activación

Consulte dreamweaver.canDeleteSelection().

dreamweaver.editFontList()

Disponibilidad

Dreamweaver 3.

Descripción

Se abre el cuadro de diálogo Editar lista de fuentes.

Argumentos

Ninguno.

Valor devuelto

Ninguno.

dreamweaver.getFontList()

Disponibilidad

Dreamweaver 3.

Descripción

Se obtiene una lista de todos los grupos de fuentes que aparecen en el inspector de propiedades de texto y en el cuadro de diálogo Definición de estilo.

Argumentos

Ninguno.

Valor devuelto

Una matriz de cadenas que representa cada elemento de la lista de fuentes.

Ejemplo

En la instalación predeterminada de Dreamweaver, si se llama a la función dreamweaver.getFontList(), se obtiene una matriz que contiene los siguientes elementos:

• “Arial, Helvetica, sans-serif”

• “Times New Roman, Times, serif”

• “Courier New, Courier, mono”

• “Georgia, Times New Roman, Times, serif”

• “Verdana, Arial, Helvetica, sans-serif”

dreamweaver.getFontStyles()

Disponibilidad

Dreamweaver 4.

Descripción

Se obtienen los estilos que admite la fuente TrueType especificada.

Argumentos

fontName

• El argumento fontName es una cadena que contiene el nombre de la fuente.

Valor devuelto

Una matriz de tres valores booleanos que indica qué admite la fuente. El primer valor indica si la fuente admite negrita; el segundo, cursiva; y el tercero, tanto negrita como cursiva.

dreamweaver.getKeyState()

Disponibilidad

Dreamweaver 3.

Descripción

Se determina si la tecla modificadora especificada está presionada.

Argumentos

key

• El argumento key debe tener uno de los siguientes valores: “Cmd”, “Ctrl”, “Alt” o “Shift”. En Windows, “Cmd” y “Ctrl” se refieren a la tecla Control; en Macintosh, “Alt” hace referencia a la tecla Opción.

Valor devuelto

Un valor booleano que indica si la tecla está presionada.

Ejemplo

Con el siguiente código se comprueba que las teclas Mayús y Control (en Windows) o Mayús y Comando (en Macintosh) están presionadas antes de una operación:

dreamweaver.getNaturalSize()

Disponibilidad

Dreamweaver 4.

Descripción

Se obtiene la altura y la anchura de un objeto gráfico.

Argumentos

url

• El argumento url remite a un objeto gráfico cuyas dimensiones se desean obtener. Dreamweaver debe admitir este objeto (GIF, JPEG, PNG, Flash y Shockwave). La URL que se proporciona como argumento para la función getNaturalSize() debe ser una URL absoluta que remita a un archivo local; no puede ser una URL relativa.

Valor devuelto

Una matriz de dos enteros: el primero define la anchura del objeto y el segundo, la altura.

dreamweaver.getSystemFontList()

Disponibilidad

Dreamweaver 4.

Descripción

Se obtiene la lista de fuentes del sistema, que pueden ser todas ellas o solo las fuentes TrueType.

Argumentos

fontTypes

• El argumento fontTypes es una cadena que contiene los valores all o TrueType.

Valor devuelto

Una matriz de cadenas que contiene todos los nombres de fuente; devuelve el valor null si no se encuentra ninguna fuente.

dreamweaver.getSystemFontName()

Disponibilidad

Dreamweaver CS5.

Descripción

Se obtiene el nombre de las fuentes del sistema.

Argumentos

Ninguno.

Valor devuelto

Una cadena que contiene el nombre de las fuentes del sistema.