A Vuetify ready Vue.js (2.x) autosuggest component for the Google Maps Places API.
Huge thanks and credit goes to @olefirenko and contributors for creating Vue Google Autocomplete upon which this Vuetify ready version was built.
Live Interactive demo: madimetjashika.github.io/vuetify-google-autocomplete
This component uses Google Maps Places API to get geo suggests for autocompletion, so you have to include the Google Maps Places API in the <head> of your HTML:
<!DOCTYPE html>
<html>
<head>
…
<script src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY_HERE&libraries=places"></script>
</head>
<body>
…
</body>
</html>To obtain API key please visit the Google Developer Console. The API's that you have to enable in your Google API Manager Dashboard are Google Maps Geocoding API, Google Places API Web Service and Google Maps Javascript API.
The easiest way to use Vuetify Google Autocomplete is to install it from npm or yarn.
npm install vuetify-google-autocomplete --saveOr
yarn add vuetify-google-autocompleteThe Vuetify Google Autocomplete works out of the box by just including it.
import VuetifyGoogleAutocomplete from 'vuetify-google-autocomplete'In your template you can use this syntax:
<vuetify-google-autocomplete
id="map"
append-icon="search"
disabled="true"
classname="form-control"
placeholder="Start typing"
v-on:placechanged="getAddressData"
>
</vuetify-google-autocomplete>NB: This componenent implements the same props as those specified for Vuetify Text Fields as at v0.16.9, some of which are listed below. Please see Vuetify Text Fields for a complete list of props.
Type: String
required ID for the input container.
Type: String
Default: null
The icon to append to the end of the input field.
Type: String
Default: null
The icon to prepend at the beginning of the input field.
Type: String
Class to the input container.
Type: String
Default: Search Address
The input field will get this placeholder text. Note that the input field will also get a label with the same text.
Type: Boolean
Default: false
Sets the input as either disabled or not.
Type: String
Default: address
Types supported in place autocomplete requests. More info
Type: String|Array
Default: null
Option to restrict the autocomplete search to a particular country. Countries must be passed as a two-character, ISO 3166-1 Alpha-2 compatible country code (i.e. "br", "sg", "fr"). You can provide a single one, or an array of up to 5 country code strings.
Note: this is a dynamic property. You must pass it as :country="" to your component, otherwise it won't work. For example:
<vuetify-google-autocomplete :country="['au', 'nz']"></vuetify-google-autocomplete>will restrict the countries to Australia and New Zealand.
Type: Boolean
Default: false
Bias the search towards user current location.
The component emits next events, which you can listen in your application:
Gets triggered when the address data got obtained. This data is available on the returned objects:
street_number,route,locality,administrative_area_level_1,country,postal_code,latitude,longitude.place- PlaceResult object is available as second parameter.
Gets triggered when a user entered the name of a Place that was not suggested and pressed the Enter key, or the Place Details request failed.
Gets triggered when the autocomplete input field receives focus.
Gets triggered when the autocomplete input field loses focus.
Gets triggered every time autocomplete input got changed
Gets triggered when the autocomplete results got changed
Gets triggered when a key gets pressed
These functions are accessible by setting "ref" on the component (Refs documentation). See example below how to use these functions.
Call to clear the value of the user input.
Call focus to focus on the element
Call blur to blur (unfocus) the element
Call to update the user input with a new value
Please note that you need to provide what method will listen (v-on:placechanged) to an event when the address data is obtained.
<template>
<div>
<h2>Your Address</h2>
<vuetify-google-autocomplete
ref="address"
id="map"
classname="form-control"
placeholder="Please type your address"
v-on:placechanged="getAddressData"
country="sg"
>
</vuetify-google-autocomplete>
</div>
</template>
<script>
import VuetifyGoogleAutocomplete from 'vuetify-google-autocomplete'
export default {
components: { VuetifyGoogleAutocomplete },
data: function () {
return {
address: ''
}
},
mounted() {
// To demonstrate functionality of exposed component functions
// Here we make focus on the user input
this.$refs.address.focus();
},
methods: {
/**
* When the location found
* @param {Object} addressData Data of the found location
* @param {Object} placeResultData PlaceResult object
* @param {String} id Input container ID
*/
getAddressData: function (addressData, placeResultData, id) {
this.address = addressData;
}
}
}
</script>Lets make this an awesome vuetify component! Collaborations and contributions are welcome!
Have a read through the Contributor Code of Conduct. Pretty standard, nothing hectic.
Fork, then clone the repo:
git clone [email protected]:your-username/vuetify-google-autocomplete.git
Install dependencies with npm
npm install
or yarn
yarn
Make your changes and ensure tests are written for your changes. Ensure that your changes pass all the tests:
npm run test
If relevant, please ensure that you update the README and demo/example accordingly.
Push to your fork and submit a pull request.
If all is well, your changes will be merged timeously!
Feel free to also post issues for bug fixes or enhancements or anything.