create-v-model

create v-model bindings quickly and easily - without having to remember which props to use

Usage no npm install needed!

<script type="module">
  import createVModel from 'https://cdn.skypack.dev/create-v-model';
</script>

README

create-v-model

create v-model bindings quickly and easily - without having to remember which props to use

install

yarn add create-v-model
npm install --save create-v-model

use

import { modelProps, createModel } from 'create-v-model'

export default {
  props: {
    ...modelProps()
  },
  setup: (props) => ({
    model: createModel(props)
  })
}

api

modelProps

Provides all three props used in binding a standard v-model to a component

props: {
  ...modelProps({
    modelName: string = 'modelValue',
    modelType: any = null,
    modelDefault: any,
    modifierDefault: any = (() => ({}))
  })
}
  • modelName: the name of the model; leave this as the default for plain v-model, and otherwise give it the NAME in v-model:NAME
  • modelType: an optional type to specify the model should be
  • modelDefault: an optional value to specify the intial value of the model (typically used for absent prop detection)
  • modifierDefault: an optional alternative default for the modelModifiers prop (or equivalent for named models)

createModel

Creates a new computed that can be used as a standard ref and will reflect changes on v-model

setup: (props, { emit }) => ({
  model: createModel({
    props,
    emit?, // see below for info about emit being optional
    modelName: string = 'modelValue',
    modifier?: function
  })
})
  • props: the props from setup - this is required
  • emit: if emit is provided, then Vue's built-in modifiers (trim and number) will be enabled - and events will be emitted for updates instead of directly calling the relevant onUpdate function directly
  • modelName: the name of the model; leave this as the default for plain v-model, and otherwise give it the NAME in v-model:NAME
  • modifier: a function of the form below, this will be called whenever the model would call set
    • (value: typeof modelType, modelModifiersObject: object) => typeof modelType

createModelFactory

Creates a higher-order function, can be useful for hooks and other utilities - otherwise effectively the same as createModel

setup: (props, { emit }) => ({
  model: createModelFactory({ modelName, modifier })({ props, emit })
})