The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

AppLib HTML Generation API

DESCRIPTION

The AppLib HTML Generation API is a set of classes containing mainly static methods that generates HTML for a variety of tasks.

The AppLib::HTML package itself holds commonly used HTML related methods, such as escaping and tag generation.

The AppLib::HTML::Form class contains methods for generating form elements.

The AppLib::HTML::Table is a class that implements the generation of quite complex HTML tables.

escapeText( $text )

The escapeText method escapes 'text' for general purpose uses.

escapeProperty( $text )

The escapeProperty method escapes text for use in HTML tag properties. In these situations, extra attention needs to be paid to ensure that quotes are always properly escaped.

escapeTextArea( $text )

Escape text for the special case of text in a textarea.

escapeHTMLText( $text )

The escapeHTMLText method escapes text for display on a HTML page, especially in situations where the text might contains line breaks etc.

linkCallback( $text, \%args, \%options )

TO BE COMPLETED

tag( $name, \%properties )

Generates an arbitrary tag, somewhat like CGI.pm does.

To reduce load, this method does not do escaping or case alteration. Escaping untrusted strings is left to the caller.

TO BE COMPLETED

tagPair( $name, $props, @contents )

Generate a pair of tags with content in them.

To reduce load, this method does not do escaping or case alteration. Escaping untrusted strings is left to the caller.

TO BE COMPLETED

TO DO

Reorganise the methods somewhat, especially the escaping ones.

Chase down all references to them, and fix them as well ( there will be a lot )

COPYRIGHT

Copyright (C) 2000-2002 Adam Kennedy

This library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version.

This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public License along with this library; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA

Should you wish to utilise this software under a different licence, please contact the author.