[ English | 中文 (简体, 中国) | русский | português (Brasil) | नेपाली | 한국어 (대한민국) | Indonesia | français | español | esperanto | English (United Kingdom) | Deutsch ]
Horizon Tabs and TabGroups¶
Horizon includes a set of reusable components for programmatically building tabbed interfaces with fancy features like dynamic AJAX loading and nearly effortless templating and styling.
Tab Groups¶
For any tabbed interface, your fundamental element is the tab group which contains all your tabs. This class provides a dead-simple API for building tab groups and encapsulates all the necessary logic behind the scenes.
- class horizon.tabs.TabGroup(request, **kwargs)[código fonte]¶
A container class which knows how to manage and render Tab objects.
- slug¶
The URL slug and pseudo-unique identifier for this tab group.
- template_name¶
The name of the template which will be used to render this tab group. Default:
"horizon/common/_tab_group.html"
- sticky¶
Boolean to control whether the active tab state should be stored across requests for a given user. (State storage is all done client-side.)
- show_single_tab¶
Boolean to control whether the tab bar is shown when the tab group has only one tab. Default:
False
- param_name¶
The name of the GET request parameter which will be used when requesting specific tab data. Default:
tab
.
- classes¶
A list of CSS classes which should be displayed on this tab group.
- attrs¶
A dictionary of HTML attributes which should be rendered into the markup for this tab group.
- selected¶
Read-only property which is set to the instance of the currently-selected tab if there is one, otherwise
None
.
- active¶
Read-only property which is set to the value of the current active tab. This may not be the same as the value of
selected
if no specific tab was requested via theGET
parameter.
- get_default_classes()[código fonte]¶
Returns a list of the default classes for the tab group.
Defaults to
["nav", "nav-tabs", "ajax-tabs"]
.
- get_id()[código fonte]¶
Returns the id for this tab group.
Defaults to the value of the tab group’s
horizon.tabs.Tab.slug
.
- get_selected_tab()[código fonte]¶
Returns the tab specific by the GET request parameter.
In the event that there is no GET request parameter, the value of the query parameter is invalid, or the tab is not allowed/enabled, the return value of this function is None.
- get_tab(tab_name, allow_disabled=False)[código fonte]¶
Returns a specific tab from this tab group.
If the tab is not allowed or not enabled this method returns
None
.If the tab is disabled but you wish to return it anyway, you can pass
True
to the allow_disabled argument.
- get_tabs()[código fonte]¶
Returns a list of the allowed tabs for this tab group.
- load_tab_data()[código fonte]¶
Preload all data that for the tabs that will be displayed.
- render()[código fonte]¶
Renders the HTML output for this tab group.
- tabs_not_available()[código fonte]¶
The fallback handler if no tabs are either allowed or enabled.
In the event that no tabs are either allowed or enabled, this method is the fallback handler. By default it’s a no-op, but it exists to make redirecting or raising exceptions possible for subclasses.
Tabs¶
The tab itself is the discrete unit for a tab group, representing one view of data.
- class horizon.tabs.Tab(tab_group, request=None, policy_rules=None)[código fonte]¶
A reusable interface for constructing a tab within a TabGroup.
- name¶
The display name for the tab which will be rendered as the text for the tab element in the HTML. Required.
- slug¶
The URL slug and id attribute for the tab. This should be unique for a given tab group. Required.
- preload¶
Determines whether the contents of the tab should be rendered into the page’s HTML when the tab group is rendered, or whether it should be loaded dynamically when the tab is selected. Default:
True
.
- classes¶
A list of CSS classes which should be displayed on this tab.
- attrs¶
A dictionary of HTML attributes which should be rendered into the markup for this tab.
- load¶
Read-only access to determine whether or not this tab’s data should be loaded immediately.
- permissions¶
A list of permission names which this tab requires in order to be displayed. Defaults to an empty list (
[]
).
- allowed(request)[código fonte]¶
Determines whether or not the tab is displayed.
Tab instances can override this method to specify conditions under which this tab should not be shown at all by returning
False
.
- enabled(request)[código fonte]¶
Determines whether or not the tab should be accessible.
For example, the tab should be rendered into the HTML on load and respond to a click event.
If a tab returns
False
fromenabled
it will ignore the value ofpreload
and only render the HTML of the tab after being clicked.The default behavior is to return
True
for all cases.
- get_context_data(request, **kwargs)[código fonte]¶
Return a dictionary of context data used to render the tab.
Required.
- get_default_classes()[código fonte]¶
Returns a list of the default classes for the tab.
Defaults to and empty list (
[]
), however additional classes may be added depending on the state of the tab as follows:If the tab is the active tab for the tab group, in which the class
"active"
will be added.If the tab is not enabled, the classes the class
"disabled"
will be added.
- get_id()[código fonte]¶
Returns the id for this tab.
Defaults to
"{{ tab_group.slug }}__{{ tab.slug }}"
.
- get_template_name(request)[código fonte]¶
Returns the name of the template to be used for rendering this tab.
By default it returns the value of the
template_name
attribute on theTab
class.
- is_active()[código fonte]¶
Method to access whether or not this tab is the active tab.
- post(request, *args, **kwargs)[código fonte]¶
Handles POST data sent to a tab.
Tab instances can override this method to have tab-specific POST logic without polluting the TabView code.
The default behavior is to ignore POST data.
- render()[código fonte]¶
Renders the tab to HTML.
get_context_data()
method and theget_template_name()
method are called.If
preload
isFalse
andforce_load
is notTrue
, or eitherallowed()
orenabled()
returnsFalse
this method will return an empty string.
- class horizon.tabs.TableTab(tab_group, request)[código fonte]¶
A Tab class which knows how to deal with DataTable classes inside of it.
This distinct class is required due to the complexity involved in handling both dynamic tab loading, dynamic table updating and table actions all within one view.
- table_classes¶
An iterable containing the
DataTable
classes which this tab will contain. Equivalent to thetable_classes
attribute onMultiTableView
. For each table class you need to define a correspondingget_{{ table_name }}_data
method as withMultiTableView
.
- get_context_data(request, **kwargs)[código fonte]¶
Adds a
{{ table_name }}_table
item to the context for each table.The target tables are specified by the
table_classes
attribute.If only one table class is provided, a shortcut
table
context variable is also added containing the single table.
- load_table_data()[código fonte]¶
Calls the
get_{{ table_name }}_data
methods for each table class.When returning, the loaded data is set on the tables.
TabView¶
There is also a useful and simple generic class-based view for handling
the display of a TabGroup
class.
- class horizon.tabs.TabView[código fonte]¶
A generic view for displaying a
horizon.tabs.TabGroup
.This view handles selecting specific tabs and deals with AJAX requests gracefully.
- tab_group_class¶
The only required attribute for
TabView
. It should be a class which inherits fromhorizon.tabs.TabGroup
.
- get_context_data(**kwargs)[código fonte]¶
Adds the
tab_group
variable to the context data.
- get_tabs(request, **kwargs)[código fonte]¶
Returns the initialized tab group for this view.
- handle_tabbed_response(tab_group, context)[código fonte]¶
Sends back an AJAX-appropriate response for the tab group if needed.
Otherwise renders the response as normal.
- class horizon.tabs.TabbedTableView(*args, **kwargs)[código fonte]¶
- get_tables()[código fonte]¶
A no-op on this class. Tables are handled at the tab level.
- handle_table(table_dict)[código fonte]¶
Loads the table data based on a given table_dict and handles them.
For the given dict containing a
DataTable
and aTableTab
instance, it loads the table data for that tab and calls the table’smaybe_handle()
method. The return value will be the result ofmaybe_handle
.
- load_tabs()[código fonte]¶
Loads the tab group.
It compiles the table instances for each table attached to any
horizon.tabs.TableTab
instances on the tab group. This step is necessary before processing any tab or table actions.