BeaconPHP 帮助文档

BeaconPHP V3.x

Label 标签控件

Label 标签控件支持Field 的属性设置，Label 标签控件仅仅用于显示内容，提交数据不会加入到 Form->getData() 获取的数组中。

使用示例：

    #[Label(
        label: '用户名',
    )]
    public string $username = '需要显示的内容';

我们可以在控制器中设置相应要显示的内容，或者编辑的时候使用 Form->setData() 来设置相应的内容。

完整Model 演示代码：

namespace app\home\model;


use beacon\core\Form;
use beacon\widget\Label;
use beacon\widget\Number;


#注意 这里需要使用表单注解
#[Form(title: '用户表单', table: '@pf_user', template: 'user.form.tpl')]
class UserModel
{

    #[Label(
        label: '用户名',
        attrs:[
            'class'=>'label',
            'style'=>'font-size:18px;color:red;'
        ]
    )]
    public string $username = '需要显示的内容';

    #[Number(
        label: '金额',
        validRule: ['r' => '请填写数值', 'money' => '只能是最多两位小数的数值'],
    )]
    public ?float $money = null;

}

模板代码：

<!doctype html>
<html lang="zh-cn">
<head>
    <meta charset="utf-8">
    <title>{$form->title}</title>
    <link type="text/css" rel="stylesheet" href="/yeeui/css/yeeui.css"/>
    <link type="text/css" rel="stylesheet" href="/icofont/icofont.css"/>
    <script src="/yeeui/third/jquery-3.3.1.min.js"></script>
    <script src="/yeeui/yee.js"></script>
</head>
<body>
<div style="margin: 20px">
    <form method="post" yee-module="ajax validate">
        <div class="yee-panel">
            <div class="panel-caption">
                {if $form->getType()=='add'}添加{elseif $form->getType()=='edit'}编辑{/if}{$form->title}
            </div>
            <div class="panel-content">
                {foreach from=$form->getViewFields() item=field}
                    {field_row field=$field}
                {/foreach}
            </div>
            <div class="yee-submit">
                <label class="submit-label"></label>
                <div class="submit-cell">
                    {*输出隐藏域*}
                    {$form->fetchHideBox()|raw}
                    <input type="submit" class="form-btn red" value="提交">
                </div>
            </div>
        </div>
    </form>
</div>
</html>

控制器代码：
我们需要设置相应的数据如：

namespace app\home\controller;


use app\home\model\UserModel;
use beacon\core\Controller;
use beacon\core\Form;
use beacon\core\Logger;
use beacon\core\Method;

class User extends Controller
{
    #[Method(act: 'index', method: Method::GET)]
    public function index()
    {
        $form = Form::create(UserModel::class, 'add');
        $form->setData(['username'=>'wj008']); //设置Label 的值，用于显示
        $this->displayForm($form);
    }

    #[Method(act: 'index', method: Method::POST)]
    public function add()
    {
        $user = new UserModel();
        $form = Form::create($user, 'add');
        $input = $this->completeForm($form);
        Logger::log($input); #input 可以用用于插入或者更新数据库。
        Logger::log($user);
        //这里需要有返回值 否则 ajax 提交会没有任何内容返回
        $this->success('ok');
    }
}

呈现效果：

上一篇：Number 数值插件

下一篇：Text 文本输入框