PrimeFaces Showcase

	Language
	English
	English
	English
	French
	German
	German
	German
	Italian
	Korean
	Spanish
	Catalan
	Dutch
	Portuguese
	Portuguese
	Arabic
	Arabic
	Bulgarian
	Bangla
	Bosnian
	Czech
	Greek
	Estonian
	Persian
	Finnish
	Danish
	Hindi
	Indonesian
	Icelandic
	Croatian
	Japanese
	Hungarian
	Hebrew
	Georgian
	Central Kurdish
	Khmer
	Kyrgyz
	Kazakh
	Lithuanian
	Latvian
	Malay
	Norwegian
	Polish
	Romanian
	Russian
	Slovak
	Slovenian
	Serbian
	Serbian
	Swedish
	Thai
	Turkish
	Ukrainian
	Uzbek
	Vietnamese
	Chinese
	Chinese

	Language
	English
	English
	English
	French
	German
	German
	German
	Italian
	Korean
	Spanish
	Catalan
	Dutch
	Portuguese
	Portuguese
	Arabic
	Arabic
	Bulgarian
	Bangla
	Bosnian
	Czech
	Greek
	Estonian
	Persian
	Finnish
	Danish
	Hindi
	Indonesian
	Icelandic
	Croatian
	Japanese
	Hungarian
	Hebrew
	Georgian
	Central Kurdish
	Khmer
	Kyrgyz
	Kazakh
	Lithuanian
	Latvian
	Malay
	Norwegian
	Polish
	Romanian
	Russian
	Slovak
	Slovenian
	Serbian
	Serbian
	Swedish
	Thai
	Turkish
	Ukrainian
	Uzbek
	Vietnamese
	Chinese
	Chinese

SelectCheckboxMenu Tag Documentation

SelectCheckboxMenu is a multi select component that displays options in an overlay.

