content
=======

A propriedade CSS **`content`** é usada com os pseudoelementos `::before` e `::after` para gerar conteúdo em um elemento. Objetos inseridos usando a propriedade `content` são *elementos substituídos (en-US) anônimos*.


```css
/\* Palavras-chave que não podem ser combinadas com outros valores \*/
content: normal;
content: none;

/\* Valores <string> com caracteres especiais devem ser escritos \*/
/\* com escape Unicode, por exemplo \00A0 para &nbsp; \*/
content: "prefixo";

/\* Valores <url> \*/
content: url("http://www.example.com/test.png");

/\* Valores <counter> \*/
content: counter(contador_capitulo);
content: counters(contador_secao, ".");

/\* Valores attr() associados ao valor do atributo HTML \*/
content: attr(valor string);

/\* Palavras-chave que variam com o idioma e posição \*/
content: open-quote;
content: close-quote;
content: no-open-quote;
content: no-close-quote;

/\* Com exceção de normal e none, vários valores \*/
/\* podem ser usados simultaneamente \*/
content: open-quote chapter_counter;

/\* Valores globais \*/
content: inherit;
content: initial;
content: unset;
```


|  |  |
| --- | --- |
| Initial value | `normal` |
| Aplica-se a | All elements, tree-abiding pseudo-elements, and page margin boxes |
| Inherited | não |
| Computed value | On elements, always computes to `normal`. On `::before` and `::after`, if `normal` is specified, computes to `none`. Otherwise, for URI values, the absolute URI; for `attr()` values, the resulting string; for other keywords, as specified. |
| Animation type | discrete |

Sintaxe
-------

### Valores

`none`

O pseudoelemento não será gerado.

`normal`

Equivalente a `none` para os pseudoelementos `::before` e `::after`.

`<string>` (en-US)

Um ou mais caracteres de texto.

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

Uma URL que designa um recurso externo (como uma imagem). Se o recurso não puder ser exibido, ele será ignorado ou um *placeholder* será exibido no seu lugar.

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

O valor de um contador CSS, geralmente um número. Ele pode ser exibido usando a função `counter()` (en-US) ou `counters()` (en-US).

A função `counter()` tem duas formas: 'counter(*nome*)' ou 'counter(*nome*, *estilo*)'. O texto gerado será o valor do contador mais próximo do nome fornecido no pseudoelemento. Ele será formatado com o estilo especificado (o padrão é `decimal`).

A função `counters()` também tem duas formas: 'counters(*nome*, *string*)' ou 'counters(*nome*, *separador*, *estilo*)'. O texto gerado será o valor de todos os contadores com o mesmo nome no escopo do pseudoelemento, do mais afastado ao mais próximo, separados pelo separador especificado. Os contadores serão exibidos no estilo indicado (o padrão é `decimal`).

`attr(x)`

O valor do atributo `x` do elemento. Se não houver um atributo `x`, uma *string* vazia será retornada. A diferenciação de maiúsculas e minúsculas dependerá da linguagem do documento.

`open-quote` | `close-quote`

Esses valores serão substituídos pela *string* apropriada da propriedade `quotes` (en-US).

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

Não introduzem nenhum conteúdo, mas aumentam (ou diminuem) o nível de aninhamento de aspas.

### Sintaxe formal
```

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         
  
```

Exemplos
--------

### Cabeçalhos e citações

Este exemplo insere aspas ao redor de citações e adiciona a palavra "Capítulo" antes dos cabeçalhos.

#### HTML


```html
<h1>5</h1>
<p>
  De acordo com o Sr. Tim Berners-Lee,
  <q cite="https://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
 >
  Devemos entender que não há nada fundamentalmente errado em criar algo com
  base nas contribuições de outras pessoas.
</p>

<h1>6</h1>
<p>
  De acordo com o Manifesto Mozilla,
  <q cite="https://www.mozilla.org/about/manifesto/"
 >As pessoas precisam ter a capacidade de moldar a Internet e suas
    experiências com ela.</q
 >
  Portanto, podemos concluir que contribuir para a Web aberta pode proteger
  nossas próprias experiências individuais nela.
</p>
```


#### CSS


```css
q {
  color: blue;
}

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

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

h1::before {
  content: "Cap\00EDtulo "; /\* O espaço no final cria uma separação
 entre o conteúdo adicionado e o
 resto do conteúdo \*/
}
```


#### Resultado

### Imagem combinada com texto

Este exemplo insere uma imagem antes do *link*. Se a imagem não for encontrada, o texto será exibido no seu lugar.

#### HTML


```html
<a href="https://www.mozilla.org/">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;
}
```


#### Resultado

### Alterando classes específicas

Este exemplo insere texto adicional no final de itens especiais em uma lista.

#### HTML


```html
<h2>Categoriass mais vendidas</h2>
<ol>
  <li>Suspenses políticos</li>
  <li class="new-entry">Histórias de terror</li>
  <li>Biografias</li>
  <li class="new-entry">Romances de Vampiros</li>
</ol>
```


#### CSS


```css
.new-entry::after {
  content: " Novo!"; /\* O espaço no final cria uma separação
 entre o conteúdo adicionado e o
 resto do conteúdo \*/
  color: red;
}
```


#### Resultado

### Imagens e atributos de elementos

Este exemplo insere uma imagem antes de cada *link* e adiciona o conteúdo do seu atributo `id` depois.

#### 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;
}
```


#### Resultado

Especificações
--------------

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

Compatibilidade com navegadores
-------------------------------

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

Veja também
-----------

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