Merge pull request SharePoint#8365 from shagra-ms/shagar/docs-update-august

Formatting docs update - August

Author: andrewconnell

docs/declarative-customization/column-formatting.md

@@ -1,7 +1,7 @@
 ---
 title: Use column formatting to customize SharePoint
 description: Customize how fields in SharePoint lists and libraries are displayed by constructing a JSON object that describes the elements that are displayed when a field is included in a list view, and the styles to be applied to those elements.
-ms.date: 06/28/2022
+ms.date: 08/12/2022
 ms.localizationpriority: high
 ---
 
@@ -707,6 +707,7 @@ The following column types support column formatting:
 * Average Rating
 * Likes
 * Approval Status
+* Attachments
 
 The following are currently **not** supported:
 

docs/declarative-customization/formatting-syntax-reference.md

@@ -1,7 +1,7 @@
 ---
 title: Formatting syntax reference
 description: Formatting syntax reference
-ms.date: 08/03/2022
+ms.date: 08/12/2022
 ms.localizationpriority: high
 ---
 
@@ -198,6 +198,12 @@ An optional property that specifies style attributes to apply to the element spe
 '--inline-editor-border-style'
 '--inline-editor-border-radius'
 '--inline-editor-border-color'
+
+'-webkit-line-clamp'
+
+'object-fit'
+'transform' // Only translate(arg) and translate(arg, arg) are currently supported
+
 ```
 
 The following example shows the value of a style object. In this example, two style properties (`padding` and `background-color`) will be applied. The `padding` value is a hard-coded string value. The `background-color` value is an Expression that is evaluated to either red (`#ff0000`) or green (`#00ff00`) depending on whether the value of the current field (specified by `@currentField`) is less than 40. For more information, see the Expression object section.
@@ -278,11 +284,11 @@ An optional property that is meant for debugging. It outputs error messages and
 
 ## forEach
 
-An optional property that allows an element to duplicate itself for each member of a specific multi-value field. The value of `"forEach"` property should be in the format of either `"iteratorName in @currentField"` or `"iteratorName in [$FieldName]"`.
+An optional property that allows an element to duplicate itself for each member of a specific multi-value field or an array. The value of `"forEach"` property should be in the format of either `"iteratorName in @currentField"` or `"iteratorName in [$FieldName]"` or `"iteratorName in Expression-Returning-An-Array"`.
 
 `iteratorName` represents the name of iterator variable that is used to represent the current member of the multi-value field. The name of the iterator can be any combination of alphanumeric characters and underscore (`_`) that does not start with a digit.
 
-The field used in the loop must be in a supported field type with multi-value option enabled: Person, Lookup, and Choice.
+The field used in the loop must be in a supported field type with multi-value option enabled: Person, Lookup, and Choice. An expression returning an array can also be used.
 
 In the element with `forEach` or its children elements, the iterator variable can be referred as if it is a new field. The index of the iterator can be accessed with `loopIndex` operator.
 
@@ -428,6 +434,8 @@ Values for `txtContent`, style properties, and attribute properties can be expre
 
 Expressions can be written using Excel-style expressions in SharePoint Online, or by using Abstract Syntax Tree expressions in SharePoint Online and SharePoint 2019.
 
+All fields in ViewFields can be referred in expresisons, even if it is marked `Explicit`.
+
 ### Excel-style expressions
 
 All Excel-style expressions begin with an equal (`=`) sign. This style of expression is only available in SharePoint Online (not SharePoint 2019).
@@ -544,13 +552,15 @@ Operators specify the type of operation to perform. The following operators are
 - startsWith
 - endsWith
 - replace
+- replaceAll
 - padStart
 - padEnd
 - getUserImage
 - addDays
 - addMinutes
 - appendTo
 - removeFrom
+- split
 
 **Binary arithmetic operators** - The following are the standard arithmetic binary operators that expect two operands:
 
@@ -645,6 +655,8 @@ Operators specify the type of operation to perform. The following operators are
 - **removeFrom**: returns an array with the given entry removed from the given array, if present
   - `"txtContent": "=removeFrom(@currentField, 'Choice 4')"` returns an array with 'Choice 4' removed from the @currentField array
   - `"txtContent": "=removeFrom(@currentField, '[email protected]')"` returns an array with '[email protected]' removed from the @currentField array
+- **split**: divides the given string into an ordered list of substrings by searching for the given pattern, and returns an array of these substrings
+  - `"txtContent": "=removeFrom('Hello World', ' ')"` returns an array with 2 strings - 'Hello' and 'World' 
 - **addDays**: returns a datetime object with days added (or deducted) from the given datetime value
   - `"txtContent": "=addDays(Date('11/14/2021'), 3)"` returns a 11/17/2021, 12:00:00 AM
   - `"txtContent": "=addDays(Date('11/14/2021'), -1)"` returns a 11/13/2021, 12:00:00 AM
@@ -666,6 +678,8 @@ Operators specify the type of operation to perform. The following operators are
   - `"txtContent":"=replace('Hello world', 'world', 'everyone')"` results in _Hello everyone_
   - `"txtContent":"=replace([$MultiChoiceField], 'Choice 1', 'Choice 2')"` returns an array replacing Choice 1 with Choice 2
   - `"txtContent":"=replace([$MultiUserField], @me, '[email protected]')"` returns an array replacing @me with '[email protected]'
+- **replaceAll**: searches a string for a specified value and returns a new string (or array) where the specified value is replaced. 
+  - `"txtContent":"=replaceAll('H-e-l-l-o W-o-r-l-d', '-', '')"` results in _Hello World_
 - **padStart**: pads the current string with another string until the resulting string reaches the given length. The padding is applied from the start of the current string.
   - `"txtContent":"=padStart('DogFood', 10, 'A')"` results in _AAADogFood_
   - `"txtContent":"=padStart('DogFood', 10, 'AB')"` results in _ABADogFood_
@@ -1149,3 +1163,15 @@ This also works with field name
   "txtContent": "[$FieldName.displayValue]"
 }
 ```
+
+### "@isSelected"
+
+This will evaluate to `true` for selected item(s) in a view and `false` otherwise.
+
+### "@lcid"
+
+This will evaluate to the LCID of current culture. This can be used to format the date, time and numbers.
+
+### "@UIlcid"
+
+This will evaluate to the LCID of current UI culture. This can be used to show localized display strings.

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

@@ -1,7 +1,7 @@
 ---
 title: Command bar customization syntax reference
 description: Command bar customization syntax reference
-ms.date: 06/28/2022
+ms.date: 08/12/2022
 ms.localizationpriority: high
 ---
 
@@ -74,6 +74,7 @@ Mandatory property to uniquely identify a command in the Command bar. Valid keys
 'exportCSV'
 'export'
 'editInGridView'
+'exitGridView'
 'sync'
 'uploadTemplate'
 'addTemplate'