格式化程式碼

上次更新時間 2024年4月25日

每當您建立或編輯檔案時,設定可控制您的程式碼格式的偏好設定。

手動格式化程式碼

開啟支援的檔案。

選取「編輯 > 命令 > 套用原始碼格式」。

或者,選取 套用來源格式 (位於 通用工具列 > 格式化來源代碼)。

以手動方式格式化在檔案內選取的程式碼

開啟程式碼。

選取程式碼的任一部分。

選取「編輯> 程式碼 > 套用原始碼格式到選取範圍」。

或者,從「常用工具列 > 格式原始碼」中選取「套用原始碼格式到選取範圍」。

備註

如果您選取任何標籤之間的程式碼,並且將原始碼格式套用到選取範圍,則整個上層標籤內都會套用該格式。

編輯程式碼格式化的預設規則

您可以在網站根資料夾中新增 .jsbeautifyrc 檔案的格式化規則,以自訂 CSS、JS 和 PHP 程式碼格式化。

若要新增 .jsbeautifyrc 檔案,請依照下列步驟進行:

備註
  • 下列指示僅適用於 CSS、JS 和 PHP 文件。
  • PHP 文件內的 HTML 標籤是依照標籤資料庫內的各偏好設定進行格式化。  您可以依照下列指示將 PHP 區塊內的程式碼格式化。

在網站的根目錄內,建立一個名稱為 .jsbeautifyrc 的新檔案

複製下列 CSS、JS 和 PHP 的預設格式化規則,並貼至 .jsbeautifyrc 內,然後儲存檔案。

"js": {

"eol": "\n",

"preserve_newlines": true,

"max_preserve_newlines": 3,

"space_after_anon_function": true,

"keep_array_indentation": false,

"space_before_conditional": true,

"break_chained_methods": false,

"unescape_strings": false,

"wrap_line_length": 0,

"end_with_newline": true,

"comma_first": false,

"operator_position": "after-newline"

    }, 

"css": {

"preserve_newlines": false,

"selector_separator_newline" : false,

"end_with_newline": false,

"newline_between_rules": false,

"space_around_selector_separator": true

    }, 

"php": {

"eol": "\n",

"preserve_newlines": true,

"max_preserve_newlines": 3,

"space_after_anon_function": true,

"brace_style": "收合",

"keep_array_indentation": false,

"space_before_conditional": true,

"break_chained_methods": false,

"unescape_strings": false,

"wrap_line_length": 0,

"end_with_newline": false,

"comma_first": 假,

"space_in_paren":真

    } 

}

編輯預設規則,依照下表所示變更預設程式碼格式化規則,然後儲存變更。

重新啟動 Dreamweaver,然後套用 CSS、JS 和 PHP 檔案的程式碼格式。

程式碼就會依照更新的格式化規則進行格式化。

備註

如果您想要自訂其他 Dreamweaver 地點中 PHP、CSS 和 JS 檔案的程式碼格式設定,則需要將自訂檔案 .jsbeautifyrc 置於地點根檔案夾中。

CSS、JS 和 PHP 格式化的規則:

CSS 規則 Dreamweaver 中的預設值 說明
  preserve_newlines False 是否要保留空白的行。
selector_separator_newline False

是否要在逗號分隔的選取器之間插入新行。

例如:".div, .P"

end_with_newline False 是否要以空白的行結束檔案。
newline_between_rules False 是否要在每一個 CSS 規則後方增加新行。
space_around_selector_separator True

確保選擇器分格符號周圍的空格:'>'、'+'、'~'

例如:套用的原始碼格式中的 "a>b" 會變成 "a > b"。

JS 規則 Dreamweaver 中的預設值 說明
  "eol" "\n" 用來表示行結束的字元。
preserve_newlines True 是否要保留空白的行。
max_preserve_newlines 3

對 "max_preserve_newlines": N 來說, 

如果 JS 檔案內有 N-1 個空白的行,在套用格式化時,就會保留 N-1 個空白的行。

注意:只有在 preserve_newlines 設定為 true 時,max_preserve_newlines 才可套用。

space_after_anon_function True

是否要在某一匿名函式的括號前方加入空格。

例如:套用的原始碼格式中的 "function()" 會變成 "function ()"。

keep_array_indentation False 允許或保留陣列內文中的新行。
space_before_conditional True

是否要在條件陳述式前方增加一個空格

例如:套用的原始碼格式中的 "if(true)" 會變成 "if (true)"。

break_chained_methods False

允許或保留鏈結的函式之間的新行。

例如:

`foobar().baz()`

unescape_strings False

\xNN 標記法編碼的字串內的可列印字元是否應逸出。

例如:

"\x65\x78\x61\x6d\x70\x6c\x65" 會變成套用的原始碼格式的 "example"。

wrap_line_length 0 在這些字元數之後,在下一次可換行時換行。
end_with_newline True

確保在檔案的末端加入新行。

comma_first False 以逗號分隔行時,使用這個標幟確保行的第一個字元是逗號。
operator_position after-newline

如果某一個較長的條件運算式分隔成多行,使用這個標幟來定義運算子在行內的位置。

您可以使用下列值來編輯這個標幟:

  • before-newline
  • after-newline
  • preserve-newline
備註

PHP 格式化的規則和 JS 格式化的規則 (如上表所述) 一樣,但多了下列兩個規則:

PHP 規則 Dreamweaver 中的預設值 說明
  brace_style collapse

您可以使用本選項控制大括號:

例如:

function f() {

// 程式碼

}

或是 

function f()

{

// 程式碼

}

您可以指定下列值:

  • "collapse" - 在同一行內放入大括號作為控制項陳述式
  • "expand" - 將大括號放在獨立的一行 (Allman / ANSI 樣式)
  • "end-expand" - 將右大括號放在獨立的一行
  • "none" - 嘗試將其保持在原來的位置
  • 任何之前的 + ",preserve-inline"- 試著保留大括號的內嵌區塊
space_in_paren True

是否要在括號內增加空格。

例如:

套用格式化時,include('header.php')

會變成

include( 'header.php' )

更多類似主題