onSubmit

Adds an action to perform when the user submits a value to this view.

View ModifieriOS 15.0+macOS 12.0+tvOS 15.0+watchOS 8.0+onSubmit(of:_:) in SwiftUI

Declaration

React
compose().onSubmit({
  of?: SwiftUI.SubmitTriggers,
  action: () => void,
})
Swift
nonisolated func onSubmit(
    of triggers: SubmitTriggers = .text,
    _ action: @escaping () -> Void
) -> some View

Parameters

Discussion

Different views may have different triggers for the provided action. A TextField, or SecureField will trigger this action when the user hits the hardware or software return key. This modifier may also bind this action to a default action keyboard shortcut. You may set this action on an individual view or an entire view hierarchy.

TextField("Username", text: $username)
    .onSubmit {
        guard viewModel.validate() else { return }
        viewModel.login()
    }

You can use the View.submitScope(_:) modifier to stop a submit trigger from a control from propagating higher up in the view hierarchy to higher View.onSubmit(of:_:) modifiers.

Form {
    TextField("Username", text: $viewModel.userName)
    SecureField("Password", text: $viewModel.password)

    TextField("Tags", text: $viewModel.tags)
        .submitScope()
}
.onSubmit {
    guard viewModel.validate() else { return }
    viewModel.login()
}

You can use different submit triggers to filter the types of triggers that should invoke the provided submission action. For example, you may provide a value of SubmitTriggers.search to only hear submission triggers that originate from search fields vended by searchable modifiers.

@StateObject private var viewModel = ViewModel()

NavigationView {
    SidebarView()
    DetailView()
}
.searchable(
    text: $viewModel.searchText,
    placement: .sidebar
) {
    SuggestionsView()
}
.onSubmit(of: .search) {
    viewModel.submitCurrentSearchQuery()
}

See also

More in Events and lifecycle.