Total Kontrol/TKT/Стандарт именования изображений: различия между версиями

Материал из KONANlabs
Перейти к: навигация, поиск
м
 
Строка 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 - нажатое состояние для кнопки, включающей освещение зала.