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.
Wallet içindeki Balances içine bağlanır. accountId ve openHoldingOnSelect Wallet üzerinden gelir. Prop’ları ve geri çağırmaları oluşturma seçenekleri veya React prop’ları aracılığıyla iletin.
Görünüm hiyerarşinizin herhangi bir yerine bağlanır. Bir accountId alır ve kendi verilerini yükler; ayrıca bir closure da iletirseniz satırlar dokunulabilir hâle gelir. Kök bir VStack olduğundan içeriğine göre boyutlanır ve ona verdiğiniz genişliği doldurur.

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

Prop’lar

string
Okuma için kapsamlı bir token. Bir hesabın company:balance:read iznine ihtiyacı vardır; bir kullanıcının varlıkları veya sahip olunan hesaplar listesi user:balance:read gerektirir. Onu sunucunuzda POST /api/v1/access_tokens ile oluşturun. Bu olmadan okuma izleyicinin kendi oturumunu kullanır; bu da yalnızca aynı origin’de çalışır.
boolean
Bir kullanıcının user_… hesabı için, kişisel hesabındaki varlıkları listelemek yerine kişisel bakiyesini ve ardından backend’in döndürdüğü sahip olunan her hesabı listeler. Bir hesap için yok sayılır. Varsayılan değer false.
boolean
Her satırı tutulduğu para biriminde gösterir (€4.20, 0.00000009 cbBTC) ve dolar değerini altına koyar. Varsayılan olarak kapalıdır, bu nedenle her satır dolar cinsindendir. Varsayılan değer false.
boolean
Kendi para biriminde gösterilen bir varlığın altındaki dolar değerini korur. Yalnızca showSourceCurrency açıkken geçerlidir. Varsayılan değer true.
boolean
includeOwnedAccounts açıkken kişisel satırı korur. Uygulamanızda açılacak kişisel hesap yoksa kapatın. Varsayılan değer true.
number
En büyükten başlayarak en fazla bu kadar varlık satırı gösterir. Daha fazlası olduğunda listeye geri kalanını yerinde genişleten bir Show all balances denetimi eklenir. Bu olmadan her varlık listelenir.

Olaylar

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

onBalanceSelected

includeOwnedAccounts kapalıyken bir varlık satırına tıklandı. holding, birleşik dolar satırı için usd, aksi hâlde varlık sembolüdür (cbBTC, EUR); kind ise üçünden hangisi olduğunu söyler, böylece sembolleri kendiniz sınıflandırmadan yönlendirme yapabilirsiniz. Element hiçbir zaman gezinme yapmaz.
object

onAccountSelected

includeOwnedAccounts açıkken bir hesap satırına tıklandı. accountId, kişisel user_… etiketi veya sahip olunan bir biz_… etiketidir; kind onu incelemeden yönlendirme yapmanızı sağlar. Element hiçbir zaman gezinme yapmaz.
object

onCreditsSelected

Whop kredileri satırına tıklandı. Krediler yalnızca Whop’ta harcanabilir ve asla çekilemez, bu nedenle her varlık satırının dışında yer alır; ana uygulama kendi krediler ekranını açar. Element hiçbir zaman gezinme yapmaz.

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<ListElementProps>
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 <Wallet> bileşenine iletin. Genel olarak WhopElements({ appearance }) ile ayarlayın.

Parametreler

String
gerekli
Görünümün parasını okuduğu hesap. biz_ önekli bir hesap kimliği kullanın. user_ önekli bir kullanıcı kimliği izleyicinin kendi bakiyesini okur ve bir hesap token’ı değil, izleyici kimlik doğrulaması (WhopSDK.configureWithOAuth) gerektirir.
((WalletBalance) -> Void)?
İzleyicinin dokunduğu satırla çağrılır. Atlarsanız satırlar köşeli oklar olmadan gösterilir ve dokunmak hiçbir şey yapmaz.

WalletBalance

Bir seçimin geri verdiği değerler:
  • id: String: satır başına sabit
  • symbol: String: USD, BTC, …
  • displayName: String: satırda gösterilen ad
  • amountUsd: Decimal: satırın dolar cinsinden değeri
  • isCrypto: Bool: fiat yerine bir kripto varlık

Durumlar

Bakiyeler yüklenirken iki yer tutucu satır gösterir. Çözümlenemeyen bir hesap kimliği Couldn't load this account. gösterir. Bakiye okumasının kendisi başarısız olursa liste bir hata göstermek yerine boş görüntülenir.

Bilmekte fayda var

  • Kendi başına kaydırılmaz; bu nedenle ekranı başka içerikle paylaştığında onu bir ScrollView içine koyun.
  • Aynı hesabın toplamını ve nasıl değiştiğini gösteren BalanceElement ile birlikte kullanılır.
Başlangıçta WhopSDK.configure(tokenProvider:) çağrısını bir kez yapın. Görünümler token’ı bekler. Bkz. Başlarken. .whopTheme(_:) ile bir tema uygulayın.