ecomfe / etpl Goto Github PK

View Code? Open in Web Editor NEW

495.0 495.0 96.0 1.06 MB

ETPL是一个强复用、灵活、高性能的JavaScript模板引擎，适用于浏览器端或Node环境中视图的生成。

Home Page: http://ecomfe.github.io/etpl/

License: BSD 3-Clause "New" or "Revised" License

JavaScript 52.52% CSS 0.66% HTML 46.79% Shell 0.03%

etpl's People

Stargazers

Watchers

Forkers

junmer lykling andrew703 zhanglei xiaosi rubylouvre jiangjunwei strwind quyatong duanlixin java-sparrow jshi-git asd123freedom lujiabz ccksfh torrylin solidco2 lucifier129 newsky smartcloud2025 mailyupeng ifa6 bigrats zhyt201 mzw11112008 cx898 chenyuanyang work0120 wenchaoliu gitter-badger biggu0 companyforme elma-cao sdtm1016 okyping dlpc bodley 24wangchen liuyuxin940308 merlot1818 jnoodle jailecoeu unclegogo001 jl9n hadesdu xiaoqiang-zhao hushicai xutingting02 firede is00hcw x710894881 smartfire mynane cxtom shangerbingenius xsls feibinyang homfen wslx520 liuwei3230 eric-peng wuyongxing jackeasons cmal hiekay gamehu yibuyisheng liangrongliu ycycwx amtool duzhanyuan hetianzhuo javascriptplugins lrcchuan2016 demon1110 xminger rebeccarrr onlinelemon ice450028456 zero-yang junhyan yaomengchen db-murphy gaecom evanhe810 bzliukai ice-zjchen wuwenchang nweller-dc zhuxingyu19 wwwk changhaoliang agigleux-limited jackjet soupria wxlvip

etpl's Issues

target手动闭合不管用？

<!--  这里是注释 -->
<!-- target: 1-->
xxx1
<!-- /target -->

<! -- 这里是注释 -->
<!-- target: 2 -->
xxx2

target 1把注释内容也给包含进去了，但是我不想让注释内容插入到html中。。。所以尝试用了手工闭合target，结果貌似不管用。。。

当使用filter并传递参数时输出不合预期

var etpl = require('etpl')
etpl.addFilter('trim', function (s, space) { return s.substring(space) })
var render = etpl.compile('${id | trim(${space})}')
var data = { id: 'abc', space: 1 }
render(data)
// -> "${id | trim(1)}"

已经修复了 #8 的错误保证能顺利执行

预期输出应该是abc在截取掉1位（space控制）后的字符串，即"bc"，但真实输出是"${id | trim(1)}"，逻辑不大能分析出来……似乎trim本身也没有执行

loader plugin的normalize有问题

直接将resourceId切开，并忽略了.和..，导致relative id无法正确解析出对应的URL

后续发PR过来

ETPL3 模版继承（母版）功能改进的方案投票

在ETPL3.0中计划target和master归一化，只保留target，删除master。也就是说，未来的模板继承（母版功能），会这么写：

<!-- target: masterTarget -->
<!-- target: myTarget[master=masterTarget] -->

在ETPL2中，target内通过content，覆盖master中contentplaceholder的部分。在smarty和nunjucks中，模板继承的内容覆盖是通过block来实现的。block可以表达contentplaceholder，也可以被继承的block覆盖。

但是，ETPL提供了命令标签的自闭合功能，当contentplaceholder没有默认内容时，是可以不写闭合的。而content也是可以不写闭合的(content允许不写闭合还有一个弊端，content之间无法嵌套)。

所以，在ETPL3.0中，需要对使用contentplaceholder＋content，或使用block进行选择。

方案描述

方案1: 放弃`contentplaceholder`＋`content`，使用`block`

使用该方案，在任何情况下，block都需要手工闭合

<!-- target: masterTarget -->
<header><!-- block: header --><!-- /block --></header>
<div><!-- block: content -->default content<!-- /block --></div>

<!-- target: myTarget[master=masterTarget] -->
<!-- block: header -->my header<!-- /block -->
<!-- block: content -->my content<!-- /block -->

