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[,data,[選項]])

lightings.post(url[,數據,[選項]])

lightings.jsonp(url[,data,[選項]])

筆記：

1. 當使用 options 作為第二個參數時，需要傳遞一個config:true屬性，例如

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

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

參數options （可配置項）

1. el：燈光掛載元素，用於模板渲染。
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. 修復一些錯誤