CGI::Widget::Tabs ================= DESCRIPTION CGI::Widget::Tabs lets you simulate tab widgets in HTML. You could benefit from a tab widget if you want to serve only one page. Depending on the tab selected you fetch and display the underlying data. There are three main reasons for taking this approach: 1. For the end user not to be directed to YAL or YAP (yet another link, yet another page), but keep it all together: The single point of entry paradigm. 2. As a consequence the end user deals with a more consistent and integrated GUI. This will give a better "situational awareness" within the application. 3. For the Perl hacker to handle multiple related data sources within the same script environment. As an example the following tabs could be used on a web page for someone's spotting hobby: __________ __________ __________ / Planes \ / Trains \ / Classics \ ------------------------------------------------------ _________ / Bikes \ ------------------------ As you can see, the headings wrap at three and a small indentation is added to the start of the next row. The nice thing about CGI::Widget::Tabs is that the tabs know their internal state. So you can ask a tab for instance which heading has been clicked by the user. This way you get instant feedback. DOCUMENTATION The documentation is included in the module. You can read it's manpage after installation with `perldoc CGI::Widget::Tabs'. If you prefer you can read the documentation before installation with `perldoc ./Tabs.pm' DEPENDENCIES - CGI, CGI::Minimal or another CGI "object broker" with the param() method and with similar behaviour - HTML::Entities - URI - A CSS style sheet for the tabs markup INSTALLATION To install this module type the following: perl Makefile.PL make make test make install DOWNLOAD You can download CGI::Widget::Tabs from CPAN at http://cpan.perl.org. The latest version is always available from the CGI::Widget::Tabs homepage at: http://users.raketnet.nl/koos_pol/en/Tabs/index.html COPYRIGHT AND LICENCE Copyright (c) 2003 Koos Pol. All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself. CHANGES These changes are against the previous version. For a complete history log, see the file 'CHANGES' in the distribution. 1.07 (2003-04-27) ------------------ - Removed the distinction between simple headings and OO headings. Simple headings are now (as they should be) just a variation of OO headings. This greatly simplifies programming logic. One consequence is that the headings() method now only returns OO headings. (Thanks to Bernhard Schmalhofer for suggestions and patches.) - Added a hash as optional initializer for the headings() method. (Thanks to Bernhard Schmalhofer for suggestions and patches.) - Headings can now override the default CSS class using the class() method. (Suggested by Bernie Ledwick ) - Documentation updates $Id: README,v 1.20 2003/04/27 07:49:00 koos Exp $