推荐用 data-granularity 属性统一管理时间粒度切换,配合单事件监听器处理逻辑,避免硬编码函数名;需同步更新图表时间轴、URL 状态及移动端 touch-action 防缩放。

用 data-granularity 属性标记时间控件,配合统一事件监听器处理切换逻辑
仪表盘里常需在“实时(秒级)”“分钟汇总”“小时趋势”间快速跳转,但每个按钮单独写 onclick 容易散乱、难维护。推荐用自定义属性集中管理:data-granularity="second"、data-granularity="minute"、data-granularity="hour"。所有按钮共用一个点击监听器,通过 event.target.dataset.granularity 拿值,再分发到对应的数据拉取或图表重绘逻辑。
常见错误是把粒度值硬编码进函数名里,比如 switchToSecond()、switchToMinute(),结果新增“15分钟粒度”就得补三个函数+三处 HTML 修改。用属性驱动就只需加一行 HTML 和一个 case 分支。
- 按钮必须带
type="button",避免在表单内意外提交 - 粒度值建议全小写、无下划线,方便后续做 URL 参数映射(如
?granularity=hour) - 首次加载时,用
document.querySelector('[data-granularity].active')读取默认激活项,别依赖 JS 初始化顺序
切换后立即更新图表时间轴,别只改数据不重绘坐标系
很多仪表盘点了“小时粒度”,折线图数据确实换了,但 X 轴标签还是按秒画的——导致密密麻麻挤成一条黑线。Canvas 或 SVG 图表必须同步调整时间轴刻度逻辑。例如用 Chart.js 时,不能只调 chart.data = newData,还得调 chart.options.scales.x.time.unit = 'hour' 并触发 chart.update()。
如果是原生 Canvas 绘图,关键点在于:时间粒度变,ctx.fillText() 写刻度的间隔步长得重算,且 new Date().getTime() 到像素坐标的映射系数也要重算。漏掉这步,图表看起来“动了”,但时间关系是错的。
立即学习“前端免费学习笔记(深入)”;
- 避免在
setInterval里反复调用getTime()算偏移——提前缓存起始时间戳和单位像素代表的毫秒数 - 分钟/小时粒度下,X 轴标签建议用
toLocaleTimeString('zh-CN', { hour: '2-digit', minute: '2-digit' }),别直接格式化毫秒值 - 切换瞬间若图表有动画,先
chart.stop()(Chart.js)或手动清空requestAnimationFrameID,防止新旧动画冲突
URL 同步与浏览器前进/后退支持,靠 history.replaceState() + popstate
用户点了“小时粒度”,刷新页面却回到“秒级”,或者点了浏览器返回键没切回去——说明没把粒度状态同步到 URL。必须在粒度变更后立刻调用 history.replaceState({ granularity: 'hour' }, '', '?granularity=hour');同时监听 window.addEventListener('popstate', ...) 捕获返回/前进动作,并还原 UI 和图表。
容易忽略的是:初始页面加载时,要从 location.search 解析 granularity 参数并设为默认值。否则用户分享带参数的链接(如 dashboard.html?granularity=minute),打开后还是显示秒级。
- 参数名统一用
granularity,别用timeUnit或interval,降低前后端理解成本 - 值校验必须做:
if (!['second', 'minute', 'hour'].includes(granularity)) granularity = 'second',防 XSS 或误传 - 不要用
history.pushState()在初始化时推入新记录——会导致用户多点一次后退才退出页面
移动端双击缩放干扰问题,给时间控件加 touch-action: manipulation
在手机上,手指双击时间按钮区域可能触发浏览器缩放,导致整个仪表盘界面变形。这不是 JS 问题,是 CSS 行为。给所有粒度切换按钮加上 style="touch-action: manipulation;",能禁用双击缩放,同时保留点击和滑动响应。
这个样式必须加在按钮元素本身,不能只加在外层容器上。如果用了框架(如 Vue 的 v-for 渲染按钮),确保内联样式或 class 规则精确命中按钮标签。
- 兼容性没问题:Chrome 36+、Firefox 60+、Safari 13+ 都支持
touch-action - 别用
user-scalable=no全局禁用缩放——它会锁死整个页面,影响可访问性 - 测试时真机双击按钮,确认没有缩放动画、按钮点击反馈正常即可



















