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çine bağlanır. accountId ve accessToken oradan gelir. Prop’ları ve geri çağırmaları oluşturma seçenekleri veya React prop’ları aracılığıyla iletin. refresh() ve setDateRange() çağırmak için oluşturulan tanıtıcıyı veya React ref değerini saklayın.
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 iletirseniz izleyicinin dokunduğu satırı alırsınız.

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

Prop’lar

string
Yalnızca bu para birimine ait etkinliği gösterir. Belirtilmezse tüm para birimlerinin etkinliği gösterilir.
string
Okuma için kapsamlı bir token. Bir hesap için company:balance:read, bir kullanıcı için user:balance:read gerekir. Sunucunuzda POST /api/v1/access_tokens ile oluşturun. Token olmadan okuma izleyicinin kendi oturumunu kullanır; bu da yalnızca aynı kaynakta (same-origin) çalışır.
number
Son etkinliğin bir önizlemesi için en fazla bu kadar satır gösterir ve sayfalamayı durdurur. Listeye, başka bir sayfaya gitmek yerine seeAllRequested bildiren bir See all activity kontrolü eklenir.
boolean
Kapalıyken kart işlemi satırları activitySelected tetiklemek yerine etkisiz görüntülenir (tıklama yok, üzerine gelme yok). İzleyicinin bu ayrıntıları görmeye yetkili olmadığını bildiğinizde kullanın. Varsayılan değer true.
string[]
Element bağlandığında veya hesabı değiştiğinde seçili olan etkinlik türleri. İzleyici bunları yerleşik filtrelerle değiştirebilir. Varsayılan değer [].
boolean
İzleyicinin filtrelemediği kompakt bir liste için filtre çiplerini gizler. Varsayılan değer false.

Olaylar

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

onActivitySelected

Bir satıra tıklandı. Bunun için kendi ayrıntı görünümünüzü veya rotanızı açın; element asla başka bir sayfaya gitmez.
object

onActivityHovered

İşaretçi bir satıra girdi veya bir satırdan çıktı (null). Aynı anda kendinize ait bir şeyi işaret edin; örneğin satırı bir bakiye grafiğinde işaretleyin.
object | null

onSeeAllRequested

İzleyici bir maxItems listesinde See all activity düğmesine bastı. Kendi tam etkinlik ekranınızı açın; element asla başka bir sayfaya gitmez.

onDateRangeChanged

İzleyici tarih filtresini setDateRange yerine filtre çipleri aracılığıyla değiştirdi. Artık eşleşmeyen, grafik fırçası gibi kendinize ait herhangi bir aralık seçimini temizleyin.
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.

refresh

Hesabın etkinliğini ilk sayfadan yeniden getirir. Başka bir yerde yapılan bir değişiklikten (para yatırma, gönderme) sonra çağırın; böylece liste önbelleğin süresinin dolmasını beklemeden bunu yansıtır.Döndürür Promise<void>

setDateRange

Tarih filtresini elementin dışından ayarlar; örneğin bir grafik fırçası seçimini listeye bağlamak için. Temizlemek için null iletin.Parametreler
ActivityDateRangeOverride | null
gerekli
Döndürür Promise<void>

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<ActivityElementProps>
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
Kimin defterinin listeleneceği. biz_ önekli bir hesap kimliği veya user_ önekli bir kullanıcı kimliği kullanın. Akış kimliği önce bir defter çözümlemeden okuduğu için her ikisi de doğrudan çalışır.
Bool
Yerleşik “Activity” başlığını gösterir. Varsayılan değer true. Ekranınızda zaten bir başlık varsa kapatın.
((WalletActivity) -> Void)?
İzleyicinin dokunduğu satırla çağrılır. Görünüm asla başka bir sayfaya gitmez, bu nedenle kendi ayrıntı ekranınıza yönlendirin.

WalletActivity

Bir seçimin döndürdüğü değerler:
  • id: String: her satır için kararlı
  • title: String / subtitle: String: satırın iki satırı
  • amount: Decimal: işaretli, para çıkışı için negatif
  • currencyCode: String
  • postedAt: Date
  • isIncoming: Bool

Durumlar

İlk sayfa yüklenirken bir iskelet liste, defterde hiç hareket yoksa No activity found ve okuma başarısız olduğunda bir Try again düğmesiyle birlikte hata mesajı gösterir. Sonraki bir sayfa başarısız olursa zaten yüklenmiş satırlar ekranda kalır ve en altta bir Try again görünür.

Bilmekte fayda var

  • Bir kaydırma kapsayıcısı verin. Akış bir LazyVStack bileşenidir ve son satırı göründükçe sayfalanır; bu nedenle bir ScrollView dışında ilk sayfayı gösterir ve asla başka bir sayfa yüklemez.
  • biz_… ve user_… etiketlerini doğrudan alır; bu nedenle diğer cüzdan görünümlerinin aksine önce bir defter çözümlemesi gerekmez.
Başlangıçta bir kez WhopSDK.configure(tokenProvider:) çağırın. Görünümler token’ı bekler. Başlarken sayfasına bakın. .whopTheme(_:) ile bir tema uygulayın.