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 CardFields, en Payments. Pasa props y callbacks mediante las opciones de creación o las props de React.
Espera a BrandingElement. Este elemento permanece en su estado de carga hasta que BrandingElement se monta en el mismo handle de Payments.
Va dentro de un builder WhopCardFields. El campo alojado del número de tarjeta, con el logotipo de la marca en su borde final.
Se monta dentro de CardFields. El número de tarjeta por separado, para que tu diseño decida dónde se coloca.

Datos de ejemplo. Abre el Playground.

Props

Este elemento no acepta props del consumidor.

Eventos

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

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<CardNumberElementProps>
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 <Payments>. Establécelo globalmente con WhopElements({ appearance }).

Estados

Se renderiza inmediatamente. El logotipo de la marca aparece una vez que el número identifica una red. Un número no válido muestra su error debajo del campo.

Información útil

  • Fuera de un builder WhopCardFields no renderiza nada: lee la unidad de tarjeta que crea ese builder.

Instalación

Móntalo dentro de un ámbito WhopPayments(accountID:charge:), que crea el controlador y se lo pasa a su contenido. payments.buyer es el comprador con sesión iniciada una vez que un inicio de sesión por correo electrónico lo ha verificado. WhopBrandingElement también tiene que estar en pantalla, porque Whop es el comerciante registrado en estas ventas y createConfirmationToken se rechaza sin él. Aplica estilo con .whopElementsAppearance(_:). El módulo es Elements, no WhopElements del SDK de wallet. Consulta Primeros pasos y Appearance.

Props

StyleProp<ViewStyle>
Se aplica al View exterior del elemento. Para la personalización del tema, es preferible appearance.parts en el provider, que cubre todos los elementos de esta superficie. Ten en cuenta que, por ahora, los nombres de las partes de React Native son un conjunto propio, no los nombres de clase whop-* de la web, por lo que un objeto de appearance de la web no se puede trasladar sin cambios.

Estados

Se renderiza en cuanto su provider CardFields tiene una clave publicable. Su mensaje de validación se renderiza debajo.

Información útil

  • Los números de tarjeta nunca pasan por tu código. Los campos son inputs nativos aislados según PCI y el SDK entrega a Whop un token, por lo que tu app queda fuera del alcance de PCI.
  • Lee el estado de completitud desde el onChange del provider CardFields en lugar de hacerlo por campo.
Envuelve tu app en <WhopElements getToken={…}> una vez y luego monta <Payments> alrededor de los elementos. Consulta Primeros pasos y Appearance.