You need to enable JavaScript to run this app. Vue模板内绑定ASP.NET MVC资源的title属性非英文字符显示异常
优惠活动
大模型
产品
解决方案
定价
更多

Vue模板内绑定ASP.NET MVC资源的title属性非英文字符显示异常

问题根因定位

这个异常是Razor视图引擎的默认编码逻辑与Vue模板渲染流程的不兼容导致的:

  • ASP.NET MVC 的 Razor 语法在输出 @表达式 时,默认会对输出内容执行 HTML 编码。对于非 ASCII 字符(比如西班牙语的 í),编码器会自动将其转成对应的 HTML 数值实体,例如把 Categoría 转成 Categoría。
  • 在纯 Razor 渲染的静态 HTML 区域,这种转义是兼容的:浏览器解析 DOM 标签时,会自动解码属性值中的 HTML 实体,最终展示正确的文本。
  • 在 Vue 模板作用域内,Razor 输出的带实体编码的字符串,要么被拼接在 JS 配置中作为 Vue 模板字符串传入,要么被 Vue 读取后直接作为模板编译。这两个环节都不会触发浏览器对 HTML 实体的自动解码,实体字符串会被直接作为 title 属性的字面文本赋值,最终悬停时就会显示转义后的实体内容,而非正确字符。
  • 英文环境下无异常,是因为 ASCII 范围内的字符不会被 Razor 编码器转成实体,两个渲染流程的输出内容完全一致,自然不会暴露问题。
排查方向
  • 右键打开页面源代码,定位到 Vue 模板对应的按钮代码,检查 Razor 输出的原始 HTML 中 title 属性的实际值,确认是否直接输出了 Categoría 这类带实体编码的内容。
  • 确认 Vue 模板的来源:是直接从 DOM 元素的 innerHTML 读取模板内容,还是服务端将模板字符串拼接在 JS 配置中传入 Vue 构造函数。
  • 对比非 Vue 区域的同资源按钮,确认两者的渲染链路差异:非 Vue 区域的实体编码是被浏览器 DOM 解析层解码的,而 Vue 流程缺少这一步解码环节。
可落地解决方案
  • 取消 Razor 对资源文本的额外 HTML 编码,直接输出原始 UTF-8 字符:
    因为当前内容是输出到 title 属性,只要提前校验资源文本不存在双引号、尖括号等会破坏 HTML 结构的特殊字符,就可以安全使用 Html.Raw() 方法跳过编码流程,示例代码:
    <button title="@Html.Raw(MyResxFile.Tooltip)">...</button>
  • 保留 Razor 默认编码逻辑,在 Vue 侧增加实体解码环节:
    如果不能调整 Razor 的输出逻辑,可以在 Vue 读取到对应文本后,通过临时 DOM 元素完成实体解码,示例解码函数:
    function decodeHtml(str) {
      const temp = document.createElement('div');
      temp.innerHTML = str;
      return temp.textContent;
    }
    
    将解码后的纯文本值绑定到按钮的 title 属性即可。
  • 从架构上解耦 Razor 编码与 Vue 模板:
    不要直接在 Vue 模板的标签属性里通过 Razor 语法插入资源文本,改为通过 JSON 序列化的方式把资源值传递给前端 JS:
    window.siteResources = @Html.Raw(Json.Encode(new { tooltip = MyResxFile.Tooltip }))
    Vue 直接从全局资源对象中读取纯文本值绑定属性,从根源上避开 HTML 实体转义的影响。

内容的提问来源于stack exchange,提问作者areller

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.31 23:27:03