Signatur
Beschreibung
tidy_access_count() liefert die Anzahl der Accessibility-Warnungen (Barrierefreiheitsprobleme), die Tidy beim letzten Parsing oder Bereinigen eines HTML/XHTML-Dokuments festgestellt hat. Diese Warnungen werden erzeugt, wenn das Dokument gegen die Richtlinien der Barrierefreiheit (z. B. WCAG oder Section 508) verstößt.
Die Funktion ist nützlich, wenn du sicherstellen möchtest, dass ein HTML-Dokument nicht nur syntaktisch korrekt ist, sondern auch den Accessibility-Standards entspricht. Sie ermöglicht eine schnelle Prüfung, ob überhaupt Accessibility-Probleme vorliegen, bevor du die Details mit tidy_get_output() oder der tidy-Klasse auswertest.
Die Funktion ist der prozedurale Stil der tidy-Erweiterung. Die objektorientierte Entsprechung ist $tidy->accessCount(). Für die Anzahl der Fehler und normalen Warnungen stehen tidy_error_count() und tidy_warning_count() zur Verfügung.
Parameter
| Name | Typ | Default | Beschreibung |
|---|---|---|---|
| $tidy Pflicht | tidy | Eine Instanz der tidy-Klasse, die das zu prüfende Dokument repräsentiert. Diese Instanz muss vorher mit tidy_parse_string(), tidy_parse_file() oder dem Konstruktor der tidy-Klasse erzeugt worden sein. |
Rückgabewert
0 zurückgegeben.Beispiele
Accessibility-Warnungen eines HTML-Snippets prüfen
<?php
$html = '<html><body><img src="logo.png"><a href="#">Klick mich</a></body></html>';
$tidy = tidy_parse_string($html, ['accessibility-check' => 1], 'UTF8');
$tidy->cleanRepair();
$count = tidy_access_count($tidy);
echo "Accessibility-Warnungen: " . $count . PHP_EOL;
if ($count > 0) {
echo "Das Dokument enthält Barrierefreiheitsprobleme!" . PHP_EOL;
}Objektorientierter Stil zum Vergleich
<?php
$html = '<html><body><img src="bild.jpg"><form><input type="text"></form></body></html>';
$tidy = new tidy();
$tidy->parseString($html, ['accessibility-check' => 2], 'UTF8');
$tidy->cleanRepair();
// Prozeduraler Stil
$countProzedural = tidy_access_count($tidy);
echo "Prozedural: " . $countProzedural . " Accessibility-Warnung(en)" . PHP_EOL;
// OOP-Stil (gleichwertig)
$countOOP = $tidy->accessCount();
echo "OOP: " . $countOOP . " Accessibility-Warnung(en)" . PHP_EOL;// Wichtig · Fallstricke
Wichtig: Damit Accessibility-Prüfungen überhaupt durchgeführt werden, muss die Tidy-Option accessibility-check auf einen Wert von 1 (WCAG Priorität 1), 2 (Priorität 1 und 2) oder 3 (alle Prioritäten) gesetzt sein. Ohne diese Option gibt tidy_access_count() immer 0 zurück, auch wenn das Dokument Barrierefreiheitsprobleme enthält.
Die Funktion steht nur zur Verfügung, wenn PHP mit der tidy-Erweiterung kompiliert wurde. Prüfe mit extension_loaded('tidy'), ob die Erweiterung verfügbar ist.