Property Naming

Описание принципов и правил наименования свойств компонентов

Специальные символы

При наименовании используются следующие символы:

□

Boolean property

◆

Componet variant

◇

Instance swap property

"ㅤ"

Пространство для создания визуальной иерархии

𝐓

Text property

Принципы

• Названия свойств должны максимально совпадать со свойствами разработчиков.

• Вложенные / зависимые свойства должны начинаться с "ㅤ" и последующего "пробела".

Пример:

С зависимостью

□ boolean property object ㅤ◇ swap instance

Оба свойства относятся к одному объекту

Без зависимости

□ boolean property object ◇ swap instance

Оба свойства относятся к разным объектам

• Наименование boolean property должно совпадать с instance swap

Общепринятые названия

• State:

  • Default

  • Hover

  • Active / Pressed

  • Disabled

• Disabled. Дополнительно делается отдельным свойством через тогл. Содержится в свойстве State

• Size

• Status / Appearance:

  • Brand

  • Neutral

  • Success

  • Warning

  • Danger

• *Align* Slot

• Icon *Number* / Icon *Align*

• NgContent

• Clear Button

• Label

• Placeholder

• Required

• Value

Рекомендации и особенности

• При соблюдении идентичности свойств в экземплярах заменяемых компонентов — состояния будут сохраняться. Пример: При замене Устаревшей версии кнопок в макетах на Новую.