Today Widget: vad är det, typer och skapande av widget för aviseringar

Vad är Today Widget

Today Widget (även känd som Notiscenter-widget) — ett iOS-gränssnittselement som visar komprimerad information från appen utan att starta den. Användaren ser widgeten genom att svepa skärmen åt vänster på låsskärmen eller på hemskärmen. Widgeten kan visa dynamisk data — valutakurs, senaste nyheter, uppgiftsstatus, enhetsstatus.

Historiskt sett dök Today Widget upp i iOS 8 som ett tillägg till Notiscenter, implementerat via ramverket Notification Center. Med iOS 14 introducerade Apple WidgetKit — en helt omdesignad arkitektur som gör det möjligt att placera widgetar direkt på skrivbordet. Today Widget i modern mening — en WidgetKit-widget placerad i sektionen “Idag” (widgetsektionen till vänster om första skärmen).

Varför behövs Today Widget

Huvudmålet är att minska tiden för åtkomst till information. Istället för att öppna appen, navigera i menyn och vänta på laddning ser användaren omedelbart nödvändig data. Enligt Apple (2024) visar appar med widgetar 27% högre användarengagemang. Ytterligare scenarier: snabba åtgärder (markera uppgift som slutförd), övervakning (puls, aktivitet) och status (batteriladdning, aviseringar).

WidgetKit mot NCWidgetProviding

Utvecklaren av Today Widget har två tillvägagångssätt: modern WidgetKit (iOS 14+) och det äldre tillägget NCWidgetProviding (iOS 8–13). Valet beror på den lägsta supportade iOS-versionen. WidgetKit rekommenderas för nya projekt, NCWidgetProviding — för support av äldre enheter.

När ska WidgetKit användas

Om din app stöder iOS 14 och nyare — använd WidgetKit. Det erbjuder rika funktioner: flera storlekar, konfiguration via intent, omdesign med iOS 17 och djupa länkar. SwiftUI-deklarativitet gör widgetkoden kompakt och läsbar. Timeline Provider hanterar automatiskt uppdateringsschemat med hänsyn till energiförbrukning.

När ska NCWidgetProviding användas

Endast om stöd för iOS 9–13 krävs. NCWidgetProviding är enklare att implementera — det är en vanlig UIViewController med ett protokoll. Det är dock begränsat: en storlek, endast UIKit, ingen konfiguration. Apple rekommenderar att byta till WidgetKit även för gamla projekt med hjälp av availability check: WidgetKit på iOS 14+, NCWidgetProviding som fallback.

Typer av Today Widgets

I modern iOS särskiljs tre typer av widgetar efter funktionellt syfte. Varje typ löser sin egen uppgift och kräver ett annorlunda tillvägagångssätt för design av data och gränssnitt. Klassificering hjälper till att välja rätt arkitektur för din app.

Informationswidgetar

Visar statisk eller periodiskt uppdaterad information: väder, datum, valutakurs, serverstatus. Data uppdateras enligt schema via Timeline Provider. Användaren interagerar inte med widgeten — bara läser. Informationswidgetar — enklast att implementera, kräver ingen bearbetning av beröringshändelser och fungerar i bakgrunden utan ytterligare behörigheter.

Interaktiva widgetar

Från iOS 17 stöder WidgetKit knappar, omkopplare och reglage i widgetar. Användaren kan utföra en åtgärd — markera uppgift, pausa musik, tända ljus — utan att öppna appen. Interactive Widgets använder App Intents för att överföra åtgärden till huvudappen. Begränsning: endast på skrivbordet, inte i sektionen “Idag” fram till iOS 18.

Konfigurerbara widgetar

Användaren anpassar visad data via systemgränssnittet — väljer stad för väder, konto för ekonomi, kategori för nyheter. Implementeras via Intents Extension och konfiguration i WidgetBundle. Konfigurerbara widgetar ökar personalisering och relevans av information för varje användare.

Skapa en WidgetKit-widget

Låt oss titta på processen att skapa en Today Widget i SwiftUI med WidgetKit. Widgeten kommer att visa aktuell valutakurs med automatisk uppdatering. WidgetKit kräver tre komponenter: widgetstruktur, Provider med konfiguration och View för visning.

import WidgetKit
import SwiftUI

@main
struct CurrencyWidget: Widget {
    let kind: String = "CurrencyWidget"

    var body: some WidgetConfiguration {
        StaticConfiguration(kind: kind, provider: Provider()) { entry in
            CurrencyWidgetEntryView(entry: entry)
        }
        .configurationDisplayName("Currency Rate")
        .description("Current USD/RUB exchange rate")
        .supportedFamilies([.systemSmall, .systemMedium])
    }
}

Providern ansvarar för att förbereda data för visning. Metoden getTimeline skapar uppdateringsschemat: nästa uppdatering om 15 minuter. TimelineProvider garanterar att widgeten visar aktuell data utan konstant polling av servern.

struct Provider: TimelineProvider {
    func getSnapshot(in context: Context,
                      completion: @escaping (CurrencyEntry) -> Void) {
        let entry = CurrencyEntry(date: Date(), rate: 92.5)
        completion(entry)
    }

    func getTimeline(in context: Context,
                     completion: @escaping (Timeline<CurrencyEntry>) -> Void) {
        let rate = CurrencyService().fetchRate()
        let entry = CurrencyEntry(date: Date(), rate: rate)
        let nextUpdate = Calendar.current.date(
            byAdding: .minute, value: 15, to: Date()
        ) ?? Date()
        let timeline = Timeline(entries: [entry], policy: .after(nextUpdate))
        completion(timeline)
    }
}

Timeline Provider och datauppdatering

Timeline Provider — den centrala WidgetKit-mekanismen för att hantera Today Widget-data. Istället för periodisk uppdatering med timer (som i gamla NCWidgetProviding) använder WidgetKit konceptet timeline — en sekvens av poster med tidsstämplar. Systemet visar den aktuella posten tills den löper ut, växlar sedan till nästa eller begär en ny.

Uppdateringspolicy

Timeline stöder tre policyer: .after(date) — nästa uppdatering vid angivet datum; .never — widgeten uppdateras inte förrän explicit anrop av WidgetCenter.reloadAllTimelines; .atEnd — uppdatering efter visning av sista posten. För Today Widget med valutakurs är policy .after med intervall på 15–30 minuter optimal. Energieffektivitet — den viktigaste fördelen med WidgetKit: systemet grupperar uppdateringar av alla widgetar i ett fönster.

WidgetCenter: programmatisk uppdatering

Om data har ändrats innan timeline löper ut (t.ex. användaren uppdaterade valutakursen i appen), anropa WidgetCenter.shared.reloadTimelines(ofKind: "CurrencyWidget"). Detta begär en ny timeline från Providern och uppdaterar visningen. WidgetCenter gör det också möjligt att ladda om alla appens widgetar med ett enda kommando — bekvämt efter datasynkronisering.

Designrekommendationer för widgetar

Apple ställer stränga krav på designen av Today Widget: innehållet måste vara läsligt på avstånd, utan onödiga element och med tydlig hierarki. Brott mot HIG-rekommendationerna (Human Interface Guidelines) är en anledning till avslag vid publicering i App Store. Tre principer: glanceability, consistency och hierarchy.

Glanceability — läsbarhet vid en blick

Användaren spenderar mindre än en sekund på widgeten. Lägg inte till fler än 3–4 dataelement. Teckenstorlek — minst 11pt för etiketter, 17pt för värden. Använd fet stil (Semibold) för nyckeltal. Undvik rullning — Today Widget rullar inte.

Anpassning till storlekar

WidgetKit stöder tre storlekar: Small (170×170pt), Medium (364×170pt), Large (364×382pt). För Today Widget i sektionen “Idag” är Medium det vanligaste valet. Adaptiv design via EnvironmentValues: ändra informationstäthet beroende på storlek. Small — ett tal, Medium — tal + graf, Large — tabell.

Stöd för mörkt tema och Dynamic Type

Widgeten måste visas korrekt i ljust och mörkt tema utan ytterligare åtgärder från utvecklaren — WidgetKit tar automatiskt emot systemfärger. Dynamic Type för widgetar är begränsad: teckenstorleken är fast men måste vara läslig. UIColor.label och UIColor.systemBackground — basfärger för text och bakgrund i båda teman.