react-bare-forms
Version:
A bare minimal React form library for quick & simple forms.
54 lines (53 loc) • 1.45 kB
TypeScript
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;