extraído de climatempo
Seletor Único
Seleção de uma opção num menu suspenso: mostra a escolhida no botão e fecha ao escolher outra.
Variações
Playground
Props
Geradas dos tipos TypeScript do componente; a descrição vem dos comentários /** */.
<SeletorUnico>
Caixa de seleção de uma opção só: mostra a escolhida no botão e fecha a lista ao escolher outra.
| Prop | Tipo | Padrão | Descrição |
|---|---|---|---|
| rotuloobrigatória | string | — | |
| opcoesobrigatória | readonly OpcaoDoSeletorUnico<T>[] | — | |
| valorobrigatória | T | null | — | |
| aoEscolherobrigatória | (valor: T) => void | — |
Código
stories.tsx tem os exemplos usados no preview e no playground.
seletor-unico/SeletorUnico.tsx
"use client";
import { MenuSuspenso } from "@/library/menu-suspenso/MenuSuspenso";
export type OpcaoDoSeletorUnico<T extends string> = { valor: T; rotulo: string };
/** Caixa de seleção de uma opção só: mostra a escolhida no botão e fecha a lista ao escolher outra. */
export function SeletorUnico<T extends string>({
rotulo,
opcoes,
valor,
aoEscolher,
}: {
rotulo: string;
opcoes: ReadonlyArray<OpcaoDoSeletorUnico<T>>;
valor: T | null;
aoEscolher: (valor: T) => void;
}) {
const nome = `seletor-${rotulo}`;
return (
<MenuSuspenso rotulo={rotulo} resumo={opcoes.find((o) => o.valor === valor)?.rotulo ?? ""} larguraDoPainel="w-64">
{(fechar) => (
<ul className="py-1">
{opcoes.map((o) => (
<li key={o.valor}>
<label className="flex min-h-11 cursor-pointer items-center gap-3 px-3 text-sm hover:bg-surface">
<input
type="radio"
name={nome}
checked={o.valor === valor}
onChange={() => {
aoEscolher(o.valor);
fechar();
}}
className="size-4 shrink-0 cursor-pointer accent-accent"
/>
<span className="min-w-0 truncate">{o.rotulo}</span>
</label>
</li>
))}
</ul>
)}
</MenuSuspenso>
);
}
seletor-unico/stories.tsx
import { useState } from "react";
import { defineStories } from "@/registry/stories";
import { SeletorUnico } from "./SeletorUnico";
const LISTAS: Record<string, Array<{ valor: string; rotulo: string }>> = {
periodo: [
{ valor: "7d", rotulo: "Últimos 7 dias" },
{ valor: "30d", rotulo: "Últimos 30 dias" },
{ valor: "ano", rotulo: "Este ano" },
],
metrica: [
{ valor: "receita", rotulo: "Receita" },
{ valor: "pedidos", rotulo: "Pedidos" },
{ valor: "ticket", rotulo: "Ticket médio" },
{ valor: "conversao", rotulo: "Conversão" },
],
};
function Exemplo({ rotulo, lista }: { rotulo: string; lista: string }) {
const opcoes = LISTAS[lista] ?? LISTAS.periodo;
const [valor, setValor] = useState(opcoes[0].valor);
return (
<div className="flex min-h-64 items-start justify-center in-data-miniatura:min-h-0">
<SeletorUnico rotulo={rotulo} opcoes={opcoes} valor={valor} aoEscolher={setValor} />
</div>
);
}
export default defineStories({
args: { rotulo: "Período", lista: "periodo" },
controls: {
rotulo: { type: "text" },
lista: { type: "select", label: "opções (exemplo)", options: ["periodo", "metrica"] },
},
render: (a) => <Exemplo key={a.lista} rotulo={a.rotulo} lista={a.lista} />,
stories: [{ name: "Período" }, { name: "Métrica", args: { rotulo: "Métrica", lista: "metrica" } }],
});
Para usar em outro projeto, copie também
Os componentes de que este depende e o tema. O CSS do tema é um arquivo só: importe depois do Tailwind.
Componentes da biblioteca (diretos e indiretos)
Tema escolhido no cabeçalho (com a ponte para o Tailwind)
Ver o CSS do tema
tema-editorial.css · Editorial
/* Tema "Editorial", gerado no Component Vault.
Importe depois de @import "tailwindcss". Carregue as fontes "Archivo" e "Inter" no projeto. */
@theme inline {
--color-page: var(--page);
--color-surface: var(--surface);
--color-track: var(--track);
--color-grid: var(--grid);
--color-ink: var(--ink);
--color-ink-2: var(--ink-2);
--color-muted: var(--muted);
--color-rule: var(--rule);
--color-rule-strong: var(--rule-strong);
--color-axis: var(--axis);
--color-accent: var(--accent);
--color-success: var(--success);
--color-warning: var(--warning);
--color-critical: var(--critical);
--font-display: var(--fonte-titulo);
--shadow-flutuante: var(--sombra-flutuante);
}
:root {
color-scheme: light dark;
--page: light-dark(#ffffff, #0f0f0e);
--surface: light-dark(#f5f5f5, #1a1a19);
--track: light-dark(#f0f0f0, #262624);
--grid: light-dark(#ededed, #232321);
--ink: light-dark(#111111, #f0efec);
--ink-2: light-dark(#4a4a4a, #c3c2b7);
--muted: light-dark(#666666, #a3a29a);
--rule: light-dark(#e3e3e3, #2c2c2a);
--rule-strong: light-dark(#111111, #f0efec);
--axis: light-dark(#9a9a9a, #6b6a64);
--accent: light-dark(#1a56db, #7aa2f7);
--success: light-dark(#13865c, #3fc48f);
--warning: #fab219;
--critical: #d03b3b;
--series-1: light-dark(#2a78d6, #3987e5);
--series-2: light-dark(#eb6834, #d95926);
--series-3: light-dark(#1baf7a, #199e70);
--series-4: light-dark(#eda100, #c98500);
--series-5: light-dark(#e87ba4, #d55181);
--series-6: #008300;
--series-7: light-dark(#6250d6, #9085e9);
--series-8: light-dark(#e34948, #e66767);
--fonte-titulo: "Archivo", system-ui, -apple-system, "Segoe UI", sans-serif;
--fonte-texto: "Inter", system-ui, -apple-system, "Segoe UI", sans-serif;
--spacing: 0.25rem;
--text-xs: 0.8rem;
--text-sm: 0.8944rem;
--text-base: 1rem;
--text-lg: 1.118rem;
--text-xl: 1.25rem;
--text-2xl: 1.5625rem;
--text-3xl: 1.9531rem;
--text-4xl: 2.4414rem;
--text-5xl: 3.0518rem;
--text-6xl: 3.8147rem;
--text-7xl: 4.7684rem;
--radius-xs: 2px;
--radius-sm: 4px;
--radius-md: 6px;
--radius-lg: 8px;
--radius-xl: 12px;
--radius-2xl: 16px;
--radius-3xl: 24px;
--radius-4xl: 32px;
--sombra-flutuante: 0 8px 24px -6px rgb(0 0 0 / 0.14), 0 2px 6px -2px rgb(0 0 0 / 0.08);
color: var(--ink);
font-family: var(--fonte-texto);
}
Na vitrine, a ponte com o Tailwind fica em src/themes/tokens.css:
src/themes/tokens.css
/* Ponte entre os tokens do tema e o Tailwind.
Os componentes da biblioteca usam classes comuns do Tailwind (p-5, text-sm,
rounded-xl...) e as cores semânticas abaixo (bg-page, text-ink...). Dentro de
[data-theme="vault"], o tema redefine as variáveis que essas classes leem:
--spacing, --text-*, --radius-* e as cores. Os valores vêm do tema escolhido
na vitrine (src/themes/presets.ts) e são gerados por themeCss(). */
@theme inline {
--color-page: var(--page);
--color-surface: var(--surface);
--color-ink: var(--ink);
--color-ink-2: var(--ink-2);
--color-muted: var(--muted);
--color-rule: var(--rule);
--color-rule-strong: var(--rule-strong);
--color-track: var(--track);
--color-grid: var(--grid);
--color-axis: var(--axis);
--color-accent: var(--accent);
--color-success: var(--success);
--color-warning: var(--warning);
--color-critical: var(--critical);
--font-display: var(--fonte-titulo);
--shadow-flutuante: var(--sombra-flutuante);
}