Documentation updates for the listpicker

Author: estruyf

docs/documentation/docs/assets/ListPicker-initial.png

@@ -0,0 +1,71 @@
+# ListPicker control
+
+This control allows you to select one or multiple available lists/libraries of the current site.
+
+Here is an example of the control:
+
+![ListPicker initial](../assets/ListPicker-initial.png)
+
+`ListPicker` single selection mode:
+
+![ListPicker single selection](../assets/ListPicker-single.png)
+
+`ListPicker` multi-selection mode
+
+![ListPicker multi selection](../assets/ListPicker-multi.png)
+
+## How to use this control in your solutions
+
+- Check that you installed the `@pnp/spfx-controls-react` dependency. Check out the [getting started](../#getting-started) page for more information about installing the dependency.
+- Import the control into your component:
+
+```TypeScript
+import { ListPicker } from "@pnp/spfx-controls-react/lib/ListPicker";
+```
+
+- Use the `ListPicker` control in your code as follows:
+
+```TypeScript
+<ListPicker context={this.props.context}
+            label="Select your list(s)"
+            placeHolder="Select your list(s)"
+            baseTemplate={100}
+            includeHidden={false}
+            multiSelect={false}
+            onSelectionChanged={this.onListPickerChange} />
+```
+
+- The `onSelectionChanged` change event returns the list(s) and can be implemented as follows:
+
+```TypeScript
+private onListPickerChange (lists: string | string[]) {
+  console.log("Lists:", lists);
+}
+```
+
+## Implementation
+
+The `ListPicker` control can be configured with the following properties:
+
+| Property | Type | Required | Description |
+| ---- | ---- | ---- | ---- |
+| context | WebPartContext OR ApplicationCustomizerContext | yes | The context object of the SPFx loaded webpart or customizer. |
+| className | string | no | If provided, additional class name to provide on the dropdown element. |
+| disabled | boolean | no | Whether or not the control is disabled. |
+| baseTemplate | number | no | The SharePoint BaseTemplate ID to filter the list options by. |
+| includeHidden | boolean | no | Whether or not to include hidden lists. Default is `true`. |
+| orderBy | LibsOrderBy | no | How to order the lists retrieved from SharePoint. |
+| selectedList | string OR string[] | no | Keys of the selected item(s). If you provide this, you must maintain selection state by observing onSelectionChanged events and passing a new value in when changed. |
+| multiSelect | boolean | no | Optional mode indicates if multi-choice selections is allowed. Default to `false`. |
+| label | string | no | Label to use for the control. |
+| placeholder | string | no | Placeholder label to show in the dropdown. |
+| onSelectionChanged | (newValue: string OR string[]): void | no | Callback function when the selected option changes. |
+
+Enum `LibsOrderBy`
+
+| Value |
+| ---- |
+| Id |
+| Title |
+
+![](https://telemetry.sharepointpnp.com/sp-dev-fx-controls-react/wiki/controls/ListPicker)

docs/documentation/docs/assets/ListPicker-multi.png

@@ -1,6 +1,6 @@
 # Taxonomy Picker
 
-This control Allows you to select one or more Terms from a TermSet via its name or TermSet ID. You can also configure the control to select the child terms from a specific term in the TermSet by setting the AnchorId.
+This control allows you to select one or more Terms from a TermSet via its name or TermSet ID. You can also configure the control to select the child terms from a specific term in the TermSet by setting the AnchorId.
 
 !!! note "Disclaimer" 
     This control makes use of the `ProcessQuery` API end-points to retrieve the managed metadata information. This will get changed once the APIs for managing managed metadata will become available.

docs/documentation/docs/assets/ListPicker-single.png

@@ -3,6 +3,7 @@ pages:
   - Home: 'index.md'
   - Controls:
     - FileTypeIcon: 'controls/FileTypeIcon.md'
+    - ListPicker: 'controls/ListPicker.md'
     - ListView: 'controls/ListView.md'
     - "ListView: add a contextual menu": 'controls/ListView.ContextualMenu.md'
     - Placeholder: 'controls/Placeholder.md'