Skip to content
Klarhimmel UI

Schedule, picture on top list

Schedule, picture on top list previewSchedule, picture on top list preview

Install

npx shadcn add @klarhimmel/schedule-picture-top-list
DetailsAbout, usage, props and more

One narrow column: a wide picture with a caption, then a label, heading and lead, then dated rows split by thin lines (date, name and line on the left, time and place…

Import

Import

import Block from '@/components/klarhimmel/blocks/schedule-picture-top-list';
Also called
  • schedule/picture-top-list
About
One narrow column: a wide picture with a caption, then a label, heading and lead, then dated rows split by thin lines (date, name and line on the left, time and place on the right), and one or two actions last.
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 short list of events or sessions in one narrow reading column, with the picture first, then the heading, the rows and the actions last. When the entries need cards in several columns or the actions belong beside the heading, pick schedule-header-row-list; for a simple dated history, a changelog block fits better.

Writing for it

- Title up to 80 characters, lead up to 200, between 1 and 10 rows. - Each row has a date, a name up to 60, a line up to 160, a time and an optional place. - Write the place as an address or a room, not a sentence.

Watch out for

A long list makes the column very tall and pushes the actions far from the heading, so keep it to about six rows. Leave the place empty when everything happens in one spot and say it in the lead.

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 SchedulePictureTopList from '@/components/klarhimmel/blocks/schedule-picture-top-list';

export default function Section() {
  return (
    <Theme theme="brand">
      <BlockSurface>
        <SchedulePictureTopList props={{
          "media": {
            "src": "/pictures/photo-wood3.avif",
            "alt": "A workbench with hand tools on the wall"
          },
          "caption": "Say what the picture shows in a few words.",
          "eyebrow": "Section name",
          "title": "Say what the schedule is for",
          "description": "Say in one line what the visitor can come to.",
          "items": [
            {
              "date": "Weekday and date",
              "title": "Name the first entry",
              "description": "Say in one line what the visitor gets.",
              "time": "Start and end time",
              "place": "Say where it takes place"
            },
            {
              "date": "Weekday and date",
              "title": "Name the second entry",
              "description": "Say in one line what the visitor gets.",
              "time": "Start and end time",
              "place": "Say where it takes place"
            }
          ],
          "primary": {
            "label": "Main action",
            "href": "#start"
          },
          "secondary": {
            "label": "Second action",
            "href": "#contact"
          }
        }} />
      </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
mediaMedia{…}See the type.
captionstring'Say what the picture shows in a few…'Text, up to 120 characters.
eyebrowstring'Section name'Text, up to 60 characters.
titlestring'Say what the schedule is for'Text, up to 80 characters.
descriptionstring'Say in one line what the visitor ca…'Text, up to 200 characters.
items{ date, title, description, time, place }[]2 itemsList of 1 to 10. Each item: date, title, description, time, place.
primaryLink{…}See the type.
secondaryLink{…}Optional; empty is not rendered.
headingLevel'1' | '2'-One of '1', '2'. Optional; empty is not rendered.