PhoneGap 連絡人

最新推荐文章于 2021-05-26 17:47:23 发布
最新推荐文章于 2021-05-26 17:47:23 发布
阅读量1.5k 收藏
点赞数
分类专栏： PhoneGap 文章标签： PhoneGap

連絡人

contacts物件提供對設備的連絡人資料庫的訪問。

重要的隱私注：連絡人資料的收集和使用提出了重要的隱私問題。 您的應用程式的隱私權原則應該討論如何應用程式使用的連絡人資料和它是否被共用與任何其他方。 聯繫資訊被視為敏感，因為它揭示了人與人通信的人們。 因此，除了您的應用程式的隱私權原則，您應強烈考慮提供在您的應用程式訪問或使用連絡人資料 （如果設備作業系統不會這樣做已經） 之前的時間只是通知。 該通知應提供相同的資訊上文指出的並獲取該使用者的許可權 （例如，通過為確定並不感謝提出的選擇）。 請注意有些應用程式市場可能需要您的應用程式提供只是時間的通知，並從訪問連絡人資料之前使用者獲得的許可權。 周圍的連絡人資料將有助於避免使用者混淆使用感知的和濫用的連絡人資料的清晰和易於理解的使用者體驗。 有關詳細資訊，請參閱隱私指南。

方法

參數

物件

訪問功能

從 3.0 版，科爾多瓦作為外掛程式實現了設備級 Api。 使用 CLI 的 plugin 命令，描述在命令列介面，可以添加或刪除一個專案，為此功能：

    $ cordova plugin add org.apache.cordova.contacts
    $ cordova plugin ls
    [ 'org.apache.cordova.contacts' ]
    $ cordova plugin rm org.apache.cordova.contacts

這些命令適用于所有有針對性的平臺，但修改如下所述的特定于平臺的配置設置：

  • Android 系統

    (in app/res/xml/config.xml)
<feature name="Contacts">
    <param name="android-package" value="org.apache.cordova.ContactManager" />
</feature>


(in 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" />

  • 黑莓手機 WebWorks

    (in www/plugins.xml)
<feature name="Contact">
    <param name="blackberry-package" value="org.apache.cordova.pim.Contact" />
</feature>


(in 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" />

  • （在 iOSconfig.xml)

    <feature name="Contacts">
    <param name="ios-package" value="CDVContacts" />
</feature>

  • Windows Phone

    (in Properties/WPAppManifest.xml)
<Capabilities>
    <Capability Name="ID_CAP_CONTACTS" />
</Capabilities>

    引用：為 Windows Phone 應用程式清單

一些平臺可能支援此功能，而無需任何特殊的配置。請參見在概述部分中的平臺支援。

contacts.create

返回一個新的連絡人物件。

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

說明

contacts.create方法是同步的並返回一個新的 Contact 物件。

此方法不會保留連絡人物件在設備的連絡人資料庫中，您需要為其調用 Contact.save 方法。

支援的平臺

  • Android 系統
  • 黑莓手機 WebWorks （OS 5.0 和更高）
  • iOS
  • Windows Phone 7 和 8

快速的示例

var myContact = navigator.contacts.create({"displayName": "Test User"});

完整的示例

<!DOCTYPE html>
<html>
  <head>
    <title>Contact 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 myContact = navigator.contacts.create({"displayName": "Test User"});
        myContact.note = "This contact has a note.";
        console.log("The contact, " + myContact.displayName + ", note: " + myContact.note);
    }

    </script>
  </head>
  <body>
    <h1>Example</h1>
    <p>Create Contact</p>
  </body>
</html>

contacts.find

查詢設備連絡人資料庫，並返回一個或多個 Contact 物件，每個包含指定的欄位。

navigator.contacts.find(contactFields, contactSuccess, contactError, contactFindOptions);

說明

contacts.find方法以非同步方式，執行設備的連絡人資料庫查詢並返回一個陣列的 Contact 物件。 所得到的物件傳遞給 contactSuccess contactSuccess參數所指定的回呼函數。

ContactFields參數指定要搜索的限定詞，作為使用的欄位，只有那些結果傳遞給contactSuccess回呼函數。 零長度contactFields參數是不正確結果在 ContactError.INVALID_ARGUMENT_ERROR 。 ContactFields值為 "*" 返回所有連絡人欄位。

ContactFindOptions.filter字串查詢連絡人資料庫時，可以用作搜索篩選器。 如果提供，不區分大小寫，部分值匹配應用於在contactFields參數中指定的每個欄位。 如果有任何指定的欄位的匹配，則返回該連絡人。

參數

支援的平臺

  • Android 系統
  • 黑莓手機 WebWorks （OS 5.0 和更高）
  • iOS
  • Windows Phone 7 和 8
  • Windows 8

快速的示例

