Skip to content
Klarhimmel UI

Schedule, header row list

Schedule, header row list previewSchedule, header row list preview

Install

npx shadcn add @klarhimmel/schedule-header-row-list
DetailsAbout, usage, props and more

A heading with its label on the left and one or two actions on the right of the same row, a wide picture with a caption across the full width below, then dated entries…

Import

Import

import Block from '@/components/klarhimmel/blocks/schedule-header-row-list';
Also called
  • schedule/header-row-list
About
A heading with its label on the left and one or two actions on the right of the same row, a wide picture with a caption across the full width below, then dated entries as cards in a grid, each with a date, time, name, line and tag.
Category
What happens when: sessions, classes or events set out as a list or along a line. New project? Set it up once: /get-started/installation.

Notes

When to use it

Pick it for a program of dated entries that wants a strong opening: the heading and its actions share one row, a wide picture follows, then the entries as cards in a grid. For a narrow column with the picture first and thin dividing lines instead of cards, pick schedule-picture-top-list; for a plain feature grid with no dates, pick features-grid.

Writing for it

- Title up to 80 characters, caption up to 120, at most 9 entries. - Each entry holds a date, a time, a name up to 60, one line up to 160 and an optional tag and badge. - Keep dates and times in one format across all entries.

Watch out for

Cards in the last grid row look ragged when the count is not a multiple of three, so use three, six or nine entries. Leave the badge empty on most cards so the one that has it stands out.

Usage

The block in a page, with its default content (long lists shortened). Every prop is in the table below.

section.tsx
import { Theme } from '@/components/klarhimmel/theme/style';
import { BlockSurface } from '@/components/klarhimmel/blocks/surface';
import ScheduleHeaderRowList from '@/components/klarhimmel/blocks/schedule-header-row-list';

export default function Section() {
  return (
    <Theme theme="brand">
      <BlockSurface>
        <ScheduleHeaderRowList props={{
          "eyebrow": "Section name",
          "title": "Say what the schedule is for",
          "primary": {
            "label": "Main action",
            "href": "#start"
          },
          "secondary": {
            "label": "Second action",
            "href": "#contact"
          },
          "media": {
            "src": "/pictures/photo-food1.avif",
            "alt": "Caramelised figs on a white plate"
          },
          "caption": "Say what the picture shows in a few words.",
          "items": [
            {
              "date": "Weekday and date",
              "badge": "Label",
              "time": "Start and end time",
              "title": "Name the first entry",
              "description": "Say in one line what the visitor gets.",
              "tag": "Tag"
            },
            {
              "date": "Weekday and date",
              "badge": "",
              "time": "Start and end time",
              "title": "Name the second entry",
              "description": "Say in one line what the visitor gets.",
              "tag": "Tag"
            },
            {
              "date": "Weekday and date",
              "badge": "",
              "time": "Start and end time",
              "title": "Name the third entry",
              "description": "Say in one line what the visitor gets.",
              "tag": "Tag"
            }
          ]
        }} />
      </BlockSurface>
    </Theme>
  );
}

Props

The type, default and text limit of every prop. On a real page, over-limit text is kept and checkSections flags it (Installation, Check a page before you ship); this live preview shows the default until it fits. The panel above edits all props.

PropTypeDefaultDescription
eyebrowstring'Section name'Text, up to 60 characters.
titlestring'Say what the schedule is for'Text, up to 80 characters.
primaryLink{…}See the type.
secondaryLink{…}Optional; empty is not rendered.
mediaMedia{…}See the type.
captionstring'Say what the picture shows in a few…'Text, up to 120 characters.
items{ date, badge, time, title, description, tag }[]3 itemsList of 1 to 9. Each item: date, badge, time, title, description, tag.
headingLevel'1' | '2'-One of '1', '2'. Optional; empty is not rendered.