PhpStorm 2021.3 Help

XPath 表达式求值

在用于程序代码或 XSLT 脚本之前或在对 XML 文档进行结构化查询之前,需要对 XPath 表达式进行评估以对其进行测试。

PhpStorm 允许您以两种模式评估 XPath 表达式:

  • 简单模式下,您可以输入不需要任何命名空间前缀自定义的简单单行表达式。此模式不允许您配置上下文设置或使用预定义变量。

  • 高级模式下,您可以方便地以多行模式编辑长表达式并编辑 XPath 上下文。

一些错误检查和 XPath 检查还为检测到的问题提供快速修复,例如,可以将未解析的命名空间前缀有意地映射到 URI。

评估 XPath 表达式

  1. 从活动编辑器选项卡的上下文菜单中选择Evaluate XPath或转到Edit | 查找 | 评估 XPath。评估XPath 表达式对话框打开。

  2. 要切换评估模式,请单击高级/简单按钮。在任何一种模式下,对话框都具有最近评估的表达式的历史记录、完成、语法检查和突出显示,以及输入表达式的一些语义错误检查。语义检查包括验证使用的命名空间前缀、无用的 XPath 表达式(例如@comment())以及对上下文文档中未出现且无法成功匹配的元素/属性名称的节点测试。

  3. 浏览表达式的历史:

    • 简单模式下,可以从下拉列表中选择最近使用的表达式。

    • 高级模式下,使用图标动作以前发生/下一次出现的图标动作或按Alt+Up/ Alt+Down

  4. 要重新配置 XPath 上下文,请单击Edit Context。在打开的对话框中,将自定义前缀分配给上下文文档中使用的命名空间 URI,并定义要在查询中用于重复表达式的变量。

    分配更短的前缀、解决前缀冲突或为默认命名空间实际定义前缀可能很有用。这可能是必不可少的,因为 XPath 不会自动匹配默认名称空间中的元素,而无需为要匹配的元素指定前缀。编辑命名空间及其前缀和

    可以为表中的每个变量分配一个表达式,该表达式将在执行查询时计算一次。然后,结果值可用于多次使用,无需额外的计算成本。

  5. 可选:

    • 选中突出显示结果复选框以突出显示当前编辑器中的匹配节点。不属于当前编辑器的匹配节点(可能通过使用该document()功能发生)不会突出显示。建议在Find Usages工具窗口中显示此类跨文档结果。

    • 选中Show results in Usage View复选框以在Find Usages工具窗口中显示所有匹配的节点。选择在新选项卡中打开复选框以在新选项卡中打开结果,而不是重复使用上一个选项卡。

最后修改:2021 年 12 月 20 日