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.