BeaconPHP 帮助文档

BeaconPHP V3.x

Hidden 隐藏域

Hidden 隐藏域支持所有Field 的属性设置，一般情况下我们用于传值，可以对 int,string,bool,float,array 等类型进行注解，如果是array 则以josn格式输出，提交内容也以json格式提交。

一般的如果我们需要将 Hidden 加入到底部隐藏区域即需要Form->fetchHideBox() 来显示的时候我们可以对字段设置 hidden

使用示例如下：

 #[Hidden(
        label: '父类ID1',
        defaultFromParam: 'cateId',
        hidden: true  //设置了hidden 将会加入到Form 表单的 hidden区域，需要用 fetchHideBox() 来显示。
    )]
    public ?int $pid1 = null;

    #[Hidden(
        label: '父类ID2',
        defaultFromParam: 'cateId',
        //没有设置 hidden 所以 会直接在相应的位置上显示
    )]
    public ?int $pid2 = null;

完整的Model

namespace app\home\model;


use beacon\core\Form;
use beacon\widget\Hidden;


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


    #[Hidden(
        label: '父类ID1',
        defaultFromParam: 'cateId',
        hidden: true  //设置了hidden 将会加入到Form 表单的 hidden区域，需要用 fetchHideBox() 来显示。
    )]
    public ?int $pid1 = null;

    #[Hidden(
        label: '父类ID2',
        defaultFromParam: 'cateId',
        //没有设置 hidden 所以 会直接在相应的位置上显示
    )]
    public ?int $pid2 = 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">
        <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');
        $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);
    }
}

打开页面时带上url参数
如：
/user?cateId=33

最终呈现：

查看页面源码：

<form method="post">
        <div class="yee-panel">
            <div class="panel-caption">
                添加用户表单
            </div>
            <div class="panel-content">
                
                    <div class="yee-row" id="row_pid2">
<label class="row-label">父类ID2：</label>
<div class="row-cell">
<input id="pid2" name="pid2" value="33" type="hidden"/>
</div>
</div>
                
            </div>
            <div class="yee-submit">
                <label class="submit-label"></label>
                <div class="submit-cell">
                    
                    <input type="hidden" name="pid1" value="33">
                    <input type="submit" class="form-btn red" value="提交">
                </div>
            </div>
        </div>
    </form>

1 首先它们的默认值都从参数中获取了 cateId 所以值被赋值为 33
2 由于 pid1 设置了 hidden 为 ture 所以被加入到了底部，而 pid2 没有设置保留在原来的位置上，因为 Hidden 输出的控件不可见，所以界面呈现出以上效果。

上一篇：Datetime 时间选择控件

下一篇：Integer 整数插件