address_field
Field Partial
Examples for the The address field partial adds a block of fields to your form. It creates and stores an instance of the Address
model and associates it to your record.
Sub-Fields Included in the Partial
Field Label | Name | Data Type | Notes |
---|---|---|---|
Country | country_id |
Addresses::Country |
For country values, see config/address/countries.json in bullet_train-core/bullet_train. |
Address | address_one |
string |
|
Address (cont'd) | address_two |
string |
|
City | city |
string |
|
State / Province / Region | region_id |
Addresses::Region |
Depending on the country selected, the label will change (e.g. Prefecture for Japan, Province or Territory for Canada). For all region values, see config/addresses/states.json in bullet_train-core/bullet_train. |
Postal code | postal_code |
string |
Depending on the country selected, the label will change (e.g. Zip code for the United States). |
If you'd like to add or remove fields, you'll need to update your own version of the Address
model and eject and modify the shared/fields/address_field
partial.
region_id
and postal_code
Fields and Labels
Dynamically Updating The address_field
partial implements Bullet Train's Dependent Fields Pattern to automatically update the region_id
and postal_code
fields and their labels based on the value of the selected country_id
.
Customizing the Address Output
By default, show
screens get a multi-line output and index
table columns get a one-line format (use the one_line: true
param).
To customize this output, eject the shared/attributes/address
partial.
See the Showcase preview for the example output.