Name	Type	Required	Default	Description
id	String	false	generated	Unique identifier of the component in a namingContainer.
rendered	boolean	false	true	Boolean value to specify the rendering of the component, when set to false component will not be rendered.
binding	UIComponent	false	generated	An EL expression referring to a server side UIComponent instance in a backing bean.
widgetVar	String	false	generated ('widget_' + componentClientId)	Name of the client side widget.
accesskey	String	false		Access key to transfer focus to the input element.
appendTo	String	false	@(body)	Appends the overlay to the element defined by search expression.
ariaDescribedBy	String	false		The aria-describedby attribute is used to define a component id that describes the current element for accessibility.
ariaLabelledBy	String	false
border	int	false	0
caseSensitive	boolean	false	false	Defines if filtering would be case sensitive.
converter	Converter	false		EL expression resolves to a converter instance or literal converter ID defining a component converter.
converterMessage	String	false
dir	String	false		Direction indication for text that does not inherit directionality.
disabled	boolean	false	false	Specifies that an element should be disabled.
disabledClass	String	false
dynamic	boolean	false	false	Defines if dynamic loading is enabled for the element's panel. If the value is "true", the overlay is not rendered on page load to improve performance.
emptyLabel	String	false		Label to be shown in updateLabel mode when no item is selected. If not set the label is shown.
enabledClass	String	false
filter	boolean	false	false	Renders an input field as a filter when enabled.
filterFunction	String	false		Client side function to use in custom filterMatchMode.
filterMatchMode	String	false		Match mode for filtering, valid values are startsWith (default), contains, endsWith and custom.
filterNormalize	boolean	false	false	Defines if filtering would be done using normalized values (accents will be removed from characters).
filterPlaceholder	String	false		Placeholder text to show when filter input is empty.
hideNoSelectionOption	boolean	false	false	Flag indicating that, if this component is activated by the user, The "no selection option", if any, must be hidden.
immediate	boolean	false	false	When set true, process validations logic is executed at apply request values phase for this component.
label	String	false		A localized user presentable name.
labelSeparator	String	false	,	Separator for joining item lables if updateLabel is set to true.
lang	String	false
layout	String	false
multiple	boolean	false	false	Enables multiple selection mode.
onHide	String	false		Client side callback to execute when overlay is hidden.
onShow	String	false		Client side callback to execute when overlay is displayed.
onblur	String	false		Fires when an element loses focus.
onchange	String	false		Fires when the value of an element has been changed.
onclick	String	false		Fires when a mouse click on the element.
ondblclick	String	false		Fires when a mouse double-click on the element.
onfocus	String	false		Fires when an element gets focus.
onkeydown	String	false		Fires when a user is pressing a key.
onkeypress	String	false		Fires when a user presses a key.
onkeyup	String	false		Fires when a user releases a key.
onmousedown	String	false		Fires when a mouse button is pressed down on an element.
onmousemove	String	false		Fires when the mouse pointer is moving while it is over an element.
onmouseout	String	false		Fires when the mouse pointer moves out of an element.
onmouseover	String	false		Fires when the mouse pointer moves onto an element.
onmouseup	String	false		Fires when a mouse button is released over an element.
onselect	String	false
panelStyle	String	false		Inline style of the dropdown panel container element.
panelStyleClass	String	false		Style class of the dropdown panel container element.
readonly	boolean	false	false	Specifies that an input field is read-only.
required	boolean	false	false	Marks component as required.
requiredMessage	String	false
role	String	false
scrollHeight	String	false	200	Defines the maximum height of the scrollable area.
selectedClass	String	false
selectedLabel	String	false		Label to be shown in updateLabel mode when one or more items are selected. If not set the label is shown.
showHeader	boolean	false	true	When enabled, the header of panel is displayed.
showSelectAll	boolean	false	true	When enabled, the "Select All" checkbox option is displayed.
style	String	false		Specifies an inline CSS style for an element.
styleClass	String	false		Specifies one or more CSS class names for an element.
submittedValue	Object	false
tabindex	String	false		Position of the element in the tabbing order.
title	String	false		Advisory tooltip information.
unselectedClass	String	false
updateLabel	boolean	false	false	When enabled, the label is updated on every change, else it statically displays the 'selectedLabel'.
validator	Validator	false		A method expression referring to a method validating the input.
validatorMessage	String	false
value	Object	false		Value of the component.
valueChangeListener	ValueChangeListener	false		A method binding expression referring to a method for handling a valuchangeevent.
var	String	false		Name of iterator to be used in custom content display.

Name	Description
footer	Footer content of the selectcheckboxmenu.

Name	Type	Default	Description
toggleSelect	ToggleSelectEvent	false	Fires when the selectAll checkbox is toggled.
change	AjaxBehaviorEvent	true	Fires when the element's value changes.
itemSelect	SelectEvent	false	Fires when an item is selected.
itemUnselect	UnselectEvent	false	Fires when an item is unselected.

Name	Library	Target
components.css	primefaces
jquery/jquery.js	primefaces
jquery/jquery-plugins.js	primefaces
core.js	primefaces
components.js	primefaces

Family org.primefaces.component

Type org.primefaces.component.SelectCheckboxMenu

Class org.primefaces.component.selectcheckboxmenu.SelectCheckboxMenu

Renderer Type org.primefaces.component.SelectCheckboxMenuRenderer

Renderer Class org.primefaces.component.selectcheckboxmenu.SelectCheckboxMenuRenderer

RESOURCES

Tag DocumentationNew DocumentationNew Documentation JSDoc

Usage


