Vue 和 React 默认不透传 data-* 属性，必须显式处理；读取时 dataset 会做驼峰转换但只返回字符串，含数字、下划线或非法命名的属性必须用 getAttribute()。
Vue 组件里 data-* 属性为什么不见了
你在模板中写 <mybutton data-tracking-id="click-home"></mybutton>，但渲染后 DOM 根元素上查不到这个属性——不是框架“过滤”了，是它根本没被挂载。Vue 默认只把声明为 props 的属性透传到根元素，data-* 被归类为“非 prop 属性”，直接丢弃。
- 必须在组件定义中加
inheritAttrs: false（Options API）或defineOptions({ inheritAttrs: false })（Composition API） - 再手动用
v-bind="$attrs"把所有未声明的属性（包括data-*）挂到目标元素上 - 如果组件有多个根节点（如使用
<template></template>包裹多个元素），$attrs不会自动分发，需显式绑定到某个节点 -
setup()中不能直接解构useAttrs()返回的响应式对象来赋值dataset，因为dataset是只读代理，改了也不更新 DOM
React 函数组件怎么拿到 data-tracking-id
React 默认不把 data-* 当作 props 传入函数组件，props 对象里压根没有 data-tracking-id 字段。你不能靠 props['data-tracking-id'] 或解构 dataTrackingId 来访问。
Orderly React SDK 钩子使用参考指南，包括 useOrderEntry、usePositionStream、useOrderbookStream、useCollateral 等。
- 正确做法是用展开运算符：
<button>Click</button>，前提是父组件传入时没做任何拦截 - 如果组件封装了多层 wrapper（比如用了
React.forwardRef或高阶组件），透传链容易断裂，得在每一层都手动转发...restProps - 若只需个别属性，可解构：
const { 'data-tracking-id': trackingId, ...rest } = props，再<button data-tracking-id="{trackingId}"></button> - 注意：JSX 中写
data-tracking-id={trackingId}是合法的，但dataTrackingId（驼峰）会被当成普通 prop，不会变成 DOM 属性
dataset.userId 读出来是 undefined？检查这三件事
dataset 看似方便，但命名和读取规则非常严格，错一个字符就返回 undefined。
- HTML 中必须全小写 + 连字符：
data-user-id✅，data-userId❌，data_user_id❌，data-UserID❌ - 数字开头的属性无法用点号访问：
data-2024-active→ 必须写el.dataset["2024Active"]，不能写el.dataset.2024Active（语法错误） - 下划线、冒号、多个连续连字符都不触发驼峰转换：
data-user_name→dataset.user_name无效，只能用el.getAttribute('data-user_name') -
dataset只返回字符串：data-count="42"→el.dataset.count === "42"，要数值就得Number(el.dataset.count)
为什么 MutationObserver 监听不到 dataset 修改
用 el.dataset.theme = 'dark' 看似改了属性，但浏览器不会触发 attributeChangedCallback，MutationObserver 也收不到通知——因为 dataset 是只读代理，它的赋值行为不等价于 setAttribute。
- 只有
el.setAttribute('data-theme', 'dark')才真正修改 DOM attribute，能触发监听器和自定义元素生命周期钩子 -
el.dataset.theme = 'dark'在部分旧版 Safari 中有兼容性问题，且某些框架（如 Vue 3 响应式系统）无法追踪其变化 - 如果你依赖属性变更做副作用（比如切主题、重绘图表），必须用
setAttribute，并配MutationObserver监听特定attributeFilter: ['data-theme'] - 别在循环或高频事件里反复调
getAttribute或dataset.xxx，应缓存到变量或状态中
真正容易被忽略的是：哪怕你写了 data-config='{"theme":"dark"}'，JavaScript 拿到的仍是字符串，没人自动帮你 JSON.parse()；出错也不会报错，只会静默变成 undefined。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
