chrome.fontSettings

Descrição

Use a API chrome.fontSettings para gerenciar as configurações de fonte do Chrome.

Permissões

fontSettings

Para usar a API Font Settings, é necessário declarar a permissão "fontSettings" na extensão manifesto do app. Exemplo:

{
  "name": "My Font Settings Extension",
  "description": "Customize your fonts",
  "version": "0.2",
  "permissions": [
    "fontSettings"
  ],
  ...
}

Conceitos e uso

O Chrome permite que algumas configurações de fonte dependam de determinadas famílias de fontes genéricas e idiomas scripts. Por exemplo, a fonte usada em chinês simplificado sem serifa pode ser diferente da fonte usado em japonês com serifa.

As famílias de fontes genéricas compatíveis com o Chrome são baseadas em famílias de fontes genéricas do CSS e são listadas em GenericReference. Quando uma página da Web especifica uma família de fontes genérica, o Chrome seleciona a fonte com base na configuração correspondente. Se nenhuma família de fontes genérica for especificada, o Chrome usará a para a configuração "padrão", família de fontes genérica.

Quando uma página da Web especifica um idioma, o Chrome seleciona a fonte com base na configuração do script do idioma correspondente. Se nenhum idioma for especificado, o Chrome usará a configuração para o padrão, ou global.

Os scripts de linguagem suportados são especificados pelo código de script ISO 15924 e listados em ScriptCode Tecnicamente, as configurações do Chrome não são estritamente por script, mas também dependem idioma de destino. Por exemplo, o Chrome escolhe a fonte para cirílico (código de script ISO 15924 "Cyrl") quando um especifica o idioma russo e usa essa fonte não apenas para o script cirílico, mas para tudo o que a fonte cobre, como o latim.

Exemplos

O código a seguir recebe a fonte padrão em árabe.

chrome.fontSettings.getFont(
  { genericFamily: 'standard', script: 'Arab' },
  function(details) { console.log(details.fontId); }
);

O próximo snippet define a fonte sans-serif para japonês.

chrome.fontSettings.setFont(
  { genericFamily: 'sansserif', script: 'Jpan', fontId: 'MS PGothic' }
);

Para testar essa API, instale o exemplo da APIfontSettings em chrome-extension-samples repositório de dados.

Tipos

FontName

Representa um nome de fonte.

Propriedades

  • displayName

    string

    O nome de exibição da fonte.

  • fontId

    string

    O ID da fonte.

GenericFamily

Uma família de fontes genérica de CSS.

Enumeração

"padrão"

"sansserif"

"serif"

"corrigido"

"cursivo"

"fantasia"

"matemática"

LevelOfControl

Um de not\_controllable: não pode ser controlado por nenhuma extensão controlled\_by\_other\_extensions: controlado por extensões com maior precedência controllable\_by\_this\_extension: pode ser controlado por esta extensão controlled\_by\_this\_extension: controlado por esta extensão

Enumeração

"not_controllable"

"controlled_by_other_extensions"

"controllable_by_this_extension"

"controlled_by_this_extension"

ScriptCode

Um código de script ISO 15924. O script padrão ou global é representado pelo código de script "Zyyy".

Enumeração

"Afak"

"Árabe"

"Armi"

"Armn"

"Avst"

"Bali"

"Bamu"

Grave

"Batk"

"Beng"

"Blis"

"Bopo"

"Brah"

"Brai"

"Bugi"

"Buhd"

"Cakm"

"Latas"

"Carla"

"Cham"

"Queria"

"Cirt"

"Usar"

"Cprt"

"Cyrl"

"Caros"

"Deva"

"Dsrt"

"Duplo"

"Egyd"

"Egyh"

"Egip"

"Elba"

"Ethi"

"Geor"

"Geok"

"Glag"

"Gótico"

"Gran"

"Grek"

"Gujr"

"Guru"

"Suspender"

"Hani"

"Hano"

