インスタンスメソッド

environment(_:_:)

指定されたキー パスの環境値を与えられた値に設定します。

nonisolated
func environment<V>(
    _ keyPath: WritableKeyPath<EnvironmentValues, V>,
    _ value: V
) -> some View

パラメータ

keyPath

更新すべき EnvironmentValues 構造体のプロパティを示すキーパス。

value

keyPath で指定された項目に設定すべき新しい値。

戻り値

その環境に与えられた値が設定されているビュー。

以下で言及

テキストにカスタムフォントを適用する (Applying custom fonts to text)

議論

この修飾子は、EnvironmentValues 構造体の書き込み可能なプロパティ（あなたが作成したカスタム値を含む）のいずれかを設定するために使用します。例えば、truncationMode キーに関連した値を設定できます。

MyView()
.environment(\.truncationMode, .head)

次に、Environment プロパティラッパーを使用して、MyView またはその子孫のいずれかの内部の値を読み取ります。

struct MyView: View {
    @Environment(\.truncationMode) var truncationMode: Text.TruncationMode

    var body: some View { ... }
}

SwiftUI は、truncationMode 値を設定する truncationMode(_:) 修飾子など、ほとんどの環境値を設定する専用のビュー修飾子を提供します。

MyView()
    .truncationMode(.head)

利用可能な場合は専用の修飾子を優先し、Entry() で説明されているように、カスタム環境値を定義するときはあなた独自の修飾子を提供します。

この修飾子は、与えられたビューとその子孫ビューの両方に影響します。この修飾子を呼び出したビュー階層の外部には全く影響しません。

以下も見よ

ビューの環境を変更する

func environment<T>(T?) -> some View

ビューの環境に監視可能なオブジェクトを配置します。

func transformEnvironment<V>(WritableKeyPath<EnvironmentValues, V>, transform: (inout V) -> Void) -> some View

指定されたキーパスの環境値を与えられた関数で変換します。