Summary

Types

territory()

Territory type passed to a collator for ordering in the select box.

Functions

Generate an HTML select tag for a territory list that can be used with a Phoenix.HTML.Form.t.

Generate a list of options for a territory list that can be used with Phoenix.HTML.Form.select/4, Phoenix.HTML.Form.options_for_select/2 or to create a <datalist>.

Types

select_options()

@type select_options() :: [
  territories: [atom() | binary(), ...],
  locale: Cldr.Locale.locale_name() | Cldr.LanguageTag.t(),
  collator: function(),
  mapper: (Cldr.Locale.territory_code() -> String.t()),
  backend: module(),
  selected: atom() | binary()
]

territory()

@type territory() :: %{
  territory: Cldr.Locale.territory_code(),
  name: String.t(),
  flag: String.t()
}

Territory type passed to a collator for ordering in the select box.

The default collator orders by :name using Elixir standard comparison which is by codepoint and is therefore not Unicode aware.

Functions

select(form, field, options \\ [])

@spec select(
  form :: Phoenix.HTML.Form.t(),
  field :: Phoenix.HTML.Form.field(),
  select_options()
) ::
  Phoenix.HTML.safe()
  | {:error, {Cldr.UnknownTerritoryError, binary()}}
  | {:error, {Cldr.UnknownLocaleError, binary()}}

Generate an HTML select tag for a territory list that can be used with a Phoenix.HTML.Form.t.

Arguments

A Phoenix.HTML.Form.t() form
A Phoenix.HTML.Form.field() field
A Keyword.t() list of options

Options

For select options see Phoenix.HTML.Form.select/4

:territories defines the list of territories to be displayed in the the select tag. The list defaults to the territories returned by Cldr.Territory.country_codes/0.
:style is the format of the territory name to be used. The options are :standard (the default), :short and :variant. Not all territories have :short or :variant names in which case :standard is used for those territories.
:locale defines the locale to be used to localise the description of the territories. The default is the locale returned by Cldr.get_locale/1
:backend is any backend module. The default is Cldr.default_backend!/0
:collator is a function used to sort the territories in the selection list. It is passed a list of maps where each map represents a territory and has the keys :territory, :name and :flag. See t:territory. The default collator sorts by name_1 < name_2. As a result, default collation sorts by code point which will not return expected results for scripts other than Latin.
:mapper is a function that creates the text to be displayed in the select tag for each territory. It is passed the territory definition as a t:territory map containing the keys :territory_code, :name and :flag. The default function is &({&1.flag <> " " <> &1.name, &1.territory_code})
:selected identifies the territory that is to be selected by default in the select tag. The default is nil. This is passed unmodified to Phoenix.HTML.Form.select/4
:prompt is a prompt displayed at the top of the select box. This is passed unmodified to Phoenix.HTML.Form.select/4

Examples

 Cldr.HTML.Territory.select(:my_form, :territory, selected: :AU)

 Cldr.HTML.Territory.select(:my_form, :territory, selected: :AU, locale: "ar")

 Cldr.HTML.Territory.select(:my_form, :territory, territories: [:US, :AU, :JP],
      mapper: &({&1.name, &1.territory_code}))

territory_options(options \\ [])

@spec territory_options(select_options()) ::
  [tuple()]
  | {:error, {Cldr.UnknownTerritoryError, binary()}}
  | {:error, {Cldr.UnknownLocaleError, binary()}}

Generate a list of options for a territory list that can be used with Phoenix.HTML.Form.select/4, Phoenix.HTML.Form.options_for_select/2 or to create a <datalist>.

Arguments

A Keyword.t() list of options.

Options

See Cldr.HTML.Territory.select/3 for options.

Settings View Source Cldr.HTML.Territory (Cldr HTML v1.5.2)

select_options()

territory()

select(form, field, options \\ [])

Examples

territory_options(options \\ [])

View Source Cldr.HTML.Territory (Cldr HTML v1.5.2)