angular-weblineindia-address
v1.0.0
Published
An AngularJS based Address component which uses Google Maps Places API to autosuggest location address
Downloads
25
Maintainers
Readme
AngularJS - Address Autosuggest (Google Maps Places API)
An AngularJS based Address component which uses Google Maps Places API to autosuggest location address.
Table of contents
- Browser Support
- Demo
- Installation
- Getting started
- Usage
- Available Props
- Methods
- Want to Contribute?
- Collection of Components
- Changelog
- Credits
- License
- Keywords
Browser Support
| | | | | | | ---------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- | | 83.0 ✔ | 77.0 ✔ | 13.1.1 ✔ | 83.0 ✔ | 11.9 ✔ |
Demo
Installation
This component uses Google Maps Places API to get geo suggestions for address autocompletion. To use this component, 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.
Getting started
Install the npm package:
npm install angular-weblineindia-address
#OR
yarn add angular-weblineindia-address
Usage
Use the <angular-weblineindia-address>
component:
Add in app.module.ts
import {AddressModule} from 'angular-weblineindia-address'
imports: [
AddressModule
],
Add in app.component.ts
import { Component } from "@angular/core";
@Component({
selector: "app-root",
templateUrl: "./app.component.html",
styleUrls: ["./app.component.css"]
})
export class AppComponent {
adddressValue: any = [{ address: "" }];
address: any = {
placeholder: "address",
addressUniqueErrorMsg: "Please do not enter same address",
addressOptions: {
types: [],
componentRestrictions: { country: "IN" }
},
maxlength: 50,
name: "address",
id: "address",
disabled: false,
tabindex: 0
};
handleAddressChange(event) {
this.adddressValue.push(event.data);
}
onChangeAddress(event) {
this.adddressValue[event.index].address = event.data;
}
onBlurAddress(data) {}
onFocusAddress(data) {}
onClickPlus() {
this.adddressValue.push({ address: "" });
}
}
Add in app.component.html
<div *ngFor="let value of adddressValue;let indexOfelement=index;">
<lib-address
[addressValue]="value.address"
[index]="indexOfelement"
[addressArray]="adddressValue"
[isShowPlus]="adddressValue.length-1 === indexOfelement"
[placeholder]="address.placeholder"
[addressUniqueErrorMsg]="address.addressUniqueErrorMsg"
[addressOptions]="address.addressOptions"
[maxlength]="address.maxlength"
[name]="address.name"
[id]="address.id"
[disabled]="address.disabled"
[tabindex]="address.tabindex"
(changeAddress)="onChangeAddress($event)"
(onPlus)="onClickPlus()"
(blur)="onBlurAddress($event)"
(focus)="onFocusAddress($event)"
></lib-address>
</div>
Available Props
| Prop | Type | default | Description | | --------------------- | ------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------- | | id | String | | ID for the input container | | name | String | | Name of the component | | addressValue | Array | address: [ {address: "", geolocation: { x: 0, y: 0 }, country: "",locality: "",postalcode: "", state: "",province: "",fulladdress: "", streetaddress: "",isDuplicate: false}] | Value of the component | | placeholder | String | | The input field will get this placeholder text | | disabled | Boolean | false | Disable component | | tabindex | Number | | Tab index of the component | | isMultiple | Boolean | | Add Multiple Address | | isShowPlus | Boolean | | Show + icon | | index | Number | | Add key of the component | | maxlength | Number | | The input maxlength | | addressArray | Array[object] | [] | The address array | | addressUniqueErrorMsg | String | | Unique address validation | | addressOptions | Object | | Autocomplete address options |
Methods
| Name | Description | | ------------- | ---------------------------------------------------------------- | | focus | Gets triggered when the autocomplete input field receives focus. | | blur | Gets triggered when the autocomplete input field loses focus. | | onPlus | Gets triggered every time when add plus icon | | changeAddress | Gets triggered when the autocomplete results got changed. |
Want to Contribute?
- Created something awesome, made this code better, added some functionality, or whatever (this is the hardest part).
- Fork it.
- Create new branch to contribute your changes.
- Commit all your changes to your branch.
- Submit a pull request.
Collection of Components
We have built many other components and free resources for software development in various programming languages. Kindly click here to view our Free Resources for Software Development
Changelog
Detailed changes for each release are documented in CHANGELOG.md.
Credits
angular-weblineindia-address is inspired by ngx-google-places-autocomplete.
License
Keywords
angular-weblineindia-address, address-autocomplete, google-maps-places, angular-components, angularjs, angularjs-component, angular-address-autosuggest, google-maps-places-api