インスタンスメソッド

buttonRepeatBehavior

Beta

このビューのボタンが長時間の操作でアクションを繰り返しトリガーするかどうかを設定します。

iOS 17.0+ Beta iPadOS 17.0+ Beta macOS 14.0+ Beta Mac Catalyst 17.0+ Beta

tvOS 17.0+ Beta watchOS 10.0+ Beta

宣言

func buttonRepeatBehavior(_ behavior: ButtonRepeatBehavior) -> some View

パラメータ

behavior

値が enabled (有効) の場合はボタンで繰り返し動作を有効にする必要があり、値が disabled (無効) の場合はボタンで繰り返し動作を禁止する必要があることを意味します。

議論

これを、値を増減するボタン、またはその他の本質的に反復的な操作を実行するボタンに適用します。ボタンを押し続ける、ボタンのキーボードショートカットを押し続ける、ボタンにフォーカスがあるときにスペースキーを押し続けるなどの操作により、この繰り返し動作がトリガーされます。

Button {
playbackSpeed.advance(by: 1)
} label: {
Label("Speed up", systemImage: "hare")
}
.buttonRepeatBehavior(.enabled)

これはすべてのシステムボタンスタイルに影響するだけでなく、カスタム ButtonStyle に準拠する型にも自動的に影響します。これは、カスタム PrimitiveButtonStyle 準拠型には自動的に適用されないため、EnvironmentValues.buttonRepeatBehavior の値を使用してカスタムジェスチャを適切に調整する必要があります。