# 语言注入设置对话框：XML 属性注入

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com.cn/help/idea/llms.txt).

> **TL;DR**
> `文件 | 设置 | 编辑器 | 语言注入 |`  !["添加"按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.add.svg)  `| XML 特性受限标识符`  适用于 Windows 和 Linux
>
>
>
> `%instance% | 设置 | 编辑器 | 语言注入 |`  !["添加"按钮](https://resources.jetbrains.com.cn/help/img/idea/2026.3/app.expui.general.add.svg)  `| XML 特性受限标识符`  适用于 macOS

|  条目  |  描述  |
| --- | --- |
|  名称  |  注入的名称。  |
|  语言  |     要注入的语言。        * ID : 选择要 inject 的语言的 ID 或名称。    * 前缀 : 指定要添加到相应字符串值之前的字符序列。    * 后缀 : 指定要添加到相应字符串值之后的字符序列。      前缀和后缀是可选的。     |
|  XML 标记  |     在此区域中，指定受已定义规则影响的 XML 标记，其内部的特性将受到影响。        * 在 本地名称 字段中，指定不带命名空间前缀的标记名称。 使用正则表达式指定多个标记名称 `name1\|name2` 、不区分大小写的名称（ `(?i)tagname` 会同时匹配 tagname 和 TagName ），等等。 > **Warning:** > 空格字符是不允许的，因为它们会影响匹配结果。    * 在 命名空间 字段中，指定 XML 标记的命名空间 URI。      这两个字段都是可选的。 但是，如果   本地名称   字段为空，配置将应用于名称与配置名称匹配的任何特性，而不考虑其所在的 XML 标记。     |
|  XML 特性  |     在此区域中，定义 XML 标记特性，该特性指示带有此类特性的标记中包含的文本应被视为所选语言。        * 本地名称 ：指定没有命名空间前缀的属性名称。 请使用正则表达式：例如，要匹配 HTML 事件处理程序属性，请在该字段中输入 `on.*` 。 除非 XML 标记 区域中的 本地名称 字段为空，否则此字段是可选的。 如果没有指定属性本地名称，则配置适用于封闭标签的所有属性。    * 命名空间 ：指定特性的命名空间 URI。    |
|  高级  |     在此区域中，指定附加设置以实现对注入过程的更精细控制。        * 值模式 - 在此字段中，输入用于确定要将语言 inject 到哪个上下文的正则表达式。 通过将模式的第一个捕获组用作受限标识符的目标，可以配置该过程，使语言仅被 inject 到匹配特定模式的值中，或被 inject 到匹配该模式的多个部分中。    * 单个文件 - 如果此选项关闭，与值模式匹配的片段将被单独处理，视为不同的“文件”——例如，从片段编辑器的视角来看。 如果该选项开启，相应片段会全部合并在一起，形成一个单元或“文件”。 给定值模式 `xxx (.+) yyy (.+) zzz` 以及片段 `xxx select * yyy from family zzz` ， 如果该选项关闭， `select *` 和 `from family` 会被视为两个独立片段（或“文件”）。 如果该选项开启， `select * from family` 会被视为一个单元或“文件”。    * XPath 条件 - 在此字段中，指定一个 XPath 表达式，以更精确地定位注入目标。 表达式的评估上下文为 XML 特性本身。 如有需要，请使用 XPath [扩展程序函数／方法](http://www.cafeconleche.org/jaxen/apidocs/org/jaxen/function/ext/package-summary.html)，例如， `lower-case()` 。 此外，还有三个附加函数可以用来确定当前文件的名称、扩展名和文件类型： `file-name()` 、 `file-ext()` 和 `file-type()` 。 或者，您也可以通过标准代码补全来获取可用函数列表。 > **Note:** > 要使该字段处于活动状态，请确保已启用 XPathView + XSLT Support [插件](managing-plugins.html)。    |

## 运作方式

* [语言和引用受限标识符](using-language-injections.html)

## See also

### 过程

[语言和引用受限标识符](using-language-injections.html)

### 参考

[正则表达式语法参考](regular-expressions.html)

