UNPKG

react-bare-forms

Version:

A bare minimal React form library for quick & simple forms.

54 lines (53 loc) 1.45 kB
import { default as React } from "react"; import { IFile } from "./core"; /** * RBF's provides a function that returns a React ref to access your file object. * To use, simply assign the returned ref from the createFileRef function to a * variable & pass this variable to FileField's ref prop. * @returns * @example * ``` * * import {createFileRef, FileField, isFile, getFileFromRef} from "react-bare-forms"; * * const myFileRef = createFileRef(); * * <FileField * ref={myFileRef} * hint="Must be a file" * labeltext="Upload your file" * name="myFileTest" * validators={[isFile()]} * /> * * ``` */ export declare function createFileRef(): React.RefObject<HTMLFormElement>; /** * To get a file object back from the react ref, you can use `getFileFromRef` function. * @params The React ref returned from {@link createFileRef} * @returns * @example * ``` * * import {createFileRef, FileField, isFile, getFileFromRef} from "react-bare-forms"; * * const myFileRef = createFileRef(); * * <FileField * ref={myFileRef} * hint="Must be a file" * labelrext="Upload your file" * name="myFileTest" * validators={[isFile()]} * /> * * let fileData = { * myFile: getFileFromRef(myFileRef) * }; * * // fileData.myFile is your Javascript File object. * * ``` */ export declare function getFileFromRef(fileRef: React.RefObject<HTMLFormElement>): IFile | null;