Třída TForm

Třída TForm generuje HTML kód formuláře. Chtěl jsem si ušetřit práci se stálým psaním HTML kódu formulářů a tak jsem si napsal tuhle třídu, která pomocí zařazování jednotlivých komponent generuje výsledný formulář aniž bych musel napsat jediný HTML tag. Veškerý vzhled komponent je definován jednotlivými třídami kaskádových stylů, jejich umístění je pozicováno souřadnicově (viz. GridBagLayout z prostředí Javy). Třídu TForm, včetně příkladu použití si můžete stáhnout zde. On-line ukázka formuláře vytvořeného pomocí třídy TFrom je tady.
TForm se může skládat z těchto komponent:

TButton - Klasické tlačítko
TCheckBox - Zaškrtávací políčko
TCombo - Výběr z definovaných hodnot
TEdit - Editační políčko
TImageButton - Grafické tlačítko
TText - Text vypisovaný ve formuláři
TTextArea - Textové pole
TTextError - Chybová zpráva

Popis vlastností

Žádné veřejné - platí k dobrým zvykům OOP, zapouzdřit vlastnosti (proměnné) třídy do metody a zde možné hodnoty řádně ošetřit. Vyhneme se tak možnému nemilému překvapení.

Popis metod

__construct( [call_script_name :string [,form_name :string [,class_name :string [,method :string ]]]] )

call_script_name = název scriptu který se má zavolat při odeslání formuláře, default hodnota je $PHP_SELF, tedy formulář volá script ve kterém je sám obsažen.
form_name = název formuláře, nepovinný parametr.
class_name = název třídy CSS pro zobrazení formuláře, nepovinný parametr, default hodnota je 'TForm'.
method = typ metody pro způsob odeslání dat z formuláře, nepovinný parametr, možné hodnoty jsou: GET a POST, default hodnota je POST.

SetTitle( o_title :TText )

o_title = objekt typu TText s nadpisem okna formulare.

SetBottomStyle( class_name :string )

class_name = název třídy CSS definující vzhled dolní části formuláře.

SetStyle( class_name :string )

class_name = název třídy CSS definující vzhled formuláře, není-li uvedena v konstruktoru je možné ji uvést zde.

Add( component :TKomponents, row :int, column :int )

component = proměnná objektu s komponentou (nikoliv název třídy, ale inicializovaný objekt).
row = řádek pro umístění komponenty.
column = sloupec pro umístění komponenty.

Metoda se stará o přidání komponenty na formulář a její 'napozicování' podle zadaného řádku (row) a sloupce (column). Nezáleží na pořadí jak komponenty na formulář přidáváte, ale doporučuji si v tom udělat nějaký systém pro lepší přehlednost kódu.

AddBottom( component :TKomponents )

component = proměnná objektu s komponentou (nikoliv název třídy, ale inicializovaný objekt).

Spodní část formuláře má jinou organizaci, všechno co se sem přidává pomocí této metody se bude automaticky zarovnávat do řádku. Tato část formuláře je hlavně zamýšlena pro různá tlačítka ovládající formulář. Jak bude tato část formuláře vypadat určuje třída CSS definovaná metodou 'SetBottomStyle'.

SetDataGrid( rows :int, columns :int )

rows = počet řádek.
columns = počet sloupců.

Definuje počet řádek a počet sloupců ve formuláři. Již výše v základním popisu TForm popisuji, že komponenty formuláře jsou pozicovány do tabulky. Je to lepší varianta, než je pozicovat konkrétně třeba v pixelech. Tabulkovým uspořádáním se myslím rychleji dopracujeme požadovaného vzhledu.

string: Render( )
Metoda vykresluje vlastní formulář, vrací text s HTML kódem kompletního formuláře. Interně tato metoda volá metodu 'Render()' u šech komponent zařazených do formuláře a sbírá jejich HTML kód ze kterého pak výsledně sestavuje HTML kód celého formuláře.

