Total Kontrol/TKT/Стандарт именования изображений: различия между версиями
Admin (обсуждение | вклад) (Новая страница: «Для удобства разработки, редактирования и переноса веб-интерфейсов и их фрагментов все …») |
Admin (обсуждение | вклад) м |
||
(не показано 5 промежуточных версий этого же участника) | |||
Строка 1: | Строка 1: | ||
− | Для удобства разработки, редактирования и переноса веб-интерфейсов и их фрагментов все файлы изображений должны иметь имена в соответствии с данным стандартом. | + | Для удобства разработки, редактирования и переноса веб-интерфейсов и их фрагментов все файлы изображений должны иметь имена в соответствии с данным стандартом. Имя файла должно состоять из ряда человеко-понятных идентификаторов, разделённых точками. Идентификаторы должны быть, с одной стороны, короткими (чтобы не перегружать XML), с другой - имеющими однозначный смысл. Поскольку большинство видимых элементов является кнопками, для них должно присутствовать как минимум 2 изображения: нажатое и отжатое состояние, соответственно, последний идентификатор должен указывать на состояние, представленное данным изображением. Стандартных состояний три: |
+ | *prs - нажато; | ||
+ | *rls - отжато; | ||
+ | *un - недоступно. | ||
− | + | Таким образом, имя изображения для некоей нажатой кнопки должно выглядеть как btn.prs.png. Не запрещается использование любых других имён файлов, но вследствие их большого количества даже в сравнительно простом веб-интерфейсе их бессистемное именование может вызвать путаницу. Кроме того, рекомендуется хранить изображения в интуитивно-понятной иерархии папок. | |
− | + | Рекомендуется следующее дерево папок в папке /img: | |
− | * | + | *back - фоновые изображения; |
− | * | + | *bt - кнопки: |
− | * | + | **kbd - кнопки цифровой клавиатуры; |
− | * | + | **mode - кнопки выбора режима работы конференц-системы; |
+ | **popup - кнопки для всплывающих окон; | ||
+ | **pwr - кнопки управления питанием; | ||
+ | **setup - кнопки, специфические для страницы настроек; | ||
+ | *icn - пиктограммы, отличаются тем что имеют только одно видимое состояние; | ||
+ | *obs - основная тёмная тема "Obsidian", набор пиктограмм в трёх состояниях: | ||
+ | **arr - стрелки навигации; | ||
+ | **fad - изображения для фейдеров; | ||
+ | **surf - пиктограммы, "стоящие" на зеркальной поверхности; | ||
+ | **wht - белые пиктограммы; | ||
+ | *pan - панели, заголовки и т. п.; | ||
+ | *text - текстовые надписи в виде изображений. | ||
− | + | Чтобы не множить количество папок, допускается внутри одной папки группировать изображения первым идентификатором. Например, в стандартном наборе /img/bt/pwr имена файлов кнопок, управляющие освещением, начинаются на "lt": lt.hall.prs.png - нажатое состояние для кнопки, включающей освещение зала. | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− |
Текущая версия на 20:44, 14 августа 2020
Для удобства разработки, редактирования и переноса веб-интерфейсов и их фрагментов все файлы изображений должны иметь имена в соответствии с данным стандартом. Имя файла должно состоять из ряда человеко-понятных идентификаторов, разделённых точками. Идентификаторы должны быть, с одной стороны, короткими (чтобы не перегружать XML), с другой - имеющими однозначный смысл. Поскольку большинство видимых элементов является кнопками, для них должно присутствовать как минимум 2 изображения: нажатое и отжатое состояние, соответственно, последний идентификатор должен указывать на состояние, представленное данным изображением. Стандартных состояний три:
- prs - нажато;
- rls - отжато;
- un - недоступно.
Таким образом, имя изображения для некоей нажатой кнопки должно выглядеть как btn.prs.png. Не запрещается использование любых других имён файлов, но вследствие их большого количества даже в сравнительно простом веб-интерфейсе их бессистемное именование может вызвать путаницу. Кроме того, рекомендуется хранить изображения в интуитивно-понятной иерархии папок.
Рекомендуется следующее дерево папок в папке /img:
- back - фоновые изображения;
- bt - кнопки:
- kbd - кнопки цифровой клавиатуры;
- mode - кнопки выбора режима работы конференц-системы;
- popup - кнопки для всплывающих окон;
- pwr - кнопки управления питанием;
- setup - кнопки, специфические для страницы настроек;
- icn - пиктограммы, отличаются тем что имеют только одно видимое состояние;
- obs - основная тёмная тема "Obsidian", набор пиктограмм в трёх состояниях:
- arr - стрелки навигации;
- fad - изображения для фейдеров;
- surf - пиктограммы, "стоящие" на зеркальной поверхности;
- wht - белые пиктограммы;
- pan - панели, заголовки и т. п.;
- text - текстовые надписи в виде изображений.
Чтобы не множить количество папок, допускается внутри одной папки группировать изображения первым идентификатором. Например, в стандартном наборе /img/bt/pwr имена файлов кнопок, управляющие освещением, начинаются на "lt": lt.hall.prs.png - нажатое состояние для кнопки, включающей освещение зала.