Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/songkeys/mantine-form-valibot-resolver

Valibot schema resolver for @mantine/form
https://github.com/songkeys/mantine-form-valibot-resolver

Last synced: 26 days ago
JSON representation

Valibot schema resolver for @mantine/form

Awesome Lists containing this project

README

        

# mantine-form-valibot-resolver

[![npm version](https://badgen.net/npm/v/mantine-form-valibot-resolver)](https://npm.im/mantine-form-valibot-resolver)

[valibot](https://www.npmjs.com/package/valibot) resolver for [@mantine/form](https://mantine.dev/form/use-form/).

## Installation

With npm:

```sh
npm install valibot mantine-form-valibot-resolver
```

With yarn:

```sh
yarn add valibot mantine-form-valibot-resolver
```

With pnpm:

```sh
pnpm add valibot mantine-form-valibot-resolver
```

## Versions

Peer dependencies:

| mantine-form-valibot-resolver | valibot | @mantine/form |
| ----------------------------- | ---------------------------------------------------------- | ------------- |
| 3.x | >=1.0.0 | >=7.0.0 |
| 2.x | [>=0.31.0](https://valibot.dev/guides/migrate-to-v0.31.0/) | >=7.0.0 |
| 1.x | <0.31.0 | >=7.0.0 |

## Usage

### Basic fields validation

```tsx
import { useForm } from "@mantine/form";
import { valibotResolver } from "mantine-form-valibot-resolver";
import * as v from "valibot";

const schema = v.object({
name: v.pipe(
v.string(),
v.minLength(2, "Name should have at least 2 letters")
),
email: v.pipe(v.string(), v.email("Invalid email")),
age: v.pipe(
v.number(),
v.minValue(18, "You must be at least 18 to create an account")
),
});

const form = useForm({
initialValues: {
name: "",
email: "",
age: 16,
},
validate: valibotResolver(schema),
});

form.validate();
form.errors;
// -> {
// name: 'Name should have at least 2 letters',
// email: 'Invalid email',
// age: 'You must be at least 18 to create an account'
// }
```

### Nested fields validation

```tsx
import { useForm } from "@mantine/form";
import { valibotResolver } from "mantine-form-valibot-resolver";
import * as v from "valibot";

const nestedSchema = v.object({
nested: v.object({
field: v.pipe(
v.string(),
v.minLength(2, "Field should have at least 2 letters")
),
}),
});

const form = useForm({
initialValues: {
nested: {
field: "",
},
},
validate: valibotResolver(nestedSchema),
});

form.validate();
form.errors;
// -> {
// 'nested.field': 'Field should have at least 2 letters',
// }
```

### List fields validation

```tsx
import { useForm } from "@mantine/form";
import { valibotResolver } from "mantine-form-valibot-resolver";
import * as v from "valibot";

const listSchema = v.object({
list: v.array(
v.object({
name: v.pipe(
v.string(),
v.minLength(2, "Name should have at least 2 letters")
),
})
),
});

const form = useForm({
initialValues: {
list: [{ name: "" }],
},
validate: valibotResolver(listSchema),
});

form.validate();
form.errors;
// -> {
// 'list.0.name': 'Name should have at least 2 letters',
// }
```

### With TypeScript

You can use the `InferInput` type from the `valibot` library to get the type of the form data.

```tsx
import { useForm } from "@mantine/form";
import { valibotResolver } from "mantine-form-valibot-resolver";
import * as v from "valibot";

export const userSchema = v.object({
email: v.pipe(v.string(), v.email()),
});

type FormData = v.InferInput;

const form = useForm({
initialValues: {
email: "",
},
validate: valibotResolver(userSchema),
});
```

## License

MIT