0.1.2 • Published 6 years ago

react-algolia-places v0.1.2

Weekly downloads
1,138
License
MIT
Repository
github
Last release
6 years ago

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

PropertiesTypeRequiredDefault valueEffectExample
onChangefunctionYESfalseFired when suggestion selected in the dropdown or hint was validated.true
disableBooleanNofalseenable/ disable the inputtrue
languageStringNonavigator.language2 letters country code (ISO 3166-1 alpha-2)fr
countriesArray of stringsNono valuesChange the countries to search in. Array of two letters country codes['fr', 'en', 'de', 'be']
typeStringNono valuesRestrict the search results to a specific type.['city', busStop]
useDeviceLocationBooleanNofalseAsk and use the device location.true
appIdStringNono valuesIf using the authenticated API, the Application ID to use.--
apiKeyStringNono valuesIf 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