标签编辑器和标签库函数

搜索
Adobe Dreamweaver 用户指南

在此页面上

适用于: Adobe Dreamweaver

某些 Creative Cloud 应用程序、服务和功能在中国不可用。

您可以使用标签编辑器插入新标签、编辑现有标签以及访问有关标签的参考信息。标签选择器允许用户整理其标签，以便他们可以轻松选择常用的标签。随 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。

说明

如果选择某个标签，该函数会打开该标签的标签编辑器，以便您可以编辑该标签。

参数

无。

返回值

无。

Enabler

请参阅 dreamweaver.canPopupEditTagDialog()。

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 参数是 DTD 或架构文件的路径，采用本地 URL 格式。

  • Prefix 参数是应添加到该标签库中的所有标签的前缀字符串。

返回值

导入的标签库的名称。

dreamweaver.tagLibrary.getImportedTagList()

适用版本

Dreamweaver MX。

说明

该函数从导入的标签库生成 tagInfo 对象列表。

参数

libname

  • libname 参数是导入的标签库的名称。

返回值

tagInfo 对象数组。

taginfo 对象包含有关包括在标签库中的单个标签的信息。以下属性是在 tagInfo 对象中定义的：

  • tagName 属性，它是一个字符串

  • attributes 属性，它是一个字符串数组。每个字符串都是为该标签定义的属性的名称。

示例：

以下示例说明使用 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.