Skip to main content
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.
Bir WhopPayments kapsamı içine bağlanır. Her onay token’ının gerektirdiği alıcı e-postasını toplar; siz bağlasanız da bağlamasanız da denetleyici token üretimi için onu okur.
Ödemeyi ve onay token’ını yöneten <Payments> içine bağlayın. <Payments> ise <WhopElements> içine bağlanır. Alıcının e-postasını toplar ve sağlayıcıya yayınlar; böylece createConfirmationToken kendisine hiçbir şey iletilmeden onu gönderir.

Örnek veriler. Playground’u açın.

Prop’lar

boolean
Yerelleştirilmiş etiketi gösterir. Kendi etiketinizi sağlıyorsanız false olarak ayarlayın. Giriş, yerelleştirilmiş bir aria-label değerini korur. Varsayılan değer true.
string
E-posta girişi için yer tutucu metin. Boş (varsayılan) bırakılırsa you@example.com görüntülenir. Kayan etiketlerde bunun yerine etiket metni yer tutucu olur. Varsayılan değer "".
"above" | "floating"
above (varsayılan) etiketi girişin üstünde gösterir. floating etiket metnini yer tutucu olarak kullanır, ardından girişte bir değer olduğunda yazılan metnin üstünde küçük bir etiket gösterir. label değeri false olduğunda yok sayılır. Varsayılan değer "above". v1.5.0 sürümünden beri.
string
Bağlama sırasında bir kez uygulanan başlangıç değeri. Varsayılan değer "".

Olaylar

Geri çağırmaları oluşturma seçeneklerinde veya React prop’larında iletin.

onChange

E-posta değiştiğinde tetiklenir. E-posta makul göründüğünde complete true olur. Oturum açma, bunu oturum açılan e-postayla tetikler; bu e-posta createConfirmationToken() çağrısına da aktarılır.
object

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.
object

Metotlar

Bunları create tarafından döndürülen tanıtıcı (handle) üzerinde veya bir React ref aracılığıyla çağırın.

mount

Elementi target içine bağlar ve yüklemeyi başlatır. React bileşenleri kendilerini bağlar.Parametreler
string | HTMLElement
gerekli

destroy

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.Parametreler
Partial<EmailElementProps>
gerekli

Stil verme

Bu parçalara appearance.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.
React’te appearance değerini <Payments> bileşenine iletin. Genel olarak WhopElements({ appearance }) ile ayarlayın.

Parametreler

Binding<String>?
Değeri geri okur. Denetleyici her durumda onu toplar.
Bool
Kendi etiketinizi sağladığınızda false olarak ayarlayın; giriş erişilebilirlik etiketini korur. Varsayılan değer true.
String?
Boş bırakılırsa you@example.com görüntülenir.

Durumlar

Hemen görüntülenir. Makul olmayan bir adres, hatasını alan odağı kaybettiğinde, ardından canlı olarak gösterir.

Bilmekte fayda var

  • Bu element olmadan billingDetails.email değerini createConfirmationToken çağrısına kendiniz iletin. Token üretimi e-postası olmayan bir token’ı reddeder.
  • Token üretimi sırasında açıkça belirtilen billingDetails.email, bu elementin topladığı değere göre önceliklidir.
  • Makul bir adres, gecikmeli olarak ve odak kaybında yeniden hesap dizininde sorgulanır. Tanınan bir adres oturum açma seçeneği sunar ve element altı haneli kod sayfasını kendisi gösterir.
  • Doğrulanmış bir oturum açma, WhopPaymentElement içinde alıcının kayıtlı ödeme yöntemlerinin kilidini açar. Alıcının kim olduğunu öğrenmek için payments.buyer değerini okuyun, onu unutmak için payments.signOut() çağırın.
  • Kapsamlı token bir saat geçerlidir ve yenilenmez. Süresi dolduğunda kayıtlı yöntemler yolu boş döner ve alıcı, bir misafirin izlediği yolun aynısıyla yeni bir yöntemle öder.

Kurulum

Denetleyiciyi oluşturan ve içeriğine ileten bir WhopPayments(accountID:charge:) kapsamı içine bağlayın. Bir e-posta oturum açma işlemi alıcıyı doğruladığında payments.buyer oturum açmış alıcıdır. WhopBrandingElement da ekranda olmalıdır; çünkü bu satışlarda kayıtlı satıcı (merchant of record) Whop’tur ve createConfirmationToken onsuz reddeder. .whopElementsAppearance(_:) ile stil verin. Modül, cüzdan SDK’sının WhopElements modülü değil, Elements modülüdür. Başlarken ve Görünüm sayfalarına bakın.

Prop’lar

string
Bağlama sırasında bir kez uygulanan başlangıç değeri.
boolean
Yerelleştirilmiş etiketi gösterir. Varsayılan değer true.
string
Boş bırakılırsa you@example.com görüntülenir.
(payload: EmailChangePayload) => void
Her düzenlemede tetiklenir.
StyleProp<ViewStyle>
Elementin dış View bileşenine uygulanır. Tema için, bu yüzeydeki her elementi kapsayan sağlayıcı üzerindeki appearance.parts seçeneğini tercih edin. React Native parça adlarının bugün web’in whop-* sınıf adlarından farklı, kendine ait bir küme olduğunu unutmayın; bu nedenle bir web appearance nesnesi değiştirilmeden aktarılamaz.
ReactNode
Element yüklenirken yerleşik iskelet yerine gösterilir.
() => void
Element etkileşimli hâle geldiğinde bir kez tetiklenir. <Payments> bunları gruplar, bu nedenle genellikle istediğiniz şey onun kendi onLoadingChange geri çağırmasıdır.
(error: { message: string; code?: string }) => void
Bu element için bir yükleme veya yapılandırma hatası. Element her iki durumda da kendi hata ekranını gösterir.

EmailChangePayload

onChange geri çağırmasının döndürdüğü değerler:
  • email: string: geçerli değer
  • complete: boolean: adres ayrıştırılabiliyor

Durumlar

Hemen görüntülenir. Adres ayrıştırılabildiğinde onChange complete bildirir ve element odak kaybında kendi doğrulama mesajını gösterir.

Bilmekte fayda var

  • Yayınlanan e-posta, onay token’ının billing_details.email olarak taşıdığı değerdir. createConfirmationToken çağrısına billingDetails.email iletmek bunu geçersiz kılar.
  • Formunuz kendi etiketini sağlıyorsa label={false} ayarlayın. Giriş her iki durumda da erişilebilirlik etiketini korur.
Uygulamanızı bir kez <WhopElements getToken={…}> ile sarın, ardından elementlerin etrafına <Payments> bağlayın. Başlarken ve Görünüm sayfalarına bakın.