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