The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.
 / 
HTML-Filter-Callbacks-0.09
River stage zero No dependents
++
/ HTML::Filter::Callbacks::Tag

NAME

HTML::Filter::Callbacks::Tag

DESCRIPTION

This will be passed to the callbacks you add to the HTML::Filter::Callbacks object. See the SYNOPSIS of HTML::Filter::Callbacks for usage.

METHODS

new

creates an object.

set

used internally to initialize the object.

name

returns the tag name.

attr

takes an attribute name and returns the attribute value or undef if there's no attribute of the name.

text

returns any text (everything other than tags) before the tag. This typically returns white spaces between the tags for an open (start) tag, and the content of the tag for a close (end) tag, but don't count on that as HTMLs are not always well-structured.

You can replace the text by passing an extra argument.

add_attr

takes an attribute name and its value to add to the tag. If there's an attribute of the name, the value will be replaced.

remove_attr

takes an attribute name to remove. You can also pass a regular expression if you remove arbitrary attributes.

replace_attr

takes an attribute name and its value to replace. You can also pass a regular expression if you replace arbitrary attributes.

replace_tag

takes an tag name and its value to replace.

remove_tag

removes the tag entirely. Note that this only removes a start or end tag, not the pair. So you usually need to add another callback to remove the counterpart.

remove_text

removes the text before the tag.

remove_text_and_tag

removes both the text and the tag.

append

takes an HTML to insert after the tag. As of this writing, you need to escape the HTML by yourself if necessary.

prepend

takes an HTML to insert just before the tag, namely between the skipped text and the tag. As of this writing, you need to escape the HTML by yourself if necessary.

as_string

returns an HTML expression of the tag (with the skipped and inserted texts).

AUTHOR

Kenichi Ishigaki, <ishigaki@cpan.org>

Yuji Shimada <xaicron@cpan.org>

COPYRIGHT AND LICENSE

Copyright (C) 2009 by Kenichi Ishigaki.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.