推荐使用[data-theme]选择器实现组件级主题控制：样式写在组件CSS内，用属性选择器限定作用域；组件根元素显式设置data-theme以确保自治；配合局部CSS变量提升可维护性；JS仅修改目标元素的data-theme。

直接用 [data-theme] 选择器就能精准控制组件主题，不需要全局切换或 JS 手动改 class。

组件内样式用 [data-theme="dark"] 隔离

避免写在全局 :root 或 body 上，把主题相关样式直接写在组件 CSS 里，用属性选择器限定作用域：

• ✅ 正确（推荐）： .card { background: white; } [data-theme="dark"] .card { background: #1e1e1e; }
• ❌ 错误（易污染）： :root[data-theme="dark"] { --bg: #1e1e1e; } —— 这会影响所有用该变量的组件

避免继承干扰，给组件根元素加 data-theme

如果父容器主题和组件需求不一致（比如页面是 dark，但某个卡片必须 light），就不要依赖祖先的 data-theme。给组件自身根元素显式设置：

• <div class="card" data-theme="light">... <li>对应样式：<code>[data-theme="light"] .card { background: #fff; color: #333; }
• 这样组件完全自治，不受外层 theme 影响

配合 CSS 自定义属性，提升可维护性

在组件内部用局部自定义属性，再用 [data-theme] 分别赋值：


arcgis-js
提供 ArcGIS Maps SDK for JavaScript 开发辅助，涵盖 2D/3D 地图视图、图层管理、数据可视化、空间分析等功能模块的参考和示例指导。
下载

立即学习“前端免费学习笔记（深入）”；

• .button { --btn-bg: var(--primary-bg, #007bff); background: var(--btn-bg); }
• [data-theme="dark"] .button { --btn-bg: #0056b3; }
• [data-theme="light"] .button { --btn-bg: #007bff; }

变量只在 .button 内生效，改一处，整个组件响应更新。

JS 切换时，只改目标元素的 data-theme

不要操作 document.body，而是按需更新具体组件：

• document.querySelector('.user-profile').dataset.theme = 'high-contrast';
• 配合 CSS：[data-theme="high-contrast"] .user-profile { outline: 3px solid #ff0; }
• 多个组件可各自独立切换，互不干扰

基本上就这些。核心是放弃“全局主题”的思维，把 data-theme 当作组件的本地状态来用。