chrome.fontSettings

شرح

از chrome.fontSettings API برای مدیریت تنظیمات فونت Chrome استفاده کنید.

مجوزها

fontSettings

برای استفاده از Font Settings API، باید مجوز "fontSettings" را در مانیفست افزونه اعلام کنید. مثلا:

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

مفاهیم و کاربرد

Chrome به برخی از تنظیمات فونت اجازه می دهد تا به خانواده فونت های عمومی و اسکریپت های زبان بستگی داشته باشند. به عنوان مثال، فونت مورد استفاده برای sans-serif چینی ساده شده ممکن است با فونت استفاده شده برای سریف ژاپنی متفاوت باشد.

خانواده‌های فونت‌های عمومی پشتیبانی‌شده توسط Chrome بر اساس خانواده‌های قلم‌های عمومی CSS هستند و در زیر GenericReference فهرست شده‌اند. وقتی یک صفحه وب یک خانواده فونت عمومی را مشخص می کند، Chrome فونت را بر اساس تنظیمات مربوطه انتخاب می کند. اگر خانواده فونت عمومی مشخص نشده باشد، Chrome از تنظیم برای خانواده فونت های عمومی "استاندارد" استفاده می کند.

وقتی یک صفحه وب زبانی را مشخص می‌کند، Chrome فونت را بر اساس تنظیمات اسکریپت زبان مربوطه انتخاب می‌کند. اگر هیچ زبانی مشخص نشده باشد، Chrome از این تنظیم برای اسکریپت پیش‌فرض یا جهانی استفاده می‌کند.

اسکریپت های زبان پشتیبانی شده توسط کد اسکریپت ISO 15924 مشخص شده و در زیر ScriptCode فهرست شده اند. از نظر فنی، تنظیمات کروم کاملاً بر اساس اسکریپت نیستند، بلکه به زبان نیز بستگی دارند. به عنوان مثال، کروم فونت را برای سیریلیک (کد اسکریپت ISO 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' }
);

برای امتحان این API، نمونه fontSettings API را از مخزن chrome-extension-samples نصب کنید.

انواع

FontName

نشان دهنده یک نام فونت است.

خواص

  • نمایش نام

    رشته

    نام نمایشی فونت

  • fontId

    رشته

    شناسه فونت

GenericFamily

یک خانواده فونت عمومی CSS.

Enum

"استاندارد"

"بدون دندانه"

"سریف"

"درست شد"

" خط شکسته "

"فانتزی"

"ریاضی"

LevelOfControl

یکی از not\_controllable : توسط هیچ برنامه افزودنی controlled\_by\_other\_extensions controllable\_by\_this\_extension کنترل نیست controlled\_by\_this\_extension این پسوند

Enum

"not_controlable"

"controlled_by_other_extensions"

"controlable_by_this_extension"

"controlled_by_this_extension"

ScriptCode

کد اسکریپت ISO 15924. اسکریپت پیش‌فرض یا سراسری با کد اسکریپت "Zyyy" نشان داده می‌شود.

Enum

"افک"

"عرب"

"آرمی"

"آرمن"

"Avst"

"بالی"

"بامو"

"صدای بم"

"باتک"

"بنگ"

"سعادت"

"بوپو"

"برا"

"برای"

"بوگی"

"بوهد"

"چکم"

"کنسروها"

"کاری"

"چم"

"چر"

"سیرت"

"قبطی"

"Cprt"

"سیرل"

"سیرس"

"دیوا"

"Dsrt"

"دوپل"

"اغید"

"ایقیه"

"مصر"

"البا"

"اتی"

"جور"

"گئوک"

"گلاگ"

"گوت"

"گرن"

"گرک"

"گجر"

"گورو"

"آویزان شدن"

"هانی"

"هانو"

"هانس"

"هنت"

"هبر"

"هلو"

"همنگ"

"آویزان"

"ایندز"

"ایتالیا"

"جاوا"

"ژاپن"

"Jurc"

"کالی"

"خر"

"خمر"

"خوج"

