Total Kontrol/TKT/Стандарт именования изображений: различия между версиями
Admin (обсуждение | вклад) |
Admin (обсуждение | вклад) м |
||
Строка 18: | Строка 18: | ||
**arr - стрелки навигации; | **arr - стрелки навигации; | ||
**fad - изображения для фейдеров; | **fad - изображения для фейдеров; | ||
− | **surf - пиктограммы, "стоящие" зеркальной поверхности; | + | **surf - пиктограммы, "стоящие" на зеркальной поверхности; |
**wht - белые пиктограммы; | **wht - белые пиктограммы; | ||
*pan - панели, заголовки и т. п.; | *pan - панели, заголовки и т. п.; |
Текущая версия на 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 - нажатое состояние для кнопки, включающей освещение зала.