TinyDB 存了数据,界面标签不更新?用「保存后主动刷新」模式做仪表盘

« 返回首页

一句话结论:微数据库(TinyDB)只是安静的存储仓库,写入数据不会触发任何事件;标签也只在你对它赋值的那一刻才会变。所以「存进 TinyDB」和「界面显示」之间必须由你自己搭一座桥——保存成功后主动重新读数据、重新计算、重新给标签赋值。这就是本文要讲的「写入 → 重读 → 刷新」模式。

一、为什么标签不会自动更新

先说清楚原理,你就知道该怎么改了。

App Inventor 里的事件(when … 代码块)只在这些情况下触发:

  • 用户操作组件(点按钮、选列表项、输入文字);
  • 系统回调(Web 请求返回、传感器数值变化、计时器到点);
  • 屏幕初始化。

注意:TinyDB 的保存值不在任何名单里。你往里存数据,它不会发通知、不会触发事件,任何标签都不会因此重绘。这和数据库领域的「响应式更新」不是一回事——TinyDB 就是一个按 key 存取的字典,仅此而已。

所以很多同学做记账、会员管理 App 时会遇到这样的现象:

  • 新增一条收入记录,保存成功,TinyDB 里确实有数据了(用伴侣 App 查得到);
  • 但仪表盘上的「总余额」「银行余额」「现金余额」还是老数字,甚至一直是 0;
  • 只有退出 App 重新打开(触发了屏幕初始化)才会更新。

第三条恰恰暴露了问题所在:你的初始化逻辑是对的,只是保存之后没有再执行一遍。

二、标准模式:写入 → 重读 → 刷新

正确的做法是把「刷新仪表盘」独立成一个过程(procedure),谁改了数据谁调用它:

┌─────────────┐     ┌─────────────┐     ┌─────────────┐
│  保存数据    │ ──→ │  重读+重算   │ ──→ │  更新标签    │
│  保存值      │     │  (过程本体)  │     │  标签.Text   │
└─────────────┘     └─────────────┘     └─────────────┘
                          ↑
        屏幕初始化和「删除记录」也要调用它

三个要点:

  1. 刷新逻辑只写一份,做成 procedure,别在按钮 Click 里、初始化里各抄一遍——抄两遍迟早改漏一处。
  2. 保存成功后再调用刷新,而不是「先刷新再保存」。
  3. 删除、修改记录后同样要调用刷新,不只是新增。

三、完整案例:会员记账仪表盘

以「会员管理 + 个人记账」为例,完整走一遍。

组件清单

组件 改名 用途
微数据库(TinyDB) 微数据库1 存所有记录
文本输入框 文本输入框_金额 输入金额
下拉框(Spinner) 下拉框_账户 选「银行」或「现金」
文本输入框 文本输入框_备注 备注
按钮 按钮_保存 保存并刷新
对话框(Notifier) 对话框1 输入校验提示
标签 × 4 标签_总余额 / 标签_银行余额 / 标签_现金余额 / 标签_记录数 仪表盘

数据设计:每条记录存成一个列表,key 用 Rec_编号 的形式;另用一个 key nextId 记录下一条的编号,保证 key 不重复。

积木逻辑(可直接照做)

global 总余额 = 0
global 银行余额 = 0
global 现金余额 = 0

when Screen1.Initialize() {
  刷新仪表盘()
}

when 按钮_保存.Click() {
  if isEmpty(文本输入框_金额.Text) {
    对话框1.ShowAlert("请先填写金额")
  } else if not (isNumber(文本输入框_金额.Text)) {
    对话框1.ShowAlert("金额必须是数字")
  } else {
    var 编号 = 微数据库1.GetValue("nextId", 1)
    微数据库1.StoreValue(join("Rec_", 编号), [文本输入框_金额.Text, 下拉框_账户.Selection])
    微数据库1.StoreValue("nextId", 编号 + 1)
    文本输入框_金额.Text = ""
    文本输入框_备注.Text = ""
    刷新仪表盘()
  }
}

刷新过程里有一个容易踩的细节:获取标签列表(GetTags)不带参数,返回库里全部 key,所以要自己用前缀过滤出本模块的记录——判断「键的前 4 个字符是不是 Rec_」:

procedure 刷新仪表盘() {
  总余额 = 0
  银行余额 = 0
  现金余额 = 0
  var 记录数 = 0
  foreach 键 in 微数据库1.GetTags() {
    if substring(键, 1, length("Rec_")) = "Rec_" {
      var 记录 = 微数据库1.GetValue(键, [])
      if length(记录) >= 2 {
        var 金额 = 记录[1]
        var 账户 = 记录[2]
        if 账户 = "银行" {
          银行余额 = 银行余额 + 金额
        } else if 账户 = "现金" {
          现金余额 = 现金余额 + 金额
        }
        总余额 = 总余额 + 金额
      }
      记录数 = 记录数 + 1
    }
  }
  标签_总余额.Text = join("总余额:", 总余额, " 元")
  标签_银行余额.Text = join("银行余额:", 银行余额, " 元")
  标签_现金余额.Text = join("现金余额:", 现金余额, " 元")
  标签_记录数.Text = join("共 ", 记录数, " 条记录")
}

逻辑拆开看:

  1. 保存按钮:先校验(金额非空、是数字——判断数字的内建叫 isNumber),再生成编号、把 [金额, 账户] 列表存进 Rec_编号,最后调用 刷新仪表盘()——这一步就是很多项目缺的那块积木。
  2. 刷新仪表盘:先用获取标签列表拿到所有 key,用 substring(键, 1, length("Rec_")) = "Rec_" 过滤出本模块的记录,逐条读出、按账户累加;算完以后给标签赋值。存完再读、读完才算、算完才显示,顺序不能乱。
  3. 屏幕初始化:也调用同一个过程,App 一打开仪表盘就是最新数据。

如果你还有会员列表(key 前缀是 Mem_),会员总数就是同一个循环里再加一个前缀判断的事,放进同一个刷新过程里一起更新即可。

删除记录后也要刷新

when 列表选择器1.AfterPicking() {
  微数据库1.ClearTag(列表选择器1.Selection)
  刷新仪表盘()
}

任何「动了数据」的操作(新增、删除、修改),结尾都跟上 刷新仪表盘(),这个习惯能让你的仪表盘永远和数据库一致。

四、常见问题

Q:我把标签更新写在屏幕初始化里了,为什么保存后不更新? 初始化代码整个 App 生命周期里只跑一次。要么把刷新逻辑抽成过程在保存后手动调用,要么不抽过程、直接把那串「重算 + 赋值」积木复制到保存按钮的 Click 末尾——但强烈建议抽过程。

Q:数据多了以后每次全量遍历会不会卡? TinyDB 存在手机本地,几十、几百条记录的遍历是瞬间完成的,毕设课设规模完全不用担心。如果记录上千条,可以在每次保存时把汇总值单独存一份 key,读的时候直接取,只在必要时才全量重算。

Q:要不要用 云数据库 / SQLite 替代 TinyDB? 看需求。单机记账用 TinyDB 就够了;要多人共享数据(比如管理员端和会员端同步)用云数据库;要按条件查询大量结构化数据,用 SQLite 更合适。但无论哪种,「写入后主动刷新界面」这个模式都一样——存储组件都不会主动帮你更新标签。

Q:编辑器里手拼这些积木太慢了怎么办? 在中文版编辑器里可以直接用 AI 助手,用聊天描述「保存记录后重新计算三类余额并更新标签」这类需求让它生成积木;拼完的积木也能实时预览成 Python/JavaScript 代码帮你检查逻辑。

五、小结

记住三句话:

  1. TinyDB 写入不触发任何事件,标签不更新是正常的,不是 bug;
  2. 把「重读数据 → 重算 → 给标签赋值」抽成一个刷新过程,获取标签列表无参返回全部 key,记得按前缀过滤;
  3. 所有改数据的操作(保存、删除、修改)末尾都调用它,屏幕初始化也调用它。

按这个模式改造,你的仪表盘就能做到「存完立刻变」,答辩演示时也不会出现数字对不上的尴尬。

文档反馈