Bootstrap 5.3.x Upgrade Guide

Bootstrap 5.3.x Upgrade Guide

We will be upgrading our Bootstrap framework from the current version to Bootstrap 5.3.x across all campuses. This upgrade is necessary to maintain security, improve performance, and access the latest features and bug fixes. Please review the list of changes below and correct your website accordingly. If you would like to test your site prior to the rollout, please contact the Drupal ITS Team via Slack or email us at its.drupal.team@domail.maricopa.edu and we can set you up with a Multi-dev environment.

Current Bootstrap 5.2.x Specific Test Pages:
Typography:
https://drupal.maricopa.edu/resources/developer/bootstrap-typography-test
Element Test:
https://drupal.maricopa.edu/resources/developer/bootstrap-element-test
Tables:
https://drupal.maricopa.edu/resources/developer/bootstrap-table-test  

New Bootstrap 5.3.x Specific Test Pages:
Typography:
https://bootstrap53-mccd-drupal.pantheonsite.io/resources/developer/bootstrap-typography-test
Element Test:
https://bootstrap53-mccd-drupal.pantheonsite.io/resources/developer/bootstrap-element-test
Tables:
https://bootstrap53-mccd-drupal.pantheonsite.io/resources/developer/bootstrap-table-test  

 

Priority

Component/Area

Change Description

Action Required

Priority

Component/Area

Change Description

Action Required

Breaking

Components

.dropdown-menu-dark, .btn-close-white, .navbar-dark deprecated

Replace with data-bs-theme="dark"

Breaking

Components

Dark mode classes replaced by data-bs-theme="dark"

Update all dark mode implementations

Deprecated

Utilities

.text-muted deprecated

Replace with .text-body-secondary

Non-breaking

Color Modes

Dark mode colors now derived from theme colors

No action needed

Non-breaking

Components

.nav-underline variant added

Optional enhancement

Non-breaking

Components

Cards now have color property for dark mode

No action needed

Non-breaking

Utilities

Renamed ${color}-text${color}-text-emphasis

No action needed (backward compatible)

Non-breaking

Utilities

Added .icon-link, .border-black, overflow utilities

Optional new features

Non-breaking

Progress

.progress-stacked class added

Optional enhancement


Quick Actions Needed:

  • Search and replace all deprecated dark mode classes

  • Find and replace .text-muted with .text-body-secondary

For more information on what Bootstrap 5.3.x has to offer, please refer to the Bootstrap 5.3.x Migration Guide online.