function onSuccess(contacts) {
    alert('Found ' + contacts.length + ' contacts.');
};

function onError(contactError) {
    alert('onError!');
};

// find all contacts with 'Bob' in any name field
var options      = new ContactFindOptions();
options.filter   = "Bob";
options.multiple = true;
var fields       = ["displayName", "name"];
navigator.contacts.find(fields, onSuccess, onError, options);

完整的示例

<!DOCTYPE html>
<html>
    <head>
        <title>Contact 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() {
                // find all contacts with 'Bob' in any name field
                var options = new ContactFindOptions();
                options.filter = "Bob";
                var fields = ["displayName", "name"];
                navigator.contacts.find(fields, onSuccess, onError, options);
            }

            // onSuccess: Get a snapshot of the current contacts

            function onSuccess(contacts) {
                for (var i = 0; i < contacts.length; i++) {
                    console.log("Display Name = " + contacts[i].displayName);
                }
            }

            // onError: Failed to get the contacts

            function onError(contactError) {
                alert('onError!');
            }
        </script>
    </head>

    <body>
        <h1>Example</h1>
        <p>Find Contacts</p>
    </body>
</html>

連絡人

包含描述聯繫，如使用者的個人或業務連絡人的屬性。

屬性

方法

  • 克隆： 返回一個新的 Contact 物件就是調用物件的深層副本 id 屬性設置為null.

  • 刪除： 從設備的連絡人資料庫中刪除連絡人，否則執行錯誤回檔與 ContactError 物件。

  • 保存： 將一個新的連絡人保存到設備的連絡人資料庫中，或更新現有的連絡人 （如果已存在具有相同id的連絡人。

詳細資訊

