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@mindspring.com)

COPYRIGHT

Copyright (c) 2006 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.