本文详解如何用原生 JavaScript 实现基于 data-name 属性的按钮驱动内容筛选功能，重点解决“按钮高亮切换正常但对应内容不显示/隐藏”的常见逻辑缺陷，并提供可直接运行的健壮代码方案。
本文详解如何用原生 javascript 实现基于 `data-name` 属性的按钮驱动内容筛选功能，重点解决“按钮高亮切换正常但对应内容不显示/隐藏”的常见逻辑缺陷，并提供可直接运行的健壮代码方案。
在构建分类筛选菜单（如作品集、项目列表）时，一个典型需求是：点击某个按钮（如“音乐”“电影”），仅显示对应类别的内容项，其余隐藏；同时该按钮应获得视觉激活态（如高亮背景）。然而，许多初学者会遇到“按钮能高亮，但内容完全不变化”的问题——这通常不是 HTML 或 CSS 的锅，而是 JavaScript 中状态判断与 DOM 操作逻辑存在隐蔽缺陷。
原始代码的问题核心在于：
- 使用 work.classList.add("hide") 强制为所有 .work 元素添加 hide 类，但未确保 .hide 在 CSS 中定义为 display: none（原文 CSS 缺失该规则，仅靠类名无法生效）；
- 条件判断 work.dataset.name === e.target.dataset.name || e.target.dataset.name === "all2" 逻辑正确，但若 .work 元素缺失 data-name 属性或值不匹配（如大小写、空格差异），则全部被隐藏；
- 更关键的是：未清除旧的 active3 状态前就操作元素类名，可能导致 document.querySelector(".active3") 返回 null（尤其在首次点击无初始 active 元素时），引发脚本静默失败。
以下是一个简洁、鲁棒、无需依赖外部库的修复方案：
<!-- HTML 结构（保持语义清晰，data-name 值需严格一致） --> <div class="filter_buttons2"> <h4 data-name="all2" class="active3">Pokaż wszystkie</h4> <h4 data-name="music">Muzyka</h4> <h4 data-name="films">Filmy</h4> <h4 data-name="photography">Fotografia</h4> <h4 data-name="copywriting">Copywriting</h4> </div> <div class="filterable_works"> <div class="work" data-name="music"><p>ddddd</p></div> <div class="work" data-name="films"><p>gfjdfgjfg</p></div> <div class="work" data-name="photography"><p>dsfsfgsghdf</p></div> <div class="work" data-name="copywriting"><p>daaaasadd</p></div> </div>
/* CSS 补充关键规则：.noDisplay 必须声明 display: none */
.noDisplay {
display: none;
}
/* 其余样式保持不变（.filter_buttons2, h4, .work 等） */
.filter_buttons2 {
display: flex;
align-items: center;
flex-wrap: wrap;
gap: 10px;
}
h4 {
padding: 10px 20px;
font-size: 18px;
background: white;
border: none;
border-radius: 6px;
cursor: pointer;
box-shadow: 0 0 10px #000000;
}
h4.active3 {
background: #670101;
color: white;
}
.filterable_works {
display: contents;
margin-top: 25px;
gap: 20px;
flex-wrap: wrap;
}
.work {
position: relative;
max-width: 1300px;
width: 100%;
padding: 20px;
margin: 0;
}// JavaScript：使用现代语法，逻辑清晰，容错性强
const filterableWorks = document.querySelectorAll('.filterable_works .work');
const filterButtons = document.querySelectorAll('.filter_buttons2 h4');
filterButtons.forEach(button => {
button.addEventListener('click', () => {
// 步骤1：同步更新所有按钮的 active3 状态
filterButtons.forEach(btn =>
btn.classList.toggle('active3', btn === button)
);
// 步骤2：根据当前按钮的 data-name 控制内容显隐
const targetCategory = button.dataset.name;
filterableWorks.forEach(work => {
const workCategory = work.dataset.name;
// 显示条件：target 是 "all2"，或 work 的 category 与 target 完全匹配
const shouldShow = targetCategory === 'all2' || workCategory === targetCategory;
work.classList.toggle('noDisplay', !shouldShow);
});
});
});✅ 关键改进说明：
- 状态同步更可靠：使用 btn.classList.toggle('active3', btn === button) 替代手动 remove/add，避免因 DOM 查询失败导致的异常；
- 显隐控制更精准：引入专用 CSS 类 .noDisplay { display: none }，语义明确且性能优于反复增删 hide 类（后者若未定义样式则完全无效）；
- 逻辑解耦清晰：按钮激活与内容过滤分为两个独立 but 同步执行的步骤，便于调试和扩展；
- 零依赖、易维护：纯原生 JS，无第三方库，兼容主流浏览器。
⚠️ 注意事项：
- 确保所有 .work 元素均含有 data-name 属性，且其值与对应按钮的 data-name 完全一致（包括大小写、空格、连字符）；
- 若页面加载后动态插入新 .work 元素，需重新调用 document.querySelectorAll 或改用事件委托；
- display: contents 在 .filterable_works 上虽可让子元素参与 Flex 布局，但需注意其对可访问性（a11y）的影响，生产环境建议评估是否改用 display: flex 并移除 display: contents。
掌握这一模式后，你不仅能修复当前问题，还能快速复用于博客标签筛选、商品分类、FAQ 折叠等场景——核心永远是：*数据驱动（data-）、状态同步、CSS 控制呈现、JS 控制逻辑**。
