django-html-sweatshop 0.1.0

原始分页

用法：

{% digg_paginator page_obj page_field theme %}

这是呈现分页的原始方式。如https://docs.djangoproject.com/en/1.9/topics/pagination/所述，您必须处理分页的实际工作（一些通用视图可以为您完成这部分工作）。此标记将处理分页的呈现。它提供了比其他两个更大的灵活性。

page_obj

Optional. A page object as outlined in https://docs.djangoproject.com/en/1.9/topics/pagination/#page-objects. By default, a variable named “page_obj” in the context will be used if it’s not provided.

page_field

Optional. The name of the page parameter in the url. For example, if “page_field” is set to “page”, when the link of the second page is clicked, “page=2” will be appended to the url. The default value is “page”.

theme

Optional. The theme pack to use. Right now Bootstrap 3 is the only valid theme available. So there’s no need to set this parameter.

Django-Table2集成

用法：

{% digg_paginator_tables2 table theme %}

此标记提供与django-tables2的集成。它通常与django-tables2附带的singletableview通用视图一起使用。但是django-tables2标记呈现的表可能在分页时看起来与默认表模板不同。

table

Optional. A table instance of django-tables2. Please refer to django-tables2 document regarding table class. By default, a variable named “table” in the context will be used if it’s not provided.

theme

Optional. The theme pack to use. Right now Bootstrap 3 is the only valid theme available. So there’s no need to set this parameter.

Django-Table2无缝集成

用法：

{% render_paginated_table table theme %}

此标记提供与django-tables2的无缝集成。与其他两个只呈现分页的标记不同，这个标记同时呈现表和分页。

table

Optional. A table instance of django-tables2. Please refer to django-tables2 document regarding table class. By default, a variable named “table” in the context will be used if it’s not provided.

theme

Optional. The theme pack to use. Right now Bootstrap 3 is the only valid theme available. So there’s no need to set this parameter.

加载标签定义

{% load one_step_delete_tags static %}

加载jquery插件

在应该包含js的地方加载jquery插件。包含jquery本身是您自己的责任。

{% include_one_step_delete_js %}

<script type=”text/javascript” src=”{% static ‘one_step_delete/js/init_one_step_delete.js’ %}”></script>

渲染删除按钮

根据主题包呈现删除按钮。以bootstrap 3主题为例，delete按钮可以是

<button class=”btn btn-danger” data-toggle=”modal” data-target=”…” data-modal-title=”…” data-modal-action=”…” data-obj-description=”…”>…</button>

可以定义一些特定于jquery插件的数据属性，以允许多个delete按钮共享相同的确认模式。

data-modal-title

Replace the modal title with this value when the button is clicked.

data-modal-action

Replace the action url of deletion submission with this value when the button is clicked.

data-obj-description

If you are satisfied with the overall message in the modal body, you can replace the description of the object to delete with this value to fine tune the message when the button is clicked.

data-body

Replace the message of the modal body with this value totally when the button is clicked.

呈现确认模式

使用以下标记呈现确认模式。您可以为每个删除按钮呈现每个确认模式，也可以呈现一个在删除按钮之间共享的模式。

{% render_confirm_modal dialog_id obj obj_description url title body theme %}

dialog_id

Optional. The HTML id of the confirmation modal. Defaults to “confirmation-modal”.

obj

Optional. A model object to be deleted. Once provided, a default confirmation message can be inferred by the tag.

obj_description

Optional. The default confirmation message use the verbose name of “obj” as the description. It can be overridden by this parameter.

url

Optional. The action url delete is submitted to. By default it’s empty.

title

Optional. The title of the confirmation modal. By default, it’s “Are you sure?”

body

Optional. Used to override the whole default confirmation message.

theme

Optional. The theme pack to use. Right now Bootstrap 3 is the only valid theme available. So there’s no need to set this parameter.