React项目无刷新更新新上传头像的实现方案(未使用Redux)
头像上传无刷新更新实现方案
问题根源
- 上传成功后返回的新头像信息仅存储在
useStorage自定义钩子的内部状态,没有对外传递 Avatar组件的头像请求仅在auth.token变化时触发,上传流程没有触发其重新拉取数据的通道- 上传链路和头像展示链路的状态完全独立,无联动机制
全局状态选型说明
不需要引入Redux,两种场景分别对应两种实现方案,均基于现有架构即可完成:
- 若头像仅在当前上传页面使用,使用状态提升即可,无需新增全局状态
- 若头像会在多个页面/组件复用,直接复用已有的
AuthContext扩展,不需要新增Context实例
方案一:状态提升(仅当前页面使用头像)
适用于上传组件和头像组件同属一个父页面的场景,实现轻量无全局污染。
修改步骤
- 找到
UploadForm和Avatar的共同父组件,新增newAvatar状态用于存储上传成功的新头像文件名 - 改造
ProgressBar组件,新增onUploadSuccess回调参数,上传成功后把新头像信息回传给父组件 - 改造
UploadForm组件,把父组件传入的onUploadSuccess回调透传给ProgressBar - 改造
Avatar组件,新增overrideAvatar参数,优先展示外部传入的新头像,无外部传入时再用自身请求的旧头像
对应修改代码
改造后的ProgressBar.js
import React, { useEffect } from "react"; import useStorage from "../../hooks/use-storage"; import { motion } from "framer-motion"; import "./ProgressBar.css"; const ProgressBar = ({ file, setFile, onUploadSuccess }) => { const { url, progress } = useStorage(file); useEffect(() => { if (url) { onUploadSuccess(url.filename); setFile(null); } }, [url, setFile, onUploadSuccess]); return ( <motion.div className="upload-progress" initial={{ width: 0 }} animate={{ width: progress + "%" }} ></motion.div> ); }; export default ProgressBar;
改造后的UploadForm.js
import React, { useState } from "react"; import ProgressBar from "../../../shared/components/progressBar/ProgressBar"; const UploadForm = ({ onUploadSuccess }) => { const [file, setFile] = useState(null); const [error, setError] = useState(null); const types = ["image/png", "image/jpg", "image/jpeg"]; const changeHandler = (e) => { let selected = e.target.files[0]; if (selected && types.includes(selected.type)) { setFile(selected); setError(""); } else { setFile(null); // 修正原代码漏写的右括号 setError("Please select an image file(png or jpg)"); } }; return ( <form> <input type="file" onChange={changeHandler} name="image"></input> <div className="output"> {error && <div className="error">{error}</div>} {file && <div>{file.name}</div>} {file && <ProgressBar file={file} setFile={setFile} onUploadSuccess={onUploadSuccess} />} </div> </form> ); }; export default UploadForm;
改造后的Avatar.js(状态提升版本)
import React, { useContext, useEffect, useState } from "react"; import Axios from "axios"; import { AuthContext } from "../../../shared/context/auth-context"; const Avatar = ({ overrideAvatar }) => { const auth = useContext(AuthContext); const [avatar, setAvatar] = useState(null); useEffect(() => { const getAvatarImage = async () => { const response = await Axios.get( "http://localhost:8000/api/v1/users/get-avatar", { headers: { Authorization: "Bearer " + auth.token } } ); setAvatar(response.data.avatar); }; if (auth.token) getAvatarImage(); }, [auth.token]); // 外部传入的新头像优先级更高 const displayAvatar = overrideAvatar || avatar; return ( <div> {displayAvatar && ( <img src={`http://localhost:8000/uploads/images/${displayAvatar}`} width="200" alt="avatar image" /> )} </div> ); }; export default Avatar;
共同父组件使用示例
import React, { useState } from "react"; import UploadForm from "./components/UploadForm"; import Avatar from "./components/Avatar"; const ProfilePage = () => { const [newAvatar, setNewAvatar] = useState(null); return ( <div> <Avatar overrideAvatar={newAvatar} /> <UploadForm onUploadSuccess={(filename) => setNewAvatar(filename)} /> </div> ); };
方案二:扩展现有AuthContext(多页面复用头像)
适用于头像会在多个页面/组件使用的场景,复用现有全局上下文,不需要新增状态管理依赖。
修改步骤
- 给
AuthContext新增avatar状态字段和updateAvatar更新方法 - 改造
useStorage钩子,上传成功后直接调用updateAvatar更新全局头像状态 - 改造
Avatar组件,直接从AuthContext读取头像状态,无需单独请求(可保留原请求作为兜底)
对应修改代码
改造后的auth-context.js
import { createContext } from "react"; export const AuthContext = createContext({ isLoggedIn: false, userId: null, token: null, email: null, firstName: null, avatar: null, // 新增头像字段 login: () => {}, logout: () => {}, updateAvatar: () => {} // 新增更新头像方法 });
注:需要在
AuthContext的Provider实现里补充updateAvatar的具体逻辑,用来修改全局的avatar状态
改造后的use-storage.js
import React, { useState, useEffect, useContext } from "react"; import Axios from "axios"; import { AuthContext } from "../context/auth-context"; const useStorage = (file) => { const auth = useContext(AuthContext); const [progress, setProgress] = useState(0); const [error, setError] = useState(null); const [url, setUrl] = useState(null); useEffect(() => { // 无文件时不触发上传 if (!file) return; const formData = new FormData(); formData.append("image", file); // 把异步错误处理移到async函数内部,避免被外层同步try/catch吞掉 const sendImage = async () => { try { const response = await Axios.post( "http://localhost:8000/api/v1/users/update-avatar", formData, { headers: { "Content-type": "multipart/form-data", Authorization: "Bearer " + auth.token, }, onUploadProgress: (progressEvent) => { setProgress( parseInt( Math.round((progressEvent.loaded * 100) / progressEvent.total) ) ); }, } ); const { filename } = response.data.file; // 上传成功后更新全局头像状态 auth.updateAvatar(filename); setUrl(filename); } catch (err) { setError(err); console.log(err.response); } }; sendImage(); }, [file, auth]); return { progress, url, error }; }; export default useStorage;
改造后的Avatar.js(全局版本)
import React, { useContext } from "react"; import { AuthContext } from "../../../shared/context/auth-context"; const Avatar = () => { const auth = useContext(AuthContext); // 直接读取全局的头像状态 const avatar = auth.avatar; return ( <div> {avatar && ( <img src={`http://localhost:8000/uploads/images/${avatar}`} width="200" alt="avatar image" /> )} </div> ); }; export default Avatar;
现有代码遗留问题修正
- 原
UploadForm的错误提示漏写了右括号,已在上述修改中修正 - 原
useStorage的useEffect依赖数组缺少auth对象,会导致闭包读取到旧的token,已补充到依赖数组 - 原
useStorage的try/catch包裹的是同步调用,无法捕获async函数的异步错误,已调整错误处理位置
内容的提问来源于stack exchange,提问作者Waterfall
相关产品推荐
相关产品推荐

