Files
yii/docs/guide/pt/form.table.txt
2009-12-13 16:48:49 +00:00

71 lines
2.5 KiB
Plaintext

Coletando Entradas Tabulares
============================
As vezes queremos coletar entradas de usuário em modo batch (em lote, vários ao
mesmo tempo). Isso é, o usuário entra com informações para diversas instâncias
de modelos e os envia todos de uma só vez. Chamamos isso de *Entrada Tabular*,
porque seus campos normalmente são apresentados em uma tabela HTML.
Para trabalhar com entradas tabulares, devemos primeiro criar e preencher um vetor
de instâncias de modelos, dependendo se estamos inserindo ou atualizando os dados.
Podemos então recuperar as entradas do usuário a partir da variável `$_POST` e
atribui-las para cada modelo. Dessa forma, existe uma pequena diferença de quando
utilizamos um único modelo para entrada; devemos recuperar os dados utilizando
`$_POST['ClasseDoModelo'][$i]` em vez de `$_POST['ClasseDoModelo']`.
~~~
[php]
public function actionBatchUpdate()
{
// recupera os itens para atualização em lote
// assumindo que cada item é instância de um Item
$items=$this->getItemsToUpdate();
if(isset($_POST['Item']))
{
$valid=true;
foreach($items as $i=>$item)
{
if(isset($_POST['Item'][$i]))
$item->attributes=$_POST['Item'][$i];
$valid=$valid && $item->validate();
}
if($valid) // todos os itens são validos
// ...faça algo aqui
}
// exibe a visão para coletar as entradas tabulares
$this->render('batchUpdate',array('items'=>$items));
}
~~~
Com a ação pronta, precisamos criar a visão `batchUpdate` para exibir os campos
em um tabela HTML:
~~~
[php]
<div class="yiiForm">
<?php echo CHtml::beginForm(); ?>
<table>
<tr><th>Name</th><th>Price</th><th>Count</th><th>Description</th></tr>
<?php foreach($items as $i=>$item): ?>
<tr>
<td><?php echo CHtml::activeTextField($item,"[$i]name"); ?></td>
<td><?php echo CHtml::activeTextField($item,"[$i]price"); ?></td>
<td><?php echo CHtml::activeTextField($item,"[$i]count"); ?></td>
<td><?php echo CHtml::activeTextArea($item,"[$i]description"); ?></td>
</tr>
<?php endforeach; ?>
</table>
<?php echo CHtml::submitButton('Save'); ?>
<?php echo CHtml::endForm(); ?>
</div><!-- yiiForm -->
~~~
Note no código acima que utilizamos `"[$i]name"` em vez de `"name"` no segundo
parâmetro ao chamar o método [CHtml::activeTextField].
Se ocorrer algum erro de validação, os campos correspondentes serão identificados
automaticamente, da mesma forma como ocorre quando utilizamos um único modelo.
<div class="revision">$Id: form.table.txt 1389 2009-09-04 14:03:35Z istvan.beregszaszi $</div>