UI: Replace experimental_SIDEBAR_BOTTOM
API with a status filter UI
#28693
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Closes #28680
What I did
I copied over the SidebarBottom filtering UI from the Visual Tests Addon and made it a core Storybook Manager component. It now shows warnings and errors from any addon, so that both the VTA and Vitest addon can use it. Compared to the VTA filter UI, "Changes" are now labeled "Warnings" because that's a more generic name and matches the actual story status we're filtering on. Functionally there is no difference.
The
experimental_SIDEBAR_BOTTOM
API is removed, though theAddon_TypesEnum
definition is marked deprecated but kept to prevent older VTA versions from breaking. Similarly,experimental_SIDEBAR_TOP
is marked deprecated. Defining aexperimental_SIDEBAR_BOTTOM
component simply doesn't do anything anymore. We can remove both enum types in Storybook 9.0.A new
SET_FILTER
event is emitted whenever a filter function is set (i.e. a filter is toggled). This can be used by the VTA's onboarding as it currently uses its own internal event. Unfortunately this means VTA onboarding will be broken when using an older VTA version with a newer Storybook version.Checklist for Contributors
Testing
The changes in this PR are covered in the following automated tests:
Manual testing
This section is mandatory for all contributions. If you believe no manual test is necessary, please state so explicitly. Thanks!
Documentation
MIGRATION.MD
Checklist for Maintainers
When this PR is ready for testing, make sure to add
ci:normal
,ci:merged
orci:daily
GH label to it to run a specific set of sandboxes. The particular set of sandboxes can be found incode/lib/cli/src/sandbox-templates.ts
Make sure this PR contains one of the labels below:
Available labels
bug
: Internal changes that fixes incorrect behavior.maintenance
: User-facing maintenance tasks.dependencies
: Upgrading (sometimes downgrading) dependencies.build
: Internal-facing build tooling & test updates. Will not show up in release changelog.cleanup
: Minor cleanup style change. Will not show up in release changelog.documentation
: Documentation only changes. Will not show up in release changelog.feature request
: Introducing a new feature.BREAKING CHANGE
: Changes that break compatibility in some way with current major version.other
: Changes that don't fit in the above categories.🦋 Canary release
This pull request has been released as version
0.0.0-pr-28693-sha-ed560db4
. Try it out in a new sandbox by runningnpx storybook@0.0.0-pr-28693-sha-ed560db4 sandbox
or in an existing project withnpx storybook@0.0.0-pr-28693-sha-ed560db4 upgrade
.More information
0.0.0-pr-28693-sha-ed560db4
sidebar-bottom-filters
ed560db4
1721821184
)To request a new release of this pull request, mention the
@storybookjs/core
team.core team members can create a new canary release here or locally with
gh workflow run --repo storybookjs/storybook canary-release-pr.yml --field pr=28693