常规编辑函数

您可以在“文档”窗口中处理常规编辑函数。这些函数用于插入文本、HTML 和对象；应用、更改和删除字体及字符标记；修改标签和属性；等等。

适用版本

Dreamweaver 3。

说明

将指定类型的字符标记应用于所选内容。如果所选内容为插入点，则将指定的字符标记应用于后续键入的所有文本。

参数

tagName

• tagName 参数是与字符标记相关联的标签名称。它必须是以下字符串之一："b"、"cite"、"code"、"dfn"、"em"、"i"、"kbd"、"samp"、"s"、"strong"、"tt"、"u" 或 "var"。

返回值

无。

dom.applyFontMarkup()

适用版本

Dreamweaver 3。

说明

将 FONT 标签以及指定的属性和值应用于当前所选内容。

参数

attribute, value

• attribute 参数必须为 "face"、"size" 或 "color"。

• value 参数是将分配给该属性的值；例如，"Arial"、"Helvetica"、"sans-serif"、"5" 或 "#FF0000"。

返回值

无。

dom.deleteSelection()

适用版本

Dreamweaver 3。

说明

删除文档中的所选内容。

参数

无。

返回值

无。

dom.editAttribute()

适用版本

Dreamweaver 3。

说明

显示用于编辑指定的文档属性的适当界面。在大多数情况下，该界面是一个对话框。该函数仅对活动文档有效。

参数

attribute

• attribute 是一个指定要编辑的标签属性的字符串。

返回值

无。

dom.exitBlock()

适用版本

Dreamweaver 3。

说明

退出当前段落或标题块，将插入点保留在所有块元素之外。

参数

无。

返回值

无。

dom.getCharSet()

适用版本

Dreamweaver 4。

说明

返回文档的 Meta 标签中的 charset 属性。

参数

无。

返回值

文档的编码标识。例如，对于 Latin1 文档，该函数返回 iso-8859-1。

dom.getFontMarkup()

适用版本

Dreamweaver 3。

说明

获取当前所选内容的 FONT 标签的指定属性值。

参数

attribute

• attribute 参数必须为 "face"、"size" 或 "color"。

返回值

一个包含指定属性的值的字符串；如果未设置该属性，则返回一个空字符串。

dom.getLineFromOffset()

适用版本

Dreamweaver MX。

说明

查找特定字符偏移在文件的文本（HTML 或 JavaScript 代码）中的行号。

参数

offset

• offset 参数是一个表示文件开头的字符位置的整数。

返回值

一个表示文档中的行号的整数。

dom.getLinkHref()

适用版本

Dreamweaver 3。

说明

获取围绕当前所选内容的链接。该函数的作用相当于重复检查当前节点的父项和祖父项，直至找到一个链接然后对该链接调用 getAttribute('HREF')。

参数

无。

返回值

一个包含链接文件的名称的字符串，表示为 file:// URL。

dom.getLinkTarget()

适用版本

Dreamweaver 3。

说明

获取围绕当前所选内容的链接的目标。该函数的作用相当于重复检查当前节点的父项和祖父项，直至找到一个链接然后对该链接调用 getAttribute('TARGET') 函数。

参数

无。

返回值

一个包含该链接的 TARGET 属性值的字符串；如果未指定目标，则返回一个空字符串。

dom.getListTag()

适用版本

Dreamweaver 3。

说明

获取选定列表的样式。

参数

无。

返回值

一个包含与该列表相关联的标签（"ul"、"ol" 或 "dl"）的字符串；如果没有任何标签与该列表相关联，则返回一个空字符串。该值始终以小写字母形式返回。

dom.getTextAlignment()

适用版本

Dreamweaver 3。

说明

获取包含所选内容的块的对齐方式。

参数

无。

返回值

一个包含与该块相关联的标签的 ALIGN 属性值的字符串；如果没有为该标签设置 ALIGN 属性，则返回一个空字符串。该值始终以小写字母形式返回。

dom.getTextFormat()

适用版本

Dreamweaver 3。

说明

获取选定文本的块格式。

参数

无。

返回值

一个包含与该文本相关联的块标签（例如，"p"、"h1"、"pre" 等等）的字符串；如果没有任何块标签与所选内容相关联，则返回一个空字符串。该值始终以小写字母形式返回。

dom.hasCharacterMarkup()

适用版本

Dreamweaver 3。

说明

检查选定内容是否已有指定的字符标记。

参数

markupTagName

• markupTagName 参数是您要检查的标签的名称。它必须是以下字符串之一："b"、"cite"、"code"、"dfn"、"em"、"i"、"kbd"、"samp"、"s"、"strong"、"tt"、"u" 或 "var"。

返回值

一个指示整个所选内容是否有指定的字符标记的布尔值。仅当该所选内容的一部分具有指定标记时，该函数才返回 false 值。

dom.indent()

适用版本

Dreamweaver 3。

说明

