HTML-Zoom
view release on metacpan or search on metacpan
---
abstract: 'selector based streaming template engine'
author:
- 'Matt S. Trout <mst@shadowcat.co.uk>'
build_requires: {}
configure_requires:
ExtUtils::MakeMaker: '0'
dynamic_config: 0
generated_by: 'Dist::Zilla version 5.036, CPAN::Meta::Converter version 2.150001'
license: perl
meta-spec:
url: http://module-build.sourceforge.net/META-spec-v1.4.html
Makefile.PL view on Meta::CPAN
# This file was automatically generated by Dist::Zilla::Plugin::MakeMaker v5.036.
use strict;
use warnings;
use ExtUtils::MakeMaker;
my %WriteMakefileArgs = (
"ABSTRACT" => "selector based streaming template engine",
"AUTHOR" => "Matt S. Trout <mst\@shadowcat.co.uk>",
"CONFIGURE_REQUIRES" => {
"ExtUtils::MakeMaker" => 0
},
"DISTNAME" => "HTML-Zoom",
"EXE_FILES" => [],
"LICENSE" => "perl",
"NAME" => "HTML::Zoom",
"PREREQ_PM" => {
"Test::More" => 0,
This archive contains the distribution HTML-Zoom,
version 0.009009:
selector based streaming template engine
This software is copyright (c) 2015 by Matt S. Trout <mst@shadowcat.co.uk>.
This is free software; you can redistribute it and/or modify it under
the same terms as the Perl 5 programming language system itself.
This README file was generated by Dist::Zilla::Plugin::Readme v5.036.
lib/HTML/Zoom.pm view on Meta::CPAN
die "We can't do $meth on ->select('$selector')";
}
}
sub DESTROY {}
1;
=head1 NAME
HTML::Zoom - selector based streaming template engine
=head1 SYNOPSIS
use HTML::Zoom;
my $template = <<HTML;
<html>
<head>
<title>Hello people</title>
</head>
lib/HTML/Zoom.pm view on Meta::CPAN
a bit of breakage between here and 1.0. Hopefully not though. Appendages
crossed and all that.
Worse still, the rest of the distribution isn't documented yet. I'm sorry.
I suck. But lots of people have been asking me to ship this, docs or no, so
having got this class itself at least somewhat documented I figured now was
a good time to cut a first real release.
=head1 DESCRIPTION
HTML::Zoom is a lazy, stream oriented, streaming capable, mostly functional,
CSS selector based semantic templating engine for HTML and HTML-like
document formats.
Which is, on the whole, a bit of a mouthful. So let me step back a moment
and explain why you care enough to understand what I mean:
=head2 JQUERY ENVY
HTML::Zoom is the cure for JQuery envy. When your javascript guy pushes a
piece of data into a document by doing:
lib/HTML/Zoom.pm view on Meta::CPAN
things like to_fh are no longer available.
=head2 POP! GOES THE WEASEL
... and by Weasel, I mean layout.
HTML::Zoom's filehandle object supports an additional event key, 'flush',
that is transparent to the rest of the system but indicates to the filehandle
object to end a getline operation at that point and return the HTML so far.
This means that in an environment where streaming output is available, such
as a number of the L<Plack> PSGI handlers, you can add the flush key to an
event in order to ensure that the HTML generated so far is flushed through
to the browser right now. This can be especially useful if you know you're
about to call a web service or a potentially slow database query or similar
to ensure that at least the header/layout of your page renders now, improving
perceived user responsiveness while your application waits around for the
data it needs.
This is currently exposed by the 'flush_before' option to the collect filter,
which incidentally also underlies the replace and repeat filters, so to
lib/HTML/Zoom.pm view on Meta::CPAN
Some will argue that overloading CSS selectors to do data stuff is a terrible
idea, and possibly even a step towards the "Concrete Javascript" pattern
(which I abhor) or Smalltalk's Morphic (which I ignore, except for the part
where it keeps reminding me of the late, great Tony Hart's plasticine friend).
To which I say, "eh", "meh", and possibly also "feh". If it really upsets
you, either use extra classes for this (and remove them afterwards) or
use special fake elements or, well, honestly, just use something different.
L<Template::Semantic> provides a similar idea to zoom except using XPath
and XML::LibXML transforms rather than a lightweight streaming approach -
maybe you'd like that better. Or maybe you really did want
L<Template Toolkit|Template> after all. It is still damn good at what it does,
after all.
So far, however, I've found that for new sites the designers I'm working with
generally want to produce nice semantic HTML with classes that represent the
nature of the data rather than the structure of the layout, so sharing them
as a common interface works really well for us.
In the absence of any evidence that overloading CSS selectors has killed
children or unexpectedly set fire to grandmothers - and given microformats
have been around for a while there's been plenty of opportunity for
octagenarian combustion - I'd suggest you give it a try and see if you like it.
=head2 GET THEE TO A SUMMARY!
Erm. Well.
HTML::Zoom is a lazy, stream oriented, streaming capable, mostly functional,
CSS selector based semantic templating engine for HTML and HTML-like
document formats.
But I said that already. Although hopefully by now you have some idea what I
meant when I said it. If you didn't have any idea the first time. I mean, I'm
not trying to call you stupid or anything. Just saying that maybe it wasn't
totally obvious without the explanation. Or something.
Er.
( run in 0.249 second using v1.01-cache-2.11-cpan-a5abf4f5562 )