Skip to content

docs: update breadcrumbs spec to list all variants, reorder tasks, fix i18n#11912

Merged
web-padawan merged 3 commits into
mainfrom
docs/breadcrumbs-flow-spec-theme-variants-i18n
Jun 11, 2026
Merged

docs: update breadcrumbs spec to list all variants, reorder tasks, fix i18n#11912
web-padawan merged 3 commits into
mainfrom
docs/breadcrumbs-flow-spec-theme-variants-i18n

Conversation

@web-padawan

Copy link
Copy Markdown
Member

Validates the breadcrumbs Flow spec against the current flow-components guidelines and reflects the web component's new theme="slash" separator variant.

  • Theme variantsBreadcrumbs now implements HasThemeVariant<BreadcrumbsVariant> with SLASH("slash") (planned LUMO_PRIMARY / AURA_ACCENT), per guidelines/09-theming.md. Reverses the earlier "no theme variants" decision now that the web component ships theme="slash".
  • i18nsetI18n rejects null via Objects.requireNonNull (guidelines/10-i18n-and-a11y.md) instead of treating null as a reset; the unset/defaults state is the pre-setI18n state.
  • Task reordering — theme variants (Task 3) and i18n (Task 4) move ahead of the Flow-core-gated tasks, and the flow-components-bom Flow-version bump moves from Task 1 to Task 6 (the first task needing PR #24186 / @RouteParent / RouteHierarchy), so the guideline-only work can proceed while those APIs are in flight.
  • Web component API doc — documents the theme="slash" variant in the separator section.
  • Dedup — each new fact has one canonical home (Theme Variants / i18n sections) with cross-references; Discussion entries added for every behavior change, bodies kept current-state-only.

🤖 Generated with Claude Code

@web-padawan
web-padawan removed the request for review from sissbruecker June 11, 2026 07:04
web-padawan and others added 2 commits June 11, 2026 10:09
Expose the web component's theme="slash" separator variant through the Flow
wrapper, align the i18n setter with the theming guidelines, and reorder the
Flow tasks so the work that needs no unreleased Flow core API can land first.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Add a "Defined in" column and the primary (Lumo) and accent (Aura) variants
to the theme table, cross-referencing the --vaadin-breadcrumbs-link-color
Discussion entry for the rationale.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@web-padawan web-padawan changed the title docs: add Flow theme variants and align i18n in breadcrumbs spec docs: update breadcrumbs spec to list all variants, reorder tasks, fix i18n Jun 11, 2026
The theme="primary" (Lumo) and theme="accent" (Aura) variants ship in
web-components on main, so BreadcrumbsVariant carries LUMO_PRIMARY and
AURA_ACCENT as real values alongside SLASH instead of documenting them as
planned. Updates the enum, token table, KDD, Discussion, the Flow API doc,
and Task 3.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@web-padawan
web-padawan force-pushed the docs/breadcrumbs-flow-spec-theme-variants-i18n branch from aea2746 to d82f16e Compare June 11, 2026 07:15
@sonarqubecloud

Copy link
Copy Markdown

@web-padawan
web-padawan merged commit aedcdf6 into main Jun 11, 2026
10 checks passed
@web-padawan
web-padawan deleted the docs/breadcrumbs-flow-spec-theme-variants-i18n branch June 11, 2026 07:18
@vaadin-bot

Copy link
Copy Markdown
Collaborator

This ticket/PR has been released with Vaadin 25.2.0-beta3.

ZheSun88 pushed a commit to vaadin/flow-components that referenced this pull request Jun 17, 2026
…9470)

## Description

Task 3 of the Breadcrumbs SDD - based on tasks reorder in
vaadin/web-components#11912.

Added `BreadcrumbsVariant` enum with `"slash"` variant and
`HasThemeVariant<BreadcrumbsVariant>`.

## Type of change

- Feature

Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
ZheSun88 pushed a commit to vaadin/flow-components that referenced this pull request Jun 17, 2026
## Description

Task 4 of the Breadcrumbs SDD - based on tasks reorder in
vaadin/web-components#11912.

Added `BreadcrumbsI18n` and `setI18n()` API for setting it reflecting
the web component `i18n` property.

## Type of change

- Feature

Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
ZheSun88 pushed a commit to vaadin/flow-components that referenced this pull request Jun 17, 2026
#9483)

## Description

Fixes #9481

Task 5 of the Breadcrumbs SDD - based on tasks reorder in
vaadin/web-components#11912.

Added `Mode` enum with `ROUTER` and `MANUAL` and logic related to mode
switching.

## Type of change

- Feature

---------

Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
ZheSun88 pushed a commit to vaadin/flow-components that referenced this pull request Jun 17, 2026
…9485)

## Description

Fixes #9482

Depends on #9483

Task 6 of the Breadcrumbs SDD - based on tasks reorder in
vaadin/web-components#11912.

Added overrides to disallow manual children modifications when using
`Mode.ROUTER`.

## Type of change

- Feature

---------

Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants