设置代码格式

上次更新日期: 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": "collapse",

"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": false,

"space_in_paren":true

    } 

}

编辑默认规则,以按照下表更改默认代码格式设置规则,并保存更改。

重新启动 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”在应用源格式时将变成“示例”。

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 折叠

您可以使用此选项控制大括号位置:

例如:

function f() {

// 代码

}

或者 

function f()

{

// 代码

}

您可以分配以下值:

  • "collapse" — 将大括号放在控制语句所在行
  • "expand" — 将大括号放在单独一行中(Allman/ANSI 样式)
  • "end-expand" — 将结束大括号放在单独一行中
  • "none" — 尝试将其保留在原位置
  • 任何之前的 + ",preserve-inline"- preserve-inline 尝试保留大括号的内联块
space_in_paren true

是否在圆括号内添加空格。

例如:

包含 ('header.php')

在应用格式设置时,将变成

包含 ( 'header.php' )

更多此类内容