diff --git a/Document-Processing/Excel/Spreadsheet/Blazor/accessibility.md b/Document-Processing/Excel/Spreadsheet/Blazor/accessibility.md index eb55876d0..d32d15612 100644 --- a/Document-Processing/Excel/Spreadsheet/Blazor/accessibility.md +++ b/Document-Processing/Excel/Spreadsheet/Blazor/accessibility.md @@ -1,7 +1,7 @@ --- layout: post title: Accessibility in Blazor Spreadsheet Component | Syncfusion -description: Checkout and learn here all about accessibility in Syncfusion Blazor Spreadsheet component and much more. +description: Learn about accessibility support in the Syncfusion Blazor Spreadsheet component, including WCAG 2.2, Section 508, keyboard shortcuts, and WAI-ARIA attributes. platform: document-processing control: Spreadsheet documentation: ug @@ -9,9 +9,17 @@ documentation: ug # Accessibility in Blazor Spreadsheet -The Syncfusion Blazor Spreadsheet 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. - -The accessibility compliance for the Spreadsheet is outlined below. +The Syncfusion Blazor Spreadsheet follows 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/), and [WAI-ARIA](https://www.w3.org/TR/wai-aria/#roles) roles that are commonly used to evaluate accessibility. + +The accessibility compliance for the Spreadsheet component is outlined below. +
Yes - All features of the component meet the requirement.
+
Intermediate - Some features of the component do not meet the requirement.
+
No - The component does not meet the requirement.
| Accessibility Criteria | Compatibility | | -- | -- | @@ -24,39 +32,27 @@ The accessibility compliance for the Spreadsheet is outlined below. | [Keyboard Navigation Support](https://blazor.syncfusion.com/documentation/common/accessibility#keyboard-navigation-support) |Intermediate | | [Axe-core Accessibility Validation](https://blazor.syncfusion.com/documentation/common/accessibility#ensuring-accessibility) | Intermediate | - -
Yes - All features of the component meet the requirement.
- -
Intermediate - Some features of the component do not meet the requirement.
- -
No - The component does not meet the requirement.
- ## WAI-ARIA attributes -The Syncfusion Blazor Spreadsheet followed the WAI-ARIA patterns to meet the accessibility. The following ARIA attributes are used in the Spreadsheet: +The Syncfusion Blazor Spreadsheet follows WAI-ARIA patterns to meet accessibility standards. The following ARIA attributes are used in the Spreadsheet component: | Attributes | Purpose | |---------------|-------------| | `role=textbox` | Identifies an element as an input field that allows text entry.| -| `role=button` | To represent the element that acts as a button in the component. | +| `role=button` | Identifies an element that functions as a button. | | `role=combobox` | Identifies a component that combines a text input with a popup listbox or tree. | | `role=menu` | Defines a container for a collection of choices or commands presented in a contextual or dropdown format. | -| `role=alert` | Designates an element that displays im portant, time-sensitive information. | +| `role=alert` | Designates an element that displays important, time-sensitive information. | | `aria-label`| This attribute describes the accessible name for the interactive elements. | -| `aria-expanded` | This attribute describes the control (for example, dropdown) is expanded or collapsed. | +| `aria-expanded` | Indicates whether a collapsible element (e.g., a dropdown) is currently expanded or collapsed. | | `aria-live` | Defines a region as "live", meaning its content updates dynamically. Values include "off", "polite" (waits until idle), or "assertive" (announces immediately). | -| `aria-rowindex` | Defines row index of the row with respect to the total number of rows within the Spreadsheet. | -| `aria-colindex` | Defines the column index of the column with respect to the total number of columns within the Spreadsheet. | +| `aria-rowindex` | Defines the row index of a row with respect to the total number of rows in the Spreadsheet. | +| `aria-colindex` | Defines the column index of a column with respect to the total number of columns in the Spreadsheet. | | `aria-multiline` | Indicates whether a textbox accepts multiple lines of input or only a single line. | ## Keyboard shortcuts -The Syncfusion Blazor Spreadsheet followed keyboard interaction guidelines, making it accessible for people who use assistive technologies (AT) and those who completely rely on keyboard navigation. The following keyboard shortcuts are supported by the Spreadsheet. +The Syncfusion Blazor Spreadsheet follows keyboard interaction guidelines, making it accessible for people who use assistive technologies (AT) and those who rely on keyboard navigation. The following keyboard shortcuts are supported by the Spreadsheet. Clipboard @@ -86,27 +82,27 @@ The Syncfusion Blazor Spreadsheet followed keyboard interaction guidelines, maki |-----|----- | -----| | Page Up / Page Down | Fn + ↑ / ↓ |Scrolls up or down one screen at a time.| | Arrow keys | Arrow keys | Navigates between adjacent cells in the direction of the arrow key.| -| Enter | Enter | Moves the selection to the cell below.| -| Shift + Enter | ⇧ + Enter | Moves the selection to the cell above.| -| Tab | Tab | Moves the selection to the cell on the right.| -| Shift + Tab | ⇧ + Tab | Moves the selection to the cell on the left.| +| Enter | Enter | Moves the active cell down one row.| +| Shift + Enter | ⇧ + Enter | Moves the active cell up one row.| +| Tab | Tab | Moves the active cell right one column.| +| Shift + Tab | ⇧ + Tab | Moves the active cell left one column.| Editing | Windows | MAC | Actions | |-----|----- | -----| -| F2 | F2 | Begin typing in the selected cell.| -| Enter | Enter | Finish typing in the current cell and move to the one below.| -| Shift + Enter | ⇧ + Enter | Finish typing in the current cell and move to the one above.| -| Tab | Tab | Finish typing in the current cell and move to the one on the right. | -| Shift + Tab | ⇧ + Tab |Finish typing in the current cell and move to the one on the left.| -| Escape | Esc | Cancel editing and return to the original value in the cell.| +| F2 | F2 | Enters edit mode for the selected cell.| +| Enter | Enter | Confirms the edit and moves the active cell down one row.| +| Shift + Enter | ⇧ + Enter | Confirms the edit and moves the active cell up one row.| +| Tab | Tab | Confirms the edit and moves the active cell right one column. | +| Shift + Tab | ⇧ + Tab | Confirms the edit and moves the active cell left one column.| +| Escape | Esc | Cancels the edit and restores the cell's original value.| Clear | Windows | MAC | Actions | |-----|----- | -----| -| Delete | Delete | Clear contents of the selected cells.| +| Delete | Delete | Clears the contents of the selected cells.| Hyperlink diff --git a/Document-Processing/Excel/Spreadsheet/Blazor/cell-range.md b/Document-Processing/Excel/Spreadsheet/Blazor/cell-range.md index 221fddb91..76c36bab6 100644 --- a/Document-Processing/Excel/Spreadsheet/Blazor/cell-range.md +++ b/Document-Processing/Excel/Spreadsheet/Blazor/cell-range.md @@ -1,19 +1,18 @@ --- layout: post -title: Managing Cell Ranges in Blazor Spreadsheet component | Syncfusion -description: Checkout and learn to manage cell range features such as formatting, autofill, and clear options in the Syncfusion Blazor Spreadsheet component and more. +title: Managing Cell Ranges in the Blazor Spreadsheet Component | Syncfusion +description: Check out and learn to manage cell range features such as formatting, autofill, and clear options in the Syncfusion Blazor Spreadsheet component and more. platform: document-processing control: Spreadsheet documentation: ug --- # Managing Cell Ranges in Blazor Spreadsheet component - -A cell range refers to a group of selected cells in a Spreadsheet that can be manipulated or processed collectively. +A cell range is a set of selected cells in a Spreadsheet, typically specified using A1 notation (for example, `A1:B10`). A range may be a single cell or a contiguous block of cells that can be manipulated or processed collectively. ## Cell formatting -Cell formatting enhances the visual presentation of data in a Spreadsheet by applying styles such as font changes, colors, borders, and alignment to individual cells or cell ranges. This helps in organizing and emphasizing important information effectively. +Cell formatting enhances the visual presentation of data by applying styles such as font changes, colors, borders, and alignment to individual cells or cell ranges. This helps organize content and emphasize important information for faster interpretation. Cell formatting options include: @@ -21,50 +20,50 @@ Cell formatting options include: * **Italic** - Slants the text to give it a distinct look, often used for emphasis or to highlight differences. -* **Underline** - Adds a line below the text, commonly used for emphasis or to indicate hyperlinks. +* **Underline** - Adds a line below the text, commonly used for emphasis or to indicate hyperlinks. -* **Strikethrough** - Draws a line through the text, often used to show completed tasks or outdated information. +* **Strikethrough** - Draws a line through the text, often used to show completed tasks or outdated information. -* **Font Family** - Changes the typeface of the text (e.g., Arial, Calibri, Times New Roman, and more) to enhance readability or visual appeal. +* **Font Family** - Changes the typeface of the text (e.g., Arial, Calibri, Times New Roman, and more) to enhance readability or visual appeal. -* **Font Size** - Adjusts the size of the text to create visual hierarchy or improve readability in the Spreadsheet. +* **Font Size** - Adjusts the size of the text to create visual hierarchy or improve readability in the Spreadsheet. -* **Font Color** - Changes the color of the text to improve visual hierarchy or to organize information using color codes. +* **Font Color** - Changes the color of the text to improve visual hierarchy or to organize information using color codes. -* **Fill Color** - Adds color to the cell background to visually organize data or highlight important information. +* **Fill Color** - Adds color to the cell background to visually organize data or highlight important information. -* **Horizontal Alignment** - Controls the position of text from left to right within a cell. Options include: +* **Horizontal Alignment** - Controls the position of text from left to right within a cell. Options include: * **Left** - Default for text * **Center** - Useful for headings * **Right** - Default for numbers -* **Vertical Alignment** - Controls the position of text from top to bottom within a cell. Options include: +* **Vertical Alignment** - Controls the position of text from top to bottom within a cell. Options include: * **Top** – Aligns content to the top of the cell * **Middle** – Centers content vertically * **Bottom** – Default alignment -* **Wrap Text** - Displays long content on multiple lines within a single cell, preventing it from overflowing into adjacent cells. +* **Wrap Text** - Displays long content on multiple lines within a single cell, preventing it from overflowing into adjacent cells. -Cell formatting can be applied to or removed from a cell or range of cells by using the formatting options available in the Ribbon toolbar under the **Home** tab. +Cell formatting can be applied or removed from a cell or range by using the options available in the component's built-in **Ribbon** under the **Home** tab. ## Autofill -Autofill is used to fill cells with data based on adjacent cells. It follows patterns from adjacent cells when available, eliminating the need to enter repeated data manually. The [AllowAutofill](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Spreadsheet.SfSpreadsheet.html#Syncfusion_Blazor_Spreadsheet_SfSpreadsheet_AllowAutofill) property can be used to enable or disable the autofill support. +Autofill is used to fill cells with data that follows a pattern or is based on data in other cells. It helps avoid entering repetitive data manually. The [AllowAutofill](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Spreadsheet.SfSpreadsheet.html#Syncfusion_Blazor_Spreadsheet_SfSpreadsheet_AllowAutofill) property can be used to enable or disable this feature. -> * The default value of the `AllowAutofill` property is **true**. +* The default value of the `AllowAutofill` property is **true**. Autofill can be performed in one of the following ways: -* Drag and drop the cell using the fill handle element. -* Use the [AutofillAsync()](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Spreadsheet.SfSpreadsheet.html#Syncfusion_Blazor_Spreadsheet_SfSpreadsheet_AutofillAsync_System_String_System_String_) method programmatically. +* Drag and drop the cell using the fill handle element. +* Use the [AutofillAsync()](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Spreadsheet.SfSpreadsheet.html#Syncfusion_Blazor_Spreadsheet_SfSpreadsheet_AutofillAsync_System_String_System_String_) method programmatically. -The available parameters in the `AutofillAsync()` method are: +The `AutofillAsync()` method accepts string parameters in A1 notation for `fillRange` and `dataRange`. The available parameters are: | Parameter | Type | Description | | -- | -- | -- | -| fillRange | string | Specifies the fill range. | -| dataRange | string | Specifies the data range. | -| direction | string | Specifies the direction ("Up", "Right", "Down", and "Left") to be filled. | +| fillRange | string | Specifies the fill range in A1 notation (e.g., "A1:A5"). | +| dataRange | string | Specifies the source data range in A1 notation (e.g., "B1:B5"). | +| direction | string | Specifies the direction to be filled ("Up", "Right", "Down", or "Left"). | ### Implementing autofill programmatically @@ -104,21 +103,21 @@ The following illustration demonstrates the use of autofill in the Spreadsheet c ## Clear -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. +The clear functionality helps remove cell contents (formulas and data), formats (including number formats), and hyperlinks from a selected range. ### Applying the clear functionality The clear support can be applied using the following way: -* Select the **Clear** icon in the Ribbon toolbar under the **Home** tab. +You can apply the clear functionality by selecting the **Clear** icon in the **Ribbon** under the **Home** tab. -| Options | Uses | +| Option | Use | | -- | -- | -| **Clear All** | Used to clear all contents, formats, and hyperlinks. | -| **Clear Formats** | Used to clear the formats (including number formats) in a cell. | -| **Clear Contents** | Used to clear the contents (formulas and data) in a cell. | -| **Clear Hyperlinks** | Used to clear the hyperlink in a cell. | +| **Clear All** | Clears all contents, formats, and hyperlinks. | +| **Clear Formats** | Clears only the formatting from the selected cells. | +| **Clear Contents** | Clears only the contents (formulas and data) from the selected cells. | +| **Clear Hyperlinks** | Clears only the hyperlinks from the selected cells. | The following image displays the clear options available in the Ribbon toolbar under the **Home** tab of the Blazor Spreadsheet. -![Clear options in the Blazor Spreadsheet](images/clear-feature.png) \ No newline at end of file +![Clear options in the Blazor Spreadsheet](images/clear-feature.png) diff --git a/Document-Processing/Excel/Spreadsheet/Blazor/clipboard.md b/Document-Processing/Excel/Spreadsheet/Blazor/clipboard.md index d99efb252..79dcbc1b1 100644 --- a/Document-Processing/Excel/Spreadsheet/Blazor/clipboard.md +++ b/Document-Processing/Excel/Spreadsheet/Blazor/clipboard.md @@ -1,19 +1,18 @@ --- layout: post title: Clipboard in Blazor Spreadsheet component | Syncfusion -description: Checkout and learn here all about the clipboard functionalities in the Syncfusion Blazor Spreadsheet component and more. -platform: document-processing +description: Explore the clipboard functionalities in the Syncfusion Blazor Spreadsheet component, including cut, copy, and paste operations via UI and programmatic methods. control: Spreadsheet documentation: ug --- # Clipboard in Blazor Spreadsheet component -The Spreadsheet supports clipboard operations such as **Cut**, **Copy**, and **Paste**. These operations can be enabled or disabled using the [EnableClipboard](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Spreadsheet.SfSpreadsheet.html#Syncfusion_Blazor_Spreadsheet_SfSpreadsheet_EnableClipboard) property of the Spreadsheet component. By default, the `EnableClipboard` property is set to **true**. +The Spreadsheet component supports clipboard operations such as **Cut**, **Copy**, and **Paste**. These operations can be managed using the [EnableClipboard](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Spreadsheet.SfSpreadsheet.html#Syncfusion_Blazor_Spreadsheet_SfSpreadsheet_EnableClipboard) property, which is set to **true** by default. The keyboard shortcuts are available to perform clipboard operations efficiently within the Spreadsheet component. `Ctrl+C` copies the selected cells, `Ctrl+X` cuts the selected cells, and `Ctrl+V` pastes the content from the clipboard. -When `EnableClipboard` is set to **false**, the **Cut** and **Copy** options are removed from the user interface (Ribbon and Context Menu). In addition, shortcut keys (**Ctrl+C, Ctrl+X, Ctrl+V**) and API methods will not work. If the worksheet is protected, clipboard operations such as cut and paste are also disabled. For more information on worksheet protection, refer [here](./protection#protect-sheet). +When `EnableClipboard` is set to **false**, the **Cut** and **Copy** options are removed from the Ribbon and Context Menu. Additionally, shortcut keys and API methods for clipboard operations are disabled. If a worksheet is protected, cut and paste operations are also disabled. For more details on worksheet protection, refer to the [Worksheet Protection](./protection#protect-sheet) topic. ## Cut @@ -25,14 +24,14 @@ The **Cut** operation can be performed through the user interface (UI) using any **Using the Ribbon** -- Select a cell or range of cells to cut the content. -- Click the **Cut** button in the **Home** tab of the **Ribbon** toolbar. This action removes the selected cell or range of cells and places the content on the clipboard. +- Select the cell or range of cells to cut. +- Click the **Cut** button in the **Home** tab of the **Ribbon**. This action cuts the selected content and places it on the clipboard. ![Cut - Ribbon](images/cut-copy.png) **Using the Context Menu** -- Select a cell or range of cells to cut the content. +- Select the cell or range of cells to cut the content. - Right-click on the selected cell or range of cells. - Choose the **Cut** option from the context menu. @@ -42,7 +41,7 @@ The **Cut** operation can be performed through the user interface (UI) using any The [CutCellAsync](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Spreadsheet.SfSpreadsheet.html#Syncfusion_Blazor_Spreadsheet_SfSpreadsheet_CutCellAsync_System_String_) method allows performing cut operations within any sheet. This method copies the specified cell or range and its properties (including value, format, style, etc.) to the clipboard and removes it from the sheet. It supports multiple scenarios for cutting cells or ranges. Below are the details for each scenario, including code examples and parameter information. -> The **Cut** operation will not execute if invalid or out-of-boundary cell ranges are specified. All cell references must fall within the defined worksheet boundaries to ensure successful execution of the operation. +> The **Cut** operation will not execute if an invalid or out-of-bounds cell range is specified. All cell references must be within the defined worksheet boundaries to ensure successful execution of the operation. **Cut active range** @@ -182,12 +181,12 @@ The **Copy** operation duplicates data from a selected range of cells, rows, or ### Copy operations via UI -The copy operation can be performed through the user interface (UI) using any of the following methods: +The copy operation can be performed through the UI using one of the following methods: **Using the Ribbon** - Select the cell or range of cells to copy. -- Click the **Copy** button in the **Home** tab of the **Ribbon** toolbar. This action duplicates the selected cell or range of cells and places the content on the clipboard. +- Click the **Copy** button in the **Home** tab of the **Ribbon**. This action duplicates the selected cell or range of cells and places the content on the clipboard. ![Copy - Ribbon](images/cut-copy.png) @@ -203,7 +202,7 @@ The copy operation can be performed through the user interface (UI) using any of The [CopyCellAsync](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Spreadsheet.SfSpreadsheet.html#Syncfusion_Blazor_Spreadsheet_SfSpreadsheet_CopyCellAsync_System_String_) method enables performing copy operations within any sheet. This method copies the specified cell or range of cells along with its properties (including value, format, style, etc.) to the clipboard. It supports multiple scenarios for copying cells or ranges. Below are the details for each scenario, including code examples and parameter information. -> The **Copy** operation will not execute if invalid or out-of-boundary cell ranges are specified. All cell addresses must fall within the valid boundaries of the worksheet to ensure successful execution of the operation. +> The **Copy** operation will not execute if an invalid or out-of-bounds cell range is specified. All cell references must be within the defined worksheet boundaries to ensure successful execution of the operation. **Copy active range** @@ -274,13 +273,13 @@ The available parameters in the `CopyCellAsync` method are: public async Task CopyCell() { - // The specified cell is copied from the active worksheet. + // Copies the specified cell from the active worksheet. await SpreadsheetInstance.CopyCellAsync("A2"); } public async Task CopyRange() { - // A specified range of cells is copied from the active worksheet. + // Copies a specified range of cells from the active worksheet. await SpreadsheetInstance.CopyCellAsync("A1:D10"); } } @@ -328,7 +327,7 @@ The available parameters in the `CopyCellAsync` method are: public async Task CopyRangeFromSpecificSheet() { - // A specified range of cells is copied from the designated worksheet. + // Copies a specified range of cells from the designated worksheet. await SpreadsheetInstance.CopyCellAsync("Sheet2!B3:E8"); } } @@ -340,18 +339,18 @@ The available parameters in the `CopyCellAsync` method are: The paste operation inserts data from the clipboard into a selected range of cells, rows, or columns, retaining all relevant details such as values, formats, and styles. When performing a **Cut** followed by **Paste**, the clipboard is cleared after the data is transferred. In contrast, with a **Copy** followed by **Paste**, the clipboard contents remain available for reuse. -**External clipboard** support is provided, allowing content to be pasted not only from within the spreadsheet but also from external sources such as Google Sheets, Microsoft Excel, Word documents, plain text files, and web pages. +**External clipboard** support allows pasting content from external sources like Google Sheets, Microsoft Excel, text files, and web pages. ### Paste operations via UI -The paste operation can be performed through the user interface (UI) using any of the following methods: +The paste operation can be performed through the UI using one of the following methods: **Using the Ribbon** - A cell must be selected or a range of cells highlighted before initiating the paste operation. - The **Paste** button located in the **Home** tab of the **Ribbon** toolbar must be clicked to perform the paste action. - The values previously cut or copied from the clipboard will be inserted into the selected range. -- If the clipboard does not contain any values, the **Paste** option will remain disabled. +- The **Paste** option is disabled if the clipboard is empty. ![Paste - Ribbon](./images/cutcopypaste.png) @@ -360,25 +359,25 @@ The paste operation can be performed through the user interface (UI) using any o - A cell must be clicked or a range of cells selected before initiating the paste operation. - The **Paste** option must be selected from the context menu accessed via right-click. - The values previously cut or copied from the clipboard will be inserted into the selected range. -- If the clipboard does not contain any values, the **Paste** option will remain disabled. +- The **Paste** option is disabled if the clipboard is empty. ![Paste - Context Menu](./images/contextcutcopypaste.png) ### Paste operations programmatically -The [PasteCellAsync](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Spreadsheet.SfSpreadsheet.html#Syncfusion_Blazor_Spreadsheet_SfSpreadsheet_PasteCellAsync_System_String_) method pastes the clipboard content into a specified cell or range of cells and preserves all associated properties (including value, format, style, etc.). When the source range is larger than the specified target range, all data from the source will still be pasted. The paste operation automatically extends beyond the defined target boundaries and overrides the content in the expanded area to match the full dimensions of the source. +The [PasteCellAsync](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Spreadsheet.SfSpreadsheet.html#Syncfusion_Blazor_Spreadsheet_SfSpreadsheet_PasteCellAsync_System_String_) method pastes clipboard content into a specified cell or range, preserving all properties (value, format, style, etc.). If the source range is larger than the target range, the paste operation extends beyond the target's boundaries to accommodate the full source content, overwriting any data in the expanded area. **Example** - Source Range: **"Sheet1!A1:C3"** (3 rows × 3 columns) - Target Range: **"Sheet2!B2"** (single cell) -In this case, although only a single cell is selected as the target, the paste operation overrides the range **"Sheet2!B2:D4"** to match the full 3×3 source content. +Pasting this content will overwrite the range **"Sheet2!B2:D4"** to match the 3×3 source content. > The **Paste** operation will not be executed if invalid or out-of-boundary cell ranges are specified. All cell addresses must fall within the valid boundaries of the worksheet to ensure successful execution of the paste action. **Paste to active range** -When the `PasteCellAsync` method is invoked without any parameters, the content is automatically pasted into the last selected range, provided an active selection exists. If no range is selected, the content is pasted into the active cell. +When `PasteCellAsync` is invoked without parameters, the content is pasted into the last selected range. If no range is selected, the content is pasted into the active cell. {% tabs %} {% highlight razor %} @@ -403,7 +402,7 @@ When the `PasteCellAsync` method is invoked without any parameters, the content public async Task PasteActiveCell() { - // The content is pasted into the currently active cell or range. + // Pastes the content into the currently active cell or range. await SpreadsheetInstance.PasteCellAsync(); } } @@ -413,7 +412,7 @@ When the `PasteCellAsync` method is invoked without any parameters, the content **Paste to specific range in active sheet** -To paste content into specific range in the current active sheet, provide the target cell address as a parameter to the `PasteCellAsync` method. A valid cell selection must exist prior to executing the paste operation. Either a single cell or a range of cells can be specified as the destination. +To paste content into a specific range in the active sheet, provide the target cell address or range as a parameter to the `PasteCellAsync` method. A valid cell selection must exist prior to executing the paste operation. Either a single cell or a range of cells can be specified as the destination. The available parameters in the `PasteCellAsync` method are: @@ -446,13 +445,13 @@ The available parameters in the `PasteCellAsync` method are: public async Task PasteCell() { - // The clipboard content is pasted into the specified cell. + // Pastes the clipboard content into the specified cell. await SpreadsheetInstance.PasteCellAsync("A2"); } public async Task PasteRange() { - // The clipboard content is pasted into the specified range of cells. + // Pastes the clipboard content into the specified range of cells. await SpreadsheetInstance.PasteCellAsync("A2:B5"); } @@ -503,7 +502,7 @@ The available parameters in the `PasteCellAsync` method are: public async Task PasteCellToTargetSheet() { - // The cell address, including the sheet name, is used as the paste destination + // The cell address, including the sheet name, is used as the paste destination. await SpreadsheetInstance.PasteCellAsync("Sheet1!B2"); } } @@ -513,7 +512,7 @@ The available parameters in the `PasteCellAsync` method are: ## Events -The Blazor Spreadsheet provides events that are triggered during the clipboard action such as [CutCopyActionBegin](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Spreadsheet.CutCopyActionBeginEventArgs.html) and [Pasting](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Spreadsheet.PastingEventArgs.html). These events can be used to perform any custom actions before the clipboard action starts or interacted with, allowing for validation, customization, and response handling. +The Blazor Spreadsheet provides events that trigger during clipboard actions: [CutCopyActionBegin](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Spreadsheet.CutCopyActionBeginEventArgs.html) and [Pasting](https://help.syncfusion.com/cr/blazor/Syncfusion.Blazor.Spreadsheet.PastingEventArgs.html). These events allow for validation, customization, and other custom actions before the clipboard operation is executed. * **CutCopyActionBegin** - `CutCopyActionBegin` event is triggered before a cut or copy operation is initiated. * **Pasting** - `Pasting` event is triggered prior to the initiation of a paste operation. @@ -524,11 +523,11 @@ The `CutCopyActionBegin` event is triggered before a copy or cut operation is pe **Purpose** -This event addresses scenarios that require monitoring or restriction of clipboard operations, such as preventing sensitive data from being copied, logging clipboard activities for audit and compliance purposes, enforcing custom validation rules for designated cells or ranges, and restricting cut operations while allowing copy functionality. +This event is useful for monitoring clipboard activities, preventing sensitive data from being copied, validating operations, or selectively restricting cut and copy actions based on custom logic. **Event Arguments** -The `CutCopyActionBeginEventArgs` includes the following properties: +`CutCopyActionBeginEventArgs` includes the following properties: | Event Arguments | Description | |----------------|-------------| @@ -556,7 +555,7 @@ The `CutCopyActionBeginEventArgs` includes the following properties: public void OnCutCopyActionBegin(CutCopyActionBeginEventArgs args) { - // Cancels the cut or copy operation. + // Cancels any cut or copy operation. args.Cancel = true; } } @@ -574,7 +573,7 @@ This event is applicable in scenarios that require control over paste operations **Event Arguments** -The `PastingEventArgs` includes the following properties: +`PastingEventArgs` includes the following properties: | Event Arguments | Description | |----------------|-------------| diff --git a/Document-Processing/Excel/Spreadsheet/Blazor/contextmenu.md b/Document-Processing/Excel/Spreadsheet/Blazor/contextmenu.md index 56d98eb6a..9d49f4ca7 100644 --- a/Document-Processing/Excel/Spreadsheet/Blazor/contextmenu.md +++ b/Document-Processing/Excel/Spreadsheet/Blazor/contextmenu.md @@ -1,8 +1,7 @@ --- layout: post title: Context Menu in Blazor Spreadsheet component | Syncfusion -description: Checkout and learn here about the context menu functionality in the Syncfusion Blazor Spreadsheet component and more. -platform: document-processing +description: Explore the context menu functionality in the Syncfusion Blazor Spreadsheet component, including options for cells, rows, columns, and sheet tabs. control: Spreadsheet documentation: ug --- @@ -13,7 +12,8 @@ The context menu enhances interaction with the Syncfusion Blazor Spreadsheet com N> When the `EnableContextMenu` property is set to **false**, the context menu does not appear upon right-clicking any element in the component. -## Context menu options categorized by element + +## Context Menu Options Based on Spreadsheet Element Type The context menu options are dynamically adjusted based on the specific element in the Spreadsheet that is right-clicked. Each element displays context-specific functionality relevant to its type. @@ -65,8 +65,8 @@ When right-clicking a single column header or a range of selected column headers | Cut | Removes data from the selected columns and temporarily stores it on the clipboard for reuse within the Spreadsheet or in an external application. | | Copy | Copies data from the selected columns and temporarily stores it on the clipboard for reuse within the Spreadsheet or in an external application. | | Paste | Inserts data from the clipboard into the Spreadsheet at the current selection. | -| Insert columns to the left | Adds new columns to the left of the selected columns. The number of columns inserted matches the number of columns selected. | -| Insert columns to the right | Adds new columns to the right of the selected columns. The number of columns inserted matches the number of columns selected. | +| Insert column to the left | Adds a new column to the left of the selected column. The number of columns inserted matches the number of columns selected. | +| Insert column to the right | Adds a new column to the right of the selected column. The number of columns inserted matches the number of columns selected. | ![Context menu options for column-header](./images/contextmenu-column.png) @@ -91,7 +91,7 @@ When right-clicking on a sheet tab located at the bottom of the Spreadsheet, the ![Context menu options for sheet tab](./images/contextmenu-sheettab.png) -Sheet tab context menu behavior is controlled by workbook-level protection. In protected workbook, only the **Protect Sheet** or **Unprotect Sheet** option remains active. All other options like **Insert**, **Delete**, **Rename**, **Move Right**, **Move Left**, **Hide**, and **Duplicate** are disabled to preserve workbook structure. +Sheet tab context menu behavior is controlled by workbook-level protection. In a protected workbook, only the **Protect Sheet** or **Unprotect Sheet** option remains active. All other options like **Insert**, **Delete**, **Rename**, **Move Right**, **Move Left**, **Hide**, and **Duplicate** are disabled to preserve workbook structure. ## Properties that influence context menu options @@ -126,4 +126,4 @@ These properties control specific context menu functionality: } {% endhighlight %} -{% endtabs %} \ No newline at end of file +{% endtabs %}