The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.
 / 
Catalyst-View-Template-Pure-0.013
River stage zero No dependents
++
/ Catalyst::View::Template::Pure::Helpers

NAME

Catalyst::View::Template::Pure::Helpers - Simplify some boilerplate

SYNOPSIS

    package  MyApp::View::Story;

    use Moose;
    use Catalyst::View::Template::Pure::Helpers (':ALL');
    extends 'Catalyst::View::Template::Pure';

    has [qw/title body capture arg q/] => (is=>'ro', required=>1);

    __PACKAGE__->config(
      returns_status => [200],
      template => q[
        <!doctype html>
        <html lang="en">
          <head>
            <title>Title Goes Here</title>
          </head>
          <body>
            <a name="hello">hello</a>
          </body>
        </html>      
      ],
      directives => [

        'a[name="hello"]@href' => Uri('Story.last',['={year}'], '={id}', {q=>'={q}',rows=>5}),
      ],
    );

DESCRIPTION

Generates code for some common tasks you need to do in your templates, such as build URLs etc.

Uri

Used to generate a URL via $c->uri_for. Takes signatures like:

    Uri("$controller.$action", \@captures, @args, \%query)
    Uri(".$action", \@captures, @args, \%query)
    Uri("$relative_action_private_name", \@captures, @args, \%query)
    Uri("$absolute_action_private_name", \@captures, @args, \%query)

We fill placeholders in the arguments in the same was as in templates, for example:

    Uri('Story.last',['={year}'], '={id}', {q=>'={q}',rows=>5})

Would fill year, id and q from the current data context. We also merge in the following keys to the current data context:

    captures => $c->request->captures,
    args => $c->request->args,
    query => $c->request->query_parameters;

To make it easier to fill data from the current request. For example:

    Uri('last', ['={captures}'], '={args}')

You can also use data paths placeholders to indicate the action on which we are building a URI:

    Uri('={delete_link}', ['={captures}'], '={args}')

In this case the placeholder should refer to a Catalyst::Action object, not a string:

    $c->view('List', delete_link => $self->action_for('item/delete'));

This may change in a future version.

Uri("$controller.$action", \@captures, @args, \%query)

URI for an action at a specific Controller. '$controller' should be a controller namespace part, for example 'MyApp::Controller::User' would be 'User' and 'MyApp::Controller::User::Info' would be 'User::Info'.

Uri(".$action", \@captures, @args, \%query)

Relative version of the previous helper. Set the controller to the current controller.

Uri("$absolute_action_private_name", \@captures, @args, \%query)

Creates a URI for an absolute action namespace. Examples:

    Uri('/root/user')
Uri("$relative_action_private_name", \@captures, @args, \%query)

Creates a URI for a relative (under the current controller namespace) action namespace. Examples:

    Uri('user/info')

Apply

Takes a view name and optionally arguments that are passed to ->new. Used to apply a view over the results of a previous one, allowing for chained views.

    'ul.todo-list li' => {
      '.<-tasks' => Apply('Summary::Task'),
    },

Useful when you wish to delegate the job of processing a section of the template to a different view, but you don't need a full include.

Wrap

Used to pass the response on a template to another template, via a 'content' argument. Similar to the 'wrapper' processing instruction.

SEE ALSO

Template::Pure, Catalyst::View::Template::Pure

AUTHOR

    John Napiorkowski L<email:jjnapiork@cpan.org>

COPYRIGHT & LICENSE

Please see Catalyst::View::Template::Pure> for copyright and license information.