@netsells/vue-form-data

0.2.0 • Public • Published

npm version Build Status codecov Mutation testing badge

Vue Form Data

Mixins to handle form data in a form and input components for you. This package makes it much easier to treat a form as a single object, and allows custom input components access to other form fields.

Installation

yarn add @netsells/vue-form-data

Usage

This package exposes 2 mixins: withFormData and withFormInput. Both are functions which return a mixin object, and can be passed options.

withFormData

This is a basic mixin which creates a formData state.

import { withFormData } from '@netsells/vue-form-data';

{
    mixins: [
        withFormData()
    ],

    mounted() {
        console.log('Form data:', this.formData); // {}
    },
}

Options you can pass are:

  • formData - change the formData name
  • defaults - change the default formData
import { withFormData } from '@netsells/vue-form-data';

{
    mixins: [
        withFormData({
            formData: 'data',
            defaults: { foo: 'bar' },
        })
    ],

    mounted() {
        console.log('Form data:', this.data); // { foo: 'bar' }
    },
}

withFormInput

This mixin adds the required props value and id. value must be set to the formData from the form using v-model. id is the name of the field in the formData, and optionally can be used for the id attribute on the input element.

It also adds a model and formData computed property. These handle the emit events for you. Changing model will update the value of the matching key in formData. Changing formData will change the entire object, and is useful for child inputs.

<template>
    <label>
      {{ label }}

      <input :id="id" v-model="model" />
    </label>
</template>
import { withFormInput } from '@netsells/vue-form-data';

export default {
    mixins: [
        withFormInput(),
    ],

    props: ['label'],
}

withFormInput can also take options to change the names of props and computed properties.

  • id - set the name of the prop used to key the field in formData
  • value - set the name of the prop used for the formData
    • If not set to value, you will need to use the sync modifier instead of v-model: :myprop.sync="formData"
  • formData - set the name of the formData computed property
  • model - set the name of the model computed property

Readme

Keywords

none

Package Sidebar

Install

npm i @netsells/vue-form-data

Weekly Downloads

2

Version

0.2.0

License

ISC

Unpacked Size

499 kB

Total Files

19

Last publish

Collaborators

  • rebeccaanderton
  • samturrell
  • spamoom
  • jakub.gawron