标签仅用于语义化标记变量名等可替换标识符,不绑定JS变量、不执行代码、不支持响应式;正确场景是文档中提及参数名如timeout,错误用法包括数值、公式、终端输出等。

var 标签不是变量声明工具,只是语义标记
var 标签和 JavaScript 的 var 关键字完全无关,它不声明、不存储、不更新任何值。浏览器不会解析它包裹的内容为可执行代码,也不会自动同步 JS 变量值。写 count 后,页面上显示的只是纯文本 “count”,哪怕你 JS 里定义了 let count = 5,它也不会变。
常见错误现象包括:
- 在 HTML 中写
name,然后试图用document.getElementById('user').textContent获取 JS 变量值 —— 它没有绑定能力,id只是普通 DOM 属性 - 把
let x = 10当作可执行代码片段 ——不支持嵌套语法,也不解析表达式 - 依赖它实现响应式渲染(比如类似
{count})—— 它没有数据绑定机制,必须靠 JS 手动更新innerText或textContent
什么时候该用 var 标签:只标“名字”,不标“值”
它的唯一合法用途是:在文档中「提及」一个变量名、参数名、占位符或公式符号本身,强调它在上下文中是可变的、待替换的标识符。
适用场景举例:
- 数学说明:
设 r 为半径,h 为高
- API 文档:
传入 timeout 参数控制请求超时时间
- 代码注释(非可执行):
将 inputValue 转为小写后再校验
DeepBI DHTML 页面生成器下载生成可在 deepbi 沙箱 iframe 内运行或作为独立文件运行的交互式 HTML 页面,使用 `window.deepbi` JS SDK 实现数据查询、空间管理、文件浏览及用户操作。当用户提出以下需求时启用该能力: - 创建 KPI 仪表盘、数据表格、文件浏览器、成员列表、管理页面; - 明确要求“转成 dhtml”、“转译成 HTML”、“把 XX 页面转成……”、“控制台页面”、“管理后台”、“DeepBI 页面迁移”; - 提及位于 `apps/console/src/featur
- 配合
使用(注意位置):✅;但fetch(url)❌(url不该嵌在内部)
不该用的场景:
- 数值、单位、函数名(如
π、sin、cm)—— 这些应归入或普通文本 - 错误信息、终端输出(如
Error: ENOENT)—— 应用 - 按键组合(如
Ctrl)—— 应用
样式与可访问性:斜体不是默认保障,必须显式控制
默认被浏览器 UA 样式设为 font-style: italic,但这只是惯例,不是规范强制。很多项目全局重置字体样式(比如 * { font-style: normal; }),会导致 失去视觉提示,更重要的是——屏幕阅读器可能不再将其识别为变量。
可靠做法是:
- 显式设置 CSS:
var { font-style: italic; },避免被全局样式覆盖 - 需要强化语义时加 ARIA:
Δ - 若项目统一禁用斜体,建议加 class 区分:
x+.var-inline { font-style: italic; color: #2c3e50; } - 不要靠
实现“变量斜体、常量正体”——常量(如π、c)该用并配font-style: normal
严肃数学公式别硬套 var,该用 MathML 或 KaTeX
写 a2 + b2 = c2 看似能工作,但它只是线性文本拼接,没有数学排版语义:上下标对齐不准、运算符间距不合理、屏幕阅读器无法理解这是勾股定理。
真正需要数学公式时:
- 用 MathML:
- 用 KaTeX:
$$a^2 + b^2 = c^2$$,由 JS 渲染为高质量数学布局 - 带下划线变量(如
_var)不能直接_var—— KaTeX 需写$\mathit{\_var}$(注意反斜杠转义),MathML 需用_var
简单文档中标记单个变量名, 足够;一旦涉及结构、对齐、上下文语义,它就不是解决方案,而是障眼法。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










