8d36f21f1b
* docs: 添加组件文档注释和类型导入 refactor: 统一使用 SnackbarOptions 类型 style: 优化导入语句顺序和格式 * refactor: 简化假数据生成器中的faker导入和使用 Co-authored-by: Copilot <copilot@github.com> * feat(form-recognizer): 增强表单识别功能并优化UI交互 - 新增字段类型偏好设置功能,支持按域名保存字段类型 - 重构FieldList组件,改进字段选择和类型修改体验 - 添加字段定位闪烁功能,便于在页面上快速找到对应字段 - 优化表单填充逻辑,支持单个字段覆盖默认填充模式 - 移除独立的侧边栏页面,统一使用主页面组件 - 改进useStorageState钩子,增加加载状态管理和防抖处理 * refactor: 移除未使用的组件文件 * refactor(页面头部): 提取通用 PageHeader 组件并替换各页面头部实现 重构各页面头部为统一的 PageHeader 组件,提高代码复用性和维护性 * style(组件): 调整自动刷新开关和存储选项网格的样式 优化自动刷新开关的文本内边距,重构存储选项网格的布局结构,调整间距和边框样式 * style(ui): 调整时间戳页面和结果视图的样式 - 为时区选择器添加圆角 - 优化结果视图的布局和对齐方式 - 调整结果项的内边距和文本样式 * ci(workflow): 移除Firefox测试以简化CI流程 仅保留Chrome浏览器的构建步骤,减少CI运行时间和资源消耗 * refactor(qrcode): 重构二维码解析功能并提取为独立模块 * style(页面样式): 统一页面头部图标颜色并优化表单样式 更新各页面头部组件的图标颜色配置,移除冗余的表单标签属性,优化输入框样式和按钮悬停效果 * feat(formMapping): 添加表单映射功能 - 创建 FormMappingPage 页面组件 - 实现表单扫描器 scanner.ts - 实现高亮器 highlighter.ts - 更新路由配置 routes.ts - 更新内容脚本 content.ts - 更新类型定义 storage.d.ts - 添加 formMappingPageStyles 样式配置 * feat(表单映射): 添加配置导出功能及状态提示 添加配置导出为JSON文件的功能,包含导出按钮和错误处理。新增Snackbar组件用于显示导出成功和错误状态。优化页面布局结构,将状态提示移至全局容器外。 * feat(表单填充): 新增智能表单填充功能 添加智能表单填充功能,包括: 1. 新增表单填充页面和路由配置 2. 实现模糊匹配引擎和智能注入引擎 3. 添加Mock数据生成器和视觉反馈渲染器 4. 扩展消息接口支持填充操作 * ci: 精简触发CI的工作流分支 移除对develop分支及其变体的触发,仅保留main分支的触发 * test: 更新路由测试以匹配新增的路由数量 * test: 将测试文件中的描述和断言翻译为中文 * test(PageHeader): 添加组件测试用例验证渲染逻辑和样式 * refactor(theme): 重构主题样式并优化仪表盘卡片组件 将页面样式配置集中管理,移除各页面中硬编码的背景色 新增 DashboardCard 组件封装通用卡片逻辑 添加 dashboardCards 配置文件统一管理卡片数据 * refactor(Button): 统一按钮样式并移除重复样式定义 将按钮样式统一封装到 Button 组件中,移除各页面重复的样式定义 更新组件文档说明,提供更清晰的用法示例 * docs: 更新 README 文件中的目录结构说明 添加新组件和配置文件的说明,保持文档与代码同步 * refactor: 优化代码类型声明和UI布局 修复类型声明从any改为never以提高类型安全性 调整TimestampPage页面布局间距 移除DashboardPage中不必要的实时时钟状态 更新ESLint配置以使用推荐配置 添加选项页面打开的错误处理 * refactor(消息通信): 使用 @webext-core/messaging 重构消息处理逻辑 将原有的 chrome.runtime.onMessage 和 chrome.tabs.sendMessage 替换为类型安全的 @webext-core/messaging 实现 添加 ProtocolMap 类型定义确保消息类型安全 更新相关页面和后台脚本使用新的消息通信方式 * fix: 修复依赖项缺失导致的潜在问题 修复 useStorageState 中缺少 defaultValue 依赖的问题 重构 RouterProvider 的初始化逻辑,使用 useCallback 优化性能 * refactor: 重构表单识别和消息处理逻辑 将表单映射UI逻辑提取到独立文件 将消息处理器提取到独立文件 将表单识别页面逻辑提取到自定义hook 优化代码结构和可维护性 * feat(侧边栏): 添加侧边栏状态变化通知功能 - 在消息类型中新增侧边栏状态变化枚举和字段 - 侧边栏打开和关闭时发送状态通知 - 替换轮询检查方式为消息监听机制 * refactor: 优化高亮组件渲染逻辑并添加防抖处理 重构高亮组件渲染逻辑,使用 requestAnimationFrame 进行节流优化 在 useStorageCleaner 中添加防抖处理以避免频繁加载 * refactor: 统一组件导出方式为默认导出 * refactor: 重构样式系统并迁移至 MUI 主题 删除冗余的 CSS 文件,统一使用 MUI 主题管理样式 新增 useActiveTabDomain 和 useSidePanelState 自定义 Hook 优化各入口点的主题集成和布局处理 * docs: 更新项目文档以反映新增功能和技术栈细节 更新 AGENTS.md 文档,详细描述新增的功能模块(存储管理、URL 管理、二维码生成、表单工具套件等)和更新的技术栈信息 * feat: 添加错误边界组件以捕获子组件错误 在 popup、sidepanel 和 options 入口点添加 ErrorBoundary 组件,用于捕获并处理子组件中的 JavaScript 错误。当错误发生时,显示友好的错误界面并提供刷新功能。 * refactor(ui): 使用全局 snackbar 替换本地通知组件 重构表单页面中的通知系统,移除本地 Snackbar 和 Alert 组件,改用全局 GlobalSnackbar 组件统一管理通知 标准化主题配置中的 CSS 属性命名,移除带前缀的样式属性 * refactor(snackbar): 重构全局消息提示为 SnackbarProvider 组件 将原本分散在各页面的 GlobalSnackbar 组件重构为集中管理的 SnackbarProvider,通过 Context 提供统一的消息提示功能。主要变更包括: 1. 创建新的 SnackbarProvider 组件作为全局消息提示容器 2. 提供 useSnackbar hook 供子组件调用 3. 移除各页面中独立的 GlobalSnackbar 实例 4. 在 App 根组件中统一集成 SnackbarProvider 5. 优化消息提示样式和交互行为 * refactor(Snackbar): 重构消息提示组件并优化样式 重构 Snackbar 组件,将状态管理逻辑提取到 GlobalSnackbar 中复用 优化消息提示样式,调整阴影效果和最小尺寸 统一各页面使用 Snackbar 的方式,移除冗余配置 * refactor: 重构路由和功能配置系统 - 将路由配置和仪表盘卡片配置合并为统一的 features 配置 - 重构 RouterProvider 增加数据校验和本地快照功能 - 优化表单字段识别和填充逻辑,提取公共方法 - 更新相关组件和文档以适配新的配置系统 - 删除废弃的 dashboardCards 和 routes 配置文件
383 lines
12 KiB
TypeScript
383 lines
12 KiB
TypeScript
import React, { useCallback, useEffect, useRef, useState } from 'react';
|
|
import {
|
|
Alert,
|
|
Box,
|
|
CircularProgress,
|
|
IconButton,
|
|
Paper,
|
|
Typography,
|
|
useMediaQuery,
|
|
useTheme,
|
|
} from '@mui/material';
|
|
import ImageIcon from '@mui/icons-material/Image';
|
|
import ClearIcon from '@mui/icons-material/Clear';
|
|
import CheckCircleIcon from '@mui/icons-material/CheckCircle';
|
|
import ErrorIcon from '@mui/icons-material/Error';
|
|
import GlobalSnackbar, { useSnackbarState } from './GlobalSnackbar';
|
|
import CopyButton from './CopyButton';
|
|
import { parseQrCodeFromFile } from '@/utils/qrCodeParser';
|
|
|
|
interface QrCodeUploaderProps {
|
|
onQrCodeDetected?: (data: string) => void;
|
|
supportedFormats?: string[];
|
|
maxFileSize?: number; // in bytes
|
|
timeout?: number; // in milliseconds
|
|
showPreview?: boolean;
|
|
showProgress?: boolean;
|
|
className?: string;
|
|
}
|
|
|
|
const QrCodeUploader: React.FC<QrCodeUploaderProps> = ({
|
|
onQrCodeDetected,
|
|
supportedFormats = ['image/png', 'image/jpeg', 'image/webp'],
|
|
maxFileSize = 5 * 1024 * 1024, // 5MB
|
|
timeout = 10000, // 10 seconds
|
|
showPreview = true,
|
|
showProgress = true,
|
|
className,
|
|
}) => {
|
|
const { snackbarProps, showMessage } = useSnackbarState({ autoHideDuration: 3000 });
|
|
const theme = useTheme();
|
|
const isMobile = useMediaQuery(theme.breakpoints.down('sm'));
|
|
|
|
const [file, setFile] = useState<File | null>(null);
|
|
const [preview, setPreview] = useState<string | null>(null);
|
|
const [uploading, setUploading] = useState(false);
|
|
const [progress, setProgress] = useState(0);
|
|
const [result, setResult] = useState<string | null>(null);
|
|
const [error, setError] = useState<string | null>(null);
|
|
const [dragging, setDragging] = useState(false);
|
|
|
|
const fileInputRef = useRef<HTMLInputElement>(null);
|
|
const uploadAreaRef = useRef<HTMLDivElement>(null);
|
|
|
|
// 清理预览 URL
|
|
useEffect(() => {
|
|
return () => {
|
|
if (preview) {
|
|
URL.revokeObjectURL(preview);
|
|
}
|
|
};
|
|
}, [preview]);
|
|
|
|
// 处理文件
|
|
const processFile = useCallback(
|
|
async (file: File) => {
|
|
setUploading(true);
|
|
setProgress(0);
|
|
|
|
try {
|
|
const progressInterval = setInterval(() => {
|
|
setProgress((prev) => {
|
|
if (prev >= 90) {
|
|
clearInterval(progressInterval);
|
|
return prev;
|
|
}
|
|
return prev + 10;
|
|
});
|
|
}, 200);
|
|
|
|
const result = await parseQrCodeFromFile(file, timeout);
|
|
|
|
clearInterval(progressInterval);
|
|
setProgress(100);
|
|
|
|
if (result.success && result.data) {
|
|
setResult(result.data);
|
|
showMessage('二维码解析成功', { severity: 'success' });
|
|
if (onQrCodeDetected) {
|
|
onQrCodeDetected(result.data);
|
|
}
|
|
} else {
|
|
setError(result.error || '未检测到二维码');
|
|
showMessage(result.error || '未检测到二维码', { severity: 'error' });
|
|
}
|
|
} catch (err) {
|
|
setError(err instanceof Error ? err.message : '解析失败');
|
|
showMessage('解析失败: ' + (err instanceof Error ? err.message : '未知错误'), {
|
|
severity: 'error',
|
|
});
|
|
} finally {
|
|
setUploading(false);
|
|
setTimeout(() => setProgress(0), 500);
|
|
}
|
|
},
|
|
[timeout, showMessage, onQrCodeDetected],
|
|
);
|
|
|
|
// 处理文件
|
|
const handleFile = useCallback(
|
|
(selectedFile: File) => {
|
|
// 检查文件格式
|
|
if (!supportedFormats.includes(selectedFile.type)) {
|
|
setError(
|
|
`不支持的文件格式。支持的格式: ${supportedFormats.map((f) => f.split('/')[1].toUpperCase()).join(', ')}`,
|
|
);
|
|
showMessage('不支持的文件格式', { severity: 'error' });
|
|
return;
|
|
}
|
|
|
|
// 检查文件大小
|
|
if (selectedFile.size > maxFileSize) {
|
|
const maxSizeMB = (maxFileSize / (1024 * 1024)).toFixed(1);
|
|
setError(`文件大小超过限制。最大支持 ${maxSizeMB}MB`);
|
|
showMessage(`文件大小超过限制,最大支持 ${maxSizeMB}MB`, { severity: 'error' });
|
|
return;
|
|
}
|
|
|
|
// 重置状态
|
|
setError(null);
|
|
setResult(null);
|
|
setFile(selectedFile);
|
|
|
|
// 创建预览
|
|
if (showPreview) {
|
|
const previewUrl = URL.createObjectURL(selectedFile);
|
|
setPreview(previewUrl);
|
|
}
|
|
|
|
// 开始处理
|
|
processFile(selectedFile).catch(console.error);
|
|
},
|
|
[supportedFormats, maxFileSize, showPreview, showMessage, processFile],
|
|
);
|
|
|
|
// 处理文件选择
|
|
const handleFileSelect = (e: React.ChangeEvent<HTMLInputElement>) => {
|
|
const selectedFile = e.target.files?.[0];
|
|
if (selectedFile) {
|
|
handleFile(selectedFile);
|
|
}
|
|
};
|
|
|
|
// 处理拖拽事件
|
|
const handleDragOver = (e: React.DragEvent<HTMLDivElement>) => {
|
|
e.preventDefault();
|
|
setDragging(true);
|
|
};
|
|
|
|
const handleDragLeave = () => {
|
|
setDragging(false);
|
|
};
|
|
|
|
const handleDrop = (e: React.DragEvent<HTMLDivElement>) => {
|
|
e.preventDefault();
|
|
setDragging(false);
|
|
const droppedFile = e.dataTransfer.files?.[0];
|
|
if (droppedFile) {
|
|
handleFile(droppedFile);
|
|
}
|
|
};
|
|
|
|
// 监听粘贴事件
|
|
useEffect(() => {
|
|
const handlePaste = (e: ClipboardEvent) => {
|
|
const items = e.clipboardData?.items;
|
|
if (!items) return;
|
|
|
|
for (let i = 0; i < items.length; i++) {
|
|
if (items[i].type.startsWith('image/')) {
|
|
e.preventDefault();
|
|
const pastedFile = items[i].getAsFile();
|
|
if (pastedFile) {
|
|
handleFile(pastedFile);
|
|
}
|
|
break;
|
|
}
|
|
}
|
|
};
|
|
|
|
document.addEventListener('paste', handlePaste);
|
|
return () => document.removeEventListener('paste', handlePaste);
|
|
}, [handleFile]);
|
|
|
|
// 清除文件
|
|
const handleClear = () => {
|
|
setFile(null);
|
|
setPreview(null);
|
|
setResult(null);
|
|
setError(null);
|
|
if (fileInputRef.current) {
|
|
fileInputRef.current.value = '';
|
|
}
|
|
};
|
|
|
|
return (
|
|
<Box className={className}>
|
|
{/* 上传区域 */}
|
|
<Paper
|
|
ref={uploadAreaRef}
|
|
elevation={0}
|
|
sx={{
|
|
p: isMobile ? 3 : 4,
|
|
borderRadius: 4,
|
|
border: `2px dashed ${dragging ? 'primary.main' : 'grey.300'}`,
|
|
bgcolor: dragging ? 'primary.lighter' : 'grey.50',
|
|
transition: 'all 0.2s ease',
|
|
textAlign: 'center',
|
|
cursor: 'pointer',
|
|
position: 'relative',
|
|
}}
|
|
onDragOver={handleDragOver}
|
|
onDragLeave={handleDragLeave}
|
|
onDrop={handleDrop}
|
|
onClick={() => fileInputRef.current?.click()}
|
|
>
|
|
<input
|
|
ref={fileInputRef}
|
|
type="file"
|
|
accept={supportedFormats.join(',')}
|
|
onChange={handleFileSelect}
|
|
style={{ display: 'none' }}
|
|
/>
|
|
|
|
{!file && !uploading ? (
|
|
<Box sx={{ display: 'flex', flexDirection: 'column', alignItems: 'center' }}>
|
|
<ImageIcon sx={{ fontSize: isMobile ? 36 : 48, color: 'grey.400', mb: 2 }} />
|
|
<Typography variant="body1" color="text.secondary" sx={{ mb: 1 }}>
|
|
点击、拖拽或粘贴上传二维码图片
|
|
</Typography>
|
|
<Typography variant="caption" color="text.secondary">
|
|
支持 {supportedFormats.map((f) => f.split('/')[1].toUpperCase()).join(', ')} 格式
|
|
</Typography>
|
|
<Typography variant="caption" color="text.secondary" sx={{ mt: 1 }}>
|
|
最大文件大小: {(maxFileSize / (1024 * 1024)).toFixed(1)}MB
|
|
</Typography>
|
|
</Box>
|
|
) : file && showPreview && preview ? (
|
|
<Box sx={{ position: 'relative' }}>
|
|
<img
|
|
src={preview}
|
|
alt="QR Code Preview"
|
|
style={{
|
|
maxWidth: '100%',
|
|
maxHeight: 200,
|
|
borderRadius: 8,
|
|
objectFit: 'contain',
|
|
}}
|
|
/>
|
|
<IconButton
|
|
size="small"
|
|
onClick={(e) => {
|
|
e.stopPropagation();
|
|
handleClear();
|
|
}}
|
|
sx={{
|
|
position: 'absolute',
|
|
top: -8,
|
|
right: -8,
|
|
bgcolor: 'rgba(244, 67, 54, 0.9)',
|
|
color: 'white',
|
|
'&:hover': {
|
|
bgcolor: 'rgba(211, 47, 47, 0.95)',
|
|
},
|
|
}}
|
|
>
|
|
<ClearIcon fontSize="small" />
|
|
</IconButton>
|
|
<Typography variant="body2" color="text.secondary" sx={{ mt: 2 }}>
|
|
{file.name}
|
|
</Typography>
|
|
</Box>
|
|
) : uploading && showProgress ? (
|
|
<Box sx={{ display: 'flex', flexDirection: 'column', alignItems: 'center' }}>
|
|
<CircularProgress size={48} sx={{ mb: 2 }} />
|
|
<Typography variant="body2" color="text.secondary" sx={{ mb: 1 }}>
|
|
处理中...
|
|
</Typography>
|
|
{progress > 0 && (
|
|
<Box sx={{ width: '80%', mt: 2 }}>
|
|
<Box
|
|
sx={{
|
|
height: 8,
|
|
bgcolor: 'grey.200',
|
|
borderRadius: 4,
|
|
overflow: 'hidden',
|
|
}}
|
|
>
|
|
<Box
|
|
sx={{
|
|
height: '100%',
|
|
bgcolor: 'primary.main',
|
|
width: `${progress}%`,
|
|
transition: 'width 0.3s ease',
|
|
}}
|
|
/>
|
|
</Box>
|
|
<Typography
|
|
variant="caption"
|
|
color="text.secondary"
|
|
sx={{ mt: 1, display: 'block' }}
|
|
>
|
|
{progress}%
|
|
</Typography>
|
|
</Box>
|
|
)}
|
|
</Box>
|
|
) : null}
|
|
</Paper>
|
|
|
|
{/* 结果展示 */}
|
|
{(result || error) && (
|
|
<Box sx={{ mt: 3 }}>
|
|
{result && (
|
|
<Paper
|
|
elevation={0}
|
|
sx={{
|
|
p: 3,
|
|
borderRadius: 4,
|
|
border: '1px solid',
|
|
borderColor: 'success.light',
|
|
bgcolor: 'success.lighter',
|
|
}}
|
|
>
|
|
<Box sx={{ display: 'flex', alignItems: 'flex-start', gap: 2 }}>
|
|
<CheckCircleIcon sx={{ color: 'success.main', mt: 0.5 }} />
|
|
<Box sx={{ flex: 1 }}>
|
|
<Typography variant="subtitle2" sx={{ fontWeight: 600, mb: 1 }}>
|
|
二维码内容
|
|
</Typography>
|
|
<Box sx={{ position: 'relative' }}>
|
|
<Typography
|
|
variant="body1"
|
|
sx={{
|
|
fontFamily: 'monospace',
|
|
wordBreak: 'break-all',
|
|
pr: 8,
|
|
}}
|
|
>
|
|
{result}
|
|
</Typography>
|
|
<CopyButton
|
|
text={result}
|
|
tooltip="复制"
|
|
size="small"
|
|
color="success"
|
|
showMessage={showMessage}
|
|
style={{
|
|
position: 'absolute',
|
|
right: 0,
|
|
top: 0,
|
|
}}
|
|
/>
|
|
</Box>
|
|
</Box>
|
|
</Box>
|
|
</Paper>
|
|
)}
|
|
|
|
{error && (
|
|
<Alert severity="error" sx={{ borderRadius: 4 }} icon={<ErrorIcon />}>
|
|
{error}
|
|
</Alert>
|
|
)}
|
|
</Box>
|
|
)}
|
|
|
|
<GlobalSnackbar {...snackbarProps} />
|
|
</Box>
|
|
);
|
|
};
|
|
|
|
export default QrCodeUploader;
|