<div class="card">
    <h:form>
        <p:growl>
            <p:autoUpdate/>
        </p:growl>

        <h5 class="mt-0">Basic</h5>
        <p:selectCheckboxMenu id="menu"
                              dynamic="true"
                              filter="true" filterMatchMode="startsWith"
                              label="Cities" updateLabel="true" showSelectAll="false"
                              selectedLabel="Cities Selected"
                              style="width: 15rem" panelStyle="width: 15rem" scrollHeight="250"
                              value="#{checkboxView.selectedCities}">
            <f:selectItems value="#{checkboxView.cities}"/>

            <f:facet name="footer">
                <p:divider styleClass="mt-0" />
                <h:outputText value="#{checkboxView.cities.size()} cities"
                              styleClass="py-1 block font-bold"/>
            </f:facet>
        </p:selectCheckboxMenu>

        <h5>Multiple</h5>
        <p:selectCheckboxMenu id="multiple"
                              multiple="true" emptyLabel="Please select..." updateLabel="true"
                              style="min-width: 15rem" panelStyle="width: 30rem" scrollHeight="250"
                              value="#{checkboxView.selectedCities2}">
                <p:ajax event="toggleSelect" listener="#{checkboxView.onToggleSelect}"/>
                <p:ajax event="itemSelect" listener="#{checkboxView.onItemSelect}"/>
                <p:ajax event="itemUnselect" listener="#{checkboxView.onItemUnselect}"/>
                <f:selectItems value="#{checkboxView.cities}"/>
            </p:selectCheckboxMenu>

        <h5>Grouped</h5>
        <p:selectCheckboxMenu id="grouped"
                              filter="true" filterMatchMode="startsWith"
                              multiple="true"
                              style="width: 15rem" panelStyle="width: 15rem" scrollHeight="250"
                              value="#{checkboxView.selectedCountries}">
            <f:selectItems value="#{checkboxView.countries}"/>
        </p:selectCheckboxMenu>

        <h5>Advanced</h5>
        <p:selectCheckboxMenu id="advanced"
                              converter="#{countryConverter}"
                              filter="true" filterMatchMode="startsWith" filterNormalize="true"
                              multiple="true"
                              scrollHeight="250"
                              value="#{checkboxView.selectedCountries2}"
                              var="c"
                              style="min-width: 15rem">
            <f:selectItems value="#{checkboxView.countries2}"/>

            <p:column style="width:10%">
                <span class="flag flag-#{c.code}" style="width: 30px; height: 20px"/>
            </p:column>

            <p:column>
                <f:facet name="header">
                    <h:outputText value="Name"/>
                </f:facet>
                <h:outputText value="#{c.name}"/>
            </p:column>

            <f:facet name="footer">
                <h:outputText value="#{checkboxView.countries2.size()} countries"
                              styleClass="py-1 block font-bold"/>
            </f:facet>
        </p:selectCheckboxMenu>
    </h:form>
</div>


package org.primefaces.showcase.view.input;

import org.primefaces.event.SelectEvent;
import org.primefaces.event.ToggleSelectEvent;
import org.primefaces.event.UnselectEvent;
import org.primefaces.showcase.domain.Country;
import org.primefaces.showcase.service.CountryService;

import java.util.ArrayList;
import java.util.List;

import jakarta.annotation.PostConstruct;
import jakarta.enterprise.context.RequestScoped;
import jakarta.faces.application.FacesMessage;
import jakarta.faces.context.FacesContext;
import jakarta.faces.model.SelectItem;
import jakarta.faces.model.SelectItemGroup;
import jakarta.inject.Inject;
import jakarta.inject.Named;

@Named
@RequestScoped
public class CheckboxView {

    private String[] selectedOptions;
    private String[] selectedOptions2;
    private String[] selectedCities;
    private String[] selectedCities2;
    private List<String> cities;
    private List<SelectItem> countries;
    private String[] selectedCountries;
    private List<Country> countries2;
    private List<Country> selectedCountries2;
    private List<SelectItem> countries3;
    private List<Country> selectedCountries3;

    @Inject
    private CountryService service;

