- DependentFormItem: 透传 disabled 为顶层 prop(之前藏在 config.disabled 中,widget 组件读取不到)
- ImageInput: 值语义分层 — undefined(开关关) / [](开关开但空) / [{...}](已上传)
- isValueEmpty: 空数组[] 不再视为空,配合 enable_switch 语义
- handleFileWidgetValue: 兼容 Upload DOM事件 和 enable_switch 裸值两种 onChange 形态
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
107 lines
4.2 KiB
TypeScript
107 lines
4.2 KiB
TypeScript
// ============================================================
|
||
// ImageInput — imageInput → Upload(单张图片)
|
||
// 用于垫图、参考图等单图上传场景
|
||
//
|
||
// enable_switch 支持:
|
||
// 当 API ui.enable_switch === true 时,默认禁用(灰色),
|
||
// 需点击 Switch 开关后才能上传——匹配原 Qt 客户端行为。
|
||
// 开关关闭时清除已上传文件。
|
||
//
|
||
// 表单值语义(配合 constraints_config.requires 依赖禁用):
|
||
// undefined → 开关关闭 / 未启用 → isValueEmpty = true → 依赖字段禁用
|
||
// [] → 开关开启但未上传文件 → isValueEmpty = false → 依赖字段启用
|
||
// [{...}] → 已上传文件 → isValueEmpty = false → 依赖字段启用
|
||
// ============================================================
|
||
|
||
import { useState, useCallback } from 'react';
|
||
import { Upload, Switch, Space, Typography, message } from 'antd';
|
||
import { UploadOutlined } from '@ant-design/icons';
|
||
import type { UploadFile } from 'antd/es/upload';
|
||
import type { WidgetProps } from './types';
|
||
|
||
const { Text } = Typography;
|
||
|
||
/** 构建图片 accept 字符串 */
|
||
function buildAccept(filters?: string[]): string {
|
||
if (!filters || filters.length === 0) return 'image/png,image/jpg,image/jpeg,image/webp';
|
||
return filters.map((ext) => `image/${ext}`).join(',');
|
||
}
|
||
|
||
/** 标记"已启用但空"的空数组,避免 react 渲染时引用变化 */
|
||
const ENABLED_EMPTY: UploadFile[] = [];
|
||
|
||
export function ImageInput({ value, onChange, disabled, config }: WidgetProps) {
|
||
const fileList = (value as UploadFile[]) || [];
|
||
const maxSizeMb = (config.maxFileSizeMb as number) || 10;
|
||
const hasEnableSwitch = (config.enableSwitch as boolean) || false;
|
||
|
||
// 有 enable_switch 时默认禁用,需手动开启
|
||
const [switchOn, setSwitchOn] = useState(!hasEnableSwitch);
|
||
const isUploadDisabled = disabled || !switchOn;
|
||
|
||
const handleSwitchChange = useCallback(
|
||
(on: boolean) => {
|
||
setSwitchOn(on);
|
||
if (!on) {
|
||
// 关闭开关 → 表单值置为 undefined(isValueEmpty = true,依赖字段禁用)
|
||
onChange?.(undefined);
|
||
} else {
|
||
// 开启开关 → 空数组 = "已启用但未上传"(isValueEmpty = false,依赖字段启用)
|
||
onChange?.(ENABLED_EMPTY as unknown as UploadFile[]);
|
||
}
|
||
},
|
||
[onChange],
|
||
);
|
||
|
||
return (
|
||
<Space orientation="vertical" style={{ width: '100%' }} size={8}>
|
||
{hasEnableSwitch && (
|
||
<Space size={8}>
|
||
<Switch
|
||
size="small"
|
||
checked={switchOn}
|
||
onChange={handleSwitchChange}
|
||
disabled={disabled}
|
||
/>
|
||
<Text type={switchOn ? 'success' : 'secondary'} style={{ fontSize: 12 }}>
|
||
{switchOn ? '已启用' : '点击开关启用上传'}
|
||
</Text>
|
||
</Space>
|
||
)}
|
||
|
||
<Upload
|
||
listType="picture-card"
|
||
maxCount={1}
|
||
accept={buildAccept(config.fileFilter as string[] | undefined)}
|
||
fileList={fileList}
|
||
onChange={({ fileList: newList }) => {
|
||
// 仅当开关开启时上报文件变化
|
||
if (switchOn || !hasEnableSwitch) {
|
||
onChange?.(newList as unknown as UploadFile[]);
|
||
}
|
||
}}
|
||
disabled={isUploadDisabled}
|
||
beforeUpload={(file) => {
|
||
const isImage = file.type.startsWith('image/');
|
||
if (!isImage) {
|
||
message.error('只能上传图片文件');
|
||
return Upload.LIST_IGNORE;
|
||
}
|
||
if (file.size / 1024 / 1024 >= maxSizeMb) {
|
||
message.error(`图片大小不能超过 ${maxSizeMb}MB`);
|
||
return Upload.LIST_IGNORE;
|
||
}
|
||
return false;
|
||
}}
|
||
>
|
||
{fileList.length < 1 && (
|
||
<div style={{ opacity: isUploadDisabled ? 0.4 : 1 }}>
|
||
<UploadOutlined />
|
||
<div style={{ marginTop: 4, fontSize: 12 }}>上传</div>
|
||
</div>
|
||
)}
|
||
</Upload>
|
||
</Space>
|
||
);
|
||
}
|