AxKit::XSP::Param - A namespace wrapper for accessing HTTP request paramaters.

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

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

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

    AxAddXSPTaglib AxKit::XSP::Param

The XSP param: tag library implements a simple way to access HTTP request parameters (query string and posted form data) by field name.

Thus, the value submitted from this text box

    <input type="text" name="username"/>

is available after POSTing as

    <param:username/>

The same is true for information passed through the query string.

The best way to describe this taglib's use is with a few examples:

Simple inline text insertion -

    <p>
      Greetings, <param:username />, welcome to our site! 
    </p>

As the contents of another element -

    <custom-element><param:param_name /></custom-element>

As the attribute value for another elememnt -

    <input type="hidden" name="foo">
      <xsp:attribute name="value"><param:foo/></xsp:attribute>
    </input>

Note that if the specified parameter field does not exist no error is thrown. So, this:

    <input type="hidden" name="secret_data">
      <xsp:attribute name="value"><param:bogus_name/></xsp:attribute>
    </input>

Will result in following after proccessing:

    <input type="hidden" name="secret_data" value="">

There are no named functions for this tag library.

Kip Hampton, khampton@totalcinema.com

Copyright (c) 2001 Kip Hampton. All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

AxKit