本文旨在解决 JavaScript 中操作元素显示与隐藏时，内联样式与内部/外部 CSS 样式表现不一致的问题。通过分析原因，提出了使用 CSS 类切换的方法，避免直接操作元素的 style 属性，从而实现更稳定、更可维护的样式控制。同时，介绍了 HTML5 的 <details> 元素，作为更语义化的解决方案。
在 Web 开发中，经常需要使用 JavaScript 来动态地改变元素的显示状态。一种常见的做法是通过修改元素的 style.display 属性来实现显示与隐藏的切换。然而，直接操作 style 属性可能会导致一些意想不到的问题，尤其是在混合使用内联样式和内部/外部 CSS 样式时。本文将深入探讨这个问题，并提供一种更优雅的解决方案。
问题根源：JavaScript 读取 style 属性的机制
问题的核心在于 JavaScript 的 element.style.display 属性只反映了元素的内联样式。当元素没有设置内联样式时，该属性返回空字符串 ""，而不是 CSS 规则中定义的 display 值。
例如，以下 HTML 代码：
立即学习“前端免费学习笔记（深入）”；
<html>
<head>
<style>
.content {
display: none;
}
</style>
<script>
function showHide(element) {
sibling = element.nextElementSibling;
if (sibling.style.display == "none")
sibling.style.display = "block"
else sibling.style.display = "none";
}
</script>
</head>
<body>
<h1 onclick="showHide(this)">Foo</h1>
<div class="content">
Foo Content
</div>
<h1 onclick="showHide(this)">Bar</h1>
<div style="display: none;">
Bar Content
</div>
</body>
</html>在上面的例子中，Foo Content 的 display 属性通过 CSS 类 .content 设置为 none，而 Bar Content 的 display 属性通过内联样式设置为 none。当点击 Foo 标题时，sibling.style.display 返回空字符串 ""，导致 if 条件判断失败，Foo Content 无法正确显示。而点击 Bar 标题时，sibling.style.display 返回 "none"，Bar Content 可以正常切换显示状态。
解决方案：使用 CSS 类切换
为了避免直接操作内联样式带来的问题，更推荐的做法是使用 CSS 类切换。这种方法将样式控制与 JavaScript 代码分离，提高了代码的可维护性和可读性。
具体步骤如下：
- 定义一个 CSS 类，用于控制元素的显示与隐藏。例如：
.content-hidden {
display: none;
}- 使用 JavaScript 的 classList.toggle() 方法来切换元素的 CSS 类。
function showHide(element) {
const sibling = element.nextElementSibling;
sibling.classList.toggle("content-hidden");
}- 在 HTML 中，将需要隐藏的元素添加该 CSS 类。
<h1 onclick="showHide(this)">Foo</h1>
<div class="content-hidden">
Foo Content
</div>
<h1 onclick="showHide(this)">Bar</h1>
<div class="content-hidden">
Bar Content
</div>通过这种方式，无论元素的初始 display 属性是通过 CSS 类还是内联样式设置的，都可以通过 classList.toggle() 方法来正确切换其显示状态。
示例代码
以下是完整的示例代码：
<html>
<head>
<style>
.content-hidden {
display: none;
}
</style>
<script>
function showHide(element) {
const sibling = element.nextElementSibling;
sibling.classList.toggle("content-hidden");
}
</script>
</head>
<body>
<h1 onclick="showHide(this)">Foo</h1>
<div class="content-hidden">
Foo Content
</div>
<h1 onclick="showHide(this)">Bar</h1>
<div class="content-hidden">
Bar Content
</div>
</body>
</html>更语义化的选择：使用 <details> 元素
对于简单的显示与隐藏需求，HTML5 提供了 <details> 元素，可以更语义化地实现相同的功能。
<details>
<summary><h1>Foo</h1></summary>
Foo Content
</details>
<details>
<summary><h1>Bar</h1></summary>
Bar Content
</details><details> 元素包含一个 <summary> 元素，用于显示摘要信息，点击摘要信息可以展开或折叠 <details> 元素的内容。可以通过 CSS 来定制 <summary> 元素的样式。
.thing > summary {
display: flex;
}总结
通过使用 CSS 类切换，可以避免直接操作内联样式带来的问题，实现更稳定、更可维护的元素显示与隐藏控制。在简单的场景下，可以考虑使用 HTML5 的 <details> 元素，以提高代码的语义化程度。在实际开发中，应根据具体需求选择最合适的解决方案。
