dniccum/nova-state-select

A Laravel Nova field that is a select dropdown pre-populated with all of the states within the US.

Fund package maintenance!
dniccum

v1.0.0 2019-07-01 03:45 UTC

This package is auto-updated.

Last update: 2024-10-27 01:37:26 UTC


README

Latest Version on Packagist License Total Downloads

Image 1

Features

  • Pre-populates a select dropdown field with all of the states in the United States
  • Works with the Place field
  • Use the full state name or the 2 letter abbreviation
  • Optionally include the US territories
  • Add custom state abbreviations or state names

Installation

To install this field, use the installation code below:

composer require dniccum/nova-state-select

Code

To use the field, add the following code to your Nova resource. As this is a field, all of the default field properties can be applied.

use Dniccum\StateSelect\StateSelect;

StateSelect::make('State')

Options

useFullNames

StateSelect::make('State')
    ->useFullNames()

By default, this field uses the two-letter state abbreviations. Add this method if you would like to use and store the full state name.

includeTerritories

StateSelect::make('State')
    ->includeTerritories()

Adds the US territories and military territories as follows:

  • American Samoa
  • District of Columbia
  • Federated States of Micronesia
  • Guam
  • Marshall Islands
  • Northern Mariana Islands
  • Palau
  • Puerto Rico
  • Virgin Islands
  • Armed Forces Africa
  • Armed Forces Americas
  • Armed Forces Pacific

customValues

StateSelect::make('State')
    ->customValues([
        'Ontario',
        'Alberta'
    ])

If you would like to add any additional territories or provinces to the list, add them as an array.

Note: If you have used the ->useFullNames() method, the values provided MUST be an associative array with the abbreviation first and the name second, like so:

StateSelect::make('State')
    ->customValues([
        'ON' => 'Ontario',
        'AB' => 'Alberta'
    ])

Credits

License

The MIT License (MIT). Please see License File for more information.