firewire / fieldtype-form-select
一个用于在ProcessWire中创建字段,以便通过FormBuilder选择表单的输入字段/字段类型
v1.0.1
2024-09-17 12:59 UTC
Requires
- php: >=8.1.0
- wireframe-framework/processwire-composer-installer: ^1.1.1
This package is auto-updated.
Last update: 2024-09-17 13:19:14 UTC
README
ProcessWire的一个字段类型,用于创建可以在选择元素中选择的表单字段,该表单使用FormBuilder构建。
要求
- ProcessWire >= 3.0
- FormBuilder
- PHP >= 8.1
此模块是在FormBuilder 0.5.5和ProcessWire 3.0.235上开发的,但它应该与其它版本兼容。
使用方法
将此模块作为模块从ProcessWire目录安装到ProcessWire中。
或者使用composer安装:composer require firewire/fieldtype-form-select
。
确保已安装FormBuilder,然后安装此模块。创建一些表单。创建一个表单选择字段,然后在“详细信息”标签下指定您希望在该字段中显示的表单。在“选择哪些表单将出现在选择字段中”的选项如下:
- 所有表单(默认)
- 仅包含您选择的表单
- 包含除您选择排除的所有表单
- 包含名称以指定字符串开头的表单
- 包含名称以指定字符串结尾的表单
- 包含包含指定字符串的名称的表单
您可以选择字段在选中或未选中表单时输出值的格式。
可选地,选择表单名称在渲染选择元素时将如何显示。选项包括:
- 默认名称:my-form-name
- 小写并带有空格:my form name
- 大写并带有空格:My Form Name
- 首字母大写并带有空格:My form name
此字段存储已选择的表单的ID,否则为null。
如果删除了表单,则包含对该表单的引用/ID的所有表单选择字段将清空其值并设置为null
。
技巧
表单选择提供另一种渲染表单的方式。要渲染已选择的表单的标记,请调用$page->render('your_form_select_field')
,然后恭喜你-你的表单已经在页面上渲染。
此模块与FormBuilderHtmx兼容,它为使用FormBuilder构建的表单添加了AJAX提交功能。