Contact物件表示使用者的連絡人。 可以創建、 存儲，或從設備的連絡人資料庫中刪除的連絡人。 連絡人可以還 (單獨或批量） 從資料庫中檢索通過調用 contacts.find 方法。

注：不是所有的上面列出的連絡人欄位平臺支援的每個設備。請檢查每個平臺的怪癖節瞭解詳細資訊。

支援的平臺

  • Android 系統
  • 黑莓手機 WebWorks （OS 5.0 和更高）
  • iOS
  • Windows Phone 7 和 8
  • Windows 8

保存快速示例

function onSuccess(contact) {
    alert("Save Success");
};

function onError(contactError) {
    alert("Error = " + contactError.code);
};

// create a new contact object
var contact = navigator.contacts.create();
contact.displayName = "Plumber";
contact.nickname = "Plumber";            // specify both to support all devices

// populate some fields
var name = new ContactName();
name.givenName = "Jane";
name.familyName = "Doe";
contact.name = name;

// save to device
contact.save(onSuccess,onError);

克隆快速示例

    // clone the contact object
    var clone = contact.clone();
    clone.name.givenName = "John";
    console.log("Original contact name = " + contact.name.givenName);
    console.log("Cloned contact name = " + clone.name.givenName);

刪除快速示例

function onSuccess() {
    alert("Removal Success");
};

function onError(contactError) {
    alert("Error = " + contactError.code);
};

    // remove the contact from the device
    contact.remove(onSuccess,onError);

完整的示例

<!DOCTYPE html>
<html>
  <head>
    <title>Contact 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() {
        // create
        var contact = navigator.contacts.create();
        contact.displayName = "Plumber";
        contact.nickname = "Plumber";                 // specify both to support all devices
        var name = new ContactName();
        name.givenName = "Jane";
        name.familyName = "Doe";
        contact.name = name;

        // save
        contact.save(onSaveSuccess,onSaveError);

        // clone
        var clone = contact.clone();
        clone.name.givenName = "John";
        console.log("Original contact name = " + contact.name.givenName);
        console.log("Cloned contact name = " + clone.name.givenName);

        // remove
        contact.remove(onRemoveSuccess,onRemoveError);
    }

    // onSaveSuccess: Get a snapshot of the current contacts
    //
    function onSaveSuccess(contact) {
        alert("Save Success");
    }

    // onSaveError: Failed to get the contacts
    //
    function onSaveError(contactError) {
        alert("Error = " + contactError.code);
    }

    // onRemoveSuccess: Get a snapshot of the current contacts
    //
    function onRemoveSuccess(contacts) {
        alert("Removal Success");
    }

    // onRemoveError: Failed to get the contacts
    //
    function onRemoveError(contactError) {
        alert("Error = " + contactError.code);
    }

    </script>
  </head>
  <body>
    <h1>Example</h1>
    <p>Find Contacts</p>
  </body>
</html>

Android 2.X 的怪癖

  • 類別： 不支援 Android 2.X 設備上，返回null.

黑莓手機 WebWorks （OS 5.0 和更高） 的怪癖

  • id： 支援。由該設備分配時保存該連絡人。

  • 顯示名稱： 支援。黑莓user1欄位中存儲。

  • 昵稱: 不受支援，返回null.

  • 手機： 部分支援。 電話號碼存儲在黑莓的欄位homePhone1和homePhone2中，如果類型是 '回家'， workPhone1和workPhone2如果類型是 '工作'，手機如果類型為行動電話， faxPhone ，如果類型是傳真， pagerPhone ，如果類型是 '呼叫器' 和otherPhone如果類型是以上都不是。

  • 電子郵件： 部分支援。 第三個電子郵件地址分別存儲在黑莓電子郵件 1，電子郵件 2、電子郵件 3欄位。

  • 位址： 部分支援。第一和第二個位址分別存儲在黑莓家庭位址和workAddress欄位中。

  • ims: 不受支援，返回null.

  • 組織： 部分支援。 名稱和標題的第一個組織存儲在黑莓公司和標題欄位中，分別。

  • 照片： 部分支援。 支援單一的縮略圖大小的照片。 若要設置連絡人的照片，通過在任一 base64 編碼的圖像或指向圖像的 URL。 圖像保存到黑莓手機的連絡人資料庫前按比例縮小。 連絡人照片返回 base64 編碼的圖像。

  • 類別： 部分支援。支援的只有商業和個人的類別。

  • url： 部分支援。第一個 URL 存儲在黑莓手機網頁欄位中。

iOS 的怪癖

  • 顯示名稱： 上返回的 iOS 不支援 null 除非有沒有 ContactName 指定，在這種情況下它將返回複合名稱，綽號或 "" ，分別。

  • 生日： 必須輸入 JavaScript 作為 Date 物件，它將返回相同的方式。

  • 照片： 返回到圖像，存儲在應用程式的臨時目錄中的檔的 URL。當應用程式退出時刪除臨時目錄的內容。

  • 類別： 這目前不支援屬性，返回null.

Windows Phone 7 和 8 怪癖

  • 顯示名稱： 當創建一個連絡人，提供的顯示名稱參數不同于顯示名稱的值檢索查找連絡人時。

  • url： 當創建一個連絡人，使用者可以輸入和保存多個 web 位址，但只有一個是可用時，可以使用搜索連絡人。

  • 手機： 不支援參照選項。 在查找操作中不是支援的類型。 只有一個 phoneNumber 允許為每個類型.

  • 電子郵件：參照選項不受支援。家庭和個人使用引用同一電子郵件項。只有一項被允許為每個類型.

  • 位址： 僅支援工作和家庭/個人類型。家庭和個人類型引用相同的位址條目。只有一項被允許為每個類型.

  • 組織： 唯一一個允許的並且不支援的治安、類型和新聞部的屬性。

  • 注意： 不支援返回null.

  • ims: 不受支援，返回null.

  • 生日: 不受支援，返回null.

  • 類別: 不受支援，返回null.

ContactAddress

包含位址屬性的 Contact 物件。

屬性

  • 上一頁: 設置為 true 如果此 ContactAddress 包含使用者的首選的值。（布林）

  • 類型： 一個字串，例如指示哪種類型的欄位這是回家。() DOMString

  • 格式： 顯示格式的完整位址。() DOMString

  • streetAddress： 完整的街道位址。() DOMString

  • 地點： 城市或地點。() DOMString

  • 區域： 國家或地區。() DOMString

  • 郵遞區號： 郵遞區號或郵政代碼。() DOMString

  • 國家： 國家名稱。() DOMString

詳細資訊

ContactAddress物件存儲的單一位址的連絡人的屬性。 A Contact 物件可能包括多個位址在 ContactAddress[] 陣列。

支援的平臺

  • Android 系統
  • 黑莓手機 WebWorks （OS 5.0 和更高）
  • iOS
  • Windows Phone 7 和 8
  • Windows 8

快速的示例

// display the address information for all contacts

function onSuccess(contacts) {
    for (var i = 0; i < contacts.length; i++) {
        for (var j = 0; j < contacts[i].addresses.length; j++) {
            alert("Pref: "         + contacts[i].addresses[j].pref          + "\n" +
                "Type: "           + contacts[i].addresses[j].type          + "\n" +
                "Formatted: "      + contacts[i].addresses[j].formatted     + "\n" +
                "Street Address: " + contacts[i].addresses[j].streetAddress + "\n" +
                "Locality: "       + contacts[i].addresses[j].locality      + "\n" +
                "Region: "         + contacts[i].addresses[j].region        + "\n" +
                "Postal Code: "    + contacts[i].addresses[j].postalCode    + "\n" +
                "Country: "        + contacts[i].addresses[j].country);
        }
    }
};

function onError(contactError) {
    alert('onError!');
};

// find all contacts
var options = new ContactFindOptions();
options.filter = "";
var filter = ["displayName", "addresses"];
navigator.contacts.find(filter, onSuccess, onError, options);

完整的示例

<!DOCTYPE html>
<html>
  <head>
    <title>Contact 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() {
        // find all contacts
        var options = new ContactFindOptions();
        options.filter = "";
        var filter = ["displayName", "addresses"];
        navigator.contacts.find(filter, onSuccess, onError, options);
    }

    // onSuccess: Get a snapshot of the current contacts
    //
    function onSuccess(contacts) {
        // display the address information for all contacts
        for (var i = 0; i < contacts.length; i++) {
            for (var j = 0; j < contacts[i].addresses.length; j++) {
                alert("Pref: "           + contacts[i].addresses[j].pref          + "\n" +
                      "Type: "           + contacts[i].addresses[j].type          + "\n" +
                      "Formatted: "      + contacts[i].addresses[j].formatted     + "\n" +
                      "Street Address: " + contacts[i].addresses[j].streetAddress + "\n" +
                      "Locality: "       + contacts[i].addresses[j].locality      + "\n" +
                      "Region: "         + contacts[i].addresses[j].region        + "\n" +
                      "Postal Code: "    + contacts[i].addresses[j].postalCode    + "\n" +
                      "Country: "        + contacts[i].addresses[j].country);
            }
        }
    };

    // onError: Failed to get the contacts
    //
    function onError(contactError) {
        alert('onError!');
    }

    </script>
  </head>
  <body>
    <h1>Example</h1>
    <p>Find Contacts</p>
  </body>
</html>

Android 2.X 的怪癖

  • 上一頁: 不受支援，返回 false Android 2.X 的設備上。

黑莓手機 WebWorks （OS 5.0 和更高） 的怪癖

  • 上一頁： 返回的黑莓設備上不支援false.

  • 類型： 部分支援。工作和家庭類型位址的每個唯一一個可以存儲每個連絡人。

  • 格式化： 部分支援。返回的串聯的所有黑莓手機位址欄位。

  • streetAddress: 支援。返回的串聯的黑莓位址 1和位址 2的位址欄位。

  • 現場: 支援。黑莓手機城位址欄位中存儲。

  • 區域： 支援。黑莓手機stateProvince位址欄位中存儲。

  • 郵遞區號: 支援。黑莓手機zipPostal位址欄位中存儲。

  • 國家： 支援。

iOS 的怪癖

  • 上一頁： 返回的 iOS 設備上不支援false.

  • 格式化： 目前不支援。

ContactField

支援泛型欄位在 Contact 物件。某些屬性存儲作為 ContactField 物件包括電子郵件地址、 電話號碼和 Url。

屬性

  • 類型： 一個字串，例如指示哪種類型的欄位這是回家。() DOMString

  • 值： 欄位的值，如電話號碼或電子郵件地址。() DOMString

  • 上一頁: 設置為 true 如果此 ContactField 包含使用者的首選的值。（布林）

詳細資訊

ContactField物件是可重用的元件表示泛指連絡人欄位。 每個 ContactField 物件包含 value ， type ，和 pref 屬性。 A Contact 物件存儲中的幾個屬性 ContactField[] 陣列，如電話號碼和電子郵件地址。

在大多數情況下，沒有任何預先確定的值為 ContactField 物件的type屬性。 例如，電話號碼可以指定類型的家庭、工作、移動、 iPhone或由一個特定的設備平臺聯繫資料庫支援的任何其他值的值。 然而，對於 Contact 的照片欄位，類型欄位指示返回圖像的格式： url的值屬性包含的照片圖像或base64的 URL 時的值包含一個 base64 編碼的圖像字串時。

支援的平臺

  • Android 系統
  • 黑莓手機 WebWorks （OS 5.0 和更高）
  • iOS
  • Windows Phone 7 和 8
  • Windows 8

快速的示例

    // create a new contact
    var contact = navigator.contacts.create();

    // store contact phone numbers in ContactField[]
    var phoneNumbers = [];
    phoneNumbers[0] = new ContactField('work', '212-555-1234', false);
    phoneNumbers[1] = new ContactField('mobile', '917-555-5432', true); // preferred number
    phoneNumbers[2] = new ContactField('home', '203-555-7890', false);
    contact.phoneNumbers = phoneNumbers;

    // save the contact
    contact.save();

完整的示例

<!DOCTYPE html>
<html>
  <head>
    <title>Contact 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() {
        // create a new contact
        var contact = navigator.contacts.create();

        // store contact phone numbers in ContactField[]
        var phoneNumbers = [];
        phoneNumbers[0] = new ContactField('work', '212-555-1234', false);
        phoneNumbers[1] = new ContactField('mobile', '917-555-5432', true); // preferred number
        phoneNumbers[2] = new ContactField('home', '203-555-7890', false);
        contact.phoneNumbers = phoneNumbers;

        // save the contact
        contact.save();

        // search contacts, returning display name and phone numbers
        var options = new ContactFindOptions();
        options.filter = "";
        filter = ["displayName", "phoneNumbers"];
        navigator.contacts.find(filter, onSuccess, onError, options);
    }

    // onSuccess: Get a snapshot of the current contacts
    //
    function onSuccess(contacts) {
        for (var i = 0; i < contacts.length; i++) {
            // display phone numbers
            for (var j = 0; j < contacts[i].phoneNumbers.length; j++) {
                alert("Type: "      + contacts[i].phoneNumbers[j].type  + "\n" +
                      "Value: "     + contacts[i].phoneNumbers[j].value + "\n" +
                      "Preferred: " + contacts[i].phoneNumbers[j].pref);
            }
        }
    };

    // onError: Failed to get the contacts
    //
    function onError(contactError) {
        alert('onError!');
    }

    </script>
  </head>
  <body>
    <h1>Example</h1>
    <p>Find Contacts</p>
  </body>
</html>

Android 的怪癖

  • 上一頁: 不受支援，返回false.

黑莓手機 WebWorks （OS 5.0 和更高） 的怪癖

  • 類型： 部分支援。使用的電話號碼。

  • 值： 支援。

  • 上一頁: 不受支援，返回false.

iOS 的怪癖

  • 上一頁: 不受支援，返回false.

ContactFindOptions

包含可用於篩選結果的屬性 contacts.find 操作。

屬性

  • 篩選器： 用來查找連絡人的搜索字串。() DOMString（預設值："")

  • 多個： 確定是否查找操作返回多個連絡人。（布林）（預設值：false)

