Skip to content

Commit d03b1ad

Browse files
Merge branch 'development' into 983001-DocumentChanges5
2 parents a699023 + d93a64d commit d03b1ad

File tree

220 files changed

+6727
-3795
lines changed

Some content is hidden

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

220 files changed

+6727
-3795
lines changed

Document-Processing-toc.html

Lines changed: 93 additions & 47 deletions
Large diffs are not rendered by default.

Document-Processing/Excel/Spreadsheet/Blazor/cell-range.md

Lines changed: 106 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -102,6 +102,112 @@ The following illustration demonstrates the use of autofill in the Spreadsheet c
102102

103103
![Autofill Illustration](images/autofill.gif)
104104

105+
## Events
106+
107+
The Blazor Spreadsheet provides events that are triggered during autofill operations, such as [AutofillActionBegin](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Spreadsheet.AutofillActionBeginEventArgs.html) and [AutofillActionEnd](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Spreadsheet.AutofillActionEndEventArgs.html). These events enable the execution of custom actions before and after an autofill operation, allowing for validation, customization, and response handling.
108+
109+
### AutofillActionBegin
110+
111+
The `AutofillActionBegin` event is triggered before an autofill operation is performed. This event provides an opportunity to validate the autofill operation and apply restrictions based on custom logic, such as preventing the operation under specific conditions.
112+
113+
**Purpose**
114+
115+
This event is useful for scenarios where autofill behavior needs to be controlled dynamically—such as restricting autofill in specific ranges or preventing autofill based on certain conditions.
116+
117+
**Event Arguments**
118+
119+
The event uses the [AutofillActionBeginEventArgs](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Spreadsheet.AutofillActionBeginEventArgs.html) class, which includes the following properties:
120+
121+
| Event Arguments | Description |
122+
|----------------|-------------|
123+
| FillRange (read-only) | The address of the target range for the autofill operation (e.g., "Sheet1!A2:A5"). |
124+
| DataRange (read-only) | The source data range for the autofill operation (e.g., "Sheet1!A1:A1"). |
125+
| Direction (read-only) | The direction of the autofill operation ("Down", "Right", "Up", or "Left"). |
126+
| Cancel | A boolean value to cancel the autofill operation. |
127+
128+
{% tabs %}
129+
{% highlight razor tabtitle="Index.razor" %}
130+
131+
@using Syncfusion.Blazor.Spreadsheet
132+
133+
<SfSpreadsheet DataSource="DataSourceBytes" AutofillActionBegin="OnAutofillActionBegin">
134+
<SpreadsheetRibbon></SpreadsheetRibbon>
135+
</SfSpreadsheet>
136+
137+
@code {
138+
public byte[] DataSourceBytes { get; set; }
139+
140+
protected override void OnInitialized()
141+
{
142+
string filePath = "wwwroot/Sample.xlsx";
143+
DataSourceBytes = File.ReadAllBytes(filePath);
144+
}
145+
146+
public void OnAutofillActionBegin(AutofillActionBeginEventArgs args)
147+
{
148+
// Prevent autofill for a specific range.
149+
if (args.FillRange == "A1:A10")
150+
{
151+
args.Cancel = true;
152+
}
153+
154+
// Prevent autofill when dragging upward.
155+
if (args.Direction == "Up")
156+
{
157+
args.Cancel = true;
158+
}
159+
}
160+
}
161+
162+
{% endhighlight %}
163+
{% endtabs %}
164+
165+
**AutofillActionEnd**
166+
167+
The `AutofillActionEnd` event is triggered after an autofill operation has been successfully completed. This event provides detailed information about the completed autofill action, enabling further processing or logging if required.
168+
169+
**Purpose**
170+
171+
This event is useful for scenarios where post-autofill actions are needed, such as logging the autofill operation, updating related data, or triggering additional UI updates.
172+
173+
**Event Arguments**
174+
175+
The event uses the [AutofillActionEndEventArgs](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Spreadsheet.AutofillActionEndEventArgs.html) class, which includes the following properties:
176+
177+
| Event Arguments | Description |
178+
|----------------|-------------|
179+
| FillRange (read-only) | The address of the target range where the autofill was applied (e.g., "Sheet1!A2:A5"). |
180+
| DataRange (read-only) | The source data range used for the autofill operation (e.g., "Sheet1!A1:A1"). |
181+
| Direction (read-only) | The direction of the autofill operation ("Down", "Right", "Up", or "Left"). |
182+
183+
{% tabs %}
184+
{% highlight razor tabtitle="Index.razor" %}
185+
186+
@using Syncfusion.Blazor.Spreadsheet
187+
188+
<SfSpreadsheet DataSource="DataSourceBytes" AutofillActionEnd="OnAutofillActionEnd">
189+
<SpreadsheetRibbon></SpreadsheetRibbon>
190+
</SfSpreadsheet>
191+
192+
@code {
193+
public byte[] DataSourceBytes { get; set; }
194+
195+
protected override void OnInitialized()
196+
{
197+
string filePath = "wwwroot/Sample.xlsx";
198+
DataSourceBytes = File.ReadAllBytes(filePath);
199+
}
200+
201+
public void OnAutofillActionEnd(AutofillActionEndEventArgs args)
202+
{
203+
// Log or process the completed autofill operation.
204+
Console.WriteLine($"Autofill completed for range: {args.FillRange}");
205+
}
206+
}
207+
208+
{% endhighlight %}
209+
{% endtabs %}
210+
105211
## Clear
106212

107213
Clear support helps clear the cell contents (formulas and data) and formats (including number formats) in a Spreadsheet. When **Clear All** is applied, both the contents and the formats will be cleared simultaneously.
-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

0 commit comments

Comments
 (0)