You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cordova.apache.org by mw...@apache.org on 2013/09/10 19:37:27 UTC
[42/51] [abbrv] [partial] Move Japanese to docs/ja and Korean to
docs/ko.
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/e7168dd7/docs/ja/1.8.1/cordova/contacts/ContactField/contactfield.md
----------------------------------------------------------------------
diff --git a/docs/ja/1.8.1/cordova/contacts/ContactField/contactfield.md b/docs/ja/1.8.1/cordova/contacts/ContactField/contactfield.md
new file mode 100644
index 0000000..62aae03
--- /dev/null
+++ b/docs/ja/1.8.1/cordova/contacts/ContactField/contactfield.md
@@ -0,0 +1,146 @@
+---
+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.
+---
+
+ContactField
+============
+
+`Contact` オブジェクトで使用される汎用フィールドに用いられます。 `ContactField` オブジェクトとして格納されるデータとしては、メールアドレスや電話番号などが挙げられます。
+
+プロパティー
+----------
+
+- __type:__ フィールドのタイプを表します (例: 'home') _(DOMString)_
+- __value:__ フィールド値を表します (例: 電話番号、メールアドレス) _(DOMString)_
+- __pref:__ `ContactField` がユーザーの推奨値を含むかどうかを表します。含む場合、 `true` がセットされます _(boolean)_
+
+詳細
+-------
+
+`ContactField` オブジェクトは、連絡先の各フィールドを汎用的に格納するためのコンポーネントです。各 `ContactField` オブジェクトは、 value プロパティ、 type プロパティ、 pref プロパティーを持っています。 `Contact` オブジェクトは電話番号やメールアドレスなどといった複数のプロパティーを `ContactField[]` 配列に保存しています。
+
+多くの場合 `ContactField` オブジェクトの __type__ 属性に定義済みの値は存在しません。例えば、電話番号について __type__ 属性の値として 'home', 'work', 'mobile', 'iPhone' など、デバイスのプラットフォームに応じて異なった値が格納されます。ただし `Contact` の __photos__ フィールドに限り、 __type__ 属性には画像フォーマットが格納されます。 Cordova は __value__ 属性が画像への URL を含む場合、 __type: 'url'__ を返します。 __value__ 属性が Base64 形式の画像を含む場合、 __type: 'base64'__ を返します。
+
+サポートされているプラットフォーム
+-------------------
+
+- Android
+- BlackBerry WebWorks (OS 5.0 以上)
+- iOS
+- Bada 1.2 & 2.0
+
+使用例
+-------------
+
+ // 新しい連絡先を作成
+ var contact = navigator.contacts.create();
+
+ // 連絡先の電話番号を ContactField[] に格納
+ var phoneNumbers = [];
+ phoneNumbers[0] = new ContactField('work', '212-555-1234', false);
+ phoneNumbers[1] = new ContactField('mobile', '917-555-5432', true); // 推奨された電話番号
+ phoneNumbers[2] = new ContactField('home', '203-555-7890', false);
+ contact.phoneNumbers = phoneNumbers;
+
+ // 連絡先を保存
+ contact.save();
+
+詳細な使用例
+------------
+
+ <!DOCTYPE html>
+ <html>
+ <head>
+ <title>Contact の使用例</title>
+
+ <script type="text/javascript" charset="utf-8" src="cordova-1.8.1.js"></script>
+ <script type="text/javascript" charset="utf-8">
+
+ // Cordova の読み込み完了まで待機
+ //
+ document.addEventListener("deviceready", onDeviceReady, false);
+
+ // Cordova 準備完了
+ //
+ function onDeviceReady() {
+ // 新しい連絡先を作成
+ var contact = navigator.contacts.create();
+
+ // 連絡先の電話番号を ContactField[] に格納
+ var phoneNumbers = [];
+ phoneNumbers[0] = new ContactField('work', '212-555-1234', false);
+ phoneNumbers[1] = new ContactField('mobile', '917-555-5432', true); // 推奨された電話番号
+ phoneNumbers[2] = new ContactField('home', '203-555-7890', false);
+ contact.phoneNumbers = phoneNumbers;
+
+ // 連絡先を保存
+ contact.save();
+
+ // 連絡先を検索し、名前と電話番号を表示
+ var options = new ContactFindOptions();
+ options.filter="";
+ filter = ["displayName","phoneNumbers"];
+ navigator.contacts.find(filter, onSuccess, onError, options);
+ }
+
+ // onSuccess: 連絡先の取得に成功した場合
+ //
+ function onSuccess(contacts) {
+ for (var i=0; i<contacts.length; i++) {
+ // 電話番号を表示
+ for (var j=0; j<contacts[i].phoneNumbers.length; j++) {
+ alert("タイプ: " + contacts[i].phoneNumbers[j].type + "\n" +
+ "値: " + contacts[i].phoneNumbers[j].value + "\n" +
+ "Preferred: " + contacts[i].phoneNumbers[j].pref);
+ }
+ }
+ };
+ // onError: 連絡先の取得に失敗した場合
+ //
+ function onError(contactError) {
+ alert('エラーが発生しました。');
+ }
+
+ </script>
+ </head>
+ <body>
+ <h1>使用例</h1>
+ <p>連絡先の検索</p>
+ </body>
+ </html>
+
+Android に関する注意点
+--------------
+
+- __pref:__ このプロパティーは Android ではサポートされておらず、常に `false` を返します。
+
+BlackBerry WebWorks (OS 5.0 and higher) に関する注意点
+--------------------------------------------
+
+- __type:__ 部分的にサポートされています。電話番号に使われます。
+- __value:__ サポートされています。
+- __pref:__ このプロパティーはサポートされておらず、常に `false` を返します。
+
+iOS に関する注意点
+-----------
+
+- __pref:__ このプロパティーは iOS ではサポートされておらず、常に `false` を返します。
+
+Bada に関する注意点
+-----------
+- __type:__ メールアドレス または 住所 フィールドの場合、プロパティーは次のいずれかである必要があります: "WORK", "HOME"。電話フィールドの場合、プロパティーは次のいずれかである必要があります: "WORK", "HOME", "VOICE", "FAX", "MSG", "CELL", "PAGER", "BBS", "MODEM", "CAR", "ISDN","VIDEO", "PCS"。
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/e7168dd7/docs/ja/1.8.1/cordova/contacts/ContactFindOptions/contactfindoptions.md
----------------------------------------------------------------------
diff --git a/docs/ja/1.8.1/cordova/contacts/ContactFindOptions/contactfindoptions.md b/docs/ja/1.8.1/cordova/contacts/ContactFindOptions/contactfindoptions.md
new file mode 100644
index 0000000..1ab794c
--- /dev/null
+++ b/docs/ja/1.8.1/cordova/contacts/ContactFindOptions/contactfindoptions.md
@@ -0,0 +1,116 @@
+---
+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.
+---
+
+ContactFindOptions
+==================
+
+`contacts.find` 関数の検索結果を絞るために使用するプロパティーを表します。
+
+プロパティー
+----------
+
+- __filter:__ 絞り込み検索用の文字列を指定します _(DOMString)_ (デフォルト: "")
+- __multiple:__ 検索時に複数の連絡先を返すかどうかを指定します _(Boolean)_ (デフォルト: false)
+
+
+サポートされているプラットフォーム
+-------------------
+
+- Android
+- BlackBerry WebWorks (OS 5.0 以上)
+- iOS
+- Bada 1.2 & 2.0
+
+使用例
+-------------
+
+ // 呼び出し成功
+ function onSuccess(contacts) {
+ for (var i=0; i<contacts.length; i++) {
+ alert(contacts[i].displayName);
+ }
+ };
+
+ // 呼び出し失敗
+ function onError(contactError) {
+ alert('エラーが発生しました。');
+ };
+
+ // 検索条件を指定
+ var options = new ContactFindOptions();
+ options.filter=""; // 空のサーチは全ての連絡先を返す
+ options.multiple=true; // 複数の結果を返す
+ filter = ["displayName"]; // contact.displayName フィールドを返す
+
+ // 連絡先を検索します
+ navigator.contacts.find(filter, onSuccess, onError, options);
+
+詳細な使用例
+------------
+
+ <!DOCTYPE html>
+ <html>
+ <head>
+ <title>Contact の使用例</title>
+
+ <script type="text/javascript" charset="utf-8" src="cordova-1.8.1.js"></script>
+ <script type="text/javascript" charset="utf-8">
+
+ // Cordova の読み込み完了まで待機
+ //
+ document.addEventListener("deviceready", onDeviceReady, false);
+
+ // Cordova 準備完了
+ //
+ function onDeviceReady() {
+ // 検索条件を指定
+ var options = new ContactFindOptions();
+ options.filter=""; // 空のサーチは全ての連絡先を返す
+ options.multiple=true; // 複数の結果を返す
+ filter = ["displayName"]; // contact.displayName フィールドを返す
+
+ // 連絡先を検索します
+ navigator.contacts.find(filter, onSuccess, onError, options);
+ }
+
+ // onSuccess: 連絡先の取得に成功した場合
+ //
+ function onSuccess(contacts) {
+ for (var i=0; i<contacts.length; i++) {
+ alert(contacts[i].displayName);
+ }
+ };
+
+ // onError: 連絡先の取得に失敗した場合
+ //
+ function onError(contactError) {
+ alert('エラーが発生しました。');
+ }
+
+ </script>
+ </head>
+ <body>
+ <h1>使用例</h1>
+ <p>連絡先の検索</p>
+ </body>
+ </html>
+
+Bada に関する注意点
+-----------
+__filter:__ このプロパティーには次の値のみ適用できます: "firstName", "lastName", "nickname", "phoneNumber", "email", "address"
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/e7168dd7/docs/ja/1.8.1/cordova/contacts/ContactName/contactname.md
----------------------------------------------------------------------
diff --git a/docs/ja/1.8.1/cordova/contacts/ContactName/contactname.md b/docs/ja/1.8.1/cordova/contacts/ContactName/contactname.md
new file mode 100644
index 0000000..2ea3517
--- /dev/null
+++ b/docs/ja/1.8.1/cordova/contacts/ContactName/contactname.md
@@ -0,0 +1,145 @@
+---
+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.
+---
+
+ContactName
+===========
+
+`Contact` オブジェクトの名前プロパティーを表します。
+
+プロパティー
+----------
+
+- __formatted:__ 連絡先のフルネームを表します _(DOMString)_
+- __familyName:__ 連絡先の姓を表します _(DOMString)_
+- __givenName:__ 連絡先の名を表します _(DOMString)_
+- __middleName:__ 連絡先のミドルネームを表します _(DOMString)_
+- __honorificPrefix:__ 連絡先の接頭敬称を表します (例: Mr. Dr.) _(DOMString)_
+- __honorificSuffix:__ 連絡先の接尾敬称を表します (例: Esq.) _(DOMString)_
+
+詳細
+-------
+
+`ContactName` オブジェクトは連絡先の名前プロパティーの情報を格納します。
+
+サポートされているプラットフォーム
+-------------------
+
+- Android 2.X
+- BlackBerry WebWorks (OS 5.0 以上)
+- iOS
+- Bada 1.2 & 2.0
+
+使用例
+-------------
+
+ function onSuccess(contacts) {
+ for (var i=0; i<contacts.length; i++) {
+ alert("名前: " + contacts[i].name.formatted + "\n" +
+ "姓: " + contacts[i].name.familyName + "\n" +
+ "名: " + contacts[i].name.givenName + "\n" +
+ "ミドルネーム: " + contacts[i].name.middleName + "\n" +
+ "接頭敬称: " + contacts[i].name.honorificSuffix + "\n" +
+ "接尾敬称: " + contacts[i].name.honorificSuffix);
+ }
+ };
+
+ function onError(contactError) {
+ alert('エラーが発生しました。');
+ };
+
+ var options = new ContactFindOptions();
+ options.filter="";
+ filter = ["displayName","name"];
+ navigator.contacts.find(filter, onSuccess, onError, options);
+
+詳細な使用例
+------------
+
+ <!DOCTYPE html>
+ <html>
+ <head>
+ <title>Contact の使用例</title>
+
+ <script type="text/javascript" charset="utf-8" src="cordova-1.8.1.js"></script>
+ <script type="text/javascript" charset="utf-8">
+
+ // Cordova の読み込み完了まで待機
+ //
+ document.addEventListener("deviceready", onDeviceReady, false);
+
+ // Cordova 準備完了
+ //
+ function onDeviceReady() {
+ var options = new ContactFindOptions();
+ options.filter="";
+ filter = ["displayName","name"];
+ navigator.contacts.find(filter, onSuccess, onError, options);
+ }
+
+ // onSuccess: 連絡先の取得に成功した場合
+ //
+ function onSuccess(contacts) {
+ for (var i=0; i<contacts.length; i++) {
+ alert("名前: " + contacts[i].name.formatted + "\n" +
+ "姓: " + contacts[i].name.familyName + "\n" +
+ "名: " + contacts[i].name.givenName + "\n" +
+ "ミドルネーム: " + contacts[i].name.middleName + "\n" +
+ "接頭敬称: " + contacts[i].name.honorificSuffix + "\n" +
+ "接尾敬称: " + contacts[i].name.honorificSuffix);
+ }
+ };
+
+ // onError: 連絡先の取得に失敗した場合
+ //
+ function onError(contactError) {
+ alert('エラーが発生しました。');
+ }
+
+ </script>
+ </head>
+ <body>
+ <h1>使用例</h1>
+ <p>連絡先の検索</p>
+ </body>
+ </html>
+
+Android に関する注意点
+------------
+- __formatted:__ 部分的にサポートされています。 honorificPrefix, givenName, middleName, familyName, honorificSuffix を連結したものを返しますが、保存は行われません。
+
+BlackBerry WebWorks (OS 5.0 and higher) に関する注意点
+---------------------------------------------
+
+- __formatted:__ 部分的にサポートされています。 BlackBerry の __firstName__ と __lastName__ フィールドを連結したものを返します。
+- __familyName:__ サポートされています。 BlackBerry の __lastName__ フィールドに保存されています。
+- __givenName:__ サポートされています。 BlackBerry の __firstName__ フィールドに保存されています。
+- __middleName:__ このプロパティーはサポートされておらず、常に `null` を返します。
+- __honorificPrefix:__ このプロパティーはサポートされておらず、常に `null` を返します。
+- __honorificSuffix:__ このプロパティーはサポートされておらず、常に `null` を返します。
+
+iOS に関する注意点
+------------
+- __formatted:__ 部分的にサポートされています。 iOS の合成名を返しますが、保存は行われません。
+
+Bada に関する注意点
+-----------
+- __formatted:__ サポートされていません。
+- __middleName:__ サポートされていません。
+_ __honorificPrefix:__ サポートされていません。
+- __honorificSuffix:__ サポートされていません。
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/e7168dd7/docs/ja/1.8.1/cordova/contacts/ContactOrganization/contactorganization.md
----------------------------------------------------------------------
diff --git a/docs/ja/1.8.1/cordova/contacts/ContactOrganization/contactorganization.md b/docs/ja/1.8.1/cordova/contacts/ContactOrganization/contactorganization.md
new file mode 100644
index 0000000..ac5088d
--- /dev/null
+++ b/docs/ja/1.8.1/cordova/contacts/ContactOrganization/contactorganization.md
@@ -0,0 +1,153 @@
+---
+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.
+---
+
+ContactOrganization
+===================
+
+`Contact` オブジェクトの組織プロパティーを表します。
+
+プロパティー
+----------
+- __pref:__ `ContactOrganization` がユーザーの推奨値を含むかどうかを表します。含む場合、 `true` がセットされます _(boolean)_
+- __type:__ フィールドのタイプを表します (例: 'home') _(DOMString)_
+- __name:__ 組織名を表します _(DOMString)_
+- __department:__ 部署名を表します _(DOMString)_
+- __title:__ 役職名を表します _(DOMString)_
+
+詳細
+-------
+
+`ContactOrganization` オブジェクトは連絡先の組織情報を表します。 `Contact` オブジェクトは複数の `ContactOrganization` オブジェクトを配列に保持します。
+
+サポートされているプラットフォーム
+-------------------
+
+- Android
+- BlackBerry WebWorks (OS 5.0 以上)
+- iOS
+- Bada 1.2
+
+使用例
+-------------
+
+ function onSuccess(contacts) {
+ for (var i=0; i<contacts.length; i++) {
+ for (var j=0; j<contacts[i].organizations.length; j++) {
+ alert("推奨値: " + contacts[i].organizations[j].pref + "\n" +
+ "タイプ: " + contacts[i].organizations[j].type + "\n" +
+ "組織名: " + contacts[i].organizations[j].name + "\n" +
+ "部署名: " + contacts[i].organizations[j].department + "\n" +
+ "役職名: " + contacts[i].organizations[j].title);
+ }
+ }
+ };
+
+ function onError(contactError) {
+ alert('エラーが発生しました。');
+ };
+
+ var options = new ContactFindOptions();
+ options.filter="";
+ filter = ["displayName","organizations"];
+ navigator.contacts.find(filter, onSuccess, onError, options);
+
+詳細な使用例
+------------
+
+ <!DOCTYPE html>
+ <html>
+ <head>
+ <title>Contact の使用例</title>
+
+ <script type="text/javascript" charset="utf-8" src="cordova-1.8.1.js"></script>
+ <script type="text/javascript" charset="utf-8">
+
+ // Cordova の読み込み完了まで待機
+ //
+ document.addEventListener("deviceready", onDeviceReady, false);
+
+ // Cordova 準備完了
+ //
+ function onDeviceReady() {
+ var options = new ContactFindOptions();
+ options.filter="";
+ filter = ["displayName","organizations"];
+ navigator.contacts.find(filter, onSuccess, onError, options);
+ }
+
+ // onSuccess: 連絡先の取得に成功した場合
+ //
+ function onSuccess(contacts) {
+ for (var i=0; i<contacts.length; i++) {
+ for (var j=0; j<contacts[i].organizations.length; j++) {
+ alert("推奨値: " + contacts[i].organizations[j].pref + "\n" +
+ "タイプ: " + contacts[i].organizations[j].type + "\n" +
+ "組織名: " + contacts[i].organizations[j].name + "\n" +
+ "部署名: " + contacts[i].organizations[j].department + "\n" +
+ "役職名: " + contacts[i].organizations[j].title);
+ }
+ }
+ };
+
+ // onError: 連絡先の取得に失敗した場合
+ //
+ function onError(contactError) {
+ alert('エラーが発生しました。');
+ }
+
+ </script>
+ </head>
+ <body>
+ <h1>使用例</h1>
+ <p>連絡先の検索</p>
+ </body>
+ </html>
+
+
+Android 2.X に関する注意点
+------------------
+
+- __pref:__ このプロパティーは Android 2.X ではサポートされておらず、常に `false` を返します。
+
+Android 1.X に関する注意点
+------------------
+
+- __pref:__ このプロパティーは Android 1.X ではサポートされておらず、常に `false` を返します。
+- __type:__ このプロパティーは Android 1.X ではサポートされておらず、常に `null` を返します。
+- __title:__ このプロパティーは Android 1.X ではサポートされておらず、常に `null` を返します。
+
+BlackBerry WebWorks (OS 5.0 and higher) に関する注意点
+--------------------------------------------
+- __pref:__ このプロパティーは BlackBerry ではサポートされておらず、常に `false` を返します。
+- __type:__ このプロパティーは BlackBerry ではサポートされておらず、常に `null` を返します。
+- __name:__ 部分的にサポートされています。一つ目の組織名が BlackBerry の __company__ フィールドに保存されます。
+- __department:__ このプロパティーはサポートされておらず、常に `null` を返します。
+- __title:__ 部分的にサポートされています。一つ目の役職名が BlackBerry の __jobTitle__ フィールドに保存されます。
+
+iOS に関する注意点
+-----------
+- __pref:__ このプロパティーは iOS ではサポートされておらず、常に `false` を返します。
+- __type:__ このプロパティーは iOS ではサポートされておらず、常に `null` を返します。
+- __name:__ 部分的にサポートされています。一つ目の組織名が iOS の __kABPersonOrganizationProperty__ フィールドに保存されます。
+- __department__: 部分的にサポートされています。一つ目の部署名が iOS の __kABPersonDepartmentProperty__ フィールドに保存されます。
+- __title__: 部分的にサポートされています。一つ目の役職名が iOS の __kABPersonJobTitleProperty__ フィールドに保存されます。
+
+Bada 2.0 に関する注意点
+---------------
+- ContactOrganization はサポートされていません。
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/e7168dd7/docs/ja/1.8.1/cordova/contacts/contacts.create.md
----------------------------------------------------------------------
diff --git a/docs/ja/1.8.1/cordova/contacts/contacts.create.md b/docs/ja/1.8.1/cordova/contacts/contacts.create.md
new file mode 100644
index 0000000..11fd529
--- /dev/null
+++ b/docs/ja/1.8.1/cordova/contacts/contacts.create.md
@@ -0,0 +1,77 @@
+---
+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.
+---
+
+contacts.create
+===============
+
+新しい Contact オブジェクトを作成します。
+
+ var contact = navigator.contacts.create(properties);
+
+概要
+-----------
+
+contacts.create 関数は、新しい `Contact` オブジェクトを同期的に作成します。
+
+この関数で作成した Contact オブジェクトは、デバイスの連絡先データベースには残りません。 Contact オブジェクトをデバイスに保存するには、 `Contact.save` 関数を使用します。
+
+サポートされているプラットフォーム
+-------------------
+
+- Android
+- BlackBerry WebWorks (OS 5.0 以上)
+- iOS
+- Bada 1.2 & 2.0
+
+使用例
+-------------
+
+ var myContact = navigator.contacts.create({"displayName": "Test User"});
+
+詳細な使用例
+------------
+
+ <!DOCTYPE html>
+ <html>
+ <head>
+ <title>Contact の使用例</title>
+
+ <script type="text/javascript" charset="utf-8" src="cordova-1.8.1.js"></script>
+ <script type="text/javascript" charset="utf-8">
+
+ // Cordova の読み込み完了まで待機
+ //
+ document.addEventListener("deviceready", onDeviceReady, false);
+
+ // Cordova 準備完了
+ //
+ function onDeviceReady() {
+ var myContact = navigator.contacts.create({"displayName": "Test User"});
+ myContact.note = "この連絡先のメモ";
+ console.log("連絡先, " + myContact.displayName + ", メモ: " + myContact.note);
+ }
+
+
+ </script>
+ </head>
+ <body>
+ <h1>使用例</h1>
+ <p>連絡先を作成します</p>
+ </body>
+ </html>
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/e7168dd7/docs/ja/1.8.1/cordova/contacts/contacts.find.md
----------------------------------------------------------------------
diff --git a/docs/ja/1.8.1/cordova/contacts/contacts.find.md b/docs/ja/1.8.1/cordova/contacts/contacts.find.md
new file mode 100644
index 0000000..3ef9b11
--- /dev/null
+++ b/docs/ja/1.8.1/cordova/contacts/contacts.find.md
@@ -0,0 +1,116 @@
+---
+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.
+---
+
+contacts.find
+=============
+
+デバイスの連絡先データベースに問い合わせを行い、 `Contact` オブジェクトを取得します。
+
+ navigator.contacts.find(contactFields, contactSuccess, contactError, contactFindOptions);
+
+概要
+-----------
+
+contacts.find 関数は、デバイスの連絡先データベースに問い合わせを行い、 `Contact` オブジェクトの配列を返す非同期関数です。 作成されたオブジェクトは __contactSuccess__ に従って `contactSuccess` コールバック関数に送られます。
+
+このメソッドを使用する際は __contactFields__ パラメーターに検索フィールドを指定します。 __contactFields__ パラメーターに渡したフィールドだけが、 `Contact` オブジェクトのプロパティーとして __contactSuccess__ コールバック関数に渡されます。 __contactFields__ パラメーターが空の場合は、 `id` プロパティーのみを持つ `Contact` オブジェクト配列が作成されます。 __contactFields__ の値が["*"]の場合は、全ての連絡先フィールドが返されます。
+
+連絡先データベースの問い合わせの際には、 __contactFindOptions.filter__ を用いて検索条件を絞ることが出来ます。このオプションが指定されていた場合、大文字小文字の区別なく、部分一致方式により __contactFields__ パラメーターに指定されたフィールドの検索が行われます。いずれかのフィールドにマッチした内容があった場合、その連絡先情報が返されます。
+
+パラメーター
+----------
+
+- __contactFields:__ 検索条件に格納されるフィールドを指定します。このパラメーターに定義されたフィールドのみが `Contact` オブジェクトにセットされます。 _(DOMString[])_ [必須]
+- __contactSuccess:__ 連絡先データベースへの問い合わせに成功した場合に呼び出されるコールバック関数を指定します [必須]
+- __contactError:__ エラーコールバック関数を指定します。連絡先データベースへの問い合わせに失敗した場合に呼び出されます [任意]
+- __contactFindOptions:__ 連絡先情報に絞り込み検索を行うための検索オプションを指定します [任意]
+
+サポートされているプラットフォーム
+-------------------
+
+- Android
+- BlackBerry WebWorks (OS 5.0 以上)
+- iOS
+- Bada 1.2 & 2.0
+
+使用例
+-------------
+
+ function onSuccess(contacts) {
+ alert(contacts.length + ' 件の連絡先が見つかりました。');
+ };
+
+ function onError(contactError) {
+ alert('エラーが発生しました。');
+ };
+
+ // Bob という名前が含まれる全ての連絡先を取得
+ var options = new ContactFindOptions();
+ options.filter="Bob";
+ var fields = ["displayName", "name"];
+ navigator.contacts.find(fields, onSuccess, onError, options);
+
+詳細な使用例
+------------
+
+ <!DOCTYPE html>
+ <html>
+ <head>
+ <title>Contact の使用例</title>
+
+ <script type="text/javascript" charset="utf-8" src="cordova-1.8.1.js"></script>
+ <script type="text/javascript" charset="utf-8">
+
+ // Cordova の読み込み完了まで待機
+ //
+ document.addEventListener("deviceready", onDeviceReady, false);
+
+ // Cordova 準備完了
+ //
+ function onDeviceReady() {
+ // Bob という名前が含まれる全ての連絡先を取得
+ var options = new ContactFindOptions();
+ options.filter="Bob";
+ var fields = ["displayName", "name"];
+ navigator.contacts.find(fields, onSuccess, onError, options);
+ }
+
+ // onSuccess: 連絡先の取得に成功した場合
+ //
+ function onSuccess(contacts) {
+ for (var i=0; i<contacts.length; i++) {
+ console.log("表示名 = " + contacts[i].displayName);
+ }
+ }
+
+ // onError: 連絡先の取得に失敗した場合
+ //
+ function onError(contactError) {
+ alert('エラーが発生しました。');
+ }
+
+ </script>
+ </head>
+ <body>
+ <h1>使用例</h1>
+ <p>連絡先の検索</p>
+ </body>
+ </html>
+
+
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/e7168dd7/docs/ja/1.8.1/cordova/contacts/contacts.md
----------------------------------------------------------------------
diff --git a/docs/ja/1.8.1/cordova/contacts/contacts.md b/docs/ja/1.8.1/cordova/contacts/contacts.md
new file mode 100644
index 0000000..a7200e3
--- /dev/null
+++ b/docs/ja/1.8.1/cordova/contacts/contacts.md
@@ -0,0 +1,108 @@
+---
+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.
+---
+
+Contacts
+========
+
+> `contacts` オブジェクトを通じて、デバイスの連絡先データベースにアクセスできます。
+
+メソッド
+-------
+
+- contacts.create
+- contacts.find
+
+引数
+---------
+
+- contactFields
+- contactSuccess
+- contactError
+- contactFindOptions
+
+オブジェクト
+-------
+
+- Contact
+- ContactName
+- ContactField
+- ContactAddress
+- ContactOrganization
+- ContactFindOptions
+- ContactError
+
+パーミッション
+-----------
+
+### Android
+
+#### app/res/xml/plugins.xml
+
+ <plugin name="Contacts" value="org.apache.cordova.ContactManager" />
+
+#### app/AndroidManifest.xml
+
+ <uses-permission android:name="android.permission.GET_ACCOUNTS" />
+ <uses-permission android:name="android.permission.READ_CONTACTS" />
+ <uses-permission android:name="android.permission.WRITE_CONTACTS" />
+
+### Bada
+
+#### manifest.xml
+
+ <Privilege>
+ <Name>ADDRESSBOOK</Name>
+ </Privilege>
+
+### BlackBerry WebWorks
+
+#### www/plugins.xml
+
+ <plugin name="Contact" value="org.apache.cordova.pim.Contact" />
+
+#### www/config.xml
+
+ <feature id="blackberry.find" required="true" version="1.0.0.0" />
+ <feature id="blackberry.identity" required="true" version="1.0.0.0" />
+ <feature id="blackberry.pim.Address" required="true" version="1.0.0.0" />
+ <feature id="blackberry.pim.Contact" required="true" version="1.0.0.0" />
+
+### iOS
+
+#### App/Supporting Files/Cordova.plist
+
+ <key>Plugins</key>
+ <dict>
+ <key>Contacts</key>
+ <string>CDVContacts</string>
+ </dict>
+
+### webOS
+
+ パーミッションの設定は必要ありません。
+
+### Windows Phone
+
+#### Properties/WPAppManifest.xml
+
+ <Capabilities>
+ <Capability Name="ID_CAP_CONTACTS" />
+ </Capabilities>
+
+参照: [Application Manifest for Windows Phone](http://msdn.microsoft.com/en-us/library/ff769509%28v=vs.92%29.aspx)
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/e7168dd7/docs/ja/1.8.1/cordova/contacts/parameters/contactError.md
----------------------------------------------------------------------
diff --git a/docs/ja/1.8.1/cordova/contacts/parameters/contactError.md b/docs/ja/1.8.1/cordova/contacts/parameters/contactError.md
new file mode 100644
index 0000000..027c4d8
--- /dev/null
+++ b/docs/ja/1.8.1/cordova/contacts/parameters/contactError.md
@@ -0,0 +1,27 @@
+---
+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.
+---
+
+contactError
+============
+
+連絡先情報の取得に失敗したときに呼び出されるコールバック関数です。
+
+ function(error) {
+ // エラー処理
+ }
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/e7168dd7/docs/ja/1.8.1/cordova/contacts/parameters/contactFields.md
----------------------------------------------------------------------
diff --git a/docs/ja/1.8.1/cordova/contacts/parameters/contactFields.md b/docs/ja/1.8.1/cordova/contacts/parameters/contactFields.md
new file mode 100644
index 0000000..0139cc4
--- /dev/null
+++ b/docs/ja/1.8.1/cordova/contacts/parameters/contactFields.md
@@ -0,0 +1,25 @@
+---
+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.
+---
+
+contactFields
+=============
+
+`contacts.find` メソッドを使用する際の必須パラメーターです。このパラメーターを使って、検索操作によって得られる `Contact` オブジェクトが持つフィールドを指定します。
+
+ ["name", "phoneNumbers", "emails"]
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/e7168dd7/docs/ja/1.8.1/cordova/contacts/parameters/contactFindOptions.md
----------------------------------------------------------------------
diff --git a/docs/ja/1.8.1/cordova/contacts/parameters/contactFindOptions.md b/docs/ja/1.8.1/cordova/contacts/parameters/contactFindOptions.md
new file mode 100644
index 0000000..fc6313a
--- /dev/null
+++ b/docs/ja/1.8.1/cordova/contacts/parameters/contactFindOptions.md
@@ -0,0 +1,35 @@
+---
+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.
+---
+
+contactFindOptions
+==================
+
+`contacts.find` メソッドを使用する際のオプションのパラメーターです。連絡先の検索時にフィルターをかける場合に使用します。
+
+ {
+ filter: "",
+ multiple: true,
+ };
+
+オプション
+-------
+
+- __filter:__ 絞り込み検索用の文字列を指定します _(DOMString)_ (デフォルト: "")
+- __multiple:__ 検索時に複数の連絡先を返すかどうかを指定します _(Boolean)_ (デフォルト: false)
+
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/e7168dd7/docs/ja/1.8.1/cordova/contacts/parameters/contactSuccess.md
----------------------------------------------------------------------
diff --git a/docs/ja/1.8.1/cordova/contacts/parameters/contactSuccess.md b/docs/ja/1.8.1/cordova/contacts/parameters/contactSuccess.md
new file mode 100644
index 0000000..5cf05d9
--- /dev/null
+++ b/docs/ja/1.8.1/cordova/contacts/parameters/contactSuccess.md
@@ -0,0 +1,41 @@
+---
+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.
+---
+
+contactSuccess
+==============
+
+`contacts.find` メソッドの実行に成功した場合に呼び出される、 `Contact` 配列を提供するコールバック関数です。
+
+ function(contacts) {
+ // 任意のコード
+ }
+
+パラメーター
+----------
+
+- __contacts:__ 検索の結果の連絡先配列 (`Contact`)
+
+使用例
+-------
+
+ function contactSuccess(contacts) {
+ for (var i=0; i<contacts.length; i++) {
+ console.log("表示名 = " + contacts[i].displayName);
+ }
+ }
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/e7168dd7/docs/ja/1.8.1/cordova/device/device.cordova.md
----------------------------------------------------------------------
diff --git a/docs/ja/1.8.1/cordova/device/device.cordova.md b/docs/ja/1.8.1/cordova/device/device.cordova.md
new file mode 100644
index 0000000..a8603ee
--- /dev/null
+++ b/docs/ja/1.8.1/cordova/device/device.cordova.md
@@ -0,0 +1,79 @@
+---
+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.
+---
+
+device.cordova
+===============
+
+現在使用している Cordova のバージョン情報を表します。
+
+ var string = device.cordova;
+
+概要
+-----------
+
+`device.cordova` は現在実行中の Cordova のバージョン情報を取得します。
+
+サポートされているプラットフォーム
+-------------------
+
+- Android
+- BlackBerry WebWorks (OS 5.0 以上)
+- iPhone
+- Windows Phone 7 (Mango)
+- Bada 1.2 & 2.x
+
+使用例
+-------------
+
+ var name = device.cordova;
+
+詳細な使用例
+------------
+
+ <!DOCTYPE html>
+ <html>
+ <head>
+ <title>デバイスプロパティーの使用例</title>
+
+ <script type="text/javascript" charset="utf-8" src="cordova-1.8.1.js"></script>
+ <script type="text/javascript" charset="utf-8">
+
+ // Cordova の読み込み完了まで待機
+ //
+ document.addEventListener("deviceready", onDeviceReady, false);
+
+ // Cordova 準備完了
+ //
+ function onDeviceReady() {
+ var element = document.getElementById('deviceProperties');
+
+ element.innerHTML = 'デバイス名: ' + device.name + '<br />' +
+ 'デバイス Cordova: ' + device.cordova + '<br />' +
+ 'デバイスプラットフォーム: ' + device.platform + '<br />' +
+ 'デバイス UUID: ' + device.uuid + '<br />' +
+ 'デバイスバージョン: ' + device.version + '<br />';
+ }
+
+ </script>
+ </head>
+ <body>
+ <p id="deviceProperties">デバイスプロパティーを読込中...</p>
+ </body>
+ </html>
+
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/e7168dd7/docs/ja/1.8.1/cordova/device/device.md
----------------------------------------------------------------------
diff --git a/docs/ja/1.8.1/cordova/device/device.md b/docs/ja/1.8.1/cordova/device/device.md
new file mode 100644
index 0000000..9d9b04e
--- /dev/null
+++ b/docs/ja/1.8.1/cordova/device/device.md
@@ -0,0 +1,95 @@
+---
+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.
+---
+
+Device
+======
+
+> `device` オブジェクトはデバイスのハードウェアとソフトウェアの情報を表します。
+
+プロパティー
+----------
+
+- device.name
+- device.cordova
+- device.platform
+- device.uuid
+- device.version
+
+変数の範囲
+--------------
+
+`device` オブジェクトは `window` オブジェクトに割当たれるため、暗黙的にグローバルスコープとして扱われます。
+
+ // 下記は同じ `device` オブジェクト
+ var phoneName = window.device.name;
+ var phoneName = device.name;
+
+パーミッション
+-----------
+
+### Android
+
+#### app/res/xml/plugins.xml
+
+ <plugin name="Device" value="org.apache.cordova.Device" />
+
+#### app/AndroidManifest.xml
+
+ <uses-permission android:name="android.permission.READ_PHONE_STATE" />
+
+### Bada
+
+#### manifest.xml
+
+ <Privilege>
+ <Name>SYSTEM_SERVICE</Name>
+ </Privilege>
+
+### BlackBerry WebWorks
+
+#### www/plugins.xml
+
+ <plugin name="Device" value="org.apache.cordova.device.Device" />
+
+#### www/config.xml
+
+ <feature id="blackberry.app" required="true" version="1.0.0.0" />
+ <rim:permissions>
+ <rim:permit>read_device_identifying_information</rim:permit>
+ </rim:permissions>
+
+### iOS
+
+ パーミッションの設定は必要ありません。
+
+### webOS
+
+ パーミッションの設定は必要ありません。
+
+### Windows Phone
+
+#### Properties/WPAppManifest.xml
+
+ <Capabilities>
+ <Capability Name="ID_CAP_WEBBROWSERCOMPONENT" />
+ <Capability Name="ID_CAP_IDENTITY_DEVICE" />
+ <Capability Name="ID_CAP_IDENTITY_USER" />
+ </Capabilities>
+
+参照: [Application Manifest for Windows Phone](http://msdn.microsoft.com/en-us/library/ff769509%28v=vs.92%29.aspx)
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/e7168dd7/docs/ja/1.8.1/cordova/device/device.name.md
----------------------------------------------------------------------
diff --git a/docs/ja/1.8.1/cordova/device/device.name.md b/docs/ja/1.8.1/cordova/device/device.name.md
new file mode 100644
index 0000000..72961f0
--- /dev/null
+++ b/docs/ja/1.8.1/cordova/device/device.name.md
@@ -0,0 +1,108 @@
+---
+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.
+---
+
+device.name
+===========
+
+デバイスのモデル名を取得します。
+
+ var string = device.name;
+
+概要
+-----------
+
+`device.name` はデバイスのモデル名を返します。この値はデバイスの製造者によって設定されるため、同じモデルでも異なるバージョンで値が異なる場合があります。
+
+サポートされているプラットフォーム
+-------------------
+
+- Android
+- BlackBerry WebWorks (OS 5.0 以上)
+- iPhone
+- Windows Phone 7 (Mango)
+- Bada 1.2 & 2.x
+- webOS
+
+使用例
+-------------
+
+ // Android: Nexus One はコードネームである "Passion" を返します
+ // Motorola Droid は "voles" を返します
+ // BlackBerry: Torch 9800 は "9800" を返します
+ // iPhone: iTunes でセットした名前、 "Joe's iPhone" などを返します
+ //
+ var name = device.name;
+
+詳細な使用例
+------------
+
+ <!DOCTYPE html>
+ <html>
+ <head>
+ <title>デバイスプロパティーの使用例</title>
+
+ <script type="text/javascript" charset="utf-8" src="cordova-1.8.1.js"></script>
+ <script type="text/javascript" charset="utf-8">
+
+ // Cordova の読み込み完了まで待機
+ //
+ document.addEventListener("deviceready", onDeviceReady, false);
+
+ // Cordova 準備完了
+ //
+ function onDeviceReady() {
+ var element = document.getElementById('deviceProperties');
+
+ element.innerHTML = 'デバイス名: ' + device.name + '<br />' +
+ 'デバイス Cordova: ' + device.cordova + '<br />' +
+ 'デバイスプラットフォーム: ' + device.platform + '<br />' +
+ 'デバイス UUID: ' + device.uuid + '<br />' +
+ 'デバイスバージョン: ' + device.version + '<br />';
+ }
+
+ </script>
+ </head>
+ <body>
+ <p id="deviceProperties">デバイスプロパティーを読込中...</p>
+ </body>
+ </html>
+
+
+Android に関する注意点
+--------------
+
+- [モデル名](http://developer.android.com/reference/android/os/Build.html#MODEL) の代わりに [製品名](http://developer.android.com/reference/android/os/Build.html#PRODUCT) を取得します。
+ - 製品名はほとんどの場合、生産時のコードネームになります。
+ - 例: Nexus One は "Passion" を返し、 Motorola Droid は "voles" を返します。
+
+iPhoneに関する注意点
+-------------
+
+- [モデル名](http://developer.apple.com/iphone/library/documentation/uikit/reference/UIDevice_Class/Reference/UIDevice.html#//apple_ref/doc/uid/TP40006902-CH3-SW1) の代わりに [デバイスのカスタムネーム](http://developer.apple.com/iphone/library/documentation/uikit/reference/UIDevice_Class/Reference/UIDevice.html#//apple_ref/doc/uid/TP40006902-CH3-SW13) を取得します。
+ - カスタムネームは iTunes のオーナーによって設定されます。
+ - 例: "Joe's iPhone"
+
+Windows Phone 7 に関する注意点
+-------------
+
+- 製造時のデバイス名を返します。例: 'SGH-i917'
+
+Bada に関する注意点
+-----------
+- 製造時のモデル名を返します。 例: 'Samsung Wave S8500'
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/e7168dd7/docs/ja/1.8.1/cordova/device/device.platform.md
----------------------------------------------------------------------
diff --git a/docs/ja/1.8.1/cordova/device/device.platform.md b/docs/ja/1.8.1/cordova/device/device.platform.md
new file mode 100644
index 0000000..8bc4dba
--- /dev/null
+++ b/docs/ja/1.8.1/cordova/device/device.platform.md
@@ -0,0 +1,95 @@
+---
+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.
+---
+
+device.platform
+===============
+
+デバイスの OS 名を取得します。
+
+ var string = device.platform;
+
+サポートされているプラットフォーム
+-------------------
+
+- Android
+- BlackBerry WebWorks (OS 5.0 以上)
+- iPhone
+- Windows Phone 7 (Mango)
+- Bada 1.2 & 2.x
+- webOS
+
+使用例
+-------------
+
+ // デバイスによって異なります。例:
+ // - "Android"
+ // - "BlackBerry"
+ // - "iPhone"
+ // - "webOS"
+ // - "WinCE"
+ var devicePlatform = device.platform;
+
+詳細な使用例
+------------
+
+ <!DOCTYPE html>
+ <html>
+ <head>
+ <title>デバイスプロパティーの使用例</title>
+
+ <script type="text/javascript" charset="utf-8" src="cordova-1.8.1.js"></script>
+ <script type="text/javascript" charset="utf-8">
+
+ // Cordova の読み込み完了まで待機
+ //
+ document.addEventListener("deviceready", onDeviceReady, false);
+
+ // Cordova 準備完了
+ //
+ function onDeviceReady() {
+ var element = document.getElementById('deviceProperties');
+
+ element.innerHTML = 'デバイス名: ' + device.name + '<br />' +
+ 'デバイス Cordova: ' + device.cordova + '<br />' +
+ 'デバイスプラットフォーム: ' + device.platform + '<br />' +
+ 'デバイス UUID: ' + device.uuid + '<br />' +
+ 'デバイスバージョン: ' + device.version + '<br />';
+ }
+
+ </script>
+ </head>
+ <body>
+ <p id="deviceProperties">デバイスプロパティーを読込中...</p>
+ </body>
+ </html>
+
+iPhone に関する注意点
+-------------
+
+iPhone は `iPhone` をプラットフォームとして返します。 iPad は `iPad` をプラットフォームとして返します。シミュレータの場合は、 `iPhone Simulator` や `iPad Simulator` をそれぞれ返します。 Apple は iPhone の OS の名称を `iOS` に変更したので、この返り値は厳密には正確でないという点に注意してください。
+
+BlackBerry に関する注意点
+-----------------
+
+OS 名ではなくプラットフォームのバージョンを返す可能性があります。例えば、 Storm2 9550 の場合 '2.13.0.95' を返すことがあります。
+
+Windows Phone 7 に関する注意点
+-----------------
+
+Windows Phone 7 デバイスはプラットフォームとして 'WinCE' を返します。
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/e7168dd7/docs/ja/1.8.1/cordova/device/device.uuid.md
----------------------------------------------------------------------
diff --git a/docs/ja/1.8.1/cordova/device/device.uuid.md b/docs/ja/1.8.1/cordova/device/device.uuid.md
new file mode 100644
index 0000000..2011207
--- /dev/null
+++ b/docs/ja/1.8.1/cordova/device/device.uuid.md
@@ -0,0 +1,103 @@
+---
+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.
+---
+
+device.uuid
+===========
+
+デバイスの固定 ID ([UUID](http://en.wikipedia.org/wiki/Universally_Unique_Identifier)) を取得します。
+
+ var string = device.uuid;
+
+概要
+-----------
+
+UUID の生成方法については、デバイスの製造者やプラットフォームによって決定されます。
+
+サポートされているプラットフォーム
+-------------------
+
+- Android
+- BlackBerry WebWorks (OS 5.0 以上)
+- iPhone
+- Windows Phone 7 (Mango)
+- Bada 1.2 & 2.x
+- webOS
+
+使用例
+-------------
+
+ // Android: ランダムな64ビットの数値を文字列として返します
+ // 数値はデバイスの初回起動時に生成されます
+ //
+ // BlackBerry: デバイスの PIN 番号を文字列として返します
+ // この番号は9桁の一意な数値です
+ //
+ // iPhone: (UIDevice クラスのドキュメントに記載)
+ // ハードウエア ID に基づくハッシュ値を返します
+ // デバイスに固有でユーザーアカウントとは
+ // リンクされていません
+ // Windows Phone 7 : デバイスユーザーのハッシュ値を返します
+ // もしユーザーが定義されていない場合、ガイドが生成され、アプリがアンインストールするまで存続します
+ //
+ // webOS: デバイスの NDUID を返します
+ var deviceID = device.uuid;
+
+詳細な使用例
+------------
+
+ <!DOCTYPE html>
+ <html>
+ <head>
+ <title>デバイスプロパティーの使用例</title>
+
+ <script type="text/javascript" charset="utf-8" src="cordova-1.8.1.js"></script>
+ <script type="text/javascript" charset="utf-8">
+
+ // Cordova の読み込み完了まで待機
+ //
+ document.addEventListener("deviceready", onDeviceReady, false);
+
+ // Cordova 準備完了
+ //
+ function onDeviceReady() {
+ var element = document.getElementById('deviceProperties');
+
+ element.innerHTML = 'デバイス名: ' + device.name + '<br />' +
+ 'デバイス Cordova: ' + device.cordova + '<br />' +
+ 'デバイスプラットフォーム: ' + device.platform + '<br />' +
+ 'デバイス UUID: ' + device.uuid + '<br />' +
+ 'デバイスバージョン: ' + device.version + '<br />';
+ }
+
+ </script>
+ </head>
+ <body>
+ <p id="deviceProperties">デバイスプロパティーを読込中...</p>
+ </body>
+ </html>
+
+iOS に関する注意点
+-------------
+
+iOS の UUID はデバイスによって一意ではありませんが、インストールされたアプリごとに一意です。もしアプリを削除し再インストールすると、この値は変化します。また、 iOS のバージョンアップをしたとき、もしくはアプリのバージョンアップをしたときにも変化する可能性があります (iOS 5.1 で現象を確認) 。安定した値ではありません。
+
+Windows Phone 7 に関する注意点
+-------------
+
+Windows Phone 7 の UUID には IDCAPIDENTITY_DEVICE の許可が必要です。 Microsoft はこのプロパティーを近い将来サポートしなくなります。もし機能が有効でなければ、アプリが永続的な guid を生成し、インストールされている限り保持されます。
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/e7168dd7/docs/ja/1.8.1/cordova/device/device.version.md
----------------------------------------------------------------------
diff --git a/docs/ja/1.8.1/cordova/device/device.version.md b/docs/ja/1.8.1/cordova/device/device.version.md
new file mode 100644
index 0000000..61aee84
--- /dev/null
+++ b/docs/ja/1.8.1/cordova/device/device.version.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.
+---
+
+device.version
+==============
+
+OS のバージョンを取得します。
+
+ var string = device.version;
+
+サポートされているプラットフォーム
+-------------------
+
+- Android 2.1+
+- BlackBerry WebWorks (OS 5.0 以上)
+- iPhone
+- Windows Phone 7 (Mango)
+- Bada 1.2 & 2.x
+- webOS
+
+使用例
+-------------
+
+ // Android: Froyo の場合は "2.2" を返す
+ // Eclair の場合は "2.1", "2.0.1" もしくは "2.0" を返す
+ // アップデートが行われると "2.1-update1" のように返す
+ //
+ // BlackBerry: OS 6.0 を搭載した Torch 9800 の場合は "6.0.0.600" を返す
+ //
+ // iPhone: iOS 3.2 は "3.2" を返す
+ //
+ // Windows Phone 7: 現在の OS バージョンを返す、例: Mango は7.10.7720を返す
+ // webOS: webOS 2.2.4 は 2.2.4 を返す
+ var deviceVersion = device.version;
+
+詳細な使用例
+------------
+
+ <!DOCTYPE html>
+ <html>
+ <head>
+ <title>デバイスプロパティーの使用例</title>
+
+ <script type="text/javascript" charset="utf-8" src="cordova-1.8.1.js"></script>
+ <script type="text/javascript" charset="utf-8">
+
+ // Cordova の読み込み完了まで待機
+ //
+ document.addEventListener("deviceready", onDeviceReady, false);
+
+ // Cordova 準備完了
+ //
+ function onDeviceReady() {
+ var element = document.getElementById('deviceProperties');
+
+ element.innerHTML = 'デバイス名: ' + device.name + '<br />' +
+ 'デバイス Cordova: ' + device.cordova + '<br />' +
+ 'デバイスプラットフォーム: ' + device.platform + '<br />' +
+ 'デバイス UUID: ' + device.uuid + '<br />' +
+ 'デバイスバージョン: ' + device.version + '<br />';
+ }
+
+ </script>
+ </head>
+ <body>
+ <p id="deviceProperties">デバイスプロパティーを読込中...</p>
+ </body>
+ </html>
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/e7168dd7/docs/ja/1.8.1/cordova/events/events.backbutton.md
----------------------------------------------------------------------
diff --git a/docs/ja/1.8.1/cordova/events/events.backbutton.md b/docs/ja/1.8.1/cordova/events/events.backbutton.md
new file mode 100644
index 0000000..4f16ef0
--- /dev/null
+++ b/docs/ja/1.8.1/cordova/events/events.backbutton.md
@@ -0,0 +1,87 @@
+---
+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.
+---
+
+backbutton
+===========
+
+このイベントはユーザーが戻るボタンを押したときに呼び出されます。
+
+ document.addEventListener("backbutton", yourCallbackFunction, false);
+
+詳細
+-------
+
+もしデフォルトの戻るボタンの挙動を上書きしたい場合は、 'backbutton' イベントにイベントリスナーを登録することができます。戻るボタンの挙動を上書きするために、他のメソッドを呼び出す必要はありません。ただ 'backbutton' イベントリスナーを登録するだけで大丈夫です。
+
+通常は、 Cordova の 'deviceready' イベントを受け取った後、 `document.addEventListener` を通じてイベントリスナーをセットします。
+
+サポートされているプラットフォーム
+-------------------
+
+- Android
+- BlackBerry WebWorks (OS 5.0 以上)
+- Windows Phone 7 (Mango)
+
+使用例
+-------------
+
+ document.addEventListener("backbutton", onBackKeyDown, false);
+
+ function onBackKeyDown() {
+ // メニューボタン関する操作を記述
+ }
+
+詳細な使用例
+------------
+
+ <!DOCTYPE html>
+ <html>
+ <head>
+ <title>Cordova Back Button 使用例</title>
+
+ <script type="text/javascript" charset="utf-8" src="cordova-1.8.1.js"></script>
+ <script type="text/javascript" charset="utf-8">
+
+ // Cordovaのロード完了とともに onDeviceReady を呼び出します。
+ //
+ // この時点では、ドキュメントの読み込みは完了していますが、 cordova-1.8.1.js はまだ完了していません。
+ // Cordova のロード完了とともに
+ // `deviceready` イベントが呼び出されます。
+ //
+ function onLoad() {
+ document.addEventListener("deviceready", onDeviceReady, false);
+ }
+
+ // Cordova 準備完了
+ //
+ function onDeviceReady() {
+ // イベントリスナーを登録
+ document.addEventListener("backbutton", onBackKeyDown, false);
+ }
+
+ // メニューボタン関する操作を記述
+ //
+ function onBackKeyDown() {
+ }
+
+ </script>
+ </head>
+ <body onload="onLoad()">
+ </body>
+ </html>
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/e7168dd7/docs/ja/1.8.1/cordova/events/events.batterycritical.md
----------------------------------------------------------------------
diff --git a/docs/ja/1.8.1/cordova/events/events.batterycritical.md b/docs/ja/1.8.1/cordova/events/events.batterycritical.md
new file mode 100644
index 0000000..26cf6bf
--- /dev/null
+++ b/docs/ja/1.8.1/cordova/events/events.batterycritical.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.
+---
+
+batterycritical
+===========
+
+このイベントはバッテリー残量が危険な閾値に達したことを Cordova アプリケーションが検知したときに呼び出されます。
+
+ window.addEventListener("batterycritical", yourCallbackFunction, false);
+
+詳細
+-------
+
+このイベントはバッテリー残量が危険なパーセンテージの閾値に達したことを Cordova アプリケーションが検知したときに呼び出されます。この値はデバイス固有です。
+
+batterycritical ハンドラーは以下の2つのプロパティーを含むオブジェクトを伴って呼び出されます:
+
+- __level:__ バッテリーのパーセンテージ (0-100) _(Number)_
+- __isPlugged:__ デバイスが充電器に接続されているかどうかを表します _(Boolean)_
+
+通常は、 Cordova の 'deviceready' イベントを受け取った後、 `window.addEventListener` を通じてイベントリスナーをセットします。
+
+サポートされているプラットフォーム
+-------------------
+
+- iOS
+- Android
+- BlackBerry WebWorks (OS 5.0 以上)
+
+使用例
+-------------
+
+ window.addEventListener("batterycritical", onBatteryCritical, false);
+
+ function onBatteryCritical(info) {
+ // バッテリー関する操作を記述
+ alert("バッテリー残量が危険です " + info.level + "%\nすぐに充電してください。");
+ }
+
+詳細な使用例
+------------
+
+ <!DOCTYPE html>
+ <html>
+ <head>
+ <title>Cordova Device Ready 使用例</title>
+
+ <script type="text/javascript" charset="utf-8" src="cordova-1.8.1.js"></script>
+ <script type="text/javascript" charset="utf-8">
+
+ // Cordova のロード完了とともに onDeviceReady を呼び出します。
+ //
+ // この時点では、ドキュメントの読み込みは完了していますが、 cordova-1.8.1.js はまだ完了していません。
+ // Cordova のロード完了とともに
+ // `deviceready` イベントが呼び出されます。
+ //
+ function onLoad() {
+ document.addEventListener("deviceready", onDeviceReady, false);
+ }
+
+ // Cordova 準備完了
+ //
+ function onDeviceReady() {
+ window.addEventListener("batterycritical", onBatteryCritical, false);
+ }
+
+ // バッテリー関する操作を記述
+ //
+ function onBatteryCritical(info) {
+ alert("バッテリー残量が危険です " + info.level + "%\nすぐに充電してください。");
+ }
+
+ </script>
+ </head>
+ <body onload="onLoad()">
+ </body>
+ </html>
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/e7168dd7/docs/ja/1.8.1/cordova/events/events.batterylow.md
----------------------------------------------------------------------
diff --git a/docs/ja/1.8.1/cordova/events/events.batterylow.md b/docs/ja/1.8.1/cordova/events/events.batterylow.md
new file mode 100644
index 0000000..153fa48
--- /dev/null
+++ b/docs/ja/1.8.1/cordova/events/events.batterylow.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.
+---
+
+batterylow
+===========
+
+このイベントはバッテリー残量が低下したことを Cordova アプリケーションが検知したときに呼び出されます。
+
+ window.addEventListener("batterylow", yourCallbackFunction, false);
+
+詳細
+-------
+
+このイベントはバッテリー残量のパーセンテージが低下の閾値に達したことを Cordova アプリケーションが検知したときに呼び出されます。この値はデバイス固有です。
+
+batterylow ハンドラーは以下の2つのプロパティーを含むオブジェクトを伴って呼び出されます:
+
+- __level:__ バッテリーのパーセンテージ (0-100) _(Number)_
+- __isPlugged:__ デバイスが充電器に接続されているかどうかを表します _(Boolean)_
+
+通常は、 Cordova の 'deviceready' イベントを受け取った後、 `document.addEventListener` を通じてイベントリスナーをセットします。
+
+サポートされているプラットフォーム
+-------------------
+
+- iOS
+- Android
+- BlackBerry WebWorks (OS 5.0 以上)
+
+使用例
+-------------
+
+ window.addEventListener("batterylow", onBatteryLow, false);
+
+ function onBatteryLow(info) {
+ // バッテリー関する操作を記述
+ alert("バッテリー残量が低下しています " + info.level + "%");
+ }
+
+詳細な使用例
+------------
+
+ <!DOCTYPE html>
+ <html>
+ <head>
+ <title>Cordova Device Ready 使用例</title>
+
+ <script type="text/javascript" charset="utf-8" src="cordova-1.8.1.js"></script>
+ <script type="text/javascript" charset="utf-8">
+
+ // Cordova のロード完了とともに onDeviceReady を呼び出します。
+ //
+ // この時点では、ドキュメントの読み込みは完了していますが、 cordova-1.8.1.js はまだ完了していません。
+ // Cordova のロード完了とともに
+ // `deviceready` イベントが呼び出されます。
+ //
+ function onLoad() {
+ document.addEventListener("deviceready", onDeviceReady, false);
+ }
+
+ // Cordova 準備完了
+ //
+ function onDeviceReady() {
+ window.addEventListener("batterylow", onBatteryLow, false);
+ }
+
+ // バッテリー関する操作を記述
+ //
+ function onBatteryLow(info) {
+ alert("バッテリー残量が低下しています " + info.level + "%");
+ }
+
+ </script>
+ </head>
+ <body onload="onLoad()">
+ </body>
+ </html>
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/e7168dd7/docs/ja/1.8.1/cordova/events/events.batterystatus.md
----------------------------------------------------------------------
diff --git a/docs/ja/1.8.1/cordova/events/events.batterystatus.md b/docs/ja/1.8.1/cordova/events/events.batterystatus.md
new file mode 100644
index 0000000..27735ca
--- /dev/null
+++ b/docs/ja/1.8.1/cordova/events/events.batterystatus.md
@@ -0,0 +1,101 @@
+---
+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.
+---
+
+batterystatus
+===========
+
+このイベントはバッテリーのステータスが変化したことを Cordova アプリケーションが検知したときに呼び出されます。
+
+ window.addEventListener("batterystatus", yourCallbackFunction, false);
+
+詳細
+-------
+
+このイベントはバッテリー残量のパーセンテージが1パーセントでも変化したことを Cordova アプリケーションが検知したときに呼び出されます。 また、デバイスが充電器に接続されたとき、接続が解除されたときも呼び出されます。
+
+battery status ハンドラーは以下の2つのプロパティーを含むオブジェクトを伴って呼び出されます:
+
+- __level:__ バッテリーのパーセンテージ (0-100) _(Number)_
+- __isPlugged:__ デバイスが充電器に接続されているかどうかを表します _(Boolean)_
+
+通常は、 Cordova の 'deviceready' イベントを受け取った後、 `window.addEventListener` を通じてイベントリスナーをセットします。
+
+サポートされているプラットフォーム
+-------------------
+
+- iOS
+- Android
+- BlackBerry WebWorks (OS 5.0 以上)
+- Windows Phone 7 (Mango)
+
+
+Windows Phone 7 に関する注意点
+----------------------
+
+Windows Phone 7 はバッテリー残量を取得するネイティブの API を提供していないため、
+level プロパティーは利用できません。 `isPlugged` パラメーターはサポートされています。
+
+使用例
+-------------
+
+ window.addEventListener("batterystatus", onBatteryStatus, false);
+
+ function onBatteryStatus(info) {
+ // バッテリーに関する操作を記述
+ console.log("残量: " + info.level + " 充電器に接続: " + info.isPlugged);
+ }
+
+詳細な使用例
+------------
+
+ <!DOCTYPE html>
+ <html>
+ <head>
+ <title>Cordova Device Ready 使用例</title>
+
+ <script type="text/javascript" charset="utf-8" src="cordova-1.8.1.js"></script>
+ <script type="text/javascript" charset="utf-8">
+
+ // Cordova のロード完了とともに onDeviceReady を呼び出します。
+ //
+ // この時点では、ドキュメントの読み込みは完了していますが、 cordova-1.8.1.js はまだ完了していません。
+ // Cordova のロード完了とともに
+ // `deviceready` イベントが呼び出されます。
+ //
+ function onLoad() {
+ document.addEventListener("deviceready", onDeviceReady, false);
+ }
+
+ // Cordova 準備完了
+ //
+ function onDeviceReady() {
+ window.addEventListener("batterystatus", onBatteryStatus, false);
+ }
+
+ // バッテリーに関する操作を記述
+ //
+ function onBatteryStatus(info) {
+ console.log("残量: " + info.level + " 充電器に接続: " + info.isPlugged);
+ }
+
+ </script>
+ </head>
+ <body onload="onLoad()">
+ </body>
+ </html>
http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/e7168dd7/docs/ja/1.8.1/cordova/events/events.deviceready.md
----------------------------------------------------------------------
diff --git a/docs/ja/1.8.1/cordova/events/events.deviceready.md b/docs/ja/1.8.1/cordova/events/events.deviceready.md
new file mode 100644
index 0000000..8e6b2b4
--- /dev/null
+++ b/docs/ja/1.8.1/cordova/events/events.deviceready.md
@@ -0,0 +1,87 @@
+---
+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.
+---
+
+deviceready
+===========
+
+このイベントは Cordova が完全にロードされたときに呼び出されます。
+
+ document.addEventListener("deviceready", yourCallbackFunction, false);
+
+詳細
+-------
+
+このイベントはすべての Cordova アプリケーションで使用される重要なイベントです。
+
+Cordova はネイティブと JavaScript の2つのコードで形成されます。ネイティブコードがロードされている間は、カスタムのロード画面が表示されます。しかし、 JavaScript は DOM が読み込まれるまではロードされません。そのため、 Cordova の JavaScript 関数群がロードされる前に、それらの関数が呼ばれる可能性があります。
+
+Cordova の `deviceready` イベントは、 Cordova が完全にロードした後で呼び出されます。安全に Cordova 関数を呼び出すためには、デバイスが完全に呼び出されたことを確認してください。
+
+通常は、 HTML の DOM が読み込まれた後、 `document.addEventListener` を通じてイベントリスナーをセットします。
+
+サポートされているプラットフォーム
+-------------------
+
+- Android
+- BlackBerry WebWorks (OS 5.0 以上)
+- iOS
+- Windows Phone 7
+- Bada 1.2 & 2.x
+
+使用例
+-------------
+
+ document.addEventListener("deviceready", onDeviceReady, false);
+
+ function onDeviceReady() {
+ // Cordova API を安全に使用できます
+ }
+
+詳細な使用例
+------------
+
+ <!DOCTYPE html>
+ <html>
+ <head>
+ <title>Cordova Device Ready 使用例</title>
+
+ <script type="text/javascript" charset="utf-8" src="cordova-1.8.1.js"></script>
+ <script type="text/javascript" charset="utf-8">
+
+ // Cordova のロード完了とともに onDeviceReady を呼び出します。
+ //
+ // この時点では、ドキュメントの読み込みは完了していますが、 cordova-1.8.1.js はまだ完了していません。
+ // Cordova のロード完了とともに
+ // `deviceready` イベントが呼び出されます。
+ //
+ function onLoad() {
+ document.addEventListener("deviceready", onDeviceReady, false);
+ }
+
+ // Cordova 準備完了
+ //
+ function onDeviceReady() {
+ // Cordova API を安全に使用できます
+ }
+
+ </script>
+ </head>
+ <body onload="onLoad()">
+ </body>
+ </html>