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.Validation by URI form

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.Validation by File Upload

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.Validation by direct input

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, 1oder 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.