NAME

Mason::Filters::Standard - Standard filters

DESCRIPTION

These filters are automatically composed into Mason::Component.

FILTERS

Capture ($ref)

Uses $m->capture to capture the content in $ref instead of outputting it.

% $.Capture(\my $content) {{
  <!-- this will end up in $content -->
% }}

... do something with $content

CompCall ($path, @args...)

Calls the component with path and @args, just as with $m->scomp, with an additional coderef argument yield that can be invoked to generate the content. Arguments passed to yield can be accessed inside the content via @_. This is the replacement for Mason 1's Components With Content.

In index.mc:
  % $.CompCall ('list_items.mi', items => \@items) {{
  <li><% $_[0] %></li>
  % }}

In list_items.mi:
  <%class>
  has 'items';
  has 'yield';
  </%class>

  % foreach my $item (@{$.items}) {
  <% $.yield->($item) %>
  % }

NoBlankLines

Remove lines with only whitespace from content. This

% $.NoBlankLines {{

hello


world    
% }}

yields

hello
world

Repeat ($count)

Repeat the content block $count times. Note that the block is re-executed each time, which may result in different content.

<!-- Prints 1 to 5 -->
% my $i = 1;
% $.Repeat(5) {{
   <% $i++ %><br>
% }}

Tee ($ref)

Uses $m->capture to capture the content in $ref, and also output it.

% $.Tee(\my $content) {{
  <!-- this will end up in $content and also be output -->
% }}

...

<!-- output content again down here -->
<% $content %>

Trim

Remove whitespace from the beginning and end of the content.

SEE ALSO

Mason::Manual::Filters, Mason

AUTHOR

Jonathan Swartz <swartz@pobox.com>

COPYRIGHT AND LICENSE

This software is copyright (c) 2012 by Jonathan Swartz.

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