content
=======

CSS-свойство **`content`** заменяет элемент сгенерированным значением. Объекты, добавленные с помощью свойства `content` являются *анонимными* property are *anonymous замещаемыми элементами.*


```css
/\* Ключевые слова, которые нельзя комбинировать с другими значениями \*/
content: normal;
content: none;

/\* Значение <url> \*/
content: url("http://www.example.com/test.png");

/\* Значение <image> \*/
content: linear-gradient(#e66465, #9198e5);

/\* Указанные ниже значения могут быть применены только к сгенерированному контенту с использованием ::before и ::after \*/

/\* Значение <string> \*/
content: "prefix";

/\* Значения <counter> \*/
content: counter(chapter_counter);
content: counters(section_counter, ".");

/\* Значение attr() связано со значением атрибута HTML \*/
content: attr(value string);

/\* Значения <quote> \*/
content: open-quote;
content: close-quote;
content: no-open-quote;
content: no-close-quote;

/\* Несколько значений могут использоваться вместе \*/
content: open-quote chapter_counter;

/\* Глобальные значения \*/
content: inherit;
content: initial;
content: unset;
```


|  |  |
| --- | --- |
| Начальное значение | `normal` |
| Применяется к | All elements, tree-abiding pseudo-elements, and page margin boxes |
| Наследуется | нет |
| Обработка значения | На элементах всегда вычисляется как `normal`. На `::before` и `::after`, если `normal` указано, интерпретируется как `none`. Иначе, для значений URI, абсолютного URI; для значений `attr()` - результирующая строка; для других ключевых слов, как указано. |
| Animation type | discrete |

Синтаксис
---------

### Значения

`none`

Псевдоэлемент не генерируется.

`normal`

Вычисляется `none` для псевдоэлементов `::before` и`::after`.

`<string>` (en-US)

Любое количество текстовых символов. Нелатинские символы должны быть закодированы с использованием их escape-последовательности Unicode: например, `\000A9` представляет собой символ авторского права.

`<url>()` (en-US)

URL-адрес, указывающий на внешний ресурс (к примеру, изображение). Если ресурс не может быть отображён, он игнорируется или отображается значение по умолчанию.

`<image>` (en-US)

`<image>` (en-US), указанный типом данных `<url>()` (en-US) или `<gradient>` (en-US), или частью веб-страницы, определяемой функцией `element()` (en-US), указывающей содержимое для обозначения.

`<counter>()` (en-US)

Значение CSS счётчика, как правило число. Его можно отобразить с помощью функций `counter()` (en-US) или`counters()` (en-US).Функция `counter()` имеет две формы записи: 'counter(*имя*)' или 'counter(*имя*, *стиль*)'. Сгенерированный текст - это значение самого вложенного счётчика с заданным именем в области видимости данного элемента. Он отформатирован в указанном стиле (по умолчанию `decimal`).Функция `counters()` также имеет две формы записи: 'counters(*name*, *string*)' или 'counters(*name*, *string*, *style*)'. Сгенерированный текст - это значение всех счётчиков с заданным именем в области видимости данного элемента, от крайнего к вложенному. разделённых указанной строкой. Счётчики отображаются в указанном стиле (по умолчанию `decimal`).

`attr(x)`

Значение атрибута `x` элемента в виде строки. Если атрибут `x` отсутствует, вернётся пустая строка. Чувствительность к регистру в названии атрибута зависит от языка документа.

`open-quote` | `close-quote`

Эти значения заменяются соответствующей строкой из свойства `quotes` (en-US).

`no-open-quote` | `no-close-quote`

Не вводит никакого содержимого, но увеличивает (уменьшает) уровень вложенности для кавычек.

### Синтаксис
```

content =   
  normal                                              | (en-US)  
  none                                                | (en-US)  
  [ (en-US) <content-replacement> | (en-US) <content-list> ] (en-US) [ (en-US) / [ (en-US) <string> (en-US) | (en-US) <counter> ] (en-US)+ (en-US) ] (en-US)? (en-US)  | (en-US)  
  <element()>                                           
  
<content-replacement> =   
  <image>    
  
<content-list> =   
  [ (en-US) <string> (en-US) | (en-US) <counter()> | (en-US) <counters()> | (en-US) <content()> | (en-US) <attr()> ] (en-US)+ (en-US)    
  
<counter> =   
  <counter()>   | (en-US)  
  <counters()>    
  
<element()> =   
  element( <id-selector> )    
  
<image> =   
  <url>       | (en-US)  
  <gradient> (en-US)    
  
<counter()> =   
  counter( <counter-name> , <counter-style>? (en-US) )    
  
<counters()> =   
  counters( <counter-name> , <string> (en-US) , <counter-style>? (en-US) )    
  
<content()> =   
  content( [ (en-US) text | (en-US) before | (en-US) after | (en-US) first-letter | (en-US) marker ] (en-US)? (en-US) )    
  
<attr()> =   
  attr( <attr-name> <attr-type>? (en-US) , <declaration-value>? (en-US) )    
  
<id-selector> =   
  <hash-token>    
  
<url> =   
  <url()>  | (en-US)  
  <src()>    
  
<counter-style> =   
  <counter-style-name>  | (en-US)  
  <symbols()>             
  
<attr-name> =   
  [ (en-US) <ident-token> '|' ] (en-US)? (en-US) <ident-token>    
  
<attr-type> =   
  string            | (en-US)  
  url               | (en-US)  
  ident             | (en-US)  
  color             | (en-US)  
  number            | (en-US)  
  percentage        | (en-US)  
  length            | (en-US)  
  angle             | (en-US)  
  time              | (en-US)  
  frequency         | (en-US)  
  flex              | (en-US)  
  <dimension-unit>    
  
<url()> =   
  url( <string> (en-US) <url-modifier>\* (en-US) )  | (en-US)  
  <url-token>                        
  
<src()> =   
  src( <string> (en-US) <url-modifier>\* (en-US) )    
  
<symbols()> =   
  symbols( <symbols-type>? (en-US) [ (en-US) <string> (en-US) | (en-US) <image> ] (en-US)+ (en-US) )    
  
<symbols-type> =   
  cyclic      | (en-US)  
  numeric     | (en-US)  
  alphabetic  | (en-US)  
  symbolic    | (en-US)  
  fixed         
  
```

Примеры
-------

### Заголовки и двойные кавычки

В этом примере вставляются кавычки вокруг кавычек а добавляет слово "Глава" перед заголовками.

#### HTML


```html
<h1>5</h1>
<p>
  According to Sir Tim Berners-Lee,
  <q cite="http://www.w3.org/People/Berners-Lee/FAQ.html#Internet"
 >I was lucky enough to invent the Web at the time when the Internet already
    existed - and had for a decade and a half.</q
 >
  We must understand that there is nothing fundamentally wrong with building on
  the contributions of others.
</p>

<h1>6</h1>
<p>
  According to the Mozilla Manifesto,
  <q cite="http://www.mozilla.org/en-US/about/manifesto/"
 >Individuals must have the ability to shape the Internet and their own
    experiences on the Internet.</q
 >
  Therefore, we can infer that contributing to the open web can protect our own
  individual experiences on it.
</p>
```


#### CSS


```css
q {
  color: blue;
}

q::before {
  content: open-quote;
}

q::after {
  content: close-quote;
}

h1::before {
  content: "Chapter "; /\* Пробел в конце создаёт разделение
 между добавленным контентом
 и остальным контентом\*/
}
```


#### Результат

### Изображение в сочетании с текстом

В этом примере вставляется изображение перед ссылкой. Если изображение не найдено, вставляет текст.

#### HTML


```html
<a href="http://www.mozilla.org/en-US/">Mozilla Home Page</a>
```


#### CSS


```css
a::before {
  content: url("https://mozorg.cdn.mozilla.net/media/img/favicon.ico")
    " MOZILLA: ";
  font:
    x-small Arial,
    sans-serif;
  color: gray;
}
```


#### Результат

### Целевые классы

В этом примере вставляется дополнительный текст после указанных элементов списка.

#### HTML


```html
<h2>Paperback Best Sellers</h2>
<ol>
  <li>Political Thriller</li>
  <li class="new-entry">Halloween Stories</li>
  <li>My Biography</li>
  <li class="new-entry">Vampire Romance</li>
</ol>
```


#### CSS


```css
.new-entry::after {
  content: " New!"; /\* Начальный пробел создаёт разделение
 между добавленным контентом
 и остальным контентом \*/
  color: red;
}
```


#### Результат

### Атрибуты изображений и элементов

В этом примере вставляется изображение перед каждой ссылкой и добавляет `id` атрибут после.

#### HTML


```html
<ul>
  <li><a id="moz" href="http://www.mozilla.org/"> Mozilla Home Page</a></li>
  <li>
    <a id="mdn" href="https://developer.mozilla.org/">
      Mozilla Developer Network</a
 >
  </li>
</ul>
```


#### CSS


```css
a {
  text-decoration: none;
  border-bottom: 3px dotted navy;
}

a::after {
  content: " (" attr(id) ")";
}

#moz::before {
  content: url("https://mozorg.cdn.mozilla.net/media/img/favicon.ico");
}

#mdn::before {
  content: url("mdn-favicon16.png");
}

li {
  margin: 1em;
}
```


#### Результат

### Замена элемента

В этом примере содержимое элемента заменяется изображением. Вы можете заменить содержимое элемента либо значением <url> или изменить значение <image> . Содержимое, добавленное с помощью ::before или ::after не будет сгенерировано, поскольку содержимое элемента будет заменено.

#### HTML


```html
<div id="replaced">Mozilla</div>
```


#### CSS


```css
#replaced {
  content: url("mdn.svg");
}

#replaced::after {
  /\* не будет отображаться, если замена элемента поддерживается \*/
  content: " (" attr(id) ")";
}
```


#### Результат

Проблемы доступности
--------------------

Сгенерированный CSS контент не включён в DOM. Из-за этого он не будет представлен в accessibility tree и некоторые комбинации вспомогательных технологий/браузеров не будут его объявлять. Если контент содержит информацию, которая имеет решающее значение для понимания цели страницы, лучше включить её в основной документ.

* Accessibility support for CSS generated content – Tink
* Explanation of WCAG, Guideline 1.3 – MDN (en-US)
* Understanding Success Criterion 1.3.1 | W3C Understanding WCAG 2.0
Спецификации
------------

| Specification |
| --- |
| CSS Generated Content Module Level 3 # content-property |

Совместимость с браузерами
--------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Смотрите также
--------------

* `::after`
* `::before`
* `quotes` (en-US)