twenty/packages/twenty-docs/l/pt/twenty-ui/input/radio.mdx

---
title: Rádio
image: /images/user-guide/create-workspace/workspace-cover.png
---

<Frame>
  <img src="/images/user-guide/create-workspace/workspace-cover.png" alt="Cabeçalho" />
</Frame>

Usado quando os usuários podem escolher apenas uma opção de uma série de opções.

<Tabs>
  <Tab title="Uso">
    ```jsx
    import { Radio } from "twenty-ui/display";

    export const MyComponent = () => {

      const handleRadioChange = (event) => {
        console.log("Radio button changed:", event.target.checked);
      };

      const handleCheckedChange = (checked) => {
        console.log("Checked state changed:", checked);
      };


      return (
        <Radio
          checked={true}
          value="Option 1"
          onChange={handleRadioChange}
          onCheckedChange={handleCheckedChange}
          size="large"
          disabled={false}
          labelPosition="right"
        />
      );
    };

    ```
  </Tab>

  <Tab title="Propriedades">
    | Propriedades      | Tipo                     | Descrição                                                                                          |
    | ----------------- | ------------------------ | -------------------------------------------------------------------------------------------------- |
    | estilo            | propriedades `React.CSS` | Estilos extras em linha para o componente                                                          |
    | className         | string                   | Classe CSS opcional para estilização adicional                                                     |
    | marcado           | booleano                 | Indica se o botão de rádio está marcado                                                            |
    | valor             | string                   | O rótulo ou texto associado ao botão de rádio                                                      |
    | onChange          | função                   | A função chamada quando o botão de rádio selecionado é alterado                                    |
    | onCheckedChange   | função                   | A função chamada quando o estado `marcado` do botão de rádio muda                                  |
    | tamanho           | string                   | O tamanho do botão de rádio. As opções incluem: `grande` e `pequeno`                               |
    | desativado        | booleano                 | Se `verdadeiro`, o botão de rádio está desativado e não clicável                                   |
    | posição do rótulo | string                   | A posição do texto do rótulo em relação ao botão de rádio. Tem duas opções: `esquerda` e `direita` |
  </Tab>
</Tabs>

## Grupo de Rádio

Agrupa juntos botões de rádio relacionados.

<Tabs>
  <Tab title="Uso">
    ```jsx
    import React, { useState } from "react";
    import { Radio, RadioGroup } from "twenty-ui/display";

    export const MyComponent = () => {

      const [selectedValue, setSelectedValue] = useState("Option 1");

      const handleChange = (event) => {
        setSelectedValue(event.target.value);
      };
      
      return (
        <RadioGroup value={selectedValue} onChange={handleChange}>
          <Radio value="Option 1" />
          <Radio value="Option 2" />
          <Radio value="Option 3" />
        </RadioGroup>
      );
    };

    ```
  </Tab>

  <Tab title="Propriedades">
    | Propriedades  | Tipo              | Descrição                                                                               |
    | ------------- | ----------------- | --------------------------------------------------------------------------------------- |
    | valor         | string            | O valor do botão de rádio atualmente selecionado                                        |
    | onChange      | função            | A função de retorno de chamada disparada quando o botão de rádio é alterado             |
    | onValueChange | função            | A função de retorno de chamada disparada quando o valor selecionado no grupo muda.      |
    | filhos        | `React.ReactNode` | Permite que você passe componentes React (como Rádio) como filhos para o Grupo de Rádio |
  </Tab>
</Tabs>