blear.ui.linkage

1Introduction

2Example

var Linkage = require('blear.ui.linkage');

new Linkage({
    el: '#demo select',
    placeholder: {
        text: function (index) {
            return '请选择' + ['省份', '城市', '区域'][index];
        },
        value: 0
    },
    getData: function (meta, next) {
        ajaxDistrictList(function (list) {
            next(list);
        });
    }
});

3Static

3.1.defaults

  • 类型：Object
  • 说明：默认配置

3.2.defaults.el

  • 类型：Element
  • 说明：select 元素

3.3.defaults.cacheable

  • 类型：boolean
  • 说明：是否缓存
  • 默认：true

3.4.defaults.placeholder

  • 类型：{{text: String | Function(index), value: String | Number}} | null
  • 说明：占位描述
  • 默认：{text: "请选择", value: 0}

3.5.defaults.getData(meta, next)

  • 类型：{{Function}}
  • 说明：获取数据方法
  • 默认：
    function getDate(meta, next) {
  next([]);
}

3.5.1getData: meta

  • 类型：Object
  • 说明：元描述

3.5.2getData: meta.currentIndex

  • 类型：Number
  • 说明：当前 select 索引值

3.5.3getData: meta.sourceIndex

  • 类型：Number
  • 说明：变化的源 select 索引值

3.5.4getData: meta.sourceValue

  • 类型：Number
  • 说明：变化的源 select 的值

3.5.5getData: meta.sourceText

  • 类型：Number
  • 说明：变化的源 select 的文本

3.5.6getData: meta.parentValue

  • 类型：Number
  • 说明：父级 select 的值

3.5.7getData: meta.parentText

  • 类型：Number
  • 说明：父级 select 的文本

4new Linkage(options)

实例化一个联动选择器，options 为入参，默认值为 .defaults。

5Prototype

5.1.length

  • 类型：Number
  • 说明：长度

5.2.cache

  • 类型：Object
  • 说明：缓存对象，是一个 value map，它的作用是在页面上多个同样的级联选择器可以共用一份缓存

5.3#setValue(value, [callback]): this

设值。

5.3.1value

  • 类型：Array
  • 说明：值

5.3.2callback

  • 类型：Function
  • 说明：回调

5.4#getValue(): value

取值。

5.4.1value

  • 类型：Array
  • 说明：值

5.5#getText(): text

取文本。

5.5.1text

  • 类型：Array
  • 说明：文本

5.6#getElements(): els

取元素。

5.6.1els

  • 类型：Array
  • 说明：元素数组

5.7#destroy()

销毁实例。

6Events

6.1change(value, text)

变化后触发。

6.1.1value

  • 类型：Array
  • 说明：值

6.1.2text

  • 类型：Array
  • 说明：文本

6.2beforeProcess()

处理（含数据加载、节点渲染等）之前触发。

6.3afterProcess()

处理（含数据加载、节点渲染等）之后触发。

7Dependencies

8Reference

无。