# `m-checkbox`

A checkbox is an interactive component used to select or deselect an option, typically within a list of choices. It allows users to make multiple selections independently and is often accompanied by a label for clarity. Checkboxes are commonly used in forms, filters, settings, and preference selections to provide a simple and intuitive way to enable or disable specific options.

## Props

| Name | Description | Type | Default |
|------|-------------|------|---------|
| `id*` | A unique identifier for the checkbox, used to associate the label with the form element. | `string` |   |
| `name` | The name attribute for the checkbox element, typically used for form submission. | `string` |   |
| `label` | The text label displayed next to the checkbox. | `string` |   |
| `checked` | The checkbox's checked state. | `boolean` | `$bindable(false)` |
| `indeterminate` | Sets the checkbox to an indeterminate state (partially selected). | `boolean` |   |
| `isinvalid` | If `true`, applies an invalid state to the checkbox. | `boolean` |   |
| `disabled` | If `true`, disables the checkbox, making it non-interactive. | `boolean` |   |
| `indented` | If `true`, indent the checkbox. | `boolean` |   |

## Dependencies

### Used By

- [m-tile-selectable](../tileselectable/README.md)

### Graph

```mermaid
graph TD;
  m-tile-selectable --> m-checkbox
style m-checkbox fill:#008240,stroke:#333,stroke-width:4px
```
