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 افزودنی controlled\_by\_this\_extension controllable\_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

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

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

        شماره

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