html5 / template
Inline Templating component
Installs: 3 099
Dependents: 2
Suggesters: 0
Security: 0
Stars: 1
Watchers: 3
Forks: 0
Open Issues: 0
Language:HTML
Requires
- php: >=7.0
- gismo/expression-language: ^3.1
- html5/htmlreader: ^1.1
- symfony/yaml: *
Requires (Dev)
- phpunit/phpunit: ^6.2
This package is auto-updated.
Last update: 2024-12-06 09:21:15 UTC
README
Html5 Template - Template Rendering
angularjs-like inline-templates for PHP7.
Planned as replacement for PHPTAL - which is quite fine but not enough extensible for cluster / platform usage.
Gismo Template does not precompile any code. It generates the pages on the fly.
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)
Example
Template:
<div go-if="showHeader==true">Welcome {{ user.name }}</div> <div go-foreach="products as curProduct"> <span go-bind="curProduct.name"></span> </div>
Parser:
$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
: Conditiongo-foreach
: Loopgo-repeat
: Loopgo-continue
: Loop start-overgo-break
: Quit loopgo-bind
: Inject string datago-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
<div go-loop="100 indexBy index">
<go-break go-if="! count(productList) < index"/>
...
</div>
or use continue to skip elements:
<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()
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)
Elements
go-text
: Inject Textgo-define
: Define Variables in Scopego-dump
: Dump a variable or scopego-macro
: Define a macrogo-callmacro
: Call a macrogo-struct
: Return array data sections defined by go-sectiongo-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:
<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:
<body> <go-callmacro name="printDemoTable(shoppingCart.headers, shoppingCart.items)"/> </body>
Benchmark
Small Example from above:
Parsing + Rendering: <0.01s
Big demo with ~2000 Lines of template-code
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:
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