Skip to content

<WalletWidget>

<WalletWidget> est le composant React chargé de rendre le widget du portefeuille.

<WalletWidget> doit être rendu à l'intérieur d'un <WalletProvider>.

Exemple

tsx
import { WalletWidget } from '@money-sdk/react'

function Layout() {
  return (
    <header>
      <WalletWidget theme={{ variant: 'dark' }} size="large" shape="squared" />
    </header>
  )
}

INFO

Le widget reste invisible jusqu'à ce que l'utilisateur connecte le portefeuille — il retourne null lorsqu'il est déconnecté. Placez-le dans un conteneur toujours monté (par exemple votre layout racine) et affichez votre propre bouton de connexion à côté.

Référence

props.theme

Personnalisez le thème du widget du portefeuille en passant un objet avec les attributs suivants :

AttributDescriptionDéfautValeurs
variantL'apparence du widget du portefeuille déplié.'glow''dark' | 'flat' | 'glow'
colors.accentColorLa couleur d'accentuation du widget du portefeuille. Définir cette valeur active le mode monochromatique, supprimant toute autre couleur concurrente (par exemple les icônes des tokens).undefinedToute chaîne de couleur CSS valide.
colors.collapsed.accentColorLa couleur d'accentuation du widget du portefeuille replié. Utilise colors.accentColor par défaut si celle-ci est définie.undefinedToute chaîne de couleur CSS valide.
colors.collapsed.backgroundColorLa couleur d'arrière-plan du widget du portefeuille replié.undefinedToute chaîne de couleur CSS valide.

Les références CSS var(...) sont résolues de manière anticipée avant d'être transmises à l'iframe, ce qui vous permet de référencer vos propres design tokens :

tsx
<WalletWidget
  theme={{
    variant: 'glow',
    colors: { accentColor: 'var(--brand-accent)' },
  }}
/>

props.size

Choisissez entre quatre tailles différentes pour le widget du portefeuille replié : small, medium, large et huge.

Par défaut 'medium'.

props.shape

Choisissez entre deux formes différentes pour le widget du portefeuille replié : rounded et squared.

Par défaut 'rounded'.

props.compact

Active le mode compact. Ce mode est une version minuscule du widget du portefeuille replié qui ne contient que l'avatar.

Par défaut false.

props.noAutoCompact

Empêche le widget du portefeuille de basculer en mode compact sur les petits écrans.

Par défaut false.

props.smallBreakpoint

Définit le breakpoint, en pixels, utilisé pour optimiser le widget du portefeuille pour les petits écrans.

Lorsque la largeur de la fenêtre est inférieure à ce nombre, le widget du portefeuille utilise le mode compact et s'étend pour occuper tout l'écran.

Par défaut 540.

props.noAutoCollapse

Empêche le widget du portefeuille de se replier lorsque l'utilisateur clique en dehors.

Par défaut false.

props.experimental_mode

Mode de rendu. dropdown déplie le widget sur place (adapté pour le desktop) ; modal rend le widget dans un portail centré. Par défaut dropdown — il reste responsive grâce à la prop smallBreakpoint.

props.className

Classes CSS supplémentaires pour un style personnalisé.

Par défaut undefined.

props.style

Styles inline pour un style personnalisé.

Par défaut undefined.