philippgrashoff/atkuiautosaveform

本软件包最新版本(5.2.0)没有可用的许可证信息。

Atk4\Ui\Form 的扩展,可自动保存每次更改

5.2.0 2024-08-04 09:54 UTC

This package is auto-updated.

Last update: 2024-09-04 10:11:42 UTC


README

Atk4\Ui\Form 扩展执行两项操作

  1. 如果用户更改控件值,例如选择下拉列表或输入文本,则自动提交。
  2. 如果在表单提交中更新字段值(例如,如果 Model::save() 在保存之前修改字段值),AutoSaveForm 将相应更新匹配的控件。

为了为用户提供良好的用户界面体验,表单的保存按钮指示表单的状态。它有三种状态

  1. 初始:只有彩色轮廓(使用 FUI 的 "basic" 类)。这意味着表单中的值没有更改。
  2. 高亮:彩色背景。表示已检测到值的变化。
  3. 高亮和加载 按钮被着色,并且上面有加载动画。这表示正在发生表单提交。

此视频 中查看 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 兼容,依此类推。