支援的平臺

  • Android 系統
  • 黑莓手機 WebWorks （OS 5.0 和更高）
  • iOS
  • Windows Phone 7 和 8
  • Windows 8

快速的示例

// success callback
function onSuccess(contacts) {
    for (var i=0; i<contacts.length; i++) {
        alert(contacts[i].displayName);
    }
};

// error callback
function onError(contactError) {
    alert('onError!');
};

// specify contact search criteria
var options = new ContactFindOptions();
    options.filter="";        // empty search string returns all contacts
    options.multiple=true;    // return multiple results
    filter = ["displayName"]; // return contact.displayName field

    // find contacts
navigator.contacts.find(filter, onSuccess, onError, options);

完整的示例

<!DOCTYPE html>
<html>
  <head>
    <title>Contact 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() {
        // specify contact search criteria
        var options = new ContactFindOptions();
        options.filter = "";      // empty search string returns all contacts
        options.multiple = true;  // return multiple results
        filter = ["displayName"]; // return contact.displayName field

        // find contacts
        navigator.contacts.find(filter, onSuccess, onError, options);
    }

    // onSuccess: Get a snapshot of the current contacts
    //
    function onSuccess(contacts) {
        for (var i=0; i<contacts.length; i++) {
            alert(contacts[i].displayName);
        }
    };

    // onError: Failed to get the contacts
    //
    function onError(contactError) {
        alert('onError!');
    }

    </script>
  </head>
  <body>
    <h1>Example</h1>
    <p>Find Contacts</p>
  </body>
