Formulário programado com QuickForm

Com as classes de QuickForm você poderá criar, validar e processar formulários PHP.

Por Manu Gutierrez - Tradução de Celeste Veiga


Publicado em: 07/12/10
Valorize este artigo:
Todos estaremos de acordo em que o poder de php reside na sua simplicidade e velocidade.

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.

Pacote de QuickForm

O pacote de HTML_QUICKFORM proporciona um sistema de classes que criam, validam, processam formulários HTML. Ao invés de imprimir os elementos do formulário um a um, podemos utilizar seus métodos para definir uma estrutura para o formulário.

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. A única razão pela qual alguém pode ficar reticente quanto ao uso de QuickForm é a carência de documentação apropriada. No entanto, isto não nos deve preocupar porque este artigo se destina a isso.

Entre outras coisas, nos concentraremos em:

  • Mostrar um formulário
  • Processo de entrada
  • Validação de campos
  • Subidas de arquivos
  • O uso SMARTY para otimizar o formulário
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.

É 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");

Configurar QuickForm

O primeiro passo para utilizar o pacote seria incluí-lo em nosso código, devemos fazê-lo da seguinte maneira:

require_once("HTML/QuickForm.php");

O passo seguinte será criar nosso objeto para o formulário:

$form = new HTML_QuickForm("myform");

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.

Além disso HTML_QUICKFORM suporta outros tipos de elementos adicionais como são: date, static, header, html, link, advcheckbox e hiddenselect.
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).

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.

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.






Usuários :    login / registro

Manuais relacionados
Categorias relacionadas
O autor

Home | Sobre nós | Copyright | Anuncie | Entrar em contato