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 Reporting, en Ads. accountId y accessToken provienen de Ads. Pasa las props y los callbacks a través de las opciones de creación o de las props de React.

Datos de ejemplo. Abre el Playground.

Props

boolean
Qué ocurre cuando un visitante pide editar, desde un menú de fila, una fila en borrador o Edit ad en el overlay de detalles. Activado por defecto: el creador de campañas se abre sobre la página, en la campaña y el paso que pidió, así que la edición funciona sin conectar nada. Desactívalo para gestionar tú mismo la edición de campañas: no se abre nada y la solicitud llega en editRequested. Por defecto es true.
string | null
Ya no tiene ningún efecto: la tabla siempre muestra filas completas. Se acepta para que las integraciones existentes sigan funcionando. Por defecto es null.
string[] | null
Las columnas visibles, por nombre: las estándar, como impressions y roas, y cualquier evento del píxel que haya añadido el visitante. Si no se establece, la tabla se abre con sus propios valores predeterminados. Se devuelve completa en columnsChanged; guarda la lista y pásala aquí para que el diseño se mantenga. Por defecto es null.
CustomMetricDefinition[]
Columnas calculadas a partir de las cifras que ya están en la tabla: una fórmula a la que pones nombre y formato. La tabla puede editarlas, y cada cambio se devuelve en customMetricsChanged como la nueva lista completa; guárdala y pásala aquí para que se mantenga. Por defecto es [].
string | null
El nivel de detalle de la pestaña All, como ruta de origen: null para las raíces, ext:* para una lista de plataformas, ext:<platform>:* para las campañas de esa plataforma. Se devuelve en viewChanged. Por defecto es null.
string
El filtro aplicado en el cuadro de búsqueda de la pestaña Ads. Por defecto es "".
boolean
Si se muestran las campañas en pausa. Por defecto es true.
boolean
Si se muestran los grupos de anuncios en pausa. Por defecto es true.
boolean
Si se muestran los anuncios en pausa. Por defecto es true.

Eventos

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

onTabChanged

Cambió la pestaña abierta. Refléjala en tu propia URL si quieres que sobreviva a una recarga.
object

onFilterChanged

El visitante acotó la vista, marcando filas o entrando desde una campaña a sus grupos de anuncios. Todas las superficies del mismo handle ya lo han seguido.
object

onColumnsChanged

El visitante mostró u ocultó una columna. Incluye todas las columnas visibles ahora, tanto estándar como de eventos del píxel: guarda la lista y devuélvela directamente como columns, o el diseño se restablecerá en el siguiente montaje.
object

onCustomMetricsChanged

El visitante añadió, editó o eliminó una columna calculada. En cualquier caso incluye la lista completa: guárdala tal cual y devuélvela como customMetrics, o desaparecerán en el siguiente montaje.
object

onViewChanged

El visitante cambió uno de los controles propios de la tabla: el nivel de detalle de la pestaña All, el cuadro de búsqueda o el interruptor de elementos en pausa de cualquiera de las tres pestañas. Incluye todos ellos, sea cual sea el que cambió; guárdalos y devuélvelos como props, o se restablecerán en el siguiente montaje.
object

onSourcesChanged

Lo que muestra ahora la pestaña All, como rutas de origen listas para pasar a un gráfico: null fuera de la pestaña All (solo publicidad de Whop), [] para todas las fuentes y, en otro caso, las filas marcadas o el grupo en el que se ha entrado. Todas las superficies del mismo handle ya lo han seguido.
object

onAttributionModelChanged

El visitante cambió qué punto de contacto recibe la atribución, desde el selector de la pestaña All. Todas las superficies del mismo handle ya han recalculado la atribución; guárdalo y devuélvelo como attributionModel, o volverá al último punto de contacto en el siguiente montaje.
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.

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<TableElementProps>
requerido

Estilos

Este elemento no expone nombres de clase para estilos. Usa appearance (tema, color de acento, variables) para cambiar su estilo.