lightings

灯饰

中文文档 |英语

一个基于ES6 Promise轻量级Ajax框架，支持模板渲染。

安装中

npm install lightings

目录结构：

 lightings
	|---src
	|    |---lightings.js (es6 source)
	|    |---promise.js (low browser support Promise)
	|
	|---dist
     	     |---lightings.js (use bable compiler source code es5)
	     |---lightings.min.js

提示：如果您的浏览器支持ES6语法，可以直接在src目录下使用ES6源码。

例子

Tip :JSON数据统一使用示例：

 {
	"name": "Lightings",
	"author": {
		"firstName": "Jay",
		"lastName": "Zangwill"
	}
}

执行 GET 请求（使用模板渲染）

 lightings.get('test.json',{
	config: true,
	el: '#app'
}).then(function(data){
		console.log(data);
		//other operation
}).catch(function(error){
	console.log(error);
});

 <!-- html -->
<div id="app">
	<p>author: {{author.firstName}} {{author.lastName}}</p>
	<p>name: {{name}}</p>
</div>

执行 GET 请求（不使用模板渲染）

 lightings.get('test.json')
	.then(function(data){
		console.log(data);
		//dom operation and other operation
	}).catch(function(error){
		console.log(error);
	});

跨域请求

 lightings.jsonp('http://jayzangwill.cn/test.json')
	.then(function(data){
		console.log(data);
		//dom operation and other operation
	}).catch(function(error){
		console.log(error);
	});

灯光API

lightings.get(url[,数据,[选项]])

lightings.post(url[,数据,[选项]])

lightings.jsonp(url[,数据,[选项]])

笔记：

1. 当使用 options 作为第二个参数时，需要传递一个config:true属性，例如

 lightings.get('test.json',{
	config:true,
	...
});

2. jsonp 不支持模板渲染、 timeout 、 progress

参数options （可配置项）

1. el：灯光挂载元素，用于模板渲染。（仅JSON数据格式支持get、post）
2. dataType：服务器数据返回格式，默认为JSON，可选值：JSON,XML, HTML, text。
3. async：是否异步。默认异步。
4. contentType： 请求头（仅支持post请求）
5. 超时：超时。默认0（不设置超时）
6. Progress：向Ajax发送请求过程中的函数

更新日志

2017年3.15 v1.1.0

1. 添加timeout配置项。 （jsonp不支持超时）
2. 添加progress配置项。 （jsonp不支持超时）

2017年3.27 v1.2.0

修复低浏览器Promise功能

2017 4.5 v1.3.0

1. 修复了IE9下的一个bug
2. 支持模板渲染（jsonp不支持）

2017 4.7 v2.0.0

修改lightings API，取消一些过时的配置

2017 4.7 v2.0.1

优化模板渲染

2017年4.13 v2.0.2

1. 修复了 async 无法设置为 false 的问题
2. 修复了设置为异步时 false 无法获取数据的问题

2018年4.06V2.0.3

1. 修复一些错误