History | Edit

The oxy:allows-global-element() function allows you to check whether or not an element that matches the arguments of the function is valid for the current framework, according to the associated schema. It has the following signature:

oxy:allows-global-element($elementName, ($attributeName, $defaultAttributeValue, $contains?)?)

The following parameters are supported:
elementName
The name of the element that you want to check if it is valid in the current framework. Its value is a string that supports the following forms:
  • The element with the specified local name that belongs to the default namespace.
    oxy:allows-global-element("para")
    The above example verifies if the para element (of the default namespace) is allowed in the current framework.
  • The element with the local name specified by any namespace.
    oxy:allows-global-element("*:para")
    The above example verifies if the para element (of any namespace) is allowed in the current framework.
  • A prefix-qualified name of an element.
    oxy:allows-global-element("prefix:para")
    The prefix is resolved in the context of the framework. The function matches on the element with the para local name from the previous resolved namespace. If the prefix is not resolved to a namespace, the function returns a value of false.
  • A specified namespace-URI-qualified name of an element.
    oxy:allows-global-element("{namespaceURI}para")

    The namespaceURI is the namespace of the element. The above example verifies if the para element (of the specified namespace) is allowed in the current framework.

  • Any element.
    oxy:allows-global-element("*")
    The above function verifies if any element is allowed in the current framework.
attributeName
The attribute of an element that you want to check if it is valid in the current framework. Its value is a string that supports the following forms:
  • The attribute with the specified name from no namespace.
    oxy:allows-global-element("*", "class", " topic/topic ")
    The above example verifies if an element with the class attribute and the default value of this attribute (that contains the topic/topic string) is allowed in the current framework.
  • The attribute with the local name specified by any namespace.
    oxy:allows-global-element("*", "*:localname", " topic/topic ")
  • A qualified name of an attribute.
    oxy:allows-global-element("*", "prefix:localname", " topic/topic ")
    The prefix is resolved in the context of the framework. If the prefix is not resolved to a namespace, the function returns a value of false.
defaultAttributeValue
A string that represents the default value of the attribute. Depending on the value of the next parameter, the default value of the attribute must either contain this value or be equal with it.
contains
An optional boolean. The default value is true. For the true value, the default value of the attribute must contain the defaultAttributeValue parameter. If the value is false, the two values must be the same.