cordova-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From dblot...@apache.org
Subject [47/51] [partial] docs commit: Adding both Chinese versions.
Date Wed, 06 Apr 2016 09:28:03 GMT
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/3.1.0/cordova/device/device.version.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/3.1.0/cordova/device/device.version.md b/www/docs/zh-cn/3.1.0/cordova/device/device.version.md
new file mode 100644
index 0000000..331f0cb
--- /dev/null
+++ b/www/docs/zh-cn/3.1.0/cordova/device/device.version.md
@@ -0,0 +1,76 @@
+---
+license: >
+    Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+        http://www.apache.org/licenses/LICENSE-2.0
+
+    Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
+title: device.version
+---
+
+# device.version
+
+獲取作業系統版本。
+
+    var string = device.version;
+    
+
+## 支援的平臺
+
+*   Android 2.1 +
+*   黑莓手機 WebWorks (OS 5.0 和更高)
+*   iOS
+*   Tizen
+*   Windows Phone 7 和 8
+*   Windows 8
+
+## 快速的示例
+
+    / / Android: Froyo OS 將返回"2.2"/ / Eclair OS 將返回"2.1"、"2.0.1"2.0"/ / 版本,也可以返回更新級別"2.1 update1"/ / / / 黑莓手機: 火炬 9800 使用 OS 6.0 將返回"6.0.0.600"/ / / / iPhone: iOS 3.2 返回"3.2"/ / / / Windows Phone 7: 返回當前 OS 版本數,。 on Mango returns 7.10.7720
+    // Tizen: returns "TIZEN_20120425_2"
+    var deviceVersion = device.version;
+    
+
+## 完整的示例
+
+    <!DOCTYPE html>
+    <html>
+      <head>
+        <title>Device Properties Example</title>
+    
+        <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
+        <script type="text/javascript" charset="utf-8">
+    
+        // Wait for device API libraries to load
+        //
+        document.addEventListener("deviceready", onDeviceReady, false);
+    
+        // device APIs are available
+        //
+        function onDeviceReady() {
+            var element = document.getElementById('deviceProperties');
+            element.innerHTML = 'Device Model: '    + device.model    + '<br />' +
+                                'Device Cordova: '  + device.cordova  + '<br />' +
+                                'Device Platform: ' + device.platform + '<br />' +
+                                'Device UUID: '     + device.uuid     + '<br />' +
+                                'Device Version: '  + device.version  + '<br />';
+        }
+    
+        </script>
+      </head>
+      <body>
+        <p id="deviceProperties">Loading device properties...</p>
+      </body>
+    </html>
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/3.1.0/cordova/events/events.backbutton.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/3.1.0/cordova/events/events.backbutton.md b/www/docs/zh-cn/3.1.0/cordova/events/events.backbutton.md
new file mode 100644
index 0000000..a7c18ed
--- /dev/null
+++ b/www/docs/zh-cn/3.1.0/cordova/events/events.backbutton.md
@@ -0,0 +1,81 @@
+---
+license: >
+    Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+        http://www.apache.org/licenses/LICENSE-2.0
+
+    Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
+title: backbutton
+---
+
+# backbutton
+
+在使用者按後退按鈕時,將觸發該事件。
+
+    document.addEventListener("backbutton", yourCallbackFunction, false);
+    
+
+## 詳細資訊
+
+要重寫後退按鈕的預設行為,註冊為事件攔截器 `backbutton` 事件,通常通過調用 `document.addEventListener` 一旦您收到 `[deviceready](events.deviceready.html)` 事件。 不再需要調用任何其他方法重寫的後退按鈕的行為。
+
+## 支援的平臺
+
+*   Android 系統
+*   黑莓手機 WebWorks (OS 5.0 和更高)
+*   Windows Phone 7 和 8
+
+## 快速的示例
+
+    document.addEventListener("backbutton", onBackKeyDown, false);
+    
+    function onBackKeyDown() {
+        // Handle the back button
+    }
+    
+
+## 完整的示例
+
+    <!DOCTYPE html>
+    <html>
+      <head>
+        <title>Back Button Example</title>
+    
+        <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
+        <script type="text/javascript" charset="utf-8">
+    
+        // Wait for device API libraries to load
+        //
+        function onLoad() {
+            document.addEventListener("deviceready", onDeviceReady, false);
+        }
+    
+        // device APIs are available
+        //
+        function onDeviceReady() {
+            // Register the event listener
+            document.addEventListener("backbutton", onBackKeyDown, false);
+        }
+    
+        // Handle the back button
+        //
+        function onBackKeyDown() {
+        }
+    
+        </script>
+      </head>
+      <body onload="onLoad()">
+      </body>
+    </html>
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/3.1.0/cordova/events/events.batterycritical.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/3.1.0/cordova/events/events.batterycritical.md b/www/docs/zh-cn/3.1.0/cordova/events/events.batterycritical.md
new file mode 100644
index 0000000..e35e94e
--- /dev/null
+++ b/www/docs/zh-cn/3.1.0/cordova/events/events.batterycritical.md
@@ -0,0 +1,91 @@
+---
+license: >
+    Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+        http://www.apache.org/licenses/LICENSE-2.0
+
+    Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
+title: batterycritical
+---
+
+# batterycritical
+
+當電池達到臨界閾值時,將觸發該事件。
+
+    window.addEventListener("batterycritical", yourCallbackFunction, false);
+    
+
+## 詳細資訊
+
+當電池計量的百分比已達到關鍵電池閾值時,將觸發該事件。值是特定于設備。
+
+`batterycritical`處理常式傳遞一個物件,包含兩個屬性:
+
+*   **級別**: 電池充電 (0-100) 的百分比。*(人數)*
+
+*   **isPlugged**: 一個布林值,該值指示設備是否插*(布林值)*
+
+應用程式通常應使用 `window.addEventListener` 將一個事件攔截器附加一次 `[deviceready](events.deviceready.html)` 事件火災。
+
+## 支援的平臺
+
+*   iOS
+*   Android 系統
+*   黑莓手機 WebWorks (OS 5.0 和更高)
+*   Tizen
+
+## 快速的示例
+
+    window.addEventListener("batterycritical", onBatteryCritical, false);
+    
+    function onBatteryCritical(info) {
+        // Handle the battery critical event
+        alert("Battery Level Critical " + info.level + "%\nRecharge Soon!");
+    }
+    
+
+## 完整的示例
+
+    <!DOCTYPE html>
+    <html>
+      <head>
+        <title>Battery Critical Example</title>
+    
+        <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
+        <script type="text/javascript" charset="utf-8">
+    
+        // Wait for device API libraries to load
+        //
+        function onLoad() {
+            document.addEventListener("deviceready", onDeviceReady, false);
+        }
+    
+        // device APIs are available
+        //
+        function onDeviceReady() {
+            window.addEventListener("batterycritical", onBatteryCritical, false);
+        }
+    
+        // Handle the batterycritical event
+        //
+        function onBatteryCritical(info) {
+            alert("Battery Level Critical " + info.level + "%\nRecharge Soon!");
+        }
+    
+        </script>
+      </head>
+      <body onload="onLoad()">
+      </body>
+    </html>
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/3.1.0/cordova/events/events.batterylow.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/3.1.0/cordova/events/events.batterylow.md b/www/docs/zh-cn/3.1.0/cordova/events/events.batterylow.md
new file mode 100644
index 0000000..5fa87fe
--- /dev/null
+++ b/www/docs/zh-cn/3.1.0/cordova/events/events.batterylow.md
@@ -0,0 +1,91 @@
+---
+license: >
+    Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+        http://www.apache.org/licenses/LICENSE-2.0
+
+    Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
+title: batterylow
+---
+
+# batterylow
+
+當電池達到低級別閾值時,將觸發該事件。
+
+    window.addEventListener("batterylow", yourCallbackFunction, false);
+    
+
+## 詳細資訊
+
+當電池計量的百分比已達到電池計量低門檻,設備特定值時,將觸發該事件。
+
+`batterylow`處理常式傳遞一個物件,包含兩個屬性:
+
+*   **級別**: 電池充電 (0-100) 的百分比。*(人數)*
+
+*   **isPlugged**: 一個布林值,該值指示設備是否插*(布林值)*
+
+應用程式通常應使用 `document.addEventListener` 將一個事件攔截器附加一次 `[deviceready](events.deviceready.html)` 事件火災。
+
+## 支援的平臺
+
+*   iOS
+*   Android 系統
+*   黑莓手機 WebWorks (OS 5.0 和更高)
+*   Tizen
+
+## 快速的示例
+
+    window.addEventListener("batterylow", onBatteryLow, false);
+    
+    function onBatteryLow(info) {
+        // Handle the battery low event
+        alert("Battery Level Low " + info.level + "%");
+    }
+    
+
+## 完整的示例
+
+    <!DOCTYPE html>
+    <html>
+      <head>
+        <title>Device Ready Example</title>
+    
+        <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
+        <script type="text/javascript" charset="utf-8">
+    
+        // Wait for device API libraries to load
+        //
+        function onLoad() {
+            document.addEventListener("deviceready", onDeviceReady, false);
+        }
+    
+        // device APIs are available
+        //
+        function onDeviceReady() {
+            window.addEventListener("batterylow", onBatteryLow, false);
+        }
+    
+        // Handle the batterylow event
+        //
+        function onBatteryLow(info) {
+            alert("Battery Level Low " + info.level + "%");
+        }
+    
+        </script>
+      </head>
+      <body onload="onLoad()">
+      </body>
+    </html>
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/3.1.0/cordova/events/events.batterystatus.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/3.1.0/cordova/events/events.batterystatus.md b/www/docs/zh-cn/3.1.0/cordova/events/events.batterystatus.md
new file mode 100644
index 0000000..6e2f3c0
--- /dev/null
+++ b/www/docs/zh-cn/3.1.0/cordova/events/events.batterystatus.md
@@ -0,0 +1,96 @@
+---
+license: >
+    Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+        http://www.apache.org/licenses/LICENSE-2.0
+
+    Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
+title: batterystatus
+---
+
+# batterystatus
+
+在電池的狀態中的更改時,將觸發該事件。
+
+    window.addEventListener("batterystatus", yourCallbackFunction, false);
+    
+
+## 詳細資訊
+
+當電池計量的百分比改變了至少 1%,或如果在插入或拔出該設備會觸發此事件。
+
+電池狀態處理常式傳遞一個物件,包含兩個屬性:
+
+*   **級別**: 電池充電 (0-100) 的百分比。*(人數)*
+
+*   **isPlugged**: 一個布林值,該值指示設備是否插*(布林值)*
+
+應用程式通常應使用 `window.addEventListener` 將一個事件攔截器附加一次 `[deviceready](events.deviceready.html)` 事件火災。
+
+## 支援的平臺
+
+*   iOS
+*   Android 系統
+*   黑莓手機 WebWorks (OS 5.0 和更高)
+*   Windows Phone 7 和 8
+*   Tizen
+
+## Windows Phone 7 和 8 怪癖
+
+Windows Phone 7 並不提供本機 Api 來確定電池計量水準,所以 `level` 是不可用的屬性。`isPlugged`參數**支援的。
+
+## 快速的示例
+
+    window.addEventListener("batterystatus", onBatteryStatus, false);
+    
+    function onBatteryStatus(info) {
+        // Handle the online event
+        console.log("Level: " + info.level + " isPlugged: " + info.isPlugged);
+    }
+    
+
+## 完整的示例
+
+    <!DOCTYPE html>
+    <html>
+      <head>
+        <title>Device Ready Example</title>
+    
+        <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
+        <script type="text/javascript" charset="utf-8">
+    
+        // Wait for device API libraries to load
+        //
+        function onLoad() {
+            document.addEventListener("deviceready", onDeviceReady, false);
+        }
+    
+        // device APIs are available
+        //
+        function onDeviceReady() {
+            window.addEventListener("batterystatus", onBatteryStatus, false);
+        }
+    
+        // Handle the batterystatus event
+        //
+        function onBatteryStatus(info) {
+            console.log("Level: " + info.level + " isPlugged: " + info.isPlugged);
+        }
+    
+        </script>
+      </head>
+      <body onload="onLoad()">
+      </body>
+    </html>
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/3.1.0/cordova/events/events.deviceready.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/3.1.0/cordova/events/events.deviceready.md b/www/docs/zh-cn/3.1.0/cordova/events/events.deviceready.md
new file mode 100644
index 0000000..8b4df93
--- /dev/null
+++ b/www/docs/zh-cn/3.1.0/cordova/events/events.deviceready.md
@@ -0,0 +1,84 @@
+---
+license: >
+    Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+        http://www.apache.org/licenses/LICENSE-2.0
+
+    Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
+title: deviceready
+---
+
+# deviceready
+
+科爾多瓦是在完全載入時,將觸發該事件。
+
+    document.addEventListener("deviceready", yourCallbackFunction, false);
+    
+
+## 詳細資訊
+
+此事件的任何應用程式至關重要。它發出信號科爾多瓦的設備已載入的 Api,並準備訪問。
+
+科爾多瓦組成的兩個代碼庫: 本機和 JavaScript。 雖然本機代碼載入、 顯示的自訂載入圖像。 然而,JavaScript 僅載入一旦 DOM 裝載。 這意味著您的 web 應用程式可能有可能調用的科爾多瓦 JavaScript 函數之前的相應的本機代碼是可用。
+
+`deviceready`科爾多瓦已完全載入後會觸發事件。 一次事件火,你可以安全地使對科爾多瓦 Api 的調用。 應用程式通常將附加一個事件攔截器與 `document.addEventListener` 一旦 HTML 文檔的 DOM 已載入。
+
+`deviceready`事件從其他人的行為方式略有不同。註冊後的任何事件處理 `deviceready` 事件將觸發了其立即調用的回呼函數。
+
+## 支援的平臺
+
+*   Android 系統
+*   黑莓手機 WebWorks (OS 5.0 和更高)
+*   iOS
+*   Tizen
+*   Windows Phone 7 和 8
+*   Windows 8
+
+## 快速的示例
+
+    document.addEventListener("deviceready", onDeviceReady, false);
+    
+    function onDeviceReady() {
+        // Now safe to use device APIs
+    }
+    
+
+## 完整的示例
+
+    <!DOCTYPE html>
+    <html>
+      <head>
+        <title>Device Ready Example</title>
+    
+        <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
+        <script type="text/javascript" charset="utf-8">
+    
+        // Wait for device API libraries to load
+        //
+        function onLoad() {
+            document.addEventListener("deviceready", onDeviceReady, false);
+        }
+    
+        // device APIs are available
+        //
+        function onDeviceReady() {
+            // Now safe to use device APIs
+        }
+    
+        </script>
+      </head>
+      <body onload="onLoad()">
+      </body>
+    </html>
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/3.1.0/cordova/events/events.endcallbutton.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/3.1.0/cordova/events/events.endcallbutton.md b/www/docs/zh-cn/3.1.0/cordova/events/events.endcallbutton.md
new file mode 100644
index 0000000..4d4730b
--- /dev/null
+++ b/www/docs/zh-cn/3.1.0/cordova/events/events.endcallbutton.md
@@ -0,0 +1,82 @@
+---
+license: >
+    Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+        http://www.apache.org/licenses/LICENSE-2.0
+
+    Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
+title: endcallbutton
+---
+
+# endcallbutton
+
+當使用者按下結束通話按鈕時,將激發此事件。
+
+    document.addEventListener("endcallbutton", yourCallbackFunction, false);
+    
+
+## 詳細資訊
+
+該事件將重寫預設結束調用行為。
+
+應用程式通常應使用 `document.addEventListener` 將一個事件攔截器附加一次 `[deviceready](events.deviceready.html)` 事件火災。
+
+## 支援的平臺
+
+*   黑莓手機 WebWorks (OS 5.0 和更高)
+
+## 快速的示例
+
+    document.addEventListener("endcallbutton", onEndCallKeyDown, false);
+    
+    function onEndCallKeyDown() {
+        // Handle the end call button
+    }
+    
+
+## 完整的示例
+
+    <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
+                          "http://www.w3.org/TR/html4/strict.dtd">
+    <html>
+      <head>
+        <title>End Call Button Example</title>
+    
+        <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
+        <script type="text/javascript" charset="utf-8">
+    
+        // Wait for device API libraries to load
+        //
+        function onLoad() {
+            document.addEventListener("deviceready", onDeviceReady, false);
+        }
+    
+        // device APIs are available
+        //
+        function onDeviceReady() {
+            // Register the event listener
+            document.addEventListener("endcallbutton", onEndCallKeyDown, false);
+        }
+    
+        // Handle the end call button
+        //
+        function onEndCallKeyDown() {
+        }
+    
+        </script>
+      </head>
+      <body onload="onLoad()">
+      </body>
+    </html>
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/3.1.0/cordova/events/events.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/3.1.0/cordova/events/events.md b/www/docs/zh-cn/3.1.0/cordova/events/events.md
new file mode 100644
index 0000000..46a7897
--- /dev/null
+++ b/www/docs/zh-cn/3.1.0/cordova/events/events.md
@@ -0,0 +1,97 @@
+---
+license: >
+    Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+        http://www.apache.org/licenses/LICENSE-2.0
+
+    Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
+title: 事件
+---
+
+# 事件
+
+> 科爾多瓦生命週期事件。
+
+## 事件種類
+
+*   [deviceready](events.deviceready.html)
+*   [暫停](events.pause.html)
+*   [簡歷](events.resume.html)
+*   [線上](events.online.html)
+*   [離線](events.offline.html)
+*   [backbutton](events.backbutton.html)
+*   [batterycritical](events.batterycritical.html)
+*   [batterylow](events.batterylow.html)
+*   [batterystatus](events.batterystatus.html)
+*   [menubutton](events.menubutton.html)
+*   [searchbutton](events.searchbutton.html)
+*   [startcallbutton](events.startcallbutton.html)
+*   [endcallbutton](events.endcallbutton.html)
+*   [volumedownbutton](events.volumedownbutton.html)
+*   [volumeupbutton](events.volumeupbutton.html)
+
+## 訪問功能
+
+版本為 3.0,科爾多瓦實現電池狀態和其他設備級 Api 作為*外掛程式*。 預設情況下啟用對所有其他不相關的電池狀態的事件的訪問。 使用 CLI 的 `plugin` 命令,描述在命令列介面,可以啟用或禁用電池事件:
+
+        $ cordova plugin add org.apache.cordova.battery-status
+        $ cordova plugin ls
+        [ 'org.apache.cordova.battery-status' ]
+        $ cordova plugin rm org.apache.cordova.battery-status
+    
+
+這些命令適用于所有有針對性的平臺,但修改如下所述的特定于平臺的配置設置:
+
+*   Android 系統
+    
+        (in app/res/xml/config.xml)
+        <feature name="Battery">
+            <param name="android-package" value="org.apache.cordova.BatteryListener" />
+        </feature>
+        
+        (in app/AndroidManifest.xml)
+        <uses-permission android:name="android.permission.BROADCAST_STICKY" />
+        
+
+*   黑莓手機 WebWorks
+    
+        (in www/plugins.xml)
+        <feature name="Battery">
+            <param name="blackberry-package" value="org.apache.cordova.battery.Battery" />
+        </feature>
+        
+        (in www/config.xml)
+        <feature id="blackberry.app"          required="true" version="1.0.0.0" />
+        <feature id="blackberry.app.event"    required="true" version="1.0.0.0" />
+        <feature id="blackberry.system.event" required="true" version="1.0.0.0" />
+        
+
+*   (在 iOS`config.xml`)
+    
+        <feature name="Battery">
+            <param name="ios-package" value="CDVBattery" />
+        </feature>
+        
+
+*   (在 Tizen`config.xml`)
+    
+        <feature name="http://tizen.org/api/systeminfo" required="true"/>
+        
+    
+    引用: [Tizen Web 應用程式的應用程式清單][1]
+
+ [1]: https://developer.tizen.org/help/topic/org.tizen.help.gs/Creating%20a%20Project.html?path=0_1_1_3#8814682_CreatingaProject-EditingconfigxmlFeatures
+
+一些平臺可能支援此功能,而無需任何特殊的配置。請參見在概述部分中*的平臺支援*。
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/3.1.0/cordova/events/events.menubutton.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/3.1.0/cordova/events/events.menubutton.md b/www/docs/zh-cn/3.1.0/cordova/events/events.menubutton.md
new file mode 100644
index 0000000..389e8d7
--- /dev/null
+++ b/www/docs/zh-cn/3.1.0/cordova/events/events.menubutton.md
@@ -0,0 +1,83 @@
+---
+license: >
+    Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+        http://www.apache.org/licenses/LICENSE-2.0
+
+    Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
+title: menubutton
+---
+
+# menubutton
+
+在使用者按功能表按鈕時,將觸發該事件。
+
+    document.addEventListener("menubutton", yourCallbackFunction, false);
+    
+
+## 詳細資訊
+
+事件處理常式的應用覆蓋的預設功能表按鈕行為。
+
+應用程式通常應使用 `document.addEventListener` 將一個事件攔截器附加一次 `[deviceready](events.deviceready.html)` 事件火災。
+
+## 支援的平臺
+
+*   Android 系統
+*   黑莓手機 WebWorks (OS 5.0 和更高)
+
+## 快速的示例
+
+    document.addEventListener("menubutton", onMenuKeyDown, false);
+    
+    function onMenuKeyDown() {
+        // Handle the back button
+    }
+    
+
+## 完整的示例
+
+    <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
+                          "http://www.w3.org/TR/html4/strict.dtd">
+    <html>
+      <head>
+        <title>Menu Button Example</title>
+    
+        <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
+        <script type="text/javascript" charset="utf-8">
+    
+        // Wait for device API libraries to load
+        //
+        function onLoad() {
+            document.addEventListener("deviceready", onDeviceReady, false);
+        }
+    
+        // device APIs are available
+        //
+        function onDeviceReady() {
+            // Register the event listener
+            document.addEventListener("menubutton", onMenuKeyDown, false);
+        }
+    
+        // Handle the menu button
+        //
+        function onMenuKeyDown() {
+        }
+    
+        </script>
+      </head>
+      <body onload="onLoad()">
+      </body>
+    </html>
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/3.1.0/cordova/events/events.offline.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/3.1.0/cordova/events/events.offline.md b/www/docs/zh-cn/3.1.0/cordova/events/events.offline.md
new file mode 100644
index 0000000..2bdf7b0
--- /dev/null
+++ b/www/docs/zh-cn/3.1.0/cordova/events/events.offline.md
@@ -0,0 +1,98 @@
+---
+license: >
+    Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+        http://www.apache.org/licenses/LICENSE-2.0
+
+    Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
+title: 離線
+---
+
+# 離線
+
+當一個應用程式離線時,與該設備未連接到互聯網時,將觸發該事件。
+
+    document.addEventListener("offline", yourCallbackFunction, false);
+    
+
+## 詳細資訊
+
+`offline`以前連接的設備失去網路連接,這樣,應用程式不再可以訪問互聯網時激發的事件。 它依賴于連接 API 中,相同的資訊和火災時 `[connection.type](../connection/connection.type.html)` 從更改 `NONE` 為其他任何值。
+
+應用程式通常應使用 `document.addEventListener` 將一個事件攔截器附加一次 `[deviceready](events.deviceready.html)` 事件火災。
+
+## 支援的平臺
+
+*   Android 系統
+*   黑莓手機 WebWorks (OS 5.0 和更高)
+*   iOS
+*   Windows Phone 7 和 8
+*   Tizen
+*   Windows 8
+
+## 快速的示例
+
+    document.addEventListener("offline", onOffline, false);
+    
+    function onOffline() {
+        // Handle the offline event
+    }
+    
+
+## 完整的示例
+
+    <!DOCTYPE html>
+    <html>
+      <head>
+        <title>Offline Example</title>
+    
+        <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
+        <script type="text/javascript" charset="utf-8">
+    
+        // Wait for device API libraries to load
+        //
+        function onLoad() {
+            document.addEventListener("deviceready", onDeviceReady, false);
+        }
+    
+        // device APIs are available
+        //
+        function onDeviceReady() {
+            document.addEventListener("offline", onOffline, false);
+        }
+    
+        // Handle the offline event
+        //
+        function onOffline() {
+        }
+    
+        </script>
+      </head>
+      <body onload="onLoad()">
+      </body>
+    </html>
+    
+
+## iOS 的怪癖
+
+在初始啟動期間,第一次離線事件 (如果適用) 需至少一秒的火。
+
+## Windows Phone 7 的怪癖
+
+當運行在模擬器中, `connection.status` 始終是未知的因此此事件不會*不*火。
+
+## Windows Phone 8 怪癖
+
+模擬程式報告連線類型為 `Cellular` ,而不會更改,所以該事件不會*不*火。
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/3.1.0/cordova/events/events.online.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/3.1.0/cordova/events/events.online.md b/www/docs/zh-cn/3.1.0/cordova/events/events.online.md
new file mode 100644
index 0000000..1889dd5
--- /dev/null
+++ b/www/docs/zh-cn/3.1.0/cordova/events/events.online.md
@@ -0,0 +1,98 @@
+---
+license: >
+    Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+        http://www.apache.org/licenses/LICENSE-2.0
+
+    Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
+title: 線上
+---
+
+# 線上
+
+當應用程式進入線上狀態,和該設備將成為連接到互聯網時觸發此事件。
+
+    document.addEventListener("online", yourCallbackFunction, false);
+    
+
+## 詳細資訊
+
+`online`當先前連接的行動裝置接收到一個網路連接以允許應用程式訪問互聯網時激發的事件。 它依賴于連接 API 中,相同的資訊和火災時的值 `[connection.type](../connection/connection.type.html)` 成為`NONE`.
+
+應用程式通常應使用 `document.addEventListener` 將一個事件攔截器附加一次 `[deviceready](events.deviceready.html)` 事件火災。
+
+## 支援的平臺
+
+*   Android 系統
+*   黑莓手機 WebWorks (OS 5.0 和更高)
+*   iOS
+*   Windows Phone 7 和 8
+*   Tizen
+*   Windows 8
+
+## 快速的示例
+
+    document.addEventListener("online", onOnline, false);
+    
+    function onOnline() {
+        // Handle the online event
+    }
+    
+
+## 完整的示例
+
+    <!DOCTYPE html>
+    <html>
+      <head>
+        <title>Online Example</title>
+    
+        <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
+        <script type="text/javascript" charset="utf-8">
+    
+        // Wait for device API libraries to load
+        //
+        function onLoad() {
+            document.addEventListener("online", onOnline, false);
+            document.addEventListener("deviceready", onDeviceReady, false);
+        }
+    
+        // device APIs are available
+        //
+        function onDeviceReady() {
+        }
+    
+        // Handle the online event
+        //
+        function onOnline() {
+        }
+    
+        </script>
+      </head>
+      <body onload="onLoad()">
+      </body>
+    </html>
+    
+
+## iOS 的怪癖
+
+在初始啟動期間第一次 `online` [事件](events.html) (如果適用),至少需一秒的火災之前的, `[connection.type](../connection/connection.type.html)` 是`UNKNOWN`.
+
+## Windows Phone 7 的怪癖
+
+當運行在模擬器中, `connection.status` 始終是未知的因此,此事件將*不*火。
+
+## Windows Phone 8 怪癖
+
+模擬程式報告連線類型為 `Cellular` ,而不會更改,所以事件將*不*火。
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/3.1.0/cordova/events/events.pause.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/3.1.0/cordova/events/events.pause.md b/www/docs/zh-cn/3.1.0/cordova/events/events.pause.md
new file mode 100644
index 0000000..987b64f
--- /dev/null
+++ b/www/docs/zh-cn/3.1.0/cordova/events/events.pause.md
@@ -0,0 +1,93 @@
+---
+license: >
+    Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+        http://www.apache.org/licenses/LICENSE-2.0
+
+    Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
+title: 暫停
+---
+
+# 暫停
+
+當一個應用程式放入後臺,將觸發該事件。
+
+    document.addEventListener("pause", yourCallbackFunction, false);
+    
+
+## 詳細資訊
+
+`pause`當本機平臺放入背景,應用程式通常在使用者切換到不同的應用程式時激發的事件。
+
+應用程式通常應使用 `document.addEventListener` 將一個事件攔截器附加一次 `[deviceready](events.deviceready.html)` 事件火災。
+
+## 支援的平臺
+
+*   Android 系統
+*   黑莓手機 WebWorks (OS 5.0 和更高)
+*   iOS
+*   Windows Phone 7 和 8
+*   Windows 8
+
+## 快速的示例
+
+    document.addEventListener("pause", onPause, false);
+    
+    function onPause() {
+        // Handle the pause event
+    }
+    
+
+## 完整的示例
+
+    <!DOCTYPE html>
+    <html>
+      <head>
+        <title>Pause Example</title>
+    
+        <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
+        <script type="text/javascript" charset="utf-8">
+    
+        // Wait for device API libraries to load
+        //
+        function onLoad() {
+            document.addEventListener("deviceready", onDeviceReady, false);
+        }
+    
+        // device APIs are available
+        //
+        function onDeviceReady() {
+            document.addEventListener("pause", onPause, false);
+        }
+    
+        // Handle the pause event
+        //
+        function onPause() {
+        }
+    
+        </script>
+      </head>
+      <body onload="onLoad()">
+      </body>
+    </html>
+    
+
+## iOS 的怪癖
+
+在 `pause` 處理常式中,任何調用到科爾多瓦 API 或穿過目標 C 的本機外掛程式不工作,以及任何互動式調用,如警報或 `console.log()` 。 當應用程式恢復後,在下一次運行迴圈上他們,只處理。
+
+特定于 iOS `resign` 事件是可用作為替代 `pause` ,並檢測時的使用者啟用**鎖定**按鈕鎖定設備與應用程式在前臺運行。 如果為多工啟用的應用程式 (和設備),則這配對與其後 `pause` 事件,但只在 iOS 5 下的。 實際上,所有鎖定應用程式已啟用多工的 iOS 5 中被推到背景中。 對於應用程式繼續運行在 iOS 5 下鎖定時,禁用應用程式的多工處理通過將[UIApplicationExitsOnSuspend][1]設置為 `YES` 。 若要運行在 iOS 4 上鎖定狀態時,此設置並不重要。
+
+ [1]: http://developer.apple.com/library/ios/#documentation/general/Reference/InfoPlistKeyReference/Articles/iPhoneOSKeys.html
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/3.1.0/cordova/events/events.resume.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/3.1.0/cordova/events/events.resume.md b/www/docs/zh-cn/3.1.0/cordova/events/events.resume.md
new file mode 100644
index 0000000..736e235
--- /dev/null
+++ b/www/docs/zh-cn/3.1.0/cordova/events/events.resume.md
@@ -0,0 +1,107 @@
+---
+license: >
+    Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+        http://www.apache.org/licenses/LICENSE-2.0
+
+    Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
+title: 簡歷
+---
+
+# 簡歷
+
+當應用程式從背景中檢索時,將觸發該事件。
+
+    document.addEventListener("resume", yourCallbackFunction, false);
+    
+
+## 詳細資訊
+
+`resume`事件觸發時的本機平臺拔出從背景的應用程式。
+
+應用程式通常應使用 `document.addEventListener` 將一個事件攔截器附加一次 `[deviceready](events.deviceready.html)` 事件火災。
+
+## 支援的平臺
+
+*   Android 系統
+*   黑莓手機 WebWorks (OS 5.0 和更高)
+*   iOS
+*   Windows Phone 7 和 8
+*   Windows 8
+
+## 快速的示例
+
+    document.addEventListener("resume", onResume, false);
+    
+    function onResume() {
+        // Handle the resume event
+    }
+    
+
+## 完整的示例
+
+    <!DOCTYPE html>
+    <html>
+      <head>
+        <title>Resume Example</title>
+    
+        <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
+        <script type="text/javascript" charset="utf-8">
+    
+        // Wait for device API libraries to load
+        //
+        function onLoad() {
+            document.addEventListener("deviceready", onDeviceReady, false);
+        }
+    
+        // device APIs are available
+        //
+        function onDeviceReady() {
+            document.addEventListener("resume", onResume, false);
+        }
+    
+        // Handle the resume event
+        //
+        function onResume() {
+        }
+    
+        </script>
+      </head>
+      <body onload="onLoad()">
+      </body>
+    </html>
+    
+
+## iOS 的怪癖
+
+從調用任何互動式函數 `pause` 事件處理常式以後執行應用程式恢復時,由發出信號 `resume` 事件。 這些包括警報, `console.log()` ,和任何調用從外掛程式或 API,科爾多瓦,穿過目標 C.
+
+*   **活動**事件
+    
+    特定于 iOS `active` 事件是可用作為替代 `resume` ,並檢測時使用者禁用**鎖定**按鈕以解鎖設備與應用程式在前臺運行。 如果為多工啟用的應用程式 (和設備),則這配對與其後 `resume` 事件,但只在 iOS 5 下的。 實際上,所有鎖定應用程式已啟用多工的 iOS 5 中被推到背景中。 對於應用程式繼續運行在 iOS 5 下鎖定時,禁用應用程式的多工處理通過將[UIApplicationExitsOnSuspend][1]設置為 `YES` 。 若要運行在 iOS 4 上鎖定狀態時,此設置並不重要。
+
+*   **恢復**事件
+    
+    當從調用 `resume` 事件處理常式,如互動式功能 `alert()` 需要包裝在 `setTimeout()` 調用超時值為零,否則應用程式掛起。 例如:
+    
+        document.addEventListener("resume", onResume, false);
+        function onResume() {
+           setTimeout(function() {
+                  // TODO: do your thing!
+                }, 0);
+        }
+        
+
+ [1]: http://developer.apple.com/library/ios/#documentation/general/Reference/InfoPlistKeyReference/Articles/iPhoneOSKeys.html
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/3.1.0/cordova/events/events.searchbutton.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/3.1.0/cordova/events/events.searchbutton.md b/www/docs/zh-cn/3.1.0/cordova/events/events.searchbutton.md
new file mode 100644
index 0000000..276547c
--- /dev/null
+++ b/www/docs/zh-cn/3.1.0/cordova/events/events.searchbutton.md
@@ -0,0 +1,82 @@
+---
+license: >
+    Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+        http://www.apache.org/licenses/LICENSE-2.0
+
+    Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
+title: searchbutton
+---
+
+# searchbutton
+
+當使用者按 Android 上的搜尋按鈕時,將觸發該事件。
+
+    document.addEventListener("searchbutton", yourCallbackFunction, false);
+    
+
+## 詳細資訊
+
+如果您需要重寫預設的搜尋按鈕行為在 android 系統上您可以註冊為 'searchbutton' 事件一個事件攔截器。
+
+應用程式通常應使用 `document.addEventListener` 將一個事件攔截器附加一次 `[deviceready](events.deviceready.html)` 事件火災。
+
+## 支援的平臺
+
+*   Android 系統
+
+## 快速的示例
+
+    document.addEventListener("searchbutton", onSearchKeyDown, false);
+    
+    function onSearchKeyDown() {
+        // Handle the search button
+    }
+    
+
+## 完整的示例
+
+    <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
+                          "http://www.w3.org/TR/html4/strict.dtd">
+    <html>
+      <head>
+        <title>Search Button Example</title>
+    
+        <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
+        <script type="text/javascript" charset="utf-8">
+    
+        // Wait for device API libraries to load
+        //
+        function onLoad() {
+            document.addEventListener("deviceready", onDeviceReady, false);
+        }
+    
+        // device APIs are available
+        //
+        function onDeviceReady() {
+            // Register the event listener
+            document.addEventListener("searchbutton", onSearchKeyDown, false);
+        }
+    
+        // Handle the search button
+        //
+        function onSearchKeyDown() {
+        }
+    
+        </script>
+      </head>
+      <body onload="onLoad()">
+      </body>
+    </html>
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/3.1.0/cordova/events/events.startcallbutton.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/3.1.0/cordova/events/events.startcallbutton.md b/www/docs/zh-cn/3.1.0/cordova/events/events.startcallbutton.md
new file mode 100644
index 0000000..f35e959
--- /dev/null
+++ b/www/docs/zh-cn/3.1.0/cordova/events/events.startcallbutton.md
@@ -0,0 +1,82 @@
+---
+license: >
+    Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+        http://www.apache.org/licenses/LICENSE-2.0
+
+    Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
+title: startcallbutton
+---
+
+# startcallbutton
+
+當使用者按下開始呼叫按鈕時,將觸發該事件。
+
+    document.addEventListener("startcallbutton", yourCallbackFunction, false);
+    
+
+## 詳細資訊
+
+如果您需要重寫預設開始調用行為您可以註冊為事件攔截器 `startcallbutton` 事件。
+
+應用程式通常應使用 `document.addEventListener` 將一個事件攔截器附加一次 `[deviceready](events.deviceready.html)` 事件火災。
+
+## 支援的平臺
+
+*   黑莓手機 WebWorks (OS 5.0 和更高)
+
+## 快速的示例
+
+    document.addEventListener("startcallbutton", onStartCallKeyDown, false);
+    
+    function onStartCallKeyDown() {
+        // Handle the start call button
+    }
+    
+
+## 完整的示例
+
+    <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
+                          "http://www.w3.org/TR/html4/strict.dtd">
+    <html>
+      <head>
+        <title>Start Call Button Example</title>
+    
+        <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
+        <script type="text/javascript" charset="utf-8">
+    
+        // Wait for device API libraries to load
+        //
+        function onLoad() {
+            document.addEventListener("deviceready", onDeviceReady, false);
+        }
+    
+        // device APIs are available
+        //
+        function onDeviceReady() {
+            // Register the event listener
+            document.addEventListener("startcallbutton", onStartCallKeyDown, false);
+        }
+    
+        // Handle the start call button
+        //
+        function onStartCallKeyDown() {
+        }
+    
+        </script>
+      </head>
+      <body onload="onLoad()">
+      </body>
+    </html>
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/3.1.0/cordova/events/events.volumedownbutton.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/3.1.0/cordova/events/events.volumedownbutton.md b/www/docs/zh-cn/3.1.0/cordova/events/events.volumedownbutton.md
new file mode 100644
index 0000000..b6fcb43
--- /dev/null
+++ b/www/docs/zh-cn/3.1.0/cordova/events/events.volumedownbutton.md
@@ -0,0 +1,82 @@
+---
+license: >
+    Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+        http://www.apache.org/licenses/LICENSE-2.0
+
+    Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
+title: volumedownbutton
+---
+
+# volumedownbutton
+
+在使用者按下按鈕卷時,將觸發該事件。
+
+    document.addEventListener("volumedownbutton", yourCallbackFunction, false);
+    
+
+## 詳細資訊
+
+如果您需要重寫預設音量降低的行為你可以註冊為事件攔截器 `volumedownbutton` 事件。
+
+應用程式通常應使用 `document.addEventListener` 將一個事件攔截器附加一次 `[deviceready](events.deviceready.html)` 事件火災。
+
+## 支援的平臺
+
+*   黑莓手機 WebWorks (OS 5.0 和更高)
+
+## 快速的示例
+
+    document.addEventListener("volumedownbutton", onVolumeDownKeyDown, false);
+    
+    function onVolumeDownKeyDown() {
+        // Handle the volume down button
+    }
+    
+
+## 完整的示例
+
+    <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
+                          "http://www.w3.org/TR/html4/strict.dtd">
+    <html>
+      <head>
+        <title>Volume Down Button Example</title>
+    
+        <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
+        <script type="text/javascript" charset="utf-8">
+    
+        // Wait for device API libraries to load
+        //
+        function onLoad() {
+            document.addEventListener("deviceready", onDeviceReady, false);
+        }
+    
+        // device APIs are available
+        //
+        function onDeviceReady() {
+            // Register the event listener
+            document.addEventListener("volumedownbutton", onVolumeDownKeyDown, false);
+        }
+    
+        // Handle the volume down button
+        //
+        function onVolumeDownKeyDown() {
+        }
+    
+        </script>
+      </head>
+      <body onload="onLoad()">
+      </body>
+    </html>
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/3.1.0/cordova/events/events.volumeupbutton.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/3.1.0/cordova/events/events.volumeupbutton.md b/www/docs/zh-cn/3.1.0/cordova/events/events.volumeupbutton.md
new file mode 100644
index 0000000..6d377f2
--- /dev/null
+++ b/www/docs/zh-cn/3.1.0/cordova/events/events.volumeupbutton.md
@@ -0,0 +1,82 @@
+---
+license: >
+    Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+        http://www.apache.org/licenses/LICENSE-2.0
+
+    Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
+title: volumeupbutton
+---
+
+# volumeupbutton
+
+當使用者按下了按鈕卷時,將觸發該事件。
+
+    document.addEventListener("volumeupbutton", yourCallbackFunction, false);
+    
+
+## 詳細資訊
+
+如果您需要重寫預設卷起來的行為你可以註冊為事件攔截器 `volumeupbutton` 事件。
+
+應用程式通常應使用 `document.addEventListener` 將一個事件攔截器附加一次 `[deviceready](events.deviceready.html)` 事件火災。
+
+## 支援的平臺
+
+*   黑莓手機 WebWorks (OS 5.0 和更高)
+
+## 快速的示例
+
+    document.addEventListener("volumeupbutton", onVolumeUpKeyDown, false);
+    
+    function onVolumeUpKeyDown() {
+        // Handle the volume up button
+    }
+    
+
+## 完整的示例
+
+    <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
+                          "http://www.w3.org/TR/html4/strict.dtd">
+    <html>
+      <head>
+        <title>Volume Up Button Example</title>
+    
+        <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
+        <script type="text/javascript" charset="utf-8">
+    
+        // Wait for device API libraries to load
+        //
+        function onLoad() {
+            document.addEventListener("deviceready", onDeviceReady, false);
+        }
+    
+        // device APIs are available
+        //
+        function onDeviceReady() {
+            // Register the event listener
+            document.addEventListener("volumeupbutton", onVolumeUpKeyDown, false);
+        }
+    
+        // Handle the volume up button
+        //
+        function onVolumeUpKeyDown() {
+        }
+    
+        </script>
+      </head>
+      <body onload="onLoad()">
+      </body>
+    </html>
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/3.1.0/cordova/file/directoryentry/directoryentry.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/3.1.0/cordova/file/directoryentry/directoryentry.md b/www/docs/zh-cn/3.1.0/cordova/file/directoryentry/directoryentry.md
new file mode 100644
index 0000000..49726bb
--- /dev/null
+++ b/www/docs/zh-cn/3.1.0/cordova/file/directoryentry/directoryentry.md
@@ -0,0 +1,384 @@
+---
+license: >
+    Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+        http://www.apache.org/licenses/LICENSE-2.0
+
+    Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
+title: 枚舉指定工作組或
+---
+
+# 枚舉指定工作組或
+
+此物件表示一個目錄在檔案系統上,如由[W3C 目錄和系統][1]規範定義的。
+
+ [1]: http://www.w3.org/TR/file-system-api/
+
+## 屬性
+
+*   **isFile**: 總是 `false` 。*(布林)*
+
+*   **isDirectory**: 總是 `true` 。*(布林)*
+
+*   **名稱**: 的名稱 `DirectoryEntry` ,不包括導致它的路徑。*() DOMString*
+
+*   **完整路徑**: 絕對路徑從根到 `DirectoryEntry` 。*() DOMString*
+
+**注:**下面的屬性由 W3C 規範定義,但*不是*支援:
+
+*   **檔案系統**: 檔案系統的 `DirectoryEntry` 駐留。*(檔案系統)*
+
+## 方法
+
+下面的方法可以上調用 `DirectoryEntry` 物件:
+
+*   **getMetadata**: 查找一個目錄有關的中繼資料。
+
+*   **setMetadata**: 在目錄上設置的中繼資料。
+
+*   **moveTo**: 移動到不同的位置在檔案系統上的目錄。
+
+*   **copyTo**: 將一個目錄複寫到檔案系統上的不同位置。
+
+*   **toURL**: 返回來説明定位目錄的 URL。
+
+*   **刪除**: 刪除一個目錄。該目錄必須是空的。
+
+*   **getParent**: 查找父目錄。
+
+*   **createReader**: 創建一個新的 `[DirectoryReader](../directoryreader/directoryreader.html)` ,可以從目錄中讀取條目。
+
+*   **getDirectory**: 創建或者查找一個目錄。
+
+*   **getFile**: 創建或查找檔。
+
+*   **removeRecursively**: 刪除一個目錄和其所有內容。
+
+## 支援的平臺
+
+*   Android 系統
+*   黑莓手機 WebWorks (OS 5.0 和更高)
+*   iOS
+*   Windows Phone 7 和 8
+*   Windows 8
+
+## getMetadata
+
+查找有關目錄的中繼資料。
+
+**參數:**
+
+*   **successCallback**: 要與執行的回呼函數 `Metadata` 物件。*(函數)*
+
+*   **errorCallback**: 一個回呼函數來執行如果檢索時出現錯誤 `Metadata` 。調用與 `[FileError](../fileerror/fileerror.html)` 物件。*(函數)*
+
+**快速的示例**
+
+    函數 success(metadata) {console.log ("上次修改時間:"+ metadata.modificationTime);}函數 fail(error) {alert(error.code);}/ / 請求的中繼資料物件的此條目 entry.getMetadata (成功、 失敗) ;
+    
+
+## setMetadata
+
+設置目錄的擴展的屬性或中繼資料。*目前僅適用于 iOS。*
+
+**參數:**
+
+*   **successCallback**: 在成功地設置該中繼資料時執行回檔。*(函數)*
+
+*   **errorCallback**: 執行中繼資料失敗要設置時的回檔。*(函數)*
+
+*   **metadataObject**: 包含中繼資料的鍵和值的物件。*(物件)*
+
+**快速的示例**
+
+    function success() {
+        console.log("The metadata was successfully set.");
+    }
+    
+    function fail() {
+        alert("There was an error in setting the metadata");
+    }
+    
+    // Set the metadata
+    entry.setMetadata(success, fail, { "com.apple.MobileBackup": 1});
+    
+
+**iOS 怪癖**
+
+*   只有 `com.apple.MobileBackup` 支援擴展的屬性。 將該值設置為 `1` ,防止該目錄從備份到 iCloud。 將該值設置為 `` ,重新啟用要備份到 iCloud 的目錄。
+
+**快速的示例**
+
+    function setFolderMetadata(localFileSystem, subFolder, metadataKey, metadataValue)
+    {
+        var onSetMetadataWin = function() {
+            console.log("success setting metadata")
+        }
+        var onSetMetadataFail = function() {
+            console.log("error setting metadata")
+        }
+    
+        var onGetDirectoryWin = function(parent) {
+            var data = {};
+            data[metadataKey] = metadataValue;
+            parent.setMetadata(onSetMetadataWin, onSetMetadataFail, data);
+        }
+        var onGetDirectoryFail = function() {
+            console.log("error getting dir")
+        }
+    
+        var onFSWin = function(fileSystem) {
+            fileSystem.root.getDirectory(subFolder, {create: true, exclusive: false}, onGetDirectoryWin, onGetDirectoryFail);
+        }
+    
+        var onFSFail = function(evt) {
+            console.log(evt.target.error.code);
+        }
+    
+        window.requestFileSystem(localFileSystem, 0, onFSWin, onFSFail);
+    }
+    
+        setFolderMetadata(LocalFileSystem.PERSISTENT, "Backups", "com.apple.MobileBackup", 1);
+    
+
+## moveTo
+
+移動到不同的位置在檔案系統上的目錄。如果應用程式嘗試向會導致錯誤:
+
+*   在任何深度移動一個目錄裡面本身或任何兒童。
+
+*   如果不提供不同從其目前的目錄的名稱,則將一個目錄移到其父。
+
+*   將一個目錄移到被佔領的一個檔的路徑。
+
+*   將一個目錄移到被佔領的一個不是空的目錄的路徑。
+
+移動目錄上現有的空目錄嘗試刪除並替換為該目錄。
+
+**參數:**
+
+*   **父**: 要移動該目錄的父目錄。*() DirectoryEntry*
+
+*   **newName**: 目錄的新名稱。預設值為當前的名稱如果未指定。*() DOMString*
+
+*   **successCallback**: 與執行的回檔 `DirectoryEntry` 為新的目錄物件。*(函數)*
+
+*   **errorCallback**: 如果移動該目錄時,會出現一個錯誤執行回檔。調用與 `[FileError](../fileerror/fileerror.html)` 物件。*(函數)*
+
+**快速的示例**
+
+    function success(entry) {
+        console.log("New Path: " + entry.fullPath);
+    }
+    
+    function fail(error) {
+        alert(error.code);
+    }
+    
+    function moveDir(entry) {
+        var parent = document.getElementById('parent').value,
+            parentName = parent.substring(parent.lastIndexOf('/')+1),
+            newName = document.getElementById('newName').value,
+            parentEntry = new DirectoryEntry(parentName, parent);
+    
+        // move the directory to a new directory and rename it
+        entry.moveTo(parentEntry, newName, success, fail);
+    }
+    
+
+## copyTo
+
+將一個目錄複寫到檔案系統上的不同位置。如果應用程式嘗試向會導致錯誤:
+
+*   複製一個目錄裡面本身在任何深度。
+
+*   如果未提供不同從其目前的目錄的名稱,請將一個目錄複寫到其父。
+
+目錄副本始終是遞迴的並將複製的目錄的所有內容。
+
+**參數:**
+
+*   **父**: 要向其複製目錄的父目錄。*() DirectoryEntry*
+
+*   **newName**: 目錄的新名稱。預設值為當前的名稱如果未指定。*() DOMString*
+
+*   **successCallback**: 與執行的回檔 `DirectoryEntry` 為新的目錄物件。*(函數)*
+
+*   **errorCallback**: 如果試圖複製基礎目錄時發生錯誤執行回檔。調用與 `[FileError](../fileerror/fileerror.html)` 物件。*(函數)*
+
+**快速的示例**
+
+    function win(entry) {
+        console.log("New Path: " + entry.fullPath);
+    }
+    
+    function fail(error) {
+        alert(error.code);
+    }
+    
+    function copyDir(entry) {
+        var parent = document.getElementById('parent').value,
+            parentName = parent.substring(parent.lastIndexOf('/')+1),
+            newName = document.getElementById('newName').value,
+            parentEntry = new DirectoryEntry(parentName, parent);
+    
+        // copy the directory to a new directory and rename it
+        entry.copyTo(parentEntry, newName, success, fail);
+    }
+    
+
+## toURL
+
+返回一個可以用來找到的目錄的 URL。
+
+**快速的示例**
+
+    // Get the URL for this directory
+    var dirURL = entry.toURL();
+    console.log(dirURL);
+    
+
+## 刪除
+
+刪除一個目錄。如果應用程式嘗試向會導致錯誤:
+
+*   刪除一個目錄,不是空的。
+
+*   刪除根目錄下的一個檔案系統。
+
+**參數:**
+
+*   **successCallback**: 在刪除該目錄後執行的回檔。不帶參數調用。*(函數)*
+
+*   **errorCallback**: 如果要刪除的目錄時,會出現錯誤執行回檔。調用與 `[FileError](../fileerror/fileerror.html)` 物件。*(函數)*
+
+**快速的示例**
+
+    函數 success(entry) {console.log ("刪除成功");}函數 fail(error) {警報 (' 刪除目錄時出錯: ' + error.code);}/ / 刪除此目錄 entry.remove (成功、 失敗) ;
+    
+
+## getParent
+
+查找父 `DirectoryEntry` 包含的目錄。
+
+**參數:**
+
+*   **successCallback**: 一個通過目錄的父目錄的回檔 `DirectoryEntry` 。*(函數)*
+
+*   **errorCallback**: 如果試圖檢索父時發生錯誤執行的回檔 `DirectoryEntry` 。 調用與 `[FileError](../fileerror/fileerror.html)` 物件。 *(函數)*
+
+**快速的示例**
+
+    function success(parent) {
+        console.log("Parent Name: " + parent.name);
+    }
+    
+    function fail(error) {
+        alert('Failed to get parent directory: ' + error.code);
+    }
+    
+    // Get the parent DirectoryEntry
+    entry.getParent(success, fail);
+    
+
+## createReader
+
+創建新的 [DirectoryReader](../directoryreader/directoryreader.html) 來讀取目錄中的條目。
+
+**快速的示例**
+
+    // create a directory reader
+    var directoryReader = entry.createReader();
+    
+
+## getDirectory
+
+創建或查找現有的目錄。如果應用程式嘗試向會導致錯誤:
+
+*   創建一個其直接父尚不存在的目錄。
+
+**參數:**
+
+*   **路徑**: 要查找或創建的目錄的路徑。絕對路徑或相對路徑從這 `DirectoryEntry` 。*() DOMString*
+
+*   **選項**: 選項,以指定是否要如果它不存在,則創建該目錄。*(標誌)*
+
+*   **successCallback**: 回檔的執行的 `DirectoryEntry` 物件。*(函數)*
+
+*   **errorCallback**: 如果發生錯誤時創建或查找目錄執行的回檔。調用與 `[FileError](../fileerror/fileerror.html)` 物件。*(函數)*
+
+**快速的示例**
+
+    函數 success(dirEntry) {console.log ("目錄名稱:"+ dirEntry.name);}函數 fail(error) {警報 ("無法創建新的目錄:"+ error.code);}/ / 檢索現有的目錄,或創建它,如果它不存在 entry.getDirectory ("newDir",{創建: true,獨家: false},成功,失敗) ;
+    
+
+## getFile
+
+創建或查找檔。如果應用程式嘗試向會導致錯誤:
+
+*   創建一個其直接父尚不存在的檔。
+
+**參數:**
+
+*   **路徑**: 要查找或創建的檔的路徑。絕對路徑或相對路徑從這 `DirectoryEntry` 。*() DOMString*
+
+*   **選項**: 選項,以指定是否是否它不存在,則創建該檔。*(標誌)*
+
+*   **successCallback**: 傳遞一個回檔 `[FileEntry](../fileentry/fileentry.html)` 物件。*(函數)*
+
+*   **errorCallback**: 如果在創建或查找檔時出現錯誤執行回檔。調用與 `[FileError](../fileerror/fileerror.html)` 物件。*(函數)*
+
+**快速的示例**
+
+    函數 success(fileEntry) {console.log ("檔的名稱:"+ fileEntry.name);}函數 fail(error) {警報 ("未能檢索檔:"+ error.code);}/ / 檢索現有的檔,或創建它,如果它不存在 entry.getFile ("newFile.txt",{創建: true,獨家: false},成功,失敗) ;
+    
+
+## removeRecursively
+
+刪除一個目錄和其所有內容。 如果發生錯誤 (例如試圖刪除包含一個不能被刪除的檔的目錄),可能會刪除一些目錄的內容。 如果應用程式嘗試向會導致錯誤:
+
+*   刪除根目錄下的一個檔案系統。
+
+**參數:**
+
+*   **successCallback**: 後執行的回檔 `DirectoryEntry` 已被刪除。不帶參數調用。*(函數)*
+
+*   **errorCallback**: 如果試圖刪除時發生錯誤執行的回檔 `DirectoryEntry` 。調用與 `[FileError](../fileerror/fileerror.html)` 物件。*(函數)*
+
+**快速的示例**
+
+    function success(parent) {
+        console.log("Remove Recursively Succeeded");
+    }
+    
+    function fail(error) {
+        alert("Failed to remove directory or it's contents: " + error.code);
+    }
+    
+    // remove the directory and all it's contents
+    entry.removeRecursively(success, fail);
+    
+
+## 黑莓手機的怪癖
+
+可能會失敗, `ControlledAccessException` 在以下情況中:
+
+*   應用程式試圖訪問由以前安裝的應用程式創建一個目錄。
+
+> 解決方案: 確保手動,或由前重新安裝應用程式的臨時目錄,清潔。
+
+*   如果該設備通過 USB 連接。
+
+> 解決方案: 從設備拔下 USB 電纜,然後再次運行。
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/3.1.0/cordova/file/directoryreader/directoryreader.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/3.1.0/cordova/file/directoryreader/directoryreader.md b/www/docs/zh-cn/3.1.0/cordova/file/directoryreader/directoryreader.md
new file mode 100644
index 0000000..cdfa022
--- /dev/null
+++ b/www/docs/zh-cn/3.1.0/cordova/file/directoryreader/directoryreader.md
@@ -0,0 +1,68 @@
+---
+license: >
+    Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+        http://www.apache.org/licenses/LICENSE-2.0
+
+    Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
+title: DirectoryReader
+---
+
+# DirectoryReader
+
+列出檔和目錄在目錄中,如[W3C 目錄和系統][1]規範中定義的物件。
+
+ [1]: http://www.w3.org/TR/file-system-api/
+
+## 方法
+
+*   **readEntries**: 讀取一個目錄中的條目。
+
+## 支援的平臺
+
+*   Android 系統
+*   黑莓手機 WebWorks (OS 5.0 和更高)
+*   iOS
+*   Windows Phone 7 和 8
+*   Windows 8
+
+## readEntries
+
+讀取此目錄中的項。
+
+**參數:**
+
+*   **successCallback**: 一個傳遞的陣列的回檔 `[FileEntry](../fileentry/fileentry.html)` 和 `DirectoryEntry` 的物件。*(函數)*
+
+*   **errorCallback**: 如果檢索目錄清單時發生錯誤執行回檔。調用與 `[FileError](../fileerror/fileerror.html)` 物件。*(函數)*
+
+**快速的示例**
+
+    function success(entries) {
+        var i;
+        for (i=0; i<entries.length; i++) {
+            console.log(entries[i].name);
+        }
+    }
+    
+    function fail(error) {
+        alert("Failed to list directory contents: " + error.code);
+    }
+    
+    // Get a directory reader
+    var directoryReader = dirEntry.createReader();
+    
+    // Get a list of all the entries in the directory
+    directoryReader.readEntries(success,fail);
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/3.1.0/cordova/file/file.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/3.1.0/cordova/file/file.md b/www/docs/zh-cn/3.1.0/cordova/file/file.md
new file mode 100644
index 0000000..a16cafa
--- /dev/null
+++ b/www/docs/zh-cn/3.1.0/cordova/file/file.md
@@ -0,0 +1,110 @@
+---
+license: >
+    Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+        http://www.apache.org/licenses/LICENSE-2.0
+
+    Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
+title: 檔
+---
+
+# 檔
+
+> 一個 API,用於讀取、 寫入和導航基於[w3c [檔](fileobj/fileobj.html) api][1]的檔案系統層次結構.
+
+ [1]: http://www.w3.org/TR/FileAPI
+
+## 物件
+
+*   [枚舉指定工作組或](directoryentry/directoryentry.html)
+*   [DirectoryReader](directoryreader/directoryreader.html)
+*   [檔](fileobj/fileobj.html)
+*   [FileEntry](fileentry/fileentry.html)
+*   [FileError](fileerror/fileerror.html)
+*   [FileReader](filereader/filereader.html)
+*   [檔案系統](filesystem/filesystem.html)
+*   [檔案傳輸](filetransfer/filetransfer.html)
+*   [FileTransferError](filetransfererror/filetransfererror.html)
+*   [FileUploadOptions](fileuploadoptions/fileuploadoptions.html)
+*   [FileUploadResult](fileuploadresult/fileuploadresult.html)
+*   [FileWriter](filewriter/filewriter.html)
+*   [標誌](flags/flags.html)
+*   [場合](localfilesystem/localfilesystem.html)
+*   [中繼資料](metadata/metadata.html)
+
+## 訪問功能
+
+從 3.0 版,科爾多瓦作為*外掛程式*實現了設備級 Api。 使用 CLI 的 `plugin` 命令,描述在命令列介面,可以添加或刪除一個專案,為此功能:
+
+        $ cordova plugin add org.apache.cordova.file
+        $ cordova plugin ls
+        [ 'org.apache.cordova.file' ]
+        $ cordova plugin rm org.apache.cordova.file
+    
+
+要使用的檔案傳輸外掛程式必須單獨添加的。
+
+        $ cordova plugin add org.apache.cordova.file-transfer
+        $ cordova plugin ls
+        [ 'org.apache.cordova.file-transfer' ]
+        $ cordova plugin rm org.apache.cordova.file-transfer
+    
+
+這些命令適用于所有有針對性的平臺,但修改如下所述的特定于平臺的配置設置:
+
+*   Android 系統
+    
+        (in app/res/xml/config.xml)
+        <feature name="File">
+            <param name="android-package" value="org.apache.cordova.FileUtils" />
+        </feature>
+        <feature name="FileTransfer">
+            <param name="android-package" value="org.apache.cordova.FileTransfer" />
+        </feature>
+        
+        (in app/AndroidManifest.xml)
+        <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
+        
+
+*   黑莓手機 WebWorks
+    
+        (in www/plugins.xml)
+        <feature name="File">
+            <param name="blackberry-package" value="org.apache.cordova.file.FileManager" />
+        </feature>
+        <feature name="FileTransfer">
+            <param name="blackberry-package" value="org.apache.cordova.http.FileTransfer" />
+        </feature>
+        
+        (in www/config.xml)
+        <feature id="blackberry.io.file" required="true" version="1.0.0.0" />
+        <feature id="blackberry.utils"   required="true" version="1.0.0.0" />
+        <feature id="blackberry.io.dir"  required="true" version="1.0.0.0" />
+        <rim:permissions>
+            <rim:permit>access_shared</rim:permit>
+        </rim:permissions>
+        
+
+*   (在 iOS`config.xml`)
+    
+        <feature name="File">
+            <param name="ios-package" value="CDVFile" />
+        </feature>
+        <feature name="FileTransfer">
+            <param name="ios-package" value="CDVFileTransfer" />
+        </feature>
+        
+
+一些平臺可能支援此功能,而無需任何特殊的配置。請參見在概述部分中*的平臺支援*。
\ No newline at end of file