"کندا"

"کپل"

"کتی"

"لانا"

"لائو"

"لاتف"

"Latg"

"لاتن"

"لپک"

" اندام "

"لینا"

"لینب"

"لیسو"

"لوما"

"لایسی"

"لیدی"

"ماند"

"مانی"

"مایا"

"بهبودی یافتن"

"مرک"

"مرو"

"ملیم"

"ماه"

"مونگ"

"مرو"

"متی"

"میمر"

"نرب"

"نبات"

"Nkgb"

"نکو"

"نشو"

"اوگام"

"اولک"

"ارخ"

"اوریا"

"اسما"

"نخل"

"پرم"

"فاگ"

"فلی"

"Phlp"

"فلو"

"Phnx"

"Plrd"

"پرتی"

"Rjng"

"رورو"

"رانر"

"سمر"

"سارا"

"سرب"

"سائور"

"Sgnw"

"شاو"

"شرد"

"سند"

"سینه"

"سورا"

"سون"

"Sylo"

"Syrc"

"سیره"

"سیرج"

"سیرن"

"تگب"

"تکر"

"قصه"

"تالو"

"تمل"

"زبانه"

"تاوت"

"تلو"

"تنگ"

"Tfng"

"Tglg"

"تا"

"تایلندی"

"تیبت"

"تیره"

"اوگار"

"وای"

"Visp"

"وارا"

"وول"

"Xpeo"

"Xsux"

"Yiii"

"زمث"

"Zsym"

"زیی"

مواد و روش ها

clearDefaultFixedFontSize()

وعده
chrome.fontSettings.clearDefaultFixedFontSize(
  details?: object,
  callback?: function,
)

اندازه فونت ثابت پیش‌فرض تنظیم‌شده توسط این پسوند را در صورت وجود پاک می‌کند.

مولفه های

  • جزئیات

    شی اختیاری

    این پارامتر در حال حاضر استفاده نمی شود.

  • پاسخ به تماس

    عملکرد اختیاری

    پارامتر callback به نظر می رسد: 

    ()=>void

برمی گرداند

  • قول<باطل>

    Chrome 96+

    Promises در Manifest V3 و نسخه های جدیدتر پشتیبانی می شود، اما callbacks برای سازگاری به عقب ارائه شده است. شما نمی توانید از هر دو در یک فراخوانی تابع استفاده کنید. وعده با همان نوع که به callback ارسال می شود حل می شود.

clearDefaultFontSize()

وعده
chrome.fontSettings.clearDefaultFontSize(
  details?: object,
  callback?: function,
)

اندازه فونت پیش‌فرض تنظیم شده توسط این پسوند را در صورت وجود پاک می‌کند.

مولفه های

  • جزئیات

    شی اختیاری

    این پارامتر در حال حاضر استفاده نمی شود.

  • پاسخ به تماس

    عملکرد اختیاری

    پارامتر callback به نظر می رسد: 

    ()=>void

برمی گرداند

  • قول<باطل>

    Chrome 96+

    Promises در Manifest V3 و نسخه های جدیدتر پشتیبانی می شود، اما callbacks برای سازگاری به عقب ارائه شده است. شما نمی توانید از هر دو در یک فراخوانی تابع استفاده کنید. وعده با همان نوع که به callback ارسال می شود حل می شود.

clearFont()

وعده
chrome.fontSettings.clearFont(
  details: object,
  callback?: function,
)

در صورت وجود، فونت تنظیم شده توسط این پسوند را پاک می کند.

مولفه های

  • جزئیات

    هدف - شی

    • genericFamily

      GenericFamily

      خانواده فونت های عمومی که فونت برای آن باید پاک شود.

    • اسکریپت

      ScriptCode اختیاری است

      اسکریپتی که فونت آن باید پاک شود. اگر حذف شود، تنظیمات قلم اسکریپت جهانی پاک می شود.

  • پاسخ به تماس

    عملکرد اختیاری

    پارامتر callback به نظر می رسد: 

    ()=>void

