refactor(qrcode): 提取独立组件并添加单元测试

- 创建 pages/QrCode/types.ts 定义状态类型接口
- 提取 QrCodePreview 组件用于二维码预览和操作
- 提取 ImageUploader 组件封装图片上传、拖拽、粘贴逻辑
- 重构 UrlToQrCodeSection 状态提升到父组件
- 重构 QrCodeToUrlSection 通过回调传递解析结果
- 更新主页面 index.tsx 集中管理所有状态
- 为 QrCodePreview 和 ImageUploader 添加单元测试 (23 个用例)
This commit is contained in:
雨霖铃
2026-05-20 21:59:57 +08:00
parent 9c03c585a8
commit 2870e01610
8 changed files with 865 additions and 241 deletions
+33 -62
View File
@@ -1,4 +1,4 @@
import React, { useCallback, useState } from 'react';
import React, { useCallback } from 'react';
import {
Accordion,
AccordionDetails,
@@ -11,39 +11,36 @@ import {
Typography,
} from '@mui/material';
import QrCodeIcon from '@mui/icons-material/QrCode';
import DownloadIcon from '@mui/icons-material/Download';
import ContentCopyIcon from '@mui/icons-material/ContentCopy';
import ExpandMoreIcon from '@mui/icons-material/ExpandMore';
import QRious from 'qrious';
import { qrCodePageStyles } from '@/config/pageTheme';
import { useSnackbar } from '@/components/GlobalSnackbar';
import { useTranslation } from 'react-i18next';
import { useContextMenuData } from '@/utils/useContextMenuData';
interface UrlToQrCodeSectionProps {
expanded: boolean;
onExpandedChange: (expanded: boolean) => void;
/** 桌面端强制展开(隐藏折叠交互) */
forceExpanded?: boolean;
}
import QrCodePreview from '@/components/QrCodePreview';
import type { QrCodeGeneratorProps } from './types';
const UrlToQrCodeSection = ({
textToEncode,
onTextChange,
qrCodeDataUrl,
onQrCodeDataUrlChange,
generating,
onGeneratingChange,
inputError,
onInputErrorChange,
expanded,
onExpandedChange,
forceExpanded = false,
}: UrlToQrCodeSectionProps) => {
}: QrCodeGeneratorProps) => {
const { t } = useTranslation(['qrCode']);
const { showMessage } = useSnackbar();
const [urlInput, setUrlInput] = useState('');
const [urlError, setUrlError] = useState('');
const [qrCodeDataUrl, setQrCodeDataUrl] = useState('');
const [generating, setGenerating] = useState(false);
const generateQrCodeFromUrl = useCallback(
async (url: string) => {
try {
setGenerating(true);
setUrlError('');
onGeneratingChange(true);
onInputErrorChange('');
if (!url.startsWith('http://') && !url.startsWith('https://')) {
url = 'https://' + url;
@@ -57,40 +54,40 @@ const UrlToQrCodeSection = ({
background: '#FFFFFF',
});
setQrCodeDataUrl(qr.toDataURL());
onQrCodeDataUrlChange(qr.toDataURL());
showMessage(t('qrCode:qrCodeSuccess'), { severity: 'success', autoHideDuration: 1000 });
} catch (error) {
console.error('生成二维码失败:', error);
showMessage(t('qrCode:parseError'), { severity: 'error', autoHideDuration: 300 });
} finally {
setGenerating(false);
onGeneratingChange(false);
}
},
[t, showMessage],
[t, showMessage, onGeneratingChange, onInputErrorChange, onQrCodeDataUrlChange],
);
const handleContextMenuData = useCallback(
(payload: string) => {
setUrlInput(payload);
onTextChange(payload);
onExpandedChange(true);
generateQrCodeFromUrl(payload);
},
[onExpandedChange, generateQrCodeFromUrl],
[onExpandedChange, generateQrCodeFromUrl, onTextChange],
);
useContextMenuData({ featureKey: 'qrCode', onData: handleContextMenuData });
const handleUrlInputChange = (e: React.ChangeEvent<HTMLInputElement>) => {
setUrlInput(e.target.value);
setUrlError('');
onTextChange(e.target.value);
onInputErrorChange('');
};
const generateQrCode = async () => {
if (!urlInput) {
setUrlError(t('qrCode:enterUrlError'));
if (!textToEncode) {
onInputErrorChange(t('qrCode:enterUrlError'));
return;
}
await generateQrCodeFromUrl(urlInput);
await generateQrCodeFromUrl(textToEncode);
};
const downloadQrCode = () => {
@@ -142,12 +139,12 @@ const UrlToQrCodeSection = ({
<TextField
label={t('qrCode:urlInputLabel')}
placeholder={t('qrCode:urlInputPlaceholder')}
value={urlInput}
value={textToEncode}
onChange={handleUrlInputChange}
fullWidth
variant="outlined"
error={!!urlError}
helperText={urlError}
error={!!inputError}
helperText={inputError}
sx={qrCodePageStyles.INPUT_STYLE}
/>
@@ -161,38 +158,12 @@ const UrlToQrCodeSection = ({
{generating ? t('qrCode:generating') : t('qrCode:generateButton')}
</Button>
<Box className="qr-flex-grow" sx={qrCodePageStyles.QR_PREVIEW_CONTAINER}>
{qrCodeDataUrl ? (
<Box sx={qrCodePageStyles.QR_PREVIEW_INNER}>
<img src={qrCodeDataUrl} alt="QR Code" style={qrCodePageStyles.QR_PREVIEW_IMAGE} />
<Box sx={qrCodePageStyles.QR_PREVIEW_ACTIONS}>
<Button
variant="outlined"
startIcon={<DownloadIcon />}
onClick={downloadQrCode}
sx={qrCodePageStyles.DOWNLOAD_BUTTON}
>
{t('qrCode:downloadButton')}
</Button>
<Button
variant="contained"
startIcon={<ContentCopyIcon />}
onClick={copyQrCode}
sx={qrCodePageStyles.COPY_BUTTON}
>
{t('qrCode:copyQrButton')}
</Button>
</Box>
</Box>
) : (
<Typography
variant="body2"
color="text.secondary"
sx={qrCodePageStyles.PLACEHOLDER_TEXT}
>
{t('qrCode:qrCodeWillShow')}
</Typography>
)}
<Box className="qr-flex-grow">
<QrCodePreview
qrCodeDataUrl={qrCodeDataUrl}
onDownload={downloadQrCode}
onCopy={copyQrCode}
/>
</Box>
</Stack>
</AccordionDetails>