</html>

連絡人姓名

包含有關的不同種類的資訊 Contact 物件的名稱。

屬性

  • 格式化： 該連絡人的完整名稱。() DOMString

  • 家族： 連絡人的姓氏。() DOMString

  • givenName： 連絡人的名字。() DOMString

  • 之間： 連絡人的中間名。() DOMString

  • honorificPrefix： 連絡人的首碼 (例如先生或博士） (DOMString)

  • honorificSuffix： 連絡人的尾碼 （如律師）。() DOMString

詳細資訊

ContactName物件存儲的連絡人的名稱屬性。

支援的平臺

  • Android 2.X
  • 黑莓手機 WebWorks （OS 5.0 和更高）
  • iOS
  • Windows Phone 7 和 8
  • Windows 8

快速的示例

function onSuccess(contacts) {
    for (var i = 0; i < contacts.length; i++) {
        alert("Formatted: "  + contacts[i].name.formatted       + "\n" +
            "Family Name: "  + contacts[i].name.familyName      + "\n" +
            "Given Name: "   + contacts[i].name.givenName       + "\n" +
            "Middle Name: "  + contacts[i].name.middleName      + "\n" +
            "Suffix: "       + contacts[i].name.honorificSuffix + "\n" +
            "Prefix: "       + contacts[i].name.honorificSuffix);
    }
};

function onError(contactError) {
    alert('onError!');
};

var options = new ContactFindOptions();
options.filter = "";
filter = ["displayName", "name"];
navigator.contacts.find(filter, onSuccess, onError, options);

完整的示例

<!DOCTYPE html>
<html>
  <head>
    <title>Contact 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 options = new ContactFindOptions();
        options.filter="";
        filter = ["displayName","name"];
        navigator.contacts.find(filter, onSuccess, onError, options);
    }

    // onSuccess: Get a snapshot of the current contacts
    //
    function onSuccess(contacts) {
        for (var i = 0; i < contacts.length; i ++) {
            alert("Formatted: " + contacts[i].name.formatted       + "\n" +
                "Family Name: " + contacts[i].name.familyName      + "\n" +
                "Given Name: "  + contacts[i].name.givenName       + "\n" +
                "Middle Name: " + contacts[i].name.middleName      + "\n" +
                "Suffix: "      + contacts[i].name.honorificSuffix + "\n" +
                "Prefix: "      + contacts[i].name.honorificPrefix);
        }
    };

    // onError: Failed to get the contacts
    //
    function onError(contactError) {
        alert('onError!');
    }

    </script>
  </head>
  <body>
    <h1>Example</h1>
    <p>Find Contacts</p>
  </body>
