From 166c02a8f2022028c35c040b0b5edf3e71dea759 Mon Sep 17 00:00:00 2001 From: Ben Newman Date: Thu, 19 Nov 2026 12:33:33 -0500 Subject: [PATCH] feat(mui-file-selector): add customHeaderMessage to fileSelector --- .../src/lib/FileSelector.test.tsx | 44 +++++++++++++++++++ .../file-selector/src/lib/FileSelector.tsx | 17 ++++++- .../src/lib/FileSelector2.test.tsx | 38 ++++++++++++++++ .../file-selector/src/lib/FileSelector2.tsx | 11 ++++- 4 files changed, 106 insertions(+), 4 deletions(-) diff --git a/packages/file-selector/src/lib/FileSelector.test.tsx b/packages/file-selector/src/lib/FileSelector.test.tsx index 5bae1168af..b85188dc30 100644 --- a/packages/file-selector/src/lib/FileSelector.test.tsx +++ b/packages/file-selector/src/lib/FileSelector.test.tsx @@ -24,4 +24,48 @@ describe('FileSelector', () => { expect(getByText('Upload file')).toBeTruthy(); }); + + test('renders default HeaderMessage when customHeaderMessage is not provided and enableDropArea is false', () => { + const client = new QueryClient(); + const { getByText } = render( + + + + + + ); + + expect(getByText(/Attach up to 10 file\(s\)/)).toBeTruthy(); + }); + + test('renders customHeaderMessage instead of default HeaderMessage when provided', () => { + const client = new QueryClient(); + const { getByText, queryByText } = render( + + + + + + ); + + expect(getByText('Attach up to 10 file(s), max 5 MB per file, 50 MB total')).toBeTruthy(); + expect(queryByText(/maximum individual size/)).toBeNull(); + }); }); diff --git a/packages/file-selector/src/lib/FileSelector.tsx b/packages/file-selector/src/lib/FileSelector.tsx index dbaf459ddb..c0af64592b 100644 --- a/packages/file-selector/src/lib/FileSelector.tsx +++ b/packages/file-selector/src/lib/FileSelector.tsx @@ -153,6 +153,12 @@ export type FileSelectorProps = { * @returns Custom error message string, or undefined to use default */ getErrorMessage?: GetErrorMessageFn; + /** + * Custom header message to replace the auto-generated "Attach up to X file(s)..." text. + * Only used when `enableDropArea` is `false`. When provided, the default `HeaderMessage` + * is not rendered. + */ + customHeaderMessage?: ReactNode; }; export const FileSelector = ({ @@ -184,6 +190,7 @@ export const FileSelector = ({ validator, disableRemove, getErrorMessage, + customHeaderMessage, }: FileSelectorProps) => { const [totalSize, setTotalSize] = useState(0); const [fileRejections, setFileRejections] = useState<(FileRejection & { id: number })[]>([]); @@ -283,7 +290,11 @@ export const FileSelector = ({ ) : ( - + {customHeaderMessage ? ( + {customHeaderMessage} + ) : ( + + )} 0 && ( { for (const rejection of tooManyFilesRejections) handleRemoveRejection(rejection.id) }} + onClose={() => { + for (const rejection of tooManyFilesRejections) handleRemoveRejection(rejection.id); + }} > Items not allowed. Too many files are selected for upload, maximum {maxFiles} allowed. diff --git a/packages/file-selector/src/lib/FileSelector2.test.tsx b/packages/file-selector/src/lib/FileSelector2.test.tsx index 2edad598f5..e5b0ad5702 100644 --- a/packages/file-selector/src/lib/FileSelector2.test.tsx +++ b/packages/file-selector/src/lib/FileSelector2.test.tsx @@ -20,4 +20,42 @@ describe('FileSelector2', () => { expect(getByText('Upload file')).toBeTruthy(); }); + + test('renders default HeaderMessage when customHeaderMessage is not provided and enableDropArea is false', () => { + const { getByText } = render( + + + + ); + + expect(getByText(/Attach up to 10 file\(s\)/)).toBeTruthy(); + }); + + test('renders customHeaderMessage instead of default HeaderMessage when provided', () => { + const { getByText, queryByText } = render( + + + + ); + + expect(getByText('Attach up to 10 file(s), max 5 MB per file, 50 MB total')).toBeTruthy(); + expect(queryByText(/maximum individual size/)).toBeNull(); + }); }); diff --git a/packages/file-selector/src/lib/FileSelector2.tsx b/packages/file-selector/src/lib/FileSelector2.tsx index ab164cd253..af685f766c 100644 --- a/packages/file-selector/src/lib/FileSelector2.tsx +++ b/packages/file-selector/src/lib/FileSelector2.tsx @@ -63,6 +63,7 @@ export const FileSelector2 = ({ validator, disableRemove, getErrorMessage, + customHeaderMessage, }: FileSelector2Props) => { const [totalSize, setTotalSize] = useState(0); const [fileRejections, setFileRejections] = useState<(FileRejection & { id: number })[]>([]); @@ -160,7 +161,11 @@ export const FileSelector2 = ({ ) : ( - + {customHeaderMessage ? ( + {customHeaderMessage} + ) : ( + + )} 0 && ( { for (const rejection of tooManyFilesRejections) handleRemoveRejection(rejection.id) }} + onClose={() => { + for (const rejection of tooManyFilesRejections) handleRemoveRejection(rejection.id); + }} > Items not allowed. Too many files are selected for upload, maximum {maxFiles} allowed.