"Hans"

"Hant"

"Hebra"

"Hluw"

"Hmng"

"Pendido"

"Inds"

"Ital"

"Java"

"Jpan"

"Jurc"

"Kali"

"Cara"

"Khmr"

"Khoj"

"Knda"

"Kpel"

"Kthi"

"Lana"

"Laoo"

"Latf"

"Latg"

"Latn"

"Lepc"

"Limb"

"Lina"

"Linb"

"Lisu"

"Loma"

"Lyci"

"Lídi"

"Mand"

"Mani"

"Maia"

"Corrigir"

"Merc"

"Mero"

"Mlym"

"Lua"

"Mong"

"Mroo"

"Mtei"

"Mymr"

"Narb"

"Nbat"

"Nkgb"

"Nkoo"

"Nshu"

"Ogam"

"Olck"

"Orkh"

"Orya"

"Osma"

"Palma"

"Perm"

"Phag"

"Phli"

"Phlp"

"Phlv"

"Phnx"

"Plrd"

"Prti"

"Rjng"

"Roro"

"Runr"

"Samr"

"Sara"

"Sarb"

"Saur"

"Sgnw"

"Shaw"

"Shrd"

"Sind"

"Sinh"

"Sora"

"Sund"

"Sylo"

"Syrc"

"Syre"

"Syrj"

"Syrn"

Tagb

Takr

"Conto"

"Talu"

"Taml"

"Tang"

"Tavt"

"Telu"

"Teng"

"Tfng"

"Tglg"

"Thaa"

"Tailandês"

"Tibt"

"Tirh"

"Ugar"

"Vaidi"

"Visp"

"Wara"

"Wole"

Xpeo,

"Xsux"

"Aiiii"

"Zmth"

"Zsym"

"Zyyy"

Métodos

clearDefaultFixedFontSize()

Promessa 
chrome.fontSettings.clearDefaultFixedFontSize(
  details?: object,
  callback?: function,
)

Limpa o tamanho de fonte fixo padrão definido por esta extensão, se houver.

Parâmetros

  • detalhes

    objeto opcional

    Esse parâmetro não está sendo usado no momento.

  • callback

    função opcional

    O parâmetro callback tem esta aparência: 

    () => void

Retorna

  • Promessa<void>

    Chrome 96 ou versão mais recente

    O Manifesto V3 e versões mais recentes oferecem suporte a promessas, mas callbacks são fornecidos para a compatibilidade com versões anteriores. Não é possível usar ambos na mesma chamada de função. A promessa é resolvida com o mesmo tipo passado ao retorno de chamada.

clearDefaultFontSize()

Promessa 
chrome.fontSettings.clearDefaultFontSize(
  details?: object,
  callback?: function,
)

Limpa o tamanho da fonte padrão definido pela extensão, se houver.

Parâmetros

  • detalhes

    objeto opcional

    Esse parâmetro não está sendo usado no momento.

  • callback

    função opcional

    O parâmetro callback tem esta aparência: 

    () => void

Retorna

  • Promessa<void>

    Chrome 96 ou versão mais recente

    O Manifesto V3 e versões mais recentes oferecem suporte a promessas, mas callbacks são fornecidos para a compatibilidade com versões anteriores. Não é possível usar ambos na mesma chamada de função. A promessa é resolvida com o mesmo tipo passado ao retorno de chamada.

clearFont()

Promessa 
chrome.fontSettings.clearFont(
  details: object,
  callback?: function,
)

Limpa a fonte definida por essa extensão, se houver.

Parâmetros

  • detalhes

    objeto

    • genericFamily

      GenericFamily

      A família genérica de fontes para a qual a fonte deve ser apagada.

    • script

      ScriptCode opcional

      O script em que a fonte deve ser apagada. Se omitido, a configuração de fonte do script global será limpa.

  • callback

    função opcional

    O parâmetro callback tem esta aparência: 

    () => void

