type: widget

release: 0.0

status: in development

documentation: N/A

demo: http://view.jqueryui.com/grid/grid-spf/menugrid.html

TODOs

• wiki
• add links to dataview
• drop markup/style section? 
• spec:
• add template option, default is markup, set to null to use existing markup in page/element 
• bundle default template, add option to customize it 
• keyboard navigation: cursor/page up/down, home/end?

1 - Description:

Widget to browse through bigger amounts of data, split in different views in lists, tables or other representations. Allows direct access to a specified page. Does not cover scroll-based (finite or infinite) paging.

Existing plugins and references:

• Tablesorter 2.0 Pager example, nothing fancy
• jPaginate (demo), mostly notable for its scrolling of direct page links 
• jQuery pager plugin, demos have regular links instead of numbers 
• jQuery Cycle plugin demo with thumbnails as pager control 
• pagination plugin (demo), rather oldschool pager, with UI elements jumping around (see Next button)

2 - Visual Design:

In grid footer:

3 - Functional Specification:

Depends on Button for the individual controls, Dataview for manipulating the data model.

Options:

• source (default: null)
• The dataview instance to use.
• Interacts with the paging.limit and paging.offset options, as well as the page and totalPages methods.  

Methods:

• page(pageIndex)
• delegates to source.page() 
• pageIndex argument is optional 
• totalPages 
• delegates to source.totalPages() 
• first
• go to first page 
• prev
• go to previous page 
• next
• go to next page 
• last 
• got to last page 

Events:

• n/a

4 - Markup & Style:

4.1 Initial markup examples

(Pre-enhanced HTML markup structure that will be transformed into the final widget. There may be multiple possible HTML markup options per widget: for example, for a slider, radiobuttons, inputs or selects could all be used. )

4.2 Recommended transformed HTML markup

(The HTML markup structure and classes that will be used by the scripts in the enhanced version) 

4.3 Accessibility recommendation

(Detailed recommendations for ARIA, HTML markup, CSS and javascript that will contribute to universal access and full section 508 accessibility for screen readers, mobile devices and any other devices) 

4.4 CSS & Theme

(Description of the CSS classes to be used for all states, how custom theming and Themeroller support will work.) 

5 - Latest version of plugin:

http://view.jqueryui.com/grid/grid-spf/menugrid.html

6 - Open issues being discussed

• tdb