使用原生 javascript 监听滚动事件，当视口首次到达目标元素位置时精确触发一次计数更新，并自动移除监听器，避免重复执行。
在网页交互开发中，常需实现“滚动触发动画”或“进入可视区域后计数”的效果，而关键在于仅执行一次——例如统计用户是否已浏览到某模块。以下是一个不依赖任何第三方库的轻量、健壮的实现方案。
✅ 核心思路
- 获取目标元素（如
）在页面中的垂直偏移量（offsetTop）； - 监听 window.scroll 事件，实时获取当前滚动高度（window.scrollY）；
- 当 scrollY >= 元素顶部距离 时，执行计数逻辑；
- 立即解绑事件监听器，确保后续滚动不再触发，杜绝重复更新。
? 完整示例代码
<!-- HTML -->
<section id="counter-section" class="oops">
<h2>目标区域：请向下滚动至此</h2>
<p>计数器当前值：<span id="counter-display">0</span></p><div class="aritcle_card flexRow">
<div class="artcardd flexRow">
<a class="aritcle_card_img" href="/xiazai/skill10362" title="java-api-doc-generator"><img
src="https://img.php.cn/upload/skill/001/246/273/6adaf20d79f23518.jpg" alt="java-api-doc-generator" ></a>
<div class="aritcle_card_info flexColumn">
<a href="/xiazai/skill10362" title="java-api-doc-generator">java-api-doc-generator</a>
<p>分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。</p>
</div>
<a href="/xiazai/skill10362" title="java-api-doc-generator" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a>
</div>
</div>
</section>/* CSS（增强可观察性） */
.oops {
border: solid red 1px;
padding: 40px;
margin: 80vh 0; /* 确保需滚动才能到达 */
background-color: #fff9f9;
}// JavaScript（原生实现）
let counter = 0;
const counterDisplay = document.getElementById('counter-display');
const section = document.querySelector('#counter-section');
if (section) {
const sectionTop = section.offsetTop;
const handleScroll = () => {
if (window.scrollY >= sectionTop) {
counter++;
counterDisplay.textContent = counter;
// ✅ 关键：移除自身监听器，保证仅执行一次
window.removeEventListener('scroll', handleScroll);
}
};
window.addEventListener('scroll', handleScroll);
} else {
console.warn('目标元素 #counter-section 未找到');
}⚠️ 注意事项
- 兼容性：offsetTop 和 scrollY 在现代浏览器中广泛支持（IE9+），若需支持 IE8，可用 document.documentElement.scrollTop || document.body.scrollTop 替代。
- 动态内容风险：若目标元素是异步加载（如 AJAX 插入），请确保在元素存在后再执行初始化逻辑，推荐用 DOMContentLoaded 或 IntersectionObserver（进阶替代方案）。
- 性能提示：本例因仅触发一次即解绑，无性能负担；但若需监听多个区域，建议封装为可复用函数，或改用 IntersectionObserver 实现更优雅的懒加载式判断。
? 小结
该方案简洁、可靠、零依赖，精准满足“滚动到达即更新一次”的核心需求。它不仅是计数器的基础，更是理解滚动触发机制的重要范例——状态判断 + 单次执行 + 主动清理，是前端事件控制的黄金三角。
