eftec/formone

Creates HTML web Form on PHP

1.8 2020-01-13 19:39 UTC

Requires

• php: >=5.6
• ext-ctype: *
• eftec/validationone: ^1.13

LGPL-2.1-or-later

• Jorge Castro

• php
• form
• library

README

Creates HTML web Form on PHP

Instead of write this code

<form method='POST' enctype='multipart/form-data' >
<label for='field1'>field 1:</label>
<input type='text' name='field1' id='field1'value='' />
<br>
</form>

Use instead this one

<?php
$f=new \eftec\FormOne();

echo $f->start();
echo $f->id('field1')
    ->label('field 1:')
    ->type('label')
    ->render();
echo $f->id('field1')
    ->type('text')
    ->render();
echo $f->renderRaw('<br>');
echo $f->end();

• FormOne
  • render()
  • start()
  • end()
  • idForm($idForm)
  • prefix($prefix)
  • name($name)
  • id($id)
  • disabled($disabled=true)
  • type($type)
  • addClass($classes)
  • value($value)
  • itemValue($value)
  • label($label)
  • addItem($idOrArray,$text=null,$extra=null)
  • addItems($items)
  • addExtra($type,$value=null)
  • addAttr($type,$value=null)
  • onClick($js)
  • onChange($js)
  • addJScript($type,$js)
  • bind($bind)
  • inner($htmlInner)
  • readonly($readonly=true)
  • required($required=true)
  • Example
  • version
  • License.

render()

It's the end of the chain. It generates the end result (html)

start()

Start a form (

)

end()

End a form (

)

idForm($idForm)

It sets the identifier of the current form.

prefix($prefix)

It marks the prefix used by the name fields. Example "frm_"

name($name)

Sets the name of the current chain.

Note: if id() is not set at the end of the chain then, it also sets the id

id($id)

it sets the id of the current chain.

Note: if name() is not set at the end of the chain then, it also sets the name

disabled($disabled=true)

It sets the attribute disable of the chain

type($type)

addClass($classes)

It adds a class to the current element. You could add many classes using different calls. Examples:

$form
    ->addClass("col-sm-2 col-form-label")

$form
    ->addClass("col-sm-2")
    ->addClass("col-form-label")

classType($type,$classes)

It adds a class to all elements of a type

$f->classType('label','col-sm-2 col-form-label'); // for all labels
$f->classType('text','col-sm-10 form-control'); // for all textbox
$f->classType('select','col-sm-10 form-control'); // for all select

value($value)

It sets the current value, for example the default value of a textbox

itemValue($value)

It sets the value of the element. It's different to value because it's used when the value is "checked"

label($label)

It sets the label of the element.
It is used for label,checkbox,radiobuttons and buttons (inner html)

addItem($idOrArray,$text=null,$extra=null)

It adds a simple item to a list. It is commonly used by type="select"

$form->addItem('','--select a field--')

$form->addItem(['id'=>'','text'=>'--select a field--'])

addItems($items)

it adds multiple items to a list.

$array=[
            ['id'=>1,'text'=>'America'],
            ['id'=>2,'text'=>'Asia'],
            ['id'=>3,'text'=>'Europa'],
        ];
$form->addItem($array)

addExtra($type,$value=null)

addAttr($type,$value=null)

onClick($js)

onChange($js)

addJScript($type,$js)

bind($bind)

inner($htmlInner)

readonly($readonly=true)

required($required=true)

Example

$form->type('label')
    ->id('id')
    ->addClass("col-sm-2 col-form-label")
    ->inner('Id 1:')
    ->render()

it renders

<label for='id' class="col-sm-2 col-form-label">Id 1:</label>

version

• 1.8 2020-01-13 Some small updates
• 1.7 2018-20-29 A small optimization. Now if the class is empty then it doesn't render class=''
• 1.6 2018-20-28 Added "hidden" type.
• 1.5 2018-20-27 Some cleanup and classType()
• 1.4 2018-20-27 start(),end(),prefix(),idform() and "password" type.
• 1.2 2018-10-22 Some cleanup.
• 1.1 2018-10-22 new features
• 1.0 2018-10-21 first version

License.

Copyright Jorge Castro Castillo Eftec 2018

This program is supplied as dual license, LGPLV2 or commercial.