http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/a890e4de/www/docs/zh-cn/3.1.0/cordova/file/fileentry/fileentry.md
----------------------------------------------------------------------
diff --git a/www/docs/zh-cn/3.1.0/cordova/file/fileentry/fileentry.md b/www/docs/zh-cn/3.1.0/cordova/file/fileentry/fileentry.md
new file mode 100644
index 0000000..88d018b
--- /dev/null
+++ b/www/docs/zh-cn/3.1.0/cordova/file/fileentry/fileentry.md
@@ -0,0 +1,334 @@
+---
+license: >
+    Licensed to the Apache Software Foundation (ASF) under one
+    or more contributor license agreements.  See the NOTICE file
+    distributed with this work for additional information
+    regarding copyright ownership.  The ASF licenses this file
+    to you under the Apache License, Version 2.0 (the
+    "License"); you may not use this file except in compliance
+    with the License.  You may obtain a copy of the License at
+
+        http://www.apache.org/licenses/LICENSE-2.0
+
+    Unless required by applicable law or agreed to in writing,
+    software distributed under the License is distributed on an
+    "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+    KIND, either express or implied.  See the License for the
+    specific language governing permissions and limitations
+    under the License.
+
+title: FileEntry
+---
+
+# FileEntry
+
+表示一個檔在檔案系統上, [W3C 目錄和系統][1]規範中定義。
+
+ [1]: http://www.w3.org/TR/file-system-api/
+
+## 屬性
+
+*   **isFile**: 總是 `true` 。*(布林)*
+
+*   **isDirectory**: 總是 `false` 。*(布林)*
+
+*   **名稱**: 的名稱 `FileEntry` ,不包括導致它的路徑。*() DOMString*
+
+*   **完整路徑**: 絕對路徑從根到 `FileEntry` 。*() DOMString*
+
+**注:**下面的屬性由 W3C 規範定義,但*不是*支援:
+
+*   **檔案系統**: 檔案系統的 `FileEntry` 駐留。*(檔案系統)*
+
+## 方法
+
+*   **getMetadata**: 查找有關檔的中繼資料。
+
+*   **setMetadata**: 設置檔上的中繼資料。
+
+*   **moveTo**: 將檔移動到一個不同的位置,在檔案系統上。
+
+*   **copyTo**: 將檔案複製到檔案系統上的不同位置。
+
+*   **toURL**: 返回一個可用於查找的檔的 URL。
+
+*   **刪除**: 刪除一個檔。
+
+*   **getParent**: 查找父目錄。
+
+*   **createWriter**: 創建 `[FileWriter](../filewriter/filewriter.html)` 物件,可用於向檔中寫入。
+
+*   **檔**: 創建 `File` 物件,其中包含檔案屬性。
+
+## 支援的平臺
+
+*   Android 系統
+*   黑莓手機 WebWorks (OS 5.0 和更高)
+*   iOS
+*   Windows Phone 7 和 8
+*   Windows 8
+
+## getMetadata
+
+查找有關檔的中繼資料。
+
+**參數:**
+
+*   **successCallback**: 傳遞一個回檔 `Metadata` 物件。*(函數)*
+
+*   **errorCallback**: 如果錯誤發生在檢索時將執行的回檔 `Metadata` 。調用與 `[FileError](../fileerror/fileerror.html)` 物件。*(函數)*
+
+**快速的示例**
+
+    函數 success(metadata) {console.log ("上次修改時間:"+ metadata.modificationTime);}函數 fail(error) {alert(error.code);}/ / 請求的中繼資料物件的此條目 entry.getMetadata (成功、 失敗) ;
+    
+
+## setMetadata
+
+上一個檔集的中繼資料。
+
+**目前僅適用于 iOS。**
+
+*   這將設置一個檔的擴展的屬性。
+
+**參數:**
+
+*   **successCallback**: 當設置該中繼資料時執行回檔。*(函數)*
+
+*   **errorCallback**: 當不成功地設置該中繼資料時執行回檔。*(函數)*
+
+*   **metadataObject**: 包含中繼資料的鍵和值的物件。*(物件)*
+
+**快速的示例**
+
+    function success() {
+        console.log("The metadata was successfully set.");
+    }
+    
+    function fail() {
+        alert("There was an error in setting the metadata");
+    }
+    
+    // Set the metadata
+    entry.setMetadata(success, fail, { "com.apple.MobileBackup": 1});
+    
+
+**iOS 怪癖**
+
+*   只有 `com.apple.MobileBackup` 支援擴展的屬性。 將該值設置為 `1` ,防止檔被備份到 iCloud。 將該值設置為 `` ,重新啟用該檔以將備份到 iCloud。
+
+**快速的示例**
+
+    function setFileMetadata(localFileSystem, filePath, metadataKey, metadataValue)
+    {
+        var onSetMetadataWin = function() {
+            console.log("success setting metadata")
+        }
+        var onSetMetadataFail = function() {
+            console.log("error setting metadata")
+        }
+    
+        var onGetFileWin = function(parent) {
+            var data = {};
+            data[metadataKey] = metadataValue;
+            parent.setMetadata(onSetMetadataWin, onSetMetadataFail, data);
+        }
+        var onGetFileFail = function() {
+            console.log("error getting file")
+        }
+    
+        var onFSWin = function(fileSystem) {
+            fileSystem.root.getFile(filePath, {create: true, exclusive: false}, onGetFileWin, onGetFileFail);
+        }
+    
+        var onFSFail = function(evt) {
+            console.log(evt.target.error.code);
+        }
+    
+        window.requestFileSystem(localFileSystem, 0, onFSWin, onFSFail);
+    }
+    
+        setFileMetadata(LocalFileSystem.PERSISTENT, "Backups/sqlite.db", "com.apple.MobileBackup", 1);
+    
+
+## moveTo
+
+在檔案系統上的檔移到不同的位置。如果應用程式嘗試向會導致錯誤:
+
+*   將檔移到其父,如果沒有提供從其當前的一個不同的名稱 ;
+
+*   將檔移動到被佔領 ; 每個目錄的路徑
+
+此外,在現有檔中移動檔將嘗試刪除和替換該檔。
+
+**參數:**
+
+*   **父**: 要將檔移到父目錄。*() DirectoryEntry*
+
+*   **newName**: 該檔的新名稱。預設值為當前的名稱如果未指定。*() DOMString*
+
+*   **successCallback**: 傳遞新檔回檔 `FileEntry` 物件。*(函數)*
+
+*   **errorCallback**: 如果嘗試移動檔時發生錯誤執行回檔。調用與 `[FileError](../fileerror/fileerror.html)` 物件。*(函數)*
+
+**快速的示例**
+
+    function success(entry) {
+        console.log("New Path: " + entry.fullPath);
+    }
+    
+    function fail(error) {
+        alert(error.code);
+    }
+    
+    function moveFile(entry) {
+        var parent = document.getElementById('parent').value,
+            parentName = parent.substring(parent.lastIndexOf('/')+1),
+            parentEntry = new DirectoryEntry(parentName, parent);
+    
+        // move the file to a new directory and rename it
+        entry.moveTo(parentEntry, "newFile.txt", success, fail);
+    }
+    
+
+## copyTo
+
+將檔案複製到檔案系統上的新位置。如果應用程式嘗試向會導致錯誤:
+
+*   如果未提供從其當前的一個不同的名稱,請將檔案複製到其父。
+
+**參數:**
+
+*   **父**: 要向其複製該檔的父目錄。*() DirectoryEntry*
+
+*   **newName**: 該檔的新名稱。預設值為當前的名稱如果未指定。*() DOMString*
+
+*   **successCallback**: 傳遞新檔回檔 `FileEntry` 物件。*(函數)*
+
+*   **errorCallback**: 如果試圖複製檔時發生錯誤執行回檔。調用與 `[FileError](../fileerror/fileerror.html)` 物件。*(函數)*
+
+**快速的示例**
+
+    function win(entry) {
+        console.log("New Path: " + entry.fullPath);
+    }
+    
+    function fail(error) {
+        alert(error.code);
+    }
+    
+    function copyFile(entry) {
+        var parent = document.getElementById('parent').value,
+            parentName = parent.substring(parent.lastIndexOf('/')+1),
+            parentEntry = new DirectoryEntry(parentName, parent);
+    
+        // copy the file to a new directory and rename it
+        entry.copyTo(parentEntry, "file.copy", success, fail);
+    }
+    
+
+## toURL
+
+返回一個可用於查找的檔的 URL。
+
+**快速的示例**
+
+    // Request the URL for this entry
+    var fileURL = entry.toURL();
+    console.log(fileURL);
+    
+
+## 刪除
+
+刪除的檔。
+
+**參數:**
+
+*   **successCallback**: 在該檔已被刪除後執行的回檔。不帶參數調用。*(函數)*
+
+*   **errorCallback**: 如果嘗試刪除檔時出現錯誤執行回檔。調用與 `[FileError](../fileerror/fileerror.html)` 物件。*(函數)*
+
+**快速的示例**
+
+    function success(entry) {
+        console.log("Removal succeeded");
+    }
+    
+    function fail(error) {
+        alert('Error removing file: ' + error.code);
+    }
+    
+    // remove the file
+    entry.remove(success, fail);
+    
+
+## getParent
+
+查找父 `DirectoryEntry` 包含該檔。
+
+**參數:**
+
+*   **successCallback**: 傳遞檔的父的回檔 `DirectoryEntry` 。*(函數)*
+
+*   **errorCallback**: 如果試圖檢索父時發生錯誤執行的回檔 `DirectoryEntry` 。 調用與 `[FileError](../fileerror/fileerror.html)` 物件。 *(函數)*
+
+**快速的示例**
+
+    function success(parent) {
+        console.log("Parent Name: " + parent.name);
+    }
+    
+    function fail(error) {
+        alert(error.code);
+    }
+    
+    // Get the parent DirectoryEntry
+    entry.getParent(success, fail);
+    
+
+## createWriter
+
+創建 `[FileWriter](../filewriter/filewriter.html)` 物件與所代表的檔關聯`FileEntry`.
+
+**參數:**
+
+*   **successCallback**: 傳遞一個回檔 `[FileWriter](../filewriter/filewriter.html)` 物件。*(函數)*
+
+*   **errorCallback**: 如果試圖創建 [FileWriter](../filewriter/filewriter.html) 而發生錯誤執行回檔。調用與 `[FileError](../fileerror/fileerror.html)` 物件。*(函數)*
+
+**快速的示例**
+
+    function success(writer) {
+        writer.write("Some text to the file");
+    }
+    
+    function fail(error) {
+        alert(error.code);
+    }
+    
+    // create a FileWriter to write to the file
+    entry.createWriter(success, fail);
+    
+
+## 檔
+
+返回 `File` 物件,它表示該檔的目前狀態,這 `FileEntry` 表示。
+
+**參數:**
+
+*   **successCallback**: 傳遞一個回檔 `File` 物件。*(函數)*
+
+*   **errorCallback**: 回檔的執行如果發生錯誤時創建 `File` 物件,例如當該檔不再存在。 調用與 `[FileError](../fileerror/fileerror.html)` 物件。 *(函數)*
+
+**快速的示例**
+
+    function success(file) {
+        console.log("File size: " + file.size);
+    }
+    
+    function fail(error) {
+        alert("Unable to retrieve file properties: " + error.code);
+    }
+    
+    // obtain properties of a file
+    entry.file(success, fail);
\ No newline at end of file


---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@cordova.apache.org
For additional commands, e-mail: commits-help@cordova.apache.org


Mime
View raw message