Js-beautify: HTML: Предложение по организации настроек переноса атрибутов

Извлечено из № 1297.

Что мы имеем

wrap_attributes :

• auto - включает перенос атрибутов.
• force - первый атрибут остается, остальные завернуты в "wrap_attributes_indent_size"
• force-aligned - первый атрибут остается, остальные завернуты и выровнены с первым
• force-expand-multiline - Если имеется более 1 атрибута, ВСЕ атрибуты, несмотря ни на что, переносятся с отступом "wrap_attributes_indent_size". И: закрывающий '>' открывающего тега также находится на новой строке. Этот режим в настоящее время не работает, создает файлы с неправильным отступом :(

Также предпринимаются многочисленные попытки предоставить некоторые дополнительные режимы, которые имеют дело с переносом длинных html-элементов с несколькими атрибутами: #1285 и #1262.

Я думаю, что здесь есть несколько (ортогональных) проблем, и объединение их всех в одно значение приведет к еще большей путанице и взрыву странных имен опций, если мы хотим обрабатывать все случаи.

Итак, давайте разделим обтекание, выравнивание и количество атрибутов в строке и т.д.

Предложение

wrap_attributes_mode :

• none — мы просто не переносим атрибуты, и точка. (нужный?)
• auto - Нормальная упаковка атрибутов, это должно быть по умолчанию, наверное, как наиболее логичный случай. Когда линия слишком большая, мы заворачиваем. Если все атрибуты помещаются в одну строку, они остаются на одной строке, без переноса. (По умолчанию.)
• force — Мы принудительно переносим, ​​если присутствует более 1 атрибута, в противном случае автоматически.

Когда оболочка работает, в игру вступают следующие свойства. Если обертывания не происходит, они не играют никакой роли.

wrapped_attributes_per_line :

• multiple — Мягкая упаковка, по умолчанию . Поместите столько атрибутов в строку, сколько разрешено.
• single — первый атрибут остается в первой строке, остальные — в отдельных строках.
• single-all - Все атрибуты, включая первый, вынесены на отдельные строки. Таким образом, каждый атрибут находится на отдельной строке, а в строке элемента/тега атрибутов не осталось.

wrapped_attributes_indent :

1. auto -- использует wrap_attributes_indent_size , по умолчанию .
2. выровнены -- все строки атрибутов начинаются с первого атрибута. Если первый атрибут находится на новой строке (режим «один-все» wrapped_attributes_per_line ), то мы используем wrap_attributes_indent_size для вычисления отступа.

wrapped_attributes_end :

• auto — по умолчанию
• multiline - закрывающий > на отдельной строке.

Примеры

1. Случай ПО УМОЛЧАНИЮ: мы делаем мягкий перенос и пытаемся разместить как можно больше атрибутов в строке, но в пределах ограничения длины строки.

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

1. Дело №1285. Очень похоже на случай по умолчанию, но мы выравниваем обернутые атрибуты так, чтобы они находились на том же уровне отступа, что и первый атрибут.

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

1. Дело №1262. Когда мы переносим, ​​нам нужен один атрибут в строке, выровненный с первым.

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

1. Текущий случай force-expand-multiline : принудительный перенос, если имеется более 1 атрибута, с одним атрибутом в строке и с многострочным окончанием, с размещением закрывающего > на новой строке.

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