XHREFlinker

Home > Books > NetKernel API and Services Reference > Accessor Listing > XHTML Utilities > XHREFlinker

Module

The XHREFlinker accessor is exported by the urn:org:ten60:netkernel:ext:xhtml module. Import this module to gain access to the accessor.

Syntax

URI

active:XHREFlinker

Argument	Rules	Description
operand	Mandatory	document containing named links to be replaced
operator	Mandatory	document containing named URIs

Example Usage

DPML

<instr>
  <type>XHREFlinker</type>
  <operand>source.xml</operand>
  <operator>links.xml</operator>
  <target>this:response</target>
</instr>

NetKernel Foundation API

req=context.createSubRequest("active:XHREFlinker");
req.addArgument("operand", [resource representation, aspect, or URI] );
req.addArgument("operator", [resource representation, aspect, or URI] );
result=context.issueSubRequest(req);

Purpose

The XHREFlinker accessor is used to replace named link elements in the operand document with an HTML link. The named links href is looked up in a links document supplied as operator.

A named link has the form <link name="mylink">Some text</link>

The operator document must contain a set of link URIs

<links>
  <link name="mylink">http://www.1060research.com</link>
    ...

</links>

In this example the result of the XHREFlinker operations is to replace <link name="mylink">Some text</link> with <a href="http://www.1060research.com">Some text</a>

Note: The XHREFlinker is not XLink. It is a simple and convenient named link transformer.