UNPKG

@dnb/eufemia

Version:

DNB Eufemia Design System UI Library

119 lines (76 loc) 3.94 kB
--- title: 'v5.0' description: 'October, 30. 2019' version: 11.8.2 generatedAt: 2026-07-03T14:39:18.349Z checksum: 090b7d977ba4be5e2c4c04d199a30a4048416c59f443a56985df2f80629d9c40 --- # v5 - [Migration](#migration) - [Typography preparations](#typography-preparations) **(feature)** - [Number component](#number-component) **(feature)** - [Color changes](#color-changes) **(major change)** - [Icon changes](#icon-changes) **(major change)** - [ESM module format](#esm-module-format) **(major change)** - [UMD changes](#umd-changes) **(major change)** - [How to Install](#install) ## Migration v5 contains a couple of breaking changes. As a migration process, you can simply search your application for: - find `save_alt_01` and replace it with `save` - find `--color-cherry-red` or `--color-cherry-red-8` and replace it with `--color-fire-red` and `--color-fire-red-8` - find `dnb-ui-lib-icons.min.js` and replace it with `dnb-ui-icons.min.js` ## Typography preparations Soon we will have our own _DNB font_. This will have an impact on `font-family`, `font-size`, `font-weight` and `line-height`. To prepare for these changes, you can already today (since `v4.24`) use the now exposed properties for both: - [font-size](/uilib/typography/font-size) - [line-height](/uilib/typography/line-height) Previously, we had [font-weight](/uilib/typography/font-weight). Read more on how to make CSS vars (Custom Properties) [work on IE](/uilib/usage/customisation/styling/polyfill). ### The benefits? If you are using only properties to change actively your application typography, then a future update with changes will "automatically" happen, so you don't need to make manual code changes later. ### Properties as JS You can now also import all the main properties as a [JavaScript Object](/uilib/usage/customisation/styling/polyfill#css-in-js): ```js import properties from 'dnb-ui-lib/style/properties ``` ## Number component The new [Number component](/uilib/components/number-format) is a ready-to-use DNB number formatter. Use it wherever you have to display a number, a currency value, phone number, etc. Good reasons for why we have this are to: - standardize the formatting of numbers for all DNB applications. - and make numbers accessible to screen readers. ## Color changes - _Cherry Red_ will be replaced by _Fire Red_. - _Cherry Red 8%_ will be replaced by _Fire Red 8%_. You may check your application code and **replace** `cherry-red` with `fire-red`. ```css /* New */ color: var(--color-fire-red); color: var(--color-fire-red-8); /* Deprecated */ color: var(--color-cherry-red); color: var(--color-cherry-red-8); ``` ## Icon changes ```js /* New */ import { download } from 'dnb-ui-lib/icons/secondary' /* Removed */ import { error } from 'dnb-ui-lib/icons/primary' import { save_alt_01 } from 'dnb-ui-lib/icons/secondary' ``` ## ESM module format The `dnb-ui-lib` uses now `ESM` as the default module format. But every component is still compiled down to ES5. ### Do I have to make changes? **Most likely no**. The majority of applications / projects does not have to make changes. If you are in **Node.js** (SSR) land, [read more about CJS](/uilib/usage/first-steps/module-formats#commonjs-cjs). ### What is ESM good for? Your project is most likely already using `ESM` (import / export). Now that the `dnb-ui-lib` uses `ESM`, [tree shaking](/uilib/usage/first-steps/module-formats) is much easier to handle and most likely be handled out of the box by your application bundler of choice (e.g. [webpack](https://webpack.js.org) ([create-react-app](https://github.com/facebook/create-react-app)), [rollup.js](https://rollupjs.org/guide/en/) and [parcel.js](https://parceljs.org)). ## UMD changes The `UMD` package for icons `dnb-ui-lib-icons.min.js` got a new naming: - `dnb-ui-icons.min.js` ## Install To upgrade to v5 with NPM, use: ```bash $ npm i dnb-ui-lib@5 ``` _October, 30. 2019_