您可以使用標籤編輯器,插入新的標籤、編輯現有標籤,以及存取標籤的參考資訊。「標籤選擇程式」可讓使用者組織其標籤,以便能輕鬆地選取常用的標籤。Dreamweaver 隨附的標籤資料庫會儲存標籤的相關資訊,這些標籤用於標準式標記語言以及最廣泛使用的標籤指令碼語言。當您需要在擴充功能中存取和使用標籤編輯器和標籤資料庫時,可以使用「JavaScript 標籤編輯器」、「標籤選擇程式」和「標籤資料庫」函式。
dom.getTagSelectorTag()
適用版本
Dreamweaver MX。
描述
這個函式會取得目前在文件視窗下方「標籤選取器」列中所選取之標籤的 DOM 節點。
引數
無。
傳回值
目前所選取之標籤的 DOM 節點,如果沒有選取任何標籤則為 null。
dreamweaver.popupInsertTagDialog()
適用版本
Dreamweaver MX。
描述
這個函式會檢查 VTM 檔案以判斷標籤是否已經定義標籤編輯器。若是,該標籤編輯器會跳出並接受開始標籤。若否,開始標籤會未經修改即插入使用者的文件中。
引數
start_tag_string
開始標籤字串,包含下列其中一個類型的初始值:
標籤,例如 <input>
含屬性的標籤,例如 <input type='text'>
指示詞,例如 <%= %>
傳回值
布林值:如果文件中已插入任何項目則為 true,否則為 false。
dreamweaver.popupEditTagDialog()
適用版本
Dreamweaver MX。
描述
如果已選取標籤,這個函式會開啟該標籤的標籤編輯器,讓您可以編輯標籤。
引數
無。
傳回值
無。
啟用程式
dreamweaver.showTagChooser()
適用版本
Dreamweaver MX (自 Dreamweaver CS5.5 開始已不支援)
描述
這個函式會顯示「標籤選擇程式」對話方塊,將其移至最上層並設定為焦點。
引數
無。
傳回值
無。
dreamweaver.showTagLibraryEditor()
適用版本
Dreamweaver MX。
描述
這個函式會開啟「標籤資料庫」編輯器。
引數
無。
傳回值
無。
dreamweaver.tagLibrary.getTagLibraryDOM()
適用版本
Dreamweaver MX。
描述
指定 filename.vtm 檔案的 URL 之後,這個函式會傳回該檔案的 DOM,如此一來,就可以編輯檔案的內容。只有當「標籤資料庫」編輯器處於作用中狀態時,才應該呼叫這個函式。
引數
fileURL
fileURL 引數是 filename.vtm 檔案相對於 Configuration/Tag Libraries 資料夾的 URL,如下列範例所示:「HTML/img.vtm」
傳回值
TagLibraries 資料夾中新增或舊有檔案的 DOM 指標。
dreamweaver.tagLibrary.getSelectedLibrary()
適用版本
Dreamweaver MX。
描述
如果在「標籤資料庫」編輯器中已選取資料庫節點,這個函式會取得資料庫名稱。
引數
無。
傳回值
字串:目前在「標籤資料庫」編輯器中所選資料庫的名稱,如果沒有選取資料庫,則傳回空字串。
dreamweaver.tagLibrary.getSelectedTag()
適用版本
Dreamweaver MX。
描述
如果目前已選取屬性節點,這個函式會取得包含屬性之標籤的名稱。
引數
無。
傳回值
字串:目前在「標籤資料庫」編輯器中所選標籤的名稱,如果沒有選取標籤,則傳回空字串。
dreamweaver.tagLibrary.importDTDOrSchema()
適用版本
Dreamweaver MX。
描述
這個函式會從遠端伺服器將 DTD 或綱要檔匯入標籤資料庫中。
引數
fileURL、Prefix
fileURL 引數是本機 URL 格式的 DTD 或綱要檔路徑。
Prefix 引數是應該為這個標籤資料庫中所有標籤加上的前置詞字串。
傳回值
匯入之標籤資料庫的名稱。
dreamweaver.tagLibrary.getImportedTagList()
適用版本
Dreamweaver MX。
描述
這個函式會從匯入的標籤資料庫產生 tagInfo 物件的清單。
引數
libname
libname 引數是匯入之標籤資料庫的名稱。
傳回值
tagInfo 物件陣列。
taginfo 物件含有標籤資料庫中所包含之單一標籤的相關資訊。下列屬性是在 tagInfo 物件中定義:
tagName 屬性,這是字串
attributes 屬性,這是字串陣列。每個字串都是這個標籤所定義之屬性 (Attribute) 的名稱。
範例:
下列範例顯示使用 dw.tagLibrary.getImportedTagList() 函式可以從 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.