Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migrated to Confluence 5.3

Description

...

Panel
borderColor#42773F
bgColor#F4F7F2
borderStylesolid
Section
Column

Image Added

Column

Pager

Excerpt

The Pager allows users to break up long lists of items into separate pages.

...

They

...

may decide whether or not they want paging, and how many results are displayed per page.

Sakai has page navigation now -- "List Navigator UI Component" in the Sakai style guide.  The default for how many items to show on a page varies.  How many makes sense depends on context, how many total items, what type of items, etc.  The idea here is to make this navigator remember the users last setting (across sessions).  That way they set if for what makes sense given the current situation and it is persistent.  As things change for them they simply change the setting to meet current needs and again it's persistent until they need to change it again.  Currently this is a "one size fits all" default and many users have to change it every time they visit a particular page.

Problems with current Sakai widget 

  • Often users change this setting every time they visit a particular page/tool.  As explained above, the default setting for how many to show on a page doesn't always make sense.
  • Related to above, widget doesn't remember users setting from previous session.
  • Widget takes up significant (extremely valuable) real estate at top of page.
  • Current widget is displayed even if the number of items is less than is required for paging (i.e. there are 9 items listed and paging kicks in by default after 10).

Use Cases / Requirements for new component

Features

  • Allow users to change the number of items shown per page
  • Allow users to jump to the first, last, and the "middle" pages easily
  • Allow users to jump to an item or a certain set of records (e.g. students with a last name starting with "G")
  • Be aware of the length of list and do not display widget when there is only one page
  • Show users how many items there are and where they are in the list (i.e. viewing

...

  • 11 - 20

...

Wireframes 

References / Competitive Analysis

NOTE:   Many of the below are for search navigation so should used strictly as a reference for more robust web application pages where users need to actually do something with the items in a list (other than just choose one).

Item Navigation (long list of items users may need to do something with) 

Search Navigation

  • of 2,356)

...

  • Remember users' paging settings and save it across visits to the site
Section
Column
width65%
Include Page
Progress Indicator - Pager
Progress Indicator - Pager
Column
width35%
Panel
borderColor#321137
bgColor#fff
titleBGColor#aab597
borderStylesolid
titleStatus

This component is in Preview status

Panel
borderColor#848484
bgColor#EFEFEF
titleBGColor#CCCCCC
borderStylesolid

Design

Integration

Demos

Latest Stable Release (v1.2)

Nightly Build