firewire/fieldtype-form-select

一个用于在ProcessWire中创建字段,以便通过FormBuilder选择表单的输入字段/字段类型

v1.0.1 2024-09-17 12:59 UTC

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提交功能。