Модуль Простору імен CSS

1. Вступ

Цей розділ не є нормативним.

Цей модуль простору імен CSS визначає синтаксис для використання просторів імен у CSS. Він визначає правило @namespace для оголошення простору імен за замовчуванням, та для зв'язування просторів імен з їх префіксами. Він також визначає синтаксис для використання цих префіксів, щоб надати повні імена просторів імен. Він не визначає, де такі імена дійсні, або, що вони означають: що залежить від їх контексту та визначається базовою мовою, такою як Селектори ([SELECT]), яка посилається на синтаксис, визначений у модулі просторів імен CSS.

Зверніть увагу, що клієнт CSS, який не підтримує цей модуль, буде (якщо він належним чином відповідає до CSS's forward-compatible parsing rules) ігнорувати усі правила @namespace, а також усі правила стилів, які використовують повні імена просторів імен. Синтаксис розмежованих префіксів простору імен у CSS, було навмисно обрано таким чином, щоб ці клієнти CSS скоріш ігнорували правила стилів, ніж зіставляли їх некоректно.

2. Відповідність

Документ або відповідність не можуть відповідати простору імен CSS по одинці, але можуть претендувати на відповідність до Просторів імен CSS, якщо він задовольняє вимогам відповідності у цій специфікації при впровадженні CSS або іншої базової мови, яка нормативно посилається до цієї специфікації.

Відповідність просторів імен CSS визначено у двох класах:

таблиця стилів

Таблиця стилів CSS (або повноцінний модуль іншої базової мови, яка нормативно надає Простори імен CSS).

інтерпретатор

Хтось або щось інтерпретує семантику таблиці стилів. (під цю категорію підпадають користувацькі агенти (user agents) CSS.)

Відповідність до вимог виражені у поєднанні описових тверджень та термінології документа RFC 2119. Ключові слова ПОВИНЕН ("MUST"), НЕ ПОВИНЕН ("MUST NOT"), НЕОБХІДНИЙ ("REQUIRED"), МУСИТЬ ("SHALL"), НЕ МУСИТЬ ("SHALL NOT"), СЛІД ("SHOULD"), НЕ СЛІД ("SHOULD NOT"), РЕКОМЕНДУЄТЬСЯ ("RECOMMENDED"), МОЖЕ ("MAY"), ТА НЕОБОВ'ЯЗКОВО ("OPTIONAL") у нормативних частинах цього документу повинні бути інтерпретовані так, як це змальовано у документі RFC 2119. Тем не менш, для зручності читання, у даній специфікації ці слова не з'являються у верхньому регістрі. Весь текст даної специфікації є нормативним, за виключенням тих розділів які явно позначені як ненормативні, приклади або примітки.[RFC2119]

Приклади у цій специфікації починаються зі слова "наприклад" або відокремлені від нормативного тексту та виділені класом - class="example", як наведено нижче:

Інформативні примітки починаються зі слова "Примітка" та встановлюються окремо від нормативного тексту з класом class="note", як наведено нижче:

Примітка, це інформативна примітка.

2.1. Термінологія

Кажучи про терміни, які представлені у цій специфікації, то Простори імен CSS використовують термінологію визначену у Просторі імен XML 1.0. [XML-NAMES] Однак, синтаксис який визначено тут, не обмежується поданням імен елементів та атрибутів XML і може представляти інші види просторів імен, як це визначено базовою мовою.

У Просторах імен CSS, ім'я простору імен, яке містить порожню строку, прийнято представляти як, нульовий простір імен або відсутність простору імен.

@namespace empty "";
@namespace "";

3. Оголошення просторів імен: правило @namespace

По-правило @namespace, оголошує префікс простору імен та пов'язує його з заданим ім'ям простору імен (рядок). Цей префікс простору імен може бути використаний у повних іменах просторів імен, у якості повних імен CSS, які визначені нижче.

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

У Просторах імен CSS, як і в Просторах імен у XML 1.0, префікс є всього лише синтаксичною конструкцією; це повне ім'я (складається з локальної назви та назви простору імен) яке є дуже значимим. Таким чином, діючі префікси використовуються у таблиці стилів CSS, та в залежності від префіксів простору імен, що використовуються у розмітці, вони являються або за замовчуванням або ні.

<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. Синтаксис

Синтаксис для правила @namespace, виглядає наступним чином (використовуючи позначення з Додатку Граматика у CSS 2.1 [CSS21]):

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

з новою лексемою:

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

Будь-які правила @namespace повинні слідувати усім правилам @charset та @import і передувати усім іншим не проігнорованим по-правилам(at-rules) та наборам правил у таблиці стилів. Для синтаксису CSS добавляють [ namespace [S|CDO|CDC]* ]* одразу після [ import [S|CDO|CDC]* ]* у граматиці stylesheet.

Синтаксично некоректне правило @namespace (або погано сформоване, або невірно розміщене) повинно бути проігноровано. Таблиця стилів CSS, яка містить у собі недійсне правило @namespace, не є коректною таблицею стилів.

Рядок URI, який отримано з синтаксису URI, повинен бути розглянутий, як символьний рядок: як і з синтаксисом STRING, ніяких специфічних нормалізацій URI не застосовується.

Усі строки,—включаючи порожню строку та строки, які представляють недійсні URI,—є дійсними іменами просторів імен у оголошеннях @namespace.

3.2. Область дії

Префікс простору імен оголошується тільки з таблицею стилів у якій це правило @namespace з'являється. Він не оголошується ні в будь-яких таблицях стилів імпортованих або, які імпортуються цією таблицею стилів, ні в будь-яких інших таблицях стилів, які застосовуються до документу.

3.3. Оголошення Префіксів

Одного разу оголошений префікс простору імен, представляє простір імен для якого він був оголошений та може бути використаний для позначення простору імен повної назви. Також як і лічильник імен CSS, префікси простору імен чутливі до регістру.

Якщо в оголошенні простору імен опущений префікс, тоді оголошений простір імен є простором імен за замовчуванням. Простір імен за замовчуванням може застосовуватися до імен які не мають явного префіксу простору імен: модулі, які використовують префікси простору імен повинні визначити у якому контексті застосовується простір імен за замовчуванням. Наприклад, наступний [XML-NAMES], у Селекторах [SELECT] простір імен за замовчуванням застосовується до типів селекторів—але воно не застосовується до атрибутів селекторів. Для простору імен за замовчуванням, не існує значення за замовчуванням: модулі, які присвоюють неповні імена простору імен за замовчуванням, повинні визначатися як їх неповні імена, та повинні бути інтерпретовані, коли простір імен за замовчуванням не оголошено.

Відзначте, що використання просторів імен за замовчуванням в поєднанні з типами селекторів, може призвести до користувацьких агентів (далі КА, з англ. user agents, скор. - UA), які підтримують простори імен за замовчуванням та КА, які не підтримують простори імен за замовчуванням для різної інтерпретації селекторів.

Якщо префікс простору імен або простір імен за замовчуванням оголошено більш ніж один раз, в такому випадку буде використовуватися тільки останнє оголошення. Оголошення префіксу простору імен або простору імен за замовчуванням більше одного разу є неузгодженим.

4. Повні назви CSS

Повна назва CSS - це назва, яка явно розташоване в межах простору імен, або пов'язана з ним. Для формування повної назви у синтаксисі CSS, префікс простору імен, який було оголошено у його області дії, додається до локальної назви (наприклад, ім'я атрибуту або елементу), та розділяється "вертикальною рискою" (|, U+007C). Префікс, що представляє простір імен для якого він був оголошений, вказує на простір імен локальної назви. Префікс повної назви, може бути не вказаний, щоб вказати, що назва не належить жодному простору імен, тобто, що частина повної назви простору імен не має значення. Деякі контексти (як це визначено у базовій мові), можуть дозволяти використання зірочки (*, U+002A) у якості шаблону префікса, щоб вказати назву у будь-якому просторі імен, зокрема і поза простору імен.

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

Синтаксис для частини повної назви CSS, перш ніж наводиться нижче локальне ім'я, призначений як для повних назв, які дозволяють використовувати шаблони префіксів (wqname), так і для повних назв, які забороняють використання шаблонів префіксів (qname). (Синтаксис використовує позначення з Граматичного додатку CSS 2.1. [CSS21] Зверніть увагу, це означає, що непрямим чином допускаються коментарі між лексемами, але не допускається порожній простір(пробіли) між ними.):

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

Повні назви CSS можуть бути використані, наприклад, в селекторах і у властивостях значень, як описано в інших модулях. Ці модулі повинні визначати обробку префіксів простору імен, які не були оголошені належним чином. Така обробка повинна розглядати неоголошені префікси просторів імен, як помилку розбору, яка призводить до того, що селектор або оголошення (та інші), повинні бути визнані недійсними і в CSS, проігноровані.