برمی گرداند

  • قول<باطل>

    Chrome 96+

    Promises در Manifest V3 و نسخه های جدیدتر پشتیبانی می شود، اما callbacks برای سازگاری به عقب ارائه شده است. شما نمی توانید از هر دو در یک فراخوانی تابع استفاده کنید. وعده با همان نوع که به callback ارسال می شود حل می شود.

clearMinimumFontSize()

وعده
chrome.fontSettings.clearMinimumFontSize(
  details?: object,
  callback?: function,
)

حداقل اندازه قلم تعیین شده توسط این پسوند را در صورت وجود پاک می کند.

مولفه های

  • جزئیات

    شی اختیاری

    این پارامتر در حال حاضر استفاده نمی شود.

  • پاسخ به تماس

    عملکرد اختیاری

    پارامتر callback به نظر می رسد: 

    ()=>void

برمی گرداند

  • قول<باطل>

    Chrome 96+

    Promises در Manifest V3 و نسخه های جدیدتر پشتیبانی می شود، اما callbacks برای سازگاری به عقب ارائه شده است. شما نمی توانید از هر دو در یک فراخوانی تابع استفاده کنید. وعده با همان نوع که به callback ارسال می شود حل می شود.

getDefaultFixedFontSize()

وعده
chrome.fontSettings.getDefaultFixedFontSize(
  details?: object,
  callback?: function,
)

اندازه پیش فرض فونت های با عرض ثابت را دریافت می کند.

مولفه های

  • جزئیات

    شی اختیاری

    این پارامتر در حال حاضر استفاده نمی شود.

  • پاسخ به تماس

    عملکرد اختیاری

    پارامتر callback به نظر می رسد: 

    (details: object)=>void

    • جزئیات

      هدف - شی

      • levelOfControl

        LevelOfControl

        سطح کنترلی که این برنامه افزودنی بر تنظیم دارد.

      • اندازه پیکسل

        عدد

        اندازه فونت بر حسب پیکسل

برمی گرداند

  • قول<object>

    Chrome 96+

    Promises در Manifest V3 و نسخه های جدیدتر پشتیبانی می شود، اما callbacks برای سازگاری به عقب ارائه شده است. شما نمی توانید از هر دو در یک فراخوانی تابع استفاده کنید. وعده با همان نوع که به callback ارسال می شود حل می شود.

getDefaultFontSize()

وعده
chrome.fontSettings.getDefaultFontSize(
  details?: object,
  callback?: function,
)

اندازه فونت پیش فرض را دریافت می کند.

مولفه های

  • جزئیات

    شی اختیاری

    این پارامتر در حال حاضر استفاده نمی شود.

  • پاسخ به تماس

    عملکرد اختیاری

    پارامتر callback به نظر می رسد: 

    (details: object)=>void

    • جزئیات

      هدف - شی

      • levelOfControl

        LevelOfControl

        سطح کنترلی که این برنامه افزودنی بر تنظیم دارد.

      • اندازه پیکسل

        عدد

        اندازه فونت بر حسب پیکسل

برمی گرداند

  • قول<object>

    Chrome 96+

    Promises در Manifest V3 و نسخه های جدیدتر پشتیبانی می شود، اما callbacks برای سازگاری به عقب ارائه شده است. شما نمی توانید از هر دو در یک فراخوانی تابع استفاده کنید. وعده با همان نوع که به callback ارسال می شود حل می شود.

getFont()

وعده
chrome.fontSettings.getFont(
  details: object,
  callback?: function,
)

فونت یک اسکریپت معین و خانواده فونت های عمومی را دریافت می کند.

