The Perl and Raku Conference 2025: Greenville, South Carolina - June 27-29 Learn more

JSWARTZ / Mason-Plugin-HTMLFilters-0.03 / lib / Mason / Plugin / HTMLFilters.pm 

            

              
1
2
3
4
5
6
7
8
9
10
—
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111

              
package Mason::Plugin::HTMLFilters;
BEGIN {
  $Mason::Plugin::HTMLFilters::VERSION = '0.03';
}
use Moose;
with 'Mason::Plugin';
1;
__END__
=head1 NAME
Mason::Plugin::HTMLFilters - Filters related to HTML generation
=head1 FILTERS
=over
=item HTML or H
Do a basic HTML escape on the content - just the characters '&', '>', '<', and
'"'.
    <input name="company" value="<% $company | H %>">
=item HTMLEntities
Do a comprehensive HTML escape on the content, using
HTML::Entities::encode_entities.
=item URI or U
URI-escape the content.
    <a href="<% $url | U %>">
=item HTMLPara
Formats a block of text into HTML paragraphs.  A sequence of two or more
newlines is used as the delimiter for paragraphs which are then wrapped in HTML
""<p>""...""</p>"" tags. Taken from L<Template::Toolkit|Template>. e.g.
    % $.HTMLPara {{
    First paragraph.
       
    Second paragraph.
    % }}
     
outputs:
    <p>
    First paragraph.
    </p>
       
    <p>
    Second paragraph.
    </p>
=item HTMLParaBreak
Similar to HTMLPara above, but uses the HTML tag sequence "<br><br>" to join
paragraphs. Taken from L<Template::Toolkit|Template>. e.g.
    % $.HTMLPara {{
    First paragraph.
       
    Second paragraph.
    % }}
     
outputs:
    First paragraph.
    <br><br>
    Second paragraph.
=item FillInForm ($form_data, %options)
Uses L<HTML::FillInForm|HTML::FillInForm> to fill in the form with the
specified I<$form_data> and I<%options>.
    % $.FillInForm($form_data, target => 'form1') {{
    ...
    <form name='form1'>
    ...
    % }}
=back
=head1 SUPPORT
The mailing list for Mason and Mason plugins is
L<mason-users@lists.sourceforge.net>. You must be subscribed to send a message.
To subscribe, visit
L<https://lists.sourceforge.net/lists/listinfo/mason-users>.
You can also visit us at C<#mason> on L<irc://irc.perl.org/#mason>.
Bugs and feature requests will be tracked at RT:
    http://rt.cpan.org/NoAuth/Bugs.html?Dist=Mason-Plugin-HTMLFilters
    bug-mason-plugin-htmlfilters@rt.cpan.org
The latest source code can be browsed and fetched at:
    http://github.com/jonswar/perl-mason-plugin-htmlfilters
    git clone git://github.com/jonswar/perl-mason-plugin-htmlfilters.git
=head1 SEE ALSO
L<Mason|Mason>