Overview | Library | Tag | Help
| FRAMES NO FRAMES

## ICEfaces EE Composite Components
Tag selectOneStateProvince

## The Select State or Province Composite Component

### Dynamically choose a US state or Canadian province

### Features

- The component will render an ice:selectOneMenu component with a list of United States states or Canadian provinces.
- Selecting a different country will dynamically change the list bound to the component.
- If the United States or Canada are not specified, the component will not render.

### How To Use

1. Add an instance of SelectOneStateProvince with getter and setter, to your bean
2. Add an <ice-cc:selectOneStateProvince/> tag to your page
3. Pass a reference to the bean into the component using the "bean" attribute
4. Specify the country in the "country" attribute. Use ISO 3166-1 two-letter country codes US or CA
5. Pass in the label (and value) of the first SelectItem using the "firstSelectItem" attribute

Example:

    <ice-cc:selectOneStateProvince id="stateOrProvince" bean="#{selectOneStateProvinceExampleBean}" country="#{selectOneStateProvinceExampleBean.country}" styleClass="stateProvStyle"/>

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

Attributes
Name | Required | Request-time | Type | Description
id | true | false | `java.lang.String` | A unique id for the component.
bean | true | false | `com.icesoft.faces.facelets.component.selectOneStateProvince.SelectOneStateProvince` | Bean containg an instance of SelectOneStateProvince with a getter and setter.
country | false | false | `java.lang.String` | ISO 3166-1 two-letter country code US or CA. Should be set to true in order to render component.
firstSelectItem | false | false | `java.lang.String` | String label and value of first SelectItem in the ice:selectOneMenu.
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.