JavaScripTools Manual

JavaScripTable

User interaction

The user may interact with the table using a row or cell function, change column sorting on the header or using the navigation bar.

The navigation bar may not be rendered or rendered at the bottom, top or both. This is set using the table navigation property to one of the following constants: JST_NAV_NONE, JST_NAV_TOP, JST_NAV_BOTTOM or JST_NAV_BOTH. The default value is determined by the JST_DEFAULT_NAVIGATION constant.

It contains the following data and links (when a property appear, the default value is determined by a constant inside parenthesis):

• The number of rows. The message is the number of rows concatenated to the singleRowText (JST_DEFAULT_SINGLE_ROW_TEXT) or multipleRowText (JST_DEFAULT_MULTIPLE_ROW_TEXT), depending on the row count.
• The next text will depend of the table being paged or not.
  • When paging is used, the pageText (JST_DEFAULT_PAGE_TEXT) is used to display the current and last pages. That text may contain variables that will be replaced by their respective values: ${current} and ${total}. The current page is a link that allows the user to type the page he want to navigate to. The total pages will be a link if allowChangePageSize (JST_DEFAULT_ALLOW_CHANGE_PAGE_SIZE) is set to true, to allow the user to change the page size.
    After, it, a text determined by showAllText (JST_DEFAULT_SHOW_ALL_TEXT), and, when allowChangePaging is true, that text will be a link that will show all rows.
  • When paging not used, a text determined by the usePagingText (JST_DEFAULT_USE_PAGING_TEXT) property. If allowChangePaging (JST_DEFAULT_ALLOW_CHANGE_PAGING) is true, the text will be a link that will start using paging.
• A link to the table top will be displayed if the allowTopLink (JST_DEFAULT_ALLOW_TOP_LINK) is true. This link is only useful if page size is large, or paging is not used, where, probably, the whole table wouldn't fit the screen.