DBO Form Widget

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

1. // 要操作的對象的數據
2. // $target必須為基於MST_DBO的實例
3. if (!isset($data) || !is_object($data) || !$data instanceof MST_DBO) {
4. echo '$data not a MST_DBO instance!';
5. }
6. else {
7. // 獲取關聯的模塊
8. $model = get_class($data);
10. // 定義$columns
11. // 如果未定義，默認根據MST_DBO的接口來取
12. if (!isset($columns))
13. $columns = $data->getFormColumns($data);
14. if (empty($columns) || !is_array($columns)) {
15. echo 'undefine form columns!';
16. }
17. else {
19. // 生成該模塊的前綴
20. if (!isset($prefix))
21. $prefix = strtolower($model);
22. else
23. $prefix = MST_String::tableize($prefix);
25. if (!isset($id))
26. $id = $prefix . '_form';
28. if (!isset($class))
29. $class = $prefix . '-form';
31. $errors = $data->getErrors();
33. // 初始化Form配置
34. // 定制提交的action
35. if (!isset($action))
36. $action = $this->params->uri;
38. // method
39. if (!isset($method))
40. $method = 'post';
41. else {
42. $method = strtolower((string)$method);
43. if ($method != 'get' && $method != 'post')
44. $method = 'post';
45. }
47. // 是否需要上傳
48. if (!isset($isUpload)) $isUpload = true;
50. // 定制提交按鈕的文字
51. if (!isset($submitText)) $submitText = 'Submit';
53. // 定制label部分的寬度
54. if (!isset($headWidth)) $headWidth = 130;
55. $headWidth = is_numeric($headWidth) && $headWidth > 0 ? $headWidth : 120;
57. if (!isset($continueForm)) $continueForm = false;
60. // 重載
61. if (!isset($lineStart)) $lineStart = 1;
62. ?>
64. >

    $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'); ?>

67. }
68. }
69. ?>

复制代码

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

复制代码

2. class Testimonial extends MST_DBO {
4. protected static
5. $columns = array(
6. 'firstname' => array('text','title' => 'First Name', 'require' => 1, 'min' => 1, 'max' => 32),
7. 'lastname' => array('text','title' => 'Last Name', 'require' => 1, 'min' => 1, 'max' => 32),
8. 'avator' => array('title' => 'Avator', 'max' => 256),
9. 'age_group' => array('title' => 'Age Group', 'require' => 1),
10. 'secret' => array('textarea','title' => 'Secret', 'require' => 1, 'min' => 10, 'max' => 600),
11. );
13. public function getFormColumns() {
14. if (GB_PERSSIONS == Region::ROOT) {
15. $columns['region_id'] = array(
16. 'select',
17. 'title' => ' region ',
18. 'optionsType' => 'list',
19. 'options' => Region::find('all', array('select' => 'id, name')),
20. );
21. }
22. else {
23. $columns['region_id'] = array(
24. 'hidden',
25. 'default' => GB_PERSSIONS,
26. );
27. }
28. $columns = array_merge($columns,self::$columns);
29. $columns['age_group'] = array('widget', 'base/age_group', array(
30. 'prefix' => 'testimonial',
31. ), 'title' => 'Age Group');
32. $columns['avator'] = array('widget', 'base/testmonial_upload', array(
33. 'prefix' => 'testimonial',
34. ), 'title' => 'Avator');
36. return $columns;
37. }
39. public function beforeCreate(& $data) {
40. $data['created_at'] = time();
41. }
43. public function getAge() {
44. $ageGroup = array(
45. 0 => '--',
46. 1 => 'Under 18',
47. 2 => '19 ? 25',
48. 3 => '26 ? 35',
49. 4 => '36 ? 45',
50. 5 => '46 ? 55',
51. 6 => '56 or above',
52. );
53. return isset($ageGroup[$this['age_group']]) ? $ageGroup[$this['age_group']] : $ageGroup[0];
54. }
56. public function getAvator() {
57. return empty($this['avator']) ? httpUri('images/avator.png') : httpUri($this['avator']);
58. }
60. // 这是对MST_DBO的find的方法的重载
61. static public function find($args = array(), $params = null, $isArray = false) {
62. if (defined('GB_PERSSIONS') && GB_PERSSIONS == Region::ROOT) {
63. self::initFind($args, $params, $isArray);
64. return parent::find($args, $params, $isArray);
65. }
66. else {
67. self::initFind($args, $params, $isArray);
68. if (isset($args['where'])) {
69. $args['where'][0] .= ' AND region_id = ?';
70. $args['where'][] = GB_PERSSIONS;
71. }
72. else {
73. $args['where'] = array('region_id = ?', GB_PERSSIONS);
74. }
75. return parent::find($args, $params, $isArray);
76. }
77. }
78. }

复制代码