Checkout Address Forms

This family renders Woo billing and shipping fields. Field definitions are authored in components, but runtime field rules come from Woo's checkout schema.

Components

Component key	Role
OmeWooBillingAddressForm	Renders billing address fields.
OmeWooShippingAddressForm	Renders shipping address fields plus the different-shipping toggle.

Shared Field Props

Both address forms expose the same field-copy pattern:

Prop	Meaning
content.legend	Fieldset legend text.
content.show_legend	Renders or hides the legend.
{field}.use_woo_defaults	Uses Woo label, hint text, and validation copy.
{field}.label	Custom label when Woo defaults are disabled.
Field hint copy	Custom input hint copy when Woo defaults are disabled.
{field}.error_message	Custom local validation copy when Woo defaults are disabled.
accessibility.aria_label	Fieldset accessible label.
preview.state	Builder preview state.

Billing includes email and phone. Shipping does not.

Shipping Toggle Props

ShippingAddressForm adds:

Prop	Meaning
shipping_toggle.label	Visible toggle label.
shipping_toggle.use_aria_label	Uses a separate ARIA label when true.
shipping_toggle.aria_label	Accessible toggle label when enabled.
shipping_toggle.preview_checked	Builder preview checked state.

Runtime hides shipping fields until the toggle is checked.

Runtime Field Rules

Runtime applies the Woo schema:

Rule	Runtime result
hidden	Field root becomes hidden and controls are disabled.
required	Field gets data-ome-required, and checkout validation uses it.
label	Label text is updated unless custom copy is enabled.
Field hint copy	Input hint copy is updated unless custom copy is enabled.
type	Native input type is updated.
priority	Field roots are sorted by Woo priority.
autocomplete	Autocomplete token is applied.

Country and state controls are UIChoice-backed. State can become select, text, or hidden depending on the selected country.

Scenario Coverage

Scenario	Covered behavior
checkout_success	Billing fields, country/state choices, and payment data produce a real order.
checkout_validation_error	Required and invalid billing fields are marked locally.
checkout_terms_blocked	Checkout notices mark error state without unsafe HTML.
checkout country changes refresh state control	State changes from ready to hidden after country change.
checkout shipping address fields follow toggle	Shipping fields show and hide with the embedded toggle.