# @govuk-react/file-upload

> File input component with label expected as children.

Latest version **0.10.7** (published 2024-05-13) · MIT license · 0 weekly downloads

## Install

```sh
npm install @govuk-react/file-upload
pnpm add @govuk-react/file-upload
yarn add @govuk-react/file-upload
bun add @govuk-react/file-upload
```

## Health

**Score 25/100 (F)** — status: abandoned.

Positive: has types; esm support; no vulnerabilities.

Warnings: low downloads; pre 1.0.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 0.10.7 |
| Published | 2024-05-13 |
| First published | 2018-03-16 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 5 |
| Unpacked size | 21.3 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Author | Alasdair McLeay |
| Maintainers | loque-, steve_sims, petelockey, penx, marksy |

## Links

- npm: https://www.npmjs.com/package/@govuk-react/file-upload
- Homepage: https://github.com/govuk-react/govuk-react/tree/main/components/file-upload
- npm.io page: https://npm.io/package/@govuk-react/file-upload

## Dependencies (5)

- [@govuk-react/label](https://npm.io/package/@govuk-react/label.md) ^0.10.7
- [@govuk-react/constants](https://npm.io/package/@govuk-react/constants.md) ^0.10.7
- [@govuk-react/hint-text](https://npm.io/package/@govuk-react/hint-text.md) ^0.10.7
- [@govuk-react/error-text](https://npm.io/package/@govuk-react/error-text.md) ^0.10.7
- [@govuk-react/label-text](https://npm.io/package/@govuk-react/label-text.md) ^0.10.7

## Recent versions

- 0.10.7 (latest) — 2024-05-13
- 0.6.0-rc.1 (next) — 2019-02-28
- 0.10.6 — 2023-10-01
- 0.10.5 — 2022-11-22
- 0.10.4 — 2022-10-08
- 0.10.3 — 2022-08-20
- 0.10.2 — 2022-08-19
- 0.10.1 — 2022-04-08
- 0.10.0 — 2021-10-07
- 0.9.1 — 2021-09-06
- 0.9.0 — 2021-05-30
- 0.8.0 — 2021-05-16
- 0.7.1 — 2019-05-24
- 0.7.0 — 2019-03-15
- 0.6.0 — 2019-03-01
- … 26 more at https://npm.io/package/@govuk-react/file-upload/versions

## README

FileUpload
==========

### Import
```js
  import FileUpload from '@govuk-react/file-upload';
```
<!-- STORY -->

Help users select and upload a file.

- https://govuk-react.github.io/govuk-react/?path=/docs/file-upload
- https://design-system.service.gov.uk/components/file-upload/

### Properties
Prop | Required | Default | Type | Description
:--- | :------- | :------ | :--- | :----------
 `acceptedFormats` |  | ```undefined``` | string | 
 `error` |  |  | boolean | Apply error state styling to the component
 `hint` |  | ```undefined``` | string | Optional hint text
 `key` |  |  | Key | 
 `margin` |  |  | Margin \| Margin[] | 
 `mb` |  |  | string \| number | 
 `meta` |  | ```{}``` | { error?: string \| string[]; touched?: boolean; } | Final form meta object, pending adjustment/removal
 `name` |  | ```undefined``` | string | 
 `onChange` |  | ```undefined``` | ChangeEventHandler<HTMLInputElement> | 
 `padding` |  |  | Padding \| Padding[] | 
 `ref` |  |  | Ref<HTMLInputElement> |

---
_Source: https://npm.io/package/@govuk-react/file-upload · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
