diff options
Diffstat (limited to 'site/content/docs/5.3/migration.md')
| -rw-r--r-- | site/content/docs/5.3/migration.md | 71 |
1 files changed, 36 insertions, 35 deletions
diff --git a/site/content/docs/5.3/migration.md b/site/content/docs/5.3/migration.md index ab486c6..27dff45 100644 --- a/site/content/docs/5.3/migration.md +++ b/site/content/docs/5.3/migration.md @@ -349,20 +349,22 @@ For a complete list of changes, [see the v5.2.0 project on GitHub](https://githu Want more information? [Read the v5.1.0 blog post.](https://blog.getbootstrap.com/2021/08/04/bootstrap-5-1-0/) -<hr class="my-5"> +## v5.0.0 + +<hr class="mb-4"> {{< callout info >}} **Hey there!** Changes to our first major release of Bootstrap 5, v5.0.0, are documented below. They don't reflect the additional changes shown above. {{< /callout >}} -## Dependencies +### Dependencies - Dropped jQuery. - Upgraded from Popper v1.x to Popper v2.x. - Replaced Libsass with Dart Sass as our Sass compiler given Libsass was deprecated. - Migrated from Jekyll to Hugo for building our documentation -## Browser support +### Browser support - Dropped Internet Explorer 10 and 11 - Dropped Microsoft Edge < 16 (Legacy Edge) @@ -373,7 +375,7 @@ Want more information? [Read the v5.1.0 blog post.](https://blog.getbootstrap.co <hr class="my-5"> -## Documentation changes +### Documentation changes - Redesigned homepage, docs layout, and footer. - Added [new Parcel guide]({{< docsref "/getting-started/parcel" >}}). @@ -385,7 +387,7 @@ Want more information? [Read the v5.1.0 blog post.](https://blog.getbootstrap.co - Redesigned the navbar and added a new subnav to make it easier to get around our sites and docs versions. - Added new keyboard shortcut for the search field: <kbd><kbd>Ctrl</kbd> + <kbd>/</kbd></kbd>. -## Sass +### Sass - We've ditched the default Sass map merges to make it easier to remove redundant values. Keep in mind you now have to define all values in the Sass maps like `$theme-colors`. Check out how to deal with [Sass maps]({{< docsref "/customize/sass#maps-and-loops" >}}). @@ -423,7 +425,7 @@ Want more information? [Read the v5.1.0 blog post.](https://blog.getbootstrap.co - The `border-radius()` mixin now has a default value. -## Color system +### Color system - The color system which worked with `color-level()` and `$theme-color-interval` was removed in favor of a new color system. All `lighten()` and `darken()` functions in our codebase are replaced by `tint-color()` and `shade-color()`. These functions will mix the color with either white or black instead of changing its lightness by a fixed amount. The `shift-color()` will either tint or shade a color depending on whether its weight parameter is positive or negative. [See #30622](https://github.com/twbs/bootstrap/pull/30622) for more details. @@ -433,7 +435,7 @@ Want more information? [Read the v5.1.0 blog post.](https://blog.getbootstrap.co - To support our color system, we've added new custom `tint-color()` and `shade-color()` functions to mix our colors appropriately. -## Grid updates +### Grid updates - **New breakpoint!** Added new `xxl` breakpoint for `1400px` and up. No changes to all other breakpoints. @@ -453,7 +455,7 @@ Want more information? [Read the v5.1.0 blog post.](https://blog.getbootstrap.co - Updated the `make-col` mixin to default to equal columns without a specified size. -## Content, Reboot, etc +### Content, Reboot, etc - **[RFS]({{< docsref "/getting-started/rfs" >}}) is now enabled by default.** Headings using the `font-size()` mixin will automatically adjust their `font-size` to scale with the viewport. _This feature was previously opt-in with v4._ @@ -485,11 +487,11 @@ Want more information? [Read the v5.1.0 blog post.](https://blog.getbootstrap.co - Added `$enable-smooth-scroll`, which applies `scroll-behavior: smooth` globally—except for users asking for reduced motion through `prefers-reduced-motion` media query. [See #31877](https://github.com/twbs/bootstrap/pull/31877) -## RTL +### RTL - Horizontal direction specific variables, utilities, and mixins have all been renamed to use logical properties like those found in flexbox layouts—e.g., `start` and `end` in lieu of `left` and `right`. -## Forms +### Forms - **Added new floating forms!** We've promoted the Floating labels example to fully supported form components. [See the new Floating labels page.]({{< docsref "/forms/floating-labels" >}}) @@ -520,21 +522,21 @@ Want more information? [Read the v5.1.0 blog post.](https://blog.getbootstrap.co <hr class="my-5"> -## Components +### Components - Unified `padding` values for alerts, breadcrumbs, cards, dropdowns, list groups, modals, popovers, and tooltips to be based on our `$spacer` variable. [See #30564](https://github.com/twbs/bootstrap/pull/30564). -### Accordion +#### Accordion - Added [new accordion component]({{< docsref "/components/accordion" >}}). -### Alerts +#### Alerts - Alerts now have [examples with icons]({{< docsref "/components/alerts#icons" >}}). - Removed custom styles for `<hr>`s in each alert since they already use `currentColor`. -### Badges +#### Badges - <span class="badge bg-danger">Breaking</span> Dropped all `.badge-*` color classes for background utilities (e.g., use `.bg-primary` instead of `.badge-primary`). @@ -544,13 +546,13 @@ Want more information? [Read the v5.1.0 blog post.](https://blog.getbootstrap.co - Increased default padding for badges from `.25em`/`.5em` to `.35em`/`.65em`. -### Breadcrumbs +#### Breadcrumbs - Simplified the default appearance of breadcrumbs by removing `padding`, `background-color`, and `border-radius`. - Added new CSS custom property `--bs-breadcrumb-divider` for easy customization without needing to recompile CSS. -### Buttons +#### Buttons - <span class="badge bg-danger">Breaking</span> **[Toggle buttons]({{< docsref "/forms/checks-radios#toggle-buttons" >}}), with checkboxes or radios, no longer require JavaScript and have new markup.** We no longer require a wrapping element, add `.btn-check` to the `<input>`, and pair it with any `.btn` classes on the `<label>`. [See #30650](https://github.com/twbs/bootstrap/pull/30650). _The docs for this has moved from our Buttons page to the new Forms section._ @@ -562,7 +564,7 @@ Want more information? [Read the v5.1.0 blog post.](https://blog.getbootstrap.co - Disabled buttons now have `pointer-events: none;`. -### Card +#### Card - <span class="badge bg-danger">Breaking</span> Dropped `.card-deck` in favor of our grid. Wrap your cards in column classes and add a parent `.row-cols-*` container to recreate card decks (but with more control over responsive alignment). @@ -570,13 +572,13 @@ Want more information? [Read the v5.1.0 blog post.](https://blog.getbootstrap.co - <span class="badge bg-danger">Breaking</span> Replaced the `.card` based accordion with a [new Accordion component]({{< docsref "/components/accordion" >}}). -### Carousel +#### Carousel - Added new [`.carousel-dark` variant]({{< docsref "/components/carousel#dark-variant" >}}) for dark text, controls, and indicators (great for lighter backgrounds). - Replaced chevron icons for carousel controls with new SVGs from [Bootstrap Icons]({{< param "icons" >}}). -### Close button +#### Close button - <span class="badge bg-danger">Breaking</span> Renamed `.close` to `.btn-close` for a less generic name. @@ -584,11 +586,11 @@ Want more information? [Read the v5.1.0 blog post.](https://blog.getbootstrap.co - Added new `.btn-close-white` variant that uses `filter: invert(1)` to enable higher contrast dismiss icons against darker backgrounds. -### Collapse +#### Collapse - Removed scroll anchoring for accordions. -### Dropdowns +#### Dropdowns - Added new `.dropdown-menu-dark` variant and associated variables for on-demand dark dropdowns. @@ -606,46 +608,46 @@ Want more information? [Read the v5.1.0 blog post.](https://blog.getbootstrap.co - Dropdowns now support `.dropdown-item`s wrapped in `<li>`s. -### Jumbotron +#### Jumbotron - <span class="badge bg-danger">Breaking</span> Dropped the jumbotron component as it can be replicated with utilities. [See our new Jumbotron example for a demo.]({{< docsref "/examples/jumbotron" >}}) -### List group +#### List group - Added new [`.list-group-numbered` modifier]({{< docsref "/components/list-group#numbered" >}}) to list groups. -### Navs and tabs +#### Navs and tabs - Added new `null` variables for `font-size`, `font-weight`, `color`, and `:hover` `color` to the `.nav-link` class. -### Navbars +#### Navbars - <span class="badge bg-danger">Breaking</span> Navbars now require a container within (to drastically simplify spacing requirements and CSS required). - <span class="badge bg-danger">Breaking</span> The `.active` class can no longer be applied to `.nav-item`s, it must be applied directly on `.nav-link`s. -### Offcanvas +#### Offcanvas - Added the new [offcanvas component]({{< docsref "/components/offcanvas" >}}). -### Pagination +#### Pagination - Pagination links now have customizable `margin-left` that are dynamically rounded on all corners when separated from one another. - Added `transition`s to pagination links. -### Popovers +#### Popovers - <span class="badge bg-danger">Breaking</span> Renamed `.arrow` to `.popover-arrow` in our default popover template. - Renamed `whiteList` option to `allowList`. -### Spinners +#### Spinners - Spinners now honor `prefers-reduced-motion: reduce` by slowing down animations. [See #31882](https://github.com/twbs/bootstrap/pull/31882). - Improved spinner vertical alignment. -### Toasts +#### Toasts - Toasts can now be [positioned]({{< docsref "/components/toasts#placement" >}}) in a `.toast-container` with the help of [positioning utilities]({{< docsref "/utilities/position" >}}). @@ -653,7 +655,7 @@ Want more information? [Read the v5.1.0 blog post.](https://blog.getbootstrap.co - Removed `overflow: hidden` from toasts and replaced with proper `border-radius`s with `calc()` functions. -### Tooltips +#### Tooltips - <span class="badge bg-danger">Breaking</span> Renamed `.arrow` to `.tooltip-arrow` in our default tooltip template. @@ -661,10 +663,9 @@ Want more information? [Read the v5.1.0 blog post.](https://blog.getbootstrap.co - <span class="badge bg-danger">Breaking</span> Renamed `whiteList` option to `allowList`. -## Utilities +### Utilities - <span class="badge bg-danger">Breaking</span> Renamed several utilities to use logical property names instead of directional names with the addition of RTL support: - - Renamed `.left-*` and `.right-*` to `.start-*` and `.end-*`. - Renamed `.float-left` and `.float-right` to `.float-start` and `.float-end`. - Renamed `.border-left` and `.border-right` to `.border-start` and `.border-end`. - Renamed `.rounded-left` and `.rounded-right` to `.rounded-start` and `.rounded-end`. @@ -702,7 +703,7 @@ Want more information? [Read the v5.1.0 blog post.](https://blog.getbootstrap.co - Extended the `.visually-hidden-focusable` helper to also work on containers, using `:focus-within`. -## Helpers +### Helpers - <span class="badge bg-danger">Breaking</span> **Responsive embed helpers have been renamed to [ratio helpers]({{< docsref "/helpers/ratio" >}})** with new class names and improved behaviors, as well as a helpful CSS variable. - Classes have been renamed to change `by` to `x` in the aspect ratio. For example, `.ratio-16by9` is now `.ratio-16x9`. @@ -717,7 +718,7 @@ Want more information? [Read the v5.1.0 blog post.](https://blog.getbootstrap.co - `bootstrap-utilities.css` now also includes our helpers. Helpers don't need to be imported in custom builds anymore. -## JavaScript +### JavaScript - **Dropped jQuery dependency** and rewrote plugins to be in regular JavaScript. |