Merge branch 'dev' into Add-Component-ListItemComments

Author: NishkalankBezawada

CHANGELOG.json

@@ -4,13 +4,24 @@
       "version": "3.16.0",
       "changes": {
         "new": [
+          "`ViewPicker`: new control ViewPicker [#1439](https://github.com/pnp/sp-dev-fx-controls-react/issues/1439)"
         ],
         "enhancements": [
+          "`FieldCollectionData`: render on page instead of panel and added combobox and peoplepicker controls [#1588](https://github.com/pnp/sp-dev-fx-controls-react/pull/1588)"
         ],
         "fixes": [
+          "`AccessibleAccordion`: fix typo in documentation [#1634](https://github.com/pnp/sp-dev-fx-controls-react/pull/1634)",
+          "`DynamicForm`: fix issue with MultiChoice field [#1510](https://github.com/pnp/sp-dev-fx-controls-react/issues/1510)",
+          "`Localization`: Update dutch translations [#1635](https://github.com/pnp/sp-dev-fx-controls-react/issues/1635)",
+          "`TaxonomyPicker`: suggested item contains double termset name [#1597](https://github.com/pnp/sp-dev-fx-controls-react/issues/1597)"
         ]
       },
       "contributions": [
+        "[Guido Zambarda](https://github.com/GuidoZam)",
+        "[Nils Andresen](https://github.com/nils-a)",
+        "[Nishkalank Bezawada](https://github.com/NishkalankBezawada)",
+        "[Rico van de Ven](https://github.com/RicoNL)",
+        "[wuxiaojun514](https://github.com/wuxiaojun514)",
       ]
     },
     {

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

@@ -30,11 +30,13 @@ Here is an example of the control in action inside a Web Part:
 * 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.
 
 * In your component file, import the `AdaptiveCardDesignerHost` control as follows:
+
 ```Typescript  
 import { AdaptiveCardDesignerHost, HostContainer, BindingPreviewMode, Versions } from "@pnp/spfx-controls-react/lib/AdaptiveCardDesignerHost";
 ```
 
 - Example on use the `AdaptiveCardDesignerHost` control with only required properties:
+
 ```Typescript
 <AdaptiveCardDesignerHost
   headerText="Adaptive Card Designer"
@@ -45,6 +47,7 @@ import { AdaptiveCardDesignerHost, HostContainer, BindingPreviewMode, Versions }
 ```
 
 - Example on use the `AdaptiveCardDesignerHost` control with all properties:
+
 ```Typescript
 <AdaptiveCardDesignerHost
   headerText="Adaptive Card Designer"
@@ -72,6 +75,7 @@ import { AdaptiveCardDesignerHost, HostContainer, BindingPreviewMode, Versions }
   snippets={snippets}
 />
 ```
+
 ## Implementation
 
 The `AdaptiveCardDesignerHost` control can be configured with the following properties:

docs/documentation/docs/assets/ViewPicker1.PNG

@@ -96,7 +96,7 @@ The `FieldCollectionData` control can be configured with the following propertie
 | saveAndAddBtnLabel | string | yes | Label of the save and add button. | |
 | cancelBtnLabel | string | yes | Label of the cancel button. | |
 | fields | ICustomCollectionField[] | yes | The fields to be used for the list of collection data. | |
-| value | string | yes | The collection data value. | |
+| value | any[] | yes | The collection data value. | |
 | enableSorting | boolean | no | Specify if you want to be able to sort the items in the collection. | false |
 | disabled | boolean | no | Specify if the control is disabled. | false |
 | disableItemCreation | boolean | no | Allows you to specify if user can create new items. | false |
@@ -106,6 +106,9 @@ The `FieldCollectionData` control can be configured with the following propertie
 | itemsPerPage | number | no | Allows you to specify the amount of items displayed per page. Paging control is added automatically. | |
 | executeFiltering | (searchFilter: string, item: any) => boolean | no | Allows you to show Search Box and specify own filtering logic. | |
 | panelProps | IPanelProps | no | Allows you to pass in props of the panel such as type and customWidth to control the underlying panel. | |
+| context | BaseComponentContext | no | Needed if **peoplepicker** field type is used | |
+| usePanel | boolean | no | Specify if you want the control to opened in a panel or directly on the page (only useful within webpart) | true | 
+| noDataMessage | string | no | Specify the message when no items are added to the collection ||
 
 Interface `ICustomCollectionField`
 
@@ -116,13 +119,18 @@ Interface `ICustomCollectionField`
 | type | CustomCollectionFieldType | yes | Specifies the type of field to render. |
 | disableEdit | boolean | no | Allows you to specify if a field is disabled for editing. |
 | required | boolean | no | Specify if the field is required. |
-| options | [IDropdownOption[]](https://developer.microsoft.com/en-us/fabric#/components/dropdown) | no | Dropdown options. Only necessary when dropdown type is used. |
+| options | [IDropdownOption[]](https://developer.microsoft.com/en-us/fabric#/components/dropdown) [IComboboxOption[]](https://developer.microsoft.com/en-us/fluentui#/controls/web/combobox) | no | Dropdown options. Only necessary when dropdown or combobox type is used. |
 | onRenderOption | IRenderFunction<ISelectableOption> | no | Dropdown custom options render method. Only for the **dropdown** field type. |
 | placeholder | string | no | Placehoder text which will be used for the input field. If not provided the input title will be used. |
 | defaultValue | any | no | Specify a default value for the input field. |
 | deferredValidationTime | number | no | Field will start to validate after users stop typing for `deferredValidationTime` milliseconds. Default: 200ms. |
 | onGetErrorMessage | (value: any, index: number, crntItem: any): string \| Promise<string> | no | The method is used to get the validation error message and determine whether the input value is valid or not. It provides you the current row index and the item you are currently editing. |
 | onCustomRender | (field: ICustomCollectionField, value: any, onUpdate: (fieldId: string, value: any) => void, item: any, itemUniqueId: string, onCustomFieldValidation: (fieldId: string, errorMessage: string) => void) => JSX.Element | no | This property is only required if you are using the `custom` field type and it can be used to specify the custom rendering of your control in the collection data. |
+| multiSelect | boolean| no | Specifies multiple options can be selected (**combobox**) or mutliple users can be selected (**peoplepicker**) |
+| allowFreeform | boolean | no | Specifies that own options can be entered. Only for **combobox** field type |
+| minimumUsers| number | no | Specifies the minimum number of users to be entered for **peoplepicker** field type |
+| minimumUsersMessage| string | no | Specifies the message to be displayed if minimumUsers are not entered for **peoplepicker** field type |
+| maximumUsers | number | no | Specifies the maximum number of users to be entered for **peoplepicker** field type |
 
 Enum `CustomCollectionFieldType`
 
@@ -132,8 +140,10 @@ Enum `CustomCollectionFieldType`
 | number | Number field |
 | boolean | Checkbox |
 | dropdown | Dropdown field. You will have to specify the `options` property when using this field type |
+| combobox | Combobox field. You wil have to specify the `options` property, optional specify `allowFreeform` and `multiSelect` |
 | fabricIcon | Name of the [Office UI Fabric icon](https://developer.microsoft.com/en-us/fabric#/styles/icons) |
 | url | URL field |
+| peoplepicker | Peoplepicker control |
 | custom | This gives you control over the whole field rendering. Be sure to provide the `onCustomRender` method to render your control in the collection data. |
 
 ![](https://telemetry.sharepointpnp.com/sp-dev-fx-property-controls/wiki/FieldCollectionData)

docs/documentation/docs/assets/ViewPicker2.png

@@ -0,0 +1,74 @@
+# ViewPicker control
+
+This control allows you to select available views from lists/libraries of the current site.
+
+Here is an example of the control:
+
+![ViewPicker initial](../assets/ViewPicker1.PNG)
+
+`ViewPicker` single selection mode:
+
+![ViewPicker single selection](../assets/ViewPicker2.png)
+
+`ViewPicker` multi selection mode:
+
+![ViewPicker multi selection](../assets/ViewPicker-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 { ViewPicker } from "@pnp/spfx-controls-react/lib/ViewPicker";
+```
+
+- Use the `ViewPicker` control in your code as follows:
+
+```TypeScript
+    <ViewPicker context={this.props.context}
+        listId={"9f3908cd-1e88-4ab3-ac42-08efbbd64ec9"}
+        placeholder={'Select list view(s)'}
+        orderBy={orderBy.Title}
+        multiSelect={true}
+        onSelectionChanged={this.onViewPickerChange} />
+```
+
+- The `onSelectionChanged` change event returns the selected view(s) and can be implemented as follows in your webpart:
+
+```TypeScript
+  private onViewPickerChange = (views: string | string[]) => {
+    console.log("Views:", views);
+  }
+```
+
+
+## Implementation
+
+The `ViewPicker` control can be configured with the following properties
+
+| Property | Type | Required | Description |
+| ---- | ---- | ---- | ---- |
+| context | BaseComponentContext | 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 view picker control is disabled. |
+| filter | string | no | Filter views from Odata query. |
+| label | string | no | Label to use for the control. |
+| listId | string | no | The List Id of the list. |
+| placeholder | string | no | Placeholder label to show in the dropdown. |
+| orderBy | Enum | no | How to order the set of views (By ID or Title). |
+| selectedView | string OR string[] | no | Keys(View Ids) 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`. |
+| showBlankOption | boolean | no | Whether or not to show a blank option. Default to `false`. |
+| viewsToExclude | string[] | no | Defines view titles which should be excluded from the view picker control. |
+| webAbsoulteUrl | string | no | Absolute Web Url of target site (user requires permissions) |
+| onSelectionChanged | (newValue: string OR string[]): void | no | Callback function when the selected option changes. |
+
+Enum `orderBy`
+
+| Value |
+| ---- |
+| Id |
+| Title |

docs/documentation/docs/controls/AdaptiveCardDesignerHost.md

@@ -61,7 +61,7 @@ telemetry.optOut();
 
 The following controls are currently available:
 
-- [AccessibleAccordion](./controls/AccessibleAccordion) (Control to render an accordion. React `AccessibleAccourdion`-based implementation)
+- [AccessibleAccordion](./controls/AccessibleAccordion) (Control to render an accordion. React `AccessibleAccordion`-based implementation)
 - [Accordion](./controls/Accordion) (Control to render an accordion)
 - [AdaptiveCardHost](./controls/AdaptiveCardHost.md) (Control to render Adaptive Cards)
 - [AdaptiveCardDesignerHost](./controls/AdaptiveCardDesignerHost.md) (Control to render Adaptive Cards Designer)

docs/documentation/docs/controls/FieldCollectionData.md

@@ -0,0 +1 @@
+export * from './controls/viewPicker/index';

docs/documentation/docs/controls/ViewPicker.md

@@ -206,3 +206,15 @@ export interface IUploadImageResult {
   ServerRelativeUrl: string;
   UniqueId: string;
 }
+
+export interface ISPView {
+    Id: string;
+    Title: string;
+}
+
+  /**
+ * Defines a collection of SharePoint list views
+ */
+export interface ISPViews {
+    value: ISPView[];
+}