Js-beautify: HTML: Proposta para organizar as configurações de encapsulamento de atributos

Extraído de #1297.

O que nós temos

wrap_attributes :

• auto - habilita o agrupamento de atributos.
• force - o primeiro atributo permanece, outros agrupados com "wrap_attributes_indent_size"
• force-aligned - o primeiro atributo fica, os outros são agrupados e alinhados com o primeiro
• force-expand-multiline - Se houver mais de 1 atributo, TODOS os atributos são encapsulados, não importa o que seja, e recuados com "wrap_attributes_indent_size". E: o fechamento '>' da tag de abertura também está na nova linha. Este modo está atualmente quebrado, produz arquivos indentados incorretamente :(

Há também vários esforços para fornecer alguns modos adicionais que lidam com o encapsulamento de elementos html longos com vários atributos: #1285 e #1262.

Eu acho que existem várias preocupações (ortogonais) aqui e colocá-las todas em um único valor criaria mais confusão e explosão de nomes de opções estranhas se quisermos lidar com todos os casos.

Então, vamos separar quebra, alinhamento e número de atributos por linha, etc.

Proposta

wrap_attributes_mode :

• none - Nós simplesmente não agrupamos atributos, ponto final. (necessário?)
• auto - Encapsulamento de atributo normal, este deve ser o padrão, provavelmente, como o caso mais lógico. Quando a linha é muito grande, nós embrulhamos. Se todos os atributos puderem caber em uma única linha, eles permanecerão em uma única linha, sem quebra. (Predefinição.)
• force - Envolvemos com força se houver mais de 1 atributo presente, caso contrário, auto.

Quando o encapsulamento está em ação, as seguintes propriedades estão em jogo. Se nenhum embrulho acontecer, eles não desempenham nenhum papel.

wrapped_attributes_per_line :

• multiple - Embalagem suave, padrão . Ajuste quantos attrs por linha forem permitidos.
• single - O primeiro atributo fica na primeira linha, os outros ficam em linhas separadas.
• single-all - Todos os atributos, incluindo o primeiro, colocados em linhas separadas. Assim, cada atributo está em uma linha separada, e o elemento/tag line não tem atributos restantes.

wrapped_attributes_indent :

1. auto -- Usa wrap_attributes_indent_size , default .
2. alinhado -- Todas as linhas de atributo começam alinhadas com o primeiro atributo. Se o primeiro atributo estiver em uma nova linha (modo "single-all" de wrapped_attributes_per_line ), então usamos wrap_attributes_indent_size para calcular o recuo.

wrapped_attributes_end :

• auto - padrão
• multiline - o > fechamento está na linha separada.

Exemplos

1. Caso DEFAULT: Nós fazemos um soft wrap e tentamos ajustar o maior número possível de atributos por linha, mas dentro do limite de comprimento de linha.

wrap_attributes_mode = auto
wrapped_attributes_per_line = multiple
wrapped_attributes_indent = auto
wrapped_attributes_end = auto

1. caso #1285. Muito semelhante ao caso padrão, mas alinhamos os atributos encapsulados para estarem no mesmo nível de recuo do primeiro atributo.

wrap_attributes_mode = auto
wrapped_attributes_per_line = multiple
wrapped_attributes_indent = aligned
wrapped_attributes_end = auto

1. caso #1262. Quando quebramos, queremos um atributo por linha, alinhado com o primeiro.

wrap_attributes_mode = auto
wrapped_attributes_per_line = single
wrapped_attributes_indent = aligned
wrapped_attributes_end = auto

1. Caso force-expand-multiline atual: Força a quebra se houver mais de 1 atributo, com um atributo por linha e com finalização de várias linhas, colocando o > fechamento na nova linha.

wrap_attributes_mode = force
wrapped_attributes_per_line = single-all
wrapped_attributes_indent = auto
wrapped_attributes_end = multiline