Lego-block style general purpose template engine
% gem install tzispaThere are 3 template types: layout, static and block:
- layout: these are the skeleton entry points of the rig templates
- static: these are "light" templates that are a included without any processing as plain text
- block: the true core of the rig templates, each block template file has an associated ruby file with the template binder class
To add templates to your app you can use cli coomands
% tzispa generate rig lister --type=layout --app=mainapp
% tzispa generate rig sitefoot --type=static --app=mainapp
% tzispa generate rig product_detail --type=block --app=mainappTemplate variables are specified with:
<var:name/>
And metavariables with:
{%name%}
metavariables are used to make runtime template tags replacements
<fieldset>
<div class='row'>
<div class='column column-80'>
<label for='name'>Nombre *</label>
<input type='text' name='name' id='name' maxlength="64" value='<var:name/>' required='required' />
</div>
<div class='column column-20'>
<label for='skey'>Código</label>
<input type='text' name='skey' id='skey' maxlength="16" value='<var:skey/>'/>
</div>
<a href='<purl:brand_edit[title=edit-brand,id0={%idb%}]/>'><i class='fa fa-edit'></i></a>
</div>in the template binder
def bind!
@idb = context.router_params[:id0]
load_brand if idb
end
private
attr_reader :idb
def load_brand
brand = repository[:brand, :ecomm_shop][idb]
attach(
idb: brand.id,
name: brand.name,
skey: brand.skey
)
endYou can make decisions in your templates using template ife tag:
<ife:test> ..... <else:test/> .... </ife:test>
or without the else part
<ife:test> ..... </ife:test>
<ife:customer_exist>
<div class='row'>
<div class='column column-80'>
<label for='name'>Nombre *</label>
<input type='text' name='name' id='name' maxlength="64" value='<var:name/>' required='required' />
</div>
<div class='column column-20'>
<label for='skey'>Código</label>
<input type='text' name='skey' id='skey' maxlength="16" value='{%skey%}'/>
</div>
</div>
<else:customer_exist/>
<p> There isn't any customer here </p>
</ife:customer_exist> In the binder you must define customer_exist
def bind!
idc = context.router_params[:id0]
customer = context.repository[:customer, :ecomm_shop][idb]
attach(
customer_exist: !customer.nil?
)
endTo repeat a part in the template use loop tag
<loop:ltag> ... </loop:ltag>
<loop:lbrands>
<tr>
<td><var:id/></td>
<td><var:skey/></td>
<td><var:name/></td>
<td class='text-right'>
<a href='<purl:brand_edit[title=edit-brand,id0={%id%}]/>'><i class='fa fa-edit'></i></a>
<a href='javascript:delete_brand("<sapi:brand:delete:{%id%}/>")'><i class='fa fa-trash'></i></a>
</td>
<tr>
</loop:lbrands>In the binder you must use the 'loop_binder' method
def bind!
attach(
lbrands: loop_binder(:lbrands).bind!(&load_brands)
)
end
private
def load_brands
Proc.new {
repository[:brand, :ecomm_shop].list.map { |b|
loop_item(
id: b.id,
skey: b.skey,
name: b.name
)
}
}
endRig templates can build urls for you. There are 2 url types:
Site path urls: used to provide links to site pages (layouts)
<purl:route_id/>
<purl:route_id[param1=value,param2=value]/>
<purl:brands[title=brand-list]/>
<purl:index/>Site full urls: used to provide links to site pages (layouts)
<url:route_id/>
<url:route_id[param1=value,param2=value]/>
<url:brand_edit[title=brand-edit,idb={%brand_id%}]/>
<url:index/>The purl/url route_id/layout's must be defined in the start.ru file with route_rig_layout(layout_id, path_pattern)
route_rig_layout :brands, '/:title/:layout(.:format)'
route_rig_layout :brand_edit, '/:title/:idb/:layout(.:format)'Api urls: used to provide urls to the application Api
<api:handler:verb/>
<api:handler:verb:predicate/>
<api:customer:add:address/>
<api:brand:{%verb%}/>You can also use 'sapi' to automagically provide signed api urls in your apps
<sapi:handler:verb/>
<sapi:handler:verb:predicate/>
<sapi:customer:add:address/>
<sapi:brand:{%verb%}/>You can include block and static rig templates using these tags:
<blk:name[param1=value,param2=value, ... ]/>
<static:name/>
As you can see, template parameters can be passed in the block tag. These parameters will be available in the binder. You can also use template subdomains using dot notation in the name
<!DOCTYPE html>
<html lang="es">
<head>
<meta charset="utf-8" />
<blk:metasense/>
<meta name="viewport" content="width=device-width, initial-scale=1" />
<static:comassert/>
</head>
<body>
<blk:header/>
<div class="container m-bot-35 m-top-25 clearfix">
<div class="row">
<div class="three columns m-bot-25">
<blk:sidebar/>
</div>
<div class="nine columns m-bot-25">
<blk:folder.edit[doc=dokum]/>
</div>
</div>
</div>
<blk:widget.footer/>
<static:footscripts/>
</body>
</html>In the folder binder you can access template parameters
def bind!
@doctype = params[:doc]
end