    @PostConstruct
    public void init() {
        cities = new ArrayList<>();
        cities.add("Miami");
        cities.add("London");
        cities.add("Paris");
        cities.add("Istanbul");
        cities.add("Berlin");
        cities.add("Barcelona");
        cities.add("Rome");
        cities.add("Brasilia");
        cities.add("Amsterdam");

        countries = new ArrayList<>();
        SelectItemGroup europeCountries = new SelectItemGroup("European Countries");
        europeCountries.setSelectItems(new SelectItem[]{
            new SelectItem("Germany", "Germany"),
            new SelectItem("Turkey", "Turkey"),
            new SelectItem("Spain", "Spain")
        });

        SelectItemGroup americaCountries = new SelectItemGroup("American Countries");
        americaCountries.setSelectItems(new SelectItem[]{
            new SelectItem("United States", "United States"),
            new SelectItem("Brazil", "Brazil"),
            new SelectItem("Mexico", "Mexico")
        });

        countries.add(europeCountries);
        countries.add(americaCountries);

        countries2 = service.getCountries();

        countries3 = new ArrayList<>();

        SelectItemGroup europeCountries3 = new SelectItemGroup("European Countries");
        europeCountries3.setSelectItems(isoCodesToSelectItemArray("DE", "TR", "ES"));

        SelectItemGroup americaCountries3 = new SelectItemGroup("American Countries");
        americaCountries3.setSelectItems(isoCodesToSelectItemArray("US", "BR", "MX"));

        countries3.add(europeCountries3);
        countries3.add(americaCountries3);
    }

    public String[] getSelectedOptions() {
        return selectedOptions;
    }

    public void setSelectedOptions(String[] selectedOptions) {
        this.selectedOptions = selectedOptions;
    }

    public String[] getSelectedOptions2() {
        return selectedOptions2;
    }

    public void setSelectedOptions2(String[] selectedOptions2) {
        this.selectedOptions2 = selectedOptions2;
    }

    public String[] getSelectedCities() {
        return selectedCities;
    }

    public void setSelectedCities(String[] selectedCities) {
        this.selectedCities = selectedCities;
    }

    public String[] getSelectedCities2() {
        return selectedCities2;
    }

    public void setSelectedCities2(String[] selectedCities2) {
        this.selectedCities2 = selectedCities2;
    }

    public List<String> getCities() {
        return cities;
    }

    public void setCities(List<String> cities) {
        this.cities = cities;
    }

    public List<SelectItem> getCountries() {
        return countries;
    }

    public void setCountries(List<SelectItem> countries) {
        this.countries = countries;
    }

    public String[] getSelectedCountries() {
        return selectedCountries;
    }

    public void setSelectedCountries(String[] selectedCountries) {
        this.selectedCountries = selectedCountries;
    }

    public List<Country> getCountries2() {
        return countries2;
    }

    public void setCountries2(List<Country> countries2) {
        this.countries2 = countries2;
    }

    public List<Country> getSelectedCountries2() {
        return selectedCountries2;
    }

    public void setSelectedCountries2(List<Country> selectedCountries2) {
        this.selectedCountries2 = selectedCountries2;
    }

    public List<SelectItem> getCountries3() {
        return countries3;
    }

    public void setCountries3(List<SelectItem> countries3) {
        this.countries3 = countries3;
    }

    public List<Country> getSelectedCountries3() {
        return selectedCountries3;
    }

    public void setSelectedCountries3(List<Country> selectedCountries3) {
        this.selectedCountries3 = selectedCountries3;
    }

    public void onToggleSelect(ToggleSelectEvent event) {
        FacesMessage msg = new FacesMessage();
        msg.setSummary("Toggled: " + event.isSelected());
        msg.setSeverity(FacesMessage.SEVERITY_INFO);

        FacesContext.getCurrentInstance().addMessage(null, msg);
    }

    public void onItemSelect(SelectEvent event) {
        FacesMessage msg = new FacesMessage();
        msg.setSummary("Item selected: " + event.getObject().toString());
        msg.setSeverity(FacesMessage.SEVERITY_INFO);

        FacesContext.getCurrentInstance().addMessage(null, msg);
    }

    public void onItemUnselect(UnselectEvent event) {
        FacesMessage msg = new FacesMessage();
        msg.setSummary("Item unselected: " + event.getObject().toString());
        msg.setSeverity(FacesMessage.SEVERITY_INFO);

        FacesContext.getCurrentInstance().addMessage(null, msg);
    }

