package Template::Liquid::Tag::Break;
our $VERSION = '1.0.6';
require Template::Liquid::Error;
require Template::Liquid::Utility;
BEGIN { use base 'Template::Liquid::Tag'; }
sub import { Template::Liquid::register_tag('break') }
sub new {
my ($class, $args) = @_;
raise Template::Liquid::Error {type => 'Context',
message => 'Missing template argument',
fatal => 1
}
if !defined $args->{'template'};
raise Template::Liquid::Error {type => 'Context',
message => 'Missing parent argument',
fatal => 1
}
if !defined $args->{'parent'};
if ($args->{'attrs'}) {
raise Template::Liquid::Error {
type => 'Syntax',
message => 'Bad argument list in ' . $args->{'markup'},
fatal => 1
};
}
my $s = bless {name => '#-' . $1,
nodelist => [],
tag_name => $args->{'tag_name'},
template => $args->{'template'},
parent => $args->{'parent'},
markup => $args->{'markup'}
}, $class;
return $s;
}
sub render {
my $s = shift;
$s->{template}->{break} = 1;
return '';
}
1;
=pod
=encoding UTF-8
=head1 NAME
Template::Liquid::Tag::Break - For-block killing construct
=head1 Synopsis
{% for item in collection %}
{% if item.condition %}
{% break %}
{% endif %}
{% endfor %}
=head1 Description
You can use the C<{% break %}> tag to break out of the enclosing
L<for|Template::Liquid::Tag::For> block. Every for block is implicitly ended
with a break.
=head1 See Also
Liquid for Designers: http://wiki.github.com/tobi/liquid/liquid-for-designers
L<Template::Liquid|Template::Liquid/"Create your own filters">'s docs on
custom filter creation
=head1 Author
Sanko Robinson <sanko@cpan.org> - http://sankorobinson.com/
The original Liquid template system was developed by jadedPixel
(http://jadedpixel.com/) and Tobias Lütke (http://blog.leetsoft.com/).
=head1 License and Legal
Copyright (C) 2009-2012 by Sanko Robinson E<lt>sanko@cpan.orgE<gt>
This program is free software; you can redistribute it and/or modify it under
the terms of The Artistic License 2.0. See the F<LICENSE> file included with
this distribution or http://www.perlfoundation.org/artistic_license_2_0. For
clarification, see http://www.perlfoundation.org/artistic_2_0_notes.
When separated from the distribution, all original POD documentation is
covered by the Creative Commons Attribution-Share Alike 3.0 License. See
http://creativecommons.org/licenses/by-sa/3.0/us/legalcode. For
clarification, see http://creativecommons.org/licenses/by-sa/3.0/us/.
=cut