Backwards Compatibility

Overview

Although backwards compatibility is included for some components and utilities available in Arizona Bootstrap 2, it is highly recommended that you utilize the new classes available in Arizona Bootstrap 5. They are simply included here to lessen the burden on site builders for migrating from Drupal sites using Arizona Bootstrap 2 to sites using Arizona Bootstrap 5.

All items that are included with backwards compatibility are built by extending the classes and styles available in Arizona Bootstrap 5. Any items that were marked as “deprecated” in Arizona Bootstrap 2 do not include backwards compatibility; these items are listed in the Removed Utility Classes and Removed Components sections.

For information on changes made in upstream Bootstrap 5, see the Migration page.

Backwards Compatible Components

Arizona Bootstrap 2 utilized components that are no longer supported/maintained in Arizona Bootstrap , but can be replicated by utilizing a combination of available classes. They have been included with backwards compatibility in Arizona Bootstrap 5 to avoid breaking changes.

Badges

Arizona Bootstrap 5 largely follows upstream Bootstrap’s changes to badges. The badge-variant() mixin override from Arizona Bootstrap 2 has been removed since badges will now use color and background helpers to ensure accessible color combinations. The .badge-link class dropped by upstream Bootstrap has been converted to a custom Arizona Bootstrap class that works with badges using the Chili, Midnight, and Light color and background helpers.

Deprecated Components

The following components are deprecated in Arizona Bootstrap 5 and will be removed in the next major version.

Accordion Implementation

Arizona Bootstrap 2 used the card component to extend the default collapse behavior and create an accordion. To properly achieve the accordion style, a custom class .accordion was also needed as a wrapper. In Arizona Bootstrap 5, the accordion component is natively provided by Bootstrap. Site owners who have used accordions in their Arizona Bootstrap 2 sites are encouraged to review relevant HTML and update to the latest implementation.

Arizona Header Classes

These custom Arizona Bootstrap classes for the Arizona Header are now deprecated:

• .block-a-line-logo: This class has no replacement. Instead, the .arizona-line-logo class should be used with the appropriate logo image.
• .redbar-buttons: This class has no replacement (the element now uses standard Arizona Bootstrap classes instead).
• .btn-redbar: This class has been replaced with .btn-arizona-header.

For both of these deprecated classes, the original CSS has been preserved. However, if these classes are used with the Arizona Header on a Quickstart 3 site, it will not be displayed correctly due to updates to the markup.

Card Classes

These custom Arizona Bootstrap classes are now deprecated:

• .card-borderless: This class can be replaced with .border-0.
• .card-clickable and .card-clickable-link: These classes can be replaced with styling using the standard Stretched Link helper along with our custom Hover utilities. See the examples on the Card page.
• .card-landing-grid and .landing-$color: The “landing grid” card style from Arizona Bootstrap 2 has been deprecated and should no longer be used.

Nav Tabs Large

The .nav-tabs-lg custom Arizona Bootstrap class is now deprecated.

UL Triangles

The .ul-triangles custom Arizona Bootstrap class has been deprecated and replaced by .az-list-triangles.

Deprecated Utilities

The following utilities are deprecated in Arizona Bootstrap 5 and will be removed in the next major version.

Border Thick

The .border-thick custom Arizona Bootstrap class has been deprecated. The .border-4 class from the new border width utilities can be used as a direct replacement.

Removed Components

The following components have been removed in Arizona Bootstrap 5.

Background Wrapper Patterns

The Triangles Fade, Triangle Mosaic, and Catalinas Abstract background wrapper patterns were deprecated in Arizona Bootstrap 2 and have been removed in Arizona Bootstrap 5.

Callout Variants

For our custom Callouts component, the following callout variants have been removed:

• .callout-leaf
• .callout-river
• .callout-silver
• .callout-mesa
• .callout-light
• .callout-dark

Navbar Off Canvas

The Navbar Off Canvas component custom to Arizona Bootstrap has been removed. This component is no longer used in Arizona Quickstart. Instead of displaying a single nav in different ways for mobile and desktop devices, Quickstart now uses separate navs (with different functionality) for mobile and desktop devices. For an example from upstream Bootstrap of building a similar component, see Offcanvas navbar.

Removed Utilities

The following utilities have been removed in Arizona Bootstrap 5.

Blockquote Reverse

The .blockquote-reverse class was removed in upstream Bootstrap 4 and has been removed from Arizona Bootstrap 5.

Bold custom class

The .bold Arizona Bootstrap class was deprecated in Arizona Bootstrap 2 and has been removed from Arizona Bootstrap 5. Use .fw-bold from the font-weight classes instead.

Heading-Style

The .heading-style class has been removed from Arizona Bootstrap 5. The Bootstrap .h1 - .h6 styles should be used instead.

Mailto

The .mailto class, which is placed directly on the <a> link tag, has been removed in favor of Bootstrap’s .text-truncate class, which is placed on the surrounding <div> instead. See Text Truncation for more details.

Sans

The legacy .sans class has been removed from Arizona Bootstrap 5, which already uses a sans-serif font for both body and heading text.

Removed JavaScript

Components listed in the JavaScript section of Arizona Bootstrap 2 (e.g., Modals, Tooltips, Popovers) have had certain methods, options, and events removed or changed in Arizona Bootstrap 5. These items are not backwards compatible. They should not cause breaking changes, but if you are manually calling any of these methods, they will need to be updated to use the methods/events/functions that Arizona Bootstrap uses. Refer to each individual component’s documentation for an explanation of proper methods, options, and events.

Offcanvasmenu

The Offcanvasmenu JavaScript module included in Arizona Bootstrap 2 has been removed from Arizona Bootstrap 5. This module supported the custom Navbar Off Canvas component, which has also been removed.

Tables

Arizona Bootstrap 5 includes a custom set of table variants. From the theme colors, only Light and Dark table variants are included. Table variants for select university brand colors are also included. Note that in Bootstrap 5, .thead-light and .thead-dark have been replaced with the .table-* color variant classes.

Icons

Google Material Icons (Sharp) are deprecated in Arizona Bootstrap 5. Site owners are encouraged to review the updated documentation around importing and using the approved Material Symbols (Rounded) in Arizona Bootstrap 5.