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) 2011 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.