方案2: 沿用ETPL2中的`contentplaceholder`＋`content`

和ETPL2使用方法一致

<!-- target: masterTarget -->
<header><!-- contentplaceholder: header --></header>
<div><!-- contentplaceholder: content -->default content<!-- /contentplaceholder --></div>

<!-- target: myTarget[master=masterTarget] -->
<!-- content: header -->my header
<!-- content: content -->my content

方案决策

请投票：

A: 使用方案1，放弃contentplaceholder＋content，使用block
B: 使用方案2，沿用ETPL2中的contentplaceholder＋content

无论使用哪种方案，ETPL3的升级都会推出模版自动升级工具。投票时无需考虑迁移成本。

能use或import一个master吗

比如

<!-- master: sidebar -->
<div class="sidebar">
    <!-- contentplaceholder: content -->
</div>

<!-- target: main -->
<header>Hello</header>
<!-- use: sidebar -->
    <!-- content: content -->
    This is Sidebar
<!-- /use -->

现在得这么写

<!-- target: sidebarHead -->
<div class="sidebar">

<!-- target: sidebarTail -->
</div>

<!-- target: main -->
<header>Hello</header>
<!-- import: sidebarHead -->
This is Sidebar
<!-- import: sidebarTail -->

Feature Request: can use filter when variable in command

希望支持如下的语法：

<!-- var: foo = ${bar|filter1|filter2}; -->
<!-- if: ${foo} -->
...
<!-- /if -->

弱弱的问下是否考虑支持 ${'some string'|filterName} 类似用法

初次提问，心情忐忑，不知大大是否空闲。

某年某月的某一天，为了真爱, 于是默默的写下了纠结一生的代码:

// filter
etpl.addFilter('kiss', function (source) {
    return 'duang~duang~ ' + source + ' too.';
});

// view
<p>${'i love u'|kiss}</p>

// output
<p>duang~duang~  too.</p>

心都碎了, 求 大大 指点 ~

for语法对于自定义集合的支持

简单来说，现在的etpl并不支持backbone的Collection，也不支持emc的Collection，因为它们封装了数组，并且没有暴露出类数组的索引下标访问功能

我们当然可以在一切这样的场景下先把Collection对象变成纯数组，但这会使得应用系统变得非常复杂，我们使用Collection是希望使用它的变化通知的相关事件，转为纯数组会失去这一功能，或者会变成每次收到集合变化时再转一次纯数组交给etpl

我总结了一下几个知名库的封装数组类的接口：

backbone.Collection：有.length属性，有each和forEach方法，使用at(index)访问元素
ember.Array：有.length属性，有forEach方法，使用objectAt(index)访问元素
ko.ObservableArray：有.length属性，能直接下标访问
jQuery：有.length，能直接下标访问

我们的emc.Collection有.length属性，没有任何遍历的方法，使用get(index)访问元素

因此我希望可以支持这一类的封装数组，从上面来看，大家都会有.length属性，但访问方法各不相同，其中以each和forEach最为通用，emc可以添加该方法作支持

个人的建议是当具备.length属性时，增加检测forEach及each方法，存在的话也认为是一个数组并使用方法进行循环

最终这一需求会影响多少的体积，是否合适，还是交给 @errorrik 来判断吧

调查：在使用etpl编写模板时，哪些命令标签的自闭和功能被用到

etpl部分命令标签提供了标签自闭和功能，为了方便模板编写时能够减少输入。

为了评估该功能带来的收益，评估自闭和功能设计是否达到了想像中的便利，为了接下来etpl的设计，发起该调查。

该调查为多选

A 使用target自闭和，target不编写结束标签
B 使用master自闭和，master不编写结束标签
C 使用content自闭和，content不编写结束标签
D 使用contentplaceholder自闭和，contentplaceholder不编写结束标签

建议为for增加break功能

应用中发现for循环写死不太方便，有时后端数据可能没有做限制，建议可以增加break功能，使使用更灵活
语法可以是这样:
{{ break: conditional-expression }}
在for循环中插入命令语句
我自测时实现了一个break command，测试用例如 {{ break: 3 }} {{ break: ${list.length} - 2 }} 等均能通过