---
name: "HTML::Display::Common"
section: "3pm"
platform: "linux"
package: "libhtml-display-perl"
version: "0.40-4"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/HTML::Display::Common"
---

# HTML::Display::Common(3pm)

routines common to all HTML::Display subclasses

## 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.