Js-beautify: HTML: اقتراح لتنظيم إعدادات التفاف السمات

مستخرج من # 1297.

ما لدينا

wrap_attributes :

• auto - يتيح التفاف السمات.
• force - السمة الأولى تبقى ، والبعض الآخر ملفوف بـ "wrap_attributes_indent_size"
• force-aligned - تبقى السمة الأولى ، والبعض الآخر ملفوف ومحاذاة للسمة الأولى
• force-expand-multiline - إذا كان هناك أكثر من سمة واحدة ، يتم تغليف جميع السمات بغض النظر عن ما يتم وضعه بمسافة بادئة بـ "wrap_attributes_indent_size". AND: إغلاق العلامة الافتتاحية موجود أيضًا في السطر الجديد. هذا الوضع معطل حاليًا ، ينتج ملفات ذات مسافة بادئة خاطئة :(

هناك أيضًا جهود متعددة لتوفير بعض الأوضاع الإضافية التي تتعامل مع التفاف عناصر html الطويلة بسمات متعددة: # 1285 و # 1262.

أعتقد أن هناك مخاوف متعددة (متعامدة) هنا ووضعها جميعًا في قيمة واحدة من شأنه أن يخلق مزيدًا من الارتباك وانفجار أسماء الخيارات الغريبة إذا أردنا التعامل مع جميع الحالات.

لذلك ، دعنا نفصل الالتفاف والمحاذاة وعدد السمات في كل سطر ، إلخ.

عرض

wrap_attributes_mode :

• none - نحن فقط لا نلف السمات ، الفترة. (ضروري؟)
• auto - التفاف السمة العادي ، يجب أن يكون هذا هو الافتراضي ، على الأرجح ، باعتباره الحالة الأكثر منطقية. عندما يكون الخط كبيرًا جدًا ، نلتف. إذا كان من الممكن احتواء جميع السمات في سطر واحد ، فإنها تظل في سطر واحد ، بدون التفاف. (تقصير.)
• force - نحن نلتف بقوة إذا كان هناك أكثر من سمة واحدة موجودة ، وإلا فهي تلقائية.

عندما يكون الالتفاف قيد التشغيل ، يتم تشغيل الخصائص التالية. إذا لم يحدث التفاف ، فلن يلعبوا أي دور.

wrapped_attributes_per_line :

• multiple - التفاف ناعم ، افتراضي . احتواء العديد من Attrs لكل سطر كما هو مسموح به.
• 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 : فرض الالتفاف إذا كان هناك أكثر من سمة واحدة ، مع سمة واحدة في كل سطر ، وبنهاية متعددة الأسطر ، ووضع الإغلاق > على السطر الجديد.

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