Formatar código

Última atualização em 25/04/2024

Defina preferências que controlam o formato do seu código ao criar ou editar um arquivo.

Formatar código manualmente

Abra um arquivo compatível.

Selecione Editar > Código > Aplicar formatação de origem.

Ou selecione Aplicar formatação de origem em Barra de ferramentas comum > Formatar código-fonte.

Formatar manualmente uma seleção de código em um arquivo

Abra o código.

Selecione qualquer parte do código.

Selecione Editar > Código > Aplicar formatação de origem à seleção.

Ou selecione Aplicar formatação de origem à seleção em Barra de ferramentas comum-> Formatar código de origem.

Nota

Se você selecionar um código entre tags e aplicar a formatação de origem à seleção, a formatação será aplicada até a tag mãe.

Editar regras padrão de formatação de código

Você pode personalizar a formatação de código CSS, JS e PHP adicionando regras de formatação no arquivo .jsbeautifyrc na pasta raiz do site.

Para adicionar o arquivo .jsbeautifyrc , siga estas etapas:

Nota
  • As instruções abaixo são aplicáveis somente a documentos CSS, JS e PHP.
  • As tags HTML em um documento PHP são formatadas de acordo com as preferências nas bibliotecas de tags.  Você pode formatar o código dentro de blocos PHP seguindo as instruções abaixo.

Crie um arquivo na raiz do site e nomeie-o como .jsbeautifyrc

Copie e cole as regras de formatação padrão para CSS, JS e PHP no arquivo .jsbeautifyrc e salve-o.

 

"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

 

    } 

 

}

Edite as regras de formatação de código padrão para alterá-las de acordo com a tabela abaixo e salve as alterações.

Reinicie o Dreamweaver e aplique a formatação de código a um arquivo CSS, JS ou PHP.

O código será formatado de acordo com as regras de formatação atualizadas.

Nota

Para personalizar a formatação de código dos arquivos PHP, CSS e JS em outros sites do Dreamweaver, coloque o arquivo personalizado .jsbeautifyrc na pasta raiz do site.

Regras de formatação CSS, JS e PHP:

CSS Regras Valores padrão no Dreamweaver Descrição
  preserve_newlines false Define se linhas vazias devem ser mantidas.
selector_separator_newline false

Define se uma nova linha deve ser adicionada entre seletores separados por vírgula.

Por exemplo: ".div, .P"

end_with_newline false Define se o arquivo deve terminar em uma linha vazia.
newline_between_rules false Define se uma nova linha deve ser adicionada após cada regra CSS.
space_around_selector_separator true

Adiciona um espaço antes e depois de separadores de um seletor:  ' >',' +',' ~'

Por exemplo: “a>b” viraria “a > b” ao aplicar a formatação de origem.

JS Regras Valores padrão no Dreamweaver Descrição
  "eol" "\n" Caractere usado para representar o fim de uma linha.
preserve_newlines true Define se linhas vazias devem ser mantidas.
max_preserve_newlines 3

Em "max_preserve_newlines": N, 

Linhas vazias N-1 serão mantidas quando a formatação for aplicada caso mais de uma linha vazia N-1 esteja presente no arquivo JS.

Observação: max_preserve_newlines só será aplicável se a regra preserve_newlines estiver definida como true.

space_after_anon_function true

Define se um espaço deve ser adicionado antes do parêntese de uma função anônima.

Por exemplo:“function()” viraria “function ()” ao aplicar a formatação de origem.

keep_array_indentation false Permite ou mantém uma nova linha dentro do corpo da matriz.
space_before_conditional true

Define se um espaço deve ser adicionado antes de uma instrução condicional.

Por exemplo: “if(true)” viraria “if (true)” ao aplicar a formatação.

break_chained_methods false

Permite ou mantém uma nova linha entre funções encadeadas.

Por exemplo:

`foobar().baz()`

unescape_strings false

Faz com que caracteres imprimíveis em linhas codificadas na notação \xNN sejam decodificados.

Por exemplo:

“\x65\x78\x61\x6d\x70\x6c\x65” viraria “exemplo” ao aplicar a formatação de origem.

wrap_line_length 0 As linhas devem ser quebradas assim que atingirem esse número de caracteres.
end_with_newline true

Adiciona uma nova linha no fim do arquivo.

comma_first false Ao quebrar uma linha em uma vírgula, esse sinalizador é usado para que a vírgula seja o primeiro caractere da linha.
operator_position after-newline

Quando uma expressão condicional longa é quebrada em várias linhas, esse sinalizador é usado para definir a posição dos operadores nas linhas.

Você pode editar o sinalizador com os valores abaixo:

  • before-newline
  • after-newline
  • preserve-newline
Nota

As regras de formatação PHP são as mesmas da formatação JS (descritas na tabela acima), com duas regras adicionais abaixo:

PHP Regras Valores padrão no Dreamweaver Descrição
  brace_style collapse

Você pode controlar a posição das chaves com essa opção.

Por exemplo:

function f() {

// code

}

ou 

function f()

{

// Code

}

Você pode atribuir os seguintes valores:

  • “collapse” - coloca as chaves na mesma linha que as instruções de controle
  • “expand” - coloca as chaves em uma linha própria (estilo Allman/ANSI)
  • “end-expand” - coloca as chaves do final da linha em uma linha própria
  • “none” - tenta manter as chaves no lugar
  • qualquer um dos anteriores + “,preserve-inline” - o valor preserve-inline tenta manter blocos alinhados de chaves
space_in_paren true

Define se espaços devem ser adicionados entre parênteses.

Por exemplo:

include('header.php')

viraria

include( 'header.php' ) ao aplicar a formatação