Instance Method インスタンスメソッド

focusedSceneValue(_:_:)

Modifies this view by injecting a value that you provide for use by other views whose state depends on the focused scene.

Declaration 宣言 

func focusedSceneValue<T>(_ keyPath: WritableKeyPath<FocusedValues, T?>, _ value: T) -> some View

Return Value 戻り値

A modified representation of this view. このビューの修正された表現。

Parameters パラメータ

keyPath

The key path to associate value with when adding it to the existing table of published focus values.

value

The focus value to publish.

Discussion 議論

Use this method instead of focusedValue(_:_:) for values that must be visible regardless of where focus is located in the active scene. For example, if an app needs a command for moving focus to a particular text field in the sidebar, it could use this modifier to publish a button action that’s visible to command views as long as the scene is active, and regardless of where focus happens to be in it.


struct Sidebar: View {
    @FocusState var isFiltering: Bool


    var body: some View {
        VStack {
            TextField(...)
                .focused(when: $isFiltering)
                .focusedSceneValue(\.filterAction) {
                    isFiltering = true
                }
        }
    }
}


struct NavigationCommands: Commands {
    @FocusedValue(\.filterAction) var filterAction


    var body: some Commands {
        CommandMenu("Navigate") {
            Button("Filter in Sidebar") {
                filterAction?()
            }
        }
        .disabled(filterAction == nil)
    }
}


struct FilterActionKey: FocusedValuesKey {
    typealias Value = () -> Void
}


extension FocusedValues {
    var filterAction: (() -> Void)? {
        get { self[FilterActionKey.self] }
        set { self[FilterActionKey.self] = newValue }
    }
}

See Also 参照

Focus

func focused<Value>(FocusState<Value>.Binding, equals: Value) -> some View
Modifies this view by binding its focus state to the given state value.
func focused(FocusState<Bool>.Binding) -> some View
Modifies this view by binding its focus state to the given Boolean state value.
func focusedValue<Value>(WritableKeyPath<FocusedValues, Value?>, Value) -> some View
Modifies this view by injecting a value that you provide for use by other views whose state depends on the focused view hierarchy. このビューを修正します、フォーカスされたビュー階層にそれの状態が依存する他のビューで使うためにあなたが提供するある値を注入することによって。
func prefersDefaultFocus(Bool, in: Namespace.ID) -> some View
Indicates that the view should receive focus by default for a given namespace.
func focusScope(Namespace.ID) -> some View
Creates a focus scope that SwiftUI uses to limit default focus preferences.
func focusSection() -> some View
Indicates that the view’s frame and cohort of focusable descendants should be used to guide focus movement.
func focusable(Bool) -> some View
Specifies if the view is focusable.