LegbaName

Ce que ça fait

Affiche value (<legba-name>) telle quelle — jamais recoupée, l’espacement de l’appelant est préservé. Une value vide ou ne contenant que des blancs affiche un texte de repli documenté (LEGBA_NAME_FALLBACK), jamais une chaîne vide silencieuse. Rien d’asynchrone ni de faillible : pas d’état chargement/erreur.

Signature

class LegbaName extends LegbaElement {
  value: string;
}

Tag : legba-name.

Paramètres

Retour

N/A — un élément DOM. Aucun événement émis.

Erreurs

Aucune : value vide/blanche n’est jamais une erreur, seulement un repli d’affichage.

Exemple minimal

import type { LegbaName } from "@legba-core/ui";

function showName(el: LegbaName, value: string): void {
  el.value = value;
}

Exemple complet

import type { LegbaName } from "@legba-core/ui";

function wireParticipantName(el: LegbaName, participant: { displayName?: string }): void {
  // Une valeur absente/blanche affiche le repli documenté — inutile de
  // vérifier soi-même avant d'affecter la propriété.
  el.value = participant.displayName ?? "";
}

Pièges

• value n’est jamais recoupée avant affichage : " Ada " s’affiche avec ses espaces internes intacts — seule la DÉTECTION du cas vide utilise un trim() interne.
• Une value composée uniquement d’espaces est traitée comme vide (repli affiché), pas une chaîne blanche silencieuse.
• Unicode (accents, emoji) affiché tel quel, sans troncature.
• Consomme les jetons --legba-* comme tout composant @legba-core/ui : ne redéclare jamais un jeton public directement, voir LegbaElement.

Voir aussi

• LEGBA_NAME_FALLBACK
• LegbaAvatar
• LegbaElement