Drupal Release: 10.2.5

TL;DR

Drupal 10.2.5: Bug Fixes and Accessibility Improvements

This minor release focuses on fixing various bugs and improving accessibility across the Drupal platform. Key improvements include fixes for CKEditor 5 issues, States API functionality with select fields, JavaScript errors in collapsed elements, and several accessibility enhancements. This release also includes updates to support PHPUnit 10 compatibility and improvements to the workspace module.

Highlight of the Release

• Fixed a long-standing issue with States API not working properly with multiple select fields
• Improved CKEditor 5 to properly save content when form is submitted immediately after changes
• Fixed JavaScript errors occurring in collapsed Details elements with required fields
• Enhanced accessibility for buttons with active states and admin toolbar elements
• Fixed issues with sticky table headers when CSS variables are not defined
• Improved handling of duplicate usernames with different cases during registration

Migration Guide

This minor release does not require any specific migration steps. As with any update:

1. Back up your database and code before updating
2. Update using Composer:

   composer update drupal/core --with-all-dependencies
   

3. Run database updates:

   drush updatedb
   

4. Clear caches:

   drush cache:rebuild
   

If you're using PHPUnit for testing, note that this release includes several updates to support PHPUnit 10 compatibility. If you have custom tests that extend core test classes, you may need to update them accordingly.

Upgrade Recommendations

It is recommended to upgrade to Drupal 10.2.5 as soon as possible, especially if you are experiencing any of the issues fixed in this release. This is a minor release with bug fixes and improvements that should not introduce any breaking changes.

The update process should be straightforward for most sites. As always, test the update on a staging environment before applying it to your production site.

For sites using CKEditor 5, sites with complex form states logic, or sites experiencing JavaScript errors with collapsed form elements, this update is particularly important as it addresses several issues in these areas.

Bug Fixes

• CKEditor and Form Handling

  • Fixed CKEditor 5 not saving updated content when form is submitted right after changes
  • Fixed JavaScript error when CKEditor 5 plugin settings have NULL values
  • Fixed issue where collapsed Details elements caused JavaScript errors for required fields

• States API and UI

  • Fixed long-standing issue where States API didn't work with multiple select fields
  • Fixed #states disable property not working for submit buttons and other elements
  • Fixed issue with content language and translation AJAX expansion being backwards
  • Fixed JavaScript warning from content language and translation page

• Layout and Display

  • Fixed sticky table header functionality when CSS variable --drupal-displace-offset-top is not defined
  • Fixed setting width for sticky-header
  • Fixed issue where page titles with value "0" were not displayed in Olivero theme
  • Fixed default images not rendering in Layout Builder
  • Fixed issue with "More" link not taking default arguments into account

• User Management

  • Fixed unhandled exception when trying to register a duplicate username with different case

• Workspace Module

  • Fixed call to getDisplayname() on null in WorkspaceListBuilder.php
  • Fixed workspace switcher block not checking access properly

• Media Handling

  • Fixed OEmbed generating URLs with URL-decoded query strings

• Other Fixes

  • Fixed Block attribute class expecting wrong ContextDefinition
  • Fixed ExistsConstraintValidator to ignore NULL values and treat core as a valid module
  • Fixed invalid CSS for #toolbar-item-user
  • Fixed Standard's article teaser entity view display marking fields as hidden even though they're visible
  • Fixed empty block_content info fields causing PHP deprecation notices
  • Fixed error when calling label() on null in MenuLinkContentForm

New Features

• Added @finnsky as core maintainer for Umami
• Made MultiWidthLayoutBase non-internal, allowing for more flexible layout options
• Added packageManager key to core/package.json to support recommended corepack usage

Security Updates

No specific security fixes were included in this release. However, keeping your Drupal installation up to date with the latest minor version is always recommended as a security best practice.

Performance Improvements

• Improved DatabaseDriver with a non-service alternative for class loading, which can help reduce overhead in certain database operations
• Updated PHPStan baseline from NEON to PHP format, which can improve development workflow efficiency
• Fixed daily updated dependencies job to ensure smoother dependency management

Impact Summary

Drupal 10.2.5 is a maintenance release that focuses on bug fixes and accessibility improvements rather than introducing new features. The impact is primarily positive, addressing several long-standing issues and improving the overall stability and user experience of Drupal sites.

The fixes for CKEditor 5 content saving, States API functionality with multiple select fields, and JavaScript errors in collapsed elements will significantly improve the content editing experience. Site builders will benefit from fixes to Layout Builder, block placement, and the "More" link functionality.

Developers will appreciate the updates for PHPUnit 10 compatibility, which helps future-proof testing setups, especially for sites planning to upgrade to PHP 8.3. The accessibility improvements to buttons, admin toolbar elements, and UI components help sites meet accessibility standards and provide a better experience for all users.

Overall, this release represents an important maintenance update that resolves numerous pain points reported by the Drupal community without introducing breaking changes or requiring significant adaptation from users.