本文详解如何安全、可靠地读取 HTML 等元素上的 title、description、activity-note、grouped-as 等自定义属性值，并重点解决以纯数字（如 '1'）作为 id 时在 JavaScript 中调用 getElementById() 失败的根本原因与最佳实践方案。
本文详解如何安全、可靠地读取 html `
` 等元素上的 `title`、`description`、`activity-note`、`grouped-as` 等自定义属性值，并重点解决以纯数字（如 `'1'`）作为 `id` 时在 javascript 中调用 `getelementbyid()` 失败的根本原因与最佳实践方案。
在实际开发中，我们常通过 HTML 自定义属性（如 title="A"、activity-note="C"）为元素附加语义化元数据，并在 JavaScript 中动态读取这些值。但当你尝试使用如下代码时：
const title = document.getElementById('1').getAttribute('title');很可能会遇到 TypeError: Cannot read property 'getAttribute' of null —— 这并非 getAttribute() 方法出错，而是 document.getElementById('1') 返回了 null。
? 根本原因：数字 ID 在 JavaScript 中不构成合法标识符
是语法合法的 HTML，但它会引发 JavaScript 层面的兼容性问题：
- id="1" 会使该元素自动挂载为 window 对象的一个属性：window[1]（注意：是数字索引，不是字符串 '1'）；
- 但 document.getElementById('1') 在部分旧版浏览器或严格模式下可能失效，尤其当存在命名冲突或 DOM 解析异常时；
- 更关键的是：1 不是合法的 JavaScript 标识符（变量名不能以数字开头），因此无法通过 window.1 或直接 1 访问，必须用方括号语法 window[1] —— 这极易被忽略且违背直觉。
✅ 正确做法是避免使用纯数字作为 id 值。推荐改写为语义化、符合标识符规则的 ID，例如：
立即学习“前端免费学习笔记（深入）”；
<div id="item-1" title="A" description="B" activity-note="C" grouped-as="Test"></div> <div id="item-4" title="Z" description="Z" activity-note="Z" grouped-as="Soil Prep"></div> <div id="item-5" title="Q" description="Q" activity-note="Q" grouped-as="Soil Prep"></div>
随后即可安全使用标准 API：
// ✅ 推荐：语义化 ID + getElementById
const el = document.getElementById('item-1');
console.log(el.getAttribute('title')); // "A"
console.log(el.getAttribute('description')); // "B"
console.log(el.getAttribute('activity-note')); // "C"
console.log(el.getAttribute('grouped-as')); // "Test"? 批量读取多个元素的所有自定义属性（进阶方案）
若需遍历所有匹配
并提取全部自定义属性，可结合 querySelectorAll 与 dataset（推荐）或 attributes（更底层）：
方案一：使用 dataset（推荐，适用于 data-* 属性）
⚠️ 注意：dataset *仅支持 `data-命名的自定义属性**（如data-title,data-activity-note）。原示例中的title、activity-note等属于非标准全局属性，**不应滥用**；规范做法是统一加data-` 前缀：
<div id="item-1" data-title="A" data-description="B" data-activity-note="C" data-grouped-as="Test"></div>
document.querySelectorAll('div[id^="item-"]').forEach(div => {
const { title, description, activityNote, groupedAs } = div.dataset;
console.log({ title, description, activityNote, groupedAs });
});
// 输出：{ title: "A", description: "B", activityNote: "C", groupedAs: "Test" }✅ activity-note → activityNote（驼峰自动转换），grouped-as → groupedAs，简洁且类型安全。
方案二：通用属性读取（兼容任意属性名）
若暂无法修改 HTML，需读取任意属性（包括 title、activity-note），可遍历 element.attributes：
function getAllAttributes(el) {
const attrs = {};
for (let attr of el.attributes) {
// 过滤掉内置属性（如 id、class），保留自定义语义属性
if (!['id', 'class', 'style'].includes(attr.name)) {
attrs[attr.name] = attr.value;
}
}
return attrs;
}
document.querySelectorAll('div[id^="item-"]').forEach(div => {
console.log(getAllAttributes(div));
});
// 输出示例：{ title: "A", description: "B", "activity-note": "C", "grouped-as": "Test" }✅ 最佳实践总结
- ID 命名规范：永远避免纯数字或特殊字符开头（如 -1, 123），使用 item-1、task-4 等语义前缀；
- 自定义属性标准化：优先使用 data-* 属性（如 data-activity-note），通过 element.dataset 安全访问；
-
健壮性检查：始终校验元素是否存在，避免 null 异常：
const el = document.getElementById('item-1'); if (el) { const title = el.getAttribute('data-title') || ''; } -
现代替代方案：考虑使用 data 属性 + JSON.parse() 存储结构化数据，提升可维护性：
<div id="item-1" data-meta='{"title":"A","description":"B","group":"Test"}'></div>const meta = JSON.parse(document.getElementById('item-1').dataset.meta);
遵循以上原则，你不仅能解决当前的属性读取问题，更能构建出可扩展、易调试、符合 Web 标准的前端代码。
