# @s-ui/react-molecule-field

> `MoleculeField` is a component that wraps a composition of Label + some input (input, textarea, ...) + Validation Messages.

Latest version **1.42.0** (published 2025-05-21) · MIT license · 0 weekly downloads

## Install

```sh
npm install @s-ui/react-molecule-field
pnpm add @s-ui/react-molecule-field
yarn add @s-ui/react-molecule-field
bun add @s-ui/react-molecule-field
```

## Health

**Score 40/100 (D)** — status: stable.

Positive: no vulnerabilities; high maintenance score.

Warnings: low downloads; no types; no esm support.

Negative: stale.

## Facts

| | |
|---|---|
| Version | 1.42.0 |
| Published | 2025-05-21 |
| First published | 2018-08-09 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 4 |
| Unpacked size | 13.4 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 146 |
| Maintainers | alejandro.ferrante, ivanmlaborda, salvador.juan, andresin87.adevinta, izeller, gfabregoadv, a.ferrer, ignacio_navarro, oscar_ramirez, jordi.munoz, joanleon-adv, aitor.rodriguez, luis-garrido, jenifer.lopez, isabelgomez87, pa.chruscinski.ext, schibstedspain, alfredo.arronte, belen.santos, xavi_ballestar, ferrangbtw, jamile.radloff, davidmartin2108, sergi.quintela, estefania_garcia, carlosvillu-adevinta, miriam-gil, arnau.guell, ferran.simon, victor.perez.adevinta, mariapaula.forero.ext, oscar.gomez, david.nieto, oriol.puig, nacho_torrella, xavi.murcia, ignacio.rodriguez, francisco.ruiz.lloret, sziauberyte, alfredo.zimperz, andresadv, javiauso, alverd004, marian.lucaci, pablogs, alisa_bayanova, cristhianb, sergiocollado, pablo.rey-adevinta, beatrizip, alex.castells, david.cuadrado.ext, giovanny.sayas.ext, patricio.sartore, azahara, marc.benito, sergio.escano, cristina.rodriguez.duque, pol.valls, frandelacasa-adevinta, carolina.mallo.ext, daniel.perez.ext, hpintos_adevinta, carlos.gonzalezl, albert.peiro, oscar-raig-adevinta, thomas.page.ext, sebastian.badea.adevinta, victoria.pasichnyk.ext, sendami.luque.ext, luz_adv, alfredo.narvaez, ruben-martin, dann41, emiliovz, adria.velardos, arturo.vicente, diegomr, sergi.martinez.adevinta, guillemgc3, frontend-jobs, javiermiguel, atilioscolaroadv, crotundu.adevinta, candymd, florinz, denis_z, anya_ok |
| Keywords | @s-ui, react, component, molecule, field |

## Links

- npm: https://www.npmjs.com/package/@s-ui/react-molecule-field
- Repository: https://github.com/SUI-Components/sui-components
- Homepage: https://sui-components.vercel.app/
- Issues: https://github.com/SUI-Components/sui-components/issues?q=is%3Aopen+label%3A%22Component%3A+field%22
- npm.io page: https://npm.io/package/@s-ui/react-molecule-field

## Dependencies (4)

- [@s-ui/react-atom-label](https://npm.io/package/@s-ui/react-atom-label.md) 1
- [@s-ui/react-atom-help-text](https://npm.io/package/@s-ui/react-atom-help-text.md) 1
- [@s-ui/react-primitive-injector](https://npm.io/package/@s-ui/react-primitive-injector.md) 1
- [@s-ui/react-atom-validation-text](https://npm.io/package/@s-ui/react-atom-validation-text.md) 1

## Alternatives

- [mobx-react](https://npm.io/package/mobx-react.md) — 2.8M weekly downloads
- [rc-tree](https://npm.io/package/rc-tree.md) — 2.6M weekly downloads
- [@react-oauth/google](https://npm.io/package/@react-oauth/google.md) — 1.3M weekly downloads
- [@wagmi/connectors](https://npm.io/package/@wagmi/connectors.md) — 877.0K weekly downloads
- [vee-validate](https://npm.io/package/vee-validate.md) — 836.4K weekly downloads

## Recent versions

- 1.42.0 (latest) — 2025-05-21
- 1.41.0 — 2025-05-20
- 1.40.0 — 2025-05-19
- 1.39.0 — 2024-04-04
- 1.38.0 — 2022-10-17
- 1.37.0 — 2022-10-06
- 1.36.0 — 2022-10-04
- 1.35.0 — 2022-10-04
- 1.34.0 — 2022-06-23
- 1.33.0 — 2022-04-05
- 1.32.0 — 2022-02-25
- 1.31.0 — 2021-09-09
- 1.30.0 — 2021-05-27
- 1.29.0 — 2021-01-08
- 1.28.0 — 2021-01-05
- … 26 more at https://npm.io/package/@s-ui/react-molecule-field/versions

## README

# MoleculeField

`MoleculeField` is a component that wraps a composition of Label + some input (input, textarea, ...) + Validation Messages. 

[![documentation](https://img.shields.io/badge/read%20the%20doc-black?logo=readthedocs)](https://sui-components.vercel.app/workbench/molecule/field/)
[![issue](https://img.shields.io/badge/report%20a%20bug-black?logo=openbugbounty&logoColor=red)](https://github.com/SUI-Components/sui-components/issues/new?&projects=4&template=bug-report.yml&assignees=&template=report-a-bug.yml&title=🪲+&labels=bug,component,molecule,field)
[![npm](https://img.shields.io/npm/dt/%40s-ui/react-molecule-field?logo=npm&labelColor=black)](https://www.npmjs.com/package/@s-ui/react-molecule-field)

[![Issues open](https://img.shields.io/github/issues-search/SUI-Components/sui-components?query=is%3Aopen%20label%3Acomponent%20label%3Afield&logo=openbugbounty&logoColor=red&label=issues%20open&color=red)](https://github.com/SUI-Components/sui-components/issues?q=is%3Aopen+label%3Acomponent+label%3Afield)
[![NPM](https://img.shields.io/npm/l/%40s-ui%2Freact-molecule-field)](https://github.com/SUI-Components/sui-components/blob/main/components/molecule/field/LICENSE.md)

## Installation

```sh
$ npm install @s-ui/react-molecule-field --save
```

## Usage

After importing the component `MoleculeField` like this

```javascript
import MoleculeField from '@s-ui/react-molecule-field'
```

### Basic usage
    
```
  <MoleculeField label="name" name="name">
    <input id="name" type="text"/>
  </MoleculeField>
```

### With Error Message 
```
<MoleculeField label="surname" name="surname" errorText="Error!">
  <input id="surname" type="text"/>
</MoleculeField>
```

### With Success Message 

```
  <MoleculeField label="address" name="address" successText="Success!">
    <input id="address" type="text"/>
  </MoleculeField>
```

### With Alert Message 

```
  <MoleculeField label="address" name="address" alertText="Alert!">
    <input id="address" type="text"/>
  </MoleculeField>
```

### With Help Text

```

<MoleculeField label="country" name="country" helpText="Read the instructions to write proper format">
  <input id="country" type="text"/>
</MoleculeField>
```

### Inline
```
<MoleculeField inline label="city" name="city">
  <input id="city" type="text"/>
</MoleculeField>
```


> **Find full description and more examples in the [demo page](https://sui-components.now.sh/workbench/molecule/field/demo).**

---
_Source: https://npm.io/package/@s-ui/react-molecule-field · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
