formkit-lazy-plugin

formkit-lazy-plugin

The Lazy plugin for FormKit allows you to effortlessly handle asynchronous data fetching and form population. With this plugin, you can easily load data into your form components while displaying a loading state until the data is resolved.

Usage

Install package:

# npm
npm install formkit-lazy-plugin

# yarn
yarn add formkit-lazy-plugin

# pnpm
pnpm install formkit-lazy-plugin

Add to formkit.config:

// ESM
import { createLazyPlugin } from "formkit-lazy-plugin";

// CommonJS
const { createLazyPlugin } = require("formkit-lazy-plugin");

// Formkit config
const config: DefaultConfigOptions = {
  plugins: [createLazyPlugin()]
}

Add the lazy prop to your FormKit component and pass either a promise or a function that returns a promise. This promise represents the asynchronous data fetching operation.

<script setup>
const fetchData = () => fetch(...)
</script>

<template>
  <FormKit type="form" :lazy="fetchData">
    ...
  </FormKit>
</template>

As soon as the promise is resolved, the form will automatically populate with the fetched data. In the meantime, the form will display a loading state, providing a smooth user experience.

Development

• Clone this repository
• Install latest LTS version of Node.js
• Enable Corepack using corepack enable
• Install dependencies using pnpm install
• Run interactive tests using pnpm dev

License

Made with 💛

Published under MIT License.

Changelog

v0.0.1

🚀 Enhancements

• CreateLazyPlugin (273b1a7)
• Add lazy prop type (d5ff42b)

🩹 Fixes

• Remove default error handler (35a3dbf)
• Disable using props (697e795)

💅 Refactors

• Remove unused import (f8f7727)

🏡 Chore

• Init (c1ea691)
• Configure prettier (31ce808)
• Fix lint (1799fce)
• Update readme (3929136)
• Update readme (b0cf488)

❤️ Contributors

• João Pedro Antunes Silva [e-mail]