</html>

Android 的怪癖

  • 格式化： 部分支援，和唯讀。 返回的串聯的 honorificPrefix ， givenName ， middleName ， familyName ，和honorificSuffix.

黑莓手機 WebWorks （OS 5.0 和更高） 的怪癖

  • 格式化： 部分支援。返回的串聯的黑莓手機名字和姓氏欄位。

  • 家族: 支援。黑莓姓氏欄位中存儲。

  • givenName： 支援。黑莓名字欄位中存儲。

  • 之間： 不受支援，返回null.

  • honorificPrefix: 不受支援，返回null.

  • honorificSuffix: 不受支援，返回null.

iOS 的怪癖

  • 格式化： 部分支援。返回 iOS 複合名稱，但為唯讀。

ContactOrganization

包含 Contact 物件的組織屬性。

屬性

  • 上一頁: 設置為 true 如果此 ContactOrganization 包含使用者的首選的值。（布林）

  • 類型： 一個字串，例如指示哪種類型的欄位這是回家。_(DOMString)

  • 名稱： 組織的名稱。() DOMString

  • 部門： 新聞部的工程合約。() DOMString

  • 標題： 在組織連絡人的標題。() DOMString

詳細資訊

ContactOrganization物件存儲的連絡人的組織屬性。A Contact 物件存儲一個或多個 ContactOrganization 陣列中的物件。

支援的平臺

  • Android 系統
  • 黑莓手機 WebWorks （OS 5.0 和更高）
  • iOS
  • Windows Phone 7 和 8
  • Windows 8

快速的示例

function onSuccess(contacts) {
    for (var i = 0; i < contacts.length; i++) {
        for (var j = 0; j < contacts[i].organizations.length; j++) {
            alert("Pref: "      + contacts[i].organizations[j].pref       + "\n" +
                "Type: "        + contacts[i].organizations[j].type       + "\n" +
                "Name: "        + contacts[i].organizations[j].name       + "\n" +
                "Department: "  + contacts[i].organizations[j].department + "\n" +
                "Title: "       + contacts[i].organizations[j].title);
        }
    }
};

function onError(contactError) {
    alert('onError!');
};

var options = new ContactFindOptions();
options.filter = "";
filter = ["displayName", "organizations"];
navigator.contacts.find(filter, onSuccess, onError, options);

完整的示例

<!DOCTYPE html>
<html>
  <head>
    <title>Contact 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 options = new ContactFindOptions();
        options.filter="";
        filter = ["displayName","organizations"];
        navigator.contacts.find(filter, onSuccess, onError, options);
    }

    // onSuccess: Get a snapshot of the current contacts
    //
    function onSuccess(contacts) {
        for (var i = 0; i < contacts.length; i++) {
            for (var j = 0; j < contacts[i].organizations.length; j++) {
                alert("Pref: "     + contacts[i].organizations[j].pref       + "\n" +
                    "Type: "       + contacts[i].organizations[j].type       + "\n" +
                    "Name: "       + contacts[i].organizations[j].name       + "\n" +
                    "Department: " + contacts[i].organizations[j].department + "\n" +
                    "Title: "      + contacts[i].organizations[j].title);
            }
        }
    };

    // onError: Failed to get the contacts
    //
    function onError(contactError) {
        alert('onError!');
    }

    </script>
  </head>
  <body>
    <h1>Example</h1>
    <p>Find Contacts</p>
  </body>
</html>

Android 2.X 的怪癖

  • 上一頁: 不支援的 Android 2.X 的設備，返回false.

