chrome.fontSettings

Deskripsi

Gunakan chrome.fontSettings API untuk mengelola setelan font Chrome.

Izin

fontSettings

Untuk menggunakan Font Settings API, Anda harus mendeklarasikan izin "fontSettings" di ekstensi manifes. Contoh:

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

Konsep dan penggunaan

Chrome memungkinkan beberapa setelan font bergantung pada jenis font dan bahasa generik tertentu skrip. Misalnya, {i>font <i}yang digunakan untuk bahasa China Aksara Sederhana sans-serif mungkin berbeda dengan {i>font<i} digunakan untuk bahasa Jepang serif.

Jenis font generik yang didukung oleh Chrome didasarkan pada jenis font umum CSS dan tercantum di bagian GenericReference. Saat halaman web menentukan jenis font generik, Chrome akan memilih {i>font<i} berdasarkan pengaturan yang sesuai. Jika tidak ada jenis font generik yang ditentukan, Chrome akan menggunakan setelan untuk "standar" jenis font generik.

Saat halaman web menentukan bahasa, Chrome akan memilih font berdasarkan setelan untuk skrip bahasa yang sesuai. Jika tidak ada bahasa yang ditentukan, Chrome akan menggunakan setelan default, atau global, skrip.

Skrip bahasa yang didukung ditentukan oleh kode skrip ISO 15924 dan tercantum di bawah ScriptCode Secara teknis, setelan Chrome tidak hanya per skrip, tetapi juga bergantung pada di bahasa target. Misalnya, Chrome memilih font untuk Cyrillic (kode skrip ISO 15924 "Cyrl") saat halaman web menentukan bahasa Rusia, dan menggunakan {i>font<i} ini tidak hanya untuk skrip Sirilik tetapi untuk semua yang dicakup {i>font<i}, seperti huruf Latin.

Contoh

Kode berikut mendapatkan font standar untuk bahasa Arab.

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

Cuplikan berikutnya menetapkan font sans-serif untuk bahasa Jepang.

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

Untuk mencoba API ini, instal contoh fontSettings API dari chrome-extension-samples repositori resource.

Jenis

FontName

Mewakili nama font.

Properti

• Nama Tampilan

  string

  Nama tampilan font.

• fontId

  string

  ID font.

GenericFamily

Jenis font umum CSS.

Enum

"standar"

"sansserif"

"serif"

"diperbaiki"

"kursif"

"fantasi"

"matematika"

LevelOfControl

Salah satu not\_controllable: tidak dapat dikontrol oleh ekstensi apa pun controlled\_by\_other\_extensions: dikontrol oleh ekstensi dengan prioritas lebih tinggi controllable\_by\_this\_extension: dapat dikontrol oleh ekstensi ini controlled\_by\_this\_extension: dikontrol oleh ekstensi ini

Enum

"not_controllable"

&quot;controlled_by_other_extensions&quot;

&quot;controllable_by_this_extension&quot;

&quot;controlled_by_this_extension&quot;

ScriptCode

Kode skrip ISO 15924. Skrip default, atau global, diwakili oleh kode skrip "Zyyy".

Enum

"Afak"

"Arab"

"Armi"

"Senjata"

"Avst"

"Bali"

"Bamu"

"Bas"

"Batk"

"Beng"

"Kebahagiaan"

"Bopo"

"Brah"

"Brai"

"Bugi"

"Buhd"

"Cakm"

"Botol"

"Cari"

"Cham"

"Beri semangat"

"Cirt"

"Copt"

"Cprt"

"Cyrl"

"Cyrs"

"Deva"

"Dsrt"

"Duplikat"

"Canggih"

"Egih"

"Egip"

"Elba"

"Ethi"

"Geor"

"Geok"

"Glag"

"Got"

"Gran"

"Grek"

"Gujr"

"Guru"

"Hang"

"Hani"

"Hano"

"Hans"

"Hant"

"Hebr"

"Hluw"

"Hmng"

"Hung"

"Ind"

"Miring"

"Java"

"Jepang"

"Jurc"

"Kali"

"Khar"

"Khmr"

"Khoj"

"Knda"

"Kpel"

"Kthi"

"Lana"

"Laoo"

"Latf"

"Latg"

"Lintang"

"Lepc"

"Limb"

"Lina"

"Lina"

"Lisu"

"Loma"

"Lyci"

"Lydi"

"Mand"

"Mani"

"Maya"

"Mend"

"Merc"

"Mero"

"Mlym"

"Bulan"

"Mong"

"Mroo"

"Mtei"

"Mymr"

"Narb"

"Nbat"

"Nkgb"

"Nkoo"

"Nshu"

"Ogam"

"Olck"

"Orkh"

"Orya"

"Osma"

"Palem"

"Perm"

"Phag"

"Phli"

"Phlp"

"Phlv"

"Phnx"

"Plrd"

"Prti"

"Rjng"

"Roro"

"Runr"

"Samr"

"Sara"

"Sarb"

"Saur"

"Sgnw"

"Shaw"

"Shrd"

"Sind"

"Sinh"

"Sura"

"Minggu"

"Sylo"

"Syrc"

"Syre"

"Syrj"

"Syrn"

"Tagb"

"Takr"

"Kisah"

"Talu"

"Taml"

"Tang"

"Tavt"

"Telu"

"Teng"

"Tfng"

"Tglg"

"Terima kasih"

"Thailand"

"Tibt"

"Tirh"

"Ugar"

"Vaii"

"Visp"

"Wara"

"Wole"

"Xpeo"

"Xsux"

"Yiii"

"Zmth"

"Zsym"

"Zyyy"

Metode

clearDefaultFixedFontSize()

Janji

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

Menghapus ukuran font tetap default yang ditetapkan oleh ekstensi ini, jika ada.

Parameter

• detail

  objek opsional

  Parameter ini saat ini tidak digunakan.

• callback

  fungsi opsional

  Parameter callback terlihat seperti ini:

  () => void

Hasil

• Janji<void>

  Chrome 96 dan yang lebih baru

  Promise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Tujuan promise yang di-resolve dengan jenis yang sama dengan yang diteruskan ke callback.

clearDefaultFontSize()

Janji

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

Menghapus ukuran font default yang ditetapkan oleh ekstensi ini, jika ada.

Parameter

• detail

  objek opsional

  Parameter ini saat ini tidak digunakan.

• callback

  fungsi opsional

  Parameter callback terlihat seperti ini:

  () => void

Hasil

• Janji<void>

  Chrome 96 dan yang lebih baru

  Promise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Tujuan promise yang di-resolve dengan jenis yang sama dengan yang diteruskan ke callback.

clearFont()

Janji

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

Menghapus font yang ditetapkan oleh ekstensi ini, jika ada.

Parameter

• detail

  objek

  • genericFamily

    GenericFamily

    Jenis font generik yang font-nya harus dihapus.

  • skrip

    ScriptCode opsional

    Skrip yang fontnya harus dihapus. Jika dihilangkan, setelan font skrip global akan dihapus.

• callback

  fungsi opsional

  Parameter callback terlihat seperti ini:

  () => void

Hasil

• Janji<void>

  Chrome 96 dan yang lebih baru

  Promise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Tujuan promise yang di-resolve dengan jenis yang sama dengan yang diteruskan ke callback.

clearMinimumFontSize()

Janji

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

Menghapus ukuran font minimum yang ditetapkan oleh ekstensi ini, jika ada.

Parameter

• detail

  objek opsional

  Parameter ini saat ini tidak digunakan.

• callback

  fungsi opsional

  Parameter callback terlihat seperti ini:

  () => void

Hasil

• Janji<void>

  Chrome 96 dan yang lebih baru

  Promise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Tujuan promise yang di-resolve dengan jenis yang sama dengan yang diteruskan ke callback.

getDefaultFixedFontSize()

Janji

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

Mendapatkan ukuran default untuk font dengan lebar tetap.

Parameter

• detail

  objek opsional

  Parameter ini saat ini tidak digunakan.

• callback

  fungsi opsional

  Parameter callback terlihat seperti ini:

  (details: object) => void

  • detail

    objek

    • levelOfControl

      LevelOfControl

      Tingkat kontrol yang dimiliki ekstensi ini atas setelan.

    • pixelSize

      angka

      Ukuran font dalam piksel.

Hasil

• Promise&lt;object&gt;

  Chrome 96 dan yang lebih baru

  Promise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Tujuan promise yang di-resolve dengan jenis yang sama dengan yang diteruskan ke callback.

getDefaultFontSize()

Janji

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

Mendapatkan ukuran font default.

Parameter

• detail

  objek opsional

  Parameter ini saat ini tidak digunakan.

• callback

  fungsi opsional

  Parameter callback terlihat seperti ini:

  (details: object) => void

  • detail

    objek

    • levelOfControl

      LevelOfControl

      Tingkat kontrol yang dimiliki ekstensi ini atas setelan.

    • pixelSize

      angka

      Ukuran font dalam piksel.

Hasil

• Promise&lt;object&gt;

  Chrome 96 dan yang lebih baru

  Promise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Tujuan promise yang di-resolve dengan jenis yang sama dengan yang diteruskan ke callback.

getFont()

Janji

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

Mendapatkan font untuk skrip tertentu dan jenis font generik.

Parameter

• detail

  objek

  • genericFamily

    GenericFamily

    Jenis font generik yang akan diambil fontnya.

  • skrip

    ScriptCode opsional

    Skrip yang akan diambil fontnya. Jika dihilangkan, setelan font untuk skrip global (kode skrip "Zyyy") diambil.

• callback

  fungsi opsional

  Parameter callback terlihat seperti ini:

  (details: object) => void

  • detail

    objek

    • fontId

      string

      ID font. Bukan nilai preferensi ID font literal, ini mungkin ID font yang di-resolve sistem menjadi nilai preferensi. Jadi, fontId dapat berbeda dari font yang diteruskan ke setFont, jika, misalnya, font tidak tersedia di sistem. String kosong menandakan penggantian ke setelan font skrip global.

    • levelOfControl

      LevelOfControl

      Tingkat kontrol yang dimiliki ekstensi ini atas setelan.

Hasil

• Promise&lt;object&gt;

  Chrome 96 dan yang lebih baru

  Promise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Tujuan promise yang di-resolve dengan jenis yang sama dengan yang diteruskan ke callback.

getFontList()

Janji

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

Mendapatkan daftar font di sistem.

Parameter

• callback

  fungsi opsional

  Parameter callback terlihat seperti ini:

  (results: FontName[]) => void

  • hasil

    FontName[]

Hasil

• Promise&lt;FontName[]&gt;

  Chrome 96 dan yang lebih baru

  Promise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Tujuan promise yang di-resolve dengan jenis yang sama dengan yang diteruskan ke callback.

getMinimumFontSize()

Janji

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

Mendapatkan ukuran font minimum.

Parameter

• detail

  objek opsional

  Parameter ini saat ini tidak digunakan.

• callback

  fungsi opsional

  Parameter callback terlihat seperti ini:

  (details: object) => void

  • detail

    objek

    • levelOfControl

      LevelOfControl

      Tingkat kontrol yang dimiliki ekstensi ini atas setelan.

    • pixelSize

      angka

      Ukuran font dalam piksel.

Hasil

• Promise&lt;object&gt;

  Chrome 96 dan yang lebih baru

  Promise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Tujuan promise yang di-resolve dengan jenis yang sama dengan yang diteruskan ke callback.

setDefaultFixedFontSize()

Janji

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

Menetapkan ukuran default untuk font dengan lebar tetap.

Parameter

• detail

  objek

  • pixelSize

    angka

    Ukuran font dalam piksel.

• callback

  fungsi opsional

  Parameter callback terlihat seperti ini:

  () => void

Hasil

• Janji<void>

  Chrome 96 dan yang lebih baru

  Promise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Tujuan promise yang di-resolve dengan jenis yang sama dengan yang diteruskan ke callback.

setDefaultFontSize()

Janji

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

Menetapkan ukuran font default.

Parameter

• detail

  objek

  • pixelSize

    angka

    Ukuran font dalam piksel.

• callback

  fungsi opsional

  Parameter callback terlihat seperti ini:

  () => void

Hasil

• Janji<void>

  Chrome 96 dan yang lebih baru

  Promise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Tujuan promise yang di-resolve dengan jenis yang sama dengan yang diteruskan ke callback.

setFont()

Janji

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

Menetapkan font untuk skrip tertentu dan jenis font generik.

Parameter

• detail

  objek

  • fontId

    string

    ID font. String kosong berarti kembali ke setelan font skrip global.

  • genericFamily

    GenericFamily

    Jenis font generik yang fontnya harus ditetapkan.

  • skrip

    ScriptCode opsional

    Kode skrip yang harus disetel dengan font. Jika dihilangkan, setelan font untuk skrip global (kode skrip "Zyyy") akan disetel.

• callback

  fungsi opsional

  Parameter callback terlihat seperti ini:

  () => void

Hasil

• Janji<void>

  Chrome 96 dan yang lebih baru

  Promise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Tujuan promise yang di-resolve dengan jenis yang sama dengan yang diteruskan ke callback.

setMinimumFontSize()

Janji

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

Menetapkan ukuran font minimum.

Parameter

• detail

  objek

  • pixelSize

    angka

    Ukuran font dalam piksel.

• callback

  fungsi opsional

  Parameter callback terlihat seperti ini:

  () => void

Hasil

• Janji<void>

  Chrome 96 dan yang lebih baru

  Promise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Tujuan promise yang di-resolve dengan jenis yang sama dengan yang diteruskan ke callback.

Acara

onDefaultFixedFontSizeChanged

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

Diaktifkan saat setelan ukuran font tetap default berubah.

Parameter

• callback

  fungsi

  Parameter callback terlihat seperti ini:

  (details: object) => void

  • detail

    objek

    • levelOfControl

      LevelOfControl

      Tingkat kontrol yang dimiliki ekstensi ini atas setelan.

    • pixelSize

      angka

      Ukuran font dalam piksel.

onDefaultFontSizeChanged

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

Diaktifkan saat setelan ukuran font default berubah.

Parameter

• callback

  fungsi

  Parameter callback terlihat seperti ini:

  (details: object) => void

  • detail

    objek

    • levelOfControl

      LevelOfControl

      Tingkat kontrol yang dimiliki ekstensi ini atas setelan.

    • pixelSize

      angka

      Ukuran font dalam piksel.

onFontChanged

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

Diaktifkan saat setelan font berubah.

Parameter

• callback

  fungsi

  Parameter callback terlihat seperti ini:

  (details: object) => void

  • detail

    objek

    • fontId

      string

      ID font. Lihat deskripsi di getFont.

    • genericFamily

      GenericFamily

      Jenis font generik yang setelan fontnya telah diubah.

    • levelOfControl

      LevelOfControl

      Tingkat kontrol yang dimiliki ekstensi ini atas setelan.

    • skrip

      ScriptCode opsional

      Kode skrip yang setelan fontnya telah diubah.

onMinimumFontSizeChanged

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

Diaktifkan saat setelan ukuran font minimum berubah.

Parameter

• callback

  fungsi

  Parameter callback terlihat seperti ini:

  (details: object) => void

  • detail

    objek

    • levelOfControl

      LevelOfControl

      Tingkat kontrol yang dimiliki ekstensi ini atas setelan.

    • pixelSize

      angka

      Ukuran font dalam piksel.