
=head1 NAME

HTML::DOM::Element::Link - A Perl class for representing 'link' elements in an HTML DOM tree

=head1 SYNOPSIS

  use HTML::DOM;
  $doc = HTML::DOM->new;
  $elem = $doc->createElement('link');

  $elem->charset('iso-8859-1'); # set attribute
  $elem->href;                  # get attribute
  $elem->tagName;
  # etc

=head1 DESCRIPTION

This class implements 'link' elements in an HTML::DOM tree. It 
implements the HTMLLinkElement DOM interface and inherits from 
L<HTML::DOM::Element> (q.v.).

=head1 METHODS

In addition to those inherited from HTML::DOM::Element and its 
superclasses, this class implements the following DOM methods:

=over 4

=item disabled

Returns a boolean. Pass an argument to set it.

=item charset

=item href

=item hreflang

=item media

=item rel

=item rev

=item target

=item type

Each of these returns the corresponding HTML attribute. If you pass an
argument, it will become the new value of the attribute, and the old value
will be returned.

=item sheet

By default, this returns null. If you provide the HTML::DOM object with a
L<C<css_url_fetcher>|HTML::DOM/css_url_fetcher>, then this returns a style
sheet when applicable.

You can also pass an argument to set it. You normally only do this if 'rel' 
is
set to 'stylesheet', but CSS::DOM is kind, and trusts you know what you are
doing if you set it when that is not the case.

=back

=head1 SEE ALSO

L<HTML::DOM>

L<HTML::DOM::Element>
