partial UI 元素渲染一个 partial,path 值可以引用一个 partial 视图文件否则字段名将用作 partial 名称。
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以下变量在局部模板渲染时可用。
$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
路径必须包含 :: 字符以激活视图服务。
:::