黑莓手機 WebWorks （OS 5.0 和更高） 的怪癖

  • 上一頁: 不支援的黑莓設備，返回false.

  • 類型： 不支援的黑莓設備，返回null.

  • 名稱： 部分支援。第一次組織名稱存儲在黑莓公司欄位中。

  • 部: 不受支援，返回null.

  • 標題: 部分支援。第一次組織標題是黑莓jobTitle欄位中存儲的。

iOS 的怪癖

  • 上一頁： 返回的 iOS 設備上不支援false.

  • 類型： 不支援的 iOS 設備上，返回null.

  • 名稱： 部分支援。第一次組織名稱存儲在 iOS kABPersonOrganizationProperty欄位中。

  • 新聞部： 部分支援。第一部名稱存儲在 iOS kABPersonDepartmentProperty欄位中。

  • 標題: 部分支援。第一個標題是 iOS kABPersonJobTitleProperty欄位中存儲的。

ContactError

A ContactError 物件傳遞給 contactError 回檔時出現錯誤。

屬性

  • 代碼： 下面列出的預定義的錯誤代碼之一。

常量

說明

ContactError物件返回到使用者通過 contactError 回呼函數時出現錯誤。

contactSuccess

提供的成功回呼函數 Contact 陣列產生的 contacts.find 操作。

function(contacts) {
    // Do something
}

參數

示例

function contactSuccess(contacts) {
    for (var i=0; i<contacts.length; i++) {
        console.log("Display Name = " + contacts[i].displayName);
    }
}

contactError

聯繫函數的錯誤回呼函數。

function(error) {
    // Handle the error
}

contactFields

所需參數的 contacts.find 方法，用來指定哪些欄位應包含在 Contact 產生的查找操作的物件。

["名稱"、"手機"、"電子郵件"]

contactFindOptions

可選的參數， contacts.find 方法，用於篩選從連絡人資料庫返回的連絡人。

{篩選器：""、 多個： true，} ；

選項

  • 篩選器： 用於過濾連絡人的搜索字串。() DOMString（預設值："")

  • 多個： 確定是否查找操作返回多個連絡人。（布林）（預設值：false)

