Skip to main content
Esta página documenta @whop/elements@1.10.0 y @whop/elements-react@1.10.0.
Desde v1.0.0.
Se monta dentro de Wallet. accountId y accessToken provienen de ahí. Pasa las props y los callbacks a través de las opciones de creación o de las props de React. Conserva el handle creado, o la ref de React, para llamar a refresh() y setDateRange().
Se monta en cualquier lugar de tu jerarquía de vistas. Recibe un accountId y carga sus propios datos; pasa también un closure y obtendrás la fila que pulsó el usuario.

Datos de ejemplo. Abre el Playground.

Props

string
Muestra solo la actividad de esta moneda. Si no se indica, se muestra la actividad de todas las monedas.
string
Un token con alcance limitado para la lectura. Una cuenta necesita company:balance:read y un usuario necesita user:balance:read. Genéralo en tu servidor con POST /api/v1/access_tokens. Sin él, la lectura usa la propia sesión del visitante, que solo funciona en el mismo origen.
number
Muestra como máximo este número de filas y deja de paginar, para obtener una vista previa de la actividad reciente. La lista incorpora un control See all activity que notifica seeAllRequested en lugar de navegar.
boolean
Cuando está desactivado, las filas de transacciones con tarjeta se muestran inertes (sin clic ni hover) en lugar de disparar activitySelected. Úsalo cuando sepas que el usuario no tiene permiso para ver esos detalles. Por defecto es true.
string[]
Tipos de actividad seleccionados cuando el elemento se monta o cambia su cuenta. El usuario puede cambiarlos con los filtros integrados. Por defecto es [].
boolean
Oculta los chips de filtro, para obtener una lista compacta que el usuario no filtra. Por defecto es false.

Eventos

Pasa los callbacks en las opciones de creación o como props de React.

onActivitySelected

Se hizo clic en una fila. Abre tu propia vista o ruta de detalle para ella; el elemento nunca navega.
object

onActivityHovered

El puntero entró en una fila o salió de ella (null). Señala algo propio en el mismo momento, como marcar la fila en un gráfico de saldo.
object | null

onSeeAllRequested

El usuario pulsó See all activity en una lista con maxItems. Abre tu propia pantalla de actividad completa; el elemento nunca navega.

onDateRangeChanged

El usuario cambió el filtro de fechas mediante los chips de filtro y no mediante setDateRange. Borra cualquier selección de rango propia que ya no coincida, como la selección de un gráfico.
object

onLoaderStart

Se ejecuta después de que el esqueleto de carga se pinta por primera vez y antes de onReady.

onReady

Se ejecuta después del primer pintado completo del elemento.

onError

Se ejecuta cuando el elemento no se carga o falla. El contenido de respaldo permanece visible. Usa code para el manejo programático. sourceKey identifica una fuente de estado del host que falló.
object

Métodos

Llámalos en el handle que devuelve create, o a través de una ref de React.

refresh

Vuelve a obtener la actividad de la cuenta desde la primera página. Llámalo después de un cambio realizado en otro lugar (un depósito, un envío) para que la lista lo refleje sin esperar a que caduque la caché.Devuelve Promise<void>

setDateRange

Establece el filtro de fechas desde fuera del elemento, por ejemplo, conectando a la lista la selección de rango de un gráfico. Pasa null para borrarlo.Parámetros
ActivityDateRangeOverride | null
requerido
Devuelve Promise<void>

mount

Monta el elemento en target y comienza a cargarlo. Los componentes de React se montan solos.Parámetros
string | HTMLElement
requerido

destroy

Elimina el elemento y libera su frame y sus suscripciones. Puedes llamarlo más de una vez. React elimina el elemento automáticamente.

update

Combina nuevas props en el elemento montado. En React, cambia las props del componente en su lugar.Parámetros
Partial<ActivityElementProps>
requerido

Estilos

Aplica estilo a estas partes mediante appearance.classes. Usa camel case o kebab case para los nombres de las propiedades e incluye las unidades. Las hojas de estilo de la página no pueden llegar al frame del elemento. El framework valida cada declaración antes de inyectarla.
En React, pasa appearance a <Wallet>. Establécelo globalmente con WhopElements({ appearance }).

Parámetros

String
requerido
De quién es el libro mayor que se lista. Usa un ID de cuenta con el prefijo biz_ o un ID de usuario con el prefijo user_. Ambos funcionan directamente porque el feed lee el ID sin resolver primero un libro mayor.
Bool
Muestra el encabezado integrado “Activity”. Por defecto es true. Desactívalo cuando tu pantalla ya tenga uno.
((WalletActivity) -> Void)?
Se llama con la fila que pulsó el usuario. La vista nunca navega, así que dirige a tu propia pantalla de detalle.

WalletActivity

Lo que devuelve una selección:
  • id: String: estable por fila
  • title: String / subtitle: String: las dos líneas de la fila
  • amount: Decimal: con signo, negativo para el dinero saliente
  • currencyCode: String
  • postedAt: Date
  • isIncoming: Bool

Estados

Muestra una lista de esqueleto mientras se carga la primera página, No activity found cuando el libro mayor no tiene movimientos, y el mensaje de error con un botón Try again cuando falla la lectura. Si falla una página posterior, las filas ya cargadas permanecen en pantalla y aparece un Try again en la parte inferior.

Información útil

  • Dale un contenedor con desplazamiento. El feed es un LazyVStack y pagina cuando aparece su última fila, así que fuera de un ScrollView muestra la primera página y nunca carga otra.
  • Acepta etiquetas biz_… y user_… directamente, así que, a diferencia de las otras vistas de wallet, nunca tiene que resolver primero un libro mayor.
Llama a WhopSDK.configure(tokenProvider:) una vez al iniciar. Las vistas esperan al token. Consulta Primeros pasos. Aplica un tema con .whopTheme(_:).