browser.fontSettings

ब्यौरा

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

अनुमतियां

fontSettings

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

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

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

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

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

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

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

उदाहरण

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

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

अगला स्निपेट, जैपनीज़ के लिए sans-serif फ़ॉन्ट सेट करता है.

browser.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

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

Enum

"Afak"

"अरब"

"Aran"

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

"Egyp"

"Elba"

"Ethi"

"Geor"

"Geok"

"Glag"

"Goth"

"Gran"

"Grek"

"Gujr"

"गुरु"

"Hang"

"हानी"

"Hano"

"Hans"

"Hant"

"Hebr"

"Hluw"

"Hmng"

"Hung"

"Inds"

"Ital"

"Java"

"Jpan"

"Jurc"

"काली"

"खार"

"Khmr"

"खोज"

"Knda"

"Kpel"

"Kthi"

"Lana"

"Laoo"

"Latf"

"Latg"

"Latn"

"Lepc"

"Limb"

"Lina"

"Linb"

"Lisu"

"Loma"

"Lyci"

"Lydi"

"Mand"

"Mani"

"Maya"

"Mend"

"Merc"

"Mero"

"Mlym"

"Moon"

"मोंग"

"Mroo"

"Mtei"

"Mymr"

"Narb"

"Nbat"

"Nkgb"

"Nkoo"

"Nshu"

"ओगम"

"Olck"

"Orkh"

"Orya"

"Osma"

"Palm"

"Perm"

"Phag"

"Phli"

"Phlp"

"Phlv"

"Phnx"

"Plrd"

"Prti"

"Rjng"

"Roro"

"Runr"

"समर"

"Sara"

"Sarb"

"सौर"

"Sgnw"

"Shaw"

"Shrd"

"सिंध"

"Sinh"

"Sora"

"Sund"

"Sylo"

"Syrc"

"Syre"

"Syrj"

"Syrn"

"Tagb"

"Takr"

"Tale"

"Talu"

"Taml"

"Tang"

"Tavt"

"तेलुगु"

"Teng"

"Tfng"

"Tglg"

"Thaa"

"थाई"

"Tibt"

"Tirh"

"Ugar"

"Vaii"

"विस्प"

"Wara"

"Wole"

"Xpeo"

"Xsux"

"Yiii"

"Zmth"

"Zsym"

"Zyyy"

तरीके

clearDefaultFixedFontSize()

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

अगर इस एक्सटेंशन ने कोई डिफ़ॉल्ट फ़ॉन्ट साइज़ सेट किया है, तो उसे हटा देता है.

पैरामीटर

• विवरण

  object ज़रूरी नहीं

  फ़िलहाल, इस पैरामीटर का इस्तेमाल नहीं किया जा रहा है.

रिटर्न

• वादा<शून्य>

  Chrome 96+

clearDefaultFontSize()

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

अगर इस एक्सटेंशन ने कोई डिफ़ॉल्ट फ़ॉन्ट साइज़ सेट किया है, तो उसे हटा देता है.

पैरामीटर

• विवरण

  object ज़रूरी नहीं

  फ़िलहाल, इस पैरामीटर का इस्तेमाल नहीं किया जा रहा है.

रिटर्न

• वादा<शून्य>

  Chrome 96+

clearFont()

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

अगर इस एक्सटेंशन ने कोई फ़ॉन्ट सेट किया है, तो उसे हटा देता है.

पैरामीटर

• विवरण

  ऑब्जेक्ट

  • genericFamily

    GenericFamily

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

  • स्क्रिप्ट

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

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

रिटर्न

• वादा<शून्य>

  Chrome 96+

clearMinimumFontSize()

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

अगर इस एक्सटेंशन ने फ़ॉन्ट का कम से कम साइज़ सेट किया है, तो उसे हटा देता है.

पैरामीटर

• विवरण

  object ज़रूरी नहीं

  फ़िलहाल, इस पैरामीटर का इस्तेमाल नहीं किया जा रहा है.

रिटर्न

• वादा<शून्य>

  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

    संख्या

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

रिटर्न

• वादा<शून्य>

  Chrome 96+

setDefaultFontSize()

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

इससे डिफ़ॉल्ट फ़ॉन्ट साइज़ सेट होता है.

पैरामीटर

• विवरण

  ऑब्जेक्ट

  • pixelSize

    संख्या

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

रिटर्न

• वादा<शून्य>

  Chrome 96+

setFont()

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

किसी स्क्रिप्ट और सामान्य फ़ॉन्ट फ़ैमिली के लिए फ़ॉन्ट सेट करता है.

पैरामीटर

• विवरण

  ऑब्जेक्ट

  • fontId

    स्ट्रिंग

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

  • genericFamily

    GenericFamily

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

  • स्क्रिप्ट

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

    वह स्क्रिप्ट कोड जिसके लिए फ़ॉन्ट सेट किया जाना चाहिए. अगर इसे शामिल नहीं किया जाता है, तो ग्लोबल स्क्रिप्ट (स्क्रिप्ट कोड "Zyyy") के लिए फ़ॉन्ट सेटिंग सेट हो जाती है.

रिटर्न

• वादा<शून्य>

  Chrome 96+

setMinimumFontSize()

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

इससे फ़ॉन्ट का सबसे छोटा साइज़ सेट किया जाता है.

पैरामीटर

• विवरण

  ऑब्जेक्ट

  • pixelSize

    संख्या

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

रिटर्न

• वादा<शून्य>

  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

      संख्या

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