Pagination Facet

Pagination Facet controls the current page for a target. It renders hidden offset state and receives pagination metadata from facet responses.

Props

Group	Prop	Default	Meaning
Settings	target	empty	Shared target ID.
Settings	sibling_count	1	Numeric page buttons shown on each side of the current page.
Settings	tag	nav	Root wrapper tag.
Settings	aria_label	Pagination	Accessible navigation label.
Settings	hide_when_single_page	true	Hides pagination when only one page exists.
Settings	scroll_to_top	false	Scrolls to the target after pagination changes.
Labels	prev_label	Previous	Previous button label.
Labels	next_label	Next	Next button label.
Range	show_range	true	Shows the live range summary.
Range	range_label	Showing	Prefix for the range summary.
Styling	class, range_class	component defaults	Root and range summary classes.

Runtime Notes

• Pagination sends offset for the target.
• Responses update current page, total pages, total items, per-page, and offset.
• Changing a normal facet resets pagination to page 1.
• Pagination hides on zero results even when hide_when_single_page is false.

The multi-facet E2E scenario verifies pagination reset after a facet value changes.