Formatar código

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

Formatar código manualmente

  1. Abra um arquivo compatível.

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

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

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

  1. Abra o código.

  2. Selecione o código.

  3. 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.

    Observação:

    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 ao arquivo Arquivo jsbeautifyrc localizado na pasta raiz do seu site.

Para adicionar o arquivo .jsbeautifyrc, siga estas etapas:

Observação:
  • 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.
  1. Crie um arquivo na raiz do site e nomeie-o como .jsbeautifyrc

  2. 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 
     
        } 
     
    }
  3. 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.

Observação:

Se você quiser personalizar a formatação de código para arquivos PHP, CSS e JS em outros sites do Dreamweaver, precisará colocar 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
Observação:

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

Artigos relacionados

Receba ajuda com mais rapidez e facilidade

Novo usuário?