【山竹记账前端-react】23.封装表单组件(下)
大纲链接 §
[toc]
1. 新页面:编辑标签 ⇧
搭建基本文件框架 ⇧
路由
@/route/routes.tsx
|
|
@/pages/TagEditPage.tsx
|
|
创建通用表单状态 createFormStore ⇧
目前标签表单-创建/编辑的公共逻辑
- 入参数据:
lastData、lastError - 表单操作:更新数据、清除错误提示、验证数据、提交数据
对比现有的表单状态文件
useTagCreateStore.ts和useSignInStore.ts,有公共逻辑可以提取为工厂函数,创建独立的表单验证相关的状态文件
- 数据:
data、error、 - 操作:
setData、setError、clearError、revalidateFormItems
封装通用表单状态
@/stores/createFormStore.ts
|
|
改造
@/stores/useSignInStore.ts
|
|
改造
@/stores/useTagCreateStore.ts
|
|
新建
@/stores/useTagEditStore.ts
|
|
封装标签页通用表单组件 TagForm.tsx 自定义状态钩子要点 ⇧
@/modules/tags/TagForm.tsx
|
|
useTagCreateStore、useTagEditStore必须以静态形式提前声明,不可放到条件判断中- ❌
const store = mode === 'edit' ? useTagEditStore() : useTagCreateStore()会报钩子使用错误 - ✅
const create = useTagCreateStore(); const edit = useTagEditStore(); cosnt store = mode === 'edit' ? edit : create;
- ❌
改造
@/pages/TagCreatePage.tsx
|
|
改造
@/pages/TagEditPage.tsx
|
|
2.使用 useEmojiStore 状态重构 emoji 相关组件状态管理(上) ⇧
通过 getEmojiById 根据 emojiId 重新设置 emoji 状态 ⇧
@/lib/helpers/getEmojiById.ts
|
|
- 根据
safeEmojiList中各个emoji的index属性返回选中的emojiItem信息 - 可以直接将这个数据属性渲染到页面上,避免各层次的组件传参
创建 useEmojiStore 状态 ⇧
@/stores/useEmojiStore.ts
|
|
- 使用
zustand-devtools-bridge浏览器插件配合插件库方便在控制台调试,实时查看状态数据 - 主要需要的数据
id: emoji_id、emoji、hint、topic、mainTopic - 模拟从请开启中获取到
sign_id后,就可以通过getEmojiById获取emojiItem数据 - 再更新到此状态中,以供
emoji各个相关组件使用
emoji 相关组件数据流转链条 ⇧
TagEditPage- TODO: 根据路由路径参数id 请求接口获取标签详情数据;
- 将模拟数据更新到
useTagEditStore和useEmojiStore状态 - 渲染
TagForm mode="edit" - 根据
mode使用useTagEditStore状态设置初始值 - 绑定输入输出数据,同步操作更新状态
useTagEditStore - 验证表单数据
- TODO: 提交逻辑
- 渲染
FormItem formItemType="emoji"- 根据
formItemType判断渲染InputEmoji组件并透传参数 - 收窄约束参数类型
{...(formItemTypeProps as FormItemTypeProps<'emoji'>)} - 渲染
InputEmoji - 通过
useEmojiStore获取数据渲染到组件部分结构中 - 监听状态中
emojiId、emoji、mainTopic和 外部参数value更新emojiItem状态 - 调用传参
onChange更新父组件参数 - 透传参数
onBlur、onFocus - 渲染
EmojiSelector- 透传参数
onBlur、onFocus - 渲染
EmojiMainTopicNav - 遍历渲染主题列表
- 负责切换表情主题逻辑,重置并更新主题状态
- 监听主题数据,切换时重置并更新主题状态
- 绑定事件
onBlur、onFocus传参 - 渲染
EmojiUnicodeList - 遍历渲染主题相关表情列表
- 负责切换表情逻辑,更新表情相关状态
- 监听表情
emoji、emojiHint数据,更新表情相关状态 - 绑定事件
onBlur、onFocus传参
- 透传参数
- 根据
TagCreatePage与编辑组件相似,只是初始数据来源不同,模式、类型、状态判断不同TagForm mode="create"FormItem formItemType="emoji"InputEmojiEmojiSelectorEmojiMainTopicNavEmojiUnicodeList
使用 useEmojiStore 状态重构 emoji 相关组件状态管理(下) ⇧
- 移除组件内原来
props传参数与据回调,统一改为由store驱动 - 通过
restProps透传至EmojiSelector内部各元素
改造状态文件 useTagEditStore 和 useTagCreateStore ⇧
改造
@/stores/createFormStore.ts添加调试中间件,并配置mode属性
|
|
- 仅在开发模式启用
enabled: import.meta.env.DEV - 根据模式名称配置
name属性name:tag-${options.mode}-form`
@/stores/useTagEditStore.ts
|
|
- 添加了
sign_id字段,之后可使用getEmojiById获取emojiItem数据,同步更新状态
@/stores/useTagCreateStore.ts
|
|
- 添加了
sign_id字段,用以简化获取emojiItem数据,同步更新状态
改造页面组件 TagEditPage.tsx ⇧
@/pages/TagEditPage.tsx
|
|
- TODO: 根据id 请求接口获取标签详情数据
改造 TagForm ⇧
@/modules/tags/TagForm.tsx
|
|
- 主要和表单相关状态交互
onSubmit中收集表单数据,执行验证逻辑- TODO: 发送创建标签请求
- TODO: 实现删除标签请求
- 对于
FormItem主要数据交互:value和onChangeonBlur触发重新验证对应表单项数据onFocus触发时清楚对应表单项错误提示formItemType类型判断,影响传参数据类型errorHint传参错误提示,影响相关样式
改造 FormItem 泛型组件与相关类型声明 ⇧
@/components/form/item/FormItemType.ts
|
|
- 注意合并类型别名,避免合并同名属性为
never,需要合并覆盖时使用Omit忽略同名属性
@/components/form/item/FormItem.tsx
|
|
- TS 在 switch (formItemType) 中不会把泛型 T 缩窄为字面量
- 因此 formItemTypeProps 仍为联合类型
- 展开到各具体组件时 value 等属性类型不兼容
- 在各分支断言为对应字面量类型的 props
InputEmoji ⇧
@/components/form/item/InputEmoji.tsx
|
|
- 监听状态数据
id: emojiId、emoji、mainTopic,和外部数据传参value- 提前退出逻辑
!emojiId || !emoji - 通过
id获取emojiItem数据,更新状态 - 并且使用外部传参回调函数
onChange传参数据emojiId、emoji,更新表单数据
- 提前退出逻辑
- 通过
{...restProps}透传事件onBlur、onFocus到子组件EmojiSelector - 不与子组件直接通信,而是和状态
useEmojiStore通信
EmojiSelector ⇧
@/components/form/item/emoji/EmojiSelector.tsx
|
|
- 使用
mainTopic状态标记组件EmojiUnicodeList的key属性 - 通过
{...restProps}透传事件onBlur、onFocus到子组件EmojiMainTopicNav和EmojiUnicodeList - 不与子组件直接通信,而是和状态
useEmojiStore通信
EmojiMainTopicNav ⇧
@/components/form/item/emoji/EmojiMainTopicNav.tsx
|
|
- 用户点击切换,执行
selectMainTopic逻辑,重置状态,更新mainTopic状态 - 监听
mainTopic数据变化,重置状态,更新mainTopic状态 - 除了绑定事件
onBlur、onFocus,不与父组件直接通信,而是和状态useEmojiStore通信
EmojiUnicodeList ⇧
@/components/form/item/emoji/EmojiUnicodeList.tsx
|
|
- 用户点击切换,执行
switchEmojiUnicode逻辑,通过getEmojiById获取emojiItem更新状态,点击同样emoji不执行逻辑 - 监听
emoji, emojiHint变化,更新状态 - 除了绑定事件
onBlur、onFocus,不与父组件直接通信,而是和状态useEmojiStore通信
参考文章
- 初始代码:https://github.com/FrankFang/aLK6px
- 提交历史(5个提交):https://github.com/FrankFang/XJJO9L/commits/master
相关文章
- 作者: Joel
- 文章链接:
- 版权声明
- 非自由转载-非商用-非衍生-保持署名