Inhaltstyp

Winkel werden auf zwei Arten angegeben. Wenn sie als Wert einer Eigenschaft in einem Stylesheet verwendet werden, wird ein <angle> wie folgt definiert:

angle ::= number (~"deg" | ~"grad" | ~"rad")?

wobei deg Grad, grad Gon und rad Radianten bezeichnet.

Für Eigenschaften, die in CSS2 definiert sind, muss ein Winkel-Einheitenkennzeichen angegeben werden. Für Winkelwerte in SVG-spezifischen Eigenschaften und deren entsprechenden Präsentationsattributen ist das Winkel-Einheitenkennzeichen optional. Wenn es nicht angegeben wird, wird der Winkelwert in Grad angenommen. In Präsentationsattributen für alle Eigenschaften, ob in SVG1.1 oder CSS2 definiert, muss das Winkelkennzeichen, falls angegeben, in Kleinbuchstaben sein.

Wenn Winkel in einem SVG-Attribut verwendet werden, wird <angle> stattdessen wie folgt definiert:

angle ::= number ("deg" | "grad" | "rad")?

Die Einheitenkennzeichen in solchen <angle>-Werten müssen in Kleinbuchstaben sein.

Im SVG-DOM werden <angle>-Werte mithilfe von SVGAngle oder SVGAnimatedAngle-Objekten dargestellt.

Der grundlegende Typ <anything> ist eine Sequenz von null oder mehr Zeichen. Genauer:

anything ::= Char*

wobei Char jedes gültige Unicode-Zeichen sein kann, das kein Steuerzeichen ist.

Uhrenwerte haben die gleiche Syntax wie in der SMIL Animation-Spezifikation. Die Grammatik für Uhrenwerte wird hier wiederholt:

Clock-val         ::= Full-clock-val | Partial-clock-val
                      | Timecount-val
Full-clock-val    ::= Hours ":" Minutes ":" Seconds ("." Fraction)?
Partial-clock-val ::= Minutes ":" Seconds ("." Fraction)?
Timecount-val     ::= Timecount ("." Fraction)? (Metric)?
Metric            ::= "h" | "min" | "s" | "ms"
Hours             ::= DIGIT+; any positive number
Minutes           ::= 2DIGIT; range from 00 to 59
Seconds           ::= 2DIGIT; range from 00 to 59
Fraction          ::= DIGIT+
Timecount         ::= DIGIT+
2DIGIT            ::= DIGIT DIGIT
DIGIT             ::= [0-9]

Für Timecount-Werte ist das standardmäßige metrische Suffix s (für Sekunden). In Uhrenwerten sind keine eingebetteten Leerzeichen erlaubt, obwohl führende und nachfolgende Leerzeichen ignoriert werden.

Die folgenden sind Beispiele für zulässige Uhrenwerte:

• Volle Uhrenwerte:
  • 02:30:03 = 2 Stunden, 30 Minuten und 3 Sekunden
  • 50:00:10.25 = 50 Stunden, 10 Sekunden und 250 Millisekunden
• Partieller Uhrenwert:
  • 02:33 = 2 Minuten und 33 Sekunden
  • 00:10.5 = 10,5 Sekunden = 10 Sekunden und 500 Millisekunden
• Zeitwerte:
  • 3.2h = 3,2 Stunden = 3 Stunden und 12 Minuten
  • 45min = 45 Minuten
  • 30s = 30 Sekunden
  • 5ms = 5 Millisekunden
  • 12.467 = 12 Sekunden und 467 Millisekunden
• Bruchteilwerte sind nur (Basis 10) Gleitkommadefinitionen von Sekunden. Daher:
  • 00.5s = 500 Millisekunden
  • 00:00.005 = 5 Millisekunden

Der grundlegende Typ <color> ist eine CSS2-kompatible Spezifikation für eine Farbe im sRGB-Farbraum. <color> gilt für die Verwendung des color-Attributs in SVG und ist ein Bestandteil der Definitionen der Attribute fill, stroke, stop-color, flood-color und lighting-color, die auch optionale ICC-basierte Farbspezifikationen bieten.

Die Definition von <color> in SVG ist genau dieselbe wie die CSS <color>-Definition.

Eine <coordinate> ist eine Länge im Benutzerkoordinatensystem, die den gegebenen Abstand vom Ursprung des Benutzerkoordinatensystems entlang der relevanten Achse (der x-Achse für x-Koordinaten, der y-Achse für y-Koordinaten) darstellt. Ihre Syntax ist dieselbe wie für <length>.

Im SVG-DOM wird eine <coordinate> als SVGLength oder ein SVGAnimatedLength dargestellt.

Frequenzwerte werden mit auralen Eigenschaften verwendet. Wie in CSS2 definiert, ist ein Frequenzwert ein <number>, dem unmittelbar ein Frequenzeinheitenkennzeichen folgt. Die Frequenzeinheitenkennzeichen sind:

• Hz: Hertz
• kHz: Kilohertz

Frequenzwerte dürfen nicht negativ sein.

