Evite flash de texto invisível

Katie Hempenius
Katie Hempenius

Este codelab mostra como exibir texto imediatamente usando o Font Face Observer.

Adicionar o Font Face Observer

O Font Face Observer é um script que detecta quando uma fonte é carregada. O arquivo fontfaceobserver.js já foi salvo no diretório do projeto. Portanto, você não precisa adicioná-lo separadamente. No entanto, você precisa adicionar uma tag de script para ele.

  • Clique em Remixar para editar para tornar o projeto editável.
  • Adicione uma tag de script para fontfaceobserver.js em index.html:
  <div class="text">Some text.</div>
  <script src="fontfaceobserver.js" type="text/javascript"></script>
</body>

Usar o Font Face Observer

Criar observadores

Crie um observador para cada família de fontes usada na página.

  • Adicione o script a seguir após o fontfaceobserver.js. Isso cria observadores para as famílias de fontes " Pacifico" e "Roboto":
  <script src="fontfaceobserver.js" type="text/javascript"></script>
  <script type="text/javascript">
    const pacificoObserver = new FontFaceObserver('Pacifico');
    const robotoObserver = new FontFaceObserver('Roboto');
  </script>
<body>

Se você não souber quais observadores de tipo de fonte precisa criar, basta procurar as declarações font-family no CSS. Transmita o nome font-family dessas declarações para FontFaceObserver(). Não é necessário criar um observador para fontes de fallback.

Por exemplo, se o CSS foi:

font-family: "Times New Roman", Times, serif;

adicione FontFaceObserver('Times New Roman'). Times e serifa são fontes substitutas. Por isso, não é necessário declarar FontFaceObservers para elas.

Detectar carregamento de fonte

O código para detectar um carregamento de fonte tem a seguinte aparência:

robotoObserver.load().then(function(){
  console.log("Hooray! Font loaded.");
});

robotoObserver.load() é uma promessa que é resolvida quando a fonte é carregada.

O site de demonstração usa duas fontes diferentes. Portanto, use Promise.all() para aguardar o carregamento das duas.

  • Adicione essa promessa ao script, logo abaixo dos FontFaceObservers que você acabou de declarar:
Promise.all([
  pacificoObserver.load(),
  robotoObserver.load()
]).then(function(){
  /* Do things */
});

✔️Acompanhamento

Seu script ficará assim:

<script type="text/javascript">
const pacificoObserver = new FontFaceObserver('Pacifico');
const robotoObserver = new FontFaceObserver('Roboto');

Promise.all([
  pacificoObserver.load(),
  robotoObserver.load()
]).then(function(){
  /* Do things */
});
</script>

Aplicar classe fonts-loaded

  • Substitua o comentário /* Do things */ no script por esta linha:
document.documentElement.classList.add("fonts-loaded");

Isso adiciona a classe fonts-loaded ao elemento raiz do documento (a tag <html>) depois que as duas fontes são carregadas.

✔️Acompanhamento

O script concluído ficará assim:

<script type="text/javascript">
  const pacificoObserver = new FontFaceObserver('Pacifico');
  const robotoObserver = new FontFaceObserver('Roboto');

  Promise.all([
    pacificoObserver.load(),
    robotoObserver.load()
  ]).then(function(){
    document.documentElement.className += " fonts-loaded";
  });
</script>

Atualizar CSS

O estilo da página precisa ser feito para usar inicialmente uma fonte do sistema e fontes personalizadas depois que a classe fonts-loaded for aplicada.

  • Atualize o CSS:
.header {
html.fonts-loaded .header {
  font-family: 'Pacifico', cursive;
}

.text
html.fonts-loaded .text {
  font-family: 'Roboto', sans-serif;
}

Verificar

  • Para visualizar o site, pressione Ver app. Em seguida, pressione Tela cheia modo tela cheia.

Se a página tiver essa aparência, significa que você implementou o Font Face Observer e se livrou do "Flash of Invisible Text".

Título em fonte cursiva.