anrom-jive-osapi-picker/README.md

UI for place/people/content Jive JS API picker, for use in custom view tiles

# anrom-jive-osapi-picker

### Requirements
* `osapi` global variable have to be exported as `'jive/osapi'` in webpack externals
* webpack should be configured to proces CSS files with `style-loader!css-loader` rule

## Installation

### npm
`npm install -S anrom-jive-osapi-picker`

## Usage
Usage example:
```jsx
import React from 'react'
import JivePicker from 'anrom-jive-osapi-picker'

export default function Picker({author, setAuthor}){
    return <JivePicker
        buttonTitle="Добавить блог"
        contentType="people"
        value={author}
        onChange={person => setAuthor({author: person})}
    />
}
```

Example of use with array as value
```jsx
import React from 'react'
import JivePicker from 'anrom-jive-osapi-picker'

export default function Picker({placesArray, setPlaces}){
    return <JivePicker
        value={placesArray}
        // function receives the whole new array, not a single item
        onChange={places => setPlaces({placesArray: places})}
    />
}
```
### API
#### Component propperties
property        | type          | default     | description
:---------------|:--------------|:------------|:-----------
**buttonTitle** | string        | "Add place" | Sets the add button title 
**contentType** | string        | "place"     | *Possible options:* "people", "content" <br> Defines the type of content that the picker will be handling.
**value**       | object/array  |-            | Current place/person/content item or the array of specified type. <br> If array given the selector will allow **multiple values**
**onChange**    | function      |-            | *arguments:* selected item (object). <br> Fires when the selection of an object is performed