Puede utilizar los editores de etiquetas para insertar etiquetas nuevas, editar las existentes y acceder a información de referencia sobre ellas. La opción Selector de etiquetas permite a los usuarios organizar las etiquetas para seleccionar fácilmente las que utilizan con más frecuencia. Las bibliotecas de etiquetas integradas en Dreamweaver almacenan información sobre las que se utilizan en lenguajes de formato basados en estándares y en los lenguajes de scripts basados en etiquetas más comunes. Puede utilizar las funciones Selector de etiquetas, Biblioteca de etiquetas y Editor de etiquetas de JavaScript para acceder a los editores y las bibliotecas de etiquetas de sus extensiones, así como trabajar con ellos.
dom.getTagSelectorTag()
Disponibilidad
Dreamweaver MX.
Descripción
Esta función proporciona el nodo DOM de la etiqueta seleccionada actualmente en la barra de Selector de etiquetas situada en la parte inferior de la ventana del documento.
Argumentos
Ninguno.
Valor devuelto
El nodo DOM de la etiqueta seleccionada actualmente; null indica que no se ha seleccionado ninguna etiqueta.
dreamweaver.popupInsertTagDialog()
Disponibilidad
Dreamweaver MX.
Descripción
Esta función comprueba los archivos VTM para ver si se ha definido un editor de etiquetas para la etiqueta. Si es así, se muestra el editor correspondiente y se acepta la etiqueta inicial. De lo contrario, la etiqueta inicial se inserta sin modificar en el documento del usuario.
Argumentos
start_tag_string
Cadena de etiquetas de inicio que incluye uno de los siguientes tipos de valores iniciales:
Una etiqueta, como <input>
Una etiqueta con atributos, como <input type='text'>
Un directorio, como <%= %>
Valor devuelto
Un valor booleano: true si se inserta algún elemento en el documento; false en caso contrario.
dreamweaver.popupEditTagDialog()
Disponibilidad
Dreamweaver MX.
Descripción
Si se selecciona una etiqueta, esta función abre el editor para modificar dicha etiqueta.
Argumentos
Ninguno.
Valor devuelto
Ninguno.
Activación
Consulte dreamweaver.canPopupEditTagDialog().
dreamweaver.showTagChooser()
Disponibilidad
Dreamweaver MX (en desuso desde Dreamweaver CS5.5).
Descripción
Esta función muestra el cuadro de diálogo Selector de etiquetas, lo trae al frente y lo sitúa en primer plano.
Argumentos
Ninguno.
Valor devuelto
Ninguno.
dreamweaver.showTagLibraryEditor()
Disponibilidad
Dreamweaver MX.
Descripción
Esta función abre el editor de la biblioteca de etiquetas.
Argumentos
Ninguno.
Valor devuelto
Ninguno.
dreamweaver.tagLibrary.getTagLibraryDOM()
Disponibilidad
Dreamweaver MX.
Descripción
Dada la URL de un archivo filename.vtm, esta función devuelve el DOM correspondiente a dicho archivo para editar su contenido. Solo se debe llamar a esta función cuando el editor de la biblioteca de etiquetas esté activo.
Argumentos
fileURL
El argumento fileURL es la URL de un archivo filename.vtm relativa a la carpeta de la biblioteca de etiquetas o la configuración, como se muestra en el siguiente ejemplo: “HTML/img.vtm”.
Valor devuelto
Un puntero DOM que remite a un archivo existente o nuevo de la carpeta de la biblioteca de etiquetas.
dreamweaver.tagLibrary.getSelectedLibrary()
Disponibilidad
Dreamweaver MX.
Descripción
Si se ha seleccionado un nodo de biblioteca en el editor de la biblioteca de etiquetas, esta función recibe el nombre de la biblioteca.
Argumentos
Ninguno.
Valor devuelto
Una cadena con el nombre de la biblioteca seleccionada actualmente en el editor de la biblioteca de etiquetas; se obtiene una cadena vacía si no hay ninguna biblioteca seleccionada.
dreamweaver.tagLibrary.getSelectedTag()
Disponibilidad
Dreamweaver MX.
Descripción
Si un nodo de atributo está seleccionado actualmente, esta función recibe el nombre de la etiqueta que contiene el atributo.
Argumentos
Ninguno.
Valor devuelto
Una cadena con el nombre de la etiqueta seleccionada actualmente en el editor de la biblioteca de etiquetas; se obtiene una cadena vacía si no se selecciona ninguna etiqueta.
dreamweaver.tagLibrary.importDTDOrSchema()
Disponibilidad
Dreamweaver MX.
Descripción
Esta función importa un archivo DTD o de esquema de un servidor remoto en la biblioteca de etiquetas.
Argumentos
fileURL, Prefix
El argumento fileURL es la ruta al archivo DTD o de esquema en formato de URL local.
El argumento Prefix es la cadena de prefijo que debe añadirse a todas las etiquetas de esta biblioteca de etiquetas.
Valor devuelto
Nombre de la biblioteca de etiquetas importada.
dreamweaver.tagLibrary.getImportedTagList()
Disponibilidad
Dreamweaver MX.
Descripción
Esta función genera una lista de objetos tagInfo a partir de una biblioteca de etiquetas importada.
Argumentos
libname
El argumento libname es el nombre de la biblioteca de etiquetas importada.
Valor devuelto
Matriz de objetos tagInfo.
El objeto tagInfo contiene información sobre una única etiqueta de la biblioteca. En el objeto tagInfo se definen las siguientes propiedades:
La propiedad tagName, que es una cadena.
La propiedad attributes, que es una matriz de cadenas. Cada cadena representa el nombre del atributo definido para esta etiqueta.
Ejemplo:
El siguiente ejemplo muestra que con la función dw.tagLibrary.getImportedTagList() se genera una matriz de etiquetas a partir de la biblioteca libName.
// "fileURL" and "prefix" have been entered by the user.
// tell the Tag Library to Import the DTD/Schema
var libName = dw.tagLibrary.importDTDOrSchema(fileURL, prefix);
// get the array of tags for this library
// this is the TagInfo object
var tagArray = dw.tagLibrary.getImportedTagList(libName);
// now I have an array of tagInfo objects.
// I can get info out of them. This gets info out of the first one.
// note: this assumes there is at least one TagInfo in the array.
var firstTagName = tagArray[0].name;
var firstTagAttributes = tagArray[0].attributes;
// note that firstTagAttributes is an array of attributes.