# 收集列表輸入
有時你需要在一個表單中以單一的形式處理多個模型。例如，有多個設置，每個設置存儲為一個 name-value，并通過?`Setting`?[活動記錄](http://www.yiichina.com/doc/guide/2.0/db-active-record)模型來表示。 這種形式也常被稱為“列表輸入”。與此相反，處理不同模型的不同類型，在[多模型同時輸入](http://www.yiichina.com/doc/guide/2.0/input-multiple-models)章節中介紹。
下面展示了如何在 Yii 中收集列表輸入。
在三種不同的情況下，所需處理的略有不同：
* 從數據庫中更新一組固定的記錄
* 創建一個動態的新記錄集
* 更新、創建和刪除一頁記錄
與之前介紹的單一模型表單相反，我們現在用的是一個數組類的模型。這個數組將每個模型傳遞到視圖并以一種類似于表格的方式來顯示表單字段。 我們使用 yii\base\Model 助手類方法來一次性地加載和驗證多模型數據：
* yii\base\Model::loadMultiple() 將數據加載到一個數組中。
* yii\base\Model::validateMultiple() 驗證一系列模型。
### 更新一組固定的記錄
讓我們從控制器的動作開始：
~~~
<?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() 來讓模型的主鍵成為一個數組的索引。 其中 yii\base\Model::loadMultiple() 用于接收以 POST 方式提交的表單數據并填充多個模型， yii\base\Model::validateMultiple() 一次驗證多個模型。 正如我們之前驗證的模型，使用了?`validateMultiple()`，現在通過傳遞?`false`?作為 yii\db\ActiveRecord::save() 的一個參數使其不會重復驗證兩次。
現在在?`update`?視圖的表單：
~~~
<?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();
~~~
在這里，我們為每個設置渲染了名字和一個帶值的輸入。重要的是給 input name 增加添加適當的索引， 因為這是由 yii\base\Model::loadMultiple() 來決定以哪些值來填補哪個模型。
### 創建一組動態的新記錄
創造新的記錄與修改記錄很相似，除部分實例化模型不同之外：
~~~
public function actionCreate()
{
$count = count(Yii::$app->request->post('Setting', []));
$settings = [new Setting()];
for($i = 1; $i < $count; $i++) {
$settings[] = new Setting();
}
// ...
}
~~~
在這里，我們創建了一個初始的?`$settings`?數組包含一個默認的模型，所以始終至少有一個文本字段是可見的。 此外，我們為每個可能會收到的輸入行添加更多的模型。
在視圖中，可以使用 JavaScript 來動態地添加新的輸入行。
### 把更新，創建和刪除結合在一個頁面上
> 注意：此章節正在開發中。
>
> 還沒有內容。
TBD
- 介紹（Introduction）
- 關于 Yii（About Yii）
- 從 Yii 1.1 升級（Upgrading from Version 1.1）
- 入門（Getting Started）
- 安裝 Yii（Installing Yii）
- 運行應用（Running Applications）
- 第一次問候（Saying Hello）
- 使用 Forms（Working with Forms）
- 玩轉 Databases（Working with Databases）
- 用 Gii 生成代碼（Generating Code with Gii）
- 更上一層樓（Looking Ahead）
- 應用結構（Application Structure）
- 結構概述（Overview）
- 入口腳本（Entry Scripts）
- 應用（Applications）
- 應用組件（Application Components）
- 控制器（Controllers）
- 模型（Models）
- 視圖（Views）
- 模塊（Modules）
- 過濾器（Filters）
- 小部件（Widgets）
- 前端資源（Assets）
- 擴展（Extensions）
- 請求處理（Handling Requests）
- 運行概述（Overview）
- 引導（Bootstrapping）
- 路由引導與創建 URL（Routing and URL Creation）
- 請求（Requests）
- 響應（Responses）
- Sessions and Cookies
- 錯誤處理（Handling Errors）
- 日志（Logging）
- 關鍵概念（Key Concepts）
- 組件（Components）
- 屬性（Properties）
- 事件（Events）
- 行為（Behaviors）
- 配置（Configurations）
- 別名（Aliases）
- 類自動加載（Class Autoloading）
- 服務定位器（Service Locator）
- 依賴注入容器（Dependency Injection Container）
- 配合數據庫工作（Working with Databases）
- 數據庫訪問（Data Access Objects）: 數據庫連接、基本查詢、事務和模式操作
- 查詢生成器（Query Builder）: 使用簡單抽象層查詢數據庫
- 活動記錄（Active Record）: 活動記錄對象關系映射（ORM），檢索和操作記錄、定義關聯關系
- 數據庫遷移（Migrations）: 在團體開發中對你的數據庫使用版本控制
- Sphinx
- Redis
- MongoDB
- ElasticSearch
- 接收用戶數據（Getting Data from Users）
- 創建表單（Creating Forms）
- 輸入驗證（Validating Input）
- 文件上傳（Uploading Files）
- 收集列表輸入（Collecting Tabular Input）
- 多模型同時輸入（Getting Data for Multiple Models）
- 顯示數據（Displaying Data）
- 格式化輸出數據（Data Formatting）
- 分頁（Pagination）
- 排序（Sorting）
- 數據提供器（Data Providers）
- 數據小部件（Data Widgets）
- 操作客戶端腳本（Working with Client Scripts）
- 主題（Theming）
- 安全（Security）
- 認證（Authentication）
- 授權（Authorization）
- 處理密碼（Working with Passwords）
- 客戶端認證（Auth Clients）
- 安全領域的最佳實踐（Best Practices）
- 緩存（Caching）
- 概述（Overview）
- 數據緩存（Data Caching）
- 片段緩存（Fragment Caching）
- 分頁緩存（Page Caching）
- HTTP 緩存（HTTP Caching）
- RESTful Web 服務
- 快速入門（Quick Start）
- 資源（Resources）
- 控制器（Controllers）
- 路由（Routing）
- 格式化響應（Response Formatting）
- 授權驗證（Authentication）
- 速率限制（Rate Limiting）
- 版本化（Versioning）
- 錯誤處理（Error Handling）
- 開發工具（Development Tools）
- 調試工具欄和調試器（Debug Toolbar and Debugger）
- 使用 Gii 生成代碼（Generating Code using Gii）
- TBD 生成 API 文檔（Generating API Documentation）
- 測試（Testing）
- 概述（Overview）
- 搭建測試環境（Testing environment setup）
- 單元測試（Unit Tests）
- 功能測試（Functional Tests）
- 驗收測試（Acceptance Tests）
- 測試夾具（Fixtures）
- 高級專題（Special Topics）
- 高級應用模版（Advanced Project Template）
- 從頭構建自定義模版（Building Application from Scratch）
- 控制臺命令（Console Commands）
- 核心驗證器（Core Validators）
- 國際化（Internationalization）
- 收發郵件（Mailing）
- 性能優化（Performance Tuning）
- 共享主機環境（Shared Hosting Environment）
- 模板引擎（Template Engines）
- 集成第三方代碼（Working with Third-Party Code）
- 小部件（Widgets）
- Bootstrap 小部件（Bootstrap Widgets）
- jQuery UI 小部件（jQuery UI Widgets）
- 助手類（Helpers）
- 助手一覽（Overview）
- Array 助手（ArrayHelper）
- Html 助手（Html）
- Url 助手（Url）