TextInputDictationActivation

A configuration that determines what starts dictation in a search field.

StructureiOS 17.0+visionOS 1.0+TextInputDictationActivation in SwiftUI

Declaration

React
type TextInputDictationActivation = 'onLook' | 'onSelect';
Swift
struct TextInputDictationActivation

Pass a literal, or build one with SwiftUI.TextInputDictationActivation from import { SwiftUI } from 'swiftui-react-native'.

Type properties

Overview

Pass a value of this type to TextInputDictationBehavior.inline(activation:) when you want to keep the dictation microphone in a search field but choose how someone begins speaking:

NavigationStack {
    RecipeList(matching: query)
}
.searchable(text: $query)
.searchDictationBehavior(.inline(activation: .onLook))

On visionOS, TextInputDictationActivation.onLook starts dictation as soon as someone looks at the field. Choose TextInputDictationActivation.onSelect instead when speaking early would be disruptive.

From Apple’s SwiftUI documentation. Code samples there are Swift.

See also

More in Text and symbols.