Tobago Demo

Menu

Root Dummy Intro Search Getting Started Docker What's New Migration Compatibility FAQ API Download Server Info Logging Info In Suggest Textarea Date Range Group 5 Star Rating File Upload Out Label Badge Image Figure Progress Object Checkbox Toggle Dropdown Radio Listbox SelectOneList Multi Checkbox Multi Listbox Shuttle SelectManyList Button and Link Default Command Button Group Customizer Link Group Box Panel Separator Section Header and Footer Bar Popup Popover Toast Basic example Tab Client Tab Ajax Tab Server Basic example Sheet Sorting Paginator Sheet Column Selector Sheet Selectionchange Sheet Event Sheet Action Sheet Markup Sheet Style Empty Sheet Column Bar Sheet Filter Sheet Static Header Sheet Multi Header Sheet Tree Column Panel Sheet Editable Sheet Lazy Sheet Nested Basic example Tree Command Types Tree Select Tree Editor Tree Menu Tree Listbox Intro TinyMCE CKEditor Flow Layout Flex Layout Segment Layout Label Layout Grid Layout Split Layout Message-layout Overview Collapsible Box Collapsible Popup Collapsible Panel Collapsible Section Content Validation JSR 303 Severity Messages Content Security Policy Sanitize Roles Form AccessKey Focus Exception Handler Style Tag Bootstrap Theme Icons Partial Ajax Behavior WebSocket Transition Non Faces Request Conversion Error Handling For Each ConversationScoped Download Configuration Format Locale DataAttribute Meta
Root Dummy Intro Search Getting Started Docker What's New Migration Compatibility FAQ API Download Server Info Logging Info In Suggest Textarea Date Range Group 5 Star Rating File Upload Out Label Badge Image Figure Progress Object Checkbox Toggle Dropdown Radio Listbox SelectOneList Multi Checkbox Multi Listbox Shuttle SelectManyList Button and Link Default Command Button Group Customizer Link Group Box Panel Separator Section Header and Footer Bar Popup Popover Toast Basic example Tab Client Tab Ajax Tab Server Basic example Sheet Sorting Paginator Sheet Column Selector Sheet Selectionchange Sheet Event Sheet Action Sheet Markup Sheet Style Empty Sheet Column Bar Sheet Filter Sheet Static Header Sheet Multi Header Sheet Tree Column Panel Sheet Editable Sheet Lazy Sheet Nested Basic example Tree Command Types Tree Select Tree Editor Tree Menu Tree Listbox Intro TinyMCE CKEditor Flow Layout Flex Layout Segment Layout Label Layout Grid Layout Split Layout Message-layout Overview Collapsible Box Collapsible Popup Collapsible Panel Collapsible Section Content Validation JSR 303 Severity Messages Content Security Policy Sanitize Roles Form AccessKey Focus Exception Handler Style Tag Bootstrap Theme Icons Partial Ajax Behavior WebSocket Transition Non Faces Request Conversion Error Handling For Each ConversationScoped Download Configuration Format Locale DataAttribute Meta

Dropdown

The tag <tc:selectOneChoice/> create a dropdown box, which contain
<tc:selectItem/> for static entries or
<tc:selectItems value="#{controller.list}"/> for entries from a controller.

Tag Library Documentation: <tc:selectOneChoice/> | <tc:selectItem/> | <tc:selectItems/>

Basics

Dropdown box with hardcoded items. The second item is disabled. To disable an item, use the itemDisable attribute.

<tc:selectOneChoice label="Dropdown Box"/>

Simple Usage

Select a person. The label of the item is shown in the dropdown box. After submitting, the value of the item is shown in the output field. So, if 'Alice' is selected, the text in the output field is 'Alice Anderson'.

<tc:selectItem itemLabel="Alice" itemValue="Alice Anderson"/>

Java enum as value

Ajax

Select a planet and a moon. The list of moons depends on the selected planet. The planet-dropdownbox contain a <f:ajax render="moonbox"/>. With it, the moon-dropdownbox will be rerendered, after a value changed in planet-dropdownbox.

<tc:selectOneChoice label="Planet" value="#{selectOneChoiceController.planet}"> <f:selectItems value="#{selectOneChoiceController.planets}"/> <f:ajax render="moonbox"/> </tc:selectOneChoice> <tc:selectOneChoice id="moonbox" label="Moon"> <f:selectItems value="#{selectOneChoiceController.moons}"/> </tc:selectOneChoice>
© 2005-2025 Apache Software Foundation, Licensed under the Apache License, Version 2.0.