Skip to content

Commit e0a7af3

Browse files
Merge pull request #1558 from syncfusion-content/986755-pv-master
986755: Change the development changes into master
2 parents 618f9b6 + b0ece6b commit e0a7af3

File tree

232 files changed

+7658
-4160
lines changed

Some content is hidden

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

232 files changed

+7658
-4160
lines changed

Document-Processing-toc.html

Lines changed: 136 additions & 101 deletions
Large diffs are not rendered by default.
-7.92 KB
Loading

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

Lines changed: 23 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ documentation: ug
88
---
99

1010
# Accessibility in Syncfusion® Blazor SfPdfViewer
11-
The Blazor SfPdfViewer component followed the accessibility guidelines and standards, including [ADA](https://www.ada.gov/), [Section 508](https://www.section508.gov/), [WCAG 2.2](https://www.w3.org/TR/WCAG22/) standards, and [WCAG roles](https://www.w3.org/TR/wai-aria/#roles) that are commonly used to evaluate accessibility.
11+
The Blazor SfPdfViewer component follows established accessibility guidelines and standards, including the [ADA](https://www.ada.gov/), [Section 508](https://www.section508.gov/), [WCAG 2.2](https://www.w3.org/TR/WCAG22/) standards, and [WCAG roles](https://www.w3.org/TR/wai-aria/#roles), which are commonly used to evaluate accessibility.
1212

1313
The accessibility compliance for the Blazor SfPdfViewer component is outlined below.
1414

@@ -37,7 +37,7 @@ 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 increase 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 used in the Blazor SfPdfViewer component:
4141

4242
| Attributes | Purpose |
4343
| --- | --- |
@@ -57,46 +57,46 @@ The accessibility compliance for the Blazor SfPdfViewer component is outlined be
5757

5858
## Keyboard interaction
5959

60-
The Blazor SfPdfViewer component followed the [keyboard interaction](https://www.w3.org/WAI/ARIA/apg/patterns/alert/#keyboardinteraction) guideline, making it easy for people who use assistive technologies (AT) and those who completely rely on keyboard navigation. The following keyboard shortcuts are supported by the Message component.
60+
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

6262
| Windows | Mac | Actions |
6363
| --- | --- | --- |
6464
|||**Shortcuts for page navigation**|
65-
| <kbd>Ctrl</kbd> + <kbd>←</kbd> / <kbd>Ctrl</</kbd> + <kbd>↑</kbd> | <kbd>⌘</kbd> + <kbd>←</kbd> or <kbd>⌘</kbd> + <kbd>↑</kbd> |Navigate to the first page |
66-
| <kbd>Ctrl</kbd> + <kbd>→</kbd> / <kbd>Ctrl</</kbd> + <kbd>↓</kbd> | <kbd>⌘</kbd> + <kbd>→</kbd> or <kbd>⌘</kbd> + <kbd>↓</kbd> |Navigate to the last page |
65+
| <kbd>Ctrl</kbd> + <kbd>←</kbd> / <kbd>Ctrl</kbd> + <kbd>↑</kbd> | <kbd>⌘</kbd> + <kbd>←</kbd> / <kbd>⌘</kbd> + <kbd>↑</kbd> |Navigate to the first page |
66+
| <kbd>Ctrl</kbd> + <kbd>→</kbd> / <kbd>Ctrl</kbd> + <kbd>↓</kbd> | <kbd>⌘</kbd> + <kbd>→</kbd> / <kbd>⌘</kbd> + <kbd>↓</kbd> |Navigate to the last page |
6767
| <kbd>←</kbd> | <kbd>←</kbd> / <kbd>⇧</kbd> + <kbd>Space</kbd> |Navigate to the previous page |
6868
| <kbd>→</kbd> | <kbd>→</kbd> / <kbd>Space</kbd> | Navigate to the next page |
6969
| <kbd>Ctrl</kbd> + <kbd>G</kbd> | <kbd>⌘</kbd> + <kbd>G</kbd> | Go To The Page|
70-
|<kbd>↑</kbd> |<kbd>↑</kbd> |Scroll up|
70+
| <kbd>↑</kbd> |<kbd>↑</kbd> |Scroll up|
7171
| <kbd>↓</kbd> | <kbd>↓</kbd> | Scroll down|
7272
|||**Shortcuts for Zooming**|
73-
|<kbd>Ctrl</kbd> + <kbd>=</kbd> |<kbd>⌘</kbd> + <kbd>=</kbd> | Perform zoom-in operation |
73+
| <kbd>Ctrl</kbd> + <kbd>=</kbd> | <kbd>⌘</kbd> + <kbd>=</kbd> | Perform zoom-in operation |
7474
| <kbd>Ctrl</kbd> + <kbd>-</kbd> | <kbd>⌘</kbd> + <kbd>-</kbd> | Perform zoom-out operation |
75-
|<kbd>Ctrl</kbd> + <kbd>0</kbd> | <kbd>⌘</kbd> + <kbd>0</kbd> | Retain the zoom level to 1 |
75+
|<kbd>Ctrl</kbd> + <kbd>0</kbd> | <kbd>⌘</kbd> + <kbd>0</kbd> | Reset zoom to 100% |
7676
|||**Shortcut for Text Search**|
7777
| <kbd>Ctrl</kbd> + <kbd>F</kbd> | <kbd>⌘</kbd> + <kbd>F</kbd> | Open the search toolbar|
7878
|||**Shortcut for Text Selection**|
7979
|<kbd>Ctrl</kbd> + <kbd>C</kbd> | <kbd>⌘</kbd> + <kbd>C</kbd> | Copy the selected text or annotation |
80-
| <kbd>Ctrl</kbd> + <kbd>X</kbd> | <kbd>⌘</kbd> + <kbd>X</kbd> |Cut the selected text or annotation |
81-
|<kbd>Ctrl</kbd> + <kbd>V</kbd> | <kbd>⌘</kbd> + <kbd>V</kbd> |Paste the selected text or annotation |
82-
|||**Shortcuts for the general operation**|
83-
| <kbd>Ctrl</kbd> + <kbd>Z</kbd> | <kbd>⌘</kbd> + <kbd>Z</kbd> |Undo the action|
84-
|<kbd>Ctrl</kbd> + <kbd>Y</kbd> | <kbd>⌘</kbd> + <kbd>Y</kbd> |Redo the action|
85-
| <kbd>Ctrl</kbd> + <kbd>P</kbd> | <kbd>⌘</kbd> + <kbd>P</kbd> |Print the document|
86-
| <kbd>Delete</kbd> | <kbd>Delete</kbd> |Delete the annotations|
87-
| <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>A</kbd> | <kbd>⌘</kbd> + <kbd>⇧</kbd> + <kbd>A</kbd> |Toggle Annotation Toolbar|
88-
| <kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>0</kbd> | <kbd>⌘</kbd> + <kbd>⌥</kbd> + <kbd>0</kbd> |Show Command panel|
89-
| <kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>2</kbd> | <kbd>⌘</kbd> + <kbd>⌥</kbd> + <kbd>2</kbd> |Show Bookmarks|
90-
|<kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>1</kbd> | <kbd>⌘</kbd> + <kbd>⌥</kbd> + <kbd>1</kbd> |Show Thumbnails|
91-
| <kbd>Ctrl</kbd> + <kbd>S</kbd> | <kbd>⌘</kbd> + <kbd>S</kbd> |Download|
92-
| <kbd>Shift</kbd> + <kbd>H</kbd> | <kbd>⇧</kbd> + <kbd>H</kbd> |Enable pan mode |
93-
| <kbd>Shift</kbd> + <kbd>V</kbd> |<kbd>⇧</kbd> + <kbd>V</kbd> |Enable text selection mode|
80+
| <kbd>Ctrl</kbd> + <kbd>X</kbd> | <kbd>⌘</kbd> + <kbd>X</kbd> | Cut the selected text or annotation |
81+
|<kbd>Ctrl</kbd> + <kbd>V</kbd> | <kbd>⌘</kbd> + <kbd>V</kbd> | Paste the selected text or annotation |
82+
|||**Shortcuts for general operation**|
83+
| <kbd>Ctrl</kbd> + <kbd>Z</kbd> | <kbd>⌘</kbd> + <kbd>Z</kbd> | Undo the action |
84+
|<kbd>Ctrl</kbd> + <kbd>Y</kbd> | <kbd>⌘</kbd> + <kbd>Y</kbd> | Redo the action |
85+
| <kbd>Ctrl</kbd> + <kbd>P</kbd> | <kbd>⌘</kbd> + <kbd>P</kbd> | Print the document |
86+
| <kbd>Delete</kbd> | <kbd>Delete</kbd> | Delete the annotations |
87+
| <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>A</kbd> | <kbd>⌘</kbd> + <kbd>⇧</kbd> + <kbd>A</kbd> | Toggle Annotation Toolbar|
88+
| <kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>0</kbd> | <kbd>⌘</kbd> + <kbd>⌥</kbd> + <kbd>0</kbd> | Show Command panel |
89+
| <kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>2</kbd> | <kbd>⌘</kbd> + <kbd>⌥</kbd> + <kbd>2</kbd> | Show Bookmarks |
90+
|<kbd>Ctrl</kbd> + <kbd>Alt</kbd> + <kbd>1</kbd> | <kbd>⌘</kbd> + <kbd>⌥</kbd> + <kbd>1</kbd> | Show Thumbnails |
91+
| <kbd>Ctrl</kbd> + <kbd>S</kbd> | <kbd>⌘</kbd> + <kbd>S</kbd> | Download |
92+
| <kbd>Shift</kbd> + <kbd>H</kbd> | <kbd>⇧</kbd> + <kbd>H</kbd> | Enable pan mode |
93+
| <kbd>Shift</kbd> + <kbd>V</kbd> | <kbd>⇧</kbd> + <kbd>V</kbd> | Enable text selection mode |
9494

9595
## Ensuring accessibility
9696

9797
The Blazor SfPdfViewer component's accessibility levels are ensured through an [axe-core](https://www.nuget.org/packages/Deque.AxeCore.Playwright) with playwright tests.
9898

99-
The accessibility compliance of the Blazor SfPdfViewer component is shown in the following sample. Open the [sample](https://blazor.syncfusion.com/accessibility/pdfviewer) in a new window to evaluate the accessibility of the Blazor SfPdfViewer component with accessibility tools.
99+
The accessibility compliance of the Blazor SfPdfViewer component is demonstrated in the following sample. Open the [SfPdfViewer accessibility sample](https://blazor.syncfusion.com/accessibility/sfpdfviewer) in a new window to evaluate the accessibility of the Blazor SfPdfViewer component with accessibility tools.
100100

101101
## See also
102102

Lines changed: 61 additions & 53 deletions
Original file line numberDiff line numberDiff line change
@@ -1,134 +1,142 @@
11
---
22
layout: post
33
title: Annotations in Mobile View using SfPdfViewer Component | Syncfusion
4-
description: Checkout and learn everything about annotations in the mobile view using the Syncfusion Blazor SfPdfViewer component and more.
4+
description: Learn how to add, edit, and manage annotations in the mobile view of the Syncfusion Blazor SfPdfViewer component
55
platform: document-processing
66
control: SfPdfViewer
77
documentation: ug
88
---
99

10-
# To open the annotation toolbar
10+
# Annotations in mobile view
1111

12-
To Open the annotation toolbar, click on the **Edit Annotation** option in the mobile primary toolbar. The mobile annotation toolbar will open at bottom of the viewer.
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.
13+
14+
## To open the annotation toolbar
15+
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.
1317

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

1620
## To add sticky notes annotation
1721

18-
Click the **Sticky Note Annotation** icon and then click anywhere in the viewer to add the sticky notes.
22+
Tap the **Sticky Note Annotation** icon, then tap anywhere in the viewer to place the note.
1923

20-
![Click Sticky Note icon in Blazor SfPdfViewer](../images/click-stickynote-annotation.png)
24+
![Choose Sticky Note Annotation in Blazor SfPdfViewer](../images/click-stickynote-annotation.png)
2125

22-
This action will open the comment panel, allowing you to add the required comment for the added sticky notes.
26+
The comments panel opens so the comment for the sticky note can be entered.
2327

24-
![Sticky Note Annotation added in Blazor SfPdfViewer](../images/sticky-note-added.png)
28+
![Sticky note annotation added in Blazor SfPdfViewer](../images/sticky-note-added.png)
2529

2630
## To add text markup annotation
2731

28-
Long-press to select any text in the PDF, then click on any **Text Markup Annotation** in the annotation toolbar.
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).
2933

30-
![Select Text in Blazor SfPdfViewer](../images/select-text-for-text-markup.png)
34+
![Select text for text markup in Blazor SfPdfViewer](../images/select-text-for-text-markup.png)
3135

32-
This action will display the required properties for this annotation in the toolbar.
36+
The toolbar then shows the available properties for the chosen annotation (such as color and opacity).
3337

34-
![Select Text in Blazor SfPdfViewer](../images/text-markup-added-for-selected-text.png)
38+
![Text markup applied to selected text in Blazor SfPdfViewer](../images/text-markup-added-for-selected-text.png)
3539

3640
## To add shape annotation
3741

38-
Click the **Shape Annotation** icon in the toolbar. It will display the supported shape annotations.
42+
Tap the **Shape Annotation** icon in the toolbar to view the available shapes.
3943

40-
![Click Shape Icon in Blazor SfPdfViewer](../images/click-shape-icon.png)
44+
![Open the shape annotations menu in Blazor SfPdfViewer](../images/click-shape-icon.png)
4145

42-
Choose any annotation type from the list, then click and drag anywhere in the viewer to add the annotation.
46+
Choose a shape, then tap and drag in the viewer to draw it.
4347

44-
![Select Particular Shape in Blazor SfPdfViewer](../images/select-required-shape.png)
48+
![Select a shape type in Blazor SfPdfViewer](../images/select-required-shape.png)
4549

46-
The toolbar will also switch to display the properties that is required for the added annotation.
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.
4751

48-
![Draw Shape in Blazor SfPdfViewer](../images/add-selected-shape-annotation.png)
52+
![Draw a selected shape annotation in Blazor SfPdfViewer](../images/add-selected-shape-annotation.png)
4953

5054
## To add measure annotation
5155

52-
Click the **Measure Annotation** icon in the toolbar. It will display the supported measure annotations.
56+
Tap the **Measure Annotation** icon in the toolbar to view supported measurement types.
5357

54-
![Click Measure Icon in Blazor SfPdfViewer](../images/click-measure-icon.png)
58+
![Open the measure annotations menu in Blazor SfPdfViewer](../images/click-measure-icon.png)
5559

56-
Choose any annotation type from the list, then click and drag anywhere in the viewer to add the annotation.
60+
Select a measurement type, then tap and drag in the viewer to add it.
5761

58-
![Select Particular Measure in Blazor SfPdfViewer](../images/select-required-measure.png)
62+
![Select a measurement type in Blazor SfPdfViewer](../images/select-required-measure.png)
5963

60-
The toolbar will also switch to display the properties that is required for the added annotation.
64+
After placement, the properties toolbar appears with options relevant to the measurement annotation (for example, stroke color, thickness, and opacity).
6165

62-
![Draw Measure in Blazor SfPdfViewer](../images/add-selected-measure-annotation.png)
66+
![Draw a selected measurement annotation in Blazor SfPdfViewer](../images/add-selected-measure-annotation.png)
6367

6468
## To add free text annotation
6569

66-
Click the **Free Text Annotation** icon in the toolbar. Which will display the properties that is required for free text.
70+
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).
6771

68-
![Click Free Text Icon in Blazor SfPdfViewer](../images/click-free-text-annotation.png)
72+
![Open Free Text Annotation in Blazor SfPdfViewer](../images/click-free-text-annotation.png)
6973

70-
Click anyWhere in the viewer to add the free text annotation.
74+
Tap anywhere in the viewer to insert the free text annotation.
7175

72-
![Add Free Text in Blazor SfPdfViewer](../images/add-free-text-viewer.png)
76+
![Add free text in the viewer in Blazor SfPdfViewer](../images/add-free-text-viewer.png)
7377

7478
## To add stamp annotation
7579

76-
Click on the **Stamp Annotation** icon and choose the desired stamp from the various types listed in the menu.
80+
Tap the **Stamp Annotation** icon, then choose a stamp from the available list.
7781

78-
![Click Stamp Icon in Blazor SfPdfViewer](../images/open-list-of-stamp.png)
82+
![Open the list of stamp annotations in Blazor SfPdfViewer](../images/open-list-of-stamp.png)
7983

80-
Afterward, click anywhere in the viewer to add the stamp. The toolbar will then switch to display the properties required for the stamp annotation.
84+
Tap anywhere in the viewer to place the stamp. The properties toolbar then appears for additional adjustments where applicable.
8185

82-
![Select Required Stamp in Blazor SfPdfViewer](../images/add-selected-stamp.png)
86+
![Place the selected stamp in Blazor SfPdfViewer](../images/add-selected-stamp.png)
8387

8488
## To add signature
8589

86-
Click the **Handwritten Signature** icon to open the signature dialog box.
90+
Tap the **Handwritten Signature** icon to open the signature dialog.
8791

88-
![Click Signature Icon in Blazor SfPdfViewer](../images/open-signature-dialog.png)
92+
![Open the signature dialog in Blazor SfPdfViewer](../images/open-signature-dialog.png)
8993

90-
Draw your signature in the signature dialog canvas, then click the ‘Create’ button to add the signature into the viewer.
94+
Draw the signature in the dialog’s canvas, then tap Create to add it to the viewer.
9195

92-
![Draw Signature in Blazor SfPdfViewer](../images/draw-signature-in-dialog.png)
96+
![Draw a signature in the dialog in Blazor SfPdfViewer](../images/draw-signature-in-dialog.png)
9397

94-
Click anywhere in the viewer to place the signature. The toolbar will then switch to display the properties required for the signature.
98+
Tap anywhere in the viewer to place the signature. The properties toolbar then appears for further adjustments.
9599

96-
![Add Signature in Blazor SfPdfViewer](../images/add-signature-to-viewer.png)
100+
![Add the signature to the viewer in Blazor SfPdfViewer](../images/add-signature-to-viewer.png)
97101

98102
## To add ink annotation
99103

100-
Click the **Ink Annotation** icon and draw anywhere in the viewer.
104+
Tap the **Ink Annotation** icon, then draw directly in the viewer.
101105

102-
![Click ink in Blazor SfPdfViewer](../images/click-ink-annotation.png)
106+
![Start ink annotation in Blazor SfPdfViewer](../images/click-ink-annotation.png)
103107

104-
Once you’ve finished drawing, click the ink annotation displayed in the toolbar to stop the ink annotation drawing. The toolbar will then switch to display the properties required for the ink annotation.
108+
When finished, tap the Ink Annotation icon again to exit drawing mode. The properties toolbar then appears with options for ink color, thickness, and opacity.
105109

106-
![Complete Ink Annotation in Blazor SfPdfViewer](../images/complete-ink-annotation.png)
110+
![Complete an ink annotation in Blazor SfPdfViewer](../images/complete-ink-annotation.png)
107111

108-
## Change annotation properties (Before adding)
112+
## Change annotation properties before adding
109113

110-
You can modify annotations properties before adding them. Click the rectangle shape annotation, which will display the toolbar with corresponding properties. You can be able to adjust these properties and then add the annotation by clicking and dragging it. The annotation will be added with the modified property.
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.
111115

112-
![Property Change Before Adding in Blazor SfPdfViewer](../images/property-change-before-adding.gif)
116+
![Change properties before adding an annotation in Blazor SfPdfViewer](../images/property-change-before-adding.gif)
113117

114-
## Change annotation properties (After adding)
118+
## Change annotation properties after adding
115119

116-
After adding the annotation, you can modify its properties. Select the added annotation, and it will display the corresponding properties. Change the necessary property, and it will reflect in the added annotation.
120+
After placement, select the annotation to display its properties toolbar. Adjust the required properties; the changes are applied immediately to the selected annotation.
117121

118-
![Property Change After Adding in Blazor SfPdfViewer](../images/property-change-after-adding.gif)
122+
![Change properties after adding an annotation in Blazor SfPdfViewer](../images/property-change-after-adding.gif)
119123

120124
## Delete Annotation
121125

122-
To delete an annotation, first, select the annotation you want to remove. The delete icon will appear in the property toolbar. Clicking on the delete icon will remove the annotation from the PDF along with its associated comment.
126+
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.
123127

124-
![Delete Selected Annotation in Blazor SfPdfViewer](../images/delete-selected-annotation.png)
128+
![Delete the selected annotation in Blazor SfPdfViewer](../images/delete-selected-annotation.png)
125129

126130
## Open and Close Comment Panel
127131

128-
You can open the comments through the **more option** located at the right end of the mobile primary toolbar.
132+
Open the comments panel from the **more option** menu at the right end of the mobile primary toolbar.
133+
134+
![Open the comments panel from More options in Blazor SfPdfViewer](../images/select-comment-panel-icon.png)
135+
136+
To close the comments panel, tap the Close icon within the panel.
129137

130-
![Select CommentPanel in Blazor SfPdfViewer](../images/select-comment-panel-icon.png)
138+
![Comments panel displayed in Blazor SfPdfViewer](../images/open-cooment-panel.png)
131139

132-
To close the comment panel, click the close icon located within the comment panel.
140+
## See Also
133141

134-
![Open CommentPanel in Blazor SfPdfViewer](../images/open-cooment-panel.png)
142+
* [Annotation Toolbar in Mobile mode](../toolbar-customization/mobile-toolbar)

0 commit comments

Comments
 (0)