Concrete5-8.0+中如何使用选择与颜色表单小部件？

我来帮你捋清楚Concrete5 8.0+里这两个表单小部件的正确用法，结合你给出的代码片段，咱们一步步修正和完善：

一、颜色选择器的正确调用（form.php） #

你当前的$color->output()写法其实可行，但更简便且符合官方推荐的是直接使用表单助手的color()方法，同时要注意参数格式：

<?php
// form.php 中的颜色选择器代码
echo $form->color('color', $selectedColor, [
    'showAlpha' => false, // 这里必须传布尔值，不是字符串'false'，否则透明度开关会失效
    'placeholder' => '点击选择颜色'
]);
?>

如果坚持用实例化ColorPicker对象的方式，也要确保参数正确：

<?php
$colorPicker = new \Concrete\Core\Form\Widget\ColorPicker();
$colorPicker->output('color', $selectedColor, ['showAlpha' => false]);
?>

二、下拉选择框的用法（你的代码基本正确，补充细节） #

你当前的下拉选择框代码没问题，但要保证$fonts是键值对格式的数组，比如：

<?php
// form.php 中的下拉选择框代码
echo $form->select('font', $fonts, $font_selected);
?>

这里$fonts应该类似：

$fonts = [
    'arial' => 'Arial',
    'times' => 'Times New Roman',
    'verdana' => 'Verdana'
];

键是提交到后台的实际值，值是前台显示的文本。

三、控制器（controller.php）的完整实现 #

1. edit() 方法（传递数据到视图） #

你的现有代码存在变量名不匹配的问题（控制器传的$font，视图用的$font_selected），修正后完整代码：

public function edit()
{
    // 1. 获取已保存的字体值，无值则设默认值
    $fontSelected = $this->get('font') ?: 'arial';
    $this->set('font_selected', $fontSelected);

    // 2. 定义可用字体数组
    $fonts = [
        'arial' => 'Arial',
        'times' => 'Times New Roman',
        'verdana' => 'Verdana'
    ];
    $this->set('fonts', $fonts);

    // 3. 获取已保存的颜色值，无值则设默认黑色
    $selectedColor = $this->get('color') ?: 'rgb(0, 0, 0)';
    $this->set('selectedColor', $selectedColor);
}

2. save() 方法（处理提交数据） #

你原来的代码被截断了，这里给出完整的安全处理版本：

public function save($args)
{
    // 处理颜色参数：去除空格，无值则设默认黑色
    $args['color'] = isset($args['color']) ? trim($args['color']) : 'rgb(0, 0, 0)';

    // 处理字体参数：校验是否在允许的选项内，防止非法提交
    $allowedFonts = ['arial', 'times', 'verdana'];
    $args['font'] = isset($args['font']) && in_array($args['font'], $allowedFonts) 
        ? trim($args['font']) 
        : 'arial';

    // 调用父类方法保存参数（如果是自定义块/页面类型控制器，必须加这行）
    parent::save($args);
}

四、关键注意事项 #

• 变量名一定要一致：控制器set的变量名，要和视图里使用的变量名完全匹配，否则会出现无数据的情况
• 颜色选择器的showAlpha参数必须传布尔值（true/false），不能传字符串
• 下拉选择框建议在后台做白名单验证，避免用户提交非法值
• 颜色值支持RGB、HEX等格式，Concrete5的颜色选择器会自动识别并适配

内容的提问来源于stack exchange，提问作者linuxoid