GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  ROSE::HTML::IMAGE (3)

.ds Aq ’

NAME

Rose::HTML::Image - Object representation of the "img" HTML tag.

CONTENTS

SYNOPSIS



    $img = Rose::HTML::Image->new(src => /logo.png,
                                  alt => Logo);

    $img->document_root(/var/web/htdocs);

    # <img alt="Logo" height="48" src="/logo.png" width="72">
    print $img->html;

    $img->alt(undef);

    # <img alt="" height="48" src="/logo.png" width="72" />
    print $img->xhtml;

    ...



DESCRIPTION

Rose::HTML::Image is an object representation of the <img> HTML tag. It includes the ability to automatically fill in the width and height HTML attributes with the correct values, provided it is given enough information to find the actual image file on disk. The Image::Size module is used to read the file and determine the correct dimensions.

This class inherits from, and follows the conventions of, Rose::HTML::Object. Inherited methods that are not overridden will not be documented a second time here. See the Rose::HTML::Object documentation for more information.

HTML ATTRIBUTES

Valid attributes:



    alt
    class
    dir
    height
    id
    ismap
    lang
    longdesc
    name
    onclick
    ondblclick
    onkeydown
    onkeypress
    onkeyup
    onmousedown
    onmousemove
    onmouseout
    onmouseover
    onmouseup
    src
    style
    title
    usemap
    width
    xml:lang



Required attributes:



    alt
    src



Boolean attributes:



    ismap



CONSTRUCTOR

<B>new PARAMSB> Constructs a new Rose::HTML::Image object based on PARAMS, where PARAMS are name/value pairs. Any object method is a valid parameter name.

OBJECT METHODS

<B>document_root [PATH]B> Get or set the web site document root. This is combined with the value of the src HTML attribute to build the path to the actual image file on disk.

If running in a mod_perl 1.x environment, the document root defaults to the value returned by:



    Apache->request->document_root



If running in a mod_perl 2.x environment, the document root defaults to the value returned by:



    Apache2::RequestUtil->request->document_root



Note that you must have the GlobalRequest option set for this to work. If you do not, the document root defaults to undef.

These calls are made once for each Rose::HTML::Image object that needs to use the document root.

<B>init_size [PATH]B> Try to set the width and height HTML attributes but using Image::Size to read the image file on disk. If a PATH argument is passed, the image file is read at that location. Otherwise, if the path() attribute is set, that path is used. Failing that, the width and height HTML attributes are simply not modified.
<B>path [PATH]B> Get or set the path to the image file on disk.

If a PATH argument is passed and document_root() is defined, then PATH has document_root() removed from the front of it (substitution anchored at the start of PATH) and the resulting string is set as the value of the src HTML attribute. Regardless of the value of document_root(), init_size() is called in an attempt to set the height and width HTML attributes.

The current value of the path object attribute is returned.

<B>src [SRC]B> Get or set the value of the src HTML attribute.

If a SRC argument is passed and a file is found at the path specified by SRC, then path() is set to SRC. Otherwise, path() is set to the concatenation of document_root() and SRC. In either case, init_size() is called in an attempt to set the height and width HTML attributes.

The current value of the src HTML attribute is returned.

AUTHOR

John C. Siracusa (siracusa@gmail.com)

LICENSE

Copyright (c) 2010 by John C. Siracusa. All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 ROSE::HTML::IMAGE (3) 2015-03-17

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.