跳到主要内容
版本:5.1

颜色方案支持

...也称为“暗黑模式”。

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 }));