philippgrashoff / atkuiautosaveform
本软件包最新版本(5.2.0)没有可用的许可证信息。
Atk4\Ui\Form 的扩展,可自动保存每次更改
5.2.0
2024-08-04 09:54 UTC
Requires
- php: 8.*
- atk4/ui: 5.*
Requires (Dev)
- phpstan/phpstan: 1.*
- phpunit/phpunit: 10.*
README
此 Atk4\Ui\Form 扩展执行两项操作
- 如果用户更改控件值,例如选择下拉列表或输入文本,则自动提交。
- 如果在表单提交中更新字段值(例如,如果 Model::save() 在保存之前修改字段值),AutoSaveForm 将相应更新匹配的控件。
为了为用户提供良好的用户界面体验,表单的保存按钮指示表单的状态。它有三种状态
- 初始:只有彩色轮廓(使用 FUI 的 "basic" 类)。这意味着表单中的值没有更改。
- 高亮:彩色背景。表示已检测到值的变化。
- 高亮和加载 按钮被着色,并且上面有加载动画。这表示正在发生表单提交。
在 此视频 中查看 AutoSaveForm 的实际效果。
在您的浏览器中打开 tests/autosaveformdemo.php
以查看演示。
当前状态
测试了这些控件
- 行
- 文本区域
- 复选框
- 单选按钮
- 日历
- 下拉列表
- 查找(此处有问题,请见下文)
未测试
- 多行
已知问题
- 查找和调整控件值(如果在表单提交期间更改)目前不起作用。对于下拉列表,此问题不存在。如果您的应用程序不更改相应字段的值,则此问题不会引起问题。自动保存 Lookup 值功能正常。
用法
只需在您的代码中使用 AutoSaveForm
而不是 \Atk4\Ui\Form
。有关示例,请参阅 tests/autosaveformdemo.php
。
安装
使用此存储库的最简单方法是将其添加到 composer.json 的 require 部分
{ "require": { "philippgrashoff/atkuiautosaveform": "5.*" } }
版本控制
此存储库的版本号与 atk4\data 版本相对应。因此,5.2.x 与 atk4\data 5.2.x 兼容,依此类推。