Funktionen für Tag-Editor und Tag-Bibliothek

Mit Tag-Editoren können Sie neue Tags einfügen, vorhandene Tags bearbeiten und auf Referenzinformationen zu Tags zugreifen. Mit der Tag-Auswahl können Benutzer ihre Tags anordnen, um häufig verwendete Tags schneller auswählen zu können. Die im Lieferumfang von Dreamweaver enthaltenen Tag-Bibliotheken speichern Informationen über Tags, die in standardisierten Markup-Sprachen und den gängigsten Tag-basierten Skriptsprachen verwendet werden. Mithilfe der Funktionen für JavaScript-Tag-Editor, Tag-Auswahl und Tag-Bibliothek können Sie auf Tag-Editoren und Tag-Bibliotheken in Erweiterungen zugreifen und diese verwenden.

dom.getTagSelectorTag()

Verfügbarkeit

Dreamweaver MX.

Beschreibung

Diese Funktion ruft den DOM-Knoten für das Tag ab, das derzeit im Tag-Selektor im unteren Bereich des Dokumentfensters ausgewählt ist.

Argumente

Keine.

Rückgabewerte

Der DOM-Knoten für das derzeit ausgewählte Tag oder null, wenn kein Tag ausgewählt ist.

dreamweaver.popupInsertTagDialog()

Verfügbarkeit

Dreamweaver MX.

Beschreibung

Diese Funktion überprüft die VTM-Dateien, um festzustellen, ob ein Tag-Editor für das Tag definiert wurde. Ist dies der Fall, wird der Editor für dieses Tag angezeigt und das öffnende Tag übernommen. Andernfalls wird das öffnende Tag unverändert in das Benutzerdokument eingefügt.

Argumente

start_tag_string

Ein String für das öffnende Tag, der einen der folgenden Anfangswerte enthält:

  • Ein Tag, z. B. <input>

  • Ein Tag mit Attributen, z. B. <input type='text'>

  • Eine Direktive, z. B. <%= %>

Rückgabewerte

Ein boolescher Wert: true, wenn ein Element in das Dokument eingefügt wird, andernfalls false.

dreamweaver.popupEditTagDialog()

Verfügbarkeit

Dreamweaver MX.

Beschreibung

Wenn ein Tag ausgewählt ist, öffnet diese Funktion den entsprechenden Tag-Editor, sodass Sie das Tag bearbeiten können.

Argumente

Keine.

Rückgabewerte

Keine.

Enabler

dreamweaver.showTagChooser()

Verfügbarkeit

Dreamweaver MX (wird seit Dreamweaver CS5.5 nicht mehr unterstützt).

Beschreibung

Diese Funktion zeigt das Dialogfeld „Tag-Auswahl“ im Vordergrund an und aktiviert es.

Argumente

Keine.

Rückgabewerte

Keine.

dreamweaver.showTagLibraryEditor()

Verfügbarkeit

Dreamweaver MX.

Beschreibung

Diese Funktion öffnet den Tag-Bibliothek-Editor.

Argumente

Keine.

Rückgabewerte

Keine.

dreamweaver.tagLibrary.getTagLibraryDOM()

Verfügbarkeit

Dreamweaver MX.

Beschreibung

Mit der URL einer Datei des Typs Dateiname.vtm als Argument gibt diese Funktion das DOM für diese Datei zurück, sodass der Inhalt bearbeitet werden kann. Diese Funktion sollte nur aufgerufen werden, wenn der Tag-Bibliothek-Editor aktiv ist.

Argumente

fileURL

  • Das Argument fileURL ist die URL einer Datei vom Typ Dateiname.vtm relativ zum Ordner „Configuration/TagLibraries“, z. B. "HTML/img.vtm".

Rückgabewerte

Ein DOM-Zeiger auf eine neue oder bereits vorhandene Datei im Ordner „TagLibraries“.

dreamweaver.tagLibrary.getSelectedLibrary()

Verfügbarkeit

Dreamweaver MX.

Beschreibung

Wenn im Tag-Bibliothek-Editor ein Bibliotheksknoten ausgewählt ist, gibt diese Funktion den Bibliotheksnamen zurück.

Argumente

Keine.

Rückgabewerte

Ein String mit dem Namen der Bibliothek, die im Tag-Bibliothek-Editor derzeit ausgewählt ist. Wenn keine Bibliothek ausgewählt ist, wird ein leerer String zurückgegeben.

dreamweaver.tagLibrary.getSelectedTag()

Verfügbarkeit

Dreamweaver MX.

Beschreibung

Wenn derzeit ein Attributknoten ausgewählt ist, gibt diese Funktion den Namen des Tags zurück, das das Attribut enthält.

Argumente

Keine.

Rückgabewerte

Ein String mit dem Namen des Tags, das im Tag-Bibliothek-Editor derzeit ausgewählt ist. Wenn kein Tag ausgewählt ist, wird ein leerer String zurückgegeben.

dreamweaver.tagLibrary.importDTDOrSchema()

Verfügbarkeit

Dreamweaver MX.

Beschreibung

Diese Funktion importiert eine DTD- oder Schemadatei von einem Remote-Server in die Tag-Bibliothek.

Argumente

fileURL, Prefix

  • Das Argument fileURL ist der Pfad zur DTD- oder Schemadatei im lokalen URL-Format.

  • Das Argument Prefix ist der Präfix-String, der allen Tags in dieser Tag-Bibliothek hinzugefügt wird.

Rückgabewerte

Name der importierten Tag-Bibliothek.

dreamweaver.tagLibrary.getImportedTagList()

Verfügbarkeit

Dreamweaver MX.

Beschreibung

Diese Funktion generiert eine Liste mit tagInfo-Objekten aus einer importierten Tag-Bibliothek.

Argumente

libname

  • Das Argument libname ist der Name der importierten Tag-Bibliothek.

Rückgabewerte

Array von tagInfo-Objekten.

Ein tagInfo-Objekt enthält Informationen über ein einzelnes Tag, das in der Tag-Bibliothek enthalten ist. In einem tagInfo-Objekt sind die folgenden Eigenschaften definiert:

  • Bei der Eigenschaft tagName handelt es sich um einen String.

  • Bei der Eigenschaft attributes handelt es sich um ein Array von Strings. Jeder String enthält den Namen eines Attributs, das für dieses Tag definiert ist.

Beispiel:

Im folgenden Beispiel wird aufgezeigt, wie durch die Verwendung der Funktion dw.tagLibrary.getImportedTagList() ein Tag-Array aus der Bibliothek libName abgerufen wird.

     // "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. 
 

Schneller und einfacher Hilfe erhalten

Neuer Benutzer?