    public void selectedOptionsChanged() {
        String message = "selectedOptions changed to: ";
        if (selectedOptions != null) {
            for (int i = 0; i < selectedOptions.length; i++) {
                if (i > 0) {
                    message += ", ";
                }
                message += selectedOptions[i];
            }
        }

        FacesContext.getCurrentInstance().addMessage(null,
                new FacesMessage(FacesMessage.SEVERITY_INFO, message, null));
    }

    public void selectedOptions2Changed() {
        String message = "selectedOptions2 changed to: ";
        if (selectedOptions2 != null) {
            for (int i = 0; i < selectedOptions2.length; i++) {
                if (i > 0) {
                    message += ", ";
                }
                message += selectedOptions2[i];
            }
        }

        FacesContext.getCurrentInstance().addMessage(null,
                new FacesMessage(FacesMessage.SEVERITY_INFO, message, null));
    }

    private SelectItem[] isoCodesToSelectItemArray(String... isoCodes) {
        return CountryService.toCountryStream(isoCodes)
                .map(country -> new SelectItem(country, country.getName()))
                .toArray(SelectItem[]::new);
    }
}


package org.primefaces.showcase.domain;

import java.io.Serializable;
import java.util.Locale;
import java.util.Objects;

public class Country implements Serializable, Comparable<Country> {

    private int id;
    private String name;
    private String code;
    private Locale locale;
    private boolean rtl;

    public Country() {
    }

    public Country(int id, Locale locale) {
        this(id, locale.getDisplayCountry(), locale.getCountry().toLowerCase(), locale);
    }

    public Country(int id, Locale locale, boolean rtl) {
        this(id, locale.getDisplayCountry(), locale.getCountry().toLowerCase(), locale);
        this.rtl = rtl;
    }

    public Country(int id, String name, String code) {
        this(id, name, code, null);
    }

    public Country(int id, String name, String code, Locale locale) {
        this.id = id;
        this.name = name;
        this.code = code;
        this.locale = locale;
    }

    public int getId() {
        return id;
    }

    public void setId(int id) {
        this.id = id;
    }

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public String getCode() {
        return code;
    }

    public void setCode(String code) {
        this.code = code;
    }

    public Locale getLocale() {
        return locale;
    }

    public void setLocale(Locale locale) {
        this.locale = locale;
    }

    public String getLanguage() {
        return locale == null ? "en" : locale.getLanguage();
    }

    public String getDisplayLanguage() {
        return locale == null ? "English" : locale.getDisplayLanguage();
    }

    public boolean isRtl() {
        return rtl;
    }

    public void setRtl(boolean rtl) {
        this.rtl = rtl;
    }

    @Override
    public boolean equals(Object o) {
        if (this == o) {
            return true;
        }
        if (o == null || getClass() != o.getClass()) {
            return false;
        }
        Country country = (Country) o;
        return id == country.id
                && Objects.equals(name, country.name)
                && Objects.equals(code, country.code);
    }

    @Override
    public int hashCode() {
        return Objects.hash(id, name, code);
    }

    @Override
    public String toString() {
        return name;
    }

    @Override
    public int compareTo(Country o) {
        return name.compareTo(o.name);
    }

}


package org.primefaces.showcase.service;

import org.primefaces.showcase.domain.Country;

import java.util.ArrayList;
import java.util.Comparator;
import java.util.List;
import java.util.Locale;
import java.util.Map;
import java.util.stream.Collectors;
import java.util.stream.Stream;

import jakarta.annotation.PostConstruct;
import jakarta.enterprise.context.ApplicationScoped;
import jakarta.inject.Named;

@Named
@ApplicationScoped
public class CountryService {

    private List<Country> countries;
    private Map<Integer, Country> countriesAsMap;
    private List<Country> locales;
    private Map<Integer, Country> localesAsMap;

