TurboGears – 分页

TurboGears 提供了一个方便的装饰器，称为 paginate()，用于将输出分成多个页面。此装饰器与 expose() 装饰器结合使用。@Paginate() 装饰器将查询结果的字典对象作为参数。此外，每页记录的数量由 items_per_page 属性的值决定。确保将 paginate 函数从 tg.decorators 导入到您的代码中。

如下重写 root.py 中的 listrec() 函数：

from tg.decorators import paginate
class RootController(BaseController):
   @expose ("hello.templates.studentlist")
   @paginate("entries", items_per_page = 3)
	
   def listrec(self):
      entries = DBSession.query(student).all()
      return dict(entries = entries)

每页项目设置为三个。

在 studentlist.html 模板中，通过在 py:for 指令下方添加 tmpl_context.paginators.entries.pager() 来启用页面导航。此模板的代码应如下所示：

<html xmlns = "http://www.w3.org/1999/xhtml"
   xmlns:py = "http://genshi.edgewall.org/">
   
   <head>
      <link rel = "stylesheet" type = "text/css" media = "screen" 
         href = "${tg.url('/css/style.css')}" />
      <title>Welcome to TurboGears</title>
   </head>
   
   <body>
      
      <h1>Welcome to TurboGears</h1>
		
      <py:with vars = "flash = tg.flash_obj.render('flash', use_js = False)">
         <div py:if = "flash" py:replace = "Markup(flash)" />
      </py:with>
      
      <h2>Current Entries</h2>
		
      <table border = '1'>
         <thead>
            <tr>
               <th>Name</th>
               <th>City</th>
               <th>Address</th>
               <th>Pincode</th>
            </tr>
         </thead>
         
         <tbody>
            <py:for each = "entry in entries">
               <tr>
                  <td>${entry.name}</td>
                  <td>${entry.city}</td>
                  <td>${entry.address}</td>
                  <td>${entry.pincode}</td>
               </tr>
            </py:for>
				
            <div>${tmpl_context.paginators.entries.pager()}</div>
         </tbody>
         
      </table>
   
   </body>

</html>

在浏览器中输入 **https://127.0.0.1:8080/listrec**。将显示表格中第一页的记录。在此表格顶部，还可以看到页面编号的链接。

如何向数据网格添加分页支持

还可以向数据网格添加分页支持。在以下示例中，分页数据网格旨在显示操作按钮。为了激活操作按钮，数据网格对象使用以下代码构建：

student_grid = DataGrid(fields = [('Name', 'name'),('City', 'city'),
   ('Address','address'), ('PINCODE', 'pincode'),
   ('Action', lambda obj:genshi.Markup('<a
      href = "%s">Edit</a>' % url('/edit',
      params = dict(name = obj.name)))) ])

这里，操作按钮链接到数据网格中每一行名称参数。

如下重写 **showgrid()** 函数：

@expose('hello.templates.grid')
@paginate("data", items_per_page = 3)

def showgrid(self):
   data = DBSession.query(student).all()
   return dict(page = 'grid', grid = student_grid, data = data)

浏览器显示分页数据网格如下所示：

点击第三行中的“编辑”按钮，它将重定向到以下 URL **https://127.0.0.1:8080/edit?name=Rajesh+Patil**

打印页面