CSS Validator Benutzerhandbuch
Inhalt
Benutzung des CSS Validators
Der einfachste Weg ein Dokument zu prüfen ist die Nutzung des Basis-Interfaces. Auf dieser Seite finden Sie drei Formulare für die drei Anwendungsmöglickeiten:
Validation per URL
Geben Sie einfach die URL des Dokuments ein, das Sie validieren möchten. Dabei kann es sich um ein HTML- oder CSS-Dokument handeln.
Validierung per Datei-Upload
Diese Möglichkeit erlaubt es Ihnen, eine lokale Datei hochzuladen und zu überprüfen. Klicken Sie auf den "Browse..."-Button und wählen Sie die zu überprüfende Datei.
In diesem Fall sind nur CSS-Dokumente erlaubt. Das bedeutet, dass Sie keine (X)HTML-Dokumente hochladen können. Sie sollten ausserdem mit @import-Regeln vorsichtig sein, weil diese nur berücksichtigt werden können, wenn Sie explizit eine öffentlich zugängliche URL referenzieren (relative Pfade funktionieren nicht).
Validierung per direkter Eingabe
Diese Methode ist perfekt zum Testen von CSS-Fragmenten. Sie müssen Ihr CSS nur in das Textfeld eingeben.
Es gelten die gleichen Regeln wie bei der Validierung per Datei-Upload. Beachten Sie, dass diese Lösung sehr praktisch ist, wenn Sie ein Problem haben und Hilfe von der Community benötigen. Sie ist auch nützlich, um einen Bug zu melden, weil Sie auf das Ergebnis per URL verlinken können.
Was tut die grundlegende Validierung?
Wenn Sie das Basis-Interface benutzen, prüft der Validator die Einhaltung von CSS 2.1, das die gegenwärtige Technical Recommendation darstellt.
Es produziert eine Ausgabe in XHTML ohne Warnungen (nur Fehler werden angezeigt).
Das Medium ist auf "all" eingestellt, was das geeignete Medium für alle Geräte ist (siehe http://www.w3.org/TR/CSS2/media.html für eine vollständige Beschreibung von Medien).
Erweiterte Validierung
Wenn Sie eine spezifischere Überprüfung brauchen, können Sie das erweiterte Interface benutzen, das die Eingabe von drei Parametern erlaubt. Hier ist eine kurze Erklärung zu jedem der drei Parameter:
Warnings
Dieser Parameter ist nützlich, um die Menge an Ausgabe zu kontrollieren, die der Validator erzeugt. Grundsätzlich kann der Validator zwei Arten von Nachrichten erzeugen: Fehler und Warnungen. Fehler werden erzeugt wenn das geprüfte CSS nicht der CSS-Recommendation entspricht. Warnungen unterscheiden sich von Fehlern dadurch, dass sie kein Problem mit der Spezifikation betreffen. Sie weisen den CSS-Entwickler darauf hin, dass bestimmte Punkte potentiell problematisch sind und zu merkwürdigem Verhalten in einigen User Agents (z.B. Browsern) führen können.
Eine typische Warnung betrifft die Font-Family. Wenn Sie keinen allgemeinen Font angeben, erhalten Sie eine Warnung, dass Sie einen solchen am Ende der Regel einfügen sollten, damit ein User Agent, der keinen der anderen Fonts kennt, nicht zu seiner Standardschriftart zurückkehrt, was merkwürdig aussehen könnte.
Profile
Der CSS Validator kann verschiedene CSS-Profile überprüfen. Ein Profil listet alle Features auf, die eine Implementierung auf einer bestimmten Plattform implementieren sollte. Diese Definition ist von der CSS-Site übernommen. Die Voreinstellung entspricht dem derzeit am meist genutzten Profil: CSS 2.
Medium
Der Medium-Parameter ist äquivalent zur @media-Regel, die für das gesamte Dokument gilt. Mehr Informationen zu @media finden Sie unter http://www.w3.org/TR/CSS2/media.html .
Für Experten
Format des Validierungs-Requests
Unten finden Sie eine Tabelle der Parameter, die Sie nutzen können, wenn Sie eine Anfrage an den W3C CSS Validator schicken.
Wenn Sie den öffentlichen Validierungsserver von W3C benutzen möchten, verwenden Sie diese Parameter in Verbindung mit der Basis-URI: http://jigsaw.w3.org/css-validator/validator
(Ersetzen Sie dies durch die Basis-Adresse Ihrer eigenen Validator-Instanz, wenn Sie den Validator auf einem eigenen Server betreiben).
Achtung: Wenn Sie den Validator in Programmen für die Stapelverarbeitung nutzen möchten, stellen Sie bitte sicher, dass Ihr Code zwischen zwei Aufrufen immer mindestens 1 Sekunde abwartet (z.B. per sleep()). Der CSS Validator-Service ist ein freier, öffentlicher Dienst für alle. Vielen Dank für Ihr Verständnis.
Parameter | Beschreibung | Voreinstellung |
---|---|---|
uri | Die URL des zu prüfenden Dokuments. CSS und HTML Dokumente sind erlaubt. | Keine. Entweder dieser Parameter oder der text-Parameter müssen aber vorhanden sein. |
text | Das zu prüfende Dokument; hier ist nur CSS erlaubt. | Keine. Entweder dieser Parameter oder der uri-Parameter müssen aber vorhanden sein. |
usermedium | Das medium für die Validierung, z.B. screen ,
print , braille ... |
all |
output | Bestimmt das Ausgabeformat des Validators. Mögliche Formate sind text/html und html (XHTML-Dokument,
Content-Type: text/html),
application/xhtml+xml und xhtml (XHTML-Dokument, Content-Type: application/xhtml+xml),
application/soap+xml und soap12 (SOAP 1.2-Dokument, Content-Type: application/soap+xml),
text/plain und text (Textdokument,
Content-Type: text/plain), alles andere (XHTML-Dokument, Content-Type: text/plain)
|
html |
profile | Das CSS-Profil für die Validierung. Das kann css1 , css2 , css21 , css3 , svg , svgbasic , svgtiny , mobile , atsc-tv , tv oder none sein. |
die letzte W3C Recommendation: CSS 2 |
lang | Die Ausgabesprache; zur Zeit werden unterstützt: en , fr , it , ko , ja , es , zh-cn , nl , de . |
Englisch (en ). |
warning | Menge der ausgegebenen Warnungen. no für keine Warnungen, 0 für wenige, 1 oder 2 für mehr Warnungen
|
2 |
CSS Validator Web Service API: Dokumentation des SOAP 1.2 Validierungs-Interfaces
Für weitere technische Unterstütztung, speziell zum SOAP 1.2 Output und allen Aufrufsmöglichkeiten siehe CSS Validator Web Service API.