Skip to content

Commit 718254f

Browse files
VesaJuvonenVesaJuvonen
committed
2 parents d64ce69 + 15d0c47 commit 718254f

23 files changed

+523
-41
lines changed

‎docs/community/repositories.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,7 @@ There are numerous SharePoint Developer GitHub repositories, which all have diff
2323
| [sp-dev-fx-webparts](https://github.com/SharePoint/sp-dev-fx-webparts) | Samples and tutorial code around SharePoint Framework client-side web parts |
2424
| [sp-dev-fx-extensions](https://github.com/SharePoint/sp-dev-fx-extensions) | Samples and tutorial code around SharePoint Framework extensions |
2525
| [sp-dev-solutions](https://github.com/SharePoint/sp-dev-solutions) | More polished and fine-tuned reusable solutions built with the SharePoint Framework |
26-
| [sp-dev-columnformatting](https://github.com/SharePoint/sp-dev-columnformatting) | Various [column formatting](https://docs.microsoft.com/en-us/sharepoint/dev/declarative-customization/column-formatting) json files shared among the community |
26+
| [sp-dev-list-formatting](https://github.com/SharePoint/sp-dev-list-formatting) | Various [column formatting](https://docs.microsoft.com/en-us/sharepoint/dev/declarative-customization/column-formatting) json files shared among the community |
2727
| [sp-dev-site-scripts](https://github.com/SharePoint/sp-dev-site-scripts) | Various [Site Script and Site Design](https://docs.microsoft.com/en-us/sharepoint/dev/declarative-customization/site-design-overview) json files shared among the community |
2828
| [sp-dev-fx-controls-react](https://github.com/SharePoint/sp-dev-fx-controls-react) | Reusable content controls for SharePoint Framework solutions built with React |
2929
| [sp-dev-fx-property-controls](https://github.com/SharePoint/sp-dev-fx-property-controls) | Reusable property pane controls for use in SharePoint Framework web parts |

‎docs/declarative-customization/column-formatting.md

Lines changed: 9 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1204,7 +1204,15 @@ This field can be used to display the current user's email address, but more lik
12041204

12051205
#### "@now"
12061206

1207-
This will evaluate to the current date and time.
1207+
This will evaluate to the current date and time.
1208+
1209+
#### "@window.innerHeight"
1210+
1211+
This will evaluate to a number equal to the height of the browser window (in pixels) when the list was rendered.
1212+
1213+
#### "@window.innerWidth"
1214+
1215+
This will evaluate to a number equal to the width of the browser window (in pixels) when the list was rendered.
12081216

12091217
## See also
12101218

‎docs/declarative-customization/view-formatting.md

Lines changed: 124 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -30,20 +30,125 @@ The easiest way to use view formatting is to start from an example and edit it t
3030

3131
You can use view formatting to apply a class to a list view row, depending on the value of one or more fields in the row. These examples leave the content and structure of list view rows intact.
3232

33+
Any conditional formatting scenario
34+
3335
For a list of recommended classes to use inside view formats, please see the [Style Guidelines section](https://github.com/SharePoint/sp-dev-docs/blob/master/docs/declarative-customization/column-formatting.md#style-guidelines) in the [Column Formatting reference document.](https://github.com/SharePoint/sp-dev-docs/blob/master/docs/declarative-customization/column-formatting.md)
3436

35-
### Conditional formatting based on a number range
37+
### Conditional formatting based on a date range
38+
39+
The following image shows a list view with conditional formatting applied based on a date range:
40+
41+
This example applies the class `sp-field-severity--severeWarning` to a list view row when the item's DueDate is before the current date/time.
42+
43+
```JSON
44+
{
45+
"additionalRowClass": {
46+
"operator": "?",
47+
"operands": [
48+
{
49+
"operator": "<=",
50+
"operands": [
51+
"[$DueDate]",
52+
"@now"
53+
]
54+
},
55+
"sp-field-severity--severeWarning",
56+
""
57+
]
58+
}
59+
}
60+
```
3661

3762
### Conditional formatting based on the value in a text or choice field
3863

64+
The following image shows a list view with conditional formatting applied based on the value inside a choice field:
65+
66+
This example was adopted from a column formatting example, [Conditional formatting based on the value in a text of choice field](https://github.com/ldemaris/sp-dev-docs/blob/patch-7/docs/declarative-customization/column-formatting.md#conditional-formatting-based-on-the-value-in-a-text-or-choice-field-advanced), with some important differences to apply the concept to list view rows. The column formatting example applies both an icon and a class to a column based on the value of `@currentField`. The `additionalRowClass` attribute in view formatting, however, only allows you to specify a class and not an icon. Additionally, since `@currentField` always resolves to the value of the Title field when referenced inside a view format, this sample refers to the `$Status` field directly to determine which class to apply to the row.
67+
68+
```JSON
69+
{
70+
"additionalRowClass": {
71+
"operator": "?",
72+
"operands": [
73+
{
74+
"operator": "==",
75+
"operands": [
76+
{
77+
"operator": "toString()",
78+
"operands": [
79+
"[$Status]"
80+
]
81+
},
82+
"Done"
83+
]
84+
},
85+
"sp-field-severity--good",
86+
{
87+
"operator": "?",
88+
"operands": [
89+
{
90+
"operator": "==",
91+
"operands": [
92+
{
93+
"operator": "toString()",
94+
"operands": [
95+
"[$Status]"
96+
]
97+
},
98+
"In progress"
99+
]
100+
},
101+
"sp-field-severity--low",
102+
{
103+
"operator": "?",
104+
"operands": [
105+
{
106+
"operator": "==",
107+
"operands": [
108+
{
109+
"operator": "toString()",
110+
"operands": [
111+
"[$Status]"
112+
]
113+
},
114+
"In review"
115+
]
116+
},
117+
"sp-field-severity--warning",
118+
{
119+
"operator": "?",
120+
"operands": [
121+
{
122+
"operator": "==",
123+
"operands": [
124+
{
125+
"operator": "toString()",
126+
"operands": [
127+
"[$Status]"
128+
]
129+
},
130+
"Blocked"
131+
]
132+
},
133+
"sp-field-severity--severeWarning",
134+
"sp-field-severity--blocked"
135+
]
136+
}
137+
]
138+
}
139+
]
140+
}
141+
]
142+
}
143+
}
144+
```
145+
39146
## Build custom row layouts
40147

41148
You can use view formatting to define a totally custom layout of field values inside a row.
42149

43150
### Multi-line view
44151

45-
### Multi-line view with an image
46-
47152
## Creating custom JSON
48153

49154
Creating custom view formatting JSON from scratch is simple if you understand the schema. To create your own custom column formatting:
@@ -67,18 +172,28 @@ Creating custom view formatting JSON from scratch is simple if you understand th
67172
68173
## Detailed syntax reference
69174

70-
### hideColumnHeader
175+
### rowFormatter
71176

72-
Optional element. Specifies whether the column headers in the view are hidden or not. *false* is the default behavior inside a list view. *true* means that the view will not display column headers.
177+
Optional element. Specifies a JSON object that describes a view format. The schema of this JSON object is identical to the schema of a column format. For details on this schema and its capabilities, see the [Column Format detailex syntax reference.](https://github.com/SharePoint/sp-dev-docs/blob/master/docs/declarative-customization/column-formatting.md#detailed-syntax-reference)
73178

74-
### hideSelection
179+
#### Differences in behavior between the rowFormatter element and column formatting
180+
181+
Despite sharing the same schema, there are some differences in behavior between elements inside a `rowFormatter` element and those same elements in a column formatting object.
75182

76-
Optional element. Specifies whether the ability to select rows in the view is diabled or not. *false* is the default behavior inside a list view. *true* means that users will not be able to select list items.
183+
* `@currentField` always resolves to the value of the Title field inside a `rowFormatter`.
77184

78185
### additionalRowClass
79186

80187
Optional element. Specifies a CSS class that is applied to the row.
81188

82-
### rowFormatter
189+
`additionalRowClass` only takes effect when there is no `rowFormatter` element specified. If a `rowFormatter` is specified, then `additionalRowClass` is ignored.
83190

84-
Optional element. Specifies a JSON object that describes a view format. The schema of this JSON object is identical to the schema of a column format. For details on this schema and its capabilities, see the [Column Format detailex syntax reference.](https://github.com/SharePoint/sp-dev-docs/blob/master/docs/declarative-customization/column-formatting.md#detailed-syntax-reference)
191+
### hideSelection
192+
193+
Optional element. Specifies whether the ability to select rows in the view is diabled or not. *false* is the default behavior inside a list view. *true* means that users will not be able to select list items.
194+
195+
`hideSelection` only takes effect when there's a `rowFormatter` element specified. If no `rowFormatter` is specified, then `hideSelection` is ignored.
196+
197+
### hideColumnHeader
198+
199+
Optional element. Specifies whether the column headers in the view are hidden or not. *false* is the default behavior inside a list view. *true* means that the view will not display column headers.

‎docs/features/hub-site/hub-site-overview.md

Lines changed: 0 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -6,9 +6,6 @@ ms.date: 4/20/2018
66

77
# SharePoint hub sites overview
88

9-
> [!IMPORTANT]
10-
> The SharePoint hub sites feature is currently in preview and is subject to change. It is not currently supported for use in production environments.
11-
129
SharePoint hub sites connect and organize sites based on organizational attributes such as project, department, division, or region. You can use PowerShell cmdlets or the SharePoint REST API to automate tasks such as creating, removing, or controlling permissions for hub sites.
1310

1411
For more information about SharePoint hub sites, see [What is a SharePoint hub site](https://go.microsoft.com/fwlink/?linkid=869149).

‎docs/scenario-guidance/Branding.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -150,7 +150,7 @@ Because Microsoft SharePoint is built on top of Microsoft ASP.NET, it supports m
150150
- [Master pages in the SharePoint Add-in model](https://docs.microsoft.com/en-us/sharepoint/dev/solution-guidance/master-pages-sharepoint-add-in)
151151
- [SharePoint Page Layouts and Master Pages (ECM)](https://msdn.microsoft.com/en-us/library/office/ms543497(v=office.14).aspx)
152152
- [Master Pages](https://msdn.microsoft.com/en-us/library/office/ms443795(v=office.14).aspx)
153-
- [Transformation guidance from farm solutions to add-in model - Replacement of files deployed via Modules (lab)](https://github.com/OfficeDev/TrainingContent/blob/master/O3658/10%20Transformation%20guidance%20from%20farm%20solutions%20to%20add-in%20model/10-1%20Replacement%20of%20files%20deployed%20via%20Modules/Lab.md)
153+
- [Transformation guidance from farm solutions to add-in model - Replacement of files deployed via Modules (lab)](https://github.com/OfficeDev/TrainingContent/tree/master/Archive/O3658/10%20Transformation%20guidance%20from%20farm%20solutions%20to%20add-in%20model)
154154
- [Branding SharePoint sites in the SharePoint Add-in model](https://docs.microsoft.com/en-us/sharepoint/dev/solution-guidance/branding-sharepoint-sites-sharepoint-add-in)
155155

156156
### Videos

‎docs/scenario-guidance/Long-running-scheduled-operations.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -72,7 +72,7 @@ In this pattern, the Azure WebJob handles the scheduling aspects associated with
7272
##### Samples
7373

7474
- [Core.SimpleTimerJob (O365 PnP Sample)](https://github.com/SharePoint/PnP/tree/master/Solutions/Core.TimerJobs.Samples)
75-
- [Using Remote Event Receivers and Remote Timer Jobs (training)](https://github.com/OfficeDev/TrainingContent/tree/master/O3658/05%20Using%20Remote%20Event%20Receivers%20and%20Remote%20Timer%20Jobs)
75+
- [Using Remote Event Receivers and Remote Timer Jobs (training)](https://github.com/OfficeDev/TrainingContent/tree/master/Archive/O3658/05%20Using%20Remote%20Event%20Receivers%20and%20Remote%20Timer%20Jobs)
7676
- [External Sharing Expiration Service](https://dev.office.com/patterns-and-practices-detail/1944)
7777
- [Sample Office 365 Application](https://dev.office.com/patterns-and-practices-detail/10980)
7878
- [Asynchronous operations with Azure storage queues and WebJobs](https://dev.office.com/patterns-and-practices-detail/2254)
@@ -105,7 +105,7 @@ The PnP timer job framework is a set of classes designed to ease the creation of
105105

106106
- [Core.SimpleTimerJob (O365 PnP Sample)](https://github.com/SharePoint/PnP/tree/master/Solutions/Core.TimerJobs.Samples)
107107
- [Transformation Tool - CSOM](https://github.com/SharePoint/PnP-Transformation/tree/master/Transformation%20Tool%20-%20CSOM)
108-
- [Using Remote Event Receivers and Remote Timer Jobs (training)](https://github.com/OfficeDev/TrainingContent/tree/master/O3658/05%20Using%20Remote%20Event%20Receivers%20and%20Remote%20Timer%20Jobs)
108+
- [Using Remote Event Receivers and Remote Timer Jobs (training)](https://github.com/OfficeDev/TrainingContent/tree/master/Archive/O3658/05%20Using%20Remote%20Event%20Receivers%20and%20Remote%20Timer%20Jobs)
109109

110110
### Windows scheduled tasks
111111

@@ -132,8 +132,8 @@ In this pattern, the Windows Scheduler handles the scheduling aspects associated
132132
##### Samples
133133

134134
- [Core.SimpleTimerJob (O365 PnP Sample)](https://github.com/SharePoint/PnP/tree/master/Samples/Core.SimpleTimerJob) - End-to-end article about this pattern with accompanying video.
135-
- [Using Remote Event Receivers and Remote Timer Jobs (training)](https://github.com/OfficeDev/TrainingContent/tree/master/O3658/05%20Using%20Remote%20Event%20Receivers%20and%20Remote%20Timer%20Jobs)
136-
- [Moving Full Trust Code to the Cloud](https://github.com/OfficeDev/TrainingContent/blob/master/O3651/O3651-4%20Moving%20Full%20Trust%20Code%20to%20the%20cloud%20using%20repeatable%20patterns%20and%20best%20practices/Lab.md)
135+
- [Using Remote Event Receivers and Remote Timer Jobs (training)](https://github.com/OfficeDev/TrainingContent/tree/master/Archive/O3658/05%20Using%20Remote%20Event%20Receivers%20and%20Remote%20Timer%20Jobs)
136+
- [Moving Full Trust Code to the Cloud](https://github.com/OfficeDev/TrainingContent/tree/master/Archive/O3651/O3651-4%20Moving%20Full%20Trust%20Code%20to%20the%20cloud%20using%20repeatable%20patterns%20and%20best%20practices)
137137

138138
### SharePoint TimerJobs
139139

@@ -151,4 +151,4 @@ A timer job is a trigger to start to run a specific Windows service for one of t
151151
##### Samples
152152

153153
- [Transformation Tool - CSOM](https://github.com/SharePoint/PnP-Transformation/tree/master/Transformation%20Tool%20-%20CSOM)
154-
- [Moving Full Trust Code to the Cloud](https://github.com/OfficeDev/TrainingContent/blob/master/O3651/O3651-4%20Moving%20Full%20Trust%20Code%20to%20the%20cloud%20using%20repeatable%20patterns%20and%20best%20practices/Lab.md)
154+
- [Moving Full Trust Code to the Cloud](hhttps://github.com/OfficeDev/TrainingContent/tree/master/Archive/O3651/O3651-4%20Moving%20Full%20Trust%20Code%20to%20the%20cloud%20using%20repeatable%20patterns%20and%20best%20practices)

‎docs/scenario-guidance/Security.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -31,7 +31,7 @@ _**Applies to:** Office 365 | SharePoint Server_
3131
- [Important aspects of the SharePoint Add-in architecture and development landscape](https://docs.microsoft.com/en-us/sharepoint/dev/sp-add-ins/important-aspects-of-the-sharepoint-add-in-architecture-and-development-landscap)
3232
- [Authorize provider-hosted add-in users at run time by using OAuth](https://docs.microsoft.com/en-us/sharepoint/dev/solution-guidance/authorize-provider-hosted-add-in-users-at-run-time-by-using-oauth)
3333
- [Build mobile apps for other platforms using SharePoint](https://docs.microsoft.com/en-us/sharepoint/dev/general-development/build-mobile-apps-for-other-platforms-using-sharepoint)
34-
- [Moving Full Trust Code to the Cloud](https://github.com/OfficeDev/TrainingContent/blob/master/O3651/O3651-4%20Moving%20Full%20Trust%20Code%20to%20the%20cloud%20using%20repeatable%20patterns%20and%20best%20practices/Lab.md)
34+
- [Moving Full Trust Code to the Cloud](https://github.com/OfficeDev/TrainingContent/tree/master/Archive/O3651/O3651-4%20Moving%20Full%20Trust%20Code%20to%20the%20cloud%20using%20repeatable%20patterns%20and%20best%20practices)
3535
- [A Series of Visual Studio Solutions to Accompany the MSDN Tutorial Series about Provider-hosted Add-ins](https://github.com/OfficeDev/SharePoint_Provider-hosted_Add-ins_Tutorials)
3636

3737
### Videos

‎docs/scenario-guidance/Transformation.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,7 @@ Typically, farm solutions are packaged as SharePoint solution package (WSP) file
2323

2424
### Articles
2525

26-
- [Advance SharePoint Add-in model development](https://github.com/OfficeDev/TrainingContent/tree/master/O3658)
26+
- [Advanced SharePoint Add-in model development](https://github.com/OfficeDev/TrainingContent/tree/master/Archive/O3658)
2727
- [Transform farm solutions to the SharePoint Add-in model](https://docs.microsoft.com/en-us/sharepoint/dev/solution-guidance/transform-farm-solutions-to-the-sharepoint-app-model)
2828
- [Work with __REQUESTDIGEST](https://docs.microsoft.com/en-us/sharepoint/dev/spfx/web-parts/basics/working-with-requestdigest)
2929
- [Transformation guidance from farm solutions to add-in model training module](https://github.com/OfficeDev/TrainingContent/tree/master/SharePoint/AddIns/14%20Transformation%20guidance%20from%20farm%20solutions%20to%20add-in%20model)

‎docs/scenario-guidance/User-information.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -49,7 +49,7 @@ In SharePoint, user profiles represent SharePoint users. User profile properties
4949
- [Get user identity and properties in SharePoint](https://docs.microsoft.com/en-us/sharepoint/dev/sp-add-ins/get-user-identity-and-properties-in-sharepoint)
5050
- [User segmentation in SharePoint](https://docs.microsoft.com/en-us/sharepoint/dev/general-development/user-segmentation-in-sharepoint)
5151
- [Pattern: Retrieving user data](https://github.com/SharePoint/PnP-Transformation/blob/master/InfoPath/Guidance/Patterns/Retrieving%20user%20data.md)
52-
- [User Personalization and OneDrive for Business Operations Using add-in model](https://github.com/OfficeDev/TrainingContent/tree/master/O3658/07%20User%20Personalization%20and%20OneDrive%20for%20Business%20Operations%20Using%20add-in%20model)
52+
- [User Personalization and OneDrive for Business Operations Using add-in model](https://github.com/OfficeDev/TrainingContent/tree/master/Archive/O3658/07%20User%20Personalization%20and%20OneDrive%20for%20Business%20Operations%20Using%20add-in%20model)
5353

5454
### Videos
5555

‎docs/solution-guidance/Document-library-templates-sample-app-for-SharePoint.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -293,5 +293,5 @@ After you create the document library, go to the **Library settings** on your do
293293

294294
## See also
295295

296-
- [ECM.Autotagging sample add-in](https://github.com/SharePoint/PnP/tree/master/Samples/ECM.Autotagging)
296+
- [ECM.Autotagging sample add-in](https://github.com/SharePoint/PnP/tree/master/Samples/ECM.AutoTagging)
297297
- [Enterprise Content Management solutions for SharePoint](enterprise-content-management-solutions-for-sharepoint.md)

0 commit comments

Comments
 (0)