Você pode usar editores de tags para inserir novas tags, editar tags já existentes e acessar as informações de referência sobre tags. O Seletor de tags permite que os usuários organizem suas tags para que possam selecionar, sem dificuldades, as tags usadas com frequência. As bibliotecas de tags que trazem informações de armazenamento do Dreamweaver sobre as tags que são usadas em linguagens de marcação baseadas em padrões e nas mais usadas linguagens de scripts baseadas em tags. Use o Editor de tags JavaScript, o Seletor de tags e as funções de biblioteca de tags quando precisar acessar e trabalhar com editores de tags e bibliotecas de tags em suas extensões.
dom.getTagSelectorTag()
Disponibilidade
Dreamweaver MX.
Descrição
Esta função obtém o nó DOM para a tag selecionada na barra Seletor de tag, na parte inferior da janela do documento.
Argumentos
Nenhum.
Retorna
O nó DOM para a tag selecionada; nulo se não houver nenhuma tag selecionada.
dreamweaver.popupInsertTagDialog()
Disponibilidade
Dreamweaver MX.
Descrição
Esta função verifica os arquivos VTM para verificar se um editor de tags foi definido para a tag. Se tiver sido, o editor para essa tag aparece e aceita a tag inicial. Caso contrário, a tag inicial é inserida sem qualquer alteração no documento do usuário.
Argumentos
start_tag_string
Uma sequência de caracteres da tag inicial que inclui um dos seguintes tipos de valores iniciais:
Uma tag, tal como <input>
Uma tag com atributos, tal como <input type='text'>
Uma diretiva, tal como <%= %>
Retorna
Um valor booliano: true se nada for inserido no documento; caso contrário, retornará false.
dreamweaver.popupEditTagDialog()
Disponibilidade
Dreamweaver MX.
Descrição
Se uma tag for selecionada, esta função abrirá o editor de tags para que você possa editá-la.
Argumentos
Nenhum.
Retorna
Nada.
Ativador
Consulte dreamweaver.canPopupEditTagDialog().
dreamweaver.showTagChooser()
Disponibilidade
Dreamweaver MX (obsoleto desde a Dreamweaver CS5.5)
Descrição
Esta função exibe a caixa de diálogo Seletor de tag, move-a para frente e coloca-a em foco.
Argumentos
Nenhum.
Retorna
Nada.
dreamweaver.showTagLibraryEditor()
Disponibilidade
Dreamweaver MX.
Descrição
Esta função abre o Editor de bibliotecas de tags.
Argumentos
Nenhum.
Retorna
Nada.
dreamweaver.tagLibrary.getTagLibraryDOM()
Disponibilidade
Dreamweaver MX.
Descrição
Quando fornecido o URL de um nome de arquivo. Arquivo vtm, esta função retorna o DOM desse arquivo para a edição de seu conteúdo.Essa função deve ser chamada somente quando o Editor de bibliotecas de tags estiver ativo.
Argumentos
fileURL
O argumento fileURL é o URL de um nome de arquivo. O arquivo vtm, relativo à pasta Bibliotecas de configurações/Tags, conforme mostrado no seguinte exemplo: "html/img.vtm"
.
Retorna
Um ponteiro DOM para um arquivo novo ou já existente na pasta TagLibraries.
dreamweaver.tagLibrary.getSelectedLibrary()
Disponibilidade
Dreamweaver MX.
Descrição
Se um nó de biblioteca estiver selecionado no Editor de bibliotecas de tags, essa função obterá o nome da biblioteca.
Argumentos
Nenhum.
Retorna
Uma sequência de caracteres: o nome da biblioteca atualmente selecionada no Editor de bibliotecas de tags; retornará uma sequência de caracteres vazia se nenhuma biblioteca estiver selecionada.
dreamweaver.tagLibrary.getSelectedTag()
Disponibilidade
Dreamweaver MX.
Descrição
Se um nó de atributo estiver selecionado, essa função obterá o nome da tag que contém o atributo.
Argumentos
Nenhum.
Retorna
Uma sequência de caracteres: o nome da tag selecionada no editor Bibliotecas de tags; retorna uma sequência de caracteres vazia se nenhuma tag está selecionada.
dreamweaver.tagLibrary.importDTDOrSchema()
Disponibilidade
Dreamweaver MX.
Descrição
Esta função importa um arquivo DTD ou de esquema de um servidor remoto para a biblioteca de tags.
Argumentos
fileURL, Prefix
O argumento fileURL é o caminho para o arquivo DTD ou de esquema, no formato de URL local.
O argumento Prefix é a sequência de caracteres de prefixo a ser adicionada a todas as tags dessa biblioteca de tags.
Retorna
Nome da biblioteca de tags importada.
dreamweaver.tagLibrary.getImportedTagList()
Disponibilidade
Dreamweaver MX.
Descrição
Esta função vai gerar uma lista de objetos tagInfo com base em uma biblioteca de tags importada.
Argumentos
libname
O argumento libname é o nome da biblioteca de tags importada.
Retorna
Matriz de objetos tagInfode.
Um objeto taginfo contém informações sobre uma única tag incluída na biblioteca de tags. As seguintes propriedades são definidas em um objeto tagInfo:
A propriedade tagName, que é uma sequência de caracteres
A propriedade attributes, que é uma matriz de sequências de caracteres. Cada sequência de caracteres é o nome de um atributo definido para essa tag.
Exemplo:
O seguinte exemplo mostra que o uso da função dw.tagLibrary.getImportedTagList() pode obter uma matriz de tags da 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.
