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 vorwindow.opener-Hijacking und weicht meine seitenweiteReferrer-Policy: no-referrerbei Profil-Links nicht auf.aria-labelundtitle. 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