, (*1)
Html5 Template - Template Rendering
angularjs-like inline-templates for PHP7., (*2)
Planned as replacement for PHPTAL - which is quite fine but not enough extensible
for cluster / platform usage., (*3)
Gismo Template does not precompile any code. It generates the pages on the fly., (*4)
Features:
* Works with HTML5 and XHTML (XHTML preferred)
* IDE supported template-development
* Generate HTML, plain-Text or struct-data from one file
* Supports macros
* Import other templates from virtual storage (cloud-ready)
* Verbose and useful error-messages with lineNo and xpath
* Secure and powerful expression engine (Symfony Component also used by Twig), (*5)
Example
Template:, (*6)
<div go-if="showHeader==true">Welcome {{ user.name }}</div>
<div go-foreach="products as curProduct">
<span go-bind="curProduct.name"></span>
</div>
Parser:, (*7)
$template = new HtmlTemplate();
echo $template->render("template.xhtml", ["showHeader" => true, "producs"=> [ new Product("prod1"), new Product("Product2)" ]]);
Install using Composer
composer require html5/template
Attributes
-
go-if
: Condition
-
go-foreach
: Loop
-
go-repeat
: Loop
-
go-continue
: Loop start-over
-
go-break
: Quit loop
-
go-bind
: Inject string data
-
go-html
: Inject html data
Conditions
<div go-if="name == 'Matthias'">
Hello {{ name }}
<div>
Foreach Loops
<div go-foreach="products as product">
Product Title: {{product.title}}
</div>
<div go-foreach="data as curKey => curVal">
Key: {{curKey}} Value: {{curVal}}
</div>
Repeat Loops
<div go-repeat="100 indexBy myIndex">
Line {{ myIndex }}: Hello
</div>
break / continue a loop
You can use conditions to break or continue a loop, (*8)
<div go-loop="100 indexBy index">
<go-break go-if="! count(productList) < index"/>
...
</div>
or use continue to skip elements:, (*9)
<div go-foreach="products as product">
<go-continue go-if="product.isHidden == true"/>
...
</div>
Bind escaped Value
<span go-bind="user.name">Name to show if user.name is null</span>
The data will be escaped by htmlspecialchars()
, (*10)
Bind Html-Code
<div go-html="page.htmlCode">Show <b>this</b> if page.htmlCode is null</div>
Add CSS Classes dynamicly
<div go-class="{cssClassName: name=='Matthes', otherClassName: highlight==true}">..</div>
Show/Hide Elements
<div go-show="showIt==true"></div>
<div go-hide="hideIt==true"></div>
if hidden it adds the css-class ng-hide
(also used by angularjs), (*11)
Elements
-
go-text
: Inject Text
-
go-define
: Define Variables in Scope
-
go-dump
: Dump a variable or scope
-
go-macro
: Define a macro
-
go-callmacro
: Call a macro
-
go-struct
: Return array data sections defined by go-section
-
go-section
: Define or overwrite struct data
Interceptors
Macros
Macros can be used to create Output on multiple positions. To define a macro use the go-macro
-Element:, (*12)
<go-macro name="printDemoTable(headers, data)">
<table>
<thead>
<tr>
<td go-foreach="headers as curHeader">{{ curHeader }}</td>
</tr>
</thead>
<tbody>
...
</tbody>
</table>
</go-macro>
To generate your Table use go-callmacro
- Element:, (*13)
<body>
<go-callmacro name="printDemoTable(shoppingCart.headers, shoppingCart.items)"/>
</body>
Benchmark
Small Example from above:, (*14)
Parsing + Rendering: <0.01s
Big demo with ~2000 Lines of template-code, (*15)
Template-Parsing: <10ms
Rendering: <15ms
Installing V8JS on Ubuntu 16.04
Since there is no apt package for v8js you have to do it manually:, (*16)
sudo add-apt-repository ppa:pinepain/libv8-5.2
sudo apt-get update
sudo apt-get install libv8-dev g++ cpp php-pear php7.0-dev
sudo pecl install v8js
sudo bash
echo "extension=v8js.so" > /etc/php/7.0/apache2/conf.d/20-v8js.ini
echo "extension=v8js.so">/etc/php/7.0/cli/conf.d/20-v8js.ini
service apache2 restart
Author
Written 2016 by Matthias Leuffen http://leuffen.de, (*17)