Apache::Wyrd::CGICond - Selectively display or hide data based on CGI state



NAME

Apache::Wyrd::CGICond - Selectively display or hide data based on CGI state


SYNOPSIS

    <Apache::Wyrd::CGICond var="sam">
      This text will appear if the CGI variable "sam"
      is set (has a value other than ''/0/undef)
    </Apache::Wyrd::CGICond>
    <Apache::Wyrd::CGICond var="!sam,pete">
      This text will appear if the CGI variables "sam" and "pete"
      are null (have a value of ''/0/undef)
    </Apache::Wyrd::CGICond>
    <Apache::Wyrd::CGICond var="?sam,pete">
      This text will appear if either of the CGI variables
      "sam" and "pete" are set
    </Apache::Wyrd::CGICond>
    <Apache::Wyrd::CGICond var="?!sam,pete">
      This text will appear if either of the CGI
      variables "sam" and "pete" are undef
    </Apache::Wyrd::CGICond>


DESCRIPTION

Hides or displays enclosed text depending on the undefined/defined value of CGI parameters. Uses the Apache::Wyrd::Interfaces::Setter style meta characters to determine the behavior in relation to the named CGI parameters.

HTML ATTRIBUTES

var
Defines the salient variable(s). Multiple values are separated with commas or whitespace.

The first characters of this value provide modifiers to determine the behavior. If missing, the test will be simply for the availability of ALL the values.

a '?' will show the text if ANY of the variables are non-null, a '!' will do so if NONE of the variables are non-null. A '?!' will show the text if any of the variables are null. (see the SYNOPSIS)

PERL METHODS

NONE


BUGS/CAVEATS/RESERVED METHODS

Reserves the _format_output method.


AUTHOR

Barry King <wyrd@nospam.wyrdwright.com>


SEE ALSO

Apache::Wyrd
General-purpose HTML-embeddable perl object


LICENSE

Copyright 2002-2004 Wyrdwright, Inc. and licensed under the GNU GPL.

See LICENSE under the documentation for Apache::Wyrd.


TODO

Variant which operates on the definition of the variable, not it's non-null status, but that might be too un-perlish :).

 Apache::Wyrd::CGICond - Selectively display or hide data based on CGI state