مولفه های

  • جزئیات

    هدف - شی

    • genericFamily

      GenericFamily

      خانواده فونت های عمومی که فونت باید برای آن بازیابی شود.

    • اسکریپت

      ScriptCode اختیاری است

      اسکریپتی که فونت برای آن باید بازیابی شود. اگر حذف شود، تنظیم فونت برای اسکریپت جهانی (کد اسکریپت "Zyyy") بازیابی می شود.

  • پاسخ به تماس

    عملکرد اختیاری

    پارامتر callback به نظر می رسد: 

    (details: object)=>void

    • جزئیات

      هدف - شی

      • fontId

        رشته

        شناسه فونت به جای مقدار ترجیحی شناسه قلم واقعی، این ممکن است شناسه قلمی باشد که سیستم مقدار ترجیحی را به آن تعیین می کند. بنابراین، fontId می تواند با فونت ارسال شده به setFont متفاوت باشد، اگر مثلاً فونت در سیستم موجود نباشد. رشته خالی به معنای بازگشت مجدد به تنظیمات قلم اسکریپت جهانی است.

      • levelOfControl

        LevelOfControl

        سطح کنترلی که این برنامه افزودنی بر تنظیم دارد.

برمی گرداند

  • قول<object>

    Chrome 96+

    Promises در Manifest V3 و نسخه های جدیدتر پشتیبانی می شود، اما callbacks برای سازگاری به عقب ارائه شده است. شما نمی توانید از هر دو در یک فراخوانی تابع استفاده کنید. وعده با همان نوع که به callback ارسال می شود حل می شود.

getFontList()

وعده
chrome.fontSettings.getFontList(
  callback?: function,
)

لیستی از فونت های سیستم را دریافت می کند.

مولفه های

  • پاسخ به تماس

    عملکرد اختیاری

    پارامتر callback به نظر می رسد: 

    (results: FontName[])=>void

برمی گرداند

  • Promise< FontName []>

    Chrome 96+

    Promises در Manifest V3 و نسخه های جدیدتر پشتیبانی می شود، اما callbacks برای سازگاری به عقب ارائه شده است. شما نمی توانید از هر دو در یک فراخوانی تابع استفاده کنید. وعده با همان نوع که به callback ارسال می شود حل می شود.

getMinimumFontSize()

وعده
chrome.fontSettings.getMinimumFontSize(
  details?: object,
  callback?: function,
)

حداقل اندازه فونت را دریافت می کند.

مولفه های

  • جزئیات

    شی اختیاری

    این پارامتر در حال حاضر استفاده نمی شود.

  • پاسخ به تماس

    عملکرد اختیاری

    پارامتر callback به نظر می رسد: 

    (details: object)=>void

    • جزئیات

      هدف - شی

      • levelOfControl

        LevelOfControl

        سطح کنترلی که این برنامه افزودنی بر تنظیم دارد.

      • اندازه پیکسل

        عدد

        اندازه فونت بر حسب پیکسل

برمی گرداند

  • قول<object>

    Chrome 96+

    Promises در Manifest V3 و نسخه های جدیدتر پشتیبانی می شود، اما callbacks برای سازگاری به عقب ارائه شده است. شما نمی توانید از هر دو در یک فراخوانی تابع استفاده کنید. وعده با همان نوع که به callback ارسال می شود حل می شود.

setDefaultFixedFontSize()

وعده
chrome.fontSettings.setDefaultFixedFontSize(
  details: object,
  callback?: function,
)

اندازه پیش فرض را برای فونت های با عرض ثابت تنظیم می کند.

مولفه های

  • جزئیات

    هدف - شی

    • اندازه پیکسل

      عدد

      اندازه فونت بر حسب پیکسل

  • پاسخ به تماس

    عملکرد اختیاری

    پارامتر callback به نظر می رسد: 

    ()=>void

برمی گرداند

  • قول<باطل>

    Chrome 96+

    Promises در Manifest V3 و نسخه های جدیدتر پشتیبانی می شود، اما callbacks برای سازگاری به عقب ارائه شده است. شما نمی توانید از هر دو در یک فراخوانی تابع استفاده کنید. وعده با همان نوع که به callback ارسال می شود حل می شود.

setDefaultFontSize()

وعده
chrome.fontSettings.setDefaultFontSize(
  details: object,
  callback?: function,
)

اندازه فونت پیش فرض را تنظیم می کند.

