Record — Related List

Import and example

use maud_ui::{blocks::record::related_list::{self, Date, Item}, primitives::badge};
related_list::render(related_list::Props {
    title: "Bookings".into(),
    items: vec![Item {
        reference: "UI-B05".into(), title: "Garden suite".into(),
        href: Some("/ui/booking/UI-B05".into()),
        status: Some(badge::Props { label: "Confirmed".into(), variant: badge::Variant::Success, ..Default::default() }),
        date: Some(Date { label: "8 Sep 2026".into(), datetime: Some("2026-09-08".into()) }),
    }],
    empty_message: "No bookings yet.".into(),
    ..Default::default()
});

Props and copy contract

title defaults to Related records; use a human-facing plural such as Bookings. items: Vec<Item> stays in caller order. empty_message defaults to No related records. and renders as one quiet line under the heading, without an empty card or placeholder rows. Items with neither reference nor title are omitted. heading defaults to H2. state supports the shared Ready/Absent/Loading/Empty/Error/Disabled contract.

An Item has reference, title, optional href, optional badge::Props in status, and optional Date { label, datetime }. A missing or blank href renders plain identity text, without a dead link. Date label is formatted for the audience; supply a valid machine-readable datetime if known. Missing/blank dates leave no placeholder column.

Reference and title appear once, separated by a middle dot when both remain. Repeated leading copies of the same reference are removed from the title, with or without #: reference UI-B05, title #UI-B05 #UI-B05 renders only UI-B05. Exact boundaries protect different references such as UI-B050. Distinct title text is preserved; the component does not rewrite arbitrary prose.

The adapter must map schema names to product labels. Never pass COMPOSITION, 1 nested, via guest, relation names, join paths or diagnostics as user-facing titles. There are deliberately no schema/count/path subtitle slots. Business status and dates come from admitted values, never inferred from the relationship.