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.