Cette traduction est incomplète. Aidez à traduire cet article depuis l'anglais.

Angle

<angle>

Les Angles sont spécifiés d'une ou deux façons.

Lorsqu'ils sont utilisés comme valeur d'une propriété dans une feuille de style, un angle <angle> se définit comme suit :

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

Lorsque les angles sont utilisés via des attributs SVG, un angle <angle> se définit comme suit :

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

L'unité de mesure deg indique les degrés, grad les grades et rad les radians.

Pour les propriétés définies en CSS2, il est obligatoire d'écrire l'unité de mesure. Pour les valeur définies directement dans les propriétés et attributs SVG, l'unité de mesure est optionnelle. Dans ce cas, l'unité de mesure par défaut est le degré. Pour toutes les propriétés, que ce soit via CSS2 ou propriété SVG, l'unité de mesure doit nécessairement être inscrite en casse minuscule.

Dans le DOM SVG, les valeurs d'angle <angle> sont représentées via SVGAngle ou SVGAnimatedAngle objects.

Anything

<anything>
Le type <anything> de base est une séquence de zero ou plus de caractères. Spéficifiquement :
anything ::= Char*

où Char est la production de caractères, comme défini dans l'édition XML 1.0 , section 2.2.

Clock-value

<clock-value>

Les valeurs temporelles ont la même syntaxe que dans la spécification des Animations SMIL. Vous en trouverez un résumé ci-dessous :

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]

Pour les veleurs de type Timecount, le suffixe d'unité par défaut est "s" (pour secondes). Auncun espace n'est autorisé dans les valeurs temporelles, le suffixe doit coller directement la valeur. De fait, tout espace en préfixe de la valeur ou en suffixe de l'unité de mesure sera ignoré.

Quelques exemples valides de valeurs temporelles :

  • Valeurs temporelles entières :
    02:30:03 = 2 heures, 30 minutes et 3 secondes
    50:00:10.25 = 50 heures, 10 secondes et 250 millisecondes
  • Valeurs temporelles partielles :
    02:33 = 2 minutes et 33 secondes
    00:10.5 = 10,5 secondes = 10 secondes et 500 millisecondes
  • Timecount values:
    3.2h = 3,2 heures = 3 heures et 12 minutes
    45min = 45 minutes
    30s = 30 secondes
    5ms = 5 millisecondes
    12.467 = 12 secondes et 467 millisecondes

Les valeurs fractionnaires sont exprimées en base 10 de secondes, ainsi :

00.5s = 500 millisecondes
00:00.005 = 5 millisecondes

Color

<color>

The basic type <color> is a CSS2 compatible specification for a color in the sRGB color space. <color> applies to SVG's use of the color attribute and is a component of the definitions of attributes fill, stroke, stop-color, flood-color and lighting-color, which also offer optional ICC-based color specifications.

SVG supports all of the syntax alternatives for <color> defined in CSS2 syntax and basic data types, and (depend on the implementation) in the future CSS Color Module Level 3.

A <color> is either a keyword or a numerical RGB specification.

In addition to these color keywords, users may specify keywords that correspond to the colors used by objects in the user's environment. The normative definition of these keywords is found in User preferences for colors (CSS2, section 18.2).

