You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/spfx/debug-modern-pages.md
+11-11Lines changed: 11 additions & 11 deletions
Original file line number
Diff line number
Diff line change
@@ -96,7 +96,7 @@ To debug an Application Customizer, add the following to the URL of your modern
96
96
> Line breaks & indentation have been added to the following snippet for readability. The following text should be on a single line with no whitespace.
|`<extensionId>`| Use the GUID of the extension as the key to associate with the custom action. This has to match the ID value of your extension, which is available in the extension manifest.json file. |
134
+
|`<extensionId>`| Use the GUID of the extension as the key to associate with the custom action. This has to match the ID value of your extension, which is available in the extension `manifest.json` file. |
135
135
|`<extensionType>`| The type of custom action. Use `ClientSideExtension.ApplicationCustomizer` for the Application Customizer extension. |
136
-
|`<propertiesJSON>`| An optional JSON object that contains properties that are available via the this.properties member |
136
+
|`<propertiesJSON>`| An optional JSON object that contains properties that are available via the `this.properties` member.|
137
137
138
138
With the parameters added to the URL, reload the page in the web browser. The page will show a popup asking you to confirm that you now will be loading debug scripts.
139
139
@@ -180,7 +180,7 @@ Following are the query string parameters that you need to add:
|`loadSPFX=true`|Ensures that the SharePoint Framework is loaded on the page. For performance reasons, the framework doesn't load unless at least one extension is registered. Because no components are registered, you must explicitly load the framework. |
182
182
|`debugManifestsFile`|Specifies that you want to load components that are locally served. The loader only looks for components in the app catalog (for your deployed solution) and the SharePoint manifest server (for the system libraries). |
183
-
|`fieldCustomizers`|indicates which fields in your list should have their rendering controlled by the Field Customizer. The ID parameter specifies the GUID of the extension that should be used to control the rendering of the field. The properties parameter is an optional text string containing a JSON object that is deserialized into `this.properties` for your extension.|
183
+
|`fieldCustomizers`|Indicates which fields in your list should have their rendering controlled by the Field Customizer. The ID parameter specifies the GUID of the extension that should be used to control the rendering of the field. The properties parameter is an optional text string containing a JSON object that is deserialized into `this.properties` for your extension.|
184
184
185
185
The `fieldCustomizers` parameter has the following tokens that should be replaced:
186
186
@@ -204,7 +204,7 @@ To debug a list view command set, add the following to the URL of your modern pa
204
204
> Line breaks & indentation have been added to the following snippet for readability. The following text should be on a single line with no whitespace.
|`loadSPFX=true`| Ensures that the SharePoint Framework is loaded on the page. For performance reasons, the framework doesn't load unless at least one extension is registered. Because no components are registered, you must explicitly load the framework. |
235
235
|`debugManifestsFile`| Specifies that you want to load components that are locally served. The loader only looks for components in the app catalog (for your deployed solution) and the SharePoint manifest server (for the system libraries). |
236
-
|`customActions`|simulates a custom action. You can set many properties on this CustomAction object that affect the look, feel, and ___location of your button; we’ll cover them all later. |
236
+
|`customActions`|Simulates a custom action. You can set many properties on this CustomAction object that affect the look, feel, and ___location of your button; we'll cover them all later. |
237
237
238
238
The `customActions` parameter has the following tokens that should be replaced:
|`<extensionType>`| Where the commands are displayed. The possible values are:<br/> `ClientSideExtension.ListViewCommandSet.ContextMenu`: The context menu of the item(s),<br/> `ClientSideExtension.ListViewCommandSet.CommandBar`: The top command set menu in a list or library.<br/> `ClientSideExtension.ListViewCommandSet`: Both the context menu and the command bar (corresponds to `SPUserCustomAction.Location="CommandUI.Ribbon"`). |
244
-
|`<propertiesJSON>`| An optional JSON object containing properties that are available via the this.properties member. |
244
+
|`<propertiesJSON>`| An optional JSON object containing properties that are available via the `this.properties` member. |
245
245
246
246
With the parameters added to the URL, reload the page in the web browser. The page will show a popup asking you to confirm that you now will be loading debug scripts.
247
247
@@ -298,7 +298,7 @@ Using the SharePoint workbench, you can only test web parts from your solution.
298
298
299
299
## Debug SharePoint Framework web parts - an alternative approach
300
300
301
-
If you build your web part solution without the **--ship** argument as following
301
+
If you build your web part solution without the **--ship** argument as following:
302
302
303
303
```console
304
304
gulp bundle
@@ -307,13 +307,13 @@ gulp package-solution
307
307
308
308
the packages generated will reference the code from your local computer (https://localhost:4321). You can deploy the solution to the app catalog as you normally would.
309
309
310
-
You can then start your local server by running
310
+
You can then start your local server by running:
311
311
312
312
```console
313
313
gulp serve --nobrowser
314
314
```
315
315
316
-
Now you can go back to a SharePoint site where the solution has been deployed and add the web parts to any page, modern or classic, and the web part code will be loaded from your local development environment. You can debug your web parts just as you would if you ran 'gulp serve' and added your web part to the workbench.
316
+
Now you can go back to a SharePoint site where the solution has been deployed and add the web parts to any page, modern or classic, and the web part code will be loaded from your local development environment. You can debug your web parts just as you would if you ran `gulp serve` and added your web part to the workbench.
317
317
318
318
This approach should only be used when you're in development mode. If you deploy an app to the app catalog that points to your local host, it will fail to run if your development environment isn't running.
0 commit comments