Penyedia widget

widget Windows adalah kontainer UI kecil yang menampilkan konten yang disediakan oleh aplikasi Windows atau Progressive Web App (PWA). Anda dapat menyediakan templat dan data Kartu Adaptif, atau menggunakan widget web untuk menampilkan HTML dari URL. Widget web masih menggunakan payload JSON Kartu Adaptif untuk menentukan URL konten.

Untuk aplikasi desktop terpaket, Anda menerapkan penyedia widget yang merespons permintaan dari host widget dan mengirim pembaruan melalui WidgetManager. PWA menggunakan definisi widget dalam manifes aplikasi webnya dan menangani peristiwa widget di pekerja layanannya.

Untuk gambaran umum pengalaman widget Windows dan panduan desain untuk membuat widget Anda sendiri, lihat widget Windows.

Saat ini Anda dapat menerapkan penyedia widget menggunakan aplikasi desktop Win32 paket atau Progressive Web App (PWA). Untuk informasi selengkapnya, lihat:

API dan kemampuan penyedia widget desktop

Terapkan IWidgetProvider untuk pembuatan widget, penghapusan, aktivasi, perubahan konteks, dan tindakan pengguna. Antarmuka dasar tetap diperlukan saat Anda menambahkan antarmuka opsional untuk kustomisasi atau konten web.

Kemampuan API atau panduan Availability
Siklus hidup widget dan pembaruan Kartu Adaptif IWidgetProvider dan WidgetManager SDK Aplikasi Windows 1.2
Kustomisasi pengguna IWidgetProvider2 dan atribut IsCustomizable manifes SDK Aplikasi Windows 1.4
Konten web, permintaan sumber daya, dan perpesanan Penyedia widget web, IWidgetResourceProvider, IWidgetProviderMessage, dan WidgetManager.SendMessageToContent SDK Aplikasi Windows 1.6.3; periksa juga host web-widget dan persyaratan regional.
Menunjukkan konten yang belum dipersonalisasi atau dapat ditindaklanjuti WidgetUpdateRequestOptions.IsPlaceholderContent SDK Aplikasi Windows 1.6.6
Callback analitik widget IWidgetProviderAnalytics Windows Widgets Board mendukung callback ini mulai Windows 11 build 26900. Host lain juga harus mendukung antarmuka; lihat keterangan API.

Versi SDK mengidentifikasi kapan API tersedia, bukan rilis mana yang harus Anda instal. Gunakan rilis stabil yang saat ini didukung dari saluran rilis SDK Aplikasi Windows, dan uji kemampuan yang Anda gunakan pada perangkat Windows target dan host widget Anda. Untuk opsi presentasi header, lihat Menyesuaikan area header widget. API pekerja layanan PWA adalah jalur implementasi terpisah; antarmuka desktop dalam tabel ini tidak berlaku untuknya.

Host widget dapat mengaktifkan dan merilis penyedia Anda secara independen dari masa pakai widget yang disematkan. Pulihkan status widget saat penyedia dimulai, dan jangan pertahankan objek argumen panggilan balik setelah panggilan balik IWidgetProvider kembali. Untuk informasi selengkapnya, lihat keterangan IWidgetProvider.

Untuk referensi API lengkap, lihat Microsoft.Windows.Widgets.Providers namespace.

Untuk panduan dasar-dasar pembuatan widget dan menerapkan penyedia widget, tonton episode Tab vs Spaces "Buat Widget untuk Windows 11".

Sumber daya tambahan

  • Terakhir diperbarui pada