The Perl and Raku Conference 2025: Greenville, South Carolina - June 27-29 Learn more

 / 
HTML-Display-0.40
River stage one • 2 direct dependents • 3 total dependents
/ HTML::Display::Common

NAME

HTML::Display::Common - routines common to all HTML::Display subclasses

__PACKAGE__->new %ARGS

Creates a new object as a blessed hash. The passed arguments are stored within the hash. If you need to do other things in your constructor, remember to call this constructor as well :


            

              
              
package HTML::Display::WhizBang;
use parent 'HTML::Display::Common';
sub new {
  my ($class) = shift;
  my %args = @_;
  my $self = $class->SUPER::new(%args);
  # do stuff
  $self;
};

$display->display %ARGS

This is the routine used to display the HTML to the user. It takes the following parameters :


            

              
              
html     => SCALAR containing the HTML
file     => SCALAR containing the filename of the file to be displayed
base     => optional base url for the HTML, so that relative links still work
location    (synonymous to base)

Basic usage :


            

              
              
my $html = "<html><body><h1>Hello world!</h1></body></html>";
my $browser = HTML::Display->new();
$browser->display( html => $html );

Location parameter :

If you fetch a page from a remote site but still want to display it to the user, the location parameter comes in very handy :


            

              
              
my $html = '<html><body><img src="/images/hp0.gif"></body></html>';
my $browser = HTML::Display->new();
# This will display part of the Google logo
$browser->display( html => $html, base => 'http://www.google.com' );

AUTHOR

Copyright (c) 2004-2013 Max Maischein <corion@cpan.org>

LICENSE

This module is released under the same terms as Perl itself.