Динамическая иконка боковой панели

:information_source: Краткое описание Делает значок переключения боковой панели динамичным и настраиваемым
:hammer_and_wrench: Репозиторий https://github.com/Lillinator/dynamic-sidebar-icon
:eyeglasses: Предпросмотр https://discourse.theme-creator.io/theme/Lilly/discourse-sidebar-icon
:question: Руководство по установке Как установить тему или компонент темы

Установить этот компонент темы

:woman_technologist:t2: Обзор

Легковесный компонент темы для Discourse, который динамически меняет значок переключения боковой панели в заголовке в зависимости от того, открыта она или закрыта.

По умолчанию компонент отображает стандартный значок меню «гамбургер» (bars), когда боковая панель закрыта, и переходит к значку крестика (xmark), когда боковая панель открыта.

Администраторы могут указать свои собственные значки, если пожелают, а также выбрать, включить ли их для мобильного просмотра (хотя динамический аспект компонента применяется только к размерам области просмотра, не являющимся мобильными, администраторы, меняющие значок открытия, могут захотеть обеспечить согласованность с пользовательским опытом на мобильных устройствах).


:star: Возможности

  • Дает пользователям четкую визуальную обратную связь о том, как взаимодействовать с боковой панелью.
  • Администраторы могут легко заменить значки по умолчанию на любой значок FontAwesome через настройки темы.
  • Позволяет включить замененный значок боковой панели для мобильной области просмотра ради согласованности пользовательского опыта.

:movie_camera: Видео-скриншоты

Значения по умолчанию компонента:

Использование значков dog и cat:


:wrench: Настройки

Настройте значки, используемые для открытия и закрытия боковой панели, отредактировав настройки компонента:

setting description
Icon_to_open_the_sidebar значок, отображаемый, когда боковая панель свернута
(по умолчанию: bars)
Icon_to_close_the_sidebar значок, отображаемый, когда боковая панель развернута
(по умолчанию: xmark)
Apply_open_icon_on_mobile применить пользовательский значок «открыть» для мобильной области просмотра
(по умолчанию: false)

:warning: Примечания

  • Если используются пользовательские значки, которые еще не включены в ядро Discourse, они будут отображаться пустыми; чтобы исправить это, необходимо добавить пользовательские значки (например, rocket, cat) в настройку сайта SVG icon subset в административных настройках вашего Discourse (см. All Site SettingsSVG icon subset).
  • Этот компонент не работает в режиме выпадающего заголовка.

Посмотрите мои другие проекты для Discourse
14 лайков

Я рефакторировал компонент и добавил новый булевый параметр Применять иконку «открыть» на мобильных устройствах (по умолчанию отключено). Это позволяет администраторам, изменившим иконку «открыть» с иконки по умолчанию bars, включить её отображение на мобильных экранах для обеспечения согласованности UX. Боковая панель-оверлей на мобильных устройствах работает иначе, поэтому иконка не меняется при активации боковой панели на экранах малого размера. Я также обновил исходное сообщение.

5 лайков