Skip to content

Commit 6d7c0a6

Browse files
authored
New article: "Performance best practices for WebView2 apps" (#3684)
* match draft doc * structural edit * Clean up headings * title, update local toc * tool notes * flatten tools * concat sentences * perf tool png * devtools for wv2 app * linkfix * not parens * parabrk * see also link * inc some comments * inc cmts 2 * 3 * top nav section * clean top nav * not see also in h2 * webpage website no space * apply more cmts * add links * linkfix * 4 answers * 2 cmts incorp * linkfix
1 parent 0e72ba2 commit 6d7c0a6

48 files changed

Lines changed: 638 additions & 83 deletions

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

microsoft-edge/accessibility/build/aria-and-ui-automation.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ The W3C defines Accessible Rich Internet Applications (ARIA) as a syntax for mak
1515

1616
Visit [HTML5Accessibility](https://html5accessibility.com) for information on which new HTML5 features are accessibly supported by Microsoft Edge.
1717

18-
The Microsoft Edge rendering engine builds an accessible projection of web pages, conforming to the following W3C specifications.
18+
The Microsoft Edge rendering engine builds an accessible projection of webpages, conforming to the following W3C specifications.
1919

2020

2121
<!-- ====================================================================== -->

microsoft-edge/accessibility/build/index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -225,7 +225,7 @@ This W3C mapping document explains how the semantics of web content languages ar
225225
<!-- ------------------------------ -->
226226
#### Easy Checks – A First Review of Web Accessibility
227227

228-
A series of quick checks by the WAI that help you assess the accessibility of a web page. For more information, go to [Easy Checks – A First Review of Web Accessibility](https://www.w3.org/WAI/eval/preliminary.html).
228+
A series of quick checks by the WAI that help you assess the accessibility of a webpage. For more information, go to [Easy Checks – A First Review of Web Accessibility](https://www.w3.org/WAI/eval/preliminary.html).
229229

230230

231231
<!-- ------------------------------ -->

microsoft-edge/accessibility/test.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -72,6 +72,6 @@ You can also use the assessment feature of [Accessibility Insights](https://acce
7272

7373
* [Accessibility Evaluation Resources](https://www.w3.org/WAI/eval/Overview.html) - Approaches for evaluating websites for accessibility.
7474

75-
* [Easy Checks – A First Review of Web Accessibility](https://www.w3.org/WAI/eval/preliminary.html) - Quick checks that help you assess the accessibility of a web page.
75+
* [Easy Checks – A First Review of Web Accessibility](https://www.w3.org/WAI/eval/preliminary.html) - Quick checks that help you assess the accessibility of a webpage.
7676

7777
* [How to Meet WCAG 2.0](https://www.w3.org/WAI/WCAG20/quickref) - A quick reference to Web Content Accessibility Guidelines (WCAG), requirements, success criteria, and techniques.

microsoft-edge/devtools/about-tools.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -64,7 +64,7 @@ There's also a **More tools** (![More Tools icon](./about-tools-images/more-tool
6464

6565
| Tool | Purpose | Article |
6666
| --- | --- | --- |
67-
| **3D View** | Explore the web page translated into a 3D perspective. Debug your webpage by navigating through the DOM or z-index stacking context. | [Navigate webpage layers, z-index, and DOM using the 3D View tool](3d-view/index.md) |
67+
| **3D View** | Explore the webpage translated into a 3D perspective. Debug your webpage by navigating through the DOM or z-index stacking context. | [Navigate webpage layers, z-index, and DOM using the 3D View tool](3d-view/index.md) |
6868
| **Animations** | Inspect and modify CSS animation effects by using the **Animation Inspector** in the **Animations** tool. | [Inspect and modify CSS animation effects](inspect-styles/animations.md) |
6969
| **Changes** | Tracks any changes you've made to CSS or JavaScript in DevTools. Shows you what changes to make to your actual source files after you use DevTools to modify your webpage files sent from the server. | [Track changes to files using the Changes tool](changes/changes-tool.md) |
7070
| **Coverage** | Help you find unused JavaScript and CSS code, to speed up your page load and save your mobile users cellular data. | [Find unused JavaScript and CSS code with the Coverage tool](coverage/index.md) |

microsoft-edge/devtools/accessibility/reference.md

Lines changed: 17 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ This article lists typical accessibility aspects to test for webpages, and the c
1818

1919
| Accessibility aspect to check | Feature of DevTools | Article |
2020
|---|---|---|
21-
| Verify that images have alt text | **Issues** tool > **Accessibility** section of report | [Verify that images have alt text](test-issues-tool.md#verify-that-images-have-alt-text) in _Automatically test a webpage for accessibility issues_ |
21+
| Verify that images have alt text | **Issues** tool > **Accessibility** section of report | [Verify that images have alt text](./test-issues-tool.md#verify-that-images-have-alt-text) in _Automatically test a webpage for accessibility issues_ |
2222
| Verify that images have alt text | **Lighthouse** tool > Issues about alt-text | [Test accessibility using Lighthouse](../accessibility/lighthouse.md) |
2323

2424

@@ -27,11 +27,11 @@ This article lists typical accessibility aspects to test for webpages, and the c
2727

2828
| Accessibility aspect to check | Feature of DevTools | Article |
2929
|---|---|---|
30-
| Verify keyboard support | **Inspect** tool > **Accessibility** section of overlay | [Use the Inspect tool to detect accessibility issues by hovering over the webpage](test-inspect-tool.md) and [Analyze HTML pages using the Inspect tool](../css/inspect.md) |
31-
| Verify keyboard support | **Tab**, **Shift+Tab**, and **Enter** keys | [Check for keyboard support by using the Tab and Enter keys](test-tab-enter-keys.md) |
32-
| Verify keyboard support: verify that focus is indicated | **Inspect** tool, **Styles** tab, and **Sources** tool | [Analyze the lack of indication of keyboard focus](test-analyze-no-focus-indicator.md) |
33-
| Verify keyboard support: verify that form buttons can be used with the keyboard | **Inspect** tool, **DOM tree** in the **Elements** tool, and **Event Listeners** tab | [Analyze the lack of keyboard support in a form](test-analyze-no-keyboard-support.md) |
34-
| Verify keyboard support: verify **Tab** key order | **Elements** tool > **Accessibility** tab > **Source Order Viewer** | [Test keyboard support using the Source Order Viewer](test-tab-key-source-order-viewer.md) |
30+
| Verify keyboard support | **Inspect** tool > **Accessibility** section of overlay | [Use the Inspect tool to detect accessibility issues by hovering over the webpage](./test-inspect-tool.md) and [Analyze HTML pages using the Inspect tool](../css/inspect.md) |
31+
| Verify keyboard support | **Tab**, **Shift+Tab**, and **Enter** keys | [Check for keyboard support by using the Tab and Enter keys](./test-tab-enter-keys.md) |
32+
| Verify keyboard support: verify that focus is indicated | **Inspect** tool, **Styles** tab, and **Sources** tool | [Analyze the lack of indication of keyboard focus](./test-analyze-no-focus-indicator.md) |
33+
| Verify keyboard support: verify that form buttons can be used with the keyboard | **Inspect** tool, **DOM tree** in the **Elements** tool, and **Event Listeners** tab | [Analyze the lack of keyboard support in a form](./test-analyze-no-keyboard-support.md) |
34+
| Verify keyboard support: verify **Tab** key order | **Elements** tool > **Accessibility** tab > **Source Order Viewer** | [Test keyboard support using the Source Order Viewer](./test-tab-key-source-order-viewer.md) |
3535
| Verify keyboard support | **Lighthouse** tool > Issues about keyboard support | [Test accessibility using Lighthouse](../accessibility/lighthouse.md) |
3636

3737

@@ -40,11 +40,11 @@ This article lists typical accessibility aspects to test for webpages, and the c
4040

4141
| Accessibility aspect to check | Feature of DevTools | Article |
4242
|---|---|---|
43-
| Verify that text has enough contrast (automatically, for the entire page) | **Issues** tool > **Accessibility** section of report | [Verify that text colors have enough contrast](test-issues-tool.md#verify-that-text-colors-have-enough-contrast) in _Automatically test a webpage for accessibility issues_ |
44-
| Verify that text has enough contrast | **Elements** tool > **Styles** tab > **Color Picker** | [Test text-color contrast using the Color Picker](color-picker.md) |
45-
| Verify that text has enough contrast | **Inspect** tool > **Accessibility** section of overlay > **Contrast** row | [Use the Inspect tool to detect accessibility issues by hovering over the webpage](test-inspect-tool.md) and [Analyze HTML pages using the Inspect tool](../css/inspect.md) |
46-
| Verify that text has enough contrast: in the hover state | **Elements** tool > **Styles** tab > **Toggle Element State** (shows **Force element state** checkboxes) | [Verify accessibility of all states of elements](test-inspect-states.md) |
47-
| Verify that text has enough contrast: with dark theme (dark mode) and light theme | **Rendering** tool > **Emulate CSS media feature prefers-color-scheme** | [Check for contrast issues with dark theme and light theme](test-dark-mode.md) |
43+
| Verify that text has enough contrast (automatically, for the entire page) | **Issues** tool > **Accessibility** section of report | [Verify that text colors have enough contrast](./test-issues-tool.md#verify-that-text-colors-have-enough-contrast) in _Automatically test a webpage for accessibility issues_ |
44+
| Verify that text has enough contrast | **Elements** tool > **Styles** tab > **Color Picker** | [Test text-color contrast using the Color Picker](./color-picker.md) |
45+
| Verify that text has enough contrast | **Inspect** tool > **Accessibility** section of overlay > **Contrast** row | [Use the Inspect tool to detect accessibility issues by hovering over the webpage](./test-inspect-tool.md) and [Analyze HTML pages using the Inspect tool](../css/inspect.md) |
46+
| Verify that text has enough contrast: in the hover state | **Elements** tool > **Styles** tab > **Toggle Element State** (shows **Force element state** checkboxes) | [Verify accessibility of all states of elements](./test-inspect-states.md) |
47+
| Verify that text has enough contrast: with dark theme (dark mode) and light theme | **Rendering** tool > **Emulate CSS media feature prefers-color-scheme** | [Check for contrast issues with dark theme and light theme](./test-dark-mode.md) |
4848
| Verify that text has enough contrast (automatically, for the entire page) | **Lighthouse** tool > Issues about text contrast | [Test accessibility using Lighthouse](../accessibility/lighthouse.md) |
4949

5050

@@ -53,9 +53,9 @@ This article lists typical accessibility aspects to test for webpages, and the c
5353

5454
| Accessibility aspect to check | Feature of DevTools | Article |
5555
|---|---|---|
56-
| Verify screen reader support: Verify that input fields have labels | **Issues** tool > **Accessibility** section of report | [Verify that input fields have labels](test-issues-tool.md#verify-that-input-fields-have-labels) in _Automatically test a webpage for accessibility issues_ |
57-
| Verify screen reader support | **Inspect** tool > **Accessibility** section of overlay > **Name** and **Role** | [Use the Inspect tool to detect accessibility issues by hovering over the webpage](test-inspect-tool.md) and [Analyze HTML pages using the Inspect tool](../css/inspect.md) |
58-
| Verify screen reader support | **Elements** tool > **Accessibility** tab > **Accessibility Tree** | [Check the Accessibility Tree for keyboard and screen reader support](test-accessibility-tree.md), and [Test accessibility using the Accessibility tab](accessibility-tab.md) |
56+
| Verify screen reader support: Verify that input fields have labels | **Issues** tool > **Accessibility** section of report | [Verify that input fields have labels](./test-issues-tool.md#verify-that-input-fields-have-labels) in _Automatically test a webpage for accessibility issues_ |
57+
| Verify screen reader support | **Inspect** tool > **Accessibility** section of overlay > **Name** and **Role** | [Use the Inspect tool to detect accessibility issues by hovering over the webpage](./test-inspect-tool.md) and [Analyze HTML pages using the Inspect tool](../css/inspect.md) |
58+
| Verify screen reader support | **Elements** tool > **Accessibility** tab > **Accessibility Tree** | [Check the Accessibility Tree for keyboard and screen reader support](./test-accessibility-tree.md), and [Test accessibility using the Accessibility tab](./accessibility-tab.md) |
5959
| Verify screen reader support | **Lighthouse** tool > Issues about screen reader support | [Test accessibility using Lighthouse](../accessibility/lighthouse.md) |
6060

6161

@@ -64,9 +64,9 @@ This article lists typical accessibility aspects to test for webpages, and the c
6464

6565
| Accessibility aspect to check | Feature of DevTools | Article |
6666
|---|---|---|
67-
| Verify that the webpage is usable by people with color blindness | **Rendering** tool > **Emulate vision deficiencies** dropdown list | [Verify that a page is usable by people with color blindness](test-color-blindness.md) |
68-
| Verify that the webpage is usable with blurred vision | **Rendering** tool > **Emulate vision deficiencies** dropdown list | [Verify that a page is usable with blurred vision](test-blurred-vision.md) |
69-
| Verify that the webpage is usable with UI animation turned off (reduced motion) | **Rendering** tool > **Emulate CSS media feature prefers-reduced-motion** | [Verify that a page is usable with UI animation turned off](test-reduced-ui-motion.md) |
67+
| Verify that the webpage is usable by people with color blindness | **Rendering** tool > **Emulate vision deficiencies** dropdown list | [Verify that a page is usable by people with color blindness](./test-color-blindness.md) |
68+
| Verify that the webpage is usable with blurred vision | **Rendering** tool > **Emulate vision deficiencies** dropdown list | [Verify that a page is usable with blurred vision](./test-blurred-vision.md) |
69+
| Verify that the webpage is usable with UI animation turned off (reduced motion) | **Rendering** tool > **Emulate CSS media feature prefers-reduced-motion** | [Verify that a page is usable with UI animation turned off](./test-reduced-ui-motion.md) |
7070
| Verify that the webpage is usable by people with vision deficiencies | **Lighthouse** tool > Issues about vision deficiencies | [Test accessibility using Lighthouse](../accessibility/lighthouse.md) |
7171

7272

microsoft-edge/devtools/console/copilot-explain-console.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -53,17 +53,17 @@ To use Copilot to explain an error or warning in the **Console** tool:
5353

5454
1. If not done already, [enable Copilot in Edge](#enable-copilot-in-edge), as described above.
5555

56-
1. Open a web page that contains the errors you want to explain. For example, open the [Console error explainer test page](https://microsoftedge.github.io/Demos/devtools-explain-error/) in a new window or tab.
56+
1. Open a webpage that contains the errors you want to explain. For example, open the [Console error explainer test page](https://microsoftedge.github.io/Demos/devtools-explain-error/) in a new window or tab.
5757

5858
1. To open DevTools, right-click the webpage, and then select **Inspect**. Or, press **Ctrl+Shift+I** (Windows, Linux) or **Command+Option+I** (macOS). DevTools opens.
5959

6060
1. In DevTools, on the **Activity Bar**, select the **Console** tab.
6161

62-
1. In the rendered web page, click the **Run** button next to one or more error descriptions.
62+
1. In the rendered webpage, click the **Run** button next to one or more error descriptions.
6363

6464
The demo page then generates errors, which are shown in the **Console**:
6565

66-
![The demo web page in Edge, with the DevTools Console next to it, showing a few error messages](./copilot-explain-console-images/some-console-errors.png)
66+
![The demo webpage in Edge, with the DevTools Console next to it, showing a few error messages](./copilot-explain-console-images/some-console-errors.png)
6767

6868
1. In the **Console** tool, click the **ask Copilot: "Explain this error"** (![The explain error icon in the Console](./copilot-explain-console-images/explain-icon.png)) button next to one of the error messages.
6969

microsoft-edge/devtools/css/index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -173,7 +173,7 @@ To debug or test the media queries that you defined in your CSS:
173173

174174
The colored bars above the webpage represent the different media queries.
175175

176-
1. Hover over the boundaries in the bars to display the values of the different media queries. Click each media query value to resize the web page to match.
176+
1. Hover over the boundaries in the bars to display the values of the different media queries. Click each media query value to resize the webpage to match.
177177

178178
![Selecting a media query from the preview bar](./index-images/media-queries-select-bar.png)
179179

microsoft-edge/devtools/elements-tool/elements-tool.md

Lines changed: 14 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,19 @@ Debug your HTML using the DOM tree, and inspect and work on the CSS for your web
1616

1717
![The Elements tool](./elements-tool-images/elements-tool.png)
1818

19+
The **Elements** tool contains the following tabs:
20+
<!--
21+
| Tool | Description | Article |
22+
|---|---|---|
23+
-->
24+
* **Styles**<!-- todo: link each -->
25+
* **Computed**
26+
* **Layout**
27+
* **Event Listeners**
28+
* **DOM Breakpoints**
29+
* **Properties**
30+
* **Accessibility**
31+
1932

2033
<!-- ====================================================================== -->
2134
## See also
@@ -26,4 +39,4 @@ Debug your HTML using the DOM tree, and inspect and work on the CSS for your web
2639
* [Edit CSS font styles and settings in the Styles pane](../inspect-styles/edit-fonts.md)
2740
* [Style editing for CSS-in-JS frameworks](../css/css-in-js.md)
2841
* [Get started viewing and changing the DOM](../dom/index.md)
29-
* [Your first website](https://developer.mozilla.org/docs/Learn/Getting_started_with_the_web) (MDN) - How to use HTML, CSS, and JavaScript to build a web page.
42+
* [Your first website](https://developer.mozilla.org/docs/Learn/Getting_started_with_the_web) (MDN) - How to use HTML, CSS, and JavaScript to build a webpage.

microsoft-edge/devtools/issues/index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -209,7 +209,7 @@ To change the list of browsers that are tested for compatibility issues:
209209
<!-- ------------------------------ -->
210210
#### Filter issues by origin
211211

212-
By default, the **Issues** tool only lists issues that pertain to the current web page's code. To include issues that are caused by third-party libraries or frameworks loaded by the web page too, select the **Include third-party issues** checkbox:
212+
By default, the **Issues** tool only lists issues that pertain to the current webpage's code. To include issues that are caused by third-party libraries or frameworks loaded by the webpage too, select the **Include third-party issues** checkbox:
213213

214214
![The Issues panel with the 'Include third-party issues' checkbox](./index-images/third-party-checkbox.png)
215215

microsoft-edge/devtools/javascript/copilot-explain-source-code.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -43,7 +43,7 @@ To use this explanation feature, enable Copilot in Edge:
4343

4444
To use Copilot to explain code in the **Sources** tool:
4545

46-
1. Open a web page that contains the source code you want to explain. For example, open the [TODO app](https://microsoftedge.github.io/Demos/demo-to-do/) demo page in a new window or tab.
46+
1. Open a webpage that contains the source code you want to explain. For example, open the [TODO app](https://microsoftedge.github.io/Demos/demo-to-do/) demo page in a new window or tab.
4747

4848
1. To open DevTools, right-click the webpage, and then select **Inspect**. Or, press **Ctrl+Shift+I** (Windows, Linux) or **Command+Option+I** (macOS). DevTools opens.
4949

0 commit comments

Comments
 (0)