Upgrade to Blacklight 8
There is a wiki page with more upgrade notes available here: Blacklight 8 Upgrade Notes.
Major Changes in This Release
This release includes key upgrades and changes:
- Blacklight updated from version 7 to 8 for better performance and functionality.
- Bootstrap updated from version 4 to 5 for improved accessibility and styling.
- blacklight_range_limit plugin updated from version 7 to 9 for compatibility with Blacklight 8.
- Transitioned from sassc-rails to dartsass-sprockets to fix SASS compatibility issues.
- Removed the forked chosen-rails gem.
HTML/CSS
-
Skip Link Fix
- Fixed skip link display during keyboard navigation.
- Subclassed the Blacklight core
SkipLinkComponent
and configuredtrln_argon
to use the customized version. - Addressed issues with legacy BS4
.sr-only
classes that conflicted with CSS in thefont-awesome-rails
gem. - Related bug fix: Removed "skip to search" link on the Advanced Search page.
- (TD-1412, TD-1396)
-
Chosen CSS Bug Fix
- Fixed an issue where
chosen.css
was not compiling in the production environment. - (TD-1402)
- Fixed an issue where
-
Facet Styling
-
CSS for Advanced Search Publication Year Fields
- Adjusted the layout of Advanced Search Publication Year input fields for better alignment and compactness.
- (TD-1383)
-
Layout and UI Fixes
- Fixed layout of search thumbnails to improve visual presentation.
- (TD-1345)
JavaScript
-
Advanced Search JS Fixes
-
Chosen Plugin Update
- Fixed keyboard navigation and icon issues for Chosen fields in Advanced Search.
- Removed the
trln-chosen-rails
fork and vendor files directly fromtrln_argon
. - (TD-1402)
Accessibility
-
Skip Link Accessibility
- Fixed display and usability of skip link during keyboard navigation, improving the overall user experience.
- (TD-1412)
-
Advanced Search Accessibility
-
Orphaned Form Labels Fix
- Refactored the
trln/local
toggle for accessibility. - Removed inappropriate label elements and improved keyboard navigation and focus ring behavior.
- Simplified the CSS using flexbox and updated the design.
- (TD-1403)
- Refactored the
-
Color Accessibility
- Improved color contrast for selected constraints to meet accessibility standards.
- (TD-1404)
Ruby
-
Ruby 3.x Compatibility
- Updated the Docker configuration to support Ruby 3.1.6 by default.
- Pin Ruby version for consistency in CI and Docker environments.
- Fixed compatibility issues with various gems (e.g.,
dartsass-sprockets
) for Ruby 3.0 and 3.1. - (TD-1358)
-
SASS Deprecation Fixes
- Replaced deprecated
lighten()
anddarken()
functions with Bootstrap 5'stint-color()
andshade-color()
. - Reduced DartSass-Sprockets deprecation warnings in production.
- (TD-1379)
- Replaced deprecated
-
Blacklight Range Limit Plugin Update
- Upgraded the
blacklight_range_limit
plugin to version 9.0.0 to work with Blacklight 8. - (TD-1382)
- Upgraded the