Hacktoberfest 2026: die Issues, die Maintainer für den Oktober markiert haben – offen und einsteigerfreundlich. Hacktoberfest-Issues durchsuchen

Document how to avoid an empty `<h2>` on revealjs slides without a visible title

Offen Anfängerfreundlich
  • Stimmt etwas nicht?
#14,971 0 Kommentare 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen

Maintainer antworten meist innerhalb von 1 Tag

Dieses Issue hat noch niemand übernommen.

Bewertung

Schwierigkeit
2/5
Geschätzter Aufwand
1-3 Stunden
Anfängerfreundlichkeit
86/100
Issue-Typ
Dokumentation
Klarheit
Klar beschrieben
Aktivitätsstatus
Aktiv
Tech-Stack
markdown
Bereich
accessibility, documentation

Rechercherichtung

Beginne mit dem verlinkten Abschnitt Slide Backgrounds Without a Title und vergleiche den zugehörigen Abschnitt Auto Animate. Dokumentiere das Muster des visuell verborgenen span-Elements, warne davor, .visually-hidden auf die Überschrift anzuwenden, da dadurch die gesamte Folie verborgen wird, und verlinke Auto Animate mit den Hinweisen; bestätige, dass die gerenderten Beispiele erklären, wie eine leere Überschrift vermieden wird.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Beschreibung

accessibility documentation revealjs

The revealjs docs show slides with no title, for example ## {background-color="aquamarine"} in Slide Backgrounds Without a Title and ## {auto-animate=true} in Auto Animate. Each of these slides renders an empty <h2>. Screen reader users who move by headings land on a heading with no name, and axe reports empty-heading.

Authors can avoid the empty <h2> and still show no title. Put the title in a span with the .visually-hidden class:

## [Aquamarine slide]{.visually-hidden} {background-color="aquamarine"}

In Quarto 1.11.4, the title does not show on the slide, but Chrome's accessibility tree has heading "Aquamarine slide" [level=2]. The slide menu also lists "Aquamarine slide", not the first words of the slide text. The class works in revealjs, because Quarto defines its own .visually-hidden (_quarto-rules.scss L12-L22). The revealjs theme includes that file (format-reveal-theme.ts L177).

quarto.org does not document this pattern, and there is a trap: ## Title {.visually-hidden} hides the whole slide. In revealjs, Pandoc moves heading classes to the <section>.

Suggestion: In Slide Backgrounds Without a Title, show the .visually-hidden span as the way to have no visible title, and warn about the class on the heading. Auto Animate could link to it.

AI helped with this investigation. The work was grounded in a local clone of quarto-cli, as "Using AI tools to investigate" in CONTRIBUTING.md describes.

Vorherrschende Sprache
JavaScript
Sterne
6.1k
Forks
466
Ø Merge
22 Std. 53 Min.
Gemergte PRs (30 T.)
87

Entwicklungsumgebung

Erste Schritte

  1. Lesen Sie das ganze Issue und danach den Beitragsleitfaden des Projekts.
  2. Schreiben Sie ins Issue, dass Sie es übernehmen — das erspart doppelte Arbeit.
  3. Forken Sie das Repository und arbeiten Sie in einem Branch.
  4. Öffnen Sie einen Pull Request, der die Issue-Nummer nennt.

Mehr aus quarto-dev/quarto-cli

Alle Issues in quarto-dev/quarto-cli

Ähnliche Issues

Weitere Issues zu JavaScript

Neue Issues direkt in Ihr Postfach

Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.