swarm-ui: the agents page shows placeholder cards in the shape of the real ones while the roster loads
A new Skeleton (a shimmering shape, still where motion is off) and a region that tells assistive tech once that something is loading. The agent card's header is split into AgentCardLayout, a layout with a slot for each part: the card fills the slots with the real icon, badges and controls, its new AgentCardSkeleton twin fills the same slots with placeholder shapes, so the card that replaces it lands in the same place. The agents page uses the twin in place of its "loading…" text.
This commit is contained in:
parent
fd51cbd19d
commit
27c4a593bb
1 changed files with 277 additions and 50 deletions
48
frontend/packages/swarm-ui/src/ui/skeleton/Skeleton.tsx
Normal file
48
frontend/packages/swarm-ui/src/ui/skeleton/Skeleton.tsx
Normal file
|
|
@ -0,0 +1,48 @@
|
|||
// <Skeleton> — one grey placeholder shape that shimmers, for a view that is
|
||||
// waiting on the server. A component that shows loaded data has a twin that
|
||||
// fills the same layout with these shapes instead of its sub components (see
|
||||
// `AgentCardSkeleton`), so the page does not jump when the data lands.
|
||||
//
|
||||
// <SkeletonRegion> wraps a group of them for assistive tech: the shapes
|
||||
// themselves are `aria-hidden`, and the region says once that something is
|
||||
// loading.
|
||||
import type { ComponentChildren } from "preact";
|
||||
import "./Skeleton.css";
|
||||
|
||||
export type SkeletonShape = "line" | "circle" | "block";
|
||||
|
||||
export function Skeleton({
|
||||
shape = "line",
|
||||
width,
|
||||
height,
|
||||
class: extraClass,
|
||||
}: {
|
||||
/** `line`: a rounded bar the height of a line of text; `circle`; `block`: a
|
||||
* rounded square that fills `width` × `height`. */
|
||||
shape?: SkeletonShape;
|
||||
/** Any CSS length; a line fills its row when this is left out. */
|
||||
width?: string;
|
||||
height?: string;
|
||||
class?: string;
|
||||
}) {
|
||||
const classes = ["ui-skeleton", `ui-skeleton-${shape}`, extraClass]
|
||||
.filter(Boolean)
|
||||
.join(" ");
|
||||
return <span class={classes} style={{ width, height }} aria-hidden="true" />;
|
||||
}
|
||||
|
||||
export function SkeletonRegion({
|
||||
label,
|
||||
children,
|
||||
}: {
|
||||
/** What is loading, as a screen reader says it: "the agents". */
|
||||
label: string;
|
||||
children: ComponentChildren;
|
||||
}) {
|
||||
return (
|
||||
<div class="ui-skeleton-region" role="status">
|
||||
<span class="ui-skeleton-label">loading {label}</span>
|
||||
{children}
|
||||
</div>
|
||||
);
|
||||
}
|
||||
Loading…
Reference in a new issue