Panel
Panel components provide a surface for contextual information alongside the main content area.Beta
New and ready to use. We'll provide comms and support for any major changes.
2.0.1
Patch Changes
2733f01e4e7f6, (opens new window) - Make the up and down panel navigation actions available without a feature gate.
2.0.0
Major Changes
87ab1d5ada9d4, (opens new window) - [ux] Move layout and resizing responsibilities to@atlaskit/navigation-system, while retaining panel state, saved width preferences and content rendering in@atlassian/panel-system. Ungate explicit controlledpanelWidthand initialdefaultPanelWidthprops. For an initial uncontrolled width, replacepanelWidthwithdefaultPanelWidth. For controlled resizing, passpanelWidthand accept width updates throughonPanelWidthChange. UpdateonResizeEndhandlers to receive{ initialWidth, finalWidth, mode }instead of a number. ProviderpanelWidthis now an optional saved preference, not the rendered width. Local-panel placement now fits the available space rather than using the previous viewport breakpoint, and resizing no longer uses the half-page limit. These changes apply regardless ofplatform-dst-chat-panel-layout.
Patch Changes
- Updated dependencies
1.15.0
Minor Changes
4f395068c4fe8, (opens new window) - Add PanelActionViewSwitcher with controlled ADS radio menu items for selecting panel views, leading view icons, and an optional New tab link.
1.14.3
Patch Changes
7ddc892892fda, (opens new window) - Gate panel content-switch motion behind platform-dst-motion-uplift-panel-content independently of panel open/close motion, and retain the navigation panel motion boundary when its content key is cleared.- Updated dependencies
1.14.2
Patch Changes
bd8355ce4adc8, (opens new window) - Refine chat and local panel resizing with directional cascading and responsive overlay behaviour. Lazy-load resize logic while preserving the initial layout during hydration.- Updated dependencies
1.14.1
Patch Changes
047d4954e93d1, (opens new window) - Add PanelActionUp and PanelActionDown.
1.14.0
Minor Changes
1644378b9dcd3, (opens new window) - Unify panel opening underopenPanel(options), replacing its positional arguments and removingreplacePanelandreplacePanelEntryPoint.
1.13.0
Minor Changes
af1727bb45fa8, (opens new window) - Add an optional sticky subheader content slot.
1.12.0
Minor Changes
31fd102f3ef90, (opens new window) - Add panelMinWidth and panelMaxWidth props to LayoutWithPanel and coordinate local-panel resizing and overlay behavior with navigation-system chat layouts behind the platform-dst-chat-panel-layout feature gate.
Patch Changes
- Updated dependencies
1.11.2
Patch Changes
- Updated dependencies
1.11.1
Patch Changes
- Updated dependencies
1.11.0
Minor Changes
be58adab5e42f, (opens new window) - Add controlled width toLayoutWithPanelviapanelWidthandonPanelWidthChange, enabling programmatic resizing after mount behind feature gateplatform-dst-panel-system-width-persistence.
Patch Changes
- Updated dependencies
1.10.4
Patch Changes
- Updated dependencies
1.10.3
Patch Changes
14307d3138fd3, (opens new window) - Refactor styles to use statically analyzable values and type-checked inline constants for Compiled and Atlaspack incremental builds, preserving existing styling behavior.- Updated dependencies
1.10.2
Patch Changes
5017f4bf49edf, (opens new window) - [ux] Adjusted main content to snap when 60% of the entry or exit animation of the panel and side nav have completed. Changes are behind theplatform-dst-motion-uplift-panelandplatform-dst-motion-uplift-sidenavfeature gates.- Updated dependencies
1.10.1
Patch Changes
- Updated dependencies
1.10.0
Minor Changes
c7333edc6dfa2, (opens new window) - Scope panel motion and exit persistence to LayoutWithPanel. Content replacements animate behind platform-dst-motion-uplift-panel while the panel shell remains mounted; standalone PanelsRenderer usage removes panels immediately. LayoutWithPanel owns its persistent slot mapping directly so PanelsRenderer retains its existing instanceId-keyed behavior.
Patch Changes
- Updated dependencies
1.9.5
Patch Changes
- Updated dependencies
1.9.4
Patch Changes
1cfdd8f6d54e6, (opens new window) - Behindplatform-dst-motion-uplift-panel,PanelSlotholdsposition: fixedfor the first 150ms of its enter animation, and its enter and exit animations are now disabled underprefers-reduced-motion: reduce.- Updated dependencies
1.9.3
Patch Changes
38c7085c92a3a, (opens new window) - Experimental React 19 peer dependency support. This patch widens the peer range; CI coverage is partial.- Updated dependencies
1.9.2
Patch Changes
613d77a51c317, (opens new window) - [ux] Panel on open snaps main content when animation end. On close the main content snaps on animation start. Changes are behind theplatform-dst-motion-uplift-panelfeature gate.
1.9.1
Patch Changes
- Use
@atlassian/testing-libraryexclusively in unit tests.
1.9.0
Minor Changes
-
d82e6f76528ab, (opens new window) - Add direct subpath package exports as part of the linking-platform, search, media, and design-system barrel-removal (de-barrel) migration.These packages now expose their individual modules via explicit
package.jsonexportssubpaths so that consumers can import directly from the leaf module (e.g.@atlaskit/pkg/thing) instead of the package barrel/index. This adds new public entry points without changing or removing any existing exports, so it is a backwards-compatible additive change.No runtime behaviour changes; this is an API-surface (entry-point) addition to support tree-shaking and to unblock removal of the barrel index files.
Patch Changes
- Updated dependencies
1.8.0
Minor Changes
0075efb228821, (opens new window) - Autofix: barrel removal (imports + exports)
Patch Changes
- Updated dependencies
1.7.1
Patch Changes
282726b37d912, (opens new window) - Trigger: when checking if a panel is open it will match against instanceId and params to ensure panels with different params still open.- Updated dependencies
1.7.0
Minor Changes
0195cea826a48, (opens new window) - Use directional motion tokens for RTL-aware panel slide animations. Adds newmotion.panel.content.enterandmotion.panel.content.exitmotion tokens, applied to the Panel to soften the content when opening and closing.
Patch Changes
- Updated dependencies
1.6.5
Patch Changes
- Updated dependencies
1.6.4
Patch Changes
d888190a11dcc, (opens new window) - Fixed an issue with LayoutWithPanel where main app content could overlap panel content.- Updated dependencies
1.6.3
Patch Changes
dd867480bf660, (opens new window) - Addedoverflow: hiddenrule to the layout (behind theplatform-dst-motion-uplift-panelgate) so that the panel transforming off screen no longer causesscroll bars to appear.- Updated dependencies
1.6.2
Patch Changes
- Updated dependencies
1.6.1
Patch Changes
- Updated dependencies
1.6.0
Minor Changes
95ff9f0742fb9, (opens new window) - Add panel enter/exit motion behind theplatform-dst-motion-uplift-panelfeature gate. When enabled,LayoutWithPanelpanels animate in/out viauseMotionandExitingPersistence.
Patch Changes
- Updated dependencies
1.5.3
Patch Changes
- Updated dependencies
1.5.2
Patch Changes
- Updated dependencies
1.5.1
Patch Changes
- Updated dependencies
1.5.0
Minor Changes
ca7886ed5840a, (opens new window) - Panel width is now saved in panel state automatically. LayoutWithPanel now closes the currently-open panel on unmount.
1.4.1
Patch Changes
- Updated dependencies
1.4.0
Minor Changes
2f56c78f969b8, (opens new window) - Update i18n NPM package versions for teamwork-graph (Group 16)
Patch Changes
- Updated dependencies
1.3.0
Minor Changes
5ad834eeed183, (opens new window) - Added new LayoutWithPanel component to provide an easy way to adopt the panel system. This component includes PanelsRenderer and PanelRouter, and handles styling and resize functionality automatically. It is designed to be used inside the Main component from@atlaskit/navigation-system. Also improved behaviour of rendering non-entrypoint panels.
Patch Changes
- Updated dependencies
1.2.0
Minor Changes
-
cd097a2111788, (opens new window) - Republish packages depending on@atlaskit/react-compiler-gatingso their published dependency reference is updated to the renamed@atlaskit/react-compiler-gatingscope.The earlier rename of
@atlassian/react-compiler-gatingto@atlaskit/react-compiler-gatingonly bumped the renamed package itself, so dependent packages were never republished and their published versions still referenced the old@atlassian/react-compiler-gatingname, which is not available in the public npm registry. This minor bump republishes all affected packages with the corrected dependency.
Patch Changes
- Updated dependencies
1.1.1
Patch Changes
ee28cf33718b0, (opens new window) - Add @atlaskit/react-compiler-gating as a runtime dependency to enable React Compiler platform gating.- Updated dependencies
1.1.0
Minor Changes
3a7da919cc41a, (opens new window) - Added default PanelSkeleton loading state alongside composable skeleton components to customise the loading experience: PanelHeaderSkeleton, PanelSubheaderSkeleton, PanelBodySkeleton, and PanelFooterSkeleton.
1.0.0
Major Changes
51222a09a4f15, (opens new window) - Implement new design.
0.9.1
Patch Changes
- Updated dependencies
0.9.0
Minor Changes
abe3c3d99949f, (opens new window) - Added entryPointProps prop to Trigger component to support runtime props. Improved EntryPoint reference saving to overwrite previously saved references with the same instanceId.
0.8.0
Minor Changes
6f83380baa12e, (opens new window) - Added ability to save entrypoint references without opening a panel. Fixed a double-scrolling bug in PanelBody. Forwarded refs to PanelActionBack.
0.7.3
Patch Changes
- Updated dependencies
0.7.2
Patch Changes
- Updated dependencies
0.7.1
Patch Changes
267b2bb06c564, (opens new window) - Internal dependency change: switch from pinned Relay v17 aliases to root:* and upgraded root to Relay v20.1.1. No public API changes.- Updated dependencies
0.7.0
Minor Changes
74f04d68a4ff6, (opens new window) - Autofix: add explicit package exports (barrel removal)
Patch Changes
- Updated dependencies
0.6.7
Patch Changes
- Updated dependencies
0.6.6
Patch Changes
- Updated dependencies
0.6.5
Patch Changes
02483200273ec, (opens new window) - Enrol all Design System UI packages into the React Compiler with platform gating via isReactCompilerActivePlatform.- Updated dependencies
0.6.4
Patch Changes
- Updated dependencies
0.6.3
Patch Changes
- Updated dependencies
0.6.2
Patch Changes
- Updated dependencies
0.6.1
Patch Changes
108d5a884925b, (opens new window) - Padding and spacing tweaks to PanelHeader. Removes left border from PanelContainer.
0.6.0
Minor Changes
32424b28cc2e2, (opens new window) - Added ability to load panels without EntryPoints.manager.replacePanelnow handles non-EntryPoint loading.manager.replacePanelEntryPointhandles EntryPoint loading.
0.5.4
Patch Changes
aa10cd8b0cde6, (opens new window) - Changes the icon for the PanelActionBack button from a chevron to an arrow.- Updated dependencies
0.5.3
Patch Changes
- Updated dependencies
0.5.2
Patch Changes
04b06e59f1d3c, (opens new window) - Enable PanelFooter height to extend based on content size.
0.5.1
Patch Changes
c6c4c00d03919, (opens new window) - Add tooltips for PanelAction icon buttons- Updated dependencies
0.5.0
Minor Changes
40859cd0c46b6, (opens new window) - Adds aspacingprop toPanelBody, enabling consumers to remove the default padding.
0.4.0
Minor Changes
be6cfa5787e59, (opens new window) - Add support for alabelprop in panel action component variants. Existing default labels are used as a fallback when no label is provided.
Patch Changes
- Updated dependencies
0.3.2
Patch Changes
- Updated dependencies
0.3.1
Patch Changes
- Updated dependencies
0.3.0
Minor Changes
c5d31e332b432, (opens new window) - AddonBeforeCloseprop to PanelActionClose to enable close event interception. Add explicitreplacePanelbehaviour. Improve typesafety and focus management.
0.2.6
Patch Changes
- Updated dependencies
0.2.5
Patch Changes
- Updated dependencies
0.2.4
Patch Changes
- Updated dependencies
0.2.3
Patch Changes
- Updated dependencies
0.2.2
Patch Changes
- Updated dependencies
0.2.1
Patch Changes
e11ffa2e46c84, (opens new window) - Add Trigger and PanelsRenderer, setting up Entrypoints/Relay integration.
0.2.0
Minor Changes
90e8d6ed6da4b, (opens new window) - Moved package into private scope.
0.1.0
Minor Changes
660aaf04cc6f2, (opens new window) - Deprecating this package to move into private scope.
0.0.12
Patch Changes
- Updated dependencies
0.0.11
Patch Changes
- Updated dependencies
0.0.10
Patch Changes
- Updated dependencies
0.0.9
Patch Changes
- Updated dependencies
0.0.8
Patch Changes
- Updated dependencies
0.0.7
Patch Changes
- Updated dependencies
0.0.6
Patch Changes
a52ec0b1c0791, (opens new window) - Add PanelSubheader component, improve styles.
0.0.5
Patch Changes
- Updated dependencies
0.0.4
Patch Changes
5bc5265a7d064, (opens new window) - Create simple PanelFooter component.
0.0.3
Patch Changes
2500a40cc74bc, (opens new window) - Create initial set of UI components.
0.0.2
Patch Changes
- Updated dependencies