使用 BLOCKQUOTE 标签缩进所选内容。如果所选内容为列表项，则该函数通过将选定项转换为嵌套列表来缩进所选内容。该嵌套列表与外部列表的类型相同且包含一个项目（原始选定项）。

参数

无。

返回值

无。

dom.insertHTML()

适用版本

Dreamweaver 3。

说明

将 HTML 内容插入文档中的当前插入点。

参数

contentToInsert, {bReplaceCurrentSelection}

• contentToInsert 参数是要插入的内容。

• bReplaceCurrentSelection 参数是可选的，它是一个指示该内容是否应替换当前所选内容的布尔值。如果 bReplaceCurrentSelection 参数的值是 true，则该内容替换当前所选内容。如果值为 false，则在当前所选内容后插入该内容。

返回值

无。

示例

以下代码将 HTML 字符串 <b>130</b> 插入当前文档中：

结果显示在“文档”窗口中。

dom.insertObject()

适用版本

Dreamweaver 3。

说明

插入指定对象，如果需要，提示用户输入参数。

参数

objectName

• objectName 参数是 Configuration/Objects 文件夹中某对象的名称。

返回值

无。

示例

调用 dom.insertObject('Button') 函数时将在活动文档中当前所选内容后插入一个表单按钮。如果未选择任何内容，该函数将在当前插入点插入该按钮。

dom.insertText()

适用版本

Dreamweaver 3。

说明

将文本内容插入文档中的当前插入点。

参数

contentToInsert, {bReplaceCurrentSelection}

• contentToInsert 参数是要插入的内容。

• bReplaceCurrentSelection 参数是可选的，它是一个指示该内容是否应替换当前所选内容的布尔值。如果 bReplaceCurrentSelection 参数的值是 true，则该内容替换当前所选内容。如果值为 false，则在当前所选内容后插入该内容。

返回值

无。

示例

以下代码向当前文档中插入文本 &lt;b&gt;130&lt;/b&gt;：

结果显示在“文档”窗口中。

dom.newBlock()

适用版本

Dreamweaver 3。

说明

使用与包含当前所选内容的块相同的标签和属性创建一个新块，或者创建一个新段落（如果指针在所有块之外）。

参数

无。

返回值

无。

示例

如果当前所选内容位于居中对齐的段落内，则调用 dom.newBlock() 函数将在当前段落后插入 <p align="center">。

dom.notifyFlashObjectChanged()

适用版本

Dreamweaver 4。

说明

告知 Dreamweaver 当前 Flash 对象文件已更改。Dreamweaver 会更新预览显示，以便根据需要调整其大小，保留原始尺寸的高宽比。

参数

无。

返回值

无。

dom.outdent()

适用版本

Dreamweaver 3。

说明

凸出所选内容。

参数

无。

返回值

无。

dom.removeCharacterMarkup()

适用版本

Dreamweaver 3。

说明

从所选内容中删除指定类型的字符标记。

参数

tagName

• tagName 参数是与字符标记相关联的标签名称。它必须是以下字符串之一："b"、"cite"、"code"、"dfn"、"em"、"i"、"kbd"、"samp"、"s"、"strong"、"tt"、"u" 或 "var"。

返回值

无。

dom.removeFontMarkup()

适用版本

Dreamweaver 3。

说明

从 FONT 标签中删除指定的属性及其值。如果删除该属性仅留下 FONT 标签，还将删除 FONT 标签。

参数

attribute

• attribute 参数必须为 "face"、"size" 或 "color"。

返回值

无。

dom.resizeSelection()

适用版本

Dreamweaver 3。

说明

将所选对象调整为指定尺寸。

参数

newWidth, newHeight

• newWidth 参数指定该函数将设置的所选对象的新宽度。

• newHeight 参数指定该函数将设置的所选对象的新高度。

返回值

无。

dom.setAttributeWithErrorChecking()

适用版本

Dreamweaver 3。

说明

将当前所选内容的指定属性设置为指定的值，以在该值为错误类型或超出范围时提示用户。该函数仅对活动文档有效。

参数

attribute, value

• attribute 参数指定要为当前所选内容设置的属性。

• value 参数指定要为该属性设置的值。

返回值

无。

dom.setLinkHref()

适用版本

Dreamweaver 3。

说明

使所选内容成为超文本链接，或者更改括起当前所选内容的 HREF 标签的 URL 值。

参数

linkHREF

• linkHREF 参数是构成该链接的 URL（文档相对路径、根目录相对路径或绝对 URL）。如果省略该参数，则显示“选择 HTML 文件”对话框。

返回值

无。

Enabler

请参阅 dom.canSetLinkHref()。

dom.setLinkTarget()

适用版本

Dreamweaver 3。

说明

设置围绕当前所选内容的链接的目标。该函数的作用相当于重复检查当前节点的父项和祖父项，直至找到一个链接然后对该链接调用 setAttribute('TARGET') 函数。

参数

{linkTarget}

• linkTarget 参数是可选的，它是一个表示框架名称、窗口名称或保留目标之一（"_self"、"_parent"、"_top" 或 "_blank"）的字符串。如果省略该参数，将显示“设置目标”对话框。

