Modulul pentru Spații de Nume CSS

1. Introducere

Această secțiune nu este normativă.

Acest modul CSS de Spații de Nume definește sintaxa pentru folosirea spațiilor de nume în CSS. Definește regula @namespace pentru a declara un spațiu de nume implicit și legarea spațiilor de nume de prefixele spațiilor de nume, și desemenea definește sintaxa pe care alte specificații pot adopta pentru folosirea acelor prefixe în numele calificat de spații de nume. Nu definește unde aceste nume sunt valide sau ce reprezintă: asta depinde de contextul lor și este definită de o limbă gazdă, cum ar fi Selectors ([SELECT]), referențiere la sintaxa definită în modulul CSS de Spații de Nume.

Observați că un client CSS care nu suportă acest modul va ( dacă se conformează corect la regulile de parsare compatibile a CSS-ului) ignora toate regulile @namespace , la fel și toate regulile de stilizare care se folosesc de numele calificate de spații de nume. Sintaxa de delimitare a prefixelor spațiilor de nume în CSS a fost în mod deliberat ales astfel încât acești clienți CSS să ignore regulili de stil în loc să le potrivească incorect.

2. Conformitate

Un document sau o implementare nu se poate conforma singur la Spațiile de Nume CSS, dar poate să solicite conformanța la Spațiul de Nume CSS dacă satisface cerințele de conformitate când implementează CSS sau un alt limbaj gazdă care referențiază în mod normativ acestă specificație.

Conformitatea la Spațiile de Nume CSS este definită pentru două clase:

style sheet

O foaie de stil CSS (sau o unitate completă a unui alt limbaj gazdă care referențiază în mod normativ Spațiile de Nume CSS).

interpreter

Cineva sau ceva care interpretează semantica unei foi de stil. (agenții de utilizator CSS intră sub această incidență.)

Cerințele de conformitate sunt exprimate cu o combinație de aserții descriptive și terminologie RFC 2119. Cuvintele cheie "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", și "OPTIONAL" în părțile normative a acestui document sunt interpretate așa cum este descris în RFC 2119. Oricum, pentru lizibilitate, aceste cuvinte nu apar cu toate literele mari în această specificație. Tot textul din această specificație este normativ cu excepție secțiunile marcate în mod explicit ca find ne-normative, exemplele, și mențiunile. [RFC2119]

Exemplele din această specificare sunt introduse cu cuvintele "de exemplu" sau sunt un set separat de textul normativ cu class="example", în felul următor:

Mențiunile informative încep cu cuvântul "Mențiune" și sunt un set separat de textul normativ cu class="note", în felul următor:

Mențiune, acesta este o mențiune informativă.

2.1. Terminologie

În afară de termenii introdusi de această specificație, Spațiul de Nume CSS folosește terminologia definită în Spațiul de Nume din XML 1.0. [XML-NAMES] Oricum, sintaxa defintă aici nu este restricționată la reprezentarea de element XML și numele de atribute și poate reprezenta alte tipuri de spații de nume așa cum este definit de către limbajul gazdă.

În Spațiul de Nume CSS a numelor de spații de nume a unui șir de caractere gol este folosit la reprezentarea spațiilor de nume goale sau lipsa unui spațiu de nume.

@namespace empty "";
@namespace "";

3. Declararea spațiilor de nume: regula @namespace rule

@namespace at-rule declară un prefix de spațiu de nume și asociază cu el un anumit nume de spațiu de nume (un șir de caractere). Acest prefix de spațiu de nume poate atunci fi folosit în numele calificate de spații de nume cum ar fi Numele calificate CSS definite mai jos.

@namespace "http://www.w3.org/1999/xhtml";
@namespace svg "http://www.w3.org/2000/svg";

În Spațiile de NUme CSS, ca și în Spațiile de Nume din XML 1.0, prefixul este aproape o construcție sintactică; este expanded name (tuplu de nume local și numele de spațiu de nume) care este significant. Prin urmare, prefixele folosite într-o foaie de stil CSS, fie că sunt implicite sau nu, sunt independente de prefixul de spațiu de nume folosit în marcare și fie acestea sunt imiplicite sau nu.

<qml:elem xmlns:qml="http://example.com/q-markup"></qml:elem>

@namespace Q "http://example.com/q-markup";
@namespace lq "http://example.com/q-markup";

3.1. Sintaxa

Sintaxa pentru regula @namespace este așa cum urmează (folosind notația de la Grammar appendix of CSS 2.1 [CSS21]):

namespace
  : NAMESPACE_SYM S* [namespace_prefix S*]? [STRING|URI] S* ';' S*
  ;
namespace_prefix
  : IDENT
  ;

cu o nouă dovadă:

@{N}{A}{M}{E}{S}{P}{A}{C}{E} {return NAMESPACE_SYM;}

Orice regulă @namespace trebuie sa urmeze toate regulile @charset și @import și să precedeze toate regulili at-rules neignorate și regula setează într-o foaie de stil. Pentru sintaxa CSS aceasta adaugă [ namespace [S|CDO|CDC]* ]* imediat după [ import [S|CDO|CDC]* ]* în gramatica stylesheet .

O regulă @namespace invalidă din punct de vedere al sintaxei (fie scrisă greșit sau unde nu trebuie) trebuie să fie ignorată. O foaie de stil CSS care conține o regulă @namespace invalidă, nu este o foaie de stil validă .

Un șir de caractere URI parsat din sintaxa URI trebuie să fie tratat ca un șir de caractere: la fel ca sintaxa STRING, nici o normalizare specifică URI este aplicată.

Toate șirurile de caractere—incluzând șirul de caractere gol și șirurile de caractere care reprezintă adrese invalide URIs—sunt nume valide de spații de nume în declarațiile @namespace .

3.2. Scop

Prefixul spațiului de nume este declarat numai în interiorul foii de stil în care regula @namespace apare. Nu este declarat în nici o foaie de stil care include sau este inclusă, nici în orice altă foaie de stil aplicată documentului.

3.3. Declararea Prefixelor

Un prefix de spațiu de nume, odată declarat, reprezintă spațiul de nume pentru care a fost declarat și nu poate fi folosit în indicarea unui spațiu de nume a unui nume calificat de spațiu de nume. Prefixele de spații de nume sunt, asemenea numelor din CSS, sensibile la litere mari.

Dacă declararea în spațiul de nume a prefixului este omisă, atunci spațiul de nume este declarat ca find spațiul de nume imiplicit. Spațiul de nume implicit poate să aplice la nume care au nici un prefix de spațiu de nume aplicat: modulele care implică prefixele trebuie să definească în ce context spațiul de nume implicit se aplică. De exemplu, urmărind [XML-NAMES], în Selectori [SELECT] spațiul de nume implicit se aplică la selectorii tip—dar nu se aplică la selectorii atribute. Nu există nici o valoare imiplictă pentru spațiul de nume implicit: modulele care atribuie nume necalificate la spațiul de nume implicit trebuie să definească cum aceste nume necalificate trebuie să fie interpretate atunci când nici un spațiu de nume implicit este declarat.

Rețineți că dacă folosiți spațiul de nume implicit în conjuncție cu selectorii tip poate cauza UA-urile care suportă spații de nume implicite și UA-urile care nu suportă spațiile de nume implicite să interpreteze selectorii diferit.

Dacă un prefix a unui spațiu de nume este declarat de mai multe ori numai ultima declarare va fi folosită. Declararea unui prefix de spațiu de nume de mai multe ori nu este conformă.

4. Nume Calificate de CSS

Un nume calificat de CSS este un nume localizat explicit în interiorul (asociat cu) unui spațiu de nume. Pentru a forma un nume calificat în sintaxa CSS, un prefix de spațiu de nume care a fost declarat în scop este pre-atașat unui nume local (cum ar fi un element sau un nume de atribut), separat de o "bară verticală" (|, U+007C). Prefixul, reprezentând spațiul de nume pentru care a fost declarat, indică spațiul de nume a numelui local. Prefixul unui nume calificat poate fi omis pentru a indica că numele nu are nici o valoare. Anumite contexte (definit de limbajul gazdă) poate permite folosirea unui asterix (*, U+002A) ca un prefix special pentru a indic un nume într-un spațiu de nume, incluzând nici un spațiu de nume.

@namespace toto "http://toto.example.org";
@namespace "http://example.com/foo";

Sintaxa pentru bucata de nume calificat CSS înainte de a se da numele local mai jos, amandouă numele calificate care permit prefixe speciale (wqname) și pentru numele calificate care nu permit prefixe speciale (qname). (Sintaxa folosește notația de la Grammar appendix of CSS 2.1. [CSS21] Rețineți ca acest lucru înseamnă că comentarile, dar nici un spațiu alb, sunt implicit permise între dovezi.):

qname_prefix
  : [namespace_prefix]? '|'
  ;
wqname_prefix
  : namespace_prefix? '|'
  | '*' '|'
  ;

Numele de CSS calificate pot fi folosite în (de exemplu) selectori și valorile proprietăți așa cum este descris în alte module. Acest module trebuie să definească manipularea prefixelor de spații de nume care nu au fost declarate corect. Astfel de manipulări trebuie să trateze prefixele nedeclarate a spațiilor de nume ca eroare de parsare care va cauza selectorului sau declarației (etc.) să fie considerată invalidă și, în CSS, ignorată.