Skip to content

docs: update Master-Detail Layout for 25.2 API changes#5449

Open
web-padawan wants to merge 2 commits intomainfrom
docs/bump-25.2-mdl
Open

docs: update Master-Detail Layout for 25.2 API changes#5449
web-padawan wants to merge 2 commits intomainfrom
docs/bump-25.2-mdl

Conversation

@web-padawan
Copy link
Copy Markdown
Member

@web-padawan web-padawan commented Apr 6, 2026

Summary

  • Update Master-Detail Layout docs and demos to align with the new 25.2 API
  • Replace masterMinSize/detailMinSize with expandingArea API
  • Replace overlayMode/stackOverlay with overlaySize
  • Replace forceOverlay with masterSize="100%"
  • Add new "Detail Placeholder" section with since badge
  • Add since badges for new 25.2 APIs (Expanding Area, Overlay Size)
  • Update styling page: remove [stack] state, rename [containment] to [overlay-containment], add [expand] states
  • Bump Vaadin to 25.2

Part of vaadin/web-components#11348

Test plan

  • Verify docs build successfully
  • Check live demos render correctly (basic and vertical)
  • Verify since badges render for new sections
  • Confirm no references to removed APIs remain

🤖 Generated with Claude Code

@web-padawan web-padawan requested a review from vursen April 6, 2026 06:43
@web-padawan web-padawan force-pushed the docs/bump-25.2-mdl branch 2 times, most recently from e4c3f6f to 3d05a0f Compare April 6, 2026 06:55
@github-actions
Copy link
Copy Markdown

github-actions bot commented Apr 6, 2026

Preview Deployment

This PR has been deployed for preview.

URL: https://docs-preview-pr-5449.fly.dev

Built from 117f48f

Update documentation and demos to align with the new
MasterDetailLayout API: replace masterMinSize/detailMinSize with
expandingArea, replace overlayMode/stackOverlay with overlaySize,
replace forceOverlay with masterSize="100%". Add detail placeholder
section. Bump Vaadin to 25.2.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-authored-by: Sergey Vinogradov <mr.vursen@gmail.com>
<MasterDetailLayout.Detail>
{selectedItem && <ItemDetail item={selectedItem} />}
</MasterDetailLayout.Detail>
<div slot="detail-placeholder">Select an item to see details</div>
Copy link
Copy Markdown
Contributor

@vursen vursen Apr 6, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This doesn't work as MasterDetailLayout only accepts subcomponents as children. I've created a PR to add a dedicated MasterDetailLayout.DetailPlaceholder subcomponent: vaadin/react-components#374

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants