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>()
-
URL-адрес, указывающий на внешний ресурс (к примеру, изображение). Если ресурс не может быть отображён, он игнорируется или отображается значение по умолчанию.
<image>
(en-US)-
<image>
(en-US), указанный типом данных<url>()
или<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-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> )
<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>
<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>
<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
<image> =
<url> | (en-US)
<gradient> (en-US)
<url> =
<url()> | (en-US)
<src()>
<url()> =
url( <string> (en-US) <url-modifier>* (en-US) ) | (en-US)
<url-token>
<src()> =
src( <string> (en-US) <url-modifier>* (en-US) )
Примеры
Заголовки и двойные кавычки
В этом примере вставляются кавычки вокруг кавычек а добавляет слово "Глава" перед заголовками.
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 и некоторые комбинации вспомогательных технологий/браузеров не будут его объявлять. Если контент содержит информацию, которая имеет решающее значение для понимания цели страницы, лучше включить её в основной документ.
Спецификации
Specification |
---|
CSS Generated Content Module Level 3 # content-property |
Поддержка браузерами
BCD tables only load in the browser