chrome.fontSettings

คำอธิบาย

ใช้ chrome.fontSettings API เพื่อจัดการการตั้งค่าแบบอักษรของ Chrome

สิทธิ์

fontSettings

หากต้องการใช้ Font Settings API คุณต้องประกาศสิทธิ์ "fontSettings" ใน extension manifest เช่น

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

แนวคิดและการใช้งาน

Chrome อนุญาตให้การตั้งค่าแบบอักษรบางอย่างขึ้นอยู่กับตระกูลแบบอักษรทั่วไปและสคริปต์ภาษา บางอย่าง เช่น แบบอักษรที่ใช้สำหรับภาษาจีนตัวย่อแบบไม่มีเชิงอาจแตกต่างจากแบบอักษรที่ใช้สำหรับภาษาญี่ปุ่นแบบมีเชิง

ชุดแบบอักษรทั่วไปที่ Chrome รองรับจะอิงตามชุดแบบอักษรทั่วไปของ CSS และแสดงอยู่ในส่วน GenericReference เมื่อหน้าเว็บระบุชุดแบบอักษรทั่วไป Chrome จะเลือก แบบอักษรตามการตั้งค่าที่เกี่ยวข้อง หากไม่ได้ระบุชุดแบบอักษรทั่วไป Chrome จะใช้การตั้งค่าสำหรับชุดแบบอักษรทั่วไป "มาตรฐาน"

เมื่อหน้าเว็บระบุภาษา Chrome จะเลือกแบบอักษรตามการตั้งค่าสำหรับ สคริปต์ภาษาที่เกี่ยวข้อง หากไม่ได้ระบุภาษา Chrome จะใช้การตั้งค่าสำหรับสคริปต์เริ่มต้น หรือสคริปต์ส่วนกลาง

ระบบจะระบุสคริปต์ภาษาที่รองรับด้วยรหัสสคริปต์ ISO 15924 และแสดงไว้ในส่วน ScriptCode ในทางเทคนิคแล้ว การตั้งค่า Chrome ไม่ได้ขึ้นอยู่กับสคริปต์เท่านั้น แต่ยังขึ้นอยู่กับ ภาษาด้วย ตัวอย่างเช่น Chrome จะเลือกแบบอักษรสำหรับซีริลลิก (รหัสสคริปต์ "Cyrl" ของ ISO 15924) เมื่อหน้าเว็บระบุภาษารัสเซีย และจะใช้แบบอักษรนี้ไม่เพียงแต่สำหรับสคริปต์ซีริลลิกเท่านั้น แต่ยังใช้กับทุกอย่างที่แบบอักษรครอบคลุม เช่น ละติน

ตัวอย่าง

โค้ดต่อไปนี้จะรับแบบอักษรมาตรฐานสำหรับภาษาอาหรับ

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

ข้อมูลโค้ดถัดไปจะตั้งค่าแบบอักษร Sans-Serif สำหรับภาษาญี่ปุ่น

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

หากต้องการลองใช้ API นี้ ให้ติดตั้งตัวอย่าง API ของ fontSettings จากที่เก็บ chrome-extension-samples

ประเภท

FontName

แสดงชื่อแบบอักษร

พร็อพเพอร์ตี้

  • displayName

    สตริง

    ชื่อที่แสดงของแบบอักษร

  • fontId

    สตริง

    รหัสแบบอักษร

GenericFamily

ชุดแบบอักษรทั่วไปของ CSS

ค่าแจกแจง

"standard"

"sansserif"

"serif"

"fixed"

"cursive"

"แฟนตาซี"

"math"

LevelOfControl

อย่างใดอย่างหนึ่งต่อไปนี้ not\_controllable: ส่วนขยายใดๆ ควบคุมไม่ได้ controlled\_by\_other\_extensions: ส่วนขยายที่มีลำดับความสำคัญสูงกว่าควบคุม controllable\_by\_this\_extension: ส่วนขยายนี้ควบคุมได้ controlled\_by\_this\_extension: ส่วนขยายนี้ควบคุม

ค่าแจกแจง

"not_controllable"

"controlled_by_other_extensions"

"controllable_by_this_extension"

"controlled_by_this_extension"

ScriptCode

รหัสสคริปต์ ISO 15924 สคริปต์เริ่มต้นหรือสคริปต์ทั่วโลกจะแสดงด้วยรหัสสคริปต์ "Zyyy"

ค่าแจกแจง

"Afak"

"อาหรับ"

"Armi"

"Armn"

"Avst"

"บาหลี"

"Bamu"

"Bass"

"Batk"

"Beng"

"Blis"

"Bopo"

"Brah"

"Brai"

"Bugi"

"Buhd"

"Cakm"

"กระป๋อง"

"Cari"

"Cham"

"Cher"

"Cirt"

"Copt"

"Cprt"

"Cyrl"

"Cyrs"

"Deva"

"Dsrt"

"Dupl"

"Egyd"

"Egyh"

"อียิปต์"

"Elba"

"Ethi"

"Geor"

"Geok"

"Glag"

"โกธิค"

"Gran"

"Grek"

"Gujr"

"กูรู"

"Hang"

"Hani"

"Hano"

"ฮันส์"

"Hant"

"Hebr"

"Hluw"

"Hmng"

"หิว"

"Inds"

"Ital"

"Java"

"Jpan"

"Jurc"

"Kali"

"Khar"

"Khmr"

"Khoj"

"Knda"

"Kpel"

"Kthi"

"Lana"

"Laoo"

"Latf"

"Latg"

"Latn"

"Lepc"

"Limb"

"Lina"

"Linb"

"Lisu"

"Loma"

"Lyci"

"Lydi"

"Mand"

"Mani"

"Maya"

"Mend"

"Merc"

"Mero"

"Mlym"

"ดวงจันทร์"

"มอง"

"Mroo"

"Mtei"

"Mymr"

"Narb"

"Nbat"

"Nkgb"

"Nkoo"

"Nshu"

"Ogam"

"Olck"

"Orkh"

"Orya"

"Osma"

"Palm"

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

"Tale"

"Talu"

"Taml"

"Tang"

"Tavt"

"Telu"

"Teng"

"Tfng"

"Tglg"

"Thaa"

"ไทย"

"Tibt"

"Tirh"

"Ugar"

"Vaii"

"Visp"

"Wara"

"Wole"

"Xpeo"

"Xsux"

"Yiii"

"Zmth"

"Zsym"

"Zyyy"

เมธอด

clearDefaultFixedFontSize()

chrome.fontSettings.clearDefaultFixedFontSize(
  details?: object,
): Promise<void>

ล้างขนาดแบบอักษรคงที่เริ่มต้นที่ส่วนขยายนี้ตั้งค่าไว้ (หากมี)

พารามิเตอร์

  • รายละเอียด

    object ไม่บังคับ

    ปัจจุบันพารามิเตอร์นี้ไม่ได้ใช้งาน

การคืนสินค้า

  • Promise<void>

    Chrome 96 ขึ้นไป

clearDefaultFontSize()

chrome.fontSettings.clearDefaultFontSize(
  details?: object,
): Promise<void>

ล้างขนาดแบบอักษรเริ่มต้นที่ส่วนขยายนี้ตั้งค่าไว้ (หากมี)

พารามิเตอร์

  • รายละเอียด

    object ไม่บังคับ

    ปัจจุบันพารามิเตอร์นี้ไม่ได้ใช้งาน

การคืนสินค้า

  • Promise<void>

    Chrome 96 ขึ้นไป

clearFont()

chrome.fontSettings.clearFont(
  details: object,
): Promise<void>

ล้างแบบอักษรที่ส่วนขยายนี้ตั้งค่าไว้ (หากมี)

พารามิเตอร์

  • รายละเอียด

    ออบเจ็กต์

    • genericFamily

      GenericFamily

      ชุดแบบอักษรทั่วไปที่ควรล้างแบบอักษร

    • แบบตัวเขียน

      ScriptCode ไม่บังคับ

      สคริปต์ที่ควรล้างแบบอักษร หากไม่ระบุ ระบบจะล้างการตั้งค่าแบบอักษรของสคริปต์ส่วนกลาง

การคืนสินค้า

  • Promise<void>

    Chrome 96 ขึ้นไป

clearMinimumFontSize()

chrome.fontSettings.clearMinimumFontSize(
  details?: object,
): Promise<void>

ล้างขนาดแบบอักษรขั้นต่ำที่ส่วนขยายนี้ตั้งไว้ (หากมี)

พารามิเตอร์

  • รายละเอียด

    object ไม่บังคับ

    ปัจจุบันพารามิเตอร์นี้ไม่ได้ใช้งาน

การคืนสินค้า

  • Promise<void>

    Chrome 96 ขึ้นไป

getDefaultFixedFontSize()

chrome.fontSettings.getDefaultFixedFontSize(
  details?: object,
): Promise<object>

รับขนาดเริ่มต้นสำหรับแบบอักษรความกว้างคงที่

พารามิเตอร์

  • รายละเอียด

    object ไม่บังคับ

    ปัจจุบันพารามิเตอร์นี้ไม่ได้ใช้งาน

การคืนสินค้า

  • Promise<object>

    Chrome 96 ขึ้นไป

getDefaultFontSize()

chrome.fontSettings.getDefaultFontSize(
  details?: object,
): Promise<object>

รับขนาดแบบอักษรเริ่มต้น

พารามิเตอร์

  • รายละเอียด

    object ไม่บังคับ

    ปัจจุบันพารามิเตอร์นี้ไม่ได้ใช้งาน

การคืนสินค้า

  • Promise<object>

    Chrome 96 ขึ้นไป

getFont()

chrome.fontSettings.getFont(
  details: object,
): Promise<object>

รับแบบอักษรสำหรับสคริปต์และชุดแบบอักษรทั่วไปที่ระบุ

พารามิเตอร์

  • รายละเอียด

    ออบเจ็กต์

    • genericFamily

      GenericFamily

      ชุดแบบอักษรทั่วไปที่ควรดึงแบบอักษรมา

    • แบบตัวเขียน

      ScriptCode ไม่บังคับ

      สคริปต์ที่ควรดึงแบบอักษร หากไม่ระบุ ระบบจะดึงการตั้งค่าแบบอักษรสำหรับสคริปต์ส่วนกลาง (รหัสสคริปต์ "Zyyy")

การคืนสินค้า

  • Promise<object>

    Chrome 96 ขึ้นไป

getFontList()

chrome.fontSettings.getFontList(): Promise<FontName[]>

รับรายการแบบอักษรในระบบ

การคืนสินค้า

  • Promise<FontName[]>

    Chrome 96 ขึ้นไป

getMinimumFontSize()

chrome.fontSettings.getMinimumFontSize(
  details?: object,
): Promise<object>

รับขนาดแบบอักษรขั้นต่ำ

พารามิเตอร์

  • รายละเอียด

    object ไม่บังคับ

    ปัจจุบันพารามิเตอร์นี้ไม่ได้ใช้งาน

การคืนสินค้า

  • Promise<object>

    Chrome 96 ขึ้นไป

setDefaultFixedFontSize()

chrome.fontSettings.setDefaultFixedFontSize(
  details: object,
): Promise<void>

กำหนดขนาดเริ่มต้นสำหรับแบบอักษรที่มีความกว้างคงที่

พารามิเตอร์

  • รายละเอียด

    ออบเจ็กต์

    • pixelSize

      ตัวเลข

      ขนาดแบบอักษรในหน่วยพิกเซล

การคืนสินค้า

  • Promise<void>

    Chrome 96 ขึ้นไป

setDefaultFontSize()

chrome.fontSettings.setDefaultFontSize(
  details: object,
): Promise<void>

ตั้งค่าขนาดแบบอักษรเริ่มต้น

พารามิเตอร์

  • รายละเอียด

    ออบเจ็กต์

    • pixelSize

      ตัวเลข

      ขนาดแบบอักษรในหน่วยพิกเซล

การคืนสินค้า

  • Promise<void>

    Chrome 96 ขึ้นไป

setFont()

chrome.fontSettings.setFont(
  details: object,
): Promise<void>

กำหนดแบบอักษรสำหรับสคริปต์และชุดแบบอักษรทั่วไป

พารามิเตอร์

  • รายละเอียด

    ออบเจ็กต์

    • fontId

      สตริง

      รหัสแบบอักษร สตริงว่างหมายถึงการกลับไปใช้การตั้งค่าแบบอักษรของสคริปต์ส่วนกลาง

    • genericFamily

      GenericFamily

      ชุดแบบอักษรทั่วไปที่ควรตั้งค่าแบบอักษร

    • แบบตัวเขียน

      ScriptCode ไม่บังคับ

      รหัสสคริปต์ที่ควรตั้งค่าแบบอักษร หากไม่ระบุ ระบบจะตั้งค่าแบบอักษรสำหรับสคริปต์ส่วนกลาง (รหัสสคริปต์ "Zyyy")

การคืนสินค้า

  • Promise<void>

    Chrome 96 ขึ้นไป

setMinimumFontSize()

chrome.fontSettings.setMinimumFontSize(
  details: object,
): Promise<void>

กำหนดขนาดแบบอักษรขั้นต่ำ

พารามิเตอร์

  • รายละเอียด

    ออบเจ็กต์

    • pixelSize

      ตัวเลข

      ขนาดแบบอักษรในหน่วยพิกเซล

การคืนสินค้า

  • Promise<void>

    Chrome 96 ขึ้นไป

กิจกรรม

onDefaultFixedFontSizeChanged

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

ทริกเกอร์เมื่อการตั้งค่าขนาดแบบอักษรคงที่เริ่มต้นมีการเปลี่ยนแปลง

พารามิเตอร์

  • callback

    ฟังก์ชัน

    พารามิเตอร์ callback มีลักษณะดังนี้ 

    (details: object) => void

    • รายละเอียด

      ออบเจ็กต์

      • levelOfControl

        LevelOfControl

        ระดับการควบคุมที่ส่วนขยายนี้มีในการตั้งค่า

      • pixelSize

        ตัวเลข

        ขนาดแบบอักษรในหน่วยพิกเซล

onDefaultFontSizeChanged

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

ทริกเกอร์เมื่อการตั้งค่าขนาดแบบอักษรเริ่มต้นเปลี่ยนแปลง

พารามิเตอร์

  • callback

    ฟังก์ชัน

    พารามิเตอร์ callback มีลักษณะดังนี้ 

    (details: object) => void

    • รายละเอียด

      ออบเจ็กต์

      • levelOfControl

        LevelOfControl

        ระดับการควบคุมที่ส่วนขยายนี้มีในการตั้งค่า

      • pixelSize

        ตัวเลข

        ขนาดแบบอักษรในหน่วยพิกเซล

onFontChanged

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

ทริกเกอร์เมื่อมีการเปลี่ยนแปลงการตั้งค่าแบบอักษร

พารามิเตอร์

  • callback

    ฟังก์ชัน

    พารามิเตอร์ callback มีลักษณะดังนี้ 

    (details: object) => void

    • รายละเอียด

      ออบเจ็กต์

      • fontId

        สตริง

        รหัสแบบอักษร ดูคำอธิบายใน getFont

      • genericFamily

        GenericFamily

        ตระกูลแบบอักษรทั่วไปที่มีการเปลี่ยนแปลงการตั้งค่าแบบอักษร

      • levelOfControl

        LevelOfControl

        ระดับการควบคุมที่ส่วนขยายนี้มีในการตั้งค่า

      • แบบตัวเขียน

        ScriptCode ไม่บังคับ

        รหัสสคริปต์ที่มีการเปลี่ยนแปลงการตั้งค่าแบบอักษร

onMinimumFontSizeChanged

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

เรียกใช้เมื่อการตั้งค่าขนาดแบบอักษรขั้นต่ำมีการเปลี่ยนแปลง

พารามิเตอร์

  • callback

    ฟังก์ชัน

    พารามิเตอร์ callback มีลักษณะดังนี้ 

    (details: object) => void

    • รายละเอียด

      ออบเจ็กต์

      • levelOfControl

        LevelOfControl

        ระดับการควบคุมที่ส่วนขยายนี้มีในการตั้งค่า

      • pixelSize

        ตัวเลข

        ขนาดแบบอักษรในหน่วยพิกเซล