Skip to content

3lvia/designsystem / skills/elvia-design-system

elvia-design-system

Verified

Reference for UI components and patterns in Elvia's design system ("Elvis"). Covers component- and pattern-specific guidelines for sizing, color tokens for custom UI, types, ordering, labeling, accessibility attributes, CSS setup, and web-component registration. Use when building, reviewing, or fixing UI in an Elvia frontend, even if the request doesn't name Elvia or the CSS classes explicitly (e.g. "add a save button", "make this icon bigger", "add a tooltip").

FileKindSize
README.mdmarkdown726 B
SKILL.mdskill md10.4 KB
references/accordion.mdmarkdown5.9 KB
references/alert.mdmarkdown4.3 KB
references/app-bridge.mdmarkdown3.3 KB
references/autocomplete.mdmarkdown5.5 KB
references/badge.mdmarkdown2.3 KB
references/box.mdmarkdown2.0 KB
references/breadcrumb.mdmarkdown2.9 KB
references/button.mdmarkdown6.0 KB
references/card.mdmarkdown5.6 KB
references/carousel.mdmarkdown4.4 KB
references/checkbox.mdmarkdown4.7 KB
references/chip.mdmarkdown4.1 KB
references/color-tokens.mdmarkdown5.6 KB
references/content-loader.mdmarkdown2.0 KB
references/context-menu.mdmarkdown6.6 KB
references/data-formats.mdmarkdown2.1 KB
references/datepicker-range.mdmarkdown5.4 KB
references/datepicker.mdmarkdown6.0 KB
references/divider.mdmarkdown2.4 KB
references/drag-and-drop.mdmarkdown2.0 KB
references/dropdown.mdmarkdown6.7 KB
references/empty-state.mdmarkdown3.0 KB
references/file-upload.mdmarkdown2.6 KB
references/form-field.mdmarkdown2.7 KB
references/header.mdmarkdown5.8 KB
references/icon.mdmarkdown5.0 KB
references/illustrations.mdmarkdown1.4 KB
references/input.mdmarkdown2.5 KB
references/installation.mdmarkdown2.1 KB
references/link.mdmarkdown3.3 KB
references/list.mdmarkdown2.0 KB
references/modal.mdmarkdown6.1 KB
references/pagination.mdmarkdown4.0 KB
references/popover.mdmarkdown5.3 KB
references/progress-linear.mdmarkdown3.1 KB
references/radio-button.mdmarkdown2.6 KB
references/radio-filter.mdmarkdown2.8 KB
references/search-pattern.mdmarkdown2.7 KB
references/segmented-control.mdmarkdown3.9 KB
references/shadows.mdmarkdown1.3 KB
references/slider.mdmarkdown3.6 KB
references/stepper.mdmarkdown4.7 KB
references/table.mdmarkdown8.4 KB
references/tabs.mdmarkdown3.8 KB
references/tag.mdmarkdown5.0 KB
references/thumbnail.mdmarkdown1.9 KB
references/timepicker.mdmarkdown5.1 KB
references/toast.mdmarkdown3.4 KB
references/toggle.mdmarkdown2.1 KB
references/tooltip.mdmarkdown4.1 KB
references/typography.mdmarkdown3.3 KB
references/utility-classes.mdmarkdown3.9 KB
references/web-components.mdmarkdown2.1 KB

references/pagination.md

View on GitHub
[TOC]

- [Pagination (`<elvia-pagination>`)](#pagination-elvia-pagination)
  - [Reference](#reference)
  - [Installation](#installation)
  - [Use](#use)
  - [Attributes](#attributes)
    - [numberOfElements](#numberofelements)
    - [alignment](#alignment)
    - [ariaLabel](#arialabel)
    - [value](#value)
    - [valueOnChange](#valueonchange)
    - [dropdownItems](#dropdownitems)
    - [dropdownSelectedItemIndex](#dropdownselecteditemindex)
    - [dropdownSelectedItemIndexOnChange](#dropdownselecteditemindexonchange)
    - [dropdownMenuPosition](#dropdownmenuposition)
    - [lastNumberLimit](#lastnumberlimit)
    - [labelOptions](#labeloptions)
  - [Guidelines](#guidelines)
    - [When to use](#when-to-use)
    - [When not to use](#when-not-to-use)
  - [Accessibility](#accessibility)
  - [Examples](#examples)

# Pagination (`<elvia-pagination>`)

## Reference

https://design.elvia.io/components/pagination

`<elvia-pagination>` is a web component.

## Installation

This web component requires the `@elvia/elvis-pagination` package. If it is not installed, follow the
[Installation reference](./installation.md).

## Use

```html
<elvia-pagination ariaLabel="Orders" numberOfElements="100"></elvia-pagination>
```

Set `numberOfElements` to the total number of items.

For updates to attributes or properties after initialization, follow the shared
[attribute and property guidance](./web-components.md#attributes-and-properties).

## Attributes

### numberOfElements

Set the total number of items. Defaults to `0`.

### alignment

Set to `left` or `right`. Defaults to `left`.

### ariaLabel

Set a unique accessible name for the pagination navigation landmark.

### value

Set the visible range with `start` and `end` indexes. Indexes start at 1 and include both ends.

```js
pagination.value = { start: 21, end: 30 };
```

### valueOnChange

Listen for this event when the visible range changes. Its event value has `start` and `end` indexes. See
[Events](./web-components.md#events).

### dropdownItems

Set the page-size options as objects with string `value` and `label` fields. Use numeric values. Defaults to
10, 20, 30, and 40.

### dropdownSelectedItemIndex

Set the selected option by its zero-based index in `dropdownItems`. Defaults to `0`.

### dropdownSelectedItemIndexOnChange

Listen for this event when the selected page-size option changes. Its event value is the selected option's
zero-based index. See [Events](./web-components.md#events).

### dropdownMenuPosition

Set to `top`, `bottom`, or `auto`. Defaults to `bottom`.

### lastNumberLimit

Set a threshold for hiding the last page number. When `numberOfElements` equals or exceeds this value, the
last page number is hidden if the current page is more than three pages from the end.

### labelOptions

Override the labels for `displaying`, `of`, and `label`. The defaults depend on the page language.

## Guidelines

### When to use

- Use pagination to split a large set of content into pages.
- Use pagination with tables.

### When not to use

- Do not use pagination when all content fits on one page.

## Accessibility

- Set a unique `ariaLabel` for each pagination landmark on a page.
- Users can move through pagination controls with the Left and Right Arrow keys.
- Users can open the page-size dropdown and select a page number with Space or Enter.

## Examples

**Input:** Update the displayed item range when a user selects a page.

**Output:**

```html
<elvia-pagination id="pagination" ariaLabel="Orders" numberOfElements="52"></elvia-pagination>
```

```js
const pagination = document.querySelector('elvia-pagination');

pagination.addEventListener('valueOnChange', (event) => {
  console.log(event.detail.value);
});
```

**Input:** Set page-size options and custom labels.

**Output:**

```js
const pagination = document.querySelector('elvia-pagination');

pagination.dropdownItems = [
  { value: '25', label: '25' },
  { value: '50', label: '50' },
];
pagination.labelOptions = {
  displaying: 'Viser',
  of: 'av',
  label: 'fakturaer',
};
```
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 322kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 198kUpdated Claude CodeCodexVerifiedInstall