Skip to content

Commit a72229f

Browse files
AJIXuMuKAJIXuMuK
authored
Merge pull request #1863 from pnp/dev
Dev 3.19.0
2 parents bf61b7a + b889753 commit a72229f

36 files changed

+4997
-2617
lines changed

‎.editorconfig

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,7 @@ root = true
1010
# change these settings to your own preference
1111
indent_style = space
1212
indent_size = 2
13+
quote_type = single
1314

1415
# we recommend you to keep these unchanged
1516
end_of_line = lf

‎.yo-rc.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"@microsoft/generator-sharepoint": {
3-
"version": "1.18.2",
3+
"version": "1.19.0",
44
"libraryName": "sp-dev-fx-controls-react",
55
"libraryId": "92b1e52c-a5fa-490a-bcf4-76080f39442c",
66
"environment": "spo",

‎CHANGELOG.json

Lines changed: 28 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,33 @@
11
{
22
"versions": [
3+
{
4+
"version": "3.19.0",
5+
"changes": {
6+
"new": [],
7+
"enhancements": [
8+
"SharePoint Framework v1.19.0 support [#1857](https://github.com/pnp/sp-dev-fx-controls-react/pull/1857)",
9+
"`DynamicForm`: enable/disable save button [#1810](https://github.com/pnp/sp-dev-fx-controls-react/pull/1810)",
10+
"`PeoplePicker`: add new prop - `useSubstrateSearch` [#1819](https://github.com/pnp/sp-dev-fx-controls-react/pull/1819)",
11+
"`SitePicker`: add button to clear single / multiple selection [#1839](https://github.com/pnp/sp-dev-fx-controls-react/pull/1839)"
12+
],
13+
"fixes": [
14+
"`DynamicForm`: more than 100 lookups and date format in lookup field [#1722](https://github.com/pnp/sp-dev-fx-controls-react/pull/1722)",
15+
"`Richtext`: can not undo ordered lists [#1135](https://github.com/pnp/sp-dev-fx-controls-react/issues/1135)",
16+
"`FilePicker`: fixing organization tab browsing issue [#1861](https://github.com/pnp/sp-dev-fx-controls-react/pull/1861)",
17+
"`PeoplePicker`: method to clear the array [#1838](https://github.com/pnp/sp-dev-fx-controls-react/pull/1838)",
18+
"`SitePicker`: documentation patch [#1842](https://github.com/pnp/sp-dev-fx-controls-react/pull/1842)"
19+
]
20+
},
21+
"contributions": [
22+
"[Alex Terentiev](https://github.com/AJIXuMuK)",
23+
"[Antanina Druzhkina](https://github.com/Ateina)",
24+
"[Guido Zambarda](https://github.com/GuidoZam)",
25+
"[Luccas Castro](https://github.com/DevPio)",
26+
"[Michaël Maillot](https://github.com/michaelmaillot)",
27+
"[Niels Söth](https://github.com/nsoeth)",
28+
"[srpmtt](https://github.com/srpmtt)"
29+
]
30+
},
331
{
432
"version": "3.18.1",
533
"changes": {

‎CHANGELOG.md

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,26 @@
11
# Releases
22

3+
## 3.19.0
4+
5+
### Enhancements
6+
7+
- SharePoint Framework v1.19.0 support [#1857](https://github.com/pnp/sp-dev-fx-controls-react/pull/1857)
8+
- `DynamicForm`: enable/disable save button [#1810](https://github.com/pnp/sp-dev-fx-controls-react/pull/1810)
9+
- `PeoplePicker`: add new prop - `useSubstrateSearch` [#1819](https://github.com/pnp/sp-dev-fx-controls-react/pull/1819)
10+
- `SitePicker`: add button to clear single / multiple selection [#1839](https://github.com/pnp/sp-dev-fx-controls-react/pull/1839)
11+
12+
### Fixes
13+
14+
- `DynamicForm`: more than 100 lookups and date format in lookup field [#1722](https://github.com/pnp/sp-dev-fx-controls-react/pull/1722)
15+
- `Richtext`: can not undo ordered lists [#1135](https://github.com/pnp/sp-dev-fx-controls-react/issues/1135)
16+
- `FilePicker`: fixing organization tab browsing issue [#1861](https://github.com/pnp/sp-dev-fx-controls-react/pull/1861)
17+
- `PeoplePicker`: method to clear the array [#1838](https://github.com/pnp/sp-dev-fx-controls-react/pull/1838)
18+
- `SitePicker`: documentation patch [#1842](https://github.com/pnp/sp-dev-fx-controls-react/pull/1842)
19+
20+
### Contributors
21+
22+
Special thanks to our contributors (in alphabetical order): [Alex Terentiev](https://github.com/AJIXuMuK), [Antanina Druzhkina](https://github.com/Ateina), [Guido Zambarda](https://github.com/GuidoZam), [Luccas Castro](https://github.com/DevPio), [Michaël Maillot](https://github.com/michaelmaillot), [Niels Söth](https://github.com/nsoeth), [srpmtt](https://github.com/srpmtt).
23+
324
## 3.18.1
425

526
### Fixes

‎docs/documentation/docs/about/release-notes.md

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,26 @@
11
# Releases
22

3+
## 3.19.0
4+
5+
### Enhancements
6+
7+
- SharePoint Framework v1.19.0 support [#1857](https://github.com/pnp/sp-dev-fx-controls-react/pull/1857)
8+
- `DynamicForm`: enable/disable save button [#1810](https://github.com/pnp/sp-dev-fx-controls-react/pull/1810)
9+
- `PeoplePicker`: add new prop - `useSubstrateSearch` [#1819](https://github.com/pnp/sp-dev-fx-controls-react/pull/1819)
10+
- `SitePicker`: add button to clear single / multiple selection [#1839](https://github.com/pnp/sp-dev-fx-controls-react/pull/1839)
11+
12+
### Fixes
13+
14+
- `DynamicForm`: more than 100 lookups and date format in lookup field [#1722](https://github.com/pnp/sp-dev-fx-controls-react/pull/1722)
15+
- `Richtext`: can not undo ordered lists [#1135](https://github.com/pnp/sp-dev-fx-controls-react/issues/1135)
16+
- `FilePicker`: fixing organization tab browsing issue [#1861](https://github.com/pnp/sp-dev-fx-controls-react/pull/1861)
17+
- `PeoplePicker`: method to clear the array [#1838](https://github.com/pnp/sp-dev-fx-controls-react/pull/1838)
18+
- `SitePicker`: documentation patch [#1842](https://github.com/pnp/sp-dev-fx-controls-react/pull/1842)
19+
20+
### Contributors
21+
22+
Special thanks to our contributors (in alphabetical order): [Alex Terentiev](https://github.com/AJIXuMuK), [Antanina Druzhkina](https://github.com/Ateina), [Guido Zambarda](https://github.com/GuidoZam), [Luccas Castro](https://github.com/DevPio), [Michaël Maillot](https://github.com/michaelmaillot), [Niels Söth](https://github.com/nsoeth), [srpmtt](https://github.com/srpmtt).
23+
324
## 3.18.1
425

526
### Fixes

‎docs/documentation/docs/controls/DynamicForm.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -61,6 +61,7 @@ The `DynamicForm` can be configured with the following properties:
6161
| webAbsoluteUrl | string | no | Absolute Web Url of target site (user requires permissions). |
6262
| fieldOverrides | {[columnInternalName: string] : {(fieldProperties: IDynamicFieldProps): React.ReactElement\<IDynamicFieldProps\>}} | no | Key value pair for fields you want to override. Key is the internal field name, value is the function to be called for the custom element to render. |
6363
| respectEtag | boolean | no | Specifies if the form should respect the ETag of the item. Default - `true` |
64+
| saveDisabled | boolean | no | Specifies if save button is disabled. |
6465
| validationErrorDialogProps | IValidationErrorDialogProps | no | Specifies validation error dialog properties |
6566
| customIcons | { [ columnInternalName: string ]: string } | no | Specifies custom icons for the form. The key of this dictionary is the column internal name, the value is the Fluent UI icon name. |
6667

‎docs/documentation/docs/controls/HoverReactionsBar.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -37,27 +37,27 @@ import { HoverReactionsBar } from '@pnp/spfx-controls-react/lib/HoverReactionsBa
3737
- With the `onSelect` property you can get the selected emoji:
3838

3939
```typescript
40-
const onSelectEmoji = React.useCallback(async (emoji: string, emojiInfo: IEmojiInfo) => {
41-
console.log('emoji', emoji);
42-
console.log('emojiInfo object',emojiInfo);
43-
setIsOpenHoverReactionBar(false);
44-
}, []);
40+
const onSelectEmoji = React.useCallback(async (emoji: string, emojiInfo: IEmojiInfo) => {
41+
console.log('emoji', emoji);
42+
console.log('emojiInfo object',emojiInfo);
43+
setIsOpenHoverReactionBar(false);
44+
}, []);
4545

46-
```
4746
onSelect: (emoji: string | undefined, emojiInfo?: IEmojiInfo) => void;
4847
isOpen: boolean;
4948
onDismiss: () => void;
5049
top4Reactions?: string[];
5150
target: HTMLDivElement;
5251
themeV8?: Theme ;
52+
```
5353

5454
## Implementation
5555

5656
The HoverReactionsBar control can be configured with the following properties:
5757

5858
| Property | Type | Required | Description |
5959
| ---- | ---- | ---- | ---- |
60-
| isOpen | boolean | yes | show hoverReactionsVar |
60+
| isOpen | boolean | yes | show hoverReactionsBar |
6161
| onSelected |onSelect: (emoji: string, emojiInfo?: IEmojiInfo) => void;| yes | selected Emoji |
6262
| top4Reactions | string[] | no | name of emojis to show on the bar |
6363
| target | HTMLDivElement | yes | container of controls who fire the HoverReactionsBar |

‎docs/documentation/docs/controls/ListItemPicker.md

Lines changed: 23 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -18,6 +18,7 @@ Here is an example of the control:
1818
```TypeScript
1919
import { ListItemPicker } from '@pnp/spfx-controls-react/lib/ListItemPicker';
2020
```
21+
2122
- Use the `ListItemPicker` control in your code as follows:
2223

2324
```TypeScript
@@ -41,30 +42,31 @@ private onSelectedItem(data: { key: string; name: string }[]) {
4142
}
4243
}
4344
```
45+
4446
## Implementation
4547

4648
The `ListItemPicker` control can be configured with the following properties:
4749

48-
49-
| Property | Type | Required | Description |
50-
| ---- | ---- | ---- | ---- |
51-
| columnInternalName | string | yes | InternalName of column to search and get values. |
52-
| keyColumnInternalName | string | no | InternalName of column to use as the key for the selection. Must be a column with unique values. Default: Id |
53-
| context | BaseComponentContext | yes | SPFx web part or extention context |
54-
| listId | string | yes | Guid or title of the list. |
55-
| itemLimit | number | yes | Number of items which can be selected |
56-
| onSelectedItem | (items: any[]) => void | yes | Callback function which returns the selected items. |
57-
| className | string | no | ClassName for the picker. |
58-
| webUrl | string | no | URL of the site. By default it uses the current site URL. |
59-
| defaultSelectedItems | any[] | no | Initial items that have already been selected and should appear in the people picker. |
60-
| suggestionsHeaderText | string | no | The text that should appear at the top of the suggestion box. |
61-
| noResultsFoundText | string | no | The text that should appear when no results are returned. |
62-
| disabled | boolean | no | Specifies if the control is disabled or not. |
63-
| filter | string | no | condition to filter list Item, same as $filter ODATA parameter|
64-
| orderBy | string | no | condition to order by list Item, same as $orderby ODATA parameter|
65-
| placeholder | string | no | Short text hint to display in empty picker |
66-
| substringSearch | boolean | no | Specifies if substring search should be used |
67-
| label | string | no | Specifies the text describing the ListItemPicker. |
68-
| enableDefaultSuggestions | boolean | no | Enable default suggestions. All options are displayed by default when clicking on the control. |
50+
| Property | Type | Required | Description |
51+
| ------------------------ | ---------------------- | -------- | ------------------------------------------------------------------------------------------------------------ |
52+
| columnInternalName | string | yes | InternalName of column to search and get values. |
53+
| keyColumnInternalName | string | no | InternalName of column to use as the key for the selection. Must be a column with unique values. Default: Id |
54+
| context | BaseComponentContext | yes | SPFx web part or extention context |
55+
| listId | string | yes | Guid or title of the list. |
56+
| itemLimit | number | yes | Number of items which can be selected |
57+
| onSelectedItem | (items: any[]) => void | yes | Callback function which returns the selected items. |
58+
| className | string | no | ClassName for the picker. |
59+
| webUrl | string | no | URL of the site. By default it uses the current site URL. |
60+
| defaultSelectedItems | any[] | no | Initial items that have already been selected and should appear in the people picker. |
61+
| suggestionsHeaderText | string | no | The text that should appear at the top of the suggestion box. |
62+
| noResultsFoundText | string | no | The text that should appear when no results are returned. |
63+
| disabled | boolean | no | Specifies if the control is disabled or not. |
64+
| filter | string | no | condition to filter list Item, same as $filter ODATA parameter |
65+
| orderBy | string | no | condition to order by list Item, same as $orderby ODATA parameter |
66+
| placeholder | string | no | Short text hint to display in empty picker |
67+
| substringSearch | boolean | no | Specifies if substring search should be used |
68+
| label | string | no | Specifies the text describing the ListItemPicker. |
69+
| enableDefaultSuggestions | boolean | no | Enable default suggestions. All options are displayed by default when clicking on the control. |
70+
| itemsQueryCountLimit | number | no | Number of items to display in a lookup field |
6971

7072
![](https://telemetry.sharepointpnp.com/sp-dev-fx-controls-react/wiki/controls/ListItemPicker)

‎docs/documentation/docs/controls/PeoplePicker.md

Lines changed: 9 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ This control renders a People picker field which can be used to select one or mo
1313

1414
![Selecting People](../assets/Peoplepicker-selectingchoices.png)
1515

16-
**Selected people**
16+
**Selected people**
1717

1818
![Selected people](../assets/Peoplepicker-multiplechoices.png)
1919

@@ -58,6 +58,10 @@ private _getPeoplePickerItems(items: any[]) {
5858
}
5959
```
6060

61+
## Use Substrate search
62+
63+
Sometimes, depending on how your organization is configured regarding users and groups, performing search can be tricky. As the `PeoplePicker` is using the `SP.UI.ApplicationPages.ClientPeoplePickerWebServiceInterface.clientPeoplePickerSearchUser` endpoint under the hood, there is an optional parameter called `useSubstrateSearch`. Setting this to `true` will perform a search using the Microsoft 365 Substrate, which will go through centralized stored data in order to find requested info. More details about this feature can be found [here](https://techcommunity.microsoft.com/t5/video-hub/admin-39-s-guide-to-the-microsoft-365-substrate/ba-p/3633132) and [here](https://youtu.be/uuiTR8r27Os?si=JkPyfiQggvCMj0xg&t=467).
64+
6165
## Implementation
6266

6367
The People picker control can be configured with the following properties:
@@ -66,8 +70,8 @@ The People picker control can be configured with the following properties:
6670
| ---- | ---- | ---- | ---- | ---- |
6771
| context | IPeoplePickerContext | yes | Context of the component, based on the SPFx context ([*BaseComponentContext*](https://learn.microsoft.com/javascript/api/sp-component-base/basecomponentcontext?view=sp-typescript-latest)). | |
6872
| titleText | string | no | Text to be displayed on the control | |
69-
| groupName | string | no | Group from which users are fetched. Leave it blank if need to filter all users. When both groupName and groupId specified groupName takes precedence. | _none_ |
70-
| groupId | number \| string \| (string\|number)[] | no | Group from which users are fetched. Leave it blank if need to filter all users. When both groupId and groupName specified groupName takes precedence. If string is specified, Microsoft 365 Group is used. If array is used, fetch results from multiple groups | _none_ |
73+
| groupName | string | no | Group from which users are fetched. Leave it blank if need to filter all users. When both groupName and groupId specified groupName takes precedence. | *none* |
74+
| groupId | number \| string \| (string\|number)[] | no | Group from which users are fetched. Leave it blank if need to filter all users. When both groupId and groupName specified groupName takes precedence. If string is specified, Microsoft 365 Group is used. If array is used, fetch results from multiple groups | *none* |
7175
| personSelectionLimit | number | no | Defines the limit of people that can be selected in the control | 1 |
7276
| required | boolean | no | Set if the control is required or not | false |
7377
| disabled | boolean | no | Set if the control is disabled or not | false |
@@ -88,8 +92,9 @@ The People picker control can be configured with the following properties:
8892
| suggestionsLimit | number | no | Maximum number of suggestions to show in the full suggestion list. | 5 |
8993
| resolveDelay | number | no | Add delay to resolve and search users | 200 |
9094
| placeholder | string | no | Short text hint to display in empty picker | |
91-
| styles | Partial<IBasePickerStyles> | no | Styles to apply on control | |
95+
| styles | Partial&lt;IBasePickerStyles&gt; | no | Styles to apply on control | |
9296
| searchTextLimit | number | no | Specifies the minimum character count needed to begin retrieving search results. | 2 |
97+
| useSubstrateSearch | boolean | no | When `true`, performs a wider search using Microsoft 365 Substrate. | false |
9398

9499
Enum `PrincipalType`
95100

‎docs/documentation/docs/controls/SitePicker.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -52,7 +52,7 @@ The `SitePicker` control can be configured with the following properties:
5252
| isDesc | boolean | no | Specifies if the list is sorted in descending order. Default: `false`. |
5353
| label | string | no | Label to use for the control. |
5454
| limitToCurrentSiteCollection | boolean | no | Specifies if the options should be limited by the current site collections. Taken into consideration if selectionMode is set to `web`. |
55-
| mode | `'site' | 'web' | 'hub'` | no | Defines what entities are available for selection: site collections, sites, hub sites. Default: `web`. |
55+
| mode | `'associatedsites' | 'site' | 'web' | 'hub'` | no | Defines what entities are available for selection: site collections, sites, hub sites and sites inside hub. Default: `web`. |
5656
| multiSelect | boolean | no | Optional mode indicates if multi-choice selections is allowed. Default: `true`. |
5757
| onChange | `(selectedSites: ISite[]) => void` | yes | Selection change handler. |
5858
| orderBy | `'title' | 'url'` | no | Specifices if the list is sorted by title or url. Default: `title`. |

0 commit comments

Comments
 (0)