本文详细介绍了如何在swift应用中，为wkwebview加载的动态html内容实现文本和背景色的自动适应亮/暗模式。核心解决方案是利用css的`@media (prefers-color-scheme)`查询，在html内容内部定义不同主题下的颜色变量，从而无需修改swift代码即可响应系统主题变化，确保文本在任何模式下都保持清晰可读。
WKWebView中动态HTML内容主题适配的挑战
在iOS应用开发中，当使用WKWebView加载来自服务器的动态HTML字符串时，开发者常常面临一个挑战：如何使这些HTML内容的显示效果（特别是文本和背景颜色）能够自动适应iOS系统的亮色（Light Mode）和暗色（Dark Mode）主题。虽然WKWebView的背景色可能可以通过Swift代码进行调整，但HTML内容内部的文本颜色却往往难以直接通过原生代码控制，导致在暗色模式下文本依然显示为黑色，影响用户体验。
问题的核心在于，WKWebView作为一个内嵌的浏览器引擎，其渲染的HTML内容默认行为由HTML和CSS定义。如果HTML内容本身没有包含对主题变化的响应逻辑，那么无论原生应用如何切换主题，HTML的显示效果都不会改变。
解决方案：利用CSS媒体查询实现主题自适应
解决这一问题的最佳实践是利用CSS的@media (prefers-color-scheme)媒体查询。这个CSS特性允许网页内容根据用户的系统主题偏好（亮色或暗色）应用不同的样式。通过在加载的HTML字符串中嵌入相应的CSS样式，我们可以让WKWebView自动处理文本和背景色的切换，而无需在Swift代码中进行任何额外的主题判断或样式注入。
核心CSS代码
以下是实现亮/暗模式文本和背景色切换的核心CSS代码：
立即学习“前端免费学习笔记（深入）”；
@media (prefers-color-scheme: light) { /* 亮色模式 */
:root {
--scheme-black-color: #000000; /* 定义亮色模式下的“黑色” */
--scheme-white-color: #ffffff; /* 定义亮色模式下的“白色” */
}
}
@media (prefers-color-scheme: dark) { /* 暗色模式 */
:root {
--scheme-black-color: #ffffff; /* 定义暗色模式下的“黑色”（反转为白色） */
--scheme-white-color: #000000; /* 定义暗色模式下的“白色”（反转为黑色） */
}
}
body {
color: var(--scheme-black-color); /* 将文本颜色设置为根据主题定义的“黑色” */
background-color: var(--scheme-white-color); /* 将背景颜色设置为根据主题定义的“白色” */
}CSS代码解析
@media (prefers-color-scheme: light) 和 @media (prefers-color-scheme: dark): 这两个媒体查询分别针对用户的系统偏好主题。当系统设置为亮色模式时，light块内的样式会生效；当系统设置为暗色模式时，dark块内的样式会生效。
-
:root 选择器与CSS变量: :root 选择器代表文档的根元素（在HTML中通常是<html>）。在这里，我们定义了两个CSS自定义属性（也称为CSS变量）：--scheme-black-color 和 --scheme-white-color。
- 在亮色模式下，--scheme-black-color 被设置为纯黑色（#000000），--scheme-white-color 被设置为纯白色（#ffffff）。
- 在暗色模式下，这些变量的值被反转：--scheme-black-color 变为白色（#ffffff），--scheme-white-color 变为黑色（#000000）。 通过这种方式，我们创建了两个“语义化”的颜色变量，它们的值会根据系统主题自动调整。
body 样式: body 元素的 color 属性（用于设置文本颜色）被设置为 var(--scheme-black-color)。这意味着在亮色模式下，文本将是黑色；在暗色模式下，文本将是白色。 background-color 属性被设置为 var(--scheme-white-color)。这意味着在亮色模式下，背景将是白色；在暗色模式下，背景将是黑色。
在Swift中集成
将上述CSS样式集成到WKWebView加载的HTML字符串中非常简单。您只需确保在服务器返回的HTML内容中包含这段CSS代码，或者在Swift代码中将这段CSS动态地插入到HTML字符串的<head>标签内。
例如，如果您的HTML字符串是contentData，您可以这样构建最终的HTML：
func displayData() {
if let contentData = self.response?.data?.content {
// 构建包含CSS的完整HTML字符串
let fullHTML = """
<html>
<head>
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<style>
@media (prefers-color-scheme: light) {
:root {
--scheme-black-color: #000000;
--scheme-white-color: #ffffff;
}
}
@media (prefers-color-scheme: dark) {
:root {
--scheme-black-color: #ffffff;
--scheme-white-color: #000000;
}
}
body {
color: var(--scheme-black-color);
background-color: var(--scheme-white-color);
}
</style>
</head>
<body>
\(contentData)
</body>
</html>
"""
do {
self.webView.loadHTMLString(fullHTML, baseURL: nil)
} catch {
print("加载HTML失败: \(error)")
}
}
}重要提示： 一旦HTML内容中包含了上述CSS，您在Swift代码中就不需要对WKWebView的背景色或任何与主题相关的样式进行额外操作。WKWebView底层的WebKit引擎会自动检测系统主题偏好，并应用相应的CSS规则。
总结
通过利用CSS的@media (prefers-color-scheme)媒体查询和CSS自定义属性，我们可以优雅地解决WKWebView中动态HTML内容在亮/暗模式下的主题适配问题。这种方法将主题逻辑封装在HTML/CSS层，使得原生Swift代码保持简洁，专注于数据加载和WKWebView的生命周期管理。这种分离关注点的方式不仅提高了代码的可维护性，也确保了网页内容在不同系统主题下都能提供一致且舒适的用户体验。
