Funzioni relative agli editor di tag e alle librerie di tag

Potete usare gli editor di tag per inserire nuovi tag, modificare i tag esistenti e accedere a informazioni di riferimento sui tag. Il Selettore di tag consente agli utenti di organizzare i propri tag in modo da poter selezionare facilmente quelli di uso più comune. Le librerie di tag fornite con Dreamweaver contengono informazioni sui tag usati nei linguaggi di codifica basati su standard e nei più diffusi linguaggi di script basati su tag. Potete usare le funzioni JavaScript relative a editor di tag, Selettore tag e librerie di tag quando avete bisogno di accedere a e lavorare con gli editor di tag e le librerie di tag nelle vostre estensioni.

dom.getTagSelectorTag()

Disponibilità

Dreamweaver MX.

Descrizione

Questa funzione ottiene il nodo DOM per il tag selezionato nella barra del Selettore tag nella parte inferiore della finestra del documento.

Argomenti

Nessuno.

Restituisce

Il nodo DOM del tag selezionato; null se non è selezionato alcun tag.

dreamweaver.popupInsertTagDialog()

Disponibilità

Dreamweaver MX.

Descrizione

Questa funzione controlla i file VTM per verificare se è stato definito un editor per il tag. In tal caso, l'editor specificato per quel tag viene visualizzato e accetta il tag iniziale. In caso contrario, il tag iniziale viene inserito senza modifiche nel documento dell'utente.

Argomenti

start_tag_string

Una stringa di tag iniziale che include uno dei seguenti tipi di valori iniziali:

  • Un tag, ad esempio <input>

  • Un tag con attributi, ad esempio <input type='text'>

  • Una direttiva, ad esempio <%= %>

Restituisce

Un valore booleano: true se nel documento è stato inserito qualcosa; false in caso contrario.

dreamweaver.popupEditTagDialog()

Disponibilità

Dreamweaver MX.

Descrizione

Se è selezionato un tag, questa funzione apre l'Editor di tag per quel tag per consentirne la modifica.

Argomenti

Nessuno.

Restituisce

Nulla.

Enabler

dreamweaver.showTagChooser()

Disponibilità

Dreamweaver MX (obsoleto da Dreamweaver CS5.5)

Descrizione

Questa funzione visualizza la finestra di dialogo Selettore tag, la porta in primo piano e la imposta come elemento attivo.

Argomenti

Nessuno.

Restituisce

Nulla.

dreamweaver.showTagLibraryEditor()

Disponibilità

Dreamweaver MX.

Descrizione

Questa funzione apre l'Editor librerie di tag.

Argomenti

Nessuno.

Restituisce

Nessuno.

dreamweaver.tagLibrary.getTagLibraryDOM()

Disponibilità

Dreamweaver MX.

Descrizione

Dato l'URL di un file filename.vtm, questa funzione restituisce il DOM di tale file, in modo che il contenuto possa essere modificato.Questa funzione deve essere chiamata solo quando l'Editor librerie di tag è attivo.

Argomenti

fileURL

  • L'argomento fileURL è l'URL di un file filename.vtm relativo alla cartella Configuration/Tag Libraries, come nell'esempio seguente: "HTML/img.vtm"

Restituisce

Un puntatore DOM a un file nuovo o già esistente nella cartella Tag Libraries.

dreamweaver.tagLibrary.getSelectedLibrary()

Disponibilità

Dreamweaver MX.

Descrizione

Se nell'Editor librerie di tag è selezionato un nodo di libreria, questa funzione recupera il nome della libreria.

Argomenti

Nessuno.

Restituisce

Una stringa: il nome della libreria attualmente selezionata nell'Editor librerie di tag; restituisce una stringa vuota se non è selezionata alcuna libreria.

dreamweaver.tagLibrary.getSelectedTag()

Disponibilità

Dreamweaver MX.

Descrizione

Se è selezionato un nodo di attributo, questa funzione recupera il nome del tag che contiene l'attributo.

Argomenti

Nessuno.

Restituisce

Una stringa: il nome del tag attualmente selezionato nell'Editor librerie di tag; restituisce una stringa vuota se non è selezionato alcun tag.

dreamweaver.tagLibrary.importDTDOrSchema()

Disponibilità

Dreamweaver MX.

Descrizione

Questa funzione importa nella libreria di tag un DTD o un file di schema da un server remoto.

Argomenti

fileURL, Prefix

  • L'argomento fileURL è il percorso di un DTD o un file di schema, in formato URL locale.

  • L'argomento Prefix è la stringa di prefisso che deve essere aggiunta a tutti i tag di questa libreria di tag.

Restituisce

Il nome della libreria di tag importata.

dreamweaver.tagLibrary.getImportedTagList()

Disponibilità

Dreamweaver MX.

Descrizione

Questa funzione genera un elenco di oggetti tagInfo da una libreria di tag importata.

Argomenti

libname

  • L'argomento libname è il nome di una libreria di tag importata.

Restituisce

Un array di oggetti tagInfo.

Un oggetto taginfo contiene informazioni su un singolo tag incluso nella libreria di tag. Le seguenti proprietà sono definite in un oggetto tagInfo:

  • La proprietà tagName, che è una stringa.

  • La proprietà attributes, che è un array di stringhe. Ogni stringa è il nome di un attributo definito per questo tag.

Esempio:

L'esempio seguente mostra che utilizzando la funzione dw.tagLibrary.getImportedTagList() è possibile ottenere un array di tag dalla libreria 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. 
 

 Adobe

Ottieni supporto in modo più facile e veloce

Nuovo utente?

Adobe MAX 2024

Adobe MAX
La conferenza sulla creatività

14-16 ottobre Miami Beach e online

Adobe MAX

La conferenza sulla creatività

14-16 ottobre Miami Beach e online

Adobe MAX 2024

Adobe MAX
La conferenza sulla creatività

14-16 ottobre Miami Beach e online

Adobe MAX

La conferenza sulla creatività

14-16 ottobre Miami Beach e online