vuetify-avatar-uploader

🐨 v-avatar + file uploads

Wraps Vuetify's v-avatar component with file upload magic.

User clicks on their avatar
User selects an image file to use as their new avatar
File is uploaded to your API
User's avatar is replaced ✨

Installation

npm i vuetify-avatar-uploader

Module

import VAvatarUploader from 'vuetify-avatar-uploader'

export default {
  components: {
    VAvatarUploader
  }
}

Browser

<script type="text/javascript" src="node_modules/vuejs/dist/vue.min.js"></script>
<script type="text/javascript" src="node_modules/vuetify/dist/vuetify.min.js"></script>
<script type="text/javascript" src="node_modules/vuetify-avatar-uploader/dist/vuetify-avatar-uploader.min.js"></script>
<script type="text/javascript">
  Vue.use(VAvatarUploader);
</script>

Usage

At a minimum, you must provide :url and :request properties:

<template>
  <v-avatar-uploader
    :url="url"
    :request="request"
  />
</template>

<script>
import VAvatarUploader from 'vuetify-avatar-uploader'

export default {
  computed: {
    // Determine the URL to show, typically from an object representing a user
    url () {
      return 'https://randomuser.me/api/portraits/men/1.jpg'
    }
  },

  methods: {
    // Responsible for performing the upload request to your API
    request (form, config) {
      return this.$http.post('/v1/avatars', form, config)
    }
  },

  components: {
    VAvatarUploader
  }
}
</script>

Example

The following is a real-world example of how the library can be used to support user avatar uploads:

<template>
  <v-avatar-uploader
    :url="url"
    :request="request"
    :clickable="clickable"
    :rename="rename"
    @success="success"
    @failed="failed"
  />
</template>

<script>
import VAvatarUploader from 'vuetify-avatar-uploader'
import events from '@/util/events'

import uuid from 'uuid/v4'
import get from 'dlv'
import { mapState } from 'vuex'

export default {
  name: 'user-avatar-uploader',

  props: {
    user: {
      type: Object,
      required: true
    }
  },

  computed: {
    ...mapState('api/user', ['session']),

    url () {
      return get(this.user, 'avatar.thumb')
    },

    clickable () {
      return this.user.id === this.session.id
    }
  },

  methods: {
    request (form, config) {
      return this.$http.post('/v1/avatars', form, config)
    },

    rename (file) {
      const ext = file.name.split('.')[1]
      const name = `${uuid()}.${ext}`

      return name
    },

    success ({ data }) {
      // Update user avatar with the latest
      Object.assign(this.user.avatar, data)

      // Request the latest user object from the API to update all other references in the app
      this.$store.dispatch('api/user/get')
    },

    failed (error) {
      events.$emit('notify', { text: 'Failed to upload avatar', kind: 'error', icon: 'warning' })
    }
  },

  components: {
    VAvatarUploader
  }
}
</script>

API

Props

Name	Description	Type	Required	Default
`url`	URL of the avatar	`String`	Yes
`request`	Performs the file upload	`Function`	Yes
`rename`	Renames the file before upload	`Function`	No	`file => file.name`
`field`	`FormData` field name to use for file data	`String`	No	`'file'`
`clickable`	Determines if the user can click to upload	`Boolean`	No	`true`
`maxSize`	Maximum file upload size (in KiB)	`Number`	No	`2048`
`headers`	Optional HTTP headers to send with upload request	`Object`	No	`{}`
`avatar`	Core `v-avatar` configuration object	`Object`	No	`{}`

Events

Name	Description
`success`	File upload succeeded
`progress`	File upload progress (`axios` only)
`cancel`	File upload interrupted (i.e. user clicked on avatar while uploading)
`replace`	User clicks on a pre-existing avatar (overrides default file selection flow!)
`failed`	File upload failed
`error-type`	File upload MIME type is unsupported
`error-size`	File upload exceeds maximum size
`error-empty`	File upload is empty

Slots

Name	Description
`none`	Displayed when the `url` prop is falsy
`loading`	Displayed when an avatar is being uploaded

Future

Document more real-world examples
Provide configuration options for v-progress-bar
Support upload cancellations
Allow custom supported MIME types
Allow custom form property name for file uploads
Emit event on empty files

License

MIT

slurmulon / vuetify-avatar-uploader