Skip to content

Commit b58ade7

Browse files
Merge pull request #2224 from syncfusion-content/1009185-blaz-dev
1009185: Revamp the content for the Blazor PDF Viewer
2 parents bee3fe2 + d8ffd1c commit b58ade7

81 files changed

Lines changed: 933 additions & 1041 deletions

File tree

Some content is hidden

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

Document-Processing/PDF/PDF-Viewer/blazor/accessibility.md

Lines changed: 15 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -37,29 +37,29 @@ The accessibility compliance for the Blazor SfPdfViewer component is outlined be
3737

3838
## WAI-ARIA attributes
3939

40-
[WAI-ARIA](https://www.w3.org/WAI/ARIA/apg/patterns/alert/) (Accessibility Initiative – Accessible Rich Internet Applications) defines a way to enhance the accessibility of web pages, dynamic content, and user interface components developed with Ajax, HTML, JavaScript, and related technologies. ARIA provides additional semantics to describe the role, state, and functionality of web components. The following ARIA attributes are used in the Blazor SfPdfViewer component:
40+
[WAI-ARIA](https://www.w3.org/WAI/ARIA/apg/patterns/alert/) (Accessibility Initiative – Accessible Rich Internet Applications) defines a way to enhance the accessibility of web pages, dynamic content, and user interface components developed with Ajax, HTML, JavaScript, and related technologies. ARIA provides additional semantics to describe the role, state, and functionality of web components. The following ARIA attributes are commonly applied in the SfPdfViewer component:
4141

4242
| Attributes | Purpose |
4343
| --- | --- |
44-
| `aria-disabled`| Indicates whether the Blazor SfPdfViewer component is in a disabled state or not.|
45-
| `aria-expanded`| Indicates whether the suggestion list has expanded or not. |
46-
| `aria-readonly` | Indicates the readonly state of the Blazor SfPdfViewer element. |
47-
| `aria-haspopup` | Indicates whether the Blazor SfPdfViewer input element has a suggestion list or not. |
48-
| `aria-label` | Indicates the breadcrumb item text. |
49-
| `aria-labelledby` | Provides a label for the SfPdfViewer. Typically, the "aria-labelledby" attribute will contain the id of the element used as the Blazor SfPdfViewer's title. |
50-
| `aria-describedby` | This attribute points to the Blazor SfPdfViewer element describing the one it's set on. |
51-
| `aria-orientation` | Indicates whether the Blazor SfPdfViewer element is oriented horizontally or vertically. |
52-
| `aria-valuetext` | Returns the current text of the SfPdfViewer. |
53-
| `aria-valuemax` | Indicates the Maximum value of the SfPdfViewer. |
54-
| `aria-valuemin` | Indicates the Minimum value of the SfPdfViewer. |
55-
| `aria-valuenow` | Indicates the current value of the SfPdfViewer. |
56-
| `aria-controls` | Attribute is set to the button and it points to the corresponding content. |
44+
| `aria-disabled` | Indicates whether an interactive control (for example, a toolbar button) is disabled and not operable. |
45+
| `aria-expanded` | Indicates whether an expandable element (for example, a panel or toolbar menu) is currently expanded. |
46+
| `aria-readonly` | Indicates that the element is read-only and user input is not expected. |
47+
| `aria-haspopup` | Identifies that the element opens a popup (menu, dialog, or toolbar). |
48+
| `aria-label` | Provides an accessible name for controls or regions when a visible label is not available. |
49+
| `aria-labelledby` | Identifies the element that labels this element by referencing that element's id. |
50+
| `aria-describedby` | Identifies the element that provides a description for this element by referencing that element's id. |
51+
| `aria-orientation` | Indicates the orientation (horizontal or vertical) of widgets such as sliders or splitters. |
52+
| `aria-valuetext` | Provides a human-readable text alternative of the current value (for example, a zoom level). |
53+
| `aria-valuemax` | Indicates the maximum value for range widgets (for example, maximum zoom). |
54+
| `aria-valuemin` | Indicates the minimum value for range widgets (for example, minimum zoom). |
55+
| `aria-valuenow` | Indicates the current numeric value for range widgets (for example, current zoom). |
56+
| `aria-controls` | Identifies the element or region controlled by this element (for example, a button that opens a panel). |
5757

5858
## Keyboard interaction
5959

6060
The Blazor SfPdfViewer component follows the [keyboard interaction](https://www.w3.org/WAI/ARIA/apg/patterns/alert/#keyboardinteraction) guideline, making it accessible to users who rely on assistive technologies (AT) and keyboard navigation. The following keyboard shortcuts are supported by the SfPdfViewer component.
6161

62-
| Windows | Mac | Actions |
62+
| Windows | Mac | Action |
6363
| --- | --- | --- |
6464
|||**Shortcuts for page navigation**|
6565
| <kbd>Ctrl</kbd> + <kbd>←</kbd> / <kbd>Ctrl</kbd> + <kbd>↑</kbd> | <kbd>⌘</kbd> + <kbd>←</kbd> / <kbd>⌘</kbd> + <kbd>↑</kbd> |Navigate to the first page |

Document-Processing/PDF/PDF-Viewer/blazor/accessible-pdf-reading.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ This accessible PDF reading feature supports two approaches:
1616
2. Windows Speech Synthesis API
1717

1818
The following demo illustrates both supported approaches:
19-
- [Blazor PDF Viewer example -Accessible PDF Reading](https://document.syncfusion.com/demos/pdf-viewer/blazor-server/pdf-viewer/accessible-pdf-reading?theme=fluent2)
19+
- [Blazor PDF Viewer example - Accessible PDF Reading](https://document.syncfusion.com/demos/pdf-viewer/blazor-server/pdf-viewer/accessible-pdf-reading?theme=fluent2)
2020

2121
## Microsoft Edge’s Screen Reader
2222

@@ -917,7 +917,7 @@ function clearAllHighlights() {
917917
{% endhighlight %}
918918
{% endtabs %}
919919

920-
![Windows Speech Synthesis](./images/windows-speech-synthesis.png)
920+
![Windows Speech Synthesis UI](./images/windows-speech-synthesis.png)
921921

922922
[View sample in GitHub](https://github.com/SyncfusionExamples/blazor-pdf-viewer-examples/tree/master/Accessible/WebSynthesis)
923923

Document-Processing/PDF/PDF-Viewer/blazor/annotation/annotations-in-mobile-view.md

Lines changed: 21 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -9,49 +9,49 @@ documentation: ug
99

1010
# Annotations in mobile view
1111

12-
This article explains how to work with annotations in the mobile view of the Blazor SfPdfViewer. It covers opening the annotation toolbar, adding each annotation type, adjusting properties, deleting annotations, and using the comments panel.
12+
This topic explains how to work with annotations in the mobile view of the Blazor `SfPdfViewer`. It covers opening the annotation toolbar, adding annotation types, adjusting properties, deleting annotations, and using the comments panel.
1313

14-
## To open the annotation toolbar
14+
## Open the annotation toolbar
1515

16-
To open the annotation toolbar, tap the **Edit Annotation** option in the mobile primary toolbar. The annotation toolbar appears at the bottom of the viewer.
16+
Open the annotation toolbar by tapping the **Edit Annotation** option in the mobile primary toolbar. The annotation toolbar appears at the bottom of the viewer.
1717

1818
![Mobile Annotation Toolbar in Blazor SfPdfViewer](../images/open-annotation-toolbar.gif)
1919

20-
## To add sticky notes annotation
20+
## Add a sticky note annotation
2121

2222
Tap the **Sticky Note Annotation** icon, then tap anywhere in the viewer to place the note.
2323

2424
![Choose Sticky Note Annotation in Blazor SfPdfViewer](../images/click-stickynote-annotation.png)
2525

26-
The comments panel opens so the comment for the sticky note can be entered.
26+
The comments panel opens to enter the comment associated with the sticky note.
2727

2828
![Sticky note annotation added in Blazor SfPdfViewer](../images/sticky-note-added.png)
2929

30-
## To add text markup annotation
30+
## Add a text markup annotation
3131

32-
Long-press to select text in the PDF, then tap a **Text Markup Annotation** in the toolbar (for example, highlight, underline, strikethrough, or squiggly).
32+
Long-press to select text in the PDF, then tap a **Text Markup Annotation** option in the toolbar (for example, highlight, underline, strikethrough, or squiggly).
3333

3434
![Select text for text markup in Blazor SfPdfViewer](../images/select-text-for-text-markup.png)
3535

36-
The toolbar then shows the available properties for the chosen annotation (such as color and opacity).
36+
The toolbar then shows properties for the chosen annotation (such as color and opacity).
3737

3838
![Text markup applied to selected text in Blazor SfPdfViewer](../images/text-markup-added-for-selected-text.png)
3939

40-
## To add shape annotation
40+
## Add a shape annotation
4141

42-
Tap the **Shape Annotation** icon in the toolbar to view the available shapes.
42+
Tap the **Shape Annotation** icon in the toolbar to view available shapes.
4343

4444
![Open the shape annotations menu in Blazor SfPdfViewer](../images/click-shape-icon.png)
4545

4646
Choose a shape, then tap and drag in the viewer to draw it.
4747

4848
![Select a shape type in Blazor SfPdfViewer](../images/select-required-shape.png)
4949

50-
After placement, the toolbar switches to the properties toolbar for the added annotation, where options such as fill color, stroke color, thickness, and opacity can be adjusted.
50+
After placement, the toolbar switches to the properties toolbar for the added annotation; adjust options such as fill color, stroke color, thickness, and opacity.
5151

5252
![Draw a selected shape annotation in Blazor SfPdfViewer](../images/add-selected-shape-annotation.png)
5353

54-
## To add measure annotation
54+
## Add a measurement annotation
5555

5656
Tap the **Measure Annotation** icon in the toolbar to view supported measurement types.
5757

@@ -65,7 +65,7 @@ After placement, the properties toolbar appears with options relevant to the mea
6565

6666
![Draw a selected measurement annotation in Blazor SfPdfViewer](../images/add-selected-measure-annotation.png)
6767

68-
## To add free text annotation
68+
## Add a free text annotation
6969

7070
Tap the **Free Text Annotation** icon in the toolbar. The properties toolbar appears with options for text formatting (such as font size, color, and opacity).
7171

@@ -75,7 +75,7 @@ Tap anywhere in the viewer to insert the free text annotation.
7575

7676
![Add free text in the viewer in Blazor SfPdfViewer](../images/add-free-text-viewer.png)
7777

78-
## To add stamp annotation
78+
## Add a stamp annotation
7979

8080
Tap the **Stamp Annotation** icon, then choose a stamp from the available list.
8181

@@ -85,7 +85,7 @@ Tap anywhere in the viewer to place the stamp. The properties toolbar then appea
8585

8686
![Place the selected stamp in Blazor SfPdfViewer](../images/add-selected-stamp.png)
8787

88-
## To add signature
88+
## Add a signature
8989

9090
Tap the **Handwritten Signature** icon to open the signature dialog.
9191

@@ -99,7 +99,7 @@ Tap anywhere in the viewer to place the signature. The properties toolbar then a
9999

100100
![Add the signature to the viewer in Blazor SfPdfViewer](../images/add-signature-to-viewer.png)
101101

102-
## To add ink annotation
102+
## Add an ink annotation
103103

104104
Tap the **Ink Annotation** icon, then draw directly in the viewer.
105105

@@ -111,25 +111,25 @@ When finished, tap the Ink Annotation icon again to exit drawing mode. The prope
111111

112112
## Change annotation properties before adding
113113

114-
Annotation properties can be configured before placement. For example, tap the rectangle shape to show its properties toolbar, adjust the settings, and then tap and drag to place the annotation. The annotation is added using the modified properties.
114+
Annotation properties can be configured before placement. For example, tap a shape to show its properties toolbar, adjust the settings, then tap and drag to place the annotation. The annotation is added with the modified properties.
115115

116116
![Change properties before adding an annotation in Blazor SfPdfViewer](../images/property-change-before-adding.gif)
117117

118118
## Change annotation properties after adding
119119

120-
After placement, select the annotation to display its properties toolbar. Adjust the required properties; the changes are applied immediately to the selected annotation.
120+
After placement, select the annotation to display its properties toolbar. Adjust required properties; the changes are applied immediately to the selected annotation.
121121

122122
![Change properties after adding an annotation in Blazor SfPdfViewer](../images/property-change-after-adding.gif)
123123

124-
## Delete Annotation
124+
## Delete an annotation
125125

126126
Select the annotation to delete. In the properties toolbar, tap the Delete icon. The annotation is removed from the PDF, and any associated comment is also deleted.
127127

128128
![Delete the selected annotation in Blazor SfPdfViewer](../images/delete-selected-annotation.png)
129129

130-
## Open and Close Comment Panel
130+
## Open and close the comments panel
131131

132-
Open the comments panel from the **more option** menu at the right end of the mobile primary toolbar.
132+
Open the comments panel from the More options menu at the right end of the mobile primary toolbar.
133133

134134
![Open the comments panel from More options in Blazor SfPdfViewer](../images/select-comment-panel-icon.png)
135135

0 commit comments

Comments
 (0)