Zdrojový kód třídy TForm


<?php
require_once "ttext.class.php";

require_once "ttexterror.class.php";

require_once "tcheckbox.class.php";

require_once "tedit.class.php";

require_once "tbutton.class.php";

require_once "timagebutton.class.php";

require_once "tcombo.class.php";

require_once "ttextarea.class.php";



class TForm {

  protected $form_header;

  protected $a_components=array();

  protected $a_bottom=array();

  protected $TText_title;

  protected $bottom_style;

  protected $grid_columns=0;

  protected $grid_rows=0;

  protected $style = "TForm";

  

  public function __construct($call_script_name="",$form_name="",$class_name="TForm",$method="POST"){

    global $PHP_SELF;

    if ($call_script_name=="") $call_script_name = $PHP_SELF;

    $this->form_header = "<FORM action="$call_script_name" name="$form_name" method="$method" enctype="multipart/form-data">";

    }



  public function SetTitle(TText $o_title){

    $this->TText_title = $o_title;

    }  

  

  public function SetBottomStyle($class_name){

    $this->bottom_style = trim($class_name);

    }  

  

  public function SetStyle($class_name){

    $this->style = trim($class_name);

    }     

     

  public function Add($component,$row,$column){

    $row = (int) $row;

    $column = (int) $column;

    if ($row <= 0) throw new exception("Index of rows must be bigger then 0.");

    if ($column <= 0) throw new exception("Index of columns must be bigger then 0.");

    $this->a_components[$row][$column] = $component;

    }  

  

  public function AddBottom($component){

    $this->a_bottom[] = $component;

    }  

    

  public function SetDataGrid($rows,$columns){

    $rows = (int) $rows;

    $columns = (int) $columns;

    if ($rows <= 0) throw new exception("Count rows must be bigger then 0.");

    if ($columns <= 0) throw new exception("Count columns must be bigger then 0.");

    $this->grid_rows = $rows;

    $this->grid_columns = $columns;

    for($row=1;$row<=$rows;$row++){

      for($column=1;$column<=$columns;$column++){

        $this->a_components[$row][$column] = "0";

        }

      }

    }  

       

  public function Render(){

    $code .="n$this->form_header n";

    $code .= "<TABLE align="center" cellspacing="0" class="$this->style">n";

    if ($this->TText_title){

      $code .= "<TR><TD colspan="$this->grid_columns">".$this->TText_title->Render()."</TD></TR>n";

      $code .= "<TR><TD colspan="$this->grid_columns">&nbsp;</TD></TR>n";

      }

    //Render Data Grid in array 'a_components'

    for($row=1;$row<=$this->grid_rows;$row++){

      $code .= "<TR>";

      for($column=1;$column<=$this->grid_columns;$column++){

        if ($this->a_components[$row][$column]!=0){

      $code .= "<TD colspan="".$this->a_components[$row][$column]->GetColspan()."">";

      $code .= $this->a_components[$row][$column]->Render();

      $column = $column+($this->a_components[$row][$column]->GetColspan()-1);

      }else{

      $code .= "<TD>&nbsp;";

      }

    $code .= "</TD>";

        }

      $code .= "</TR>n";

      }

    //Render Bottom part

    if (Count($this->a_bottom)>0){

      $code .= "<TR><TD colspan="$this->grid_columns">&nbsp;</TD></TR>n";

      $code .= "<TR><TD colspan="$this->grid_columns" class="$this->bottom_style">";

      foreach($this->a_bottom as $object){

        $code .= $object->Render()."&nbsp;&nbsp;";

        }

      $code .= "</TD></TR>n";

      }

    $code .= "<TR><TD colspan="$this->grid_columns">&nbsp;</TD></TR>n";    

    $code .= "</TABLE>n";

    $code .= "</FORM>n";

    return $code;

    }  

  }


?>

Linux133.fzu.cz

Třída TForm

Popis vlastností

Popis metod

Zdrojový kód třídy TForm