Merge pull request #7105 from softark/docs-guide-ja-input-updates

docs/guide-ja/README.md

@@ -90,7 +90,8 @@ All Rights Reserved.
 * [フォームを作成する](input-forms.md)
 * [入力を検証する](input-validation.md)
 * [ファイルをアップロードする](input-file-upload.md)
-* **未定** [複数モデルのデータ取得](input-multiple-models.md)
+* [表形式インプットのデータ収集](input-tabular-input.md)
+* [複数モデルのデータ取得](input-multiple-models.md)
 
 
 データの表示

docs/guide-ja/input-multiple-models.md

 複数のモデルを扱う複雑なフォーム
 ================================
 
+複雑なユーザインタフェイスにおいては、一つのフォームにユーザが入力したデータをデータベースの異なる複数のテーブルに保存しなければならないということが生じ得ます。
+Yii のフォームの概念に従うと、単一モデルのフォームと比べても、ほとんど複雑さを加えることなく、そういうフォームを構築することが出来ます。
+
+単一モデルの場合と同じように、サーバ側では次のような検証のスキーマに従います。
+
+1. モデルのクラスをインスタンス化する。
+2. モデルの属性に入力されたデータを投入する。
+3. 全てのモデルを検証する。
+4. 全てのモデルに対して検証が通った場合は、それらを保存する。
+5. 検証が失敗した場合、または、データが送信されなかった場合は、全てのモデルのインスタンスをビューに渡してフォームを表示する。
+
+次に、一つのフォームで複数のモデルを使用する例を示します ... (未定)
+
+複数のモデルの例
+----------------
+
+> Note|注意: この節はまだ執筆中です。
+>
+> まだ内容がありません。
+
+(未定)
+
+依存するモデル
+--------------
+
 > Note|注意: この節はまだ執筆中です。
 >
 > まだ内容がありません。
+
+(未定)

docs/guide-ja/input-tabular-input.md

+表形式インプットでデータを収集する
+==================================
+
+時として、一つのフォームで同じ種類の複数のモデルを扱わなければならないことがあります。
+例えば、それぞれが「名前-値」の形で保存され、`Setting` [アクティブレコード](db-active-record.md) モデルとして表される複数の設定項目を扱うフォームです。
+この種のフォームは「表形式インプット」と呼ばれることもよくあります。
+これとは対照的な、異なる種類のさまざまなモデルを扱うことについては、[複数のモデルを持つ複雑なフォーム](input-multiple-models.md) の節で扱います。
+
+以下に、表形式インプットを Yii で実装する方法を示します。
+
+カバーすべき三つの異なる状況があり、それぞれ少しずつ異なる処理をしなければなりません。
+- 特定の数のデータベースレコードを更新する
+- 不特定の数の新しいレコードを作成する
+- 一つのページでレコードを更新、作成、および、削除する
+
+前に説明した単一モデルのフォームとは対照的に、モデルの配列を扱うことになります。
+この配列がビューに渡されて、各モデルのためのインプットフィールドが表のような形式で表示され、そして、複数のモデルを一度にロードしたり検証したりするために [[yii\base\Model]] のヘルパメソッドを使用します。
+
+- [[yii\base\Model::loadMultiple()|Model::loadMultiple()]] - 送信されたデータをモデルの配列にロードします。
+- [[yii\base\Model::validateMultiple()|Model::validateMultiple()]] - モデルの配列を検証します。
+
+### 特定の数のレコードを更新する
+
+コントローラのアクションから始めましょう。
+
+```php
+<?php
+
+namespace app\controllers;
+
+use Yii;
+use yii\base\Model;
+use yii\web\Controller;
+use app\models\Setting;
+
+class SettingsController extends Controller
+{
+    // ...
+
+    public function actionUpdate()
+    {
+        $settings = Setting::find()->indexBy('id')->all();
+
+        if (Model::loadMultiple($settings, Yii::$app->request->post()) && Model::validateMultiple($settings)) {
+            foreach ($settings as $setting) {
+                $setting->save(false);
+            }
+            return $this->redirect('index');
+        }
+
+        return $this->render('update', ['settings' => $settings]);
+    }
+}
+```
+
+上記のコードでは、データベースからモデルを読み出すときに [[yii\db\ActiveQuery::indexBy()|indexBy()]] を使って、モデルのプライマリキーでインデックスされた配列にデータを投入しています。
+このインデックスが、後で、フォームフィールドを特定するために使われます。
+[[yii\base\Model::loadMultiple()|Model::loadMultiple()]] が POST から来るフォームデータを複数のモデルに代入し、[[yii\base\Model::validateMultiple()|Model::validateMultiple()]] が全てのモデルを一度に検証します。
+保存するときには、`validateMultiple()` を使ってモデルの検証を済ませていますので、[[yii\db\ActiveRecord::save()|save()]] のパラメータに `false` を渡して、二度目の検証を実行しないようにしています。
+
+次に、`update` ビューにあるフォームです。
+
+Now the form that's in `update` view:
+
+```php
+<?php
+use yii\helpers\Html;
+use yii\widgets\ActiveForm;
+
+$form = ActiveForm::begin();
+
+foreach ($settings as $index => $setting) {
+    echo $form->field($setting, "[$index]value")->label($setting->name);
+}
+
+ActiveForm::end();
+```
+
+ここで全ての設定項目について、それぞれ、項目名を示すラベルと、項目の値を入れたインプットをレンダリングしています。
+インプットの名前に適切なインデックスを追加することが肝腎です。
+というのは、`loadMultiple` がそれを見て、どのモデルにどの値を代入するかを決定するからです。
+
+### 不特定の数の新しいレコードを作成する
+
+新しいレコードを作成するのは、モデルのインスタンスを作成する部分を除いて、更新の場合と同じです。
+
+```php
+public function actionCreate()
+{
+    $count = count(Yii::$app->request->post('Setting', []));
+    $settings = [new Setting()];
+    for($i = 1; $i < $count; $i++) {
+        $settings[] = new Setting();
+    }
+
+    // ...
+}
+```
+
+ここでは、デフォルトで一個のモデルを含む `$settings` 配列を初期値として作成し、少なくとも一個のテキストフィールドが常にビューに表示されるようにしています。
+そして、受信したインプットの行数に合せて、配列にモデルを追加しています。
+
+ビューでは javascript を使ってインプットの行を動的に追加することが出来ます。
+
+### 更新、作成、削除を一つのページに組み合わせる
+
+> Note|注意: この節はまだ執筆中です。
+>
+> まだ内容がありません。
+
+(未定)

docs/guide-ja/tutorial-advanced-app.md

@@ -62,7 +62,7 @@ Composer がインストールされていれば、次のコマンドを使っ
     php /path/to/yii-application/init --env=Production --overwrite=All
     ```
 
-2. 新しいデータベースを作成し、それに従って `common/config/main-local.php` の `components.db` の構成情報を修正します。
+2. 新しいデータベースを作成し、それに従って `common/config/main-local.php` の `components['db']` の構成情報を修正します。
 3. コンソールコマンド `yii migrate` でマイグレーションを適用します。
 4. ウェブサーバのドキュメントルートを設定します。