在行動應用中,常需要搜尋聯絡人並取得 email 或姓名等欄位。PhoneGap 的 contacts API 可依條件篩選,並回傳符合的結果。
可設定查詢欄位與過濾條件,再呼叫搜尋方法。成功後可遍歷結果,取出需要的聯絡資訊;失敗時則顯示錯誤訊息。
由於不同裝置與系統版本對聯絡人權限與欄位支援不同,開發時應做好例外處理,並避免假設所有欄位一定存在。