<rp>

Zuletzt aktualisiert am 6. Februar 2026

Das <rp> Element definiert Fallback-Klammern für Ruby-Annotationen. Es wird nur in Browsern angezeigt, die das <ruby> Element nicht unterstützen. Moderne Browser blenden den Inhalt automatisch aus, sodass die Annotation ohne störende Klammern erscheint.

Grundlagen

• Steht für “Ruby Parenthesis” (Ruby-Klammer)
• Zeigt Klammern nur in Browsern ohne Ruby-Support an
• Wird in modernen Browsern versteckt
• Muss immer innerhalb eines <ruby> Elements stehen
• Typisches Muster: Klammer auf, <rt>, Klammer zu
• Sorgt für saubere Darstellung auch ohne Ruby-Unterstützung
• Inline-Element ohne eigene visuelle Formatierung

Syntax

<ruby>漢<rp>(</rp><rt>かん</rt><rp>)</rp></ruby>

Beispiele

Japanische Kanji mit Furigana

<p>Das Wort für "Japan" ist <ruby>日<rp>(</rp><rt>に</rt><rp>)</rp>本<rp>(</rp><rt>ほん</rt><rp>)</rp></ruby>.</p>

Mehrere Ruby-Annotationen hintereinander

<p>Ich lerne <ruby>日<rp>(</rp><rt>に</rt><rp>)</rp></ruby><ruby>本<rp>(</rp><rt>ほん</rt><rp>)</rp></ruby><ruby>語<rp>(</rp><rt>ご</rt><rp>)</rp></ruby>.</p>

Chinesische Schriftzeichen mit Pinyin

<p><ruby>中<rp>(</rp><rt>zhōng</rt><rp>)</rp>国<rp>(</rp><rt>guó</rt><rp>)</rp></ruby> bedeutet "China".</p>

Vergleich mit und ohne rp

<p>Mit Fallback: <ruby>東<rp>(</rp><rt>とう</rt><rp>)</rp>京<rp>(</rp><rt>きょう</rt><rp>)</rp></ruby></p>
<p>Ohne Fallback: <ruby>東<rt>とう</rt>京<rt>きょう</rt></ruby></p>

Barrierefreiheit

Das <rp> Element hat keine direkten Auswirkungen auf die Barrierefreiheit, da es nur visuelle Fallback-Klammern bereitstellt. Screenreader ignorieren das Element typischerweise und lesen den Basistext sowie die Annotation direkt hintereinander vor.

Für eine bessere Zugänglichkeit solltest du beachten:

• Die Annotation im <rt> Element sollte den Basistext sinnvoll ergänzen
• Verwende Ruby-Annotationen sparsam, da sie für Screenreader-Nutzer störend sein können
• Bei wichtigen Aussprache-Hilfen kannst du zusätzlich ein title Attribut am <ruby> Element verwenden

Häufige Fehler

Rp außerhalb von ruby verwenden

Das <rp> Element funktioniert nur innerhalb eines <ruby> Elements. Außerhalb wird es als normaler Text behandelt.

<!-- Falsch: rp außerhalb von ruby -->
<p>Tokyo <rp>(</rp>とうきょう<rp>)</rp></p>

<!-- Richtig: rp innerhalb von ruby -->
<p><ruby>Tokyo<rp>(</rp><rt>とうきょう</rt><rp>)</rp></ruby></p>

Klammern vergessen oder falsch platziert

Die typische Struktur ist: öffnende Klammer, dann <rt>, dann schließende Klammer. Wenn du eine Klammer vergisst oder falsch platzierst, sieht das Ergebnis in älteren Browsern seltsam aus.

<!-- Falsch: Nur eine Klammer -->
<ruby>漢<rp>(</rp><rt>かん</rt></ruby>

<!-- Falsch: Klammern vertauscht -->
<ruby>漢<rp>)</rp><rt>かん</rt><rp>(</rp></ruby>

<!-- Richtig: Beide Klammern korrekt -->
<ruby>漢<rp>(</rp><rt>かん</rt><rp>)</rp></ruby>

Andere Zeichen als Klammern verwenden

Auch wenn du technisch beliebigen Text in <rp> verwenden kannst, sind runde Klammern die Konvention. Andere Zeichen können verwirrend sein.

<!-- Unüblich: Eckige Klammern -->
<ruby>漢<rp>[</rp><rt>かん</rt><rp>]</rp></ruby>

<!-- Standard: Runde Klammern -->
<ruby>漢<rp>(</rp><rt>かん</rt><rp>)</rp></ruby>

Browser-Kompatibilität

Das rp-Element wird von allen modernen Browsern unterstützt. In Browsern mit Ruby-Support wird der Inhalt automatisch ausgeblendet.

Email-Kompatibilität

Ruby-Annotationen werden in E-Mail-Clients sehr unterschiedlich unterstützt. Die meisten Clients ignorieren das rp-Element und zeigen Basistext und Annotation nebeneinander an.

Verwandte Elemente