Форматирование кода

Последнее обновление 25 апр. 2024 г.

Задайте предпочтительные настройки, которые можно применять для форматирования кода каждый раз при создании или изменении файла.

Форматирование кода вручную

Откройте поддерживаемый файл.

Выберите Редактировать > Код > Применить исходное форматирование.

Или выберите Apply Source Formatting из Common Toolbar > Format Source Code.

Форматирование выделенного кода в файле вручную

Откройте код.

Выберите любой фрагмент кода.

Выберите Редактировать > Код > Применить исходное форматирование к выделенному.

Или выберите Применить исходное форматирование к выбранному в разделе Общая панель инструментов > Форматировать исходный код.

Примечание

При выделении кода в любом теге и применении исходного форматирования к выделенному фрагменту форматирование применяется к родительскому тегу.

Изменение стандартных правил форматирования кода

Вы можете настроить форматирование кода CSS, JS и PHP, добавив правила форматирования в файл .jsbeautifyrc в корневую папку вашего сайта.

Чтобы добавить файл .jsbeautifyrc , выполните следующие действия:

Примечание
  • Следующие инструкции относятся только к документам CSS, JS и PHP.
  • HTML-теги в документе PHP форматируются в соответствии с установками в библиотеках тегов.  Вы можете форматировать код внутри блоков 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.

Форматирование кода происходит в соответствии с обновленными правилами форматирования.

Примечание

Если вы хотите настроить форматирование кода для PHP-, CSS- и JS-файлов в других сайтах Dreamweaver, необходимо поместить настроенный файл .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, 

пустые строки (N-1) сохраняются при применении форматирования, если в файле JS имеется более N-1 пустых строк.

Примечание. max_preserve_newlines применимо только в том случае, если preserve_newlines имеет значение true.

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' ) при применении форматирования.

Связанные материалы