元のドキュメント： developer.apple.com/documentation/swiftui/togglestyle/button

型プロパティ

button

ラベルがタイトルとなるボタンとして表示されるトグルスタイル。

@MainActor @preconcurrency
static var button: ButtonToggleStyle { get }

Self が ButtonToggleStyle の時利用可能です。

議論

toggleStyle(_:) 修飾子を使用して、このスタイルを Toggle またはトグルを含むビュー階層に適用します。

Toggle(isOn: $isFlagged) {
    Label("Flag", systemImage: "flag.fill")
}
.toggleStyle(.button)

このスタイルでは、トグルの目的を説明するラベルが付いたボタンが生成されます。ユーザーはボタンをタップまたはクリックして、トグルの状態を変更します。ボタンは、背景をそのティントカラーで塗りつぶすことでオン状態を示します。ティントカラーは、tint(_:) 修飾子を使用して変更できます。SwiftUI では、ツールバーに表示されるトグルのデフォルトスタイルとしてこのスタイルが使用されます。

以下の表は、トグルのオフ状態とオン状態をそれぞれ示しています。

プラットフォーム	外観
iOS, iPadOS
macOS

ボタンのトグルのラベルには、Label インスタンスが最適です。SwiftUI は、コンテキストに基づいて、上記の例のようにタイトルとアイコンの両方を表示するか、ツールバーに表示されるトグルのようにアイコンのみを表示するかを判断します。また、labelStyle(_:) 修飾子を追加することで、ラベルのスタイルを制御することもできます。いずれの場合も、SwiftUI は VoiceOver を使用してコントロールを識別するために常にタイトルを使用します。

以下も見よ

組み込みのトグルスタイルを取得する

static var automatic: DefaultToggleStyle

デフォルトのトグルスタイル。

static var checkbox: CheckboxToggleStyle

チェックボックスとそれに続くラベルを表示するトグルスタイル。

static var `switch`: SwitchToggleStyle

先頭にラベルとそれに続くスイッチを表示するトグルスタイル。