Eine Callout-Komponente für Astro

Eine wiederverwendbare Hinweisbox für Astro mit Info, Note und Warning, optionalem Titel, Social-Links und einer Mitglieder-Sektion mit Links pro Person.

Beim Schreiben einiger Posts für meine alte Seite brauchte ich immer wieder denselben Block. Einen farbigen Kasten mit Icon, optional einem Titel und ein paar Social-Links zur Band oder zum Projekt, um das es ging. Ein klassischer Fall für eine kleine MDX-Komponente. Je länger ich daran gebaut habe, desto mehr konnte sie am Ende:

  • drei Varianten: info, note, warning;
  • einen optionalen Titel;
  • Inline-Markdown im Inhalt über <slot />;
  • bis zu fünf Social-Icons (YouTube, TikTok, Facebook, Instagram, Website);
  • eine Mitglieder-Sektion mit Name, Rolle und beliebig vielen Links pro Person.

Im Beitrag zur YouTube-Einbettung habe ich damit direkt unter dem Video die Band verlinkt und darunter die Sängerin mit ihren eigenen Kanälen.

Die Props

src/components/Callout.astro, Frontmatter:

---
type SocialKey = 'youtube' | 'tiktok' | 'facebook' | 'instagram' | 'website';

interface MemberLink {
    social: SocialKey;
    href: string;
}
interface Member {
    name: string;
    role?: string;
    links: MemberLink[];
}

interface Props {
    type?: 'info' | 'note' | 'warning';
    title?: string;
    youtube?: string;
    tiktok?: string;
    facebook?: string;
    instagram?: string;
    website?: string;
    membersTitle?: string;
    members?: Member[];
}

const {
    type = 'info',
    title,
    youtube,
    tiktok,
    facebook,
    instagram,
    website,
    membersTitle,
    members = [],
} = Astro.props;
---

Die SVG-Icons (Info, Note, Warning und die Social-Icons) liegen als String-Konstanten in derselben Datei und werden mit set:html ausgegeben. Inline-SVG war hier angenehmer als noch ein Icon-Paket: ein Build-Schritt und ein paar Kilobyte weniger.

Die Ausgabe

<aside class={`callout callout-${type}`}>
    <span class="callout-icon" set:html={icons[type]} />
    <div class="callout-body">
        {title && <p class="callout-title">{title}</p>}
        <slot />
        {
            socials.length > 0 && (
                <ul class="callout-socials">
                    {socials.map((s) => (
                        <li>
                            <a
                                href={s.href}
                                target="_blank"
                                rel="noopener noreferrer"
                                aria-label={s.label}
                                title={s.label}
                                set:html={socialIcons[s.key]}
                            />
                        </li>
                    ))}
                </ul>
            )
        }
        {
            members.length > 0 && (
                <div class="callout-members">
                    {membersTitle && <p class="callout-members-title">{membersTitle}</p>}
                    <ul>
                        {members.map((m) => (
                            <li>
                                <div class="callout-member-text">
                                    <span class="callout-member-name">{m.name}</span>
                                    {m.role && <span class="callout-member-role">{m.role}</span>}
                                </div>
                                {m.links.length > 0 && (
                                    <ul class="callout-member-links">
                                        {m.links.map((l) => (
                                            <li>
                                                <a
                                                    href={l.href}
                                                    target="_blank"
                                                    rel="noopener noreferrer"
                                                    title={socialLabels[l.social]}
                                                    set:html={socialIcons[l.social]}
                                                />
                                            </li>
                                        ))}
                                    </ul>
                                )}
                            </li>
                        ))}
                    </ul>
                </div>
            )
        }
    </div>
</aside>

Drei Details waren mir wichtig:

  • <slot /> vor den Listen. Der Text bleibt im Lesefluss, Socials und Mitglieder stehen darunter. Das liest sich auch dann sinnvoll, wenn JavaScript aus ist und keine Icons erscheinen.
  • rel="noopener noreferrer" auf jedem externen Link. Das schützt vor window.opener-Hijacking und weicht meine seitenweite Referrer-Policy: no-referrer bei Profil-Links nicht auf.
  • aria-label und title. Die Icons haben keine sichtbare Beschriftung, also bekommen Screenreader und Tooltip einen lesbaren Namen.

