TABLE OF CONTENTS

文档

Mojolicious::Plugin::DefaultHelpers - 默认的 helpers 插件

概述

# Mojolicious
$self->plugin('DefaultHelpers');

# Mojolicious::Lite
plugin 'DefaultHelpers';

描述

Mojolicious::Plugin::DefaultHelpers 中收集了所有的 Mojolicious 渲染模板用的 Helpers.扶凯: 其实这个就是传给模板技术使用的一些函数,可以让你在模板中调用。

这是一个核心插件,这意味着它总是开户的。这个中的代码是非常好的例子,学习来创建新插件的话,可以考虑直接 fork 它.

HELPERS

Mojolicious::Plugin::DefaultHelpers 实现了下面这些 helpers. 扶凯: 注意如果使用其它的模板插件要调用这些功能,比如 Xslate 的模板插件,如果要使用这些 helpers 的话,只需要使用 $c.method 这种方式来调用就行了。

app

%= app->secret

这是 "app" in Mojolicious::Controller 的别名.

config

%= config 'something'

这是 "config" in Mojo 的别名。

content

%= content foo => begin
  test
% end
%= content bar => 'Hello World!'
%= content 'foo'
%= content 'bar'
%= content

存储部分要显示的内容到指定名字的缓冲区和并可以检索它.

content_for

% content_for foo => begin
  test
% end
%= content_for 'foo'

追加分要显示的内容到指定名字的缓冲区和并可以检索它

% content_for message => begin
  Hello
% end
% content_for message => begin
  world!
% end
%= content_for 'message'

current_route

% if (current_route 'login') {
  Welcome to Mojolicious!
% }
%= current_route

检查 current_route 的这个名字.

dumper

%= dumper {some => 'data'}

使用 Data::Dumper 这个模块 Dump 出数组成 Perl 的数组结构。

extends

% extends 'blue';
% extends 'blue', title => 'Blue!';

扩展模板。所有额外的值会合并到 stash.

flash

%= flash 'foo'

这个是 "flash" in Mojolicious::Controller 的别名.

include

%= include 'menubar'
%= include 'menubar', format => 'txt'

包括进来部分的模板,所有的参数需要加在后面,只可用在局部模板上。

layout

% layout 'green';
% layout 'green', title => 'Green!';

显示 layout 的模板,附加上的值会合并到 stash.

memorize

%= memorize begin
  %= time
% end
%= memorize {expires => time + 1} => begin
  %= time
% end
%= memorize foo => begin
  %= time
% end
%= memorize foo => {expires => time + 1} => begin
  %= time
% end

记住块中的的结果在内存中,预防将来执行时在次用到.

param

%= param 'foo'

"param" in Mojolicious::Controller 的别名.

session

%= session 'foo'

"session" in Mojolicious::Controller 的别名.

stash

%= stash 'foo'
% stash foo => 'bar';

"stash" in Mojolicious::Controller 的别名.

%= stash 'name' // 'Somebody'

title

% title 'Welcome!';
% title 'Welcome!', foo => 'bar';
%= title

网页的 title. 附加的值会合并到 stash.

url_for

%= url_for 'named', controller => 'bar', action => 'baz'

"url_for" in Mojolicious::Controller 的别名.

url_with

%= url_with 'named', controller => 'bar', action => 'baz'

这个有点象 url_for, 但是继承当前网页的查询参数。

%= url_with->query([page => 2])

METHODS

Mojolicious::Plugin::DefaultHelpers 继承全部的 Mojolicious::Plugin 的方法,并自己实现了一些.

register

$plugin->register(Mojolicious->new);

注册一个 helpers 到 Mojolicious 的应用.

SEE ALSO

Mojolicious, Mojolicious::Guides, http://mojolicio.us.