    public static Stream<Country> toCountryStream(String... isoCodes) {
        return Stream.of(isoCodes)
                .map(isoCode -> new Locale("", isoCode))
                .map(CountryService::toCountry);
    }

    public static Country toCountry(Locale locale) {
        return CountryService.toCountry(locale, false);
    }

    public static Country toCountry(Locale locale, boolean rtl) {
        //use hash code from locale to have a reproducible ID (required for CountryConverter)
        return new Country(locale.hashCode(), locale, rtl);
    }

    @PostConstruct
    public void init() {
        countries = CountryService.toCountryStream(Locale.getISOCountries())
                .sorted(Comparator.comparing(Country::getName))
                .collect(Collectors.toList());

        locales = new ArrayList<>();

        locales.add(CountryService.toCountry(Locale.US));
        locales.add(CountryService.toCountry(Locale.UK));
        locales.add(CountryService.toCountry(new Locale("en", "AU")));
        locales.add(CountryService.toCountry(Locale.FRANCE));
        locales.add(CountryService.toCountry(Locale.GERMANY));
        locales.add(CountryService.toCountry(new Locale("de", "AT")));
        locales.add(CountryService.toCountry(new Locale("de", "CH")));
        locales.add(CountryService.toCountry(Locale.ITALY));
        locales.add(CountryService.toCountry(Locale.KOREA));
        locales.add(CountryService.toCountry(new Locale("es", "ES")));
        locales.add(CountryService.toCountry(new Locale("ca", "ES")));
        locales.add(CountryService.toCountry(new Locale("nl", "NL")));
        locales.add(CountryService.toCountry(new Locale("pt", "BR")));
        locales.add(CountryService.toCountry(new Locale("pt", "PT")));
        locales.add(CountryService.toCountry(new Locale("ar", "SA"), true));
        locales.add(CountryService.toCountry(new Locale("ar", "TN"), true));
        locales.add(CountryService.toCountry(new Locale("bg", "BG")));
        locales.add(CountryService.toCountry(new Locale("bn", "BD")));
        locales.add(CountryService.toCountry(new Locale("bs", "BA")));
        locales.add(CountryService.toCountry(new Locale("cs", "CZ")));
        locales.add(CountryService.toCountry(new Locale("el", "GR")));
        locales.add(CountryService.toCountry(new Locale("et", "EE")));
        locales.add(CountryService.toCountry(new Locale("fa", "IR"), true));
        locales.add(CountryService.toCountry(new Locale("fi", "FI")));
        locales.add(CountryService.toCountry(new Locale("da", "DK")));
        locales.add(CountryService.toCountry(new Locale("hi", "IN")));
        locales.add(CountryService.toCountry(new Locale("in", "ID")));
        locales.add(CountryService.toCountry(new Locale("is", "IS")));
        locales.add(CountryService.toCountry(new Locale("hr", "HR")));
        locales.add(CountryService.toCountry(new Locale("ja", "JP")));
        locales.add(CountryService.toCountry(new Locale("hu", "HU")));
        locales.add(CountryService.toCountry(new Locale("he", "IL"), true));
        locales.add(CountryService.toCountry(new Locale("ka", "GE")));
        locales.add(CountryService.toCountry(new Locale("ckb", "IQ"), true));
        locales.add(CountryService.toCountry(new Locale("km", "KH")));
        locales.add(CountryService.toCountry(new Locale("ky", "KG")));
        locales.add(CountryService.toCountry(new Locale("kk", "KZ")));
        locales.add(CountryService.toCountry(new Locale("lt", "LT")));
        locales.add(CountryService.toCountry(new Locale("lv", "LV")));
        locales.add(CountryService.toCountry(new Locale("ms", "MY")));
        locales.add(CountryService.toCountry(new Locale("no", "NO")));
        locales.add(CountryService.toCountry(new Locale("pl", "PL")));
        locales.add(CountryService.toCountry(new Locale("ro", "RO")));
        locales.add(CountryService.toCountry(new Locale("ru", "RU")));
        locales.add(CountryService.toCountry(new Locale("sk", "SK")));
        locales.add(CountryService.toCountry(new Locale("sl", "SI")));
        locales.add(CountryService.toCountry(new Locale("sr", "BA")));
        locales.add(CountryService.toCountry(new Locale("sr", "RS")));
        locales.add(CountryService.toCountry(new Locale("sv", "SE")));
        locales.add(CountryService.toCountry(new Locale("th", "TH")));
        locales.add(CountryService.toCountry(new Locale("tr", "TR")));
        locales.add(CountryService.toCountry(new Locale("uk", "UA")));
        locales.add(CountryService.toCountry(new Locale("uz", "UZ")));
        locales.add(CountryService.toCountry(new Locale("vi", "VN")));
        locales.add(CountryService.toCountry(Locale.SIMPLIFIED_CHINESE));
        locales.add(CountryService.toCountry(Locale.TRADITIONAL_CHINESE));
    }

