元のドキュメント：developer.apple.com/documentation/swiftui/view/tint(_:)-93mfq

インスタンスメソッド

tint(_:)

このビュー内の tint を設定します。

nonisolated
func tint(_ tint: Color?) -> some View

パラメータ

tint

適用すべき tint Color。

議論

このメソッドを使用して、このビューのデフォルトのアクセントカラーを上書きします。アプリのアクセントカラーはユーザーの設定で上書きできますが、tint カラーは常に優先されるため、コントロールに特別な意味を持たせる方法として使用してください。

以下の例では、「回答」ボタンと「拒否」ボタンがそれぞれ green と red の tint カラーで表示されています。

struct ControlTint: View {
    var body: some View {
        HStack {
            Button {
                // Answer the call
            } label: {
                Label("Answer", systemImage: "phone")
            }
            .tint(.green)
            Button {
                // Decline the call
            } label: {
                Label("Decline", systemImage: "phone.down")
            }
            .tint(.red)
        }
        .buttonStyle(.borderedProminent)
        .padding()
    }
}

コントロールによっては、それらのスタイル、現在のプラットフォーム、および周囲のコンテキストに応じて、tint カラーへの対応が異なる場合があります。たとえば、macOS では、bordered スタイルのボタンは背景に tint 色を付けませんが、borderedProminent スタイルのボタンは tint 色を付けます。macOS では、これらのボタンスタイルはいずれもラベルに tint 色を付けませんが、他のプラットフォームでは tint 色を付けます。

nonisolated
func tint<S>(_ tint: S?) -> some View where S : ShapeStyle

パラメータ

tint

適用すべき tint。

議論

このメソッドを使用すると、このビューのデフォルトのアクセントカラーを、与えられたスタイルで上書きできます。アプリのアクセントカラーはユーザーの設定で上書きできますが、tint は常に優先されるため、コントロールに特別な意味を持たせる方法として使用してください。

与えられた型の ShapeStyle を使用してスタイルを設定できないコントロールは、可能な限りスタイルを近似しようとします (つまり、グラデーションを使用してスタイルを設定できないコントロールは、グラデーションの最初の停止点の色を使用しようとします)。

以下の例では、blue から red へのグラデーションで tint された直線状のゲージを示しています。

struct ControlTint: View {
    var body: some View {
        Gauge(value: 75, in: 0...100) {
            Text("Temperature")
        }
        .gaugeStyle(.linearCapacity)
        .tint(Gradient(colors: [.blue, .orange, .red]))
    }
}

コントロールによっては、それらのスタイル、現在のプラットフォーム、および周囲のコンテキストに応じて、tint カラーへの対応が異なる場合があります。たとえば、macOS では、bordered スタイルのボタンは背景に tint 色を付けませんが、borderedProminent スタイルのボタンは tint 色を付けます。macOS では、これらのボタンスタイルはいずれもラベルに tint 色を付けませんが、他のプラットフォームでは tint 色を付けます。