Verwendung

Im Originalbeitrag stand jede Variante als echte Box. In MDX sieht das so aus:

import Callout from '~/components/Callout.astro';

<Callout>Kurzer Hinweis ohne Titel.</Callout>

<Callout type="warning" title="Achtung">
    Vor dem Deploy `astro check` laufen lassen.
</Callout>

info war die farbige Standardbox, warning eine Box in Warnfarben und note ein neutrales Grau für Nebenbemerkungen.

Die fünf Social-Props erscheinen als Icon-Reihe unter dem Text. Die Reihenfolge ist fest, leere Werte fallen weg.

<Callout
    type="info"
    title="Mein Projekt"
    website="https://example.com"
    youtube="https://www.youtube.com/@example"
>
    Hier passiert das Wesentliche.
</Callout>

members nimmt ein Array aus { name, role?, links }. Jedes Mitglied bekommt eine eigene kleine Karte mit Name, Rolle und Icon-Reihe; membersTitle ist eine optionale Überschrift darüber. Die Demo im Beitrag war die Box zur OZONE Band aus Phuket: vier Band-Links oben, die Überschrift „Bandmitglieder“ und darunter die Sängerin Nene Royal mit ihrer Rolle und fünf eigenen Links. Weitere Mitglieder sind einfach weitere Objekte im Array.

MDX-Stolperfalle: JSX-Ausdrücke auf eine Zeile

Beim ersten Versuch hatte ich das members-Array auf mehrere Zeilen verteilt:

members={[
{ name: "…", links: [{ social: "tiktok", href: "…" }] }
]}

@astrojs/mdx parst das mit acorn über micromark-util-events-to-acorn. Ein mehrzeiliger JSX-Ausdruck mit verschachtelten Objektliteralen warf zuverlässig Could not parse expression with acorn. Die Lösung: das Array auf eine Zeile schreiben. Hässlich, aber stabil:

members={[{ name: "…", links: [{ social: "tiktok", href: "…" }] }]}

Wird dir die Zeile zu lang, zieh das Array ins Frontmatter eines .astro-Wrappers, der die Komponente importiert. Für einzelne Posts reicht die Inline-Form.

Gestaltung

  • Linker Rand mit passendem Akzent-Hintergrund: der klassische Callout-Look, der mit vielen Themes und Farbschemata funktioniert.
  • Mitglieder-Sektion mit gestrichelter border-top: trennt Band-Links von Personen-Links ohne zweiten Hintergrund.
  • Icons als Inline-SVG mit currentColor: Die Icons erben die Textfarbe und wechseln beim Hover zu Akzentfarbe und Weiß. Keine Bilder, keine Wartezeit auf Webfonts.
  • Rollen klein und gedimmt (opacity: 0.8, 0.78rem): Die Reihenfolge soll Name, Rolle, Icons sein, nicht alles gleich laut.

Umfang und Erweiterung

Die Komponente kam auf rund 270 Zeilen in einer Datei: Props, Inline-SVGs, Render-Logik und Scoped Styles. Kein Icon-Paket, kein Slot-Stapel, kein React. In MDX ist <Callout> so unauffällig wie ein Markdown-Zitat.

Eine weitere Plattform wie Mastodon oder Bluesky braucht zwei Zeilen: einen SVG-String in socialIcons und einen Eintrag in der SocialKey-Union samt Prop. Die Architektur ist absichtlich flach: kein Plugin-System, keine Registry, nur ein paar ifs.

Mehr dazu

Thema
  • Statische Website Eine Website aus fertigen HTML-Dateien, die einmal gebaut und dann unverändert ausgeliefert werden. Kein Servercode, keine Datenbank.
Im Text erwähnt
  • YouTube DSGVO-konform einbetten Eine Astro-Komponente, die YouTube erst nach einem Klick lädt: einmalig, zustimmen und merken oder nur der Link. Kein Cookie, kein Request an Google vorher.
Schlagwörter

In der Graph-Ansicht zeigen →