# CanBeDisabled

> Provides an immutable API for the disabled attribute.

[API reference](/docs/api/index.md) › [HTML Attribute](/docs/extensions/html-attribute/reference/index.md) › CanBeDisabled

| trait | `UIAwesome\Html\Attribute\CanBeDisabled` |
| --- | --- |
| Source | [`src/CanBeDisabled.php`](https://github.com/ui-awesome/html-attribute/blob/main/src/CanBeDisabled.php#L16) |

Used by 8 types:

- [`UIAwesome\Html\Core\Element\BaseInput`](/docs/extensions/html-core/reference/element/baseinput/index.md)
- [`UIAwesome\Html\Form\Button`](/docs/extensions/html/reference/form/button/index.md)
- [`UIAwesome\Html\Form\Fieldset`](/docs/extensions/html/reference/form/fieldset/index.md)
- [`UIAwesome\Html\Form\Optgroup`](/docs/extensions/html/reference/form/optgroup/index.md)
- [`UIAwesome\Html\Form\Option`](/docs/extensions/html/reference/form/option/index.md)
- [`UIAwesome\Html\Form\Select`](/docs/extensions/html/reference/form/select/index.md)
- [`UIAwesome\Html\Form\TextArea`](/docs/extensions/html/reference/form/textarea/index.md)
- [`UIAwesome\Html\Metadata\Link`](/docs/extensions/html/reference/metadata/link/index.md)

Provides an immutable API for the `disabled` attribute.

See also: <https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Attributes/disabled>.

## Methods

| Method | Description | Defined by |
| --- | --- | --- |
| [`disabled()`](#method-disabled) | Sets the `disabled` attribute. | `CanBeDisabled` |

## Method details

### disabled() <span id="method-disabled"></span>

```php
public function disabled(bool|null $value): static
```

Sets the `disabled` attribute.

**Parameters**

| Parameter | Type | Description |
| --- | --- | --- |
| `$value` | `bool\|null` | Disabled state. Use `true` to disable, `false` to enable, or `null` to remove the attribute. |

**Returns**

`static`: New instance with the updated `disabled` attribute.