View in English
●
●
Apple Developer
検索
検索を終了
●
Apple Developer
●
ニュース
●
見つける
●
デザイン
●
開発
●
配信
●
サポート
●
アカウント
次の内容に検索結果を絞り込む
5クイックリンク
日本語ドキュメント
●
フレームワーク
WidgetKit
iOSのホーム画面やmacOSの通知センターに、アプリ内の適切なコンテンツを一目でわかる形で表示します。
最新の英語ドキュメント
WidgetKit
対象
●iOS 14.0+
●iPadOS 14.0+
●macOS 11.0+
●Mac Catalyst 14.0+
テクノロジー
●WidgetKit
このページの内容
●概要
●トピック
概要
WidgetKitは、iOSのホーム画面やmacOSの通知センターにウィジェットを配置することで、ユーザーがアプリ内のコンテンツに簡単にアクセスできるようにします。配置されたウィジェットは最新の状態に維持されるため、ユーザーはいつでも最新の情報を一目で把握できます。詳細情報が必要な場合、ユーザーがウィジェットをタップすると、アプリ内で該当する場所がただちに表示されます。
3種類のサイズ︵小、中、大︶の中から選択して、幅広い情報をウィジェットに表示できます。ユーザーは、自分のニーズに合った詳細が表示されるようにウィジェットを調整したり、最適に機能するようにウィジェットを配置することができます。ユーザーがウィジェットをスタックし、﹁スマートローテーション﹂を有効にすると、WidgetKitは、最も関連性のあるウィジェットをスタックの一番上に自動的に配置して、ユーザーが適切なタイミングで最も重要な詳細情報を確認できるようにします。
ウィジェットを実装するには、Widget Extensionをアプリに追加します。タイムラインプロバイダによってウィジェットを構成し、SwiftUIビューを使ってウィジェットのコンテンツを表示します。タイムラインプロバイダは、ウィジェットのコンテンツを更新するタイミングをWidgetKitに知らせます。
ウィジェットをユーザーが構成できるようにするには、カスタムSiriKit Intentの定義をExtensionに追加します。WidgetKitは、カスタマイズ可能なインターフェイスを自動的に提供して、ユーザーがそれぞれのウィジェットをカスタマイズできるようにします。
トピック
ウィジェットの作成
Widget Extensionの作成
Extensionを追加および構成して、ホーム画面、﹁今日の表示﹂または通知センターにアプリのコンテンツを表示します。
WidgetKitとSwiftUIを使ったウィジェットの構築
ウィジェットを作成して、ホーム画面にアプリのコンテンツを表示し、ユーザーが設定をカスタマイズできるようにカスタムインテントを含めます。
Fruta: SwiftUIによる多機能アプリの構築
ウィジェットとApp Clipをユーザーに提供するマルチプラットフォームアプリを構築するための共有コードベースを開発します。
protocol Widget
ホーム画面または通知センターに表示するウィジェットの構成とコンテンツです。
protocol WidgetBundle
単一のWidget Extensionから複数のウィジェットを公開するために使用するコンテナです。
struct StaticConfiguration
ユーザーが構成可能なオプションを含まないウィジェットのコンテンツを記述するオブジェクトです。
enum WidgetFamily
ウィジェットに使用されるテンプレートのサイズを設定します。
構成可能なウィジェット
構成可能なウィジェットの作成
カスタムSiriKit Intentの定義をプロジェクトに追加して、ウィジェットをカスタマイズするオプションをユーザーに提供します。
struct IntentConfiguration
カスタムインテントの定義を使ってユーザーが構成可能なオプションを提供するウィジェットのコンテンツを記述するオブジェクトです。
struct WidgetInfo
ユーザーが構成したウィジェットに関する情報を含む構造体です。
タイムライン管理
ウィジェットを最新の状態に維持
ダイナミックビューを使って関連する情報が適切なタイミングで表示されるようにウィジェットのタイムラインを計画し、状況が変化したときにタイムラインを更新します。
protocol TimelineProvider
ウィジェットの表示を更新するタイミングをWidgetKitに通知するタイプです。
protocol IntentTimelineProvider
ユーザーが構成可能なウィジェットの表示を更新するタイミングをWidgetKitに通知するタイプです。
struct TimelineProviderContext
ウィジェットのサイズやウィジェットがウィジェットギャラリーに表示されるかどうかなど、ウィジェットのレンダリング方法に関する詳細を含むオブジェクトです。
protocol TimelineEntry
ウィジェットを表示する日時を指定し、必要に応じてウィジェットのコンテンツの現在の関連性を示すタイプです。
struct Timeline
WidgetKitがウィジェットのビューを更新する日時を指定するオブジェクトです。
class WidgetCenter
ユーザーが構成したウィジェットのリストを含むオブジェクトであり、ウィジェットのタイムラインを再度読み込むために使用します。
ユーザーインターフェイス
SwiftUIビュー
SwiftUIビューによってアプリのコンテンツをウィジェットに表示します。
SwiftUIの概要
SwiftUIは、すべてのAppleプラットフォームでユーザーインターフェイスを定義する宣言型の最新ツールです。美しくダイナミックなアプリを、よりスピーディーに開発できます。
ウィジェットの位置情報サービス
ウィジェットでの位置情報へのアクセス
位置情報をウィジェットのプレゼンテーションに組み込むことで、状況に応じてより関連性の高い情報がウィジェットに表示されるようにします。
スマートスタック
スマートスタックに表示される回数を増やす
Intentsをドネートして、関連性を示すことで、表示すべき役立つ情報が含まれている場合に﹁スマートスタック﹂にウィジェットが自動的に表示されます。
struct TimelineEntryRelevance
現在および過去のタイムラインの他のエントリと比較した、タイムラインエントリの相対的な重要性を記述するオブジェクトです。
ウィジェットのプレビューとデバッグ
ウィジェットのデバッグ
Xcodeで環境変数を設定して、ウィジェットの構成をデバッガで制御します。
struct WidgetPreviewContext
ウィジェットのプレビューのコンテキストを指定します。
・日本語ドキュメント
・WidgetKit
メニューを開く メニューを閉じる
●iOS
●iPadOS
●macOS
●tvOS
●visionOS
●watchOS
Open Menu
Close Menu
●Swift
●SwiftUI
●Swift Playgrounds
●TestFlight
●Xcode
●Xcode Cloud
●SF Symbols
メニューを開く メニューを閉じる
●アクセシビリティ
●アクセサリ
●App Extension
●App Store
●オーディオとビデオ︵英語︶
●拡張現実
●ビジネス︵英語︶
●デザイン
●配信
●教育
●フォント︵英語︶
●ゲーム
●ヘルスケアとフィットネス
●アプリ内課金
●ローカリゼーション
●マップと位置情報
●機械学習
●オープンソース︵英語︶
●セキュリティ
●SafariとWeb︵英語︶
メニューを開く メニューを閉じる
●英語ドキュメント︵完全版︶
●日本語ドキュメント︵一部トピック︶
●チュートリアル
●ダウンロード︵英語︶
●フォーラム︵英語︶
●ビデオ
Open Menu
Close Menu
●サポートドキュメント
●お問い合わせ
●バグ報告
●システム状況︵英語︶
メニューを開く メニューを閉じる
●Apple Developer
●App Store Connect
●Certificates, IDs, & Profiles︵英語︶
●フィードバックアシスタント
メニューを開く メニューを閉じる
●Apple Developer Program
●Apple Developer Enterprise Program
●App Store Small Business Program
●MFi Program︵英語︶
●News Partner Program︵英語︶
●Video Partner Program︵英語︶
●セキュリティ報奨金プログラム︵英語︶
●Security Research Device Program︵英語︶
Open Menu
Close Menu
●Appleのエキスパートに相談
●Apple Developer Center
●App Store Awards︵英語︶
●Apple Design Awards
●Apple Developer Academy︵英語︶
●Entrepreneur Camp︵英語︶
●WWDC
Apple Developerアプリを入手する
Light
Dark
Auto
Copyright © 2024 Apple Inc. All rights reserved.
利用規約