The List widget allows users to select one or more items from a list.

For a listing of all of the options, methods, and events available on this widget, please see the API docs for wijlist.

In this section

Breaking Changes in V3

Quick Start

Main Elements

Markup and Scripting

List Concepts

Adaptive for Mobile Use

This widget is an adaptive widget in v3. If you are running v2.3.x or earlier, it is not adaptive. You can download v3 here: Downloads Page.

An adaptive widget is different from a jQuery UI widget in that you can use it in both mobile and non-mobile web applications. To use it in non-mobile applications, just use the regular help. To use it in mobile applications:

• Use jQuery Mobile instead of jQuery UI references
• Do not initialize the widget in script (unless you need to for complex widgets like charts)
• Use the data-role attribute to create the widget in markup

These steps are demonstrated in the jQuery Mobile topic.