xbdsky/ecope

easy components for jQuery

ecope -- easy components for jQuery

---

ecope 是一个基于 jQuery 的组件库，集合了一些常见的简单实用的组件。

基于 AMD 的模块化规范，使用 seed 作为加载器，当然你也可以使用符合AMD规范的加载器，如 requireJS。

其中 seed-jquery.js 是 seed(加载器) 与 jQuery(基础类库) 的集合体。

有问题可以提 issue，或者加入 QQ群：202604349 讨论。

在线文档

---

在使用 ecope 的组件库之前，如果能花上几分钟看看下面的一些简单的入门指南，在使用组件的时候你会更加的得心应手。

简单性

ecope 的组件库在 UI(界面) 层面尽量保持简单，开发者可以很方便的通过修改 CSS 样式就可以轻松定制自己想要的样式。 使用一个组件通常情况下只需要寥寥几行 JS 代码。

一致性

组件在接口设计、命名规则上都尽可能的保持一致。通常，你只要使用过任意一个组件，那么其他组件也很容易上手。

模块化

每个组件都是一个独立的符合 AMD 规范的模块，都依赖 seed-jquery 的核心库，在使用时都可以通过 seed.use 来进行加载。

命名空间

所有组件的命名空间都是 $.ui，在组件加载完后都可以通过 $.ui.xxxx 来访问。

实例化

在使用组件时都需要通过 new 关键字来实例化，组件类的首字母都是 大写。

实例化时，第一个参数 都是必需的，该参数通常都是设置需要实例化某个/组 DOM 元素。该参数可以是选择器字符串、DOM 元素以及 jQuery Object 的对象。

实例化时，第二个参数 都是可选的，该参数是一个多选可配置形式的 Object 对象。

事件处理

组件在实例化后都可以通过 on 方法来为组件绑定事件，同样，也可以通过 un 方法来卸载事件。各组件支持的事件类型可以在详细的说明文档中看到。在多选形式的配置参数中，除了可能存在 init 回调函数，不会有任何其他的回调。

销毁实例

组件实例可以通过 destroy 方法进行销毁。

---