contacts.create

新しい Contact オブジェクトを作成します。

var contact = navigator.contacts.create(properties);

概要

contacts.create 関数は、新しい [Contact](Contact/contact.html) オブジェクトを同期的に作成します。

この関数で作成した Contact オブジェクトは、デバイスの連絡先データベースには残りません。 Contact オブジェクトをデバイスに保存するには、 [Contact](Contact/contact.html).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-2.1.0.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>