当前位置：首页 > news >正文

fritz2实战案例：TodoMVC应用的完整实现

news 2026/7/25 23:12:02

fritz2实战案例：TodoMVC应用的完整实现

【免费下载链接】fritz2Easily build reactive web-apps in Kotlin based on flows and coroutines.项目地址: https://gitcode.com/gh_mirrors/fr/fritz2

fritz2是一个基于Kotlin的响应式Web应用框架，它利用Kotlin的协程和流（flows）特性，让开发者能够轻松构建现代化的Web应用。本文将通过实现经典的TodoMVC应用，展示fritz2在实际项目中的应用。

项目概述

TodoMVC是一个流行的前端框架测试项目，要求实现一个功能完整的待办事项管理应用。fritz2的TodoMVC实现位于examples/todomvc/目录下，包含了模型定义、状态管理和UI渲染等完整功能。

fritz2响应式应用的生命周期展示，体现了数据流动和状态管理的核心思想

数据模型设计

在fritz2中，数据模型是应用的基础。TodoMVC的模型定义在examples/todomvc/src/commonMain/kotlin/dev/fritz2/examples/todomvc/Model.kt文件中：

@Lenses data class ToDo( val id: String = Id.next(), val text: String, val completed: Boolean = false ) { // 序列化和反序列化方法 }

这个模型使用了fritz2的@Lenses注解，自动生成了用于访问和修改属性的透镜（Lenses），这是fritz2响应式状态管理的关键。

状态管理实现

fritz2采用基于Store的状态管理模式。TodoMVC的状态管理逻辑在examples/todomvc/src/jsMain/kotlin/dev/fritz2/examples/todomvc/TodoMvc.kt中实现：

object ToDoListStore : RootStore<List<ToDo>>(emptyList(), id = persistencePrefix, job = Job()) { val save = handle<ToDo> { toDos, new -> /* 保存逻辑 */ } val remove = handle<String> { toDos, id -> /* 删除逻辑 */ } val toggleAll = handle { toDos, toggle: Boolean -> /* 全选/取消全选逻辑 */ } val clearCompleted = handle { toDos -> /* 清除已完成任务逻辑 */ } // 派生状态 val count = data.map { todos -> todos.count { !it.completed } }.distinctUntilChanged() val empty = data.map { it.isEmpty() }.distinctUntilChanged() val allChecked = data.map { todos -> todos.isNotEmpty() && todos.all { it.completed } }.distinctUntilChanged() }

RootStore是应用的单一数据源，通过handle定义修改状态的操作，通过map派生衍生状态，实现了响应式的数据流动。

UI组件构建

fritz2使用类型安全的DSL构建UI。TodoMVC的UI组件分为三个主要部分：

输入头部

fun RenderContext.inputHeader() { header { h1 { +"todos" } input("new-todo") { placeholder("What needs to be done?") autofocus(true) changes.values().map { ToDo(text = it.trim()) } handledBy ToDoListStore.save } } }

主内容区域

主内容区域负责展示待办事项列表，使用renderEach实现列表渲染：

ul("todo-list") { ToDoListStore.data.combine(router.data) { all, route -> filters[route]?.function?.invoke(all) ?: all }.renderEach(ToDo::id) { toDo -> // 每个待办项的渲染逻辑 } }

页脚区域

页脚包含任务计数、过滤选项和清除已完成任务按钮：

fun RenderContext.appFooter() { footer("footer") { span("todo-count") { /* 任务计数 */ } ul("filters") { /* 过滤选项 */ } button("clear-completed") { /* 清除已完成任务 */ } } }

fritz2实现的TodoMVC应用界面，展示了响应式UI和状态管理的实际效果

路由与本地存储

应用还集成了路由功能，使用routerOf实现不同过滤状态的切换：

val router = routerOf("all")

同时利用浏览器的localStorage实现数据持久化，确保刷新页面后数据不丢失：

private val query = handle { buildList { for (index in 0 until localStorage.length) { val key = localStorage.key(index) if (key != null && key.startsWith(persistencePrefix)) { add(ToDo.deserialize(localStorage[key]!!)) } } } }