ThePalaceProject / web-patron / 36462000870

26%

push

github

Library UI cards with logos and descriptions (PP-3116) (#202)

## Description

- The library lists on the multi-library home page and the item landing
page now show each library as a card with logo, title, and a description
(limited to two lines).
- A generic library icon holds the logo spot when a library has no logo
or its logo fails to load. The spot is blank while a logo loads.
- The whole card is clickable. The title link or button remains the only
focusable element, and the description is attached to it as its
accessible description.
- Cards have a border and a small shadow, with a larger shadow on hover
(except while a card is disabled). Hover transitions respect
reduced-motion settings.
- Logos load lazily.

<img width="765" height="585" alt="Screenshot 2026-09-26 at 14 49 57"
src="https://github.com/user-attachments/assets/3bb74d8a-8643-41ec-94b4-0cf6cea85930"
/>


**Known issues**:
- A white logo on a transparent background is invisible on a white card,
and thus looks blank.
- Libraries configured statically in the the configuration file show the
default library icon when they have no `logoUrl`, and no description
when they have no `description`. This is true even when their
authentication document has a logo or a description. We do not currently
use authentication documents to generate the cards.

<img width="767" height="238" alt="Screenshot 2026-09-26 at 14 54 07"
src="https://github.com/user-attachments/assets/b42dd51a-ec5d-4b99-831e-3bef0b71e0d4"
/>


## Motivation and Context

Logos and descriptions make libraries easier to recognize and tell apart
than a list of names alone. The library list already includes a logo and
a description whenever the static library config or the registry
provides them, but previously nothing displayed them.

[Jira PP-3116]

## How Has This Been Tested?

- Manual testing in local dev environment.
- New unit tests for the card: logo rendering, the default logo with and
without a logo URL, fallback when a log... (continued)

353 of 1530 branches covered (23.07%)

Branch coverage included in aggregate %.

6 of 24 new or added lines in 4 files covered. (25.0%)

738 of 2139 relevant lines covered (34.5%)

9.54 hits per line