Merge pull request #378 from MicrosoftDocs/master

publish on 25-April

Author: AFTOwen

powerapps-docs/maker/TOC.yml

@@ -35,11 +35,11 @@
     items:
     - name: Customize a generated app
       items:
-      - name: Customize a browse screen
+      - name: 1 - Galleries
         href: ./canvas-apps/customize-layout-sharepoint.md
-      - name: Customize a form
+      - name: 2 - Forms
         href: ./canvas-apps/customize-forms-sharepoint.md
-      - name: Customize a card
+      - name: 3 - Cards
         href: ./canvas-apps/customize-card.md
     - name: Create an app from scratch
       items:

powerapps-docs/maker/canvas-apps/accessible-apps-color.md

@@ -61,3 +61,6 @@ For video content, consider checking it for contrast issues. Alternatively or ad
 Ensure that the app does not convey information with just color. For example, users with red-green color blindness will not be able to distinguish a red error message from a green success message.
 
 Additional cues like an **[Icon](controls/control-shapes-icons.md)** or text styles like **[Italic](controls/properties-text.md)** and **[Underline](controls/properties-text.md)** can help convey meaning.
+
+## Next steps
+Learn about [accessibility properties](controls/properties-accessibility.md) in PowerApps controls.

powerapps-docs/maker/canvas-apps/controls/control-barcodescanner.md

@@ -86,5 +86,6 @@ If you add this control, the user can update a data source with one or more phot
 
 ### Screen reader support
 * **[AccessibleLabel](properties-accessibility.md)** must be present.
-> [!NOTE]
+
+    > [!NOTE]
 > Screen readers will annnouce when a new barcode has been found. The value will not be announced. As long as the barcode is in view, screen readers will remind every 5 seconds that the same barcode is still being identified.

powerapps-docs/maker/canvas-apps/controls/control-column-line-chart.md

@@ -133,7 +133,8 @@ There must be adequate color contrast between:
 ### Screen reader support
 * There must be a **[Label](control-text-box.md)** immediately before the chart graphic to serve as the title.
 * Consider adding a summary of the chart graphic. For example, "The line chart shows a steady increase in sales between March and August this year."
-> [!NOTE]
+
+    > [!NOTE]
 > Chart graphics and **Legend** are hidden from screen reader users. As an alternative, a tabular form of the data is presented to them. They can also cycle through buttons that select data in the chart.
 
 ### Low vision support
@@ -143,5 +144,6 @@ There must be adequate color contrast between:
 
 ### Keyboard support
 * **[TabIndex](properties-accessibility.md)** must be zero or greater so that keyboard users can navigate to it.
-> [!NOTE]
+
+    > [!NOTE]
 > When keyboard users navigate to the chart, they can cycle through buttons that select data in the chart.

powerapps-docs/maker/canvas-apps/controls/control-combo-box.md

