Declaration
import { Form } from 'swiftui-react-native';nonisolated struct Form<Content> where Content : ViewInitializers
One SwiftUI initializer backs <Form>.
<Form>
children?: ReactNode
</Form>nonisolated init(@ContentBuilder content: () -> Content)childrenReactNodeContent. Strings become
Text; React Native views are laid out by Yoga and placed by SwiftUI.Swift
content: () -> Content
Also takes the common view props: modifiers, style and testID.
Overview
SwiftUI applies platform-appropriate styling to views contained inside a form, to group them together. Form-specific styling applies to things like buttons, toggles, labels, lists, and more. Keep in mind that these stylings may be platform-specific. For example, forms appear as grouped lists on iOS, and as aligned vertical stacks on macOS.
The following example shows a simple data entry form on iOS, grouped into
two sections. The supporting types (NotifyMeAboutType and
ProfileImageSize) and state variables (notifyMeAbout, profileImageSize,
playNotificationSounds, and sendReadReceipts) are omitted for
simplicity.
var body: some View {
NavigationView {
Form {
Section(header: Text("Notifications")) {
Picker("Notify Me About", selection: $notifyMeAbout) {
Text("Direct Messages").tag(NotifyMeAboutType.directMessages)
Text("Mentions").tag(NotifyMeAboutType.mentions)
Text("Anything").tag(NotifyMeAboutType.anything)
}
Toggle("Play notification sounds", isOn: $playNotificationSounds)
Toggle("Send read receipts", isOn: $sendReadReceipts)
}
Section(header: Text("User Profiles")) {
Picker("Profile Image Size", selection: $profileImageSize) {
Text("Large").tag(ProfileImageSize.large)
Text("Medium").tag(ProfileImageSize.medium)
Text("Small").tag(ProfileImageSize.small)
}
Button("Clear Image Cache") {}
}
}
}
}On macOS, a similar form renders as a vertical stack. To adhere to macOS
platform conventions, this version doesn't use sections, and uses colons at
the end of its labels. It also sets the picker to use
the PickerStyle.inline style, which produces radio buttons on macOS.
var body: some View {
Spacer()
HStack {
Spacer()
Form {
Picker("Notify Me About:", selection: $notifyMeAbout) {
Text("Direct Messages").tag(NotifyMeAboutType.directMessages)
Text("Mentions").tag(NotifyMeAboutType.mentions)
Text("Anything").tag(NotifyMeAboutType.anything)
}
Toggle("Play notification sounds", isOn: $playNotificationSounds)
Toggle("Send read receipts", isOn: $sendReadReceipts)
Picker("Profile Image Size:", selection: $profileImageSize) {
Text("Large").tag(ProfileImageSize.large)
Text("Medium").tag(ProfileImageSize.medium)
Text("Small").tag(ProfileImageSize.small)
}
.pickerStyle(.inline)
Button("Clear Image Cache") {}
}
Spacer()
}
Spacer()
}From Apple’s SwiftUI documentation. Code samples there are Swift.
Relationships
Conforms to
- View
See also
More in Lists and collections.
- ForEachA structure that computes views on demand from an underlying collection of identified data.
- ListA container that presents rows of data arranged in a single column, optionally providing the ability to select one or more members.
- SectionA container view that you can use to add hierarchy within certain views.