ride/lib-form

Form library of the Ride framework

Wednesday, November 29, 2017
by ride-user
Repository
7 Watchers
0 Stars
4,213 Installations

PHP
21 Dependents
0 Suggesters
0 Forks
0 Open issues
80 Versions
2 % Grown

The README.md

Ride: Form Library

Form library of the PHP Ride framework., _(*1)

What's In This Library

RowFactory

The RowFactory interface is used to create a Row based on a simple name. Using this factory adds flexibility to the forms since every row can be overwritten with another implementation if needed., _(*2)

A default implementation is provided by the GenericRowFactory class., _(*3)

Row

The Row interface is used to implement a row type. This can be a scalar type like a string, a number, ... all generic HTML form elements. It can also be a component or a collection of components., _(*4)

The following rows are provided by this library:, _(*5)

button
collection
component
date
email
file
hidden
image
label
number
object
option
password
select
string
text
time
website
wysiwyg

Component

The Component interface is used to group a combination of rows into a single row or form. For example, a datetime component can combine a date row and a time row together into a single row. Creating components will add reusability to your forms., _(*6)

The Widget interface is used to display a Row. Certain rows can have the same logic but a different view representation. Think about an option row which can be represented through a list of checkboxes (or radio buttons) or a select field., _(*7)

View

The View interface is used to send the form to the UI. It removes everything needed to build the form and makes sure the form is serializeable., _(*8)

Code Sample

Check this code sample to see some possibilities of this library:, _(*9)

<?php

function createForm(Form $form) {
    // id of the form
    $form->setId('form-example');
    // action to catch submission of different forms on one page
    $form->setAction('submit-example');

    $form->addRow('name', 'string', array(
        'label' => 'Name',
        'description' => 'Enter your name',
        'filters' => array(
            'trim' => array(),
        ), 
        'validators' => array(
            'required' => array(),
        ),
    ));
    $form->addRow('gender', 'option', array(
        'label' => 'Gender',
        'description' => 'Select your gender',
        'default' => 'F',
        'options' => array(
            'F' => 'Female',
            'M' => 'Male',
            'O' => 'Other', 
        ),
        'validators' => array(
            'required' => array(),
        ),
    ));
    $form->addRow('extra', 'string', array(
        'label' => 'Extra',
        'description' => 'Extra row to show off some other options',
        'multiple' => true,
        'disabled' => false,
        'readonly' => false,
        'attributes' => array(
            'data-extra' => 'An extra attribute for the HTML element',
        ),
    ));

    return $form->build();
}

Installation

You can use Composer to install this library., _(*10)

composer require ride/app-form

The Versions

29/11 2017

dev-master

9999999-dev

Form library of the Ride framework

library lib-form

Form library of the Ride framework

ride/lib-form

The README.md

Ride: Form Library

What's In This Library

RowFactory

Row

Component

Widget

View

Code Sample

Related Modules

Installation

The Versions

dev-master

The Requires

by Joris Vandeweerd

dev-develop

The Requires

by Joris Vandeweerd

1.0.4

The Requires

by Joris Vandeweerd

1.0.3

The Requires

by Joris Vandeweerd

1.0.2

The Requires

by Joris Vandeweerd

1.0.1

The Requires

by Joris Vandeweerd

1.0.0

The Requires

by Joris Vandeweerd

0.14.11

The Requires

by Joris Vandeweerd

0.14.10

The Requires

by Joris Vandeweerd

0.14.9

The Requires

by Joris Vandeweerd

0.14.8

The Requires

by Joris Vandeweerd

0.14.7

The Requires

by Joris Vandeweerd

0.14.5

The Requires

by Joris Vandeweerd

0.14.4

The Requires

by Joris Vandeweerd

0.14.3

The Requires

by Joris Vandeweerd

0.14.2

The Requires

by Joris Vandeweerd

0.14.1

The Requires

by Joris Vandeweerd

0.14.0

The Requires

by Joris Vandeweerd

0.13.0

The Requires

by Joris Vandeweerd

0.12.13

The Requires

by Joris Vandeweerd

0.12.12

The Requires

by Joris Vandeweerd

0.12.11

The Requires