Kirby 5.0.0-rc.4 版本发布：文件上传优化与文本输入改进

Kirby 是一个灵活的内容管理系统，以其简洁的设计和强大的自定义能力著称。最新发布的 5.0.0-rc.4 版本是 5.0.0 系列的第四个候选版本，主要针对文件上传功能和文本输入处理进行了多项优化和改进。

文件上传功能增强

本次更新对文件上传模块进行了多项改进，提升了上传过程的稳定性和用户体验：

1. 新增异步通知机制：通过 panel.upload.announce() 方法，系统现在能够在文件上传完成后发送成功通知并触发 model.update 事件，确保界面及时更新。

2. 错误处理改进：上传模块现在会为每个未能成功上传的文件发送 file.upload.error 事件，便于开发者进行针对性的错误处理。

3. 事件触发时机优化：file.upload 事件现在会在单个文件上传完成后立即触发，而不是等待所有文件上传完成，这提高了系统的响应速度。

文本输入处理改进

文本输入区域（TextareaInput）的处理逻辑得到了显著增强：

1. 新增异步方法：引入了 TextareaInput.restoreSelection() 异步方法，取代了原有的 restoreSelectionCallback，提供了更稳定的异步控制。

2. 方法异步化：多个关键方法被改造为异步方法，包括 insert、insertFile、insertUpload、prepend、toggle 和 wrap，确保了异步操作的顺序性和可靠性。

3. 上传内容插入优化：TextareaInput.insertUpload() 现在使用 await panel.content.update() 来推送文本值变更，直接与变更 API 交互，确保视图正确刷新。

问题修复

本次更新修复了多个影响用户体验的问题：

1. 内容保存优化：panel.content.save() 现在会调用 panel.content.cancelSaving() 来取消任何旧的保存请求，避免了潜在的竞态条件。

2. 文件字段优化：FilesField 不再在上传后发送不必要的 file.upload 和 model.update 事件，避免了重复的区块重新加载请求。

3. 选择字段显示优化：选择和单选字段预览现在显示选项文本而非值，提高了可读性。

4. 暗色模式适配：调整了文件浏览器中移动返回按钮在暗色模式下的背景颜色，提升了视觉一致性。

技术细节与最佳实践

对于开发者而言，本次更新带来了一些值得注意的技术变化：

1. 方法可见性调整：HasMethods::hasMethod() 方法重新变为公开方法，方便开发者使用。

2. 事件处理优化：上传模块现在会在任何上传完成时正确触发 complete 事件，无论上传是成功还是被取消。

3. 代码重构：将 trait 模板注解移动到类文档中，提高了代码的可读性和维护性。

升级建议

对于正在使用 Kirby 5.0.0 候选版本的用户，建议及时升级到 rc.4 版本以获得更稳定的文件上传体验和更可靠的文本输入处理。特别注意以下变更：

1. 替换所有使用 TextareaInput.restoreSelectionCallback() 的代码为新的 TextareaInput.restoreSelection() 方法。

2. 检查自定义上传处理逻辑，确保能够正确处理新的 file.upload.error 事件。

3. 验证暗色模式下的界面显示效果，特别是文件浏览器中的返回按钮。

Kirby 5.0.0 系列版本正在稳步推进，rc.4 版本的发布标志着系统在稳定性和用户体验方面又向前迈进了一步。开发团队持续关注用户反馈，不断优化系统功能，为即将到来的正式版发布做好准备。