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 currency 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; range, açıldığı zaman aralığını seçer. 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
Okumalar için kapsamlı bir token. Bir hesabın toplam için company:balance:read, grafik için stats:read iznine ihtiyacı vardır; bir kullanıcının kendi bakiyesi user:balance:read gerektirir. Onu sunucunuzda POST /api/v1/access_tokens ile oluşturun ve süresi dolmadan önce yenisini ayarlayın. Bu olmadan okumalar izleyicinin kendi oturumunu kullanır; bu da yalnızca aynı origin’de çalışır. Varsayılan değer "".
"1D" | "1W" | "1M" | "1Y" | "ALL"
Açılacak zaman aralığı. Düğmeler onu oradan itibaren değiştirir; kendiniz kontrol etmek için bu prop’u yeniden ayarlayın. Varsayılan değer "1M".
string
Hesabın açıldığı zaman, ISO 8601 zaman damgası olarak. ALL, beş yıllık varsayılanı yerine buradan başlar; böylece bundan daha eski bir hesap tüm geçmişini korur. Varsayılan değer "".
string
Hesap adını etikete ekler: normalde Total balance · Acme, izleyici bir noktayı okurken ise Acme balance on Jul 9. Bu olmadan etiket yalnızca Total balance olur. Varsayılan değer "".
object | null
Grafikteki seçili aralık, ISO 8601 zaman damgaları olarak. Seçimi kendiniz kontrol etmek için ayarlayın veya izleyicinin yaptığı seçimi temizlemek için null yapın. rangeBrushed olayının bildirdiğini geri yansıtın; böylece sayfanızın başka bir yerinde bir filtreyi temizlemek buradaki seçimi de temizler. Varsayılan değer null.
string
Grafikte işaretlenecek bir an, ISO 8601 zaman damgası olarak — sayfanızdaki başka bir şeyin işaret ettiği nokta; örneğin bir etkinlik listesinde işaretçinin altındaki satır. İzleyicinin o noktanın üzerine kendisi gelmiş gibi okunur ve ekrandaki pencerenin dışına düştüğünde veya izleyici grafiği okurken yok sayılır. Varsayılan değer "".
boolean
Bir kullanıcı için yalnızca kendi parası yerine kendi parasıyla birlikte sahip olduğu her hesabın toplamını alır. Zaten tek bir hesap olan bir hesap için yok sayılır. Varsayılan değer false.
boolean
Toplamı ve değişimini gizler; grafik ve aralık düğmeleri kalır. Varsayılan değer false.
boolean
Grafiği gizler; toplam ve aralık düğmeleri kalır. Varsayılan değer false.
number
Grafiğin piksel cinsinden çizim yüksekliği. Varsayılan değer 210.

Olaylar

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

onRangeChanged

Görünür zaman aralığı değişti. Sayfanızdaki başka bir şey aynı dönemi okuyorsa onu yansıtın.
object

onRangeBrushed

İzleyici bir aralık seçmek için grafik üzerinde sürükledi veya seçimi temizledi (null). ISO 8601 zaman damgalarını ve okundukları aralığı verir; böylece etkinlik listesi veya tablo gibi kendi görünümlerinizi aynı döneme göre filtreleyebilirsiniz.
object | null

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<BalanceElementProps>
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.
String
Toplamın ve grafiğin gösterildiği para birimi. Varsayılan değer "usd".
WalletBalanceRange
Grafiğin açıldığı zaman aralığı: .oneDay, .oneWeek, .oneMonth, .oneYear, .all. Varsayılan değer .oneMonth; izleyici seçiciyle değiştirebilir.

Durumlar

Veriler yüklenirken yer tutucu bir grafik gösterir. Karşılaştırma dönemi başarısız olursa değişim tahmin edilmek yerine gizlenir; böylece ekrandaki her sayı gerçekten ölçülmüş bir sayıdır. Çözümlenemeyen bir hesap kimliği dönmeye devam etmek yerine Couldn't load this account. gösterir.

Bilmekte fayda var

  • Grafikte gezinmek için basılı tutup sürükleyin. Başlık parmağınızın altındaki noktayı izler ve bıraktığınızda toplama geri döner.
  • Bakiye geçmişi yalnızca biz_ önekli hesap kimlikleri için kullanılabilir; bu nedenle user_ önekli kişisel bir hesap toplamı grafik olmadan gösterir.
  • Aynı toplamı tek tek varlıklara ayıran ListElement 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.