# Radio List Facet

> Single-select list facet with optional built-in reset item.

<!-- Sources: src/Components/Facets/RadioListFacet/RadioListFacet.php; src/Components/Facets/RadioListFacetOption/RadioListFacetOption.php; src/Components/Facets/Shared/FacetQueryProperties.php; client/src/domains/facets/facets/radio-list-facet.ts; client/src/domains/facets/adapters/radio-list-facet-adapter.ts; tests/e2e/components/facets/radio-list-facet.spec.ts; tests/e2e/components/facets/options-behavior.spec.ts -->

# Radio List Facet

`Radio List Facet` is a single-select option list. It renders a `radiogroup`, stores the selected value in a hidden input, and can include a built-in reset item before authored options.

## Authoring Structure

```text
Radio List Facet
└── Radio List Facet Option
```

## Parent Props

| Group | Prop | Default | Meaning |
| --- | --- | --- | --- |
| Settings | `target` | empty | Shared target ID. |
| Settings | `argument_mode` | `default` | Single argument mode. |
| Settings | `target_multiple_query_arguments` | `false` | Enables mapped bundle mode. |
| Settings | `options_behavior` | `all` | Availability behavior. |
| Settings | `show_counts` | `false` | Enables dynamic counts. |
| Settings | `aria_label` | `Filter options` | Accessible name for the radiogroup. |
| Reset | `show_reset_option` | `false` | Adds a reset choice before authored options. |
| Reset | `reset_option_mode` | `radio` | Reset item presentation: `radio` or `button`. |
| Reset | `reset_label` | `Reset selection` | Reset item label. |
| Mode groups | mode-specific props | varies | See [Argument Modes](../argument-modes). |
| Styling | `class` | `ome-radio-list-facet-root-default` | Root list class. |

## Option Props

| Group | Prop | Default | Meaning |
| --- | --- | --- | --- |
| Content | `value` | empty | Sent value in single-argument mode. |
| Content | `label` | `Option` | Visible label. |
| Metadata | `key`, `value` | empty | Optional rows for custom JavaScript integrations. |
| Query Value Mappings | `mapping_key`, `value` | empty | Values used when parent mapped bundle mode is enabled. |
| Settings | `disabled` | `false` | Prevents selection. |
| Settings | `is_default` | `false` | Authored default or reset choice depending on reset setup. |
| Settings | `mode` | `radio` | Option presentation: `radio` or `button`. |
| Settings | `used_with_multiple_arguments` | `false` | Switches option authoring to query value mappings. |
| Settings | `count_display` | `inline` | Inline count text or separate count span. |
| Styling | option, button, indicator, label, count classes | component defaults | Option presentation classes. |

## Runtime Notes

- Only one option can be selected.
- The built-in reset option uses an empty value.
- `mode = button` changes presentation only; the facet remains single-select.
- The runtime manages `aria-checked`, roving focus, disabled state, selected state, and highlighted state.