Retorna

  • Promessa<void>

    Chrome 96 ou versão mais recente

    O Manifesto V3 e versões mais recentes oferecem suporte a promessas, mas callbacks são fornecidos para a compatibilidade com versões anteriores. Não é possível usar ambos na mesma chamada de função. A promessa é resolvida com o mesmo tipo passado ao retorno de chamada.

clearMinimumFontSize()

Promessa 
chrome.fontSettings.clearMinimumFontSize(
  details?: object,
  callback?: function,
)

Limpa o tamanho mínimo da fonte definido pela extensão, se houver.

Parâmetros

  • detalhes

    objeto opcional

    Esse parâmetro não está sendo usado no momento.

  • callback

    função opcional

    O parâmetro callback tem esta aparência: 

    () => void

Retorna

  • Promessa<void>

    Chrome 96 ou versão mais recente

    O Manifesto V3 e versões mais recentes oferecem suporte a promessas, mas callbacks são fornecidos para a compatibilidade com versões anteriores. Não é possível usar ambos na mesma chamada de função. A promessa é resolvida com o mesmo tipo passado ao retorno de chamada.

getDefaultFixedFontSize()

Promessa 
chrome.fontSettings.getDefaultFixedFontSize(
  details?: object,
  callback?: function,
)

Recebe o tamanho padrão para fontes de largura fixa.

Parâmetros

  • detalhes

    objeto opcional

    Esse parâmetro não está sendo usado no momento.

  • callback

    função opcional

    O parâmetro callback tem esta aparência: 

    (details: object) => void

    • detalhes

      objeto

      • levelOfControl

        LevelOfControl

        O nível de controle que esta extensão tem sobre a configuração.

      • pixelSize

        number

        O tamanho da fonte em pixels.

Retorna

  • Promise&lt;object&gt;

    Chrome 96 ou versão mais recente

    O Manifesto V3 e versões mais recentes oferecem suporte a promessas, mas callbacks são fornecidos para a compatibilidade com versões anteriores. Não é possível usar ambos na mesma chamada de função. A promessa é resolvida com o mesmo tipo passado ao retorno de chamada.

getDefaultFontSize()

Promessa 
chrome.fontSettings.getDefaultFontSize(
  details?: object,
  callback?: function,
)

Recebe o tamanho da fonte padrão.

Parâmetros

  • detalhes

    objeto opcional

    Esse parâmetro não está sendo usado no momento.

  • callback

    função opcional

    O parâmetro callback tem esta aparência: 

    (details: object) => void

    • detalhes

      objeto

      • levelOfControl

        LevelOfControl

        O nível de controle que esta extensão tem sobre a configuração.

      • pixelSize

        number

        O tamanho da fonte em pixels.

Retorna

  • Promise&lt;object&gt;

    Chrome 96 ou versão mais recente

    O Manifesto V3 e versões mais recentes oferecem suporte a promessas, mas callbacks são fornecidos para a compatibilidade com versões anteriores. Não é possível usar ambos na mesma chamada de função. A promessa é resolvida com o mesmo tipo passado ao retorno de chamada.

getFont()

Promessa 
chrome.fontSettings.getFont(
  details: object,
  callback?: function,
)

Recebe a fonte de um determinado script e família de fontes genérica.

Parâmetros

  • detalhes

    objeto

    • genericFamily

      GenericFamily

      A família genérica de fontes para a qual a fonte deve ser recuperada.

    • script

      ScriptCode opcional

      O script para o qual a fonte deve ser recuperada. Se omitido, a configuração de fonte do script global (código de script "Zyyy") é recuperada.

  • callback

    função opcional

    O parâmetro callback tem esta aparência: 

    (details: object) => void

    • detalhes

      objeto

      • fontId

        string

        O ID da fonte. Em vez do valor de preferência do ID de fonte literal, pode ser o ID da fonte para a qual o sistema resolve o valor de preferência. Portanto, fontId pode ser diferente da fonte transmitida para setFont se, por exemplo, a fonte não estiver disponível no sistema. A string vazia indica substituto para a configuração de fonte do script global.

      • levelOfControl

        LevelOfControl

        O nível de controle que esta extensão tem sobre a configuração.

Retorna

  • Promise&lt;object&gt;

    Chrome 96 ou versão mais recente

    O Manifesto V3 e versões mais recentes oferecem suporte a promessas, mas callbacks são fornecidos para a compatibilidade com versões anteriores. Não é possível usar ambos na mesma chamada de função. A promessa é resolvida com o mesmo tipo passado ao retorno de chamada.

getFontList()

Promessa 
chrome.fontSettings.getFontList(
  callback?: function,
)

Recebe uma lista de fontes no sistema.

Parâmetros

  • callback

    função opcional

    O parâmetro callback tem esta aparência: 

    (results: FontName[]) => void

Retorna

  • Promise&lt;FontName[]&gt;

    Chrome 96 ou versão mais recente

    O Manifesto V3 e versões mais recentes oferecem suporte a promessas, mas callbacks são fornecidos para a compatibilidade com versões anteriores. Não é possível usar ambos na mesma chamada de função. A promessa é resolvida com o mesmo tipo passado ao retorno de chamada.

getMinimumFontSize()

Promessa 
chrome.fontSettings.getMinimumFontSize(
  details?: object,
  callback?: function,
)

Recebe o tamanho mínimo da fonte.

Parâmetros

  • detalhes

    objeto opcional

    Esse parâmetro não está sendo usado no momento.

  • callback

    função opcional

    O parâmetro callback tem esta aparência: 

    (details: object) => void

    • detalhes

      objeto

      • levelOfControl

        LevelOfControl

        O nível de controle que esta extensão tem sobre a configuração.

      • pixelSize

        number

        O tamanho da fonte em pixels.

Retorna

  • Promise&lt;object&gt;

    Chrome 96 ou versão mais recente

    O Manifesto V3 e versões mais recentes oferecem suporte a promessas, mas callbacks são fornecidos para a compatibilidade com versões anteriores. Não é possível usar ambos na mesma chamada de função. A promessa é resolvida com o mesmo tipo passado ao retorno de chamada.

setDefaultFixedFontSize()

Promessa 
chrome.fontSettings.setDefaultFixedFontSize(
  details: object,
  callback?: function,
)

Define o tamanho padrão para fontes de largura fixa.

Parâmetros

  • detalhes

    objeto

    • pixelSize

      number

      O tamanho da fonte em pixels.

  • callback

    função opcional

    O parâmetro callback tem esta aparência: 

    () => void

Retorna

  • Promessa<void>

    Chrome 96 ou versão mais recente

    O Manifesto V3 e versões mais recentes oferecem suporte a promessas, mas callbacks são fornecidos para a compatibilidade com versões anteriores. Não é possível usar ambos na mesma chamada de função. A promessa é resolvida com o mesmo tipo passado ao retorno de chamada.

setDefaultFontSize()

Promessa 
chrome.fontSettings.setDefaultFontSize(
  details: object,
  callback?: function,
)

Define o tamanho da fonte padrão.

Parâmetros

  • detalhes

    objeto

    • pixelSize

      number

      O tamanho da fonte em pixels.

  • callback

    função opcional

    O parâmetro callback tem esta aparência: 

    () => void

Retorna

  • Promessa<void>

    Chrome 96 ou versão mais recente

    O Manifesto V3 e versões mais recentes oferecem suporte a promessas, mas callbacks são fornecidos para a compatibilidade com versões anteriores. Não é possível usar ambos na mesma chamada de função. A promessa é resolvida com o mesmo tipo passado ao retorno de chamada.

setFont()

Promessa 
chrome.fontSettings.setFont(
  details: object,
  callback?: function,
)

Define a fonte de um script e uma família de fontes genérica.

Parâmetros

  • detalhes

    objeto

    • fontId

      string

      O ID da fonte. A string vazia significa substituir a configuração de fonte do script global.

    • genericFamily

      GenericFamily

      É a família genérica de fontes para a qual a fonte precisa ser definida.

    • script

      ScriptCode opcional

      O código do script em que a fonte precisa ser definida. Se omitido, a configuração de fonte do script global (código de script "Zyyy") é definida.

  • callback

    função opcional

    O parâmetro callback tem esta aparência: 

    () => void

Retorna

  • Promessa<void>

    Chrome 96 ou versão mais recente

    O Manifesto V3 e versões mais recentes oferecem suporte a promessas, mas callbacks são fornecidos para a compatibilidade com versões anteriores. Não é possível usar ambos na mesma chamada de função. A promessa é resolvida com o mesmo tipo passado ao retorno de chamada.

setMinimumFontSize()

Promessa 
chrome.fontSettings.setMinimumFontSize(
  details: object,
  callback?: function,
)

Define o tamanho mínimo da fonte.

Parâmetros

  • detalhes

    objeto

    • pixelSize

      number

      O tamanho da fonte em pixels.

  • callback

    função opcional

    O parâmetro callback tem esta aparência: 

    () => void

Retorna

  • Promessa<void>

    Chrome 96 ou versão mais recente

    O Manifesto V3 e versões mais recentes oferecem suporte a promessas, mas callbacks são fornecidos para a compatibilidade com versões anteriores. Não é possível usar ambos na mesma chamada de função. A promessa é resolvida com o mesmo tipo passado ao retorno de chamada.

Eventos

onDefaultFixedFontSizeChanged

chrome.fontSettings.onDefaultFixedFontSizeChanged.addListener(
  callback: function,
)

Disparado quando a configuração de tamanho de fonte fixo padrão é alterada.

Parâmetros

  • callback

    função

    O parâmetro callback tem esta aparência: 

    (details: object) => void

    • detalhes

      objeto

      • levelOfControl

        LevelOfControl

        O nível de controle que esta extensão tem sobre a configuração.

      • pixelSize

        number

        O tamanho da fonte em pixels.

onDefaultFontSizeChanged

chrome.fontSettings.onDefaultFontSizeChanged.addListener(
  callback: function,
)

Disparado quando a configuração de tamanho de fonte padrão é alterada.

Parâmetros

  • callback

    função

    O parâmetro callback tem esta aparência: 

    (details: object) => void

    • detalhes

      objeto

      • levelOfControl

        LevelOfControl

        O nível de controle que esta extensão tem sobre a configuração.

      • pixelSize

        number

        O tamanho da fonte em pixels.

onFontChanged

chrome.fontSettings.onFontChanged.addListener(
  callback: function,
)

Disparado quando uma configuração de fonte é alterada.

Parâmetros

  • callback

    função

    O parâmetro callback tem esta aparência: 

    (details: object) => void

    • detalhes

      objeto

      • fontId

        string

        O ID da fonte. Consulte a descrição em getFont.

      • genericFamily

        GenericFamily

        É a família genérica de fontes em que a configuração da fonte mudou.

      • levelOfControl

        LevelOfControl

        O nível de controle que esta extensão tem sobre a configuração.

      • script

        ScriptCode opcional

        O código do script em que a configuração da fonte foi alterada.

onMinimumFontSizeChanged

chrome.fontSettings.onMinimumFontSizeChanged.addListener(
  callback: function,
)

Disparado quando a configuração de tamanho mínimo de fonte é alterada.

Parâmetros

  • callback

    função

    O parâmetro callback tem esta aparência: 

    (details: object) => void

    • detalhes

      objeto

      • levelOfControl

        LevelOfControl

        O nível de controle que esta extensão tem sobre a configuração.

      • pixelSize

        number

        O tamanho da fonte em pixels.