NAME

HTML::Widget::Plugin::Link - a hyperlink

SYNOPSIS

$widget_factory->link({
  text => "my favorite D&D pages",
  href => 'http://rjbs.manxome.org/rubric/entries/tags/dnd',
});

...or...

$widget_factory->link({
  html => "some <em>great<em> d&amp;d pages",
  href => 'http://rjbs.manxome.org/rubric/entries/tags/dnd',
});

DESCRIPTION

This plugin provides a basic input widget.

METHODS

provided_widgets

This plugin provides the following widgets: link

link

This method returns a basic text hyperlink.

In addition to the generic HTML::Widget::Plugin attributes, the following are valid arguments:

href

This is the URI to which the link ... um ... links. If no href is supplied, an exception is thrown.

html

text

Either of these may contain the text of created link. If passed as html, it is not escaped; if passed as text, it is. If no text is supplied, the href is used. If both options are provided, an exception is thrown.

AUTHOR

Ricardo SIGNES <rjbs @ cpan.org>

COPYRIGHT

Copyright (C) 2005-2007, Ricardo SIGNES. This is free software, released under the same terms as perl itself.