مرورگر.تصویر زمینه

توضیحات

برای تغییر تصویر زمینه ChromeOS از API chrome.wallpaper استفاده کنید.

مجوزها

wallpaper

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

{
  "name": "My extension",
  ...
  "permissions": [
    "wallpaper"
  ],
  ...
}

در دسترس بودن

فقط کروم ۴۳+ (سیستم عامل کروم)

مثال‌ها

برای مثال، برای تنظیم تصویر زمینه به عنوان تصویر موجود در آدرس https://example.com/a_file.png ، می‌توانید تابع browser.wallpaper.setWallpaper به این صورت فراخوانی کنید:

browser.wallpaper.setWallpaper(
  {
    'url': 'https://example.com/a_file.jpg',
    'layout': 'CENTER_CROPPED',
    'filename': 'test_wallpaper'
  },
  function() {}
);

انواع

WallpaperLayout

کروم ۴۴+

طرح‌بندی‌های تصویر زمینه پشتیبانی شده.

شمارشی

"کشش"

«مرکز»

"مرکز_برش داده شده"

روش‌ها

setWallpaper()

chrome.wallpaper.setWallpaper(
  details: object,
)
: Promise<ArrayBuffer | undefined>

تصویر زمینه را روی تصویر موجود در url یا wallpaperData با طرح‌بندی مشخص شده تنظیم می‌کند.

پارامترها

  • جزئیات

    شیء

    • داده‌ها

      ArrayBuffer اختیاری

      تصویر پس‌زمینه کدگذاری شده با فرمت jpeg یا png به عنوان یک ArrayBuffer.

    • نام فایل

      رشته

      نام فایل تصویر زمینه ذخیره شده.

    • طرح‌بندی‌های تصویر زمینه پشتیبانی شده.

    • تصویر بندانگشتی

      بولی اختیاری

      اگر قرار است یک تصویر بندانگشتی ۱۲۸x۶۰ ایجاد شود، صحیح است. طرح‌بندی و نسبت هنوز پشتیبانی نمی‌شوند.

    • آدرس اینترنتی

      رشته اختیاری

      آدرس اینترنتی (URL) تصویر زمینه‌ای که قرار است تنظیم شود (می‌تواند نسبی باشد).

بازگشت‌ها

  • قول <ArrayBuffer | undefined>

    کروم ۹۶+