    public List<Country> getCountries() {
        return new ArrayList<>(countries);
    }

    public Map<Integer, Country> getCountriesAsMap() {
        if (countriesAsMap == null) {
            countriesAsMap = getCountries().stream().collect(Collectors.toMap(Country::getId, country -> country));
        }
        return countriesAsMap;
    }

    public List<Country> getLocales() {
        return new ArrayList<>(locales);
    }

    public Map<Integer, Country> getLocalesAsMap() {
        if (localesAsMap == null) {
            localesAsMap = getLocales().stream().collect(Collectors.toMap(Country::getId, country -> country));
        }
        return localesAsMap;
    }
}


package org.primefaces.showcase.convert;

import org.primefaces.showcase.domain.Country;
import org.primefaces.showcase.service.CountryService;

import jakarta.enterprise.context.ApplicationScoped;
import jakarta.faces.application.FacesMessage;
import jakarta.faces.component.UIComponent;
import jakarta.faces.context.FacesContext;
import jakarta.faces.convert.Converter;
import jakarta.faces.convert.ConverterException;
import jakarta.faces.convert.FacesConverter;
import jakarta.inject.Inject;
import jakarta.inject.Named;

@Named
@ApplicationScoped
@FacesConverter(value = "countryConverter", managed = true)
public class CountryConverter implements Converter<Country> {

    @Inject
    private CountryService countryService;

    @Override
    public Country getAsObject(FacesContext context, UIComponent component, String value) {
        if (value != null && !value.trim().isEmpty()) {
            try {
                return countryService.getCountriesAsMap().get(Integer.parseInt(value));
            }
            catch (NumberFormatException e) {
                throw new ConverterException(new FacesMessage(FacesMessage.SEVERITY_ERROR, "Conversion Error", "Not a valid country."));
            }
        }
        else {
            return null;
        }
    }

    @Override
    public String getAsString(FacesContext context, UIComponent component, Country value) {
        if (value != null) {
            return String.valueOf(value.getId());
        }
        else {
            return null;
        }
    }
}

Locale

Input Style

Themes

PrimeUIX

PrimeOne

Bootstrap

Material Design

Material Design Compact

Legacy

SelectCheckboxMenu

SelectCheckboxMenu Tag Documentation

Basic

Multiple

Grouped

Advanced

Usage

Reloading page

		Name
		Afghanistan
		Albania
		Algeria
		American Samoa
		Andorra
		Angola
		Anguilla
		Antarctica
		Antigua & Barbuda
		Argentina
		Armenia
		Aruba
		Australia
		Austria
		Azerbaijan
		Bahamas
		Bahrain
		Bangladesh
		Barbados
		Belarus
		Belgium
		Belize
		Benin
		Bermuda
		Bhutan
		Bolivia
		Bosnia & Herzegovina
		Botswana
		Bouvet Island
		Brazil
		British Indian Ocean Territory
		British Virgin Islands
		Brunei
		Bulgaria
		Burkina Faso
		Burundi
		Cambodia
		Cameroon
		Canada
		Cape Verde
		Caribbean Netherlands
		Cayman Islands
		Central African Republic
		Chad
		Chile
		China
		Christmas Island
		Cocos (Keeling) Islands
		Colombia
		Comoros
		Congo - Brazzaville
		Congo - Kinshasa
		Cook Islands
		Costa Rica
		Croatia
		Cuba
		Curaçao
		Cyprus
		Czechia
		Côte d’Ivoire
		Denmark
		Djibouti
		Dominica
		Dominican Republic
		Ecuador
		Egypt
		El Salvador
		Equatorial Guinea
		Eritrea
		Estonia
		Eswatini
		Ethiopia
		Falkland Islands
		Faroe Islands
		Fiji
		Finland
		France
		French Guiana
		French Polynesia
		French Southern Territories
		Gabon
		Gambia
		Georgia
		Germany
		Ghana
		Gibraltar
		Greece
		Greenland
		Grenada
		Guadeloupe
		Guam
		Guatemala
		Guernsey
		Guinea
		Guinea-Bissau
		Guyana
		Haiti
		Heard & McDonald Islands
		Honduras
		Hong Kong SAR China
		Hungary
		Iceland
		India
		Indonesia
		Iran
		Iraq
		Ireland
		Isle of Man
		Israel
		Italy
		Jamaica
		Japan
		Jersey
		Jordan
		Kazakhstan
		Kenya
		Kiribati
		Kuwait
		Kyrgyzstan
		Laos
		Latvia
		Lebanon
		Lesotho
		Liberia
		Libya
		Liechtenstein
		Lithuania
		Luxembourg
		Macao SAR China
		Madagascar
		Malawi
		Malaysia
		Maldives
		Mali
		Malta
		Marshall Islands
		Martinique
		Mauritania
		Mauritius
		Mayotte
		Mexico
		Micronesia
		Moldova
		Monaco
		Mongolia
		Montenegro
		Montserrat
		Morocco
		Mozambique
		Myanmar (Burma)
		Namibia
		Nauru
		Nepal
		Netherlands
		New Caledonia
		New Zealand
		Nicaragua
		Niger
		Nigeria
		Niue
		Norfolk Island
		North Korea
		North Macedonia
		Northern Mariana Islands
		Norway
		Oman
		Pakistan
		Palau
		Palestinian Territories
		Panama
		Papua New Guinea
		Paraguay
		Peru
		Philippines
		Pitcairn Islands
		Poland
		Portugal
		Puerto Rico
		Qatar
		Romania
		Russia
		Rwanda
		Réunion
		Samoa
		San Marino
		Saudi Arabia
		Senegal
		Serbia
		Seychelles
		Sierra Leone
		Singapore
		Sint Maarten
		Slovakia
		Slovenia
		Solomon Islands
		Somalia
		South Africa
		South Georgia & South Sandwich Islands
		South Korea
		South Sudan
		Spain
		Sri Lanka
		St. Barthélemy
		St. Helena
		St. Kitts & Nevis
		St. Lucia
		St. Martin
		St. Pierre & Miquelon
		St. Vincent & Grenadines
		Sudan
		Suriname
		Svalbard & Jan Mayen
		Sweden
		Switzerland
		Syria
		São Tomé & Príncipe
		Taiwan
		Tajikistan
		Tanzania
		Thailand
		Timor-Leste
		Togo
		Tokelau
		Tonga
		Trinidad & Tobago
		Tunisia
		Turkmenistan
		Turks & Caicos Islands
		Tuvalu
		Türkiye
		U.S. Outlying Islands
		U.S. Virgin Islands
		Uganda
		Ukraine
		United Arab Emirates
		United Kingdom
		United States
		Uruguay
		Uzbekistan
		Vanuatu
		Vatican City
		Venezuela
		Vietnam
		Wallis & Futuna
		Western Sahara
		Yemen
		Zambia
		Zimbabwe
		Åland Islands