README

pcln-autocomplete

Composable React autocomplete component built with Downshift

npm i pcln-autocomplete

import React from 'react'
import { Autocomplete } from 'pcln-autocomplete'
import { Icon, Text } from 'pcln-design-system'

export default props =>
  <Autocomplete
    match={(item, value) => item.includes(value)}
    onChange={item => {
      props.onChange(item)
    }}>
    <Autocomplete.Label>
      Location
    </Autocomplete.Label>
    <Autocomplete.Input />
    <Autocomplete.Menu>
      {props.locations.map(location => (
        <Autocomplete.Item
          key={location.name}
          item={location}>
          <Icon
            name='pin'
            mr={2}
            color='blue'
          />
          <Text fontSize={0}>
            {location.name}
          </Text>
        </Autocomplete.Item>
      ))
    </Autocomplete.Menu>
  </Autocomplete>

Note: <Autocomplete> relies on values from theme, so it must be a descendent of <ThemeProvider> in order to work properly. Otherwise, you might experience errors like this:

Uncaught TypeError: Cannot read property '3' of undefined

Components

All components can be imported by name and subcomponents are provided as static properties on the Autocomplete component.

Autocomplete

Wrapper for Downshift component with additional match prop.

Prop	Type	Description
`match`	function	Filters direct children of the Menu component
`itemToString`	function	Used to determine the string value for the selected item (shown in the input value)
`onChange`	function	Called when the user selects an item and the selected item has changed. Called with the item that was selected and the new state of downshift

For additional props, see the Downshift documentation.

Label

Design system Label component with additional default props provided by Downshift for accessibility.

Input

Design system Input component with additional default props provided by Downshift for accessibility.

Item

Design system Flex component with styles and default props to work with Downshift.

Roadmap

Make autocomplete elements compatible with design system FormField

Usage no npm install needed!