Rails – Country Select
Provides a simple helper to get an HTML select list of countries using the ISO 3166-1 standard.
While the ISO 3166 standard is a relatively neutral source of country names, it may still offend some users. Developers are strongly advised to evaluate the suitability of this list given their user base.
Install as a gem using
gem install country_select
Or put the following in your Gemfile
Simple use supplying model and attribute as parameters:
Supplying priority countries to be placed at the top of the list:
country_select("user", "country", [ "Great Britain", "France", "Germany" ])
Using ISO 3166-1 alpha-2 codes as values
You can have the
option tags use ISO 3166-1 alpha-2 codes as values
and the country names as display strings. For example, the United States
would appear as
<option value="us">United States</option>
If you're starting a new project, this is the recommended way to store your country data since it will be more resistant to country names changing.
country_select("user", "country_code", nil, iso_codes: true)
country_select("user", "country_code", [ "GB", "FR", "DE" ], iso_codes: true)
Global configuration to always use ISO codes
Add the following configuration to an initializer.
::CountrySelect.use_iso_codes = true
Getting the Country from ISO codes
class User < ActiveRecord::Base # Assuming country_select is used with User attribute `country_code` def country_name ::CountrySelect::COUNTRIES[country_code] end end
bundle bundle exec rspec
Running with multiple versions of actionpack
bundle exec appraisal
Copyright (c) 2008 Michael Koziarski, released under the MIT license