The format of an RGB value in hexadecimal notation is a "#" immediately followed by either three or six hexadecimal characters. The three-digit RGB notation (#rgb) is converted into six-digit form (#rrggbb) by replicating digits, not by adding zeros. For example, #fb0 expands to #ffbb00. This ensures that white (#ffffff) can be specified with the short notation (#fff) and removes any dependencies on the color depth of the display. The format of an RGB value in the functional notation is an RGB start-function followed by a comma-separated list of three numerical values (either three integer values or three percentage values) followed by ")". An RGB start-function is the case-insensitive string "rgb(", for example "RGB(" or "rGb(". For compatibility, the all-lowercase form "rgb(" is preferred. The integer value 255 corresponds to 100%, and to F or FF in the hexadecimal notation: rgb(255,255,255) = rgb(100%,100%,100%) = #FFF. White space characters are allowed around the numerical values. All RGB colors are specified in the sRGB color space. Using sRGB provides an unambiguous and objectively measurable definition of the color, which can be related to international standards.

color    ::= "#" hexdigit hexdigit hexdigit (hexdigit hexdigit hexdigit)?
             | "rgb("integer, integer, integer")"
             | "rgb("integer "%", integer "%", integer "%)"
             | color-keyword
hexdigit ::= [0-9A-Fa-f]

where color-keyword matches (case insensitively) one of the color keywords listed in CSS Color Module Level 3, or one of the system color keywords listed in User preferences for colors (CSS2, section 18.2).

The corresponding SVG DOM interface definitions for <color> are defined the one defined by CSS. SVG's extension to color, including the ability to specify ICC-based colors, are represented using DOM interface SVGColor.

Coordinate

<coordinate>
Une coordonnée <coordinate> est un point dans le système de coordonnées qui déterminé par une distance depuis le point d'origine de ce système, suivant les axes X (abscisses) et Y (ordonnées). La syntaxe est la même que <length>.

A l'intérieur du DOM SVG, une coordonnée <coordinate> est représenté par SVGLength ou SVGAnimatedLength.

Frequency

<frequency>

Les valeurs de fréquence sont utilisées pour des propriétés sonores. Comme défini en CSS2, une valeur de fréquence est un nombre <number> directement suivi par une unité de fréquence. Les unités de fréquence sont les suivantes :

  • Hz: Hertz
  • kHz: kilo Hertz

Les valeurs de fréquence ne peuvent pas être négatives.

FuncIRI

<FuncIRI>
Notation fonctionnelle pour une référence. La syntaxe pour cette référence est la même que pour css uri

ICCColor

<icccolor>

<icccolor> est une spécification couleur ICC. En SVG 1.1, une spécification couleur ICC est attribué par l'allocation d'un nom qui référence un élément <color-profile>, ainsi qu'un ou plusieurs composants colorimétriques. La syntaxe est la suivante :

icccolor ::= "icc-color(" name (, number)+ ")"

La correspondance dans le DOM SVG pour <icccolor> est SVGICCColor.

Integer

<integer>

Un nombre <integer> se définit comme un caractère optionel ("+" ou "-") suivi par un ou plusieurs chiffres de "0" à "9":

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

Si aucun caractère de signe n'est présent, alors le nombre est considéré comme positif.

A moins qu'il soit utilisé sur un attribut ou une propriété non conventionnelle, un nombre <integer> peut se situer dans un interval de -2147483648 à 2147483647.

Dans le DOM SVG, un <integer> est représenté comme un number ou un SVGAnimatedInteger.

IRI

<IRI>

An Internationalized Resource Identifier.

On the Internet, resources are identified using IRIs (Internationalized Resource Identifiers). For example, an SVG file called someDrawing.svg located at http://example.com might have the following IRI:

http://example.com/someDrawing.svg

An IRI can also address a particular element within an XML document by including an IRI fragment identifier as part of the IRI. An IRI which includes an IRI fragment identifier consists of an optional base IRI, followed by a "#" character, followed by the IRI fragment identifier. For example, the following IRI can be used to specify the element whose ID is "Lamppost" within file someDrawing.svg:

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

IRIs are used in the xlink:href attribute. Some attributes allow both IRIs and text strings as content. To disambiguate a text string from a relative IRI, the functional notation <FuncIRI> is used. This is simply an IRI delimited with a functional notation. Note: For historical reasons, the delimiters are "url(" and ")", for compatibility with the CSS specifications. The FuncIRI form is used in presentation attributes .

SVG makes extensive use of IRI references, both absolute and relative, to other objects. For example, to fill a rectangle with a linear gradient, you first define a <linearGradient> element and give it an ID, as in:

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

You then reference the linear gradient as the value of the fill attribute for the rectangle, as in the following example:

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

SVG supports two types of IRI references:

  • local IRI references, where the IRI reference does not contain an <absoluteIRI> or <relativeIRI> and thus only contains a fragment identifier (i.e., #<elementID> or #xpointer(id<elementID>))
  • non-local IRI references, where the IRI reference does contain an <absoluteIRI> or <relativeIRI>

For the full specification of IRI references in SVG, see SVG 1.1 (2nd Edition): IRI references.

Length

<length>

Le type de données <length> correspond à une mesure de distance appliquée sur un élémént à l'aide d'une unité de mesure. Ces mesures sont spécifiées de deux manières, selon leur contexte.

Lorsqu'elles sont utilisées dans une feuille de style, la mesure <length> est définie comme suit :

length ::= number (~"em" | ~"ex" | ~"px" | ~"in" | ~"cm" | ~"mm" | ~"pt" | ~"pc")?

Lorsque les longueurs sont utilisées sur un attribut SVG, la mesure <length> est définie comme suit :

length ::= number ("em" | "ex" | "px" | "in" | "cm" | "mm" | "pt" | "pc" | "%")?

Voir les spécifications CSS2 pour en apprendre plus sur la signification de ces unités de mesure.

Concernant les propriétés définies en CSS2, l'utilisation d'une unité de mesures est requise. A l'inverse, les propriétés définies par les éléments SVG et leurs attributs de présentation associés ne nécessitent pas l'utilisation d'une unité de mesure. Si elle n'est pas explicitée, l'unité de mesure représentera une distance dans le système de coordonnées utilisé. Si elle est spécifiée, l'unité de mesure doit toujours être écrite en minuscule, qu'elle soit définie en SVG1.1 ou CSS2.

Il faut noter que la définition de la propriété <length> autorise l'utilisation du pourcentage comme unité de mesure. La valeur relative résultant du pourcentage dépendra de l'attribut sur lequel il aura été spécifié. Deux cas :

  • Lorsque la distance exprimée en pourcentage représente la largeur ou la hauteur du viewport.
  • Lorsque la distance exprimée en pourcentage représente un pourcentage de la largeur ou hauteur d'un élément donné.

Dans le DOM SVG, les valeurs <length> sont représentées par les objets SVGLength ou SVGAnimatedLength.

List-of-Ts

<list-of-Ts>

(Where T is some type.) A list consists of a separated sequence of values. Unless explicitly described differently, lists within SVG's XML attributes can be either comma-separated, with optional white space before or after the comma, or white space-separated.

White space in lists is defined as one or more of the following consecutive characters: "space" (U+0020), "tab" (U+0009), "line feed" (U+000A), "carriage return" (U+000D) and "form-feed" (U+000C).

The following is a template for an EBNF grammar describing the <list-of-Ts> syntax:

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

Within the SVG DOM, values of a <list-of-Ts> type are represented by an interface specific for the particular type T. For example, a <list-of-lengths> is represented in the SVG DOM using an SVGLengthList or SVGAnimatedLengthList object.

Name

<name>
Un nom <name> est une chaîne de caractères à l'intérieur de laquelle certains caractères syntaxique sont interdits. 
name  ::= [^,()#x20#x9#xD#xA] /* any char except ",", "(", ")" or wsp */

Number

<number>

Un nombre réel est spécifié d'une ou deux façons. Quand il est utilisé dans une feuille de style, un nombre <number> est défini comme suit :

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

La syntaxe est telle quelle que définit dans la normalisation CSS (CSS2, section 4.3.1).

Quand il est utilisé dans un attribut SVG, un nombre <number> est défini différemment, afin d'autoriser les nombres d'une plus grande amplitude, tout en permettant de les écrire de manière plus concise :

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

Dans le DOM SVG, un <number> écrit comme un nombre décimal, SVGNumber ou un SVGAnimatedNumber.

Number-optional-number

<number-optional-number>

Une paire de nombres <number>, dans laquelle le second nombre <number> est optionnel.

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

Dans le DOM SVG, <number-optional-number> est représenté comme utilisant une paire d'objets SVGAnimatedInteger ou SVGAnimatedNumber.

Opacity value

<opacity-value>
L'opacité d'une couleur ou d'un contenu va remplir l'objet visé par la valeur, qui est notée comme un nombre <number>. Toute valeur en dessous du niveau 0.0 (totalement transparent) et au dessus de 1.0 (totalement opaque) sera automatiquement ramené à ces extrêmes.

Paint

<paint>

Les valeurs des propriétés fill et stroke sont des spécifications de type paint. Ells sont utilisées lorsqu'il s'agit de remplir ou tracer le contour d'une forme avec une couleur. Les options et la syntaxe pour le type <paint> sont décrites dans la spécification W3C.

Dans le DOM SVG, les valeurs <paint> sont représentées par les objets SVGPaint.

Percentage

<percentage>

Les pourcentages sont spécifiés comme des nombres suivis par un symbole "%" :

percentage ::= number "%"

Il faut noter que la définition du nombre composant le pourcentage dépend de ce que le pourcentage est utilisé dans une feuille de style ou directement dans un attribut.

Les valeurs d'un pourcentage sont toujours relatives à une autre valeur référente, par exemple une longueur. Chaque attribut ou propriété qui permet l'utilisation d'un pourcentage détermine la valeur de référence du pourcentage.

Dans le DOM SVG, un pourcentage <percentage> est représenté via SVGNumber ou via un objet SVGAnimatedNumber.

Time

<time>

Une valeur temporelle <time> est un nombre <number> immédiatement suivi par une unité temporelle. Les unités temporelles sont les suivantes :

  • ms: millisecondes
  • s: secondes

Transform-list

<transform-list>

<transform-list> est utilisé pour spécifier une liste de systèmes de coordonnées pour transformation. Une description détaillée des valeurs disponibles pour ce type de contenu est donnée dans la définition de l'attribut transform.

Dans le DOM SVG, une valeur <transform-list> est représenté via SVGTransformList ou un objet SVGAnimatedTransformList.

URL

URL

Un localisateur d'adresses unifiées.

Un URL est une séquence de caractères Unicode constituant une adresse vers une ressource interne ou externe.

Avant l'utilisation du SVG 2, des contenus plus limités de type IRI étaient utilisés à la place des URL. En effet, la spécification URL n'était pas encore standardisée à ce moment.

Étiquettes et contributeurs liés au document

Étiquettes : 
 Contributeurs à cette page : AlexisColin
 Dernière mise à jour par : AlexisColin,