@@ -102,11 +102,13 @@ This is in addition to the [standard color contrast requirements](../accessible-
 
 ### Screen reader support
 * **[AccessibleLabel](properties-accessibility.md)** must be present.
-> [!NOTE]
+
+    > [!NOTE]
 > On touch screens, screen reader users can navigate the contents of the combo box sequentially. The combo box acts as a button that shows or hides its contents when selected.
 
 ### Keyboard support
 * **[TabIndex](properties-accessibility.md)** must be zero or greater so that keyboard users can navigate to it.
 * Focus indicators must be clearly visible. Use **[FocusedBorderColor](properties-color-border.md)** and **[FocusedBorderThickness](properties-color-border.md)** to achieve this.
-> [!NOTE]
+
+    > [!NOTE]
 > The tab key navigates to or away from the combo box. Arrow keys navigate the contents of the combo box. The escape key closes the drop down when opened.

powerapps-docs/maker/canvas-apps/controls/control-gallery.md

@@ -101,11 +101,13 @@ If clicking anywhere in a gallery item is meant to select it, there must be adeq
 
 ### Screen reader support
 * **[AccessibleLabel](properties-accessibility.md)** must be present.
-> [!NOTE]
+
+    > [!NOTE]
 > Screen readers will annnouce when items in the gallery change. The **AccessibleLabel** is also mentioned. This gives context to the announcement and is even more important when there are multiple galleries on the same screen.
 
 ### Keyboard support
 * Consider setting **ShowScrollbar** to **true**. On most touch screen devices, the scrollbar will not show until scrolling begins.
 * If clicking anywhere in a gallery item is meant to select it, there must also be way for keyboard users to select the gallery item. For example, adding a **[Button](control-button.md)** that has its **OnSelect** property set to **Select(Parent)**.
-> [!NOTE]
+
+    > [!NOTE]
 > Controls outside the gallery are not considered in the keyboard navigation order within the gallery. **[TabIndex](properties-accessibility.md)** of controls inside a gallery are scoped. See [accessibility properties](properties-accessibility.md) to learn more.

powerapps-docs/maker/canvas-apps/controls/control-image.md

@@ -142,11 +142,13 @@ If you add one or more **Image** controls to your app, you can show individual i
 * **[AccessibleLabel](properties-accessibility.md)** must be empty or the empty string **""**, if the graphic is purely for decoration. This causes screen readers to ignore the graphic.
 * **[AccessibleLabel](properties-accessibility.md)** can be empty or the empty string **""**, if the graphic provides redundant information.
     * For example, an **Image** of gears with its **[AccessibleLabel](properties-accessibility.md)** set to **Settings**. This image is not used as a button. It is next to a **[Label](control-text-box.md)** that also says **Settings**. Screen readers will read the image as **Settings**, and the label as **Settings** again. This is unnecessarily verbose. In this case, the **Image** does not need an **[AccessibleLabel](properties-accessibility.md)**.
-> [!IMPORTANT]
+
+    > [!IMPORTANT]
 > Screen readers will always read **Image**s that have **[TabIndex](properties-accessibility.md)** of zero or greater, even if **[AccessibleLabel](properties-accessibility.md)** is empty. This is because they are rendered as buttons. If no **[AccessibleLabel](properties-accessibility.md)** is provided, screen readers will simply read the graphic as **button**.
 
 ### Keyboard support
 * **[TabIndex](properties-accessibility.md)** must be zero or greater, if the graphic is used as a button. This allows keyboard users to navigate to it.
 * Focus indicators must be clearly visible, if the graphic is used as a button. Use **[FocusedBorderColor](properties-color-border.md)** and **[FocusedBorderThickness](properties-color-border.md)** to achieve this.
-> [!NOTE]
+
+    > [!NOTE]
 > When **[TabIndex](properties-accessibility.md)** is zero or greater, the **Image** is rendered as a button. There is no change to the visual appearance, but screen readers will correctly identify the image as a button. When **[TabIndex](properties-accessibility.md)** is less than zero, the **Image** is identified as an image.

powerapps-docs/maker/canvas-apps/controls/control-list-box.md

@@ -164,5 +164,6 @@ This is in addition to the [standard color contrast requirements](../accessible-
 ### Keyboard support
 * **[TabIndex](properties-accessibility.md)** must be zero or greater so that keyboard users can navigate to it.
 * Focus indicators must be clearly visible. Use **[FocusedBorderColor](properties-color-border.md)** and **[FocusedBorderThickness](properties-color-border.md)** to achieve this.
-> [!NOTE]
+
+    > [!NOTE]
 > The tab key navigates to or away from the **List box**. Arrow keys navigate the contents of the **List box**.

powerapps-docs/maker/canvas-apps/controls/control-pen-input.md

@@ -95,9 +95,11 @@ There must be adequate color contrast between:
 
 ### Screen reader support
 * **[AccessibleLabel](properties-accessibility.md)** should be present.
-> [!IMPORTANT]
+
+    > [!IMPORTANT]
 > **Pen input** is not accessible to screen reader users. Always provide an alternative form of input. For example, if a sketch is required, consider adding an **[Add picture](control-add-picture.md)** control for users to upload an image. Both methods can be offered and the user can choose the one they are more comfortable with.
 
 ### Keyboard support
+
 > [!IMPORTANT]
 > **Pen input** is not accessible to keyboard users. Always provide an alternative form of input. For example, if a signature is required, consider adding a **[Text input](control-text-input.md)** for users to enter their name. Both methods can be offered and the user can choose the one they are more comfortable with.

powerapps-docs/maker/canvas-apps/controls/control-pie-chart.md

@@ -98,7 +98,8 @@ There must be adequate color contrast between:
 
 ### Screen reader support
 * There must be a **[Label](control-text-box.md)** immediately before the chart graphic to serve as the title.
-> [!NOTE]
+
+    > [!NOTE]
 > Chart graphics and **Legend** are hidden from screen reader users. As an alternative, a tabular form of the data is presented to them. They can also cycle through buttons that select data in the chart.
 
 ### Low vision support
@@ -108,5 +109,6 @@ There must be adequate color contrast between:
 
 ### Keyboard support
 * **[TabIndex](properties-accessibility.md)** must be zero or greater so that keyboard users can navigate to it.
-> [!NOTE]
+
+    > [!NOTE]
 > When keyboard users navigate to the chart, they can cycle through buttons that select data in the chart.