Js-beautify: HTML: propuesta para organizar la configuración de ajuste de atributos

Extraído de #1297.

Que tenemos

wrap_attributes :

• auto - habilita el ajuste de atributos.
• force : el primer atributo permanece, los demás se envuelven con "wrap_attributes_indent_size"
• force-aligned - el primer atributo permanece, otros envueltos y alineados con el primero
• force-expand-multiline : si hay más de 1 atributo, TODOS los atributos se envuelven sin importar qué y se sangran con "wrap_attributes_indent_size". Y: el cierre '>' de la etiqueta de apertura también está en la nueva línea. Este modo está actualmente roto, produce archivos mal sangrados :(

También hay múltiples esfuerzos para proporcionar algunos modos adicionales que se ocupan de la envoltura de elementos html largos con múltiples atributos: #1285 y #1262.

Creo que hay múltiples preocupaciones (ortogonales) aquí y ponerlas todas en un solo valor crearía más confusión y una explosión de nombres de opciones extraños si vamos a manejar todos los casos.

Entonces, separemos el ajuste, la alineación y la cantidad de atributos por línea, etc.

Propuesta

wrap_attributes_mode :

• none : simplemente no envolvemos los atributos, punto. (¿necesario?)
• auto - Ajuste de atributo normal, este debería ser el predeterminado, probablemente, como el caso más lógico. Cuando la línea es demasiado grande, envolvemos. Si todos los atributos pueden caber en una sola línea, permanecen en la misma línea, sin envolver. (Por defecto.)
• force - Envolvemos a la fuerza si hay más de 1 atributo presente, de lo contrario, automático.

Cuando el envoltorio está en acción, las siguientes propiedades están en juego. Si no se envuelve, no juegan ningún papel.

wrapped_attributes_per_line :

• multiple - Envoltura blanda, por defecto . Ajuste tantos atributos por línea como sea posible.
• single - El primer atributo permanece en la primera línea, los demás están en líneas separadas.
• single-all - Todos los atributos, incluido el primero, colocados en líneas separadas. Por lo tanto, cada atributo está en una línea separada y al elemento/etiqueta no le quedan atributos.

wrapped_attributes_indent :

1. auto -- Usa wrap_attributes_indent_size , por defecto .
2. alineado: todas las líneas de atributo comienzan alineadas con el primer atributo. Si el primer atributo está en una nueva línea (modo "único-todo" de wrapped_attributes_per_line ), entonces usamos wrap_attributes_indent_size para calcular la sangría.

wrapped_attributes_end :

• auto - predeterminado
• multiline - el cierre > está en la línea separada.

Ejemplos

1. Caso PREDETERMINADO: ajustamos suavemente e intentamos ajustar tantos atributos por línea como sea posible, pero dentro del límite de longitud de línea.

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

1. Caso #1285. Muy similar al caso predeterminado, pero alineamos los atributos envueltos para que estén en el mismo nivel de sangría que el primer atributo.

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

1. Caso #1262. Cuando ajustamos, queremos un atributo por línea, alineado con el primero.

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

1. Caso actual force-expand-multiline : fuerce el ajuste si hay más de 1 atributo, con un atributo por línea y con un final de varias líneas, colocando el cierre > en la nueva línea.

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