partial UI 元素渲染一个局部视图,path 值可以引用一个局部视图文件,否则字段名被用作局部视图名称。
content:
label: Content
type: partial
path: field_content以下 字段属性 受支持。
| Property | Description |
|---|---|
| path | path to a partial view file or view template code, defaults to the field name with field_ as a prefix. |
当 path 设置为非限定文件名(不包含目录路径和扩展名的文件名)时,源路径被确定在模型或控制器目录中。以下示例将检查位于 ../models/mymodel/_field_for_content.php 或 ../controllers/mycontroller/_field_for_content.php 的部分文件。
content:
type: partial
path: field_for_content您可以指定一个完全限定的路径来访问模型或控制器目录之外的局部视图。这对于在定义之间共享局部视图很有用。
content:
type: partial
path: $/acme/blog/partials/_field_content.php以下变量在 partial 渲染时可用。
$value 是当前字段值,如果已找到。$model 是 使用的模型 用于该字段$field 是配置的类对象 Backend\Classes\FormField以下是 _field_content.php 文件的一些示例内容。
<?php if ($model->is_active): ?>
<p><?= $field->label ?> is active</p>
<?php endif ?>您可以将视图模板代码作为 path 传递,以访问插件内部的视图服务模板。以下代码位于路径 plugins/acme/blog/views/formfields/content.php。
content:
type: partial
path: acme.blog::formfields.content您也可以在 app 目录中放置一个局部视图,例如,app/views/formfields/content.php。
content:
type: partial
path: app::formfields.content:::tip
路径必须包含 :: 字符以激活视图服务。
:::