Glossary Item Box

Overview: Overview

Client-side API: ComboBox client side API

See Also AspLib component library Send comments on this topic.

ComboBox

ComboBox provides auto-complete functionality so that when you write text in the ComboBox, it completes the text if it finds in item collection. It can be customized with styles, colors and sizes.

Control supports AJAX behavior: partially items loading and fast items uploading for large items collections.

 

Features:

 

ComboBox view sample:

 

ComboBox is initialized by an SelectBoxItem property. Each item has text and value properties. If you don't set item's value property it will equal the item text property.

AJAX behavior

Control has AJAX behavior. It may loads collection of values only after clicking on the drop-down button, not during page rendering. It decreases traffic and speed when working with large Items collections.

To enable AJAX behavior only set EnableAjaxBehavior=True

 

Initially by default ComboBox shows 25 first items that matches the search criteria (the count of items for each single request is setted by property ItemRequestCount).

When AJAX behavior is enabled ComboBox shows status bar with already uploaded items counter, loading status and "Upload next" button. When "Upload next" button pressed ComboBox requests next items that matches the search criteria.

When uploading items "Loading..." message appears:

Also you can use ItemsRequested server event to populate the items collection. Use event arguments to define what certain items you must add to the control items collection. It helps you to minimize requested data from the database.

Keyboard navigation

A critical requirement for software accessibility is keyboard support as a complete alternative to pointing devices (mouse, etc.). Use keyboard to navigate ComboBox:

In ComboBox textbox - press Down key to show pop-up window.

In the pop-up use next keys:

Keyboard key Action
Up Move to the up item
Down Move to the down item
Escape Close pop-up
Enter Select a an item - and close pop-up

Overview: Overview

Client-side API: ComboBox client side API

 

 


© 2002-2007 Astron Digital. All Rights Reserved.