1. interface
  2. Masterminds
  3. HTML5
  4. InstructionProcessor

InstructionProcessor

interface InstructionProcessor (View source)

Provide an processor to handle embedded instructions.

XML defines a mechanism for inserting instructions (like PHP) into a document. These are called "Processor Instructions." The HTML5 parser provides an opportunity to handle these processor instructions during the tree-building phase (before the DOM is constructed), which makes it possible to alter the document as it is being created.

One could, for example, use this mechanism to execute well-formed PHP code embedded inside of an HTML5 document.

Methods

DOMElement
process( DOMElement $element, string $name, string $data)

Process an individual processing instruction.

Details

at line line 42
DOMElement process( DOMElement $element, string $name, string $data)

Process an individual processing instruction.

The process() function is responsible for doing the following: - Determining whether $name is an instruction type it can handle. - Determining what to do with the data passed in. - Making any subsequent modifications to the DOM by modifying the DOMElement or its attached DOM tree.

Parameters

DOMElement $element The parent element for the current processing instruction.
string $name The instruction's name. E.g. <?php has the name php.
string $data All of the data between the opening and closing PI marks.

Return Value

DOMElement The element that should be considered "Current". This may just be the element passed in, but if the processor added more elements, it may choose to reset the current element to one of the elements it created. (When in doubt, return the element passed in.)