مولفه های

  • جزئیات

    هدف - شی

    • اندازه پیکسل

      عدد

      اندازه فونت بر حسب پیکسل

  • پاسخ به تماس

    عملکرد اختیاری

    پارامتر callback به نظر می رسد: 

    ()=>void

برمی گرداند

  • قول<باطل>

    Chrome 96+

    Promises در Manifest V3 و نسخه های جدیدتر پشتیبانی می شود، اما callbacks برای سازگاری به عقب ارائه شده است. شما نمی توانید از هر دو در یک فراخوانی تابع استفاده کنید. وعده با همان نوع که به callback ارسال می شود حل می شود.

setFont()

وعده
chrome.fontSettings.setFont(
  details: object,
  callback?: function,
)

فونت را برای یک اسکریپت معین و خانواده فونت های عمومی تنظیم می کند.

مولفه های

  • جزئیات

    هدف - شی

    • fontId

      رشته

      شناسه فونت رشته خالی به معنای بازگشت به تنظیمات قلم اسکریپت جهانی است.

    • genericFamily

      GenericFamily

      خانواده فونت های عمومی که فونت باید برای آن تنظیم شود.

    • اسکریپت

      ScriptCode اختیاری است

      کد اسکریپت که فونت باید تنظیم شود. اگر حذف شود، تنظیم فونت برای اسکریپت جهانی (کد اسکریپت "Zyyy") تنظیم می شود.

  • پاسخ به تماس

    عملکرد اختیاری

    پارامتر callback به نظر می رسد: 

    ()=>void

برمی گرداند

  • قول<باطل>

    Chrome 96+

    Promises در Manifest V3 و نسخه های جدیدتر پشتیبانی می شود، اما callbacks برای سازگاری به عقب ارائه شده است. شما نمی توانید از هر دو در یک فراخوانی تابع استفاده کنید. وعده با همان نوع که به callback ارسال می شود حل می شود.

setMinimumFontSize()

وعده
chrome.fontSettings.setMinimumFontSize(
  details: object,
  callback?: function,
)

حداقل اندازه فونت را تنظیم می کند.

مولفه های

  • جزئیات

    هدف - شی

    • اندازه پیکسل

      عدد

      اندازه فونت بر حسب پیکسل

  • پاسخ به تماس

    عملکرد اختیاری

    پارامتر callback به نظر می رسد: 

    ()=>void

برمی گرداند

  • قول<باطل>

    Chrome 96+

    Promises در Manifest V3 و نسخه های جدیدتر پشتیبانی می شود، اما callbacks برای سازگاری به عقب ارائه شده است. شما نمی توانید از هر دو در یک فراخوانی تابع استفاده کنید. وعده با همان نوع که به callback ارسال می شود حل می شود.

مناسبت ها

onDefaultFixedFontSizeChanged

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

هنگامی که تنظیم اندازه فونت ثابت پیش‌فرض تغییر می‌کند فعال می‌شود.

مولفه های

  • پاسخ به تماس

    تابع

    پارامتر callback به نظر می رسد: 

    (details: object)=>void

    • جزئیات

      هدف - شی

      • levelOfControl

        LevelOfControl

        سطح کنترلی که این برنامه افزودنی بر تنظیم دارد.

      • اندازه پیکسل

        عدد

        اندازه فونت بر حسب پیکسل

onDefaultFontSizeChanged

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

هنگامی که تنظیم اندازه فونت پیش‌فرض تغییر می‌کند فعال می‌شود.

مولفه های

  • پاسخ به تماس

    تابع

    پارامتر callback به نظر می رسد: 

    (details: object)=>void

    • جزئیات

      هدف - شی

      • levelOfControl

        LevelOfControl

        سطح کنترلی که این برنامه افزودنی بر تنظیم دارد.

      • اندازه پیکسل

        عدد

        اندازه فونت بر حسب پیکسل

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

        سطح کنترلی که این برنامه افزودنی بر تنظیم دارد.

      • اندازه پیکسل

        عدد

        اندازه فونت بر حسب پیکسل