Skip to content

Commit 3d0dd7e

Browse files
committed
Render callouts correctly by inserting a newline between sections
1 parent b8506ae commit 3d0dd7e

13 files changed

+22
-0
lines changed

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

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -86,5 +86,6 @@ If you add this control, the user can update a data source with one or more phot
8686

8787
### Screen reader support
8888
* **[AccessibleLabel](properties-accessibility.md)** must be present.
89+
8990
> [!NOTE]
9091
> 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

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -133,6 +133,7 @@ There must be adequate color contrast between:
133133
### Screen reader support
134134
* There must be a **[Label](control-text-box.md)** immediately before the chart graphic to serve as the title.
135135
* 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."
136+
136137
> [!NOTE]
137138
> 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.
138139
@@ -143,5 +144,6 @@ There must be adequate color contrast between:
143144

144145
### Keyboard support
145146
* **[TabIndex](properties-accessibility.md)** must be zero or greater so that keyboard users can navigate to it.
147+
146148
> [!NOTE]
147149
> 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

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -102,11 +102,13 @@ This is in addition to the [standard color contrast requirements](../accessible-
102102

103103
### Screen reader support
104104
* **[AccessibleLabel](properties-accessibility.md)** must be present.
105+
105106
> [!NOTE]
106107
> 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.
107108
108109
### Keyboard support
109110
* **[TabIndex](properties-accessibility.md)** must be zero or greater so that keyboard users can navigate to it.
110111
* Focus indicators must be clearly visible. Use **[FocusedBorderColor](properties-color-border.md)** and **[FocusedBorderThickness](properties-color-border.md)** to achieve this.
112+
111113
> [!NOTE]
112114
> 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

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -101,11 +101,13 @@ If clicking anywhere in a gallery item is meant to select it, there must be adeq
101101

102102
### Screen reader support
103103
* **[AccessibleLabel](properties-accessibility.md)** must be present.
104+
104105
> [!NOTE]
105106
> 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.
106107
107108
### Keyboard support
108109
* Consider setting **ShowScrollbar** to **true**. On most touch screen devices, the scrollbar will not show until scrolling begins.
109110
* 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)**.
111+
110112
> [!NOTE]
111113
> 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

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -142,11 +142,13 @@ If you add one or more **Image** controls to your app, you can show individual i
142142
* **[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.
143143
* **[AccessibleLabel](properties-accessibility.md)** can be empty or the empty string **""**, if the graphic provides redundant information.
144144
* 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)**.
145+
145146
> [!IMPORTANT]
146147
> 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**.
147148
148149
### Keyboard support
149150
* **[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.
150151
* 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.
152+
151153
> [!NOTE]
152154
> 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

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -164,5 +164,6 @@ This is in addition to the [standard color contrast requirements](../accessible-
164164
### Keyboard support
165165
* **[TabIndex](properties-accessibility.md)** must be zero or greater so that keyboard users can navigate to it.
166166
* Focus indicators must be clearly visible. Use **[FocusedBorderColor](properties-color-border.md)** and **[FocusedBorderThickness](properties-color-border.md)** to achieve this.
167+
167168
> [!NOTE]
168169
> 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

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -95,9 +95,11 @@ There must be adequate color contrast between:
9595

9696
### Screen reader support
9797
* **[AccessibleLabel](properties-accessibility.md)** should be present.
98+
9899
> [!IMPORTANT]
99100
> **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.
100101
101102
### Keyboard support
103+
102104
> [!IMPORTANT]
103105
> **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

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -98,6 +98,7 @@ There must be adequate color contrast between:
9898

9999
### Screen reader support
100100
* There must be a **[Label](control-text-box.md)** immediately before the chart graphic to serve as the title.
101+
101102
> [!NOTE]
102103
> 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.
103104
@@ -108,5 +109,6 @@ There must be adequate color contrast between:
108109

109110
### Keyboard support
110111
* **[TabIndex](properties-accessibility.md)** must be zero or greater so that keyboard users can navigate to it.
112+
111113
> [!NOTE]
112114
> 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-rating.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -99,12 +99,14 @@ This is in addition to the [standard color contrast requirements](../accessible-
9999

100100
### Screen reader support
101101
* **[AccessibleLabel](properties-accessibility.md)** must be present.
102+
102103
> [!NOTE]
103104
> Screen readers treat the **Rating** control as radio buttons.
104105
105106
### Keyboard support
106107
* **[TabIndex](properties-accessibility.md)** must be zero or greater so that keyboard users can navigate to it.
107108
* Focus indicators must be clearly visible. Use **[FocusedBorderColor](properties-color-border.md)** and **[FocusedBorderThickness](properties-color-border.md)** to achieve this.
108109
* Consider using a different control if there are too many stars. It can be tedious to navigate with a keyboard and difficult to select accurately with a touch screen.
110+
109111
> [!NOTE]
110112
> The same keyboard interactions for radio buttons can be used on **Rating**.

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

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -77,5 +77,6 @@ In addition to text, consider checking color contrast with essential graphical o
7777

7878
### Screen reader support
7979
* There must be a meaningful name for each **Screen**. The screen name can be viewed and edited in the same way as other controls: in the tree view of the controls pane or in the header of the properties pane.
80+
8081
> [!NOTE]
8182
> When a new **Screen** is loaded, screen readers will announce its name.

0 commit comments

Comments
 (0)