WebStorm 2025.2 Help

语言注入设置对话框:XML 标签注入

项目

描述

名称

注入的名称。

语言

要注入的语言。

  • ID 在此列表中,选择要注入的语言的 ID 或名称。

  • 前缀 一串字符,添加在对应字符串值之前。

  • 后缀 一串字符,添加在对应字符串值之后。

前缀和后缀为可选项。

XML 标签

在该区域中,定义 XML 标签,表明该标签中包含的文本应按所选语言处理。

  • 本地名称 :指定不带命名空间前缀的标签名称。 使用正则表达式指定多个标签名称 name1|name2 ,不区分大小写的名称((?i)tagname 可匹配 tagnameTagName ),等等。

  • 命名空间 :指定 XML 标签的命名空间 URI。 该字段为可选项。

子标签

选中此复选框可递归包含所有子标签。

高级

指定附加设置,以便对注入过程进行更精细的控制。

  • 值模式 - 输入一个正则表达式,用于确定要注入语言的 XML 文本值的部分。 通过使用模式的第一个捕获组作为注入目标,您可以将语言仅注入匹配某一特定模式的值或多个匹配该模式的部分。

    示例:

    [$#]\{(.*?)\} 匹配 JSP/JSF 表达式语言使用的模式。

    ^javascript:(.*) 匹配可用于在 hyperlink-hrefs 中执行 JavaScript 代码的 javascript 协议。

    • 单个文件 :如果关闭此选项,则匹配值模式的片段将被视为不同的“文件”进行分别处理——例如,从片段编辑器的角度看。

      如果启用此选项,对应的片段将合并为一个整体或“文件”。

      已知值模式

      xxx (.+) yyy (.+) zzz

      以及片段

      xxx select * yyy from family zzz

      select *from family 如果未启用该选项,将被视为两个独立的片段(或“文件”)。 如果启用该选项, select * from family 将被作为一个整体或“文件”处理。

  • XPath 条件 :指定一个 XPath 表达式,以更精确地定位注入目标。 表达式的求值上下文为所包围的 XML 标签。

    可以使用 XPath 扩展函数 ,例如 lower-case()。 此外,还有三个附加函数可用于确定当前文件的名称、扩展名和文件类型: file-name()file-ext()file-type()。 或者,您可以通过标准代码补全检索可用函数列表。

    要使该字段生效,必须启用 XPathView + XSLT Support 插件

最后修改日期: 2025年 9月 26日