一般編輯函式

您可以在「文件」視窗中處理一般編輯函式。這些函式會進行插入文字、HTML 和物件;套用、變更和移除字體及字元標記;修改標籤及屬性等作業。

dom.applyCharacterMarkup()

適用版本

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> 插入目前文件中:

 var theDOM = dw.getDocumentDOM(); 
 theDOM.insertHTML('<b>130</b>');

結果會出現在「文件」視窗中。

dom.insertObject()

適用版本

Dreamweaver 3。

描述

插入指定的物件,並在必要時提示使用者提供參數。

引數

objectName

  • objectName 引數是 Configuration/Objects 資料夾中物件的名稱。

傳回值

無。

範例

呼叫 dom.insertObject('Button') 函式會在使用中文件的目前選取範圍之後插入表單按鈕。如果沒有選取任何項目,這個函式會在目前插入點插入按鈕。

註解:

雖然物件檔案可以儲存在不同資料夾中,但這些檔案一定要有唯一名稱。如果 Forms 資料夾和 MyObjects 資料夾同樣都有名為 Button.htm 的檔案,Dreamweaver 就無法加以分辨。

dom.insertText()

適用版本

Dreamweaver 3。

描述

在目前插入點將文字內容插入文件中。

引數

contentToInsert、{bReplaceCurrentSelection}

  • contentToInsert 引數是您要插入的內容。

  • bReplaceCurrentSelection 引數 (這是選擇性引數) 為表示內容是否應取代目前選取範圍的布林值。如果 bReplaceCurrentSelection 引數值為 true,內容會取代目前選取範圍。如果值為 false,則在目前選取範圍之後插入內容。

傳回值

無。

範例

下列程式碼會將文字 &lt;b&gt;130&lt;/b&gt; 插入目前文件中:

 var theDOM = dreamweaver.getDocumentDOM(); 
 theDOM.insertText('<b>130</b>');

結果會出現在「文件」視窗中。

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 檔案」對話方塊。

傳回值

無。

啟用程式

請參閱 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。

描述

開啟「清單屬性」對話方塊。

引數

無。

傳回值

無。

啟用程式

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 上,這會刪除在對話方塊或浮動面板中有焦點的文字方塊。

引數

無。

傳回值

無。

啟用程式

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 引數是包含字體名稱的字串。

傳回值

含有三個布林值的陣列,表示所支援的字體。第一個值表示字體是否支援 bold,第二個值表示字體是否支援 italic,以及第三個值表示字體是否支援 bolditalic 兩者。

dreamweaver.getKeyState()

適用版本

Dreamweaver 3。

描述

判斷指定的輔助按鍵是否被按下。

引數

key

  • key 引數必須是下列其中一個值:"Cmd""Ctrl""Alt""Shift"。在 Windows 中,"Cmd""Ctrl" 指的是 Control 鍵。在 Macintosh 中,"Alt" 指的是 Option 鍵。

傳回值

表示是否按下按鍵的布林值。

範例

下列程式碼在執行作業前檢查是否同時按下 Shift 和 Control 鍵 (Windows) 或 Shift 和 Command 鍵 (Macintosh):

 if (dw.getKeyState("Shift") && dw.getKeyState("Cmd")){ 
    // execute code 
}

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。

描述

傳回系統字體名稱。

引數

無。

傳回值

包含系統字體名稱的字串。

更快、更輕鬆地獲得協助

新的使用者?