Matt Sergeant > AxKit-XSP-Util-1.6 > AxKit::XSP::Util

Download:
AxKit-XSP-Util-1.6.tar.gz

Dependencies

Annotate this POD

CPAN RT

New  1
Open  0
View/Report Bugs
Module Version: 1.6   Source  

NAME ^

AxKit::XSP::Util - XSP util: taglib.

SYNOPSIS ^

Add the util: namespace to your XSP <xsp:page> tag:

    <xsp:page
         language="Perl"
         xmlns:xsp="http://apache.org/xsp/core/v1"
         xmlns:util="http://apache.org/xsp/util/v1"
    >

And add this taglib to AxKit (via httpd.conf or .htaccess):

    AxAddXSPTaglib AxKit::XSP::Util

DESCRIPTION ^

The XSP util: taglib seeks to add a short list of basic utility functions to the eXtesible Server Pages library. It trivializes the inclusion of external fragments and adds a few other useful bells and whistles.

TAG STRUCTURE ^

Most of of the tags require some sort of "argument" to be passed (e.g. <util:include-file> requires the name of the file that is to be read). Unless otherwise noted, all tags allow you to pass this information either as an attribute of the current element or as the text node of an appropriately named child.

Thus, both:

    <util:include-file name="foo.xml" />

and

    <util:include-file>
    <util:name>foo.xml</util:name>
    </util:include-file>

are valid.

TAG REFERENCE ^

<util:include-file>

Provides a way to include an XML fragment from a local file into the current parse tree. Requires a name argument. The path may be relative or absolute.

<util:include-uri>

Provides a way to include an XML fragment from a (possibly) remote URI. Requires an href argument.

<util:get-file-contents>

Provides a way to include a local file as plain text. Requires a name argument. The path may be relative or absolute.

<util:include-expr>

Provides a way to include an XML fragment from a scalar variable. Note that this tag may only pass the required expr argument as a child node. Example:

    <util:include-expr>
    <xsp:expr>$xml_fragment</xsp:expr>
    </util:include-expr>

<util:time>

Returns a formatted time/date string. Requires a format attribute. The format is defined using the standard strftime() syntax.

AUTHOR ^

Kip Hampton, khampton@totalcinema.com

SEE ALSO ^

AxKit.

syntax highlighting: