chrome.fontSettings

ब्यौरा

Chrome की फ़ॉन्ट सेटिंग मैनेज करने के लिए, chrome.fontSettings एपीआई का इस्तेमाल करें.

अनुमतियां

fontSettings

Font Settings API का इस्तेमाल करने के लिए, आपको एक्सटेंशन मेनिफ़ेस्ट में "fontSettings" अनुमति के बारे में एलान करना होगा. उदाहरण के लिए:

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

कॉन्सेप्ट और इस्तेमाल

Chrome, कुछ फ़ॉन्ट सेटिंग को सामान्य फ़ॉन्ट फ़ैमिली और भाषा स्क्रिप्ट पर निर्भर रहने की अनुमति देता है. उदाहरण के लिए, सेरिफ़ के बिना वाली आसान चाइनीज़ भाषा के लिए इस्तेमाल किया गया फ़ॉन्ट, सेरिफ़ वाली जापानी भाषा के लिए इस्तेमाल किए गए फ़ॉन्ट से अलग हो सकता है.

Chrome में काम करने वाली जेनरिक फ़ॉन्ट फ़ैमिली, सीएसएस जेनरिक फ़ॉन्ट फ़ैमिली पर आधारित होती हैं. इन्हें GenericReference में लिस्ट किया गया है. जब कोई वेब पेज सामान्य फ़ॉन्ट फ़ैमिली के बारे में बताता है, तो Chrome उससे जुड़ी सेटिंग के आधार पर फ़ॉन्ट चुनता है. अगर कोई सामान्य फ़ॉन्ट फ़ैमिली नहीं दी गई है, तो Chrome, "स्टैंडर्ड" सामान्य फ़ॉन्ट फ़ैमिली के लिए सेटिंग का इस्तेमाल करता है.

जब कोई वेब पेज किसी भाषा के बारे में बताता है, तो Chrome उस भाषा की स्क्रिप्ट की सेटिंग के आधार पर फ़ॉन्ट चुनता है. अगर कोई भाषा नहीं चुनी जाती है, तो Chrome, डिफ़ॉल्ट या ग्लोबल स्क्रिप्ट के लिए सेट की गई सेटिंग का इस्तेमाल करता है.

भाषा की स्क्रिप्ट के लिए, आईएसओ 15924 स्क्रिप्ट कोड तय किया जाता है. यह कोड ScriptCode में दिया गया है. तकनीकी तौर पर, Chrome की सेटिंग हर स्क्रिप्ट के हिसाब से नहीं होती हैं. ये भाषा पर भी निर्भर करती हैं. उदाहरण के लिए, जब कोई वेब पेज रूसी भाषा के बारे में बताता है, तो Chrome सिरिलिक (आईएसओ 15924 स्क्रिप्ट कोड "Cyrl") के लिए फ़ॉन्ट चुनता है. साथ ही, इस फ़ॉन्ट का इस्तेमाल सिर्फ़ सिरिलिक स्क्रिप्ट के लिए नहीं, बल्कि फ़ॉन्ट में शामिल हर चीज़ के लिए करता है. जैसे, लैटिन.

उदाहरण

नीचे दिए गए कोड से, ऐरेबिक के लिए स्टैंडर्ड फ़ॉन्ट मिलता है.

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' }
);

इस एपीआई को आज़माने के लिए, chrome-extension-samples रिपॉज़िटरी से fontSettings API का उदाहरण इंस्टॉल करें.

टाइप

FontName

यह फ़ॉन्ट के नाम को दिखाता है.

प्रॉपर्टी

  • displayName

    स्ट्रिंग

    फ़ॉन्ट का डिसप्ले नेम.

  • fontId

    स्ट्रिंग

    फ़ॉन्ट आईडी.

GenericFamily

यह सीएसएस की एक सामान्य फ़ॉन्ट फ़ैमिली है.

Enum

"standard"

"sansserif"

"serif"

"fixed"

"cursive"

"fantasy"

"math"

LevelOfControl

इनमें से कोई एक not\_controllable: इसे किसी भी एक्सटेंशन से कंट्रोल नहीं किया जा सकता controlled\_by\_other\_extensions: इसे ज़्यादा प्राथमिकता वाले एक्सटेंशन से कंट्रोल किया जाता है controllable\_by\_this\_extension: इसे इस एक्सटेंशन से कंट्रोल किया जा सकता है controlled\_by\_this\_extension: इसे इस एक्सटेंशन से कंट्रोल किया जाता है

Enum

"not_controllable"

"controlled_by_other_extensions"

"controllable_by_this_extension"

"controlled_by_this_extension"

ScriptCode

आईएसओ 15924 स्क्रिप्ट कोड. डिफ़ॉल्ट या ग्लोबल स्क्रिप्ट को स्क्रिप्ट कोड "Zyyy" से दिखाया जाता है.

Enum

"Afak"

"Arab"

"Armi"

"Armn"

"Avst"

"Bali"

"Bamu"

"Bass"

"Batk"

"Beng"

"Blis"

"Bopo"

"Brah"

"Brai"

"Bugi"

"Buhd"

"Cakm"

"Cans"

"Cari"

"Cham"

"Cher"

"Cirt"

"Copt"

"Cprt"

"Cyrl"

"Cyrs"

"Deva"

"Dsrt"

"Dupl"

"Egyd"

"Egyh"

"Egyp"

"Elba"

"Ethi"

"Geor"

"Geok"

"Glag"

"Goth"

"Gran"

"Grek"

"Gujr"

"Guru"

"Hang"

"Hani"

"Hano"

"Hans"

"Hant"

"Hebr"

"Hluw"

"Hmng"

"Hung"

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

"Moon"

"Mong"

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

"Thai"

"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 पैरामीटर ऐसा दिखता है: 

    (details: object) => void

    • विवरण

      ऑब्जेक्ट

      • levelOfControl

        LevelOfControl

        इस एक्सटेंशन के पास सेटिंग को कंट्रोल करने का लेवल.

      • pixelSize

        संख्या

        पिक्सल में फ़ॉन्ट का साइज़.

onDefaultFontSizeChanged

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

जब फ़ॉन्ट के डिफ़ॉल्ट साइज़ की सेटिंग बदलती है, तब यह इवेंट ट्रिगर होता है.

पैरामीटर

  • कॉलबैक

    फ़ंक्शन

    callback पैरामीटर ऐसा दिखता है: 

    (details: object) => void

    • विवरण

      ऑब्जेक्ट

      • levelOfControl

        LevelOfControl

        इस एक्सटेंशन के पास सेटिंग को कंट्रोल करने का लेवल.

      • pixelSize

        संख्या

        पिक्सल में फ़ॉन्ट का साइज़.

onFontChanged

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

फ़ॉन्ट की सेटिंग में बदलाव होने पर ट्रिगर होता है.

पैरामीटर

  • कॉलबैक

    फ़ंक्शन

    callback पैरामीटर ऐसा दिखता है: 

    (details: object) => void

    • विवरण

      ऑब्जेक्ट

      • fontId

        स्ट्रिंग

        फ़ॉन्ट आईडी. getFont में मौजूद जानकारी देखें.

      • genericFamily

        GenericFamily

        वह सामान्य फ़ॉन्ट फ़ैमिली जिसके लिए फ़ॉन्ट सेटिंग बदली गई है.

      • levelOfControl

        LevelOfControl

        इस एक्सटेंशन के पास सेटिंग को कंट्रोल करने का लेवल.

      • स्क्रिप्ट

        ScriptCode ज़रूरी नहीं है

        वह स्क्रिप्ट कोड जिसके लिए फ़ॉन्ट की सेटिंग बदली गई है.

onMinimumFontSizeChanged

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

यह इवेंट तब ट्रिगर होता है, जब फ़ॉन्ट के कम से कम साइज़ की सेटिंग बदलती है.

पैरामीटर

  • कॉलबैक

    फ़ंक्शन

    callback पैरामीटर ऐसा दिखता है: 

    (details: object) => void

    • विवरण

      ऑब्जेक्ट

      • levelOfControl

        LevelOfControl

        इस एक्सटेंशन के पास सेटिंग को कंट्रोल करने का लेवल.

      • pixelSize

        संख्या

        पिक्सल में फ़ॉन्ट का साइज़.