返回值

无。

dom.setListBoxKind()

适用版本

Dreamweaver 3。

说明

更改所选 SELECT 菜单的种类。

参数

kind

• kind 参数必须为 "menu" 或 "list box"。

返回值

无。

dom.showListPropertiesDialog()

适用版本

Dreamweaver 3。

说明

打开“列表属性”对话框。

参数

无。

返回值

无。

Enabler

请参阅 dom.canShowListPropertiesDialog()。

dom.setListTag()

适用版本

Dreamweaver 3。

说明

设置所选列表的样式。

参数

listTag

• listTag 参数是与该列表相关联的标签。它必须为 "ol"、"ul"、"dl" 或空字符串。

返回值

无。

dom.setTextAlignment()

适用版本

Dreamweaver 3。

说明

将包含所选内容的块的 ALIGN 属性设置为指定值。

参数

alignValue

• alignValue 参数必须为 "left"、"center" 或 "right"。

返回值

无。

dom.setTextFieldKind()

适用版本

Dreamweaver 3（自 Dreamweaver CS5.5 起已弃用）

说明

设置选定文本字段的格式。

参数

fieldType

• fieldType 参数必须为 "input"、"textarea" 或 "password"。

返回值

无。

dom.setTextFormat()

适用版本

Dreamweaver 4。

说明

设置选定文本的块格式。

参数

blockFormat

• blockFormat 参数是一个指定下列格式之一的字符串：""（无格式）、"p"、"h1"、"h2"、"h3"、"h4"、"h5"、"h6" 或 "pre"。

返回值

无。

dom.showFontColorDialog()

适用版本

Dreamweaver 3。

说明

打开“拾色器”对话框。

参数

无。

返回值

无。

dreamweaver.deleteSelection()

适用版本

Dreamweaver 3。

说明

删除活动文档或站点面板中的所选内容；在 Macintosh 上，该函数将删除在对话框或浮动面板中具有焦点的文本框。

参数

无。

返回值

无。

Enabler

请参阅 dreamweaver.canDeleteSelection()。

dreamweaver.editFontList()

适用版本

Dreamweaver 3。

说明

打开“编辑字体列表”对话框。

参数

无。

返回值

无。

dreamweaver.getFontList()

适用版本

Dreamweaver 3。

说明

获取显示在文本属性检查器和“样式定义”对话框中的所有字体组的列表。

参数

无。

返回值

一个表示字体列表中各个项的字符串数组。

示例

对于默认安装的 Dreamweaver，调用 dreamweaver.getFontList() 函数将返回一个包含下列项的数组：

• "Arial, Helvetica, sans-serif"

• "Times New Roman, Times, serif"

• "Courier New, Courier, mono"

• "Georgia, Times New Roman, Times, serif"

• "Verdana, Arial, Helvetica, sans-serif"

dreamweaver.getFontStyles()

适用版本

Dreamweaver 4。

说明

返回指定的 TrueType 字体支持的样式。

参数

fontName

• fontName 参数是一个包含该字体的名称的字符串。

返回值

一个由三个布尔值组成的数组，用于指示该字体支持的样式。第一个值指示该字体是否支持粗体，第二个值指示该字体是否支持斜体，第三个值指示该字体是否同时支持粗体 和斜体。

dreamweaver.getKeyState()

适用版本

Dreamweaver 3。

说明

确定是否按下了指定的修改键。

参数

key

• key 参数必须为下列值之一："Cmd"、"Ctrl"、"Alt" 或 "Shift"。在 Windows 中，"Cmd" 和 "Ctrl" 是指 Control 键；在 Macintosh 中，"Alt" 是指 Option 键。

返回值

一个指示是否按下了该键的布尔值。

示例

以下代码检查在执行某操作之前是否按下了 Shift 和 Control 键 (Windows) 或者 Shift 和 Command 键 (Macintosh)：

dreamweaver.getNaturalSize()

适用版本

Dreamweaver 4。

说明

返回图形对象的宽度和高度。

参数

url

• url 参数指向需要其尺寸的图形对象。Dreamweaver 必须支持该对象（GIF、JPEG、PNG、Flash 和 Shockwave）。作为 getNaturalSize() 函数的参数提供的 URL 必须为指向本地文件的绝对 URL；它不能为相对 URL。

返回值

一个由两个整数组成的数组，第一个整数定义该对象的宽度，第二个整数定义高度。

dreamweaver.getSystemFontList()

适用版本

Dreamweaver 4。

说明

返回系统的字体列表。该函数可获取所有字体或仅获取 TrueType 字体。

参数

fontTypes

• fontTypes 参数是一个包含值 all 或值 TrueType 的字符串。

返回值

一个包含全部字体名称的字符串的数组；如果未找到字体，则返回 null 值。

dreamweaver.getSystemFontName()

适用版本

Dreamweaver CS5。

说明

返回系统字体名称。

参数

无。

返回值

一个包含系统字体名称的字符串。