diff --git a/docs/components/dropdown.md b/docs/components/dropdown.md index faa570a..9192fac 100644 --- a/docs/components/dropdown.md +++ b/docs/components/dropdown.md @@ -14,6 +14,8 @@ BitBlazor.Components A custom `ActivatorTemplate` can replace the built-in toggle button with any element while retaining the complete keyboard interaction model. +> **Requires interactive rendering.** Because the open/closed state is managed purely in C# (`@onclick` / `@onkeydown`) with no JavaScript fallback, `BitDropdown` only works under an interactive render mode (Server, WebAssembly, or Auto). Under static SSR the activator button cannot be toggled, so the menu can never open — even though `BitDropdownItem.Href` values still render as valid links. This also applies to any component that renders a `BitDropdown` internally, such as `BitPagination`'s `ShowChanger` feature (see [pagination.md](./pagination.md)). + ## Components | Component | Description | diff --git a/docs/components/pagination.md b/docs/components/pagination.md index 2b0b724..a345082 100644 --- a/docs/components/pagination.md +++ b/docs/components/pagination.md @@ -12,7 +12,9 @@ BitBlazor.Components The Pagination component enables users to navigate through large data sets split across multiple pages. It renders previous/next buttons, individual page links with optional ellipsis truncation, and optional extras such as a jump-to-page input and a total-items summary. Two view modes are available: the default full control and a compact simple mode. -`BitPagination` supports both **interactive** and **static SSR** render modes. In interactive mode, page changes are handled via two-way binding with `@bind-Page`. In SSR mode, supply a `PageLinkGenerator` to render real `` links that trigger full browser navigation — no JavaScript required. +`BitPagination` supports both **interactive** and **static SSR** render modes for page navigation. In interactive mode, page changes are handled via two-way binding with `@bind-Page`. In SSR mode, supply a `PageLinkGenerator` to render real `` links that trigger full browser navigation — no JavaScript required. + +> **The page size changer (`ShowChanger`) requires interactive rendering.** It is rendered with [`BitDropdown`](./dropdown.md), which manages its open/closed state entirely in C# with no href-based fallback. Setting `PageLinkGenerator` produces valid links for each page size option, but the dropdown menu itself cannot be opened under static SSR — it needs an interactive render mode (Server, WebAssembly, or Auto). ## Parameters @@ -22,7 +24,7 @@ The Pagination component enables users to navigate through large data sets split | `Description` | `string` | ✓ | `""` | Text placed in the `aria-label` of the wrapping `