---
title: "init(text:selection:prompt:axis:label:)"
framework: swiftui
role: symbol
role_heading: Initializer
path: "swiftui/textfield/init(text:selection:prompt:axis:label:)"
---

# init(text:selection:prompt:axis:label:)

Creates a text field with a binding to the current selection and a prompt generated from a Text.

## Declaration

```swift
nonisolated init(text: Binding<String>, selection: Binding<TextSelection?>, prompt: Text? = nil, axis: Axis? = nil, @ContentBuilder label: () -> Label)
```

## Parameters

- `text`: The text to display and edit.
- `selection`: A doc://com.apple.SwiftUI/documentation/SwiftUI/Binding to the variable containing the selection.
- `prompt`: A Text representing the prompt of the text field which provides users with guidance on what to type into the text field. Defaults to nil.
- `axis`: The axis in which to scroll text when it doesn’t fit in the available space. Defaults to nil.
- `label`: A view that describes the purpose of the text field.

## Discussion

Discussion The following example shows a text field with a binding to the current selection: @State private var message: String = "" @State private var selection: TextSelection? = nil

var body: some View {     TextField(text: $message, selection: $selection) {         Text("Message")     } } Use the onSubmit(of:_:) modifier to invoke an action whenever the user submits this text field.