MarkHD
关注
  • 0
    点赞
  • 踩
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
使用phonegap创建联系人的实现方法
09-27
下面小编就为大家带来一篇使用phonegap创建联系人的实现方法。小编觉得挺不错的，现在就分享给大家，也给大家做个参考。一起跟随小编过来看看吧
使用phonegap查找联系人
孤云博客
09-12 476
随时随地阅读更多技术实战干货，获取项目源码、学习资料，请关注源代码社区公众号(ydmsq666) <!DOCTYPE html> <html> <head> <meta charset="UTF-8"> <title>Databas...
windows phonegap android,phonegap windows 安装
weixin_33736514的博客
05-26 77
安装PhoneGap CLI创建应用phonegap create 项目目径 包名 应用名称$ phonegap create path/to/myApp$ phonegap create path/to/myApp "com.example.app" "My App"$ phonegap create path/to/myApp --id "com.example.app" --name "My...
phonegap打包
Talk is cheap, show me the code!
03-01 605
转自http://www.bkjia.com/Androidjc/1053595.html#commentphonegap官网 http://phonegap.com/安装 phonegap 官方文档： http://docs.phonegap.com/en/edge/guide_cli_index.md.html#The%20Command-Line%20Interface准备工作： 下载
php phonegap,phonegap操作数据库详解
weixin_39860952的博客
03-11 67
这次给大家带来phonegap操作数据库详解，phonegap操作数据库的注意事项有哪些，下面就是实战案例，一起来看一下。实例如下：Database Exampledocument.addEventListener("deviceready", onDeviceReady, false);function onDeviceReady() {var db=window.openDatabase("T...
PhoneGap 简介
peneraly_ruirui的博客
08-30 567
PhoneGap 什么是PhoneGap？ PhoneGap是一个能够让Web开发者快速进行移动app开发的开源框架；PhoneGap主要涉及的技术：HTML5, CSS3, Javascript跨平台， 利用PhoneGap进行移动开发，只需要做非常小的改动，就可以让程序在各种平台上运行：IOS, Android, Windows PhonePhoneGap开发的应用和传统方式（
phonegap 遍历联系人
11-17
使用phonegap调起联系人的小demo
使用phonegap查找联系人的实现方法
09-27
下面小编就为大家带来一篇使用phonegap查找联系人的实现方法。小编觉得挺不错的，现在就分享给大家，也给大家做个参考。一起跟随小编过来看看吧
phonegap通讯录
08-29
手机通讯录资源获取，操作联系人，读取信息
PhoneGap开发环境搭建
02-20
项目中要用PhoneGap开发，了解了下基本规则，记录一下，以备后查。(只针对Android平台)在安装PhoneGap开发环境之前，需要先安装以下框架：1.JavaSDK2.Eclipse3.AndroidSDK4.ADTPlugin5.PhoneGap1.JavaSDK直接下载...
node-v16.12.0-darwin-x64.tar.xz
最新发布
04-23
Node.js，简称Node，是一个开源且跨平台的JavaScript运行时环境，它允许在浏览器外运行JavaScript代码。Node.js于2009年由Ryan Dahl创立，旨在创建高性能的Web服务器和网络应用程序。它基于Google Chrome的V8 JavaScript引擎，可以在Windows、Linux、Unix、Mac OS X等操作系统上运行。 Node.js的特点之一是事件驱动和非阻塞I/O模型，这使得它非常适合处理大量并发连接，从而在构建实时应用程序如在线游戏、聊天应用以及实时通讯服务时表现卓越。此外，Node.js使用了模块化的架构，通过npm（Node package manager，Node包管理器）,社区成员可以共享和复用代码，极大地促进了Node.js生态系统的发展和扩张。 Node.js不仅用于服务器端开发。随着技术的发展，它也被用于构建工具链、开发桌面应用程序、物联网设备等。Node.js能够处理文件系统、操作数据库、处理网络请求等，因此，开发者可以用JavaScript编写全栈应用程序，这一点大大提高了开发效率和便捷性。 在实践中，许多大型企业和组织已经采用Node.js作为其Web应用程序的开发平台，如Netflix、PayPal和Walmart等。它们利用Node.js提高了应用性能，简化了开发流程，并且能更快地响应市场需求。
试用Dev Containers的示例项目-Go
04-23
计算机技术是指评价计算机系统的各种知识和技能的总称。它涵盖了计算机硬件、软件、网络和信息安全等方面。计算机技术的发展使我们能够进行高效的数据处理、信息存储和传输。现代计算机技术包括操作系统、数据库管理、编程语言、算法设计等。同时，人工智能、云计算和大数据等新兴技术也在不断推动计算机技术的进步。计算机技术的应用广泛，涵盖了各个领域，如商业、医疗、教育和娱乐等。随着计算机技术的不断革新，我们可以更加高效地实现预期自动化、标准化
NTsky新闻发布v1.0测试版(提供JavaBean).zip
04-23
### 内容概要： 《NTsky新闻发布v1.0测试版》是一款基于 Java 开发的新闻发布系统的测试版本，旨在为新闻机构和媒体提供一个简单易用的新闻发布平台。该系统具有基本的新闻发布和管理功能，包括新闻分类、新闻编辑、新闻发布等核心功能。此外，该版本还提供了 JavaBean，使开发人员能够方便地将系统集成到自己的项目中，快速实现新闻发布的功能。 ### 适用人群： 本测试版本适用于新闻机构、媒体从业者以及Java开发人员。如果你是一家新闻机构或媒体，希望拥有一个简单易用的新闻发布平台，方便快捷地发布和管理新闻，那么这个测试版本将为你提供一个初步的体验。同时，如果你是一名Java开发人员，希望学习和掌握新闻发布系统的开发技术，并且对新闻行业有一定的了解，那么通过这个测试版本，你可以获取到一些JavaBean，并且可以参考系统的设计和实现，为你的项目开发提供参考和借鉴。无论是从业务需求还是技术学习的角度，该测试版本都将为你提供一定的帮助和支持。
JavaScript介绍.zip
04-23
javascript，JavaScript 最初由 Netscape 公司的 Brendan Eich 在 1995 年开发，用于 Netscape Navigator 浏览器。随着时间的推移，JavaScript 成为了网页开发中不可或缺的一部分，并且其应用范围已经远远超出了浏览器，成为了全栈开发的重要工具。
15-21.php
04-23
15-21.php
汽车租赁系统（毕业设计）
04-23
汽车租赁系统后端采用了spring，spring mvc，mybatis框架，前端使用了layui，界面美观。 包含功能：客户管理，车辆管理，出租，出租单管理，汽车入库，检查单管理，菜单管理，用户管理，角色管理，日志管理，统计分析等。 该毕业设计功能涵盖了大部分汽车租赁中的业务需求，特点是业务功能较多，有助于学生加深业务到技术的理解。
设计模式_行为型_访问者模式.md
04-23
设计模式_行为型_访问者模式
HTML25-创意网站产品主页模板官网落地页APP主页产品宣传页源码 landing静态页面.zip
04-23
HTML25-创意网站产品主页模板官网落地页APP主页产品宣传页源码 landing静态页面
快手弹幕采集学习源码！！
04-23
快手弹幕采集学习源码
PhoneGap安装及使用教程
09-11
它使开发者能够利用iPhone，Android，Palm，Symbian,WP7,Bada和Blackberry智能手机的核心功能——包括地理定位，加速器，联系人，声音和振动等，此外PhoneGap拥有丰富的插件，可以以此扩展无限的功能。PhoneGap是...

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值