wheei

a javascript native code embed template with

• clear
• powerful
• Compatible

compare with similar libs

fire

output

<%='hello'%>
<%=0%>
<%=false%>
<%=true%>
<%=null%>

escapes html

<%-'1<2'%>

embedded javaScript

<%
    var a=0;
%>
<%-a+1%>

if

<%
    var a=1;
%>
<% if(a===1){ %>

<% }else if(a===2){ %>

<% }else{ %>

<% } %>

if shortcut

<%
    var a=1;
%>
<%? a===1 %>

<%?? a===2 %>

<%??%>

<%?%>

loop

<%var arr=['a','b','c'];if(arr)for(var i=0;i<arr.length;i++){var v=arr[i];%>
    <li><%-i%> : <%-v%></li>
<%}%>

loop shortcut

<%~['a','b','c'] i,v%>
    <li><%-i%> : <%-v%></li>
<%~%>

<%~['a','b','c'] v%>
    <li><%-v%></li>
<%~%>

comment

<%/*this is a comment too*/%>

commment shortcut

<%*
this is a comment
this is a comment
this is a comment
this is a comment
%>
<%*this is a comment too%>

variables output to template

<script>
    var a=<%${id:1,name:'wheei'}%>
    var b=<%$'</script>'%>
    var c=<%$'null'%>
</script>

render html

var html=wheei('<h1><%-it.title%></h1>',{title:'wheei'}); // 'wheei'

get template function

var func=wheei('<h1><%-it.title%></h1>');         // function(it){...}
func({title:'wheei'});                            // 'wheei'

third argument is config

var html=wheei('<%-data%>','ok',{
    argName:data
}); // 'ok'

• open <%
• close %>
• argName it
• strip false strip white-space between lines

the globel default is wheei.conf

• wheei is a global variable (because template function will access it)

beyond

mark safe

    wheei('<%-it%>','<a href="xxx">xxx</a>'); // you will get a `<a href="xxx">xxx</a>` text
    wheei('<%-it%>',wheei.markSafe('<a href="xxx">xxx</a>')); // you will get a link element
    wheei('<%=it%>',wheei.markSafe('<a href="xxx">xxx</a>')); // you will get a link element too

inner template

<%#list data , a%>
    <%~data item%>
        <li><%-item%></li>
    <%~%>
    <%=a%>
<%#%>
<%=list(['first','second'],'aaa')%>

same to

<%function list(data , a){var __out='';%>
    <%~data item%>
        <li><%-item%></li>
    <%~%>
    <%=a%>
<%return __out;} %>
<%=list(['first','second'],'aaa')%>

include template

<script type="text/plain" id="list">
    <%~data item%>
        <li><%-item%></li>
    <%~%>
</script>

wheei.tpls.list = wheei(document.getElementById('list').innerHTML);

<script type="text/plain" id="page">
    <h1>in page</h1>
    <%=wheei.tpls.list(['first','second'])%>
</script>

nodejs with express

npm install wheei --save

var wheei=require('wheei');
var path=require('path');

app.engine('whe',wheei.__express);
app.set('view engine', 'whe');
app.set('views', path.join(__dirname,'views'));
// if `view cache` is `true`,you have to restart server after `.whe` file change
app.set('view cache', true||false);

include

index.whe:

index.whe
<%@ 'whe/a.whe','hello'%>
index.whe

whe/a.whe:

a.whe:<%=it%>

result is:

index.whe
a.whe:hello
index.whe

about the path

just like linux cd

• the root is app.set('views', path.join(__dirname,'views'))
• absolute start with /,like /index.whe
• relative like whe/a.whe ./whe/a.whe ../index.whe