Funktionale Notation für eine Referenz. Die Syntax für diese Referenz ist dieselbe wie der CSS URI.

Eine <integer> wird als optionales Vorzeichenzeichen (+ oder -) gefolgt von einer oder mehreren Ziffern 0 bis 9 angegeben:

integer ::= [+-]? [0-9]+

Wenn das Vorzeichenzeichen nicht vorhanden ist, ist die Zahl nicht negativ.

Sofern nicht anders für ein bestimmtes Attribut oder eine Eigenschaft angegeben, umfasst der Bereich für eine <integer> (mindestens) -2147483648 bis 2147483647.

Im SVG-DOM wird eine <integer> als number oder als SVGAnimatedInteger dargestellt.

Ein Internationalisierter Ressourcen-Identifikator.

Im Internet werden Ressourcen durch IRIs (Internationalisierte Ressourcenidentifikatoren) identifiziert. Ein Beispiel für eine SVG-Datei namens someDrawing.svg, die unter http://example.com liegt, könnte das folgende IRI sein:

http://example.com/someDrawing.svg

Ein IRI kann auch ein bestimmtes Element innerhalb eines XML-Dokuments ansprechen, indem es einen Fragmentbezeichner als Teil des IRI_s enthält. Ein _IRI, der einen Fragmentbezeichner enthält, besteht aus einem optionalen Basis-IRI, gefolgt von einem #-Zeichen, gefolgt vom IRI-Fragmentbezeichner. Zum Beispiel kann das folgende IRI verwendet werden, um das Element zu spezifizieren, dessen ID Lamppost innerhalb der Datei someDrawing.svg ist:

http://example.com/someDrawing.svg#Lamppost

IRIs werden im href-Attribut verwendet. Einige Attribute erlauben sowohl IRIs als auch Textzeichenketten als Inhalt. Um eine Textzeichenkette von einem relativen IRI zu unterscheiden, wird die funktionale Notation <FuncIRI> verwendet. Dies ist ein IRI, das mit einer funktionalen Notation umgeben ist. Hinweis: Aus historischen Gründen sind die Trennzeichen url( und ), zur Kompatibilität mit den CSS-Spezifikationen. Die FuncIRI-Form wird in Präsentationsattributen verwendet.

SVG macht umfangreichen Gebrauch von IRI-Referenzen, sowohl absolut als auch relativ, zu anderen Objekten. Zum Beispiel, um ein Rechteck mit einem linearen Farbverlauf zu füllen, definieren Sie zuerst ein <linearGradient>-Element und geben ihm eine ID, wie in:

<linearGradient xml:id="MyGradient">...</linearGradient>

Sie verweisen dann auf den linearen Farbverlauf als den Wert des fill-Attributs für das Rechteck, wie im folgenden Beispiel:

<rect fill="url(#MyGradient)" />

SVG unterstützt zwei Typen von IRI-Referenzen:

