# [zip]()
Zip模塊管理文件壓縮和解壓,通過plus.zip可獲取壓縮管理對象。
### 方法:
- [compress](http://www.dcloud.io/docs/api/zh_cn/zip.shtml#plus.zip.compress): 用于壓縮Zip文件
- [decompress](http://www.dcloud.io/docs/api/zh_cn/zip.shtml#plus.zip.decompress): 用于解壓縮Zip文件。
### 回調方法:
- [ZipSuccessCallback](http://www.dcloud.io/docs/api/zh_cn/zip.shtml#plus.zip.ZipSuccessCallback): 操作成功回調函數接口,在解壓Zip文件或壓縮成Zip文件成功時調用
- [ZipErrorCallback](http://www.dcloud.io/docs/api/zh_cn/zip.shtml#plus.zip.ZipErrorCallback): 操作錯誤回調函數接口,在解壓Zip文件或壓縮成Zip文件失敗時調用
### 權限:
permissions
~~~
"Zip": {
"description": "文件壓縮與解壓縮"
}
~~~
# [compress]()
用于壓縮Zip文件
~~~
void plus.zip.compress(src, zipfile, successCB, errorCB);
~~~
### 參數:
- src: *( DOMString ) 可選 *要壓縮的源文件路徑,支持文件路徑或目錄
- zipfile: *( DOMString ) 可選 *壓縮后保存的Zip文件路徑
- successCB: *( [ZipSuccessCallback](http://www.dcloud.io/docs/api/zh_cn/zip.shtml#plus.zip.ZipSuccessCallback) ) 必選 *壓縮Zip文件操作成功回調,在壓縮操作成功時調用
- errorCB: *( [ZipErrorCallback](http://www.dcloud.io/docs/api/zh_cn/zip.shtml#plus.zip.ZipErrorCallback) ) 必選 *壓縮Zip文件操作失敗回調,在壓縮操作失敗時調用
### 返回值:
void : 無
### 示例:
~~~
<!DOCTYPE HTML>
<html>
<head>
<meta charset="UTF-8" />
<script type="text/javascript">
//壓縮
function zipCompress(){
var zipfile = "_doc/text11.zip";
var targetPath = '_doc/dir/';
plus.zip.compress(targetPath,zipfile,
function() {
alert("Compress success!");
},function(error) {
alert("Compress error!");
});
}
</script>
</head>
<body >
<input type='button' onclick='zipCompress()' value='zip壓縮' />
</body>
</html>
~~~
# [decompress]()
用于解壓縮Zip文件。
~~~
void plus.zip.decompress( zipfile, target, successCB, errorCB);
~~~
### 參數:
- zipfile: *( DOMString ) 可選 *
需解壓Zip文件路徑
- target: *( DOMString ) 可選 *
解壓Zip文件的目標路徑,必須是路徑
- successCB: *( [ZipSuccessCallback](http://www.dcloud.io/docs/api/zh_cn/zip.shtml#plus.zip.ZipSuccessCallback) ) 必選 *
解壓Zip文件操作成功回調,在解壓操作成功時調用。
- errorCB: *( [ZipErrorCallback](http://www.dcloud.io/docs/api/zh_cn/zip.shtml#plus.zip.ZipErrorCallback) ) 必選 *
解壓Zip文件操作失敗回調,在解壓操作失敗時調用。
### 返回值:
void : 無
### 示例:
~~~
<!DOCTYPE HTML>
<html>
<head>
<meta charset="UTF-8" />
<script type="text/javascript">
//解壓縮
function zipDecompress() {
var zipfile = "_doc/text.zip";
var targetPath = '_doc/dir/';
plus.zip.decompress(zipfile, targetPath,
function() {
alert("Decompress success!");
},function(error) {
alert("Compress error!");
});
}
</script>
</head>
<body >
<input type='button' onclick='zipDecompress()' value='zip解壓' />
</body>
</html>
~~~
# [ZipSuccessCallback]()
操作成功回調函數接口,在解壓Zip文件或壓縮成Zip文件成功時調用
~~~
void onSuccess(){
// Code here
}
~~~
### 參數:
無
### 返回值:
void : 無
# [ZipErrorCallback]()
操作錯誤回調函數接口,在解壓Zip文件或壓縮成Zip文件失敗時調用
~~~
void onError(error){
// Handle the error
}
~~~
### 參數:
- error: *( DOMException ) 可選 *
Zip文件操作的錯誤信息
### 返回值:
void : 無
- API參考
- Accelerometer
- Audio
- Camera
- Contacts
- Device
- Downloader
- Events
- Gallery
- Geolocation
- IO
- Key
- Messaging
- NativeUI
- Navigator
- Orientation
- Proximity
- SplashScreen
- Storage
- UI
- Uploader
- InterfaceOrientation
- Runtime
- WebView
- XMLHttpRequest
- Zip
- Plugins
- Barcode
- Maps
- Payment
- Push
- Share
- Speech
- Statistic
- Native.js
- Android
- iOS