MenuChevron Down
Button Botón - Docs - Artefact

Button Botón

Forms
Detección automática inteligente

Introducción

Un componente clicable para desencadenar acciones e interacciones del usuario. Incluye variantes para iconos y botones agrupados.

Uso

Botón básico

import { Button } from "../components/ui";

export default function MyPage() {
  return (
    <Button variant="solid" colorPalette="blue">
      Click me
    </Button>
  );
}

Estado de carga

import { Button } from "../components/ui";

export default function MyPage() {
  return (
    <Button loading loadingText="Saving...">
      Save
    </Button>
  );
}

IconButton

Un botón optimizado para iconos.

import { IconButton } from "../components/ui";
import { SearchIcon } from "./icons";

export default function MyPage() {
  return (
    <IconButton aria-label="Search">
      <SearchIcon />
    </IconButton>
  );
}

CloseButton

Un botón preestilizado para cerrar elementos.

import { CloseButton } from "../components/ui";

export default function MyPage() {
  return <CloseButton onClick={() => console.log("closed")} interactive />;
}

ButtonGroup

import { Button, ButtonGroup } from "../components/ui";

export default function MyPage() {
  return (
    <ButtonGroup attached>
      <Button>First</Button>
      <Button>Second</Button>
    </ButtonGroup>
  );
}

Constructor de Páginas CMS

Este componente está disponible como un bloque button en el Constructor de Páginas (content/pages/*.json):

{
  "type": "button",
  "text": "Click me",
  "variant": "solid",
  "colorPalette": "blue"
}

Propiedades

Button

PropTypeDescription
childrenanyContenido que se renderiza dentro del componente.
classstringClases CSS personalizadas.

| variant | `"solid" \ | "surface" \ | "subtle" \ | "outline" \ | "plain"` | El estilo visual del botón. |

| size | `"2xs" \ | "xs" \ | "sm" \ | "md" \ | "lg" \ | "xl" \ | "2xl"` | El tamaño del botón. |

| loading | boolean | Si es true, el botón mostrará un spinner de carga. | | loadingText | string | El texto que se muestra durante la carga. |

| type | `"button" \ | "submit" \ | "reset"` | El tipo HTML del botón. |

| colorPalette | string | El tema de color del botón. | | interactive | boolean | Si se habilita la hidratación del lado del cliente. |

ButtonGroup

PropTypeDescription
childrenanyBotones a agrupar.
attachedbooleanSi se deben unir los botones entre sí.