Por Manu Gutierrez - Tradução de Celeste Veiga
Uma das aplicações mais comuns que utilizamos nesta linguagem são os formulários PHP, por sua parte PHP não oferece nenhuma função para o desenvolvimento dos formulários. A biblioteca PEAR, um framework e sistema de distribuição de utilidades Php, contém o pacote HTML_QUICKFORM que proporciona todas as classes e métodos necessários para manejar formulários HTML.
QuickForm salva automaticamente os valores fixados para nossos elementos através do envio do formulário, mostra mensagens de erro, permite a validação e a filtração que se pode aplicar aos campos individuais e/ou ao formulário completo e gera o código Javascript para a validação no lado cliente. Além disso, simplifica os uploads de arquivos.
Entre outras coisas, nos concentraremos em:
É importante saber que é necessário o pacote HTML_COMMON.
Se a linha seguinte não retorna um erro, então você tem instalado QuickForm em seu sistema.
require("HTML/QuickForm.php");
require_once("HTML/QuickForm.php");
O passo seguinte será criar nosso objeto para o formulário:
$form = new HTML_QuickForm("myform");
Além disso HTML_QUICKFORM suporta outros tipos de elementos adicionais como são: date, static, header, html, link, advcheckbox e hiddenselect.
Alguns dos elementos podem aceitar argumentos adicionais. Por exemplo, um elemento "select" pode receber como argumento um array de valores que são itens da lista.
O objetivo destes artigos é demonstrar como podemos fazer uso de QuickForm e SMARTY para desenvolver uma pequena aplicaçãoWeb.
Requisitos
Há que destacar que HTML_QUICKFORM não é standard na instalação da biblioteca PEAR motivo pelo qual haverá que baixá-lo e colocá-lo no diretório em que tenhamos PEAR.
Configurar QuickForm
O primeiro passo para utilizar o pacote seria incluí-lo em nosso código, devemos fazê-lo da seguinte maneira:
Elementos do formulário
Podemos acrescentar novos elementos chamando a função addElement(). Você poderá definir a ordem em que os elementos aparecem no formulário.
A função recebe um número de argumentos, o primeiro define o tipo de elemento.
Para um formulário standard os tipos são: text, button, checkbox, hidden, submit, reset, radio, file, image, password, select e textarea.
O segundo argumento é o nome que será usado para o elemento.
O terceiro argumento representa a etiqueta do elemento(o texto que aparecerá em nosso navegador mais tarde).
Validação e regras de filtrado
HTML_QUICKFORM tem uma grande variedade de atributos para sua validação, este pacote simplifica o uso destas regras não apenas no servidor.