mirror of
https://github.com/monstra-cms/monstra.git
synced 2025-08-04 04:07:59 +02:00
413 lines
11 KiB
PHP
413 lines
11 KiB
PHP
<?php
|
|
|
|
/**
|
|
* Gelato Library
|
|
*
|
|
* This source file is part of the Gelato Library. More information,
|
|
* documentation and tutorials can be found at http://gelato.monstra.org
|
|
*
|
|
* @package Gelato
|
|
*
|
|
* @author Romanenko Sergey / Awilum <awilum@msn.com>
|
|
* @copyright 2012-2013 Romanenko Sergey / Awilum <awilum@msn.com>
|
|
*
|
|
* For the full copyright and license information, please view the LICENSE
|
|
* file that was distributed with this source code.
|
|
*/
|
|
|
|
class Form
|
|
{
|
|
/**
|
|
* The registered custom macros.
|
|
*
|
|
* @var array
|
|
*/
|
|
public static $macros = array();
|
|
|
|
/**
|
|
* Protected constructor since this is a static class.
|
|
*
|
|
* @access protected
|
|
*/
|
|
protected function __construct()
|
|
{
|
|
// Nothing here
|
|
}
|
|
|
|
/**
|
|
* Registers a custom macro.
|
|
*
|
|
* <code>
|
|
*
|
|
* // Registering a Form macro
|
|
* Form::macro('my_field', function() {
|
|
* return '<input type="text" name="my_field">';
|
|
* });
|
|
*
|
|
* // Calling a custom Form macro
|
|
* echo Form::my_field();
|
|
*
|
|
*
|
|
* // Registering a Form macro with parameters
|
|
* Form::macro('my_field', function($value = '') {
|
|
* return '<input type="text" name="my_field" value="'.$value.'">';
|
|
* });
|
|
*
|
|
* // Calling a custom Form macro with parameters
|
|
* echo Form::my_field('Monstra');
|
|
*
|
|
* </code>
|
|
*
|
|
* @param string $name Name
|
|
* @param Closure $macro Macro
|
|
*/
|
|
public static function macro($name, $macro)
|
|
{
|
|
Form::$macros[$name] = $macro;
|
|
}
|
|
|
|
/**
|
|
* Create an opening HTML form tag.
|
|
*
|
|
* <code>
|
|
* // Form will submit back to the current page using POST
|
|
* echo Form::open();
|
|
*
|
|
* // Form will submit to 'search' using GET
|
|
* echo Form::open('search', array('method' => 'get'));
|
|
*
|
|
* // When "file" inputs are present, you must include the "enctype"
|
|
* echo Form::open(null, array('enctype' => 'multipart/form-data'));
|
|
* </code>
|
|
*
|
|
* @param mixed $action Form action, defaults to the current request URI.
|
|
* @param array $attributes HTML attributes.
|
|
* @uses Url::base
|
|
* @uses Html::attributes
|
|
* @return string
|
|
*/
|
|
public static function open($action = null, array $attributes = null)
|
|
{
|
|
if (! $action) {
|
|
|
|
// Submits back to the current url
|
|
$action = '';
|
|
|
|
} elseif (strpos($action, '://') === false) {
|
|
|
|
// Make the URI absolute
|
|
$action = Url::base() . '/' . $action;
|
|
}
|
|
|
|
// Add the form action to the attributes
|
|
$attributes['action'] = $action;
|
|
|
|
if ( ! isset($attributes['method'])) {
|
|
|
|
// Use POST method
|
|
$attributes['method'] = 'post';
|
|
}
|
|
|
|
return '<form'.Html::attributes($attributes).'>';
|
|
}
|
|
|
|
/**
|
|
* Create a form input.
|
|
* Text is default input type.
|
|
*
|
|
* <code>
|
|
* echo Form::input('username', $username);
|
|
* </code>
|
|
*
|
|
* @param string $name Input name
|
|
* @param string $value Input value
|
|
* @param array $attributes HTML attributes
|
|
* @uses Html::attributes
|
|
* @return string
|
|
*/
|
|
public static function input($name, $value = null, array $attributes = null)
|
|
{
|
|
// Set the input name
|
|
$attributes['name'] = $name;
|
|
|
|
// Set the input id
|
|
$attributes['id'] = (isset($attributes['id']))?$attributes['id']:$name;
|
|
|
|
// Set the input value
|
|
$attributes['value'] = $value;
|
|
|
|
if ( ! isset($attributes['type'])) {
|
|
// Default type is text
|
|
$attributes['type'] = 'text';
|
|
}
|
|
|
|
return '<input'.Html::attributes($attributes).' />';
|
|
}
|
|
|
|
/**
|
|
* Create a hidden form input.
|
|
*
|
|
* <code>
|
|
* echo Form::hidden('user_id', $user_id);
|
|
* </code>
|
|
*
|
|
* @param string $name Input name
|
|
* @param string $value Input value
|
|
* @param array $attributes HTML attributes
|
|
* @uses Form::input
|
|
* @return string
|
|
*/
|
|
public static function hidden($name, $value = null, array $attributes = null)
|
|
{
|
|
// Set the input type
|
|
$attributes['type'] = 'hidden';
|
|
|
|
return Form::input($name, $value, $attributes);
|
|
}
|
|
|
|
/**
|
|
* Creates a password form input.
|
|
*
|
|
* <code>
|
|
* echo Form::password('password');
|
|
* </code>
|
|
*
|
|
* @param string $name Input name
|
|
* @param string $value Input value
|
|
* @param array $attributes HTML attributes
|
|
* @uses Form::input
|
|
* @return string
|
|
*/
|
|
public static function password($name, $value = null, array $attributes = null)
|
|
{
|
|
// Set the input type
|
|
$attributes['type'] = 'password';
|
|
|
|
return Form::input($name, $value, $attributes);
|
|
}
|
|
|
|
/**
|
|
* Creates a file upload form input.
|
|
*
|
|
* <code>
|
|
* echo Form::file('image');
|
|
* </code>
|
|
*
|
|
* @param string $name Input name
|
|
* @param array $attributes HTML attributes
|
|
* @uses Form::input
|
|
* @return string
|
|
*/
|
|
public static function file($name, array $attributes = null)
|
|
{
|
|
// Set the input type
|
|
$attributes['type'] = 'file';
|
|
|
|
return Form::input($name, null, $attributes);
|
|
}
|
|
|
|
/**
|
|
* Creates a checkbox form input.
|
|
*
|
|
* <code>
|
|
* echo Form::checkbox('i_am_not_a_robot');
|
|
* </code>
|
|
*
|
|
* @param string $name Input name
|
|
* @param string $input Input value
|
|
* @param boolean $checked Checked status
|
|
* @param array $attributes HTML attributes
|
|
* @uses Form::input
|
|
* @return string
|
|
*/
|
|
public static function checkbox($name, $value = null, $checked = false, array $attributes = null)
|
|
{
|
|
// Set the input type
|
|
$attributes['type'] = 'checkbox';
|
|
|
|
if ($checked === true) {
|
|
// Make the checkbox active
|
|
$attributes['checked'] = 'checked';
|
|
}
|
|
|
|
return Form::input($name, $value, $attributes);
|
|
}
|
|
|
|
/**
|
|
* Creates a radio form input.
|
|
*
|
|
* <code>
|
|
* echo Form::radio('i_am_not_a_robot');
|
|
* </code>
|
|
*
|
|
* @param string $name Input name
|
|
* @param string $value Input value
|
|
* @param boolean $checked Checked status
|
|
* @param array $attributes HTML attributes
|
|
* @uses Form::input
|
|
* @return string
|
|
*/
|
|
public static function radio($name, $value = null, $checked = null, array $attributes = null)
|
|
{
|
|
// Set the input type
|
|
$attributes['type'] = 'radio';
|
|
|
|
if ($checked === true) {
|
|
// Make the radio active
|
|
$attributes['checked'] = 'checked';
|
|
}
|
|
|
|
return Form::input($name, $value, $attributes);
|
|
}
|
|
|
|
/**
|
|
* Creates a textarea form input.
|
|
*
|
|
* <code>
|
|
* echo Form::textarea('text', $text);
|
|
* </code>
|
|
*
|
|
* @param string $name Name
|
|
* @param string $body Body
|
|
* @param array $attributes HTML attributes
|
|
* @uses Html::attributes
|
|
* @return string
|
|
*/
|
|
public static function textarea($name, $body = '', array $attributes = null)
|
|
{
|
|
// Set the input name
|
|
$attributes['name'] = $name;
|
|
|
|
// Set the input id
|
|
$attributes['id'] = (isset($attributes['id']))?$attributes['id']:$name;
|
|
|
|
return '<textarea'.Html::attributes($attributes).'>'.$body.'</textarea>';
|
|
}
|
|
|
|
/**
|
|
* Creates a select form input.
|
|
*
|
|
* <code>
|
|
* echo Form::select('themes', array('default', 'classic', 'modern'));
|
|
* </code>
|
|
*
|
|
* @param string $name Name
|
|
* @param array $options Options array
|
|
* @param string $selected Selected option
|
|
* @param array $attributes HTML attributes
|
|
* @uses Html::attributes
|
|
* @return string
|
|
*/
|
|
public static function select($name, array $options = null, $selected = null, array $attributes = null)
|
|
{
|
|
// Set the input name
|
|
$attributes['name'] = $name;
|
|
|
|
// Set the input id
|
|
$attributes['id'] = (isset($attributes['id']))?$attributes['id']:$name;
|
|
|
|
$options_output = '';
|
|
|
|
foreach ($options as $value => $name) {
|
|
if ($selected == $value) $current = ' selected '; else $current = '';
|
|
$options_output .= '<option value="'.$value.'" '.$current.'>'.$name.'</option>';
|
|
}
|
|
|
|
return '<select'.Html::attributes($attributes).'>'.$options_output.'</select>';
|
|
}
|
|
|
|
/**
|
|
* Creates a submit form input.
|
|
*
|
|
* <code>
|
|
* echo Form::submit('save', 'Save');
|
|
* </code>
|
|
*
|
|
* @param string $name Input name
|
|
* @param string $value Input value
|
|
* @param array $attributes HTML attributes
|
|
* @uses Form::input
|
|
* @return string
|
|
*/
|
|
public static function submit($name, $value, array $attributes = null)
|
|
{
|
|
// Set the input type
|
|
$attributes['type'] = 'submit';
|
|
|
|
return Form::input($name, $value, $attributes);
|
|
}
|
|
|
|
/**
|
|
* Creates a button form input.
|
|
*
|
|
* <code>
|
|
* echo Form::button('save', 'Save Profile', array('type' => 'submit'));
|
|
* </code>
|
|
*
|
|
* @param string $name Input name
|
|
* @param string $value Input value
|
|
* @param array $attributes HTML attributes
|
|
* @uses Html::attributes
|
|
* @return string
|
|
*/
|
|
public static function button($name, $body, array $attributes = null)
|
|
{
|
|
// Set the input name
|
|
$attributes['name'] = $name;
|
|
|
|
return '<button'.Html::attributes($attributes).'>'.$body.'</button>';
|
|
}
|
|
|
|
/**
|
|
* Creates a form label.
|
|
*
|
|
* <code>
|
|
* echo Form::label('username', 'Username');
|
|
* </code>
|
|
*
|
|
* @param string $input Target input
|
|
* @param string $text Label text
|
|
* @param array $attributes HTML attributes
|
|
* @uses Html::attributes
|
|
* @return string
|
|
*/
|
|
public static function label($input, $text, array $attributes = null)
|
|
{
|
|
// Set the label target
|
|
$attributes['for'] = $input;
|
|
|
|
return '<label'.Html::attributes($attributes).'>'.$text.'</label>';
|
|
}
|
|
|
|
/**
|
|
* Create closing form tag.
|
|
*
|
|
* <code>
|
|
* echo Form::close();
|
|
* </code>
|
|
*
|
|
* @return string
|
|
*/
|
|
public static function close()
|
|
{
|
|
return '</form>';
|
|
}
|
|
|
|
/**
|
|
* Dynamically handle calls to custom macros.
|
|
*
|
|
* @param string $method
|
|
* @param array $parameters
|
|
* @return mixed
|
|
*/
|
|
public static function __callStatic($method, $parameters)
|
|
{
|
|
if (isset(Form::$macros[$method])) {
|
|
return call_user_func_array(Form::$macros[$method], $parameters);
|
|
}
|
|
|
|
throw new RuntimeException("Method [$method] does not exist.");
|
|
}
|
|
|
|
}
|