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)

1ページあたりのアイテム数は3に設定されています。

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>

入る http://localhost: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)

ブラウザには、ページ付けされたデータグリッドが次のように表示されます-

3行目の[編集]ボタンをクリックすると、次のURLにリダイレクトされます http://localhost:8080/edit?name=Rajesh+Patil