Skip to content

Upgrade to Blacklight 8

Compare
Choose a tag to compare
@kazymovae kazymovae released this 14 Jan 21:26
· 2 commits to main since this release
0949948

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 configured trln_argon to use the customized version.
    • Addressed issues with legacy BS4 .sr-only classes that conflicted with CSS in the font-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)
  • Facet Styling

    • Removed old facet style hacks.
    • Ensured checkbox facets (e.g., Available Online) use flexbox for consistency with other facets.
    • (TD-1377, TD-1368)
  • 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

    • Refined JS logic for Advanced Search page to improve functionality.
    • Fixed skip link functionality and updated aria labels for various elements.
    • (TD-1395, TD-1401, TD-1396)
  • 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 from trln_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

    • Addressed various WAVE-flagged accessibility issues in the Advanced Search page.
    • Fixed aria labels for sort results and selector elements.
    • Removed the "skip to search" link on Advanced Search page for improved clarity.
    • (TD-1395, TD-1397, TD-1400, TD-1396, TD-1391)
  • 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)
  • 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() and darken() functions with Bootstrap 5's tint-color() and shade-color().
    • Reduced DartSass-Sprockets deprecation warnings in production.
    • (TD-1379)
  • Blacklight Range Limit Plugin Update

    • Upgraded the blacklight_range_limit plugin to version 9.0.0 to work with Blacklight 8.
    • (TD-1382)

Other Updates

  • Bookmarking & Caching Fixes

    • Fixed caching for homepage Solr query and advanced search facet queries.
    • Addressed issues with bookmark actions and replaced obsolete references to @document_list.
    • (TD-1393, TD-1390)
  • Search UI Improvements

    • Addressed UI issues with missing titles and layout issues on the main search page.
    • (TD-1340)
  • RSS Feed Fixes

    • Fixed issues with RSS feeds and the reference to @document_list.
    • (TD-1392)
  • Miscellaneous Bug Fixes

    • Fixed display issues with the range limit submit button.
    • Added missing icons to tools on the item page.
    • Fixed an issue where the 'Available Online' checkbox facet did not return any results when checked from the homepage.
    • Fixed performing a blank search.
    • (TD-1349, TD-1413)