Rose::HTML::Anchor(3p)

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