API

Wine

$.fn.wine(init);

声明Wine对象

参数(可选):

Wine的init函数,会在第一次渲染之前执行

var presenter = $(dom).wine(init);

setTemplate('template HTML')

设置EJS模版

参数(必选):

参数为模版文本

presenter.setTemplate('template HTML')

value(data)

给Wine对象赋值,可以通过 presenter.data 访问

参数(必选):

json数据

presenter.value(data);

beforeValue(fn)

给presenter赋值之前执行fn

参数(必选):

赋值之前执行的函数

presenter.beforeValue(fn);

afterValue(fn)

给presenter赋值之后执行fn

参数(必选):

赋值之后执行的函数

presenter.afterValue(fn);

render()

对Wine对象渲染，请勿和form()方法混用

presenter.render()

form()

使调用声明函数并给form表单赋值，请勿和render()方法混用

presenter.wine(function(){
    // init 函数会在第一次调用form表单时执行    
})
.value({...}) // 赋值 必需
.setValidate([...]) // 设置验证规则 选填
.form();

beforeRender(fn)

在渲染presenter中的数据之前执行fn

参数(必选):

在渲染presenter中的数据之前执行的函数

presenter.beforeRender(fn);

afterRender(fn)

在渲染presenter中的数据之后执行fn

参数(必选):

在渲染presenter中的数据之后执行的函数

presenter.afterRender(fn);

binding({ attributeName:function({ $obj : element , old : old , value : value , path : path}){} })

给wine-bind表单元素绑定事件，其中this为当前wine对象

参数(必选):

格式:{ attributeName: callback, attributeName1: callback1 ... }

类型:json

attributeName:用wine-bind给表单元素绑定presenter中data的值

callback:在绑定wine-bind的表单元素触发change事件时调用callback函数

callback arguments:

$obj:表单元素对应的jQuery对象
old:表单元素触发change事件之前的值
value:表单元素触发change事件之后的值
path:attribute相对于presenter中data对象的路径

presenter.binding({
    attribute : function(argu){
        console.log(argu);
        //    { 
        //        $obj : element,
        //        old : old,
        //        value : value,
        //        path : path
        //    }
    }

});

unbinding( str|array )

给Wine-bind表单元素解绑，参数为字符串或者数组

参数(必选):

对应binding参数中的attributeName

presenter.unbinding('name');

setValidate()

设置验证规则

presenter
.setValidate([
    { // 验证规则1
        name : 'key',
        rule : /^\d$/,
        success : function( data, $input ){ // data 为表单元素内当前值，$input为对应当前表单元素的jQuery对象
            // this 指向当前的wine对象 即当前presenter
            // 验证成功时执行
        },
        fail : function( data, $input ){
            // 验证失败时执行
        }
    },
    { // 验证规则2

    }
])

validate()

验证某个属性或者全部属性

// 验证name属性对应的验证规则，验证成功则调用验证规则中success函数并返回true，否则调用fail且返回false
presenter
.validate('name');

// 按顺序验证全部验证规则，验证成功则调用验证规则中success函数并返回true，否则调用第一个验证失败的fail函数且返回false
presenter
.validate();

watch({eventName:callback})

订阅事件

参数(必选):

格式:{ eventName: callback, eventName1: callback1 ... }

类型:json

eventName:订阅事件名,支持通配符'*'

callback:指定事件回调函数,如果在trigger时传递了数据可以在callback函数中获取到

presenter.watch({'eventName':callback});

detach

取消订阅

参数(必选):

格式:[event, event1 ...]

类型:数组

已经订阅过的事件名

presenter.detach(['eventName','eventName1']);

工具函数

$.Wine.extend(presenter, $element);

从已经建立的presenter生成新的presenter

参数(必选)

presenter:需要被继承的presenter

$element:生成的presenter关联的jQuery对象

$.Wine.trigger(eventName, data)

触发订阅的事件

参数

eventName:需要触发的事件

data:传递给订阅函数的参数数据