v9.3.1 — 2024-01-17

Overview

Performance improvements and bugfixes from the SDC work.

Issue Summary

• RW-826: reduce CLS caused by JS for OCHA Services #458
• OPS-9885: leftover references to components sub-dir after SDC reshuffle #459

Steps to Upgrade

composer require unocha/common_design:^9

If the cd-global-header.html.twig file has been changed in an existing sub-theme, it will need to have the new line of HTML inserted (see base-theme template with the same name). If the new container isn't inserted, the OCHA Services menu will never display in the Global Header. Insert this HTML before the page.header_top variable:

<div id="cd-ocha-services-container"></div>

If the sub-theme file was never altered and still contains the extend directive, no action is needed.

v9.3.0 — 2024-01-04

Overview

Issue Summary

• CD-483: introduce SDC and add two new components: Snap/Video
• Updated our composer installer settings so that versions 1.2 or 2 can be used.

Steps to Upgrade

composer require unocha/common_design:^9

• If your existing sub-theme follows Drupal best practices and uses libraries-extend or libraries-override to customize CD components, there is no manual upgrade required.
• If you have been hardcoding paths to any of the existing CD components, they will need their paths updated from components/... to libraries/...

v9.2.3 — 2024-01-02

What's Changed

• fix(admin): nicer-looking unpublished styles by @rupl in #444
• chore: minor fixes picked up by css-validator by @lazysoundsystem in #447
• fix: load primary font in a non-blocking manner by @rupl in #448
• CD-527 Remove CSS custom property for mobile logo as it is no longer in use by @left23 in #449
• chore(release): 9.2.3 by @left23 in #450

Full Changelog: v9.2.2...v9.2.3

v9.2.2 — 2023-10-26

Overview

Fixes for CD Social Links (including 🐦 → 🅇), improved main nav's focus/active-trail, CI improvements.

Issue Summary

• CD-500: #441
• CD-502: #438
• CD-507 #437
• CD-508: #440

Steps to Upgrade

No impact, including the Twitter icon. If you're using the CD Social Links classnames exactly as the demo, then it will update automatically. We didn't change the classname, only the icon.

composer require unocha/common_design:^9

v9.2.1 — 2023-10-11

Overview

Testing and developer-facing improvements.

Issue Summary

• CD-505: Refresh and reorganize E2E tests. They're now better suited to be run on individual sites. #431
• CD-504: a11y fix for the site logo
• CD-498: improve WYSIWYG for nested ordered lists
• CD-419: add some theme suggestions for Paragraphs fields

Steps to Upgrade

No impact to existing sites.

composer require unocha/common_design:^9

v9.2.0 — 2023-09-28

Overview

One new feature: CD Disclosure. It's a component to show/hide extended text content.

Issue Summary

• CD-489: CD Disclosure #427

Steps to Upgrade

No impact to existing sites.

composer require unocha/common_design:^9

v9.1.0 — 2023-09-13

Overview

Some bug-fixes and improvements to existing features. Added a new mode to CD Dropdown, but we will replace it with a dedicated component in the next release.

Issue Summary

• CD-173: auto-close dorpdowns when focus leaves the widget #425
• CD-489: provides a new attribute for Dropdowns to allow showing/revealing truncated content #420 #421
• CD-492: D10 updates to how we detect 403/404 #424
• CD-488: encode all URL params inside social links widget #419
• CD-487: pixel pushing for CD Footer mandate #418

Steps to Upgrade

No action strictly necessary. Sites that have copied the CD Social Links template into an active Twig override should manually encode URL params to receive the upgrade contained in the release. See the new template for guidance.

composer require unocha/common_design:^9

v9.0.1 — 2023-07-10

Overview

Small a11y fixes and security updates.

Issue Summary

• CD-486 reported to us on GitHub in #413

Steps to Upgrade

No impact.

composer require unocha/common_design:^9

v9.0.0 — 2023-07-03

9.0.0 (2023-07-03)

Overview

New mininum node.js version, fixes some regressions introduced recently, a11y improvements.

See CHANGELOG for a full list.

Issue Summary

• CD-408: disable animations/transitions when prefers-reduced-motion: reduce media query resolves true.
• CD-473: form styles are scoped to form elements now.
• CD-481: Card images no longer have bottom gap
• CD-482: CD Social Links have an optional label
• CD-484: upgrade node.js

Steps to Upgrade

composer require unocha/common_design:^9

• Upgrade node.js to 18.16.1 or newer, and npm 9.7.2 or newer. Node.js 16 is EOL later in 2023, and shouldn't be used any longer.
• Remove --brand-logo-mobile-url and replace with the literal value. Drupal aggregation can correctly convert relative url() paths when found in files, but our setup introduced in the recent v8.2.0 release had the path being defined in brand.css in an effort to consolidate theme "config" in one place. This led to aggregated paths resolving to the wrong location, so we removed the variable. The sub-theme now has an libraries-extend library which can be used to define the logo.
• Update markup for CD Social Links. The screen-reading of the copy-to-clipboard button was far below our a11y standards and has been refactored. If you have a template which contains {{ attach_library('common_design/cd-social-links') }} then the markup needs to be updated to match the template in the CD base-theme. The official CD Demo will soon be updated to reflect this update.

v8.2.0 — 2023-06-16

Overview

• Many accessibility (a11y) improvements, particularly in regards to screen reading.
• The tabs for logged-in users have larger tap targets on mobile, and have improved RTL support.
• The mobile logo can be specified in brand.css without writing override rules.

A detailed list of every change can be found in the CHANGELOG

Issue Summary

• CD-476: Screen reading improvements for Header/Footer
• CD-478: Screen reading improvements for component library
• CD-418: Tabs refactored to have better RTL/a11y support
• CD-477: screen reading improvements for status messages
• CD-475: mobile logo can be specified in brand.css now — no more overriding rules with custom code!
• CD-399: W3 Validator errors addressed
• No ticket: Drupal performance improvements

Steps to Upgrade

If any of the following templates were overridden, they will not receive the improvements without manually inspecting and incorporating the changes in this release:

• block--language-block.html.twig
• block--system-branding-block.html.twig
• block--system-menu-block--account.html.twig
• block--system-menu-block--account.html.twig
• block--system-menu-block--footer.html.twig
• block--system-menu-block--help.html.twig
• block--system-menu-block--main.html.twig
• cd-copyright.html.twig
• cd-footer-menu.html.twig
• cd-footer.html.twig
• cd-header.html.twig
• cd-mandate.html.twig
• cd-social-menu.html.twig
• maintenance-page.html.twig
• menu--account.html.twig
• menu--help.html.twig
• menu-local-tasks.html.twig
• node--full.html.twig
• page--404.html.twig
• page--facets.html.twig
• page.html.twig
• pager.html.twig
• status-messages.html.twig