Navigation

• index
• modules |
• next |
• previous |
• Reahl 6.1.1 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

Used to declare the arguments of this Widget on its class.

Override this class attribute to declare arguments this Widget, each described by a Field.

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 are set as attributes on this Widget (with names matching the argument names).

To declare arguments on your own Widget class, assign a ExposedNames instance to query_fields and then assign a single-argument callable for each Widget argument to it. This callable will be called with the Widget instance as argument, and should return a Field describing it:

class MyWidget(Widget):
    query_fields = ExposedNames()
    query_fields.my_argument = lambda i: Field()

Changed in version 6.1: This used to be set up using a method using an exposed decorator.

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

Used to declare the arguments of this Widget on its class.

Override this class attribute to declare arguments this Widget, each described by a Field.

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 are set as attributes on this Widget (with names matching the argument names).

To declare arguments on your own Widget class, assign a ExposedNames instance to query_fields and then assign a single-argument callable for each Widget argument to it. This callable will be called with the Widget instance as argument, and should return a Field describing it:

class MyWidget(Widget):
    query_fields = ExposedNames()
    query_fields.my_argument = lambda i: Field()

Changed in version 6.1: This used to be set up using a method using an exposed decorator.

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 6.1.1 documentation »
• Web framework »
• Package reahl.web.bootstrap »

Created using Sphinx 5.3.0.