DBO Form Widget

这是一个十分有用的组件，可用于生成一个数据的编辑form，他是MST Library 3.1一个十分重要的组件，可以实现dbo form和dbo form的循环嵌套，而且控制在一个form中，同时支持dbo form中再次嵌套自定义的widget组件。
很多PHP框架，将form的生成写在函数，这是无可厚非的，但是你无法接收在生成一个form的时候，循环调用用户函数所付出的性能成本，这时候，构建一个php和html混编的代码，远比循环执行函数的性能要高。
而且，多数时候，我们知道一个数据对象的结构，也已经定义了数据对象的每个字段的值类型，我们真的没有必要再去手动写什么form，或者还要用代码去判断，这个用select，那个用textarea什么的。

// 要操作的對象的數據
// $target必須為基於MST_DBO的實例
if (!isset($data) || !is_object($data) || !$data instanceof MST_DBO) {
	echo '$data not a MST_DBO instance!';
}
else {
	// 獲取關聯的模塊
	$model = get_class($data);

	// 定義$columns
	// 如果未定義，默認根據MST_DBO的接口來取
	if (!isset($columns))
		$columns = $data->getFormColumns($data);
	if (empty($columns) || !is_array($columns)) {
		echo 'undefine form columns!';
	}
	else {

		// 生成該模塊的前綴
		if (!isset($prefix))
			$prefix = strtolower($model);
		else
			$prefix = MST_String::tableize($prefix);

		if (!isset($id))
			$id = $prefix . '_form';

		if (!isset($class))
			$class = $prefix . '-form';

		$errors = $data->getErrors();

		// 初始化Form配置
		// 定制提交的action
		if (!isset($action))
			$action = $this->params->uri;

		// method
		if (!isset($method))
			$method = 'post';
		else {
			$method = strtolower((string)$method);
			if ($method != 'get' && $method != 'post')
				$method = 'post';
		}

		// 是否需要上傳
		if (!isset($isUpload)) $isUpload = true;

		// 定制提交按鈕的文字
		if (!isset($submitText)) $submitText = 'Submit';

		// 定制label部分的寬度
		if (!isset($headWidth)) $headWidth = 130;
		$headWidth = is_numeric($headWidth) && $headWidth > 0 ? $headWidth : 120;

		if (!isset($continueForm)) $continueForm = false;


		// 重載
		if (!isset($lineStart)) $lineStart = 1;
?>

>	
$lineNum = $lineStart;$tinymceTimes = 0;foreach ($columns as $key => $column) {	// 跳過$column[0]為空的部分	if (!isset($column[0])) continue;
	// 定制一行的$column常用變量	$key = strtolower(trim($key));	$columnId = $prefix . '_' . $key;	$columnName = $prefix . '[' . $key . ']';	$columnClass = $prefix . '-' . $key;	$columnText  = empty($column['title']) ? ucfirst($key) : $column['title'];	$columnValue = isset($data[$key]) ? (string)$data[$key] : (isset($column['default']) ? $column['default'] : null);	if (isset($column['forceValue'])) $columnValue = (string)$column['forceValue'];	$isDisabled = isset($column['disabled']) ? $column['disabled'] : false;	$isReadonly = isset($column['readonly']) ? $column['readonly'] : false;
	if (is_object($column[0]) && $column[0] instanceof Closure) {		$editType = 'closure';	}	else {		$editType = strtolower($column[0]);	}?>
if ($editType == 'dbo_form') {	if (empty($column[1])) {		// 缺少dbo_form重用說明?>							
	} else {		$column[1]['continueForm'] = true;		$this->widget('base/dbo_form', $column[1]);	}?>																

$lineClass = $lineNum % 2 == 0 ? 'f-line f-line-odd' : 'f-line f-line-even';?>										
}?>											




























Can't reuse dbo_form, please set the dbo_form options in $column[1].












				

			








				widget($column[1], $column[2]); ?>
			















// 開始生成form行
switch ($editType) {
	case 'text' :
?>
									if (isset($column['max']))
						echo ' maxlength="',$column['max'],'"';
					if ($isDisabled)
						echo ' disabled="disabled"';
					if ($isReadonly)
						echo ' readonly="readonly"';
				?>/>

		break;
	case 'smalltextarea' :
?>
									if (isset($column['max']))<li>						echo ' maxlength="'.$column['max'].'"';</li>
<li>					if ($isDisabled)</li>
<li>						echo ' disabled="disabled"';</li>
<li>					if ($isReadonly)</li>
<li>						echo ' readonly="readonly"';</li>
<li>				?>><?php echo $columnValue; ?>
</li>


		break;
	case 'longtext' :
?>
									if (isset($column['max']))
						echo ' maxlength="',$column['max'],'"';
					if ($isDisabled)
						echo ' disabled="disabled"';
					if ($isReadonly)
						echo ' readonly="readonly"';
				?>/>

		break;
	case 'upload' :
?>
				


		break;
	case 'password' :
?>
									if (isset($column['max']))
						echo ' maxlength="'.$column['max'].'"';
					if ($isDisabled)
						echo ' disabled="disabled"';
					if ($isReadonly)
						echo ' readonly="readonly"';
				?>/>

		break;
	case 'textarea' :
?>
									if ($isDisabled)<li>						echo ' disabled="disabled"';</li>
<li>					if ($isReadonly)</li>
<li>						echo ' readonly="readonly"';</li>
<li>				?>><?php echo $columnValue; ?>
</li>


		break;
	case 'select' :
		$options = isset($column['options']) ? $column['options'] : array();
		$optionsType = isset($column['optionsType']) ? $column['optionsType'] : 'map';
		// 向前兼容：0 -> map, 1 -> list
		if (is_numeric($optionsType)) $optionsType = $optionsType > 0 ? 'list' : 'map';
?>
									if ($isDisabled)						echo ' disabled="disabled"';
				?>>

					 value="">




 $option) { ?>

					 value="">




$option = array_values((array)$option);
if (isset($option[0])) {
?>
					 value="">



}
?>


				


		break;
	case 'radiogroup' :
		$maps = isset($column['maps']) ? $column['maps'] : array();
		$mapsType = isset($column['mapsType']) ? $column['mapsType'] : 'map';
		// 向前兼容：0 -> map, 1 -> list
		if (is_numeric($mapsType)) $mapsType = $mapsType > 0 ? 'list' : 'map';
?>
				
					


$index = 0;
foreach ($maps as $key => $map) {
	$index++;
?>

					" class="f-radio" value="" />
					" class="f-label">


					" class="f-radio" value="" />
					" class="f-label">



}
?>
				



		break;
	case 'datetime':
		$format = empty($column['dateFormat']) ? 'Y-m-d H:i:s' : $column['dateFormat'];
		$jsFormat = empty($column['jsFormat']) ? '%Y-%m-%d %H:00' : $column['jsFormat'];
		$pickSize = isset($column['pickSize']) ? intval($column['pickSize']) : 2;
		if ($columnValue > 0) {
			if (is_numeric($columnValue)) {
				$dtStr = date($format, $columnValue);
				$dtVal = $columnValue;
			}
			else {
				$dtStr = $columnValue;
				$dtVal = MST_String::date2num($columnValue);
			}
		}
		else {
			$dtStr = 0;
			$dtVal = 0;
		}

		if (is_numeric($dtVal) && $dtVal > 0)
			$dtStr = date($format, $dtVal);
?>
									type="text"
					id="_str"
					class="f-text f-dt "
					value="" 

				/>
									type="hidden"
					name=""
					id=""
					value="" 

				/>
				


		break;
	case 'tinymce' :
		$tinymceTimes++;
?>


script('tiny_mce/tiny_mce.js'); ?>

				

				<?php echo $columnValue; ?>


		break;
	case 'widget' :
		$this->widget($column[1], $column[2]);
		break;
}
$lineNum++;
?>

				



				


				


			















$index = 0;
foreach ($submitText as $btnId => $btnText) {
	$index++;
?>
				



				


				validCode($prefix, 'input'); ?>


	}
}
?>

$this->widget('base/dbo_form', array(
	'data' => $this->list,
));

class Testimonial extends MST_DBO {

	protected static
		$columns = array(
			'firstname' => array('text','title' => 'First Name', 'require' => 1, 'min' => 1, 'max' => 32),
			'lastname' => array('text','title' => 'Last Name', 'require' => 1, 'min' => 1, 'max' => 32),
			'avator' => array('title' => 'Avator', 'max' => 256),
			'age_group' => array('title' => 'Age Group', 'require' => 1),
			'secret' => array('textarea','title' => 'Secret', 'require' => 1, 'min' => 10, 'max' => 600),
		);

	public function  getFormColumns() {
		if (GB_PERSSIONS == Region::ROOT) {
			$columns['region_id'] = array(
				'select',
				'title' => ' region ',
				'optionsType' => 'list',
				'options' =>  Region::find('all', array('select' => 'id, name')),
			);
		}
		else {
			$columns['region_id'] = array(
				'hidden',
				'default' => GB_PERSSIONS,
			);
		}
		$columns = array_merge($columns,self::$columns);
		$columns['age_group'] = array('widget', 'base/age_group', array(
			'prefix' => 'testimonial',
		), 'title' => 'Age Group');
		$columns['avator'] = array('widget', 'base/testmonial_upload', array(
			'prefix' => 'testimonial',
		), 'title' => 'Avator');

		return $columns;
	}

	public function beforeCreate(& $data) {
		$data['created_at'] = time();
	}

	public function getAge() {
		$ageGroup = array(
                         0 => '--',
			 1 => 'Under 18',
			 2 => '19 ? 25',
			 3 => '26 ? 35',
			 4 => '36 ? 45',
			 5 => '46 ? 55',
			 6 => '56 or above',
		);
		return isset($ageGroup[$this['age_group']]) ? $ageGroup[$this['age_group']] : $ageGroup[0];
	}

	public function getAvator() {
		return empty($this['avator']) ? httpUri('images/avator.png') : httpUri($this['avator']);
	}

	// 这是对MST_DBO的find的方法的重载
	static public function find($args = array(), $params = null, $isArray = false) {
		if (defined('GB_PERSSIONS') && GB_PERSSIONS == Region::ROOT) {
			self::initFind($args, $params, $isArray);
			return parent::find($args, $params, $isArray);
		}
		else {
			self::initFind($args, $params, $isArray);
			if (isset($args['where'])) {
				$args['where'][0] .= ' AND region_id = ?';
				$args['where'][] = GB_PERSSIONS;
			}
			else {
				$args['where'] = array('region_id = ?', GB_PERSSIONS);
			}
			return parent::find($args, $params, $isArray);
		}
	}
}