p:namespace-delete (3.1) 

Summary

<p:declare-step type="p:namespace-delete">
  <input port="source" primary="true" content-types="xml html" sequence="false"/>
  <output port="result" primary="true" content-types="xml html" sequence="false"/>
  <option name="prefixes" as="xs:string" required="true"/>
</p:declare-step>

The p:namespace-delete step deletes namespaces, for which the prefixes are listed in the prefixes option, from elements and attributes in the document appearing on its source. The resulting document appears on the result port.

Ports:

Options:

Description

The p:namespace-delete step takes the value of its prefixes option, which must be a whitespace separated list of namespace-prefixes, and finds out which namespaces are associated with these prefixes. These namespace prefixes must be defined in the pipeline. It then uses this list to delete these namespaces from elements and attributes in the document appearing on the source port. Elements and attributes that were in one of these namespaces are now in the no-namespace. The resulting document appears on the result port.

Note that matching is done on namespace name, not on namespace-prefix. This means that the prefix as used in the prefixes option might be different from the one used in the document to delete the namespace from. See the Basic usage with different namespace-prefixes example.

Examples

<config xmlns:con="#myconfig" con:status="special">
   <con:thing>button</con:thing>
</config>

<p:declare-step xmlns:con="#myconfig" xmlns:p="http://www.w3.org/ns/xproc" version="3.0">

  <p:input port="source"/>
  <p:output port="result"/>

  <p:namespace-delete prefixes="con"/>

</p:declare-step>

<config status="special">
   <thing>button</thing>
</config>

<config xmlns:con="#myconfig" con:status="special">
   <con:thing>button</con:thing>
</config>

<p:declare-step xmlns:ns1="#myconfig" xmlns:p="http://www.w3.org/ns/xproc" version="3.0">

  <p:input port="source"/>
  <p:output port="result"/>

  <p:namespace-delete prefixes="ns1"/>

</p:declare-step>

<config status="special">
   <thing>button</thing>
</config>

Additional details

• p:namespace-delete preserves all document-properties of the document(s) appearing on its source port.

Errors raised

Reference information

This description of the p:namespace-delete step is for XProc version: 3.1. This is a required step (an XProc 3.1 processor must support this).

The formal specification for the p:namespace-delete step can be found here.

The p:namespace-delete step is part of categories:

• Standard XProc steps

• Basic XML manipulation

• Namespace handling

The p:namespace-delete step is also present in version: 3.0.