Bu sayfa
@whop/elements@1.10.0 ve @whop/elements-react@1.10.0 sürümlerini belgeler.v1.0.0 sürümünden beri.
Payments içine bağlanır. Prop’ları ve geri çağırmaları oluşturma seçenekleri veya React prop’ları aracılığıyla iletin. validate() ve getValues() çağırmak için oluşturulan tanıtıcıyı veya React ref değerini saklayın.Her
mode için bir tane. Tek bir Payments tanıtıcısı altında her mode değeri için bir <AddressElement /> bağlayın. Aynı mode ile ikinci bir bağlama reddedilir. Bir elementin mode değeri onu oluşturduğunuzda ayarlanır; değiştirmek için elementi yok edin ve yeni bir tane oluşturun.Örnek veriler. Playground’u açın.
Prop’lar
Bunun hangi adresi topladığı:
billing (varsayılan) veya shipping. Tarayıcının otomatik tamamlama amacını da ayarlar. Tek bir tanıtıcı altında her birinden bir tane bağlayabilirsiniz. Fatura ayrıntıları fatura elementinden veya hiçbir fatura elementi bağlı değilse teslimat elementinden gelir. Varsayılan değer "billing".Ad satırı: tek bir tam ad alanı (varsayılan), ayrı ad/soyad alanları veya hiçbiri. Varsayılan değer
"combined".Adres satırı 2: her zaman görünür (varsayılan), bir metin düğmesiyle ortaya çıkar (
toggle) veya hiç toplanmaz. Varsayılan değer "always".İlk çizimden önce bir kez uygulanan başlangıç değerleri (
address.country bir ISO 3166-1 alpha-2 ülke kodudur). IP’ye dayalı ülke algılamasına göre önceliklidir.full (varsayılan) etiketli alanları üst üste dizer. compact, yer tutucuyla etiketlenmiş alanları tek bir kenarlık içinde gruplar. wrap, full düzeninin ayrı alanlarını korur ve ayrıca şehir, eyalet ve posta kodunu yan yana koyar. Bunlar ve full düzeninin zaten yan yana koyduğu çiftler (ad ve soyad, kuruluş), genişliğin izin verdiği kadar bir satıra sığar ve genişlik daraldıkça alt satıra geçer. Varsayılan değer "full".above (varsayılan) her etiketi alanının dışında tutar: full düzeninde alanın üstünde, compact düzeninde yer tutucusu olarak. floating, her iki düzende de her etiketi alanının yer tutucusu olarak kullanır, ardından alanın bir değeri olduğunda yazılan metnin üstünde küçük bir etiket gösterir. Varsayılan değer "above". v1.5.0 sürümünden beri.full (varsayılan), seçilen ülkenin eksiksiz adres biçimini izler. minimal yalnızca ülke ve posta kodunu toplar. name, gerekli ad alanlarını bağımsız olarak ekler. Bunları atlamak için name değerini none olarak ayarlayın. Bu element bir ödeme yönteminin gerektirdiği alanları eklemez. Kart onayı bir ad, ülke ve posta kodu gerektirir, bu nedenle name seçeneğini etkin tutun veya billingDetails.name iletin. Varsayılan değer "full".Kuruluş alanları: hiçbiri (varsayılan), yalnızca ad veya işletme/bireysel seçicisiyle birlikte ad. Varsayılan değer
"none".Ülkeyi varsayılan olarak alıcının IP adresinden belirler (ilk çizimden önce çözümlenir). Önce denetleyicinin
countryHint değerine, ardından US’ye geri döner. Varsayılan değer true.İzin verilen ISO 3166-1 alpha-2 ülke kodları. Tek bir kodla seçici görünür kalır ancak yalnızca o ülkeyi sunar.
Sokak adresi için Google Places önerilerini etkinleştirir. Hiçbir eşleşme görünmezse veya Places engellenmişse liste eşleşme olmadığını bildirir ve alıcıların adresi elle girmesine izin verir. Telefonda öneriler, klavyenin onları kapatacağı alanın altında değil, sokak alanındaki bir arama düğmesinden tam ekran açılır. Düz bir giriş için
false olarak ayarlayın. Varsayılan değer true.Her adres alanını baştan gösterir. Varsayılan olarak (
false) form sokak adresiyle açılır ve alıcı bir öneri seçtiğinde, bir adres yazdığında veya elle girmeyi seçtiğinde geri kalanını ortaya çıkarır. Varsayılan değer false. v1.6.0 sürümünden beri.Adres formuyla birlikte gösterilen ek alanlar. Değerler doğrulanır ve ayrı
custom eşlemesinde yayınlanır.defaultValues ve IP algılamasından sonraki yedek ülke. Bir ISO 3166-1 alpha-2 kodu kullanın. Boş bir değer US değerine geri döner. Varsayılan değer "".Olaylar
Geri çağırmaları oluşturma seçeneklerinde veya React prop’larında iletin.onChange
Adres değiştiğinde tetiklenir. Ülkeye özgü tüm alanlar ve gerekli özel alanlar geçerli olduğunda complete true olur. address, postal_code dahil olmak üzere onay token’ının billing_details adlarını izler. country bir ISO 3166-1 alpha-2 kodudur. Özel değerler custom içindedir.onLoaderStart
Yükleme iskeleti ilk kez çizildikten sonra ve onReady öncesinde çalışır.onReady
Elementin ilk eksiksiz çiziminden sonra çalışır.onError
Element yüklenemediğinde veya çöktüğünde çalışır. Yedek görünüm görünür kalır. Programatik işleme için code kullanın. sourceKey, başarısız olan host-state kaynağını tanımlar.Metotlar
Bunlarıcreate tarafından döndürülen tanıtıcı (handle) üzerinde veya bir React ref aracılığıyla çağırın.validate
Formu doğrular, tüm satır içi hataları ortaya çıkarır ve asla hata fırlatmaz. complete, address ve errors döndürür. errors, tam olarak complete true olduğunda boştur. Anahtarlar postal_code ve line1 gibi sözleşme adlarını, özel alanlar için custom:<key> biçimini ve yükleme sırasında geçici form anahtarını kullanır.Döndürür Promise<object>getValues
Doğrulama yapmadan veya hataları ortaya çıkarmadan address ve custom döndürür.Döndürür Promise<object>mount
Elementi target içine bağlar ve yüklemeyi başlatır. React bileşenleri kendilerini bağlar.Parametrelerdestroy
Elementi kaldırır ve çerçevesini ile aboneliklerini serbest bırakır. Birden fazla kez çağırabilirsiniz. React elementi otomatik olarak kaldırır.update
Yeni prop’ları bağlı elementle birleştirir. React’te bunun yerine bileşen prop’larını değiştirin.ParametrelerStil verme
Bu parçalaraappearance.classes aracılığıyla stil verin. Özellik adları için camel case veya kebab case kullanın ve birimleri ekleyin. Sayfa stil sayfaları elementin çerçevesine ulaşamaz. Framework her bildirimi eklemeden önce doğrular.appearance değerini <Payments> bileşenine iletin. Genel olarak WhopElements({ appearance }) ile ayarlayın.
