Web için kişi seçici

Kişi Seçici API'sı, kullanıcıların kendi kişi listelerindeki kişileri paylaşması için kolay bir yol sağlar.

Pete LePage

Contact Picker API'si nedir?

Contact Picker API'sini kullanma

Contact Picker API'si, istediğiniz iletişim bilgisi türlerini belirtir. İkinci bir yöntem de temel sistemin hangi bilgileri sağlayacağını belirlemek önemlidir.

Özellik algılama

Contact Picker API'sinin desteklenip desteklenmediğini kontrol etmek için şunu kullanın:

const supported = ('contacts' in navigator && 'ContactsManager' in window);

Ayrıca, Android'de Kişi Seçici için Android M veya sonraki sürümleri gerekir.

Kişi Seçiciyi Açma

Contact Picker API'sinin giriş noktası navigator.contacts.select(). Çağrı yapıldığında bir söz döndürür ve kişi seçiciyi göstererek kullanıcının siteyle paylaşmak istediği kişileri seçmesine olanak tanır. Şu tarihten sonra: paylaşacağınızı seçtikten sonra Bitti'yi tıkladığınızda vaat kullanıcı tarafından seçilen kişi dizisidir.

select() öğesini çağırırken istediğiniz bir özellik dizisini sağlamanız gerekir ilk parametre olarak döndürülür (izin verilen değerler, 'name', 'email', 'tel', 'address' veya 'icon'), ve isteğe bağlı olarak birden çok kişinin ikinci parametre olarak seçilir.

const props = ['name', 'email', 'tel', 'address', 'icon'];
const opts = {multiple: true};

try {
  const contacts = await navigator.contacts.select(props, opts);
  handleResults(contacts);
} catch (ex) {
  // Handle any errors here.
}

Kişi Seçici API'si yalnızca güvenli bağlamına göz atmak ister. Diğer güçlü API'lerde olduğu gibi, Kullanıcı hareketi.

Kullanılabilir özellikleri algılama

Hangi tesislerin kullanılabilir olduğunu tespit etmek için navigator.contacts.getProperties() işlevini çağırın. Bir vaat döndürerek söz konusu dizelerle çözülür. kullanılabilir. Örnek: ['name', 'email', 'tel', 'address']. Bu değerleri select() adlı cihaza aktarabilirsiniz.

Özelliklerin her zaman kullanılamayacağını ve yeni mülklerin eklendi. Gelecekte diğer platformlar ve kişi kaynakları bu kısıtlamaya tabi olabilir. ve hangi özelliklerin paylaşılacağını belirler.

Sonuçları işleme

Contact Picker API'si bir dizi kişi döndürür ve her kişi istenen özelliklerin dizisi. Bir kişinin veya kullanıcı belirli bir öğeyi paylaşmayı devre dışı bırakmayı seçerse özelliği varsa API boş bir dizi döndürür. (Kullanıcının tesisleri nasıl seçtiğini açıklıyorum (Kullanıcı denetimi bölümündeki) tıklayın.)

Örneğin, bir site name, email ve tel isteğinde bulunursa ve bir kullanıcı ad alanında veri bulunan tek bir kişi seçer ve ancak bir e-posta adresi yoksa döndürülen yanıt şöyle olur:

[{
  "email": [],
  "name": ["Queen O'Hearts"],
  "tel": ["+1-206-555-1000", "+1-206-555-1111"]
}]

Güvenlik ve izinler

Chrome ekibi, temel bilgileri kullanarak Contact Picker API'sini tanımlanan ilkelere Güçlü Web Platformu Özelliklerine Erişimi Kontrol Etme dahil olmak üzere tüm bunları kapsar. Her birini açıklayacağım.

Kullanıcı denetimi

Kullanıcıların kişiler seçici aracılığıyla oluşturulur ve yalnızca güvenli, üst düzey göz atma bağlamında bir kullanıcı hareketi. Bu durum, bir sitenin sayfa yüklenirken seçiciyi ya da rastgele gösterilmesini engeller bağlam olmadan kullanabilirsiniz.

Kullanıcıları teşvik etmek için tüm kişileri topluca seçme imkanı yoktur. yalnızca o paylaşım için paylaşmaları gereken kişileri seçmek web sitesi. Kullanıcılar, siteyle hangi mülklerin paylaşılacağını da kontrol edebilir Bunu yapmak için seçicinin üst kısmındaki özellik düğmesini etkinleştirin.

Şeffaflık

Hangi kişi ayrıntılarının paylaşıldığını netleştirmek için seçici her zaman kişinin adı ve simgesi ile sitenin sahip olduğu tüm özellikleri gösterir istendi. Örneğin, bir site name, email ve tel için istekte bulunursa üç özellik de seçicide gösterilir. Alternatif olarak: Bir site yalnızca tel isteğinde bulunursa seçici yalnızca adı gösterir ve telefon numaraları.

ziyaret edin.

'nı inceleyin.

Bir kişiye uzun bastığınızda, içinde bulunacak tüm bilgiler kişi seçilirse paylaşılır. (Cheshire Cat'in kişi resmine bakın.)

İzin kalıcılığı yok

Kişilere erişim isteğe bağlıdır ve kalıcı değildir. Bir site her istekte bulunduğunda navigator.contacts.select() bir kullanıcı hareketiyle çağrılmalıdır, ve kullanıcının paylaşmak istediği kişileri tek tek seçmesi gerekir göstermenin iyi bir yoludur.

Geri bildirim

Chrome ekibi, Kişi Seçici ile ilgili deneyimlerinizi öğrenmek istiyor API'ye gidin.

Uygulamayla ilgili bir sorun mu var?

Chrome'un uygulanmasıyla ilgili bir hata buldunuz mu? Yoksa ve spesifikasyondan farklı mı?

• https://new.crbug.com adresinden hata bildiriminde bulunun. Olabildiğince çok sayıda ve hatayı yeniden oluşturmak için basit talimatlar sağlayın ve Bileşenler'i Blink>Contacts olarak ayarlayın. Glitch çok iyi sonuç veriyor hızlı ve kolay problem yeniden prodüksiyonları paylaşmanız için gereklidir.

API'yi kullanmayı mı planlıyorsunuz?

Contact Picker API'yi kullanmayı planlıyor musunuz? Herkese açık desteğiniz, Chrome ekibinin özelliklere öncelik vermesi için yardımcı olur ve diğer tarayıcı tedarikçilerine onu desteklemek çok önemli.

• Bu özelliği nasıl kullanmayı planladığınızı WICG Discourse ileti dizisinde paylaşın.
• Hashtag'i kullanarak @ChromiumDev hesabına tweet gönderin #ContactPicker ve bize bildirin.

Faydalı bağlantılar

• Herkese açık açıklayıcı
• Kişi seçicinin teknik özellikleri
• Contact Picker API Demosu ve Contact Picker API demo kaynağı
• Hata izleme
• ChromeStatus.com girişi
• Blink Bileşeni: Blink>Contacts

Teşekkürler

Finnur Thorarinsson ve Rayan Kanso'ya teşekkür ederiz. Peter Beverloo’yu kodlama utançsızca çalındı ve yeniden düzenlendi.

Not: Kişi seçicimdeki adlar Aylin Harikalar Diyarında'dan karakterler.