Overview | Library | Tag | Help
| FRAMES NO FRAMES

## ICEfaces EE Composite Components
Tag selectLocale

## The Locale Selector Composite Component

### Features

- The component will render an ice:selectOneMenu component with a list of the application's supported locales.
- Selecting a different language will dynamically apply the selected resource bundle to the user session.
- If no locales have been specified in the application, or only one locale is available, the component will not render anything.

### How To Use

1. Add <ice-cc:selectLocale> to any page where you want to make a locale selection
2. Add the attribute locale="#{localeController.sessionLocale}" to your view tag(s)
3. Ensure a resource-bundle has been specified in faces-config.xml
4. Ensure localized versions of the resource-bundle are present with language locale and possibly country locale. ie: messages_en.properties messages_en_US.properties
5. Ensure each locale is registered as a supported-locale under locale-config in faces-config.xml

Example:

    <ice-cc:selectLocale styleClass="localeStyle"/>

Tag Information
Tag Class | javax.faces.webapp.FacetTag
TagExtraInfo Class | None
Body Content | tagdependent
Display Name | Select Locale

Attributes
Name | Required | Request-time | Type | Description
disabled | false | false | `java.lang.Boolean` | Flag indicating that this component must never receive focus or be included in a subsequent submit.
effect | false | false | `com.icesoft.faces.context.effects.Effect` | The Javascript Effect
required | false | false | `java.lang.Boolean` | Sets whether the input value is required
title | false | false | `java.lang.String` | Passed through to underlying component
style | false | false | `java.lang.String` | CSS style(s) to be applied when this component is rendered
styleClass | false | false | `java.lang.String` | Space-separated list of CSS style class(es) to be applied when this element is rendered.

Variables
| No Variables Defined.

Overview | Library | Tag | Help
| FRAMES NO FRAMES

Output Generated by Tag Library Documentation Generator. Java, JSP, and JavaServer Pages are trademarks or registered trademarks of Sun Microsystems, Inc. in the US and other countries. Copyright 2002-4 Sun Microsystems, Inc. 4150 Network Circle Santa Clara, CA 95054, U.S.A. All Rights Reserved.