Js-beautify: HTML : proposition d'organisation des paramètres d'enveloppement d'attributs

Extrait du #1297.

Ce que nous avons

wrap_attributes :

• auto - active l'encapsulation des attributs.
• force - le premier attribut reste, les autres enveloppés avec "wrap_attributes_indent_size"
• force-aligned - le premier attribut reste, les autres enveloppés et alignés avec le premier
• force-expand-multiline - S'il y a plus d'un attribut, TOUS les attributs sont enveloppés quoi qu'il arrive et indentés avec "wrap_attributes_indent_size". AND : le '>' de fermeture de la balise d'ouverture se trouve également sur la nouvelle ligne. Ce mode est actuellement cassé, produit des fichiers mal indentés :(

Il existe également de nombreux efforts pour fournir des modes supplémentaires qui traitent de l'habillage d'éléments html longs avec plusieurs attributs : #1285 et #1262.

Je pense qu'il y a plusieurs problèmes (orthogonaux) ici et les mettre tous dans une seule valeur créerait plus de confusion et une explosion des noms d'options étranges si nous voulons gérer tous les cas.

Séparons donc l'habillage, l'alignement et le nombre d'attributs par ligne, etc.

Proposition

wrap_attributes_mode :

• none - Nous n'enveloppons tout simplement pas les attributs, point final. (nécessaire?)
• auto - Emballage d'attribut normal, cela devrait être la valeur par défaut, probablement, comme le cas le plus logique. Quand la ligne est trop grande, on enroule. Si tous les attributs peuvent tenir sur une seule ligne, ils restent sur la même ligne, sans retour à la ligne. (Défaut.)
• force - Nous enveloppons avec force s'il y a plus d'un attribut présent, sinon auto.

Lorsque l'emballage est en action, les propriétés suivantes sont en jeu. Si aucun emballage ne se produit, ils ne jouent aucun rôle.

wrapped_attributes_per_line :

• multiple - Emballage souple, par défaut . Ajustez autant d'attributs par ligne que permis.
• single - Le premier attribut reste sur la première ligne, les autres sont sur des lignes séparées.
• single-all - Tous les attributs, y compris le premier, placés sur des lignes séparées. Ainsi, chaque attribut est sur une ligne distincte et la ligne d'élément/tag n'a plus d'attributs.

wrapped_attributes_indent :

1. auto -- Utilise wrap_attributes_indent_size , par défaut .
2. aligné -- Toutes les lignes d'attribut commencent alignées avec le premier attribut. Si le premier attribut est sur une nouvelle ligne (mode "single-all" de wrapped_attributes_per_line ), alors nous utilisons wrap_attributes_indent_size pour calculer l'indentation.

wrapped_attributes_end :

• auto - par défaut
• multiline - la fermeture > est sur la ligne séparée.

Exemples

1. Cas PAR DÉFAUT : nous encapsulons et essayons d'adapter autant d'attributs par ligne que possible, mais dans la limite de longueur de ligne.

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

1. cas #1285. Très similaire au cas par défaut, mais nous alignons les attributs enveloppés pour qu'ils soient au même niveau d'indentation que le premier attribut.

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

1. cas #1262. Lorsque nous encapsulons, nous voulons un attribut par ligne, aligné avec le premier.

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

1. Cas force-expand-multiline actuel : forcer l'habillage s'il y a plus d'un attribut, avec un attribut par ligne et avec une fin multiligne, en plaçant le > fermeture sur la nouvelle ligne.

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