From fb2d7dc3bd9a7218a5662e0532d94d340016a255 Mon Sep 17 00:00:00 2001
From: Kenshin Okinaka <okinakak@yahoo.co.jp>
Date: Sat, 5 Aug 2017 16:54:13 +0900
Subject: [PATCH] [ja] follows #5040

---
 ja/views/cells.rst | 43 +++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 43 insertions(+)

diff --git a/ja/views/cells.rst b/ja/views/cells.rst
index b21dbb2a5c..5bb5150617 100644
--- a/ja/views/cells.rst
+++ b/ja/views/cells.rst
@@ -203,3 +203,46 @@
     各セルを描画するために新しい ``View`` インスタンスが作成され、それらの新しいオブジェクトは
     メインのテンプレート／レイアウトとはコンテキストを共有しません。各セルは内包されていて、
     ``View::cell()`` の呼び出しの引数として渡された変数にのみアクセスが可能です。
+
+
+セル内のデータのページ制御
+=============================
+
+ページ制御された結果セットを描画するセルを作成するには、ORM の ``Paginator`` クラスを利用します。
+ユーザーのお気に入りメッセージをページ制御する例は次のようになります。 ::
+
+    namespace App\View\Cell;
+
+    use Cake\View\Cell;
+    use Cake\Datasource\Paginator;
+
+    class FavoritesCell extends Cell
+    {
+        public function display($user)
+        {
+            $this->loadModel('Messages');
+
+            // paginator の作成
+            $paginator = new Paginator();
+
+            // モデルをページ制御
+            $results = $paginator->paginate(
+                $this->Messages,
+                $this->request->getQueryParams(),
+                [
+                    // パラメーター付きカスタムファインダーを使用
+                    'finder' => ['favorites' => [$user]],
+
+                    // スコープ指定のクエリー文字列パラメーターを使用
+                    'scope' => 'favorites',
+                ]
+            );
+            $this->set('favorites', $results);
+        }
+    }
+
+上記のセルは、 :ref:`スコープ指定のページ制御パラメーター <paginating-multiple-queries>`
+を使用して ``Messages`` モデルをページ制御します。
+
+.. versionadded:: 3.5.0
+    ``Cake\Datasource\Paginator`` は 3.5.0 で追加されました。