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

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.
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.