NAME

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

SYNOPSIS

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

DESCRIPTION

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="">

Tag Reference

There are no named functions for this tag library.

AUTHOR

Kip Hampton, khampton@totalcinema.com

COPYRIGHT

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.

SEE ALSO

AxKit