`AddressElement` collects a billing or shipping address using the selected country's own format: which fields exist, the order they appear in, which of them are required and how the postal code is validated all follow that country, and the street field offers suggestions as the buyer types. Unlike the wallet views it reads nothing from Whop, so it needs no token and renders before (or without) `WhopSDK.configure`. Hold an `AddressElementManager` where your submit button lives to read and validate what it holds.
### Usage
```swift theme={null}
import SwiftUI
import WhopElements
// Nothing here is read from Whop, so this screen needs no WhopSDK.configure.
struct CheckoutScreen: View {
@State private var manager = AddressElementManager()
var body: some View {
ScrollView {
AddressElement(manager: manager) { snapshot in
print(snapshot.isComplete)
}
.padding()
}
.safeAreaInset(edge: .bottom) {
Button("Continue") {
let snapshot = manager.validate()
guard snapshot.isComplete else { return }
print(snapshot.address.country, snapshot.address.postalCode ?? "")
}
.padding()
}
}
}
```
### Parameters
Reads and validates the address from outside the view. Hold one with `@State` where your submit button lives, then call `validate()` before submitting.
`.full` labels every field and stacks them; `.compact` moves the labels into placeholders. Defaults to `.full`.
`.full` collects the country's whole address format; `.minimal` collects country and postal code only. Defaults to `.full`.
`.combined` for one full-name field, `.split` for first and last, `.none` to leave the name out. Defaults to `.combined`.
`.none`, `.name` for an organization name, or `.nameWithType` to also ask whether it is a business or an individual. Defaults to `.none`.
`.always` shows the second line, `.toggle` reveals it with a button, `.never` leaves it out. Defaults to `.always`.
Values to start from. Its `country` is an ISO 3166-1 alpha-2 code and takes precedence over country detection.
Start on the device's region. Defaults to `true`, and falls back to `countryHint` and then US.
Restrict the country picker to these ISO 3166-1 alpha-2 codes. Defaults to every country.
ISO 3166-1 alpha-2 fallback for the country chain, for example one derived from the buyer's currency.
Street suggestions as the buyer types. Defaults to `true`. Turning it off also shows every field from the start, since there is no suggestion to wait for.
Called on every edit with the current snapshot.
### `WhopAddressSnapshot`
What a selection hands back:
* `isComplete: Bool`: every field the country requires is filled and valid
* `address: WhopAddress`: what the buyer has entered so far
* `errors: [WhopAddressField: WhopAddressFieldError]`: empty exactly when `isComplete` is true
### States
There is nothing to fetch, so it renders immediately with no loading or error state of its own. `manager.validate()` reveals the per-field errors inline and returns the same snapshot `onChange` receives; `errors` is empty exactly when `isComplete` is true. While `autocomplete` is on at `.full` scope the locality fields stay hidden until the buyer picks a suggestion or opens the form manually — turn it off and every field is shown from the start.
### Good to know
* Street suggestions come from MapKit on the device, so what the buyer types is not sent to Whop as they type.
* `defaultValues.country` beats `detectCountry`; with neither, the country falls back to `countryHint` and then to US.
* Field names on `WhopAddress` match the web element's payload and the confirmation token's `billing_details` keys, so the same JSON works on both platforms.
Authentication is set once for every element, not per element, so `WhopSDK.configure(tokenProvider:)` at app launch is enough. A view mounted before it lands renders a spinner and picks the token up when it arrives. See [Getting started](/elements/upcoming/getting-started) for the token provider. Theme with the `.whopTheme(_:)` modifier.