ewx v1.0.1

ewx 模板引擎

ewx 是一个基于 wxml 扩展的小程序 html 模板。主要功能是扩展 wxml 的数据绑定（可以调用函数等），并和 mobx 结合，使用 mobx 作为状态管理。

ewx 对 wxml 的扩展

1. 函数调用

<view wx:if="{{ [1,2].includes(1) }}">{{"hello" + name}}</view>

2. 事件绑定可以传递一个函数

<view wx:for="{{array}}" bindtap="{{ ()=> click(item) }}">
  {{index}}: {{item.message}}
</view>

ewx 对 js 层的扩展

使用类来声明页面和组件

// demo.js
import { WeApp, createComponent } from 'ewx'

@createComponent(require)
export class Demo extends WeApp {
  title = 'weapp'

  // 生命周期和其他微信的回调方法
  onLoad() {
    // Do some initialize when page load.
  }

  // 自定义方法
  handle() {
    this.title = 'hello'
  }
  
  getFullTitle() {
    return this.title + '-mobx'
  }
}

// demo.ewx -> 使用 .ewx, 而不是 .wxml
<view bindtap="handle">{{ title }}  {{ getFullTitle() }}</view>

在这个类中没有小程序的 data、setData。所有实例变量(例如 title)都是响应式的 模板里可以绑定实例的变量和方法，实例里数据的发生改变也会同步到视图层(wxml)。 响应式数据的 api 是由 mobx 提供的，因此在实例里面也可以引用全局的 mobx 数据，从而实现全局状态管理。

api 介绍

Component 声明

import { WeApp, createComponent, prop, watch } from 'ewx'

@createComponent(require)
export class Counter extends WeApp {
  static options = {}
  static externalClasses = {}
  
  @prop(String) myProp1 // properties 声明

  @watch('myProp1') // 监听属性变化，参考原生组件的 observers
  myProp1Change(){
      
  }


  // 生命周期函数
  attached() { }
  moved() { }
  detached() { }
  
  // 组件所在页面的生命周期函数
  show() { }
  hide() { }
  resize() { }
  
  // 自定义方法
  handle() {
  
  }
  
  myPropertyChange() {
  
  }
}

Component 的配置目前只支持 options, externalClasses, 这三个参数都是静态属性，跟实例没有直接关系的。

update

需要设置 setData 回调时改用 update api

this.update({ title: 'abc' }, ()=> {}) // 和 setData 类似，但是更新的目标是当前的 this

template

.ewx 声明 template 的标签时，内部的标签内容不支持 .ewx 的语法，只能采用原生的语法

.ewx 调用模版时的语法 <template is="item" data="{{ {text: 'forbar'} }}"/> 和 .wxml 调用模版时的语法 <template is="item" data="{{text: 'forbar'}}"/> 不同

include

<include src="" /> 内部的 wxml 暂不支持.ewx 的语法