Rose::HTML::Anchor.3pm

Langue: en

Version: 2008-02-25 (mandriva - 01/05/08)

Section: 3 (Bibliothèques de fonctions)

NAME

Rose::HTML::Anchor - Object representation of an HTML anchor.

SYNOPSIS

     $a = Rose::HTML::Anchor->new(href => 'apple.html', link => 'Apple');
 
     print $a->html;
 
     $a->contents(Rose::HTML::Image->new(src => 'a.gif'));
 
     print $a->html;
 
     ...
 
 

DESCRIPTION

Rose::HTML::Anchor is an object representation of an HTML anchor, or ``a'' tag.

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:
     accesskey
     charset
     class
     coords
     dir
     href
     hreflang
     id
     lang
     name
     onblur
     onclick
     ondblclick
     onfocus
     onkeydown
     onkeypress
     onkeyup
     onmousedown
     onmousemove
     onmouseout
     onmouseover
     onmouseup
     rel
     rev
     shape
     style
     tabindex
     title
     type
     xml:lang
 
 

CONSTRUCTOR

new PARAMS
Constructs a new Rose::HTML::Anchor object based on PARAMS, where PARAMS are name/value pairs. Any object method is a valid parameter name.

OBJECT METHODS

contents [ARGS]
Get or set the contents of the anchor tag. This is usually the text that appears as the link, but may also be an image or other arbitrary HTML. ARGS may be any combination of one or more strings or Rose::HTML::Object-derived objects, or a reference to an array of the same.

Returns the list of contents in list context, or the first item in the list of contents in scalar context.

link [ARGS]
This is an alias for the contents method.

AUTHOR

John C. Siracusa (siracusa@gmail.com) Copyright (c) 2008 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.