diff --git a/site/content/docs/4.3/migration.md b/site/content/docs/4.3/migration.md index 6e12ce721133..278abd6cf2f3 100644 --- a/site/content/docs/4.3/migration.md +++ b/site/content/docs/4.3/migration.md @@ -1,337 +1,83 @@ --- layout: docs -title: Migrating to v4 -description: Bootstrap 4 is a major rewrite of the entire project. The most notable changes are summarized below, followed by more specific changes to relevant components. +title: Migrating to v5 +description: Track and review changes to the Bootstrap source files, documentation, and components to help you migrate from v4 to v5. group: migration aliases: "/migration/" toc: true --- -## Stable changes +## Browser support -Moving from Beta 3 to our stable v4.x release, there are no breaking changes, but there are some notable changes. +See the browser and devices page for details on what is currently supported in Bootstrap 5. Since v4, here's what's changed to our browser support: -### Printing -- Fixed broken print utilities. Previously, using a `.d-print-*` class would unexpectedly overrule any other `.d-*` class. Now, they match our other display utilities and only apply to that media (`@media print`). +- Dropped support for Internet Explorer NN +- Dropped support for Firefox NN - MM +- Dropped support for Safari NN +- Dropped support for iOS Safari NN +- Dropped support for Chrome NN +- Dropped support for Android NN -- Expanded available print display utilities to match other utilities. Beta 3 and older only had `block`, `inline-block`, `inline`, and `none`. Stable v4 added `flex`, `inline-flex`, `table`, `table-row`, and `table-cell`. +## Sass -- Fixed print preview rendering across browsers with new print styles that specify `@page` `size`. +Changes to our source Sass files and compiled CSS. -## Beta 3 changes +- **Todo:** Remove previously deprecated mixins + - `float()` + - `form-control-mixin()` + - `retina-img()` + - `text-hide()` (also dropped the associated utility class, `.text-hide`) + - `visibility()` +- **Todo:** New variables? +- **Todo:** Rearrange forms source files (under `scss/forms/`) +- **Todo:** Rearrange grid source files (under `scss/grid/`) -While Beta 2 saw the bulk of our breaking changes during the beta phase, but we still have a few that needed to be addressed in the Beta 3 release. These changes apply if you're updating to Beta 3 from Beta 2 or any older version of Bootstrap. +## JavaScript -### Miscellaneous +Changes to our source and compiled JavaScript files. -- Removed the unused `$thumbnail-transition` variable. We weren't transitioning anything, so it was just extra code. -- The npm package no longer includes any files other than our source and dist files; if you relied on them and were running our scripts via the `node_modules` folder, you should adapt your workflow. +- Dropped jQuery dependency and rewrote plugins to be in regular JavaScript. -### Forms +## Grid and layout -- Rewrote both custom and default checkboxes and radios. Now, both have matching HTML structure (outer `
` with sibling `` and `