Skip to content

Commit 0697611

Browse files
Fix typos in formatting-syntax-reference and form-customizer docs (#10474)
* Fix typos in formatting-syntax-reference and form-customizer docs * Fix HTML tag warning * grammatical and markdown fixes - `id` is a property, so it should be formatted as code - fixed other grammatical issues throughout doc - update timestamp --------- Co-authored-by: Andrew Connell <[email protected]>
1 parent e0c1064 commit 0697611

File tree

2 files changed

+22
-22
lines changed

2 files changed

+22
-22
lines changed

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

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -381,8 +381,8 @@ See [Formatting multi-value fields](column-formatting.md#formatting-multi-value-
381381

382382
> [!NOTE]
383383
>
384-
> - The `src` needs to be just the `url` part of an embeddable code generated by an app (usually found in the `src` attribute of the `iframe` element).
385-
> - This action is only available in the newer version of the Microsoft Lists App.
384+
> - The src can be the URL part of an embed code generated by an app (usually the src of an iframe) or any valid URL that returns embeddable HTML content, such as a SharePoint list item display form (DispForm.aspx?ID=`<ItemID>`).
385+
> - This action is available in the newer version of the Microsoft Lists App and Document Library.
386386

387387
For more information about allowing or restricting domains, see [Allow or restrict the ability to embed content on SharePoint Lists using custom formatters](https://go.microsoft.com/fwlink/p/?linkid=2258033).
388388

docs/spfx/extensions/get-started/building-form-customizer.md

Lines changed: 20 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,16 @@
11
---
22
title: Build your first Form customizer extension
3-
description: Form customizers are SharePoint Framework components giving you an option to override the form experience in a list or library level by associating the component to the used content type.
4-
ms.date: 12/14/2023
3+
description: Form customizers are SharePoint Framework components giving you an option to override the form experience at a list or library level by associating the component with the used content type.
4+
ms.date: 11/14/2025
55
ms.custom: scenarios:getting-started
66
---
77

88
# Build your first Form Customizer extension
99

10-
Form customizers are SharePoint Framework components giving you an option to override the form experience in a list or library level by associating the component to the used content type. Form customizer components can be used in SharePoint Online, and you build them using modern JavaScript tools and libraries.
10+
Form customizers are SharePoint Framework components that give you an option to override the form experience at a list or library level by associating the component with the used content type. Form customizer components can be used in SharePoint Online, and you build them using modern JavaScript tools and libraries.
1111

1212
>[!Important]
13-
> Form customizer were released as part of the SharePoint Framework 1.15, so ensure that you are using the right version in your environment. See [v1.15 release notes](../../release-1.15.md) for details.
13+
> Form customizers were released as part of the SharePoint Framework v1.15, so ensure that you are using the right version in your environment. See [v1.15 release notes](../../release-1.15.md) for details.
1414
1515
> [!TIP]
1616
> You can find the output from this tutorial from [GitHub](https://github.com/pnp/spfx-reference-scenarios/tree/main/samples/spfx-formcustomizer-basics).
@@ -56,7 +56,7 @@ Form customizers are SharePoint Framework components giving you an option to ove
5656

5757
1. Open the **./src/extensions/helloWorld/HelloWorldFormCustomizer.manifest.json** file.
5858

59-
This file defines your extension type and a unique identifier `id` for your extension which can be used to set to be used in content type level for enabling a custom rendering with this component.
59+
This file defines your extension type and a unique identifier (`id`) for your extension. The `id` is used to associate the form customizer with a content type, enabling custom form rendering for that content type.
6060

6161
## Code your Form Customizer
6262

@@ -74,7 +74,7 @@ import {
7474
The logic for your Form Customizer is contained in the `onInit()`, `render()`, and `onDispose()` methods.
7575

7676
- `onInit()` is where you'll execute the setup needed for your extension. This event occurs after `this.context` and `this.properties` are assigned, but before the page DOM is ready. As with web parts, `onInit()` returns a promise that you can use to do asynchronous operations; `render()` isn't called until your promise has resolved. If you don’t need that, simply return `Promise.resolve<void>();`.
77-
- `render()` occurs when component is rendered. It provides an `event.domElement` HTML element where your code can write its content.
77+
- `render()` occurs when the component is rendered. It provides an `event.domElement` HTML element where your code can write its content.
7878
- `onDispose()` occurs immediately before the form host element is deleted. It can be used to free any resources that were allocated during form rendering. For example, if `render()` mounted a React element, `onDispose()` must be used to free it; otherwise, a resource leak would occur.
7979

8080
The following are the contents of `render()` and `onDispose()` in the default solution:
@@ -91,7 +91,7 @@ The following are the contents of `render()` and `onDispose()` in the default so
9191
}
9292
```
9393

94-
As by default the form customzier component does not render any information, let's update the render method as follows.
94+
By default, the form customizer component does not render any information. Let's update the render method as follows.
9595

9696
```typescript
9797
public render(): void {
@@ -105,7 +105,7 @@ As by default the form customzier component does not render any information, let
105105

106106
You can test and debug your Form Customizer within a live SharePoint Online site. You do not need to deploy your customizations to the tenant app catalog to do this, which makes the debugging experience simple and efficient.
107107

108-
1. To test your extension, you'll need to first create list to test the customizer in. So move to the site in your SharePoint Online tenant where you want to test the form customizer.
108+
1. To test your extension, you'll need to first create a list to test the customizer in. So move to the site in your SharePoint Online tenant where you want to test the form customizer.
109109
1. On the toolbar, select **New**, and then select **List**.
110110

111111
![Creating a new list](../../../images/ext-forcustomizer-create-new-list.png)
@@ -120,7 +120,7 @@ You can test and debug your Form Customizer within a live SharePoint Online site
120120

121121
1. Within Visual Studio Code, open the **./config/serve.json** file.
122122

123-
Update the `pageUrl` attributes to match a URL of the list which we created in the preview steps. After the changes, your **serve.json** should look like the following code:
123+
Update the `pageUrl` attributes to match the URL of the list that we created in the preview steps. After the changes, your **serve.json** should look like the following code:
124124

125125
```json
126126
{
@@ -140,11 +140,11 @@ You can test and debug your Form Customizer within a live SharePoint Online site
140140
}
141141
```
142142

143-
Let's call out few specific topics from serve.json file
143+
Let's call out a few specific topics from the **serve.json** file
144144

145-
- You can see multiple different configurations which can be used to debug new, edit and view forms with specific query parameter differences. You can define the used configuration in your gulp serve command, for example as `gulp serve --config=helloWorld_EditForm`
145+
- You can see multiple different configurations that can be used to debug new, edit, and view forms with specific query parameter differences. You can define the used configuration in your gulp serve command, for example, as `gulp serve --config=helloWorld_EditForm`
146146
- componentId is automatically associated to be the first list formatting component in your solution (if you have multiple components)
147-
- To simplify the debugging, you do not need to define target content type id to which the component is associated, but in the runtime the association is performed in content type level by updating at least one of the following properties in the content type:
147+
- To simplify the debugging, you do not need to define the target content type `id` to which the component is associated, but in the runtime, the association is performed in the content type level by updating at least one of the following properties in the content type:
148148
- ContentType.**NewFormClientSideComponentId** - component id for new form
149149
- ContentType.**NewFormClientSideComponentProperties** - optional configuration details
150150
- ContentType.**DispFormClientSideComponentId** - component id for edit form
@@ -168,13 +168,13 @@ You can test and debug your Form Customizer within a live SharePoint Online site
168168

169169
![Accept loading debug scripts](../../../images/ext-forcustomizer-accept-debug-scripts.png)
170170

171-
Notice how the the custom component is rendered in the page based on the custom content which we updated to the render method.
171+
Notice how the custom component is rendered in the page based on the custom content, which we updated to the render method.
172172

173173
![List view with from customizer rendered with default outpu](../../../images/ext-forcustomizer-default-output.png)
174174

175175
## Add form item editing capabilities to the sample
176176

177-
Now that we have created the baseline component and tested that it works properly. We will be creating a separate rendering logic for display, edit and new forms and to support saving new items to the list.
177+
Now that we have created the baseline component and tested that it works properly. We will be creating a separate rendering logic for display, edit, and new form,s and to support saving new items to the list.
178178

179179
1. Open the **./src/extensions/helloWorld/loc/myStrings.d.ts** file, and add new **Title** to the **IHelloWorldFormCustomizerStrings** interface . Interface should be as follows after your edits..
180180

@@ -273,7 +273,7 @@ Now that we have created the baseline component and tested that it works properl
273273
}
274274
```
275275

276-
1. Update the **render()** method as follows. Render the form either in display only or in the edit mode, depending on the display mode of the form. In this case we use the same renderig for new and edit experience, but you could easily have dedicated option if needed.
276+
1. Update the **render()** method as follows. Render the form either in display-only or in edit mode, depending on the display mode of the form. In this case, we use the same rendering for new and edit experience, but you could easily have a dedicated option if needed.
277277

278278
```typescript
279279
public render(): void {
@@ -382,16 +382,16 @@ Now that we have created the baseline component and tested that it works properl
382382
}
383383
```
384384

385-
Now the code is complete to support minimal New, Edit and Display experiences and you can test out the different experiences using different configurations for debugging.
385+
Now the code is complete to support minimal New, Edit, and Display experiences, and you can test out the different experiences using different configurations for debugging.
386386

387387
![Custom form in the context of SharePoint](../../../images/ext-forcustomizer-custom-form.png)
388388

389389
## Deployment of your extension
390390

391-
Whenever you are ready to start using your component, there are few steps to consider related on the component association to the content type. Steps for deployment are as follows:
391+
Whenever you are ready to start using your component, there are a few steps to consider related to the component's association with the content type. Steps for deployment are as follows:
392392

393393
1. Deploy solution to SharePoint App Catalog
394-
1. Install solution to the site collection where you want to use the extension if you are not using the tenant scoped deployment
395-
1. Associate the custom component to the content type using the specific properties in ContentType object. There are few options to do this:
394+
1. Install the solution to the site collection where you want to use the extension if you are not using the tenant-scoped deployment
395+
1. Associate the custom component to the content type using the specific properties in `ContentType` object. There are a few options to do this:
396396
1. You can provision the used list and content type from your solution if you are using site scoped deployment option
397-
1. You can associate the component to content types using REST or CSOM APIs. Notice that if you associate the component in the site collection or in the content type hub level, it's automatically inherited to all new content type instances
397+
1. You can associate the component with content types using REST or CSOM APIs. Notice that if you associate the component in the site collection or in the content type hub level, it's automatically inherited to all new content type instances

0 commit comments

Comments
 (0)