问题现象
设备开启深色模式时,应用的Web页面没有适配,页面背景及字体颜色均毫无变化。
背景知识
Web深色模式适配:ArkWeb提供灵活控制Web组件深色模式的能力,支持独立于系统进行设置。此外,ArkWeb还可以强制不同网页适配深色模式,以兼容不同的系统主题。
问题定位
- 检查Web是否开启深色模式。Web深色模式接口darkMode()默认状态为关闭,需显式声明为WebDarkMode.On或WebDarkMode.Auto,才能开启深色模式。
- Web已开启深色模式时,检查网页是否定义深色样式。网页的深色样式需要网页开发者适配。如果未定义深色样式,即使Web开启深色模式,网页样式也会保持不变。若需强制适配,可以使用forceDarkAccess()接口开启强制深色模式。
- Web已开启强制深色模式时,检查网页是否声明支持深色配色方案。通过color-scheme声明支持深色配色方案的网页,在强制深色模式下色值不会被Web转换。同时,如果网页内元素自定义了颜色样式,则不会被color-scheme影响。因此表现为网页样式未切换为深色样式。此时,需要网页开发者进行适配修改。
分析结论
应用Web页面未显式声明为WebDarkMode.On或WebDarkMode.Auto,或者未通过forceDarkAccess()接口开启强制深色模式。且Web页面未使用color-scheme的CSS属性和prefers-color-scheme媒体查询属性进行深色模式适配。
修改建议
Web页面适配深色模式,官方提供了深色模式/强制深色模式/color-scheme三种方法,具体三种方法的区别及使用方法可参考:Web深色模式适配。