react-algolia-places

A simple but powerful React.js wrapper around fantastic Algolia's place !

How to use

Install the package by using npm

    npm install -S react-algolia-places

Or use yarn

    yarn add react-algolia-places

Then import the package

    import React, {Component} from 'react'
    import ReactDOM from 'react-dom'

    import Place from 'react-algolia-places'

    ReactDOM.render(<Place />, document.getElementById('app'))

Properties

Properties	Type	Required	Default value	Effect	Example
onChange	function	YES	false	Fired when suggestion selected in the dropdown or hint was validated.	true
disable	Boolean	No	false	enable/ disable the input	true
language	String	No	navigator.language	2 letters country code (ISO 3166-1 alpha-2)	fr
countries	Array of strings	No	no values	Change the countries to search in. Array of two letters country codes	['fr', 'en', 'de', 'be']
type	String	No	no values	Restrict the search results to a specific type.	['city', busStop]
useDeviceLocation	Boolean	No	false	Ask and use the device location.	true
appId	String	No	no values	If using the authenticated API, the Application ID to use.	--
apiKey	String	No	no values	If using the authenticated API, the API key to use.	--

ℹ️ List of accepted types :

• city
• country
• address
• busStop
• trainStation
• townhall
• airport

Runnning locally

Run the following script yarn demo or npm run demo and open a browser at http://localhost:3000

Runnning the test suite

Our test is based on Airbnb's Enzyme, JEST and Jasime test suite, to run them use the following script yarn test

To do

Support other Algolia's place options and Events Write Tests