• lokale IRI-Referenzen, bei denen die IRI-Referenz kein <absoluteIRI> oder <relativeIRI> enthält und somit nur einen Fragmentbezeichner enthält (d.h. #<elementID> oder #xpointer(id<elementID>)).
• nicht-lokale IRI-Referenzen, bei denen die IRI-Referenz ein <absoluteIRI> oder <relativeIRI> enthält.

IRI ist jetzt ein zurückgezogenes Konzept in SVG 2, ersetzt durch den universellen URL-Typ.

Eine Länge ist eine Distanzmessung, angegeben als Zahl zusammen mit einer Einheit. Die SVG2-Spezifikation stimmt mit den CSS <length> Datentypen und Einheiten für die Attributsyntax und -werte überein. Ein Längeneinheitenkennzeichen muss angegeben werden und die Werte der Längeneinheitenkennzeichen sind nicht case-sensitiv. Die Syntax folgt der CSS <length>-Syntax:

length ::= <number> (<absolute-length> | <relative-length>)?

Für SVG-spezifische Eigenschaften, die in SVG1.1 definiert sind, und ihren entsprechenden Präsentationsattributen sind die Einheitenkennzeichen in den Werten optional. Wenn nicht angegeben, stellt der Längenwert eine Distanz im aktuellen Benutzerkoordinatensystem dar. Längenkennzeichen müssen in Kleinbuchstaben sein, wenn sie in Präsentationsattributen für alle Eigenschaften verwendet werden, ob sie in SVG oder CSS definiert sind. Diese Schreibempfindlichkeit wird in SVG2 gelockert, um mit CSS übereinzustimmen.

Beachten Sie, dass die Definition ohne Eigenschaft <length> auch einen Prozentwert (%) als Einheitenkennzeichen erlaubt. Die Bedeutung eines prozentualen Längenwerts hängt von dem Attribut ab, für das der prozentuale Längenwert angegeben wurde. Zwei häufige Fälle sind:

• wenn ein prozentualer Längenwert einen Prozentsatz der Viewport-Breite oder -Höhe darstellt
• wenn ein prozentualer Längenwert einen Prozentsatz der Breite oder Höhe der Begrenzungsbox eines bestimmten Objekts darstellt.

Im SVG-DOM werden <length>-Werte mithilfe von SVGLength oder SVGAnimatedLength-Objekten dargestellt.

(Dabei ist T ein gewisser Typ.) Eine Liste besteht aus einer getrennten Sequenz von Werten. Es sei denn, es ist explizit anders beschrieben, Listen in den XML-Attributen von SVG können sowohl durch Kommata getrennt (mit optionalem Leerzeichen vor oder nach dem Komma) oder durch Leerzeichen getrennt sein.

Leerzeichen in Listen werden definiert als eines oder mehrere der folgenden aufeinanderfolgenden Zeichen: "space" (U+0020), "tab" (U+0009), "line feed" (U+000A), "carriage return" (U+000D) und "form-feed" (U+000C).

Das Folgende ist ein Template für eine EBNF-Grammatik, die die <list-of-Ts>-Syntax beschreibt:

list-of-Ts ::= T
                | T, list-of-Ts

Im SVG-DOM werden Werte vom Typ <list-of-Ts> durch eine schnittstellenspezifische Darstellung für den jeweiligen Typ T repräsentiert. Zum Beispiel wird eine <list-of-lengths> im SVG-DOM mithilfe eines SVGLengthList oder SVGAnimatedLengthList-Objekts dargestellt.

Ein Name, der eine Zeichenkette ist, bei der einige Zeichen mit syntaktischer Bedeutung nicht erlaubt sind.

name  ::= [^,()#x20#x9#xD#xA] /* any char except ",", "(", ")" or wsp */

Reelle Zahlen werden auf zwei Arten angegeben. Wenn sie in einem Stylesheet verwendet werden, wird ein <number> wie folgt definiert:

number ::= integer
            | [+-]? [0-9]* "." [0-9]+

Diese Syntax entspricht der Definition in CSS (CSS2, Abschnitt 4.3.1).

Wenn sie in einem SVG-Attribut verwendet werden, wird ein <number> anders definiert, um Zahlen mit großen Größenordnungen prägnanter angeben zu können:

number ::= integer ([Ee] integer)?
            | [+-]? [0-9]* "." [0-9]+ ([Ee] integer)?

Im SVG-DOM wird ein <number> als float, SVGNumber oder als SVGAnimatedNumber dargestellt.

Ein Paar von <number>s, wobei der zweite <number> optional ist.

number-optional-number ::= number
                            | number, number

Im SVG-DOM wird ein <number-optional-number> mithilfe eines Paares von SVGAnimatedInteger oder SVGAnimatedNumber-Objekten dargestellt.

Die Opazität der Farbe oder des Inhalts, mit dem das aktuelle Objekt gefüllt ist, als <number>. Jegliche Werte außerhalb des Bereichs 0.0 (vollständig transparent) bis 1.0 (vollständig opak) werden in diesen Bereich eingegrenzt.

Die Werte für die Eigenschaften fill und stroke definieren die Art der Farbe, die zum Füllen oder Umranden eines bestimmten Grafikelements verwendet werden soll. Die verfügbaren Optionen und die Syntax für <paint> sind:

paint ::= none | <color> | <url> [none | <color>]? | context-fill | context-stroke

Die context-fill und context-stroke Werte ermöglichen das Erben von Werten in marker und use Elementen.

Prozentsätze werden als Zahl gefolgt von einem %-Zeichen angegeben:

percentage ::= number "%"

Beachten Sie, dass die Definition von <number> davon abhängt, ob der Prozentsatz in einem Stylesheet oder in einem Attribut angegeben wird, das nicht auch ein Präsentationsattribut ist.

Prozentwerte beziehen sich immer auf einen anderen Wert (zum Beispiel eine Länge). Jedes Attribut oder jede Eigenschaft, die Prozentsätze erlaubt, definiert auch das Referenzmaß, auf das sich der Prozentsatz bezieht.

Im SVG-DOM wird ein <percentage> mithilfe eines SVGNumber oder eines SVGAnimatedNumber-Objekts dargestellt.

Ein Zeitwert ist eine <number> direkt gefolgt von einem Zeiteinheitskennzeichen. Die Zeiteinheitenkennzeichen sind:

• ms: Millisekunden
• s: Sekunden

Eine <transform-list> wird verwendet, um eine Liste von Koordinatensystem-Transformationen zu spezifizieren. Eine detaillierte Beschreibung der möglichen Werte für eine <transform-list> finden Sie in der transform-Attributdefinition.

Im SVG-DOM wird ein <transform-list>-Wert mithilfe eines SVGTransformList oder eines SVGAnimatedTransformList-Objekts dargestellt.

Ein Uniform Resource Locator.

Eine URL ist eine Sequenz von Unicode-Zeichen, die eine Adresse zu einer internen oder externen Ressource bildet.

Vor SVG 2 wurde der eingeschränktere IRI Inhaltstyp verwendet, da die URL-Spezifikation vorher nicht standardisiert war.