颜色方案支持
...也称为“暗黑模式”。
Joomla 模板提供了一个 API 来支持深色/浅色颜色方案,可以通过自定义开关或通过 CSS 媒体查询自动更改。
当颜色方案更改(无论是自动还是通过自定义开关)时,模板应该将适当的值设置为 data-color-scheme
属性,以帮助扩展(如编辑器插件)加载相应的深色/浅色主题。此外,应该触发 joomla:color-scheme-change
事件。
文档属性
在提供颜色方案切换功能的模板中,应该在 <html>
元素中使用以下数据属性
data-color-scheme-os
当模板遵循 **操作系统** 设置并通过 CSS 媒体查询自动更改颜色方案时,应设置此属性。data-color-scheme="light"
当模板使用 **浅色** 颜色方案时,无论是自动还是通过自定义开关更改的。data-color-scheme="dark"
当模板使用 **深色** 颜色方案时,无论是自动还是通过自定义开关更改的。
JavaScript 事件
当方案更改时,模板应该触发一个自定义事件 joomla:color-scheme-change
,以通知颜色方案更改(无论是自动还是通过自定义开关更改的)。
document.documentElement.dataset.colorScheme = 'dark';
document.dispatchEvent(new CustomEvent('joomla:color-scheme-change', { bubbles: true }));