Navigation

• index
• modules |
• next |
• previous |
• Reahl 5.2.0 documentation »
• Web framework »
• Package reahl.web.bootstrap »

Package reahl.web.bootstrap.pagination

Examples in this section

• tutorial.pagerbootstrap

Get a copy of an example by running:

reahl example <examplename>

New in version 3.2.

Sometimes you need to display a long list of items. Displaying such a list on a single page is not a good idea, because the page will take forever to load.

This module provides a few classes you can use to build a single View that displays only one “pageful” of the list. You can then also include a PageMenu – a menu on which a user can choose to navigate to another section (or page) of the list.

PageMenu

class reahl.web.bootstrap.pagination.PageMenu(view, css_id, page_index, paged_panel)

An Menu, which lists the pages of items that can be navigated by a user. If there are many pages, only a small subset is shown, with controls allowing the user to browse to the wanted page number and choose it.

Parameters

• view – (See reahl.web.fw.Widget)

• css_id – (See reahl.web.ui.HTMLElement)

• page_index – The PageIndex whose pages are displayed by this PageMenu.

• paged_panel – The PagedPanel in which the contents of a page is displayed.

query_fields(fields)

Accessed as a property, but is a method:

@exposed
query_fields(self, fields)

Override this method to parameterise this Widget.

When accessed as a property for the first time, this method is called, and passed an empty FieldIndex as fields.

Inside the method you can declare each argument of the Widget by assigning a Field to an attribute of fields.

When constructed, the Widget uses the names and validation details of each Field to parse values for its arguments from the current query string. The resultant argument values set as attributes on this Widget (with names matching the argument names).

get_js(context=None)

Override this method if your Widget needs JavaScript to be activated on the browser side.

PagedPanel

class reahl.web.bootstrap.pagination.PagedPanel(view, page_index, css_id)

A Div whose contents change, depending on the page selected by a user from a PageMenu. A programmer should subclass from PagedPanel, supplying an __init__ method which populates the PagedPanel with appropriate contents, based on its .current_contents.

Styling

Represented in HTML by an <div> element.

Parameters

• view – (See reahl.web.fw.Widget)

• page_index – The PageIndex to use to supply contents to the pages displayed by this PagedPanel.

• css_id – (See reahl.web.ui.HTMLElement)

query_fields(fields)

Accessed as a property, but is a method:

@exposed
query_fields(self, fields)

Override this method to parameterise this Widget.

When accessed as a property for the first time, this method is called, and passed an empty FieldIndex as fields.

Inside the method you can declare each argument of the Widget by assigning a Field to an attribute of fields.

When constructed, the Widget uses the names and validation details of each Field to parse values for its arguments from the current query string. The resultant argument values set as attributes on this Widget (with names matching the argument names).

property current_contents

The list of items that should be displayed for the current page.

PageIndex

class reahl.web.bootstrap.pagination.PageIndex(current_page_number=1, start_page_number=1, max_page_links=5)

An object responsible for breaking a long list of items up into shorter lists for display. Each such shorter list is referred to as a page. Different ways of breaking long lists into smaller lists are provided by subclasses.

Parameters

• current_page_number – The initial page shown to users.

• start_page_number – The first page that should be listed in the current PageMenu.

• max_page_links – The number of pages to be shown in the current PageMenu.

abstract get_contents_for_page(page_number)

Override this method in subclasses to obtain the correct list of items for the given page_number.

abstract property total_number_of_pages

Override this @property in subclasses to state what the total number of pages is.

SequentialPageIndex

class reahl.web.bootstrap.pagination.SequentialPageIndex(items, items_per_page=5, current_page_number=1, start_page_number=1, max_page_links=4)

A PageIndex that breaks a list of items up into smaller lists, by cutting the original list into sections that have a maximum number of items per page.

Parameters

• items – The long list of items.

• items_per_page – The maximum number of items to allow on a page.

• current_page_number – (See PageIndex)

• start_page_number – (See PageIndex)

• max_page_links – (See PageIndex)

get_contents_for_page(page_number)

Override this method in subclasses to obtain the correct list of items for the given page_number.

property total_number_of_pages

Override this @property in subclasses to state what the total number of pages is.

AnnualPageIndex

class reahl.web.bootstrap.pagination.AnnualPageIndex(annual_item_organiser, current_page_number=1, start_page_number=1, max_page_links=4)

A PageIndex that breaks a list of items up into smaller lists, by arranging all items that have the same year on the same page.

Parameters

• annual_item_organiser – An object that implements AnnualItemOrganiserProtocol. Its methods will be called to find the relevent items, or determine what years are applicable.

• current_page_number – (See PageIndex)

• start_page_number – (See PageIndex)

• max_page_links – (See PageIndex)

get_contents_for_page(page_number)

Override this method in subclasses to obtain the correct list of items for the given page_number.

property total_number_of_pages

Override this @property in subclasses to state what the total number of pages is.

Navigation

• index
• modules |
• next |
• previous |
• Reahl 5.2.0 documentation »
• Web framework »
• Package reahl.web.bootstrap »

Created using Sphinx 4.4.0.