将django页面对象呈现为与bootstrap 3.x分页兼容的html
django-bootstrap-pagination-vinta的Python项目详细描述
========
django bootstrap分页
========
**注意:**此版本仅与bootstrap 3.x兼容!请使用1.0.x分支来支持引导2。
此应用程序可使使用Twitter的引导分页样式与django页面对象无缝工作。通过传入一个page对象和
一个或多个可选参数,引导分页栏和寻呼机可以很容易地呈现出来。
与django 1.3+
内容:
----
installation
----
**pip**
**下载**
下载最新的稳定发行版,网址:
http://pypi.python.org/pypi/django bootstrap pagination
最新开发版本来自:
github@http://www.github.com/jmcclell/django bootstrap pagination
----
usage
----
**setup**
请确保在"设置"中的已安装应用列表中包含bootstrap pagination。py:
已安装的应用程序=(
‘引导分页’,
)
此外,在使用分页标记的任何模板顶部包括以下代码段:
{%load bootstrap分页%}
====
bootstrap分页
======
接受一个"django paginator实例"lt;https://docs.djangoproject.com/en/dev/topics/pagination/>;`\u
作为参数来构建一个跳转到页面元素。
**所有可选参数**
range
定义要显示的最大页面链接数
show_prev_next
布尔型。定义是否显示上一个和下一个链接。(接受"true"或"false")
previous_label
用于上一链接的标签
next_label
用于下一链接的标签
show_first_last
布尔值。定义是否显示第一个和最后一个链接。(接受"true"或"false")
first_label
用于第一页链接的标签
last_label
用于最后一页链接的标签
url_view_name
命名的url引用(例如可能在url模板标记中传递的引用)用作url
模板。必须可由reverse()函数解析。**如果未指定此选项,则标记仅使用相对URL,如"?page=1"这在大多数情况下都很好**
url_param_name
确定页码的get参数的名称。默认为"页面"。如果未定义
**url_view_name**,则此字符串将作为"?{{url_param_name}=1"。
url_extra_args
**仅当设置了url_view_name时有效。**
要传递到reverse()以解析url的其他参数。
**仅当设置了url_view_name时有效。**
要传递到reverse()的其他命名参数解析url。此外,
template标记将为此页面添加一个额外的参数,因为假设
给定一个url_名称,则该页面将是url正则表达式中的一个命名变量。在
这种情况下,**url_param_name**继续是用于表示名称的字符串。
即,默认情况下,**url_param_name**等于"page",因此,**url_view_name**引用的url中应该有一个命名的"page"参数。这允许
我们使用漂亮的分页URL,例如"/page/1"
**基本用法**
>下面将显示一个分页栏,其中包含指向每个页面的链接、上一个链接和下一个链接:
{%bootstrap_paginate page_obj%}
最多有10个页面链接,前一个链接和下一个链接:
{%bootstrap_paginate page_obj range=10%}
下面将显示分页栏,最多包含10个页面链接、一个第一页链接和一个最后一页链接:
{%bootstrap_paginate page_obj range=10 show_prev_next="false"show_first_last="true"%}
**高级用法**
_ index_view=archiveindexview.as_view(
日期字段='date',
分页依据=10,
允许_empty=true,
查询集=mymodel.all(),
模板名='example/archive.html'
)
urlpatterns=patterns(
"example.views",
url(r'^$',存档索引视图,name='存档索引'),
url(r'^page/(?p<;page>;\d+/$',archive_index_view,
name="archive_index_paginated'))
我们可以简单地使用基本用法(附加?page=)上面有*archive_index*url,
作为来自django的*archive_index_view*基于类的通用视图,并不关心它如何获得
页面参数。但是,如果我们想要漂亮的url,比如在
*archive_index_paginated*url(即/page/1)中定义的url,我们需要在模板标记中定义url:
{%bootstrap_paginate page_obj url_view_name="archive_index_paginated"%}
,因为我们使用的是默认的页面参数。"page"的名称和我们的url不需要其他
参数,一切正常。如果我们的url需要额外的参数,我们将使用可选的参数**url_extra_args**和**url_extra_kwargs**传递它们。
同样,如果我们的页面参数有不同的名称,我们将向模板标记传递不同的
**url_param_name**参数。
==========
引导分页器
==
==
引导分页功能的一个更简单的实现是分页器,它只提供上一个和下一个链接。
**所有可选参数**
next_label
定义下一链接的标签
previous_title
定义上一链接的链接标题
next_title
定义下一链接的链接标题
居中
布尔值。定义链接是否居中。默认为false。
(接受"true"或"false")
url查看名称
一个命名的url引用(例如可能在url模板标记中传递的引用)用作url模板。必须可由reverse()函数解析。**如果未指定此选项,则标记仅使用相对URL,如"?page=1"这在大多数情况下都很好**
url_param_name
确定页码的get参数的名称。默认为"页面"。如果未定义
**url_view_name**,则此字符串将作为"?{{url_param_name}=1"。
url_extra_args
**仅当设置了url_view_name时有效。**
要传递到reverse()以解析url的其他参数。
**仅当设置了url_view_name时有效。**
要传递到reverse()的其他命名参数解析url。此外,
template标记将为此页面添加一个额外的参数,因为假设
给定一个url_名称,则该页面将是url正则表达式中的一个命名变量。在
这种情况下,**url_param_name**继续是用于表示名称的字符串。
即,默认情况下,**url_param_name**等于"page",因此,**url_view_name**引用的url中应该有一个命名的"page"参数。这允许
我们使用漂亮的分页url,例如"/page/1"
要在url中使用的锚。默认为无。
**用法**
用法与引导分页基本相同。最简单的用法是:
{%bootstrap_pager page_obj%}
更高级的用法可能是:
{%bootstrap_pager page_obj previous_label="newer posts"next_label="older posts"url_view_name="post_archive_paginated"%}
django bootstrap分页
========
**注意:**此版本仅与bootstrap 3.x兼容!请使用1.0.x分支来支持引导2。
此应用程序可使使用Twitter的引导分页样式与django页面对象无缝工作。通过传入一个page对象和
一个或多个可选参数,引导分页栏和寻呼机可以很容易地呈现出来。
与django 1.3+
内容:
----
installation
----
**pip**
**下载**
下载最新的稳定发行版,网址:
http://pypi.python.org/pypi/django bootstrap pagination
最新开发版本来自:
github@http://www.github.com/jmcclell/django bootstrap pagination
----
usage
----
**setup**
请确保在"设置"中的已安装应用列表中包含bootstrap pagination。py:
已安装的应用程序=(
‘引导分页’,
)
此外,在使用分页标记的任何模板顶部包括以下代码段:
{%load bootstrap分页%}
====
bootstrap分页
======
接受一个"django paginator实例"lt;https://docs.djangoproject.com/en/dev/topics/pagination/>;`\u
作为参数来构建一个跳转到页面元素。
**所有可选参数**
range
定义要显示的最大页面链接数
show_prev_next
布尔型。定义是否显示上一个和下一个链接。(接受"true"或"false")
previous_label
用于上一链接的标签
next_label
用于下一链接的标签
show_first_last
布尔值。定义是否显示第一个和最后一个链接。(接受"true"或"false")
first_label
用于第一页链接的标签
last_label
用于最后一页链接的标签
url_view_name
命名的url引用(例如可能在url模板标记中传递的引用)用作url
模板。必须可由reverse()函数解析。**如果未指定此选项,则标记仅使用相对URL,如"?page=1"这在大多数情况下都很好**
url_param_name
确定页码的get参数的名称。默认为"页面"。如果未定义
**url_view_name**,则此字符串将作为"?{{url_param_name}=1"。
url_extra_args
**仅当设置了url_view_name时有效。**
要传递到reverse()以解析url的其他参数。
要传递到reverse()的其他命名参数解析url。此外,
template标记将为此页面添加一个额外的参数,因为假设
给定一个url_名称,则该页面将是url正则表达式中的一个命名变量。在
这种情况下,**url_param_name**继续是用于表示名称的字符串。
即,默认情况下,**url_param_name**等于"page",因此,**url_view_name**引用的url中应该有一个命名的"page"参数。这允许
我们使用漂亮的分页URL,例如"/page/1"
**基本用法**
>下面将显示一个分页栏,其中包含指向每个页面的链接、上一个链接和下一个链接:
{%bootstrap_paginate page_obj%}
最多有10个页面链接,前一个链接和下一个链接:
{%bootstrap_paginate page_obj range=10%}
下面将显示分页栏,最多包含10个页面链接、一个第一页链接和一个最后一页链接:
{%bootstrap_paginate page_obj range=10 show_prev_next="false"show_first_last="true"%}
**高级用法**
_ index_view=archiveindexview.as_view(
日期字段='date',
分页依据=10,
允许_empty=true,
查询集=mymodel.all(),
模板名='example/archive.html'
)
urlpatterns=patterns(
"example.views",
url(r'^$',存档索引视图,name='存档索引'),
url(r'^page/(?p<;page>;\d+/$',archive_index_view,
name="archive_index_paginated'))
我们可以简单地使用基本用法(附加?page=)上面有*archive_index*url,
作为来自django的*archive_index_view*基于类的通用视图,并不关心它如何获得
页面参数。但是,如果我们想要漂亮的url,比如在
*archive_index_paginated*url(即/page/1)中定义的url,我们需要在模板标记中定义url:
{%bootstrap_paginate page_obj url_view_name="archive_index_paginated"%}
,因为我们使用的是默认的页面参数。"page"的名称和我们的url不需要其他
参数,一切正常。如果我们的url需要额外的参数,我们将使用可选的参数**url_extra_args**和**url_extra_kwargs**传递它们。
同样,如果我们的页面参数有不同的名称,我们将向模板标记传递不同的
**url_param_name**参数。
==========
引导分页器
==
==
引导分页功能的一个更简单的实现是分页器,它只提供上一个和下一个链接。
**所有可选参数**
next_label
定义下一链接的标签
previous_title
定义上一链接的链接标题
next_title
定义下一链接的链接标题
居中
布尔值。定义链接是否居中。默认为false。
(接受"true"或"false")
url查看名称
一个命名的url引用(例如可能在url模板标记中传递的引用)用作url模板。必须可由reverse()函数解析。**如果未指定此选项,则标记仅使用相对URL,如"?page=1"这在大多数情况下都很好**
url_param_name
确定页码的get参数的名称。默认为"页面"。如果未定义
**url_view_name**,则此字符串将作为"?{{url_param_name}=1"。
url_extra_args
**仅当设置了url_view_name时有效。**
要传递到reverse()以解析url的其他参数。
要传递到reverse()的其他命名参数解析url。此外,
template标记将为此页面添加一个额外的参数,因为假设
给定一个url_名称,则该页面将是url正则表达式中的一个命名变量。在
这种情况下,**url_param_name**继续是用于表示名称的字符串。
即,默认情况下,**url_param_name**等于"page",因此,**url_view_name**引用的url中应该有一个命名的"page"参数。这允许
我们使用漂亮的分页url,例如"/page/1"
**用法**
用法与引导分页基本相同。最简单的用法是:
{%bootstrap_pager page_obj%}
更高级的用法可能是:
{%bootstrap_pager page_obj previous_label="newer posts"next_label="older posts"url_view_name="post_archive_paginated"%}