Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

nickt26/svelte-headless-form

Repository files navigation

Svelte Headless Form

A fast, light and batteries-included form library to make you more productive.

Getting Started

npm install svelte-headless-form

How to use

<script>
 import { createForm } from 'svelte-headless-form';
 const { submitForm, input, errors, values, register } = createForm({
 validateMode: 'onBlur', // Defaults - Schemaless:onChange Schema:onBlur
 initialValues: {
 username: '',
 password: ''
 },
 initialValidators: {
 username: (value) => (value.length > 0 ? false : 'Name is required'),
 password: (value) => (value.length > 0 ? false : 'Password is required')
 }
 });
</script>
<form on:submit|preventDefault={submitForm((values) => console.log(values))}>
 <input
 type="text"
 bind:value={$values.username}
 use:register={{ name: 'username' }}
 />
 {#if $errors.username}
 <div>
 {$errors.username}
 </div>
 {/if}
 <input
 type="password"
 bind:value={$values.password}
 use:register={{ name: 'password' }}
 />
 {#if $errors.password}
 <div>
 {$errors.password}
 </div>
 {/if}
 <button type="submit">Submit</button>
</form>

Philosophy

Svelte Headless Form allows for 2 different validation implementations, called schema-based validation and schemaless validation. In the How To Use section we are demonstrating schemaless validation by giving each form value it's own validator in the initialValidators prop. If you are intereseted in using schema based validaton please give your createForm() a prop called 'validationResolver' which is a single function that returns an object with error strings located at the same path of the corresponding values. In the future we plan to have pre-built validation resolvers for all the major schema based validators like zod, yup and joi to name a few.

Roadmap

These roadmap features are not ordered by priority.

  • Support schemaless validation updates after form creation.
  • Support validation dependencies.
  • Update README with more advanced examples.
  • Create a website with a tutorial, an API overview and documentation.
  • Send through entire form state to schemaless validators.
  • Support async schemaless validators.
  • Support schema-based validation.
  • Unify useField and useFieldArray api by passing down control.
  • Support a revalidateMode in createForm options.
  • Explore simpler options for attaching handleChange, handleBlur and handleFocus events to inputs.

Please consider svelte-headless-form in beta until a 1.0 release.

About

A fast, powerful and batteries-included form library to make you more productive

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

AltStyle によって変換されたページ (->オリジナル) /