PhpStorm 8.0.0 Web Help

File | Settings | Language Injection - XML Attribute

settings

The dialog box opens when you click add.png in the Language Injection page, and choose XML Attribute Injection on the context menu, or select an entry and click properties.gif.

Item Description
Display Name In this text box, type the name that will identify the injection configuration in the list.

Note

The text box is available when configuration is created (add), or configured (properties).

Language In this area, specify the language of the injection. If necessary, define the context to be automatically made up when the injection is opened in the editor.
  • ID - from this drop-down list, select the ID of the language of the injection.
  • Prefix - in this text box, specify the character string to be automatically added before the injection.
  • Suffix - in this text box, specify the character string to be automatically added after the injection.

Note

The Prefix and Suffix text boxes are optional.

XML Tag In this area, specify the XML tags in which the attributes are impacted by the defined configuration.
  • Local Name - in this text box, specify the tag name without a namespace prefix. Use regular expressions to specify multiple tag names (name1|name2), case-insensitive names ((?i)tagname matches tagname as well as TagName), etc.

    Warning

    Space characters are not allowed as they affect the match result.

  • Namespace - in this text box, specify the namespace URI of the XML tag.

Note

Both fields are optional. However, if the Local Name text box is empty the configuration will apply to any attribute that matches the configured name, regardless of its containing XML tag.

XML Attribute In this area, define the XML tag attribute which indicates that the text enclosed in a tag with such attribute should be treated as the selected language.
  • Local Name - in this text box, specify the attribute name without a namespace prefix. Use regular expressions: For example, to match HTML event handler attributes, type on.* in the text box.

    Note

    The field is optional, unless the Local Name text box in the XML Tag area is empty. If the attribute local name is not specified, the configuration applies to all attributes of the enclosing tag.

  • Namespace - in this text box, specify the namespace URI of the attribute.
Advanced In this area, specify additional settings to enable more fine-grained control over the injection process.
  • Value Pattern - in this text box, type a regular expression that determines the part of the attribute's value to inject the language into. By using the first capturing group of the pattern as the target for injection, you can configure the procedure to have the language injected only into values that match a certain pattern or into multiple parts that match the pattern.
  • XPath Condition - in this text box, specify an XPath expression to address the injection-target more precisely. The context in which the expression is evaluated is the attribute itself.
  • Single File - select this check box to specify an exact file to apply the injection to.

See Also

Concepts:

Reference:

Web Resources: