feat: add useFileInput hook (#624)

src/components/index.ts

@@ -66,3 +66,4 @@ export * from './utils/useForkRef';
 export * from './utils/setRef';
 export {useOnFocusOutside} from './utils/useOnFocusOutside';
 export * from './utils/xpath';
+export * from './utils/useFileInput/useFileInput';

src/components/utils/useFileInput/__stories__/UseFileInput.stories.tsx

@@ -0,0 +1,20 @@
+import React from 'react';
+import {Meta, Story} from '@storybook/react';
+import {Button} from '../../../Button';
+import {useFileInput} from '../useFileInput';
+
+export default {title: 'Hooks/useFileInput'} as Meta;
+
+const DefaultTemplate: Story = () => {
+    const onUpdate = React.useCallback((files: File[]) => console.log(files), []);
+    const {controlProps, triggerProps} = useFileInput({onUpdate});
+
+    return (
+        <React.Fragment>
+            <input {...controlProps} />
+            <Button {...triggerProps}>Upload</Button>
+        </React.Fragment>
+    );
+};
+
+export const Default = DefaultTemplate.bind({});

src/components/utils/useFileInput/useFileInput.ts

@@ -0,0 +1,74 @@
+/* eslint-disable valid-jsdoc */
+import React from 'react';
+
+export type UseFileInputProps = {
+    onUpdate?: (files: File[]) => void;
+    onChange?: (event: React.ChangeEvent<HTMLInputElement>) => void;
+};
+
+export type UseFileInputOutput = {
+    controlProps: React.DetailedHTMLProps<
+        React.InputHTMLAttributes<HTMLInputElement>,
+        HTMLInputElement
+    >;
+    triggerProps: {
+        onClick: () => void;
+    };
+};
+
+/**
+ * Used to shape props for input with type "file".
+ * 
+ * Usage example:
+ ```tsx
+    import React from 'react';
+    import {Button, useFileInput} from '@gravity-ui/uikit';
+    
+    const Component = () => {
+        const onUpdate = React.useCallback((files: File[]) => console.log(files), []);
+        const {controlProps, triggerProps} = useFileInput({onUpdate});
+        
+        return (
+            <React.Fragment>
+                <input {...controlProps} />
+                <Button {...triggerProps}>Upload</Button>
+            </React.Fragment>
+        );
+    };
+```
+*/
+export function useFileInput({onUpdate, onChange}: UseFileInputProps): UseFileInputOutput {
+    const ref = React.useRef<HTMLInputElement>(null);
+
+    const handleChange = React.useCallback(
+        (event: React.ChangeEvent<HTMLInputElement>) => {
+            onChange?.(event);
+            onUpdate?.(Array.from(event.target.files || []));
+            // https://stackoverflow.com/a/12102992
+            event.target.value = '';
+        },
+        [onChange, onUpdate],
+    );
+
+    const openDeviceStorage = React.useCallback(() => {
+        ref.current?.click();
+    }, []);
+
+    const result: UseFileInputOutput = React.useMemo(
+        () => ({
+            controlProps: {
+                ref,
+                type: 'file',
+                tabIndex: -1,
+                style: {opacity: 0, position: 'absolute', width: 1, height: 1},
+                onChange: handleChange,
+            },
+            triggerProps: {
+                onClick: openDeviceStorage,
+            },
+        }),
+        [handleChange, openDeviceStorage],
+    );
+
+    return result;
+}