Range

A range lets users choose an approximate value on a slider.

12.2.3

Patch Changes

  • Updated dependencies

12.2.2

Patch Changes

12.2.1

Patch Changes

12.2.0

Minor Changes

Patch Changes

  • Updated dependencies

12.1.1

Patch Changes

12.1.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.json exports subpaths 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

12.0.1

Patch Changes

  • Updated dependencies

12.0.0

Major Changes

  • f0bf5f838abd5, (opens new window) - Apply Volt entry-point and barrel-removal standards across these packages. Public exports now resolve directly to ./src/* implementations instead of intermediate ./src/entry-points/* re-exports.

    Migration

    Prefer published subpaths over the package root or internal entry-point paths:

    import Calendar from '@atlaskit/calendar/calendar'; import Drawer from '@atlaskit/drawer/drawer'; import { WidthObserver } from '@atlaskit/width-detector/width-observer'; import { DocumentViewer } from '@atlaskit/media-document-viewer/document-viewer';

    If you imported through internal entry-point modules, switch to the public subpath:

    -import Calendar from '@atlaskit/calendar/entry-points/calendar'; +import Calendar from '@atlaskit/calendar/calendar'; -import WidthObserver from '@atlaskit/width-detector/src/WidthObserver'; +import { WidthObserver } from '@atlaskit/width-detector/width-observer';

Patch Changes

  • Updated dependencies

11.1.2

Patch Changes

  • Updated dependencies

11.1.1

Patch Changes

  • Updated dependencies

11.1.0

Minor Changes

  • cd097a2111788, (opens new window) - Republish packages depending on @atlaskit/react-compiler-gating so their published dependency reference is updated to the renamed @atlaskit/react-compiler-gating scope.

    The earlier rename of @atlassian/react-compiler-gating to @atlaskit/react-compiler-gating only bumped the renamed package itself, so dependent packages were never republished and their published versions still referenced the old @atlassian/react-compiler-gating name, which is not available in the public npm registry. This minor bump republishes all affected packages with the corrected dependency.

Patch Changes

  • Updated dependencies

11.0.1

Patch Changes

11.0.0

Major Changes

  • f2dc9097319f0, (opens new window) - ### Dropped support for legacy Typescript 4 types. Typescript 5 is now the new minimum.

    Removes the typesVersions property and dist/types-ts4.5 directory from the dist.

    Types are now exclusively via the "types": "dist/types/index.d.ts" property.

    - "typesVersions": { - ">=4.5 <4.9": { - "*": [ - "dist/types-ts4.5/*", - "dist/types-ts4.5/index.d.ts" - ] - } - },

Patch Changes

  • Updated dependencies

10.1.2

Patch Changes

  • Updated dependencies

10.1.1

Patch Changes

  • Updated dependencies

10.1.0

Minor Changes

10.0.7

Patch Changes

  • Updated dependencies

10.0.6

Patch Changes

10.0.5

Patch Changes

  • Updated dependencies

10.0.4

Patch Changes

  • Updated dependencies

10.0.3

Patch Changes

10.0.2

Patch Changes

10.0.1

Patch Changes

10.0.0

Major Changes

Patch Changes

  • Updated dependencies

9.3.7

Patch Changes

  • Updated dependencies

9.3.6

Patch Changes

  • Updated dependencies

9.3.5

Patch Changes

9.3.4

Patch Changes

  • Updated dependencies

9.3.3

Patch Changes

  • Updated dependencies

9.3.2

Patch Changes

  • Updated dependencies

9.3.1

Patch Changes

  • Updated dependencies

9.3.0

Minor Changes

9.2.15

Patch Changes

  • Updated dependencies

9.2.14

Patch Changes

  • Updated dependencies

9.2.13

Patch Changes

  • Updated dependencies

9.2.12

Patch Changes

  • Updated dependencies

9.2.11

Patch Changes

  • Updated dependencies

9.2.10

Patch Changes

9.2.9

Patch Changes

9.2.8

Patch Changes

9.2.7

Patch Changes

9.2.6

Patch Changes

  • Updated dependencies

9.2.5

Patch Changes

  • Updated dependencies

9.2.4

Patch Changes

9.2.3

Patch Changes

  • Updated dependencies

9.2.2

Patch Changes

9.2.1

Patch Changes

  • Updated dependencies

9.2.0

Minor Changes

9.1.5

Patch Changes

  • Updated dependencies

9.1.4

Patch Changes

  • Updated dependencies

9.1.3

Patch Changes

  • Updated dependencies

9.1.2

Patch Changes

9.1.1

Patch Changes

  • Updated dependencies

9.1.0

Minor Changes

9.0.4

Patch Changes

  • Updated dependencies

9.0.3

Patch Changes

9.0.2

Patch Changes

  • Updated dependencies

9.0.1

Patch Changes

9.0.0

Major Changes

Patch Changes

  • Updated dependencies

8.2.0

Minor Changes

Patch Changes

  • Updated dependencies

8.1.2

Patch Changes

  • Updated dependencies

8.1.1

Patch Changes

  • Updated dependencies

8.1.0

Minor Changes

Patch Changes

  • Updated dependencies

8.0.2

Patch Changes

  • Updated dependencies

8.0.1

Patch Changes

8.0.0

Major Changes

  • #172418, (opens new window) 8a5e8d3d28432, (opens new window) - Migrated from @emotion/react to @compiled/react in order to improve performance, align with the rest of the Atlaskit techstack, and support React 18 Streaming SSR. Please note, in order to use this version of @atlaskit/range, you will need to ensure that your bundler is configured to handle .css imports correctly. Most bundlers come with built-in support for .css imports, so you may not need to do anything. If you are using a different bundler, please refer to the documentation for that bundler to understand how to handle .css imports. For more information on the migration, please refer to RFC-73 Migrating our components to Compiled CSS-in-JS, (opens new window).

7.4.5

Patch Changes

7.4.4

Patch Changes

  • Updated dependencies

7.4.3

Patch Changes

  • Updated dependencies

7.4.2

Patch Changes

  • Updated dependencies

7.4.1

Patch Changes

  • Updated dependencies

7.4.0

Minor Changes

  • #127511, (opens new window) db30e29344013, (opens new window) - Widening range of react and react-dom peer dependencies from ^16.8.0 || ^17.0.0 || ~18.2.0 to the wider range of ``^16.8.0 || ^17.0.0 || ^18.0.0` (where applicable).

    This change has been done to enable usage of react@18.3 as well as to have a consistent peer dependency range for react and react-dom for /platform packages.

Patch Changes

  • Updated dependencies

7.3.1

Patch Changes

7.3.0

Minor Changes

7.2.0

Minor Changes

7.1.8

Patch Changes

7.1.7

Patch Changes

7.1.6

Patch Changes

7.1.5

Patch Changes

7.1.4

Patch Changes

7.1.3

Patch Changes

7.1.2

Patch Changes

7.1.1

Patch Changes

7.1.0

Minor Changes

Patch Changes

  • Updated dependencies

7.0.4

Patch Changes

7.0.3

Patch Changes

  • Updated dependencies

7.0.2

Patch Changes

  • Updated dependencies

7.0.1

Patch Changes

  • Updated dependencies

7.0.0

Major Changes

  • #25860, (opens new window) 78741dd1644, (opens new window) - [ux] Breaking visual changes to range to afford better contrast:
    • The scrubber now applies the same color as the foreground
    • The disabled state has been altered; it's now a consistently applied opacity state overlay across the whole element
    • The input now uses :focus-visible, rather than :focus and applies an offset focus ring

6.1.1

Patch Changes

6.1.0

Minor Changes

6.0.9

Patch Changes

6.0.8

Patch Changes

6.0.7

Patch Changes

6.0.6

Patch Changes

6.0.5

Patch Changes

  • Updated dependencies

6.0.4

Patch Changes

6.0.3

Patch Changes

  • Updated dependencies

6.0.2

Patch Changes

  • Updated dependencies

6.0.1

Patch Changes

  • Updated dependencies

6.0.0

Major Changes

  • #18526, (opens new window) 17d9edaa415, (opens new window) - In preparation for compiled adoption, internal styling has been rewritten to remove dynamic styles. This includes custom theming using the theme prop, which has been removed.

    If you are not using the theme prop, there should be no breaking changes.

5.1.4

Patch Changes

5.1.3

Patch Changes

  • Updated dependencies

5.1.2

Patch Changes

5.1.1

Patch Changes

5.1.0

Minor Changes

  • #14777, (opens new window) 21c178539a2, (opens new window) - [ux] Instrumented range with the new theming package, @atlaskit/tokens.

    New tokens will be visible only in applications configured to use the new Tokens API (currently in alpha). These changes are intended to be interoperable with the legacy theme implementation. Legacy dark mode users should expect no visual or breaking changes.

Patch Changes

  • Updated dependencies

5.0.11

Patch Changes

  • Updated dependencies

5.0.10

Patch Changes

5.0.9

Patch Changes

5.0.8

Patch Changes

5.0.7

Patch Changes

5.0.6

Patch Changes

5.0.5

Patch Changes

5.0.4

Patch Changes

5.0.3

Patch Changes

  • Updated dependencies

5.0.2

Patch Changes

5.0.1

Patch Changes

5.0.0

Major Changes

Patch Changes

  • Updated dependencies

4.0.1

Patch Changes

4.0.0

Major Changes

  • #2137, (opens new window) da1c8c16d4, (opens new window) - In this version we made range dramatically faster and lighter 🤩

    Changes

    In 4.0.0 we bring significant performance improvements all for just the cost of 1 breaking change 😮. That's not all folks because this update comes with a 🤑 FREE 🤑 codemod for you to upgrade with.

    • Range no longer has a peerDependency on styled-components@3. Internally range is now using @emotion/core for styling
    • A performance issue made the range noticeably laggy with large ranges. With this change we are no longer creating new classes on each step change and instead updating a css variable, making Range noticeably smoother.
    • Changed the inputRef prop to be ref which returns the ref of the range input using React.forwardRef. This new ref prop will accept the type of the old inputRef prop, (input?: HTMLInputElement) => any, as well as if ref is created with React.createRef.
    • A new example that shows off how to rate limit your onChange event

    Automatic upgrading

    # You first need to have the latest range installed before you can run the codemod yarn upgrade @atlaskit/range@^4.0.0 # Run the codemod cli # Pass in a parser for your codebase npx @atlaskit/codemod-cli /path/to/target/directory --parser [tsx | flow | babel]

    Notes

    • You first need to upgrade to 4.0.0 before you run the codemod cli. This is because the cli will look in your local node_modules for the codemod which is published inside the spinner package.
    • The codemod is pretty clever, and will respect aliasing as well as using custom naming for the default import

    Ez pz lemon squeezy

    The codemod will change the inputRef prop to ref

    - <Range inputRef={inputRef} /> + <Range ref={inputRef} /> - <Range - inputRef={ref => { - myRangeRef = ref; - }} - /> + <Range + ref={ref => { + myRangeRef = ref; + }} + />

3.0.12

Patch Changes

3.0.11

Patch Changes

3.0.10

Patch Changes

3.0.9

Patch Changes

3.0.8

3.0.7

Patch Changes

  • [patch]097b696613, (opens new window):

    Components now depend on TS 3.6 internally, in order to fix an issue with TS resolving non-relative imports as relative imports

3.0.6

Patch Changes

3.0.5

Patch Changes

3.0.4

Patch Changes

3.0.3

Patch Changes

3.0.2

3.0.1

Patch Changes

3.0.0

Major Changes

  • [major]4a08d1912e, (opens new window):

    @atlaskit/range has been converted to Typescript. Typescript consumers will now get static type safety. Flow types are no longer provided. No API or behavioural changes.

2.0.2

2.0.1

2.0.0

  • [major]7c17b35107, (opens new window):
    • Updates react and react-dom peer dependencies to react@^16.8.0 and react-dom@^16.8.0. To use this package, please ensure you use at least this version of react and react-dom.

1.0.0

0.2.2

0.2.1

0.2.0

  • [minor]76299208e6, (opens new window):

    • Drop ES5 from all the flow modules

    Dropping CJS support in all @atlaskit packages

    As a breaking change, all @atlaskit packages will be dropping cjs distributions and will only distribute esm. This means all distributed code will be transpiled, but will still contain import and export declarations.

    The major reason for doing this is to allow us to support multiple entry points in packages, e.g:

    import colors from `@atlaskit/theme/colors`;

    Previously this was sort of possible for consumers by doing something like:

    import colors from `@atlaskit/theme/dist/esm/colors`;

    This has a couple of issues. 1, it treats the file system as API making internal refactors harder, we have to worry about how consumers might be using things that aren't actually supposed to be used. 2. We are unable to do this internally in @atlaskit packages. This leads to lots of packages bundling all of theme, just to use a single color, especially in situations where tree shaking fails.

    To support being able to use multiple entrypoints internally, we unfortunately cannot have multiple distributions as they would need to have very different imports from of their own internal dependencies.

    ES Modules are widely supported by all modern bundlers and can be worked around in node environments.

    We may choose to revisit this solution in the future if we find any unintended condequences, but we see this as a pretty sane path forward which should lead to some major bundle size decreases, saner API's and simpler package architecture.

    Please reach out to #fabric-build (if in Atlassian) or create an issue in Design System Support, (opens new window) (for external) if you have any questions or queries about this.

0.1.3

0.1.2

0.1.1

  • [patch]d13242d, (opens new window):
    • Change API to experimental theming API to namespace component themes into separate contexts and make theming simpler. Update all dependant components.

0.1.0

Was this page helpful?
We use this feedback to improve our documentation.
© 2026 AtlassianTrademark, (opens new window)Privacy, (opens new window)License