diff --git a/ej2-asp-core-mvc/code-snippet/rich-text-editor/code-block/controller.cs b/ej2-asp-core-mvc/code-snippet/rich-text-editor/code-block/controller.cs new file mode 100644 index 0000000000..2e1a07508d --- /dev/null +++ b/ej2-asp-core-mvc/code-snippet/rich-text-editor/code-block/controller.cs @@ -0,0 +1,15 @@ +public class HomeController : Controller +{ + + public ActionResult Index() + { + ViewBag.items = new[] { "Undo", "Redo", "|", "CodeBlock", "|", "Bold", "Italic", "Underline", "StrikeThrough", "InlineCode", "|", "CreateLink", "Image", "CreateTable", "Blockquote", "|", "BulletFormatList", "NumberFormatList", "|", "Formats", "Alignments", "|", "Outdent", "Indent", "|", + "FontColor", "BackgroundColor", "FontName", "FontSize", "|", "LowerCase", "UpperCase", "|", "EmojiPicker", "|", "SourceCode" }; + ViewBag.languages = new[] { + new {label= "HTML", language= "html"}, + new {label= "JavaScript", language= "javascript"}, + new {label= "CSS", language= "css"}, + new {label= "Plain Text", language= "plaintext"}}; + return View(); + } +} \ No newline at end of file diff --git a/ej2-asp-core-mvc/code-snippet/rich-text-editor/code-block/razor b/ej2-asp-core-mvc/code-snippet/rich-text-editor/code-block/razor new file mode 100644 index 0000000000..eda6ccaf47 --- /dev/null +++ b/ej2-asp-core-mvc/code-snippet/rich-text-editor/code-block/razor @@ -0,0 +1 @@ +@Html.EJS().RichTextEditor("code-block").ToolbarSettings(e => { e.Items((object)ViewBag.items); }).CodeBlockSettings(e => { e.Languages((object)ViewBag.languages); e.DefaultLanguage("plaintext"); }).Placeholder("Type something...").Render() \ No newline at end of file diff --git a/ej2-asp-core-mvc/code-snippet/rich-text-editor/code-block/tagHelper b/ej2-asp-core-mvc/code-snippet/rich-text-editor/code-block/tagHelper new file mode 100644 index 0000000000..39f310100c --- /dev/null +++ b/ej2-asp-core-mvc/code-snippet/rich-text-editor/code-block/tagHelper @@ -0,0 +1,4 @@ + + + + \ No newline at end of file diff --git a/ej2-asp-core-mvc/rich-text-editor/EJ2_ASP.MVC/code-block.md b/ej2-asp-core-mvc/rich-text-editor/EJ2_ASP.MVC/code-block.md new file mode 100644 index 0000000000..d2d1116267 --- /dev/null +++ b/ej2-asp-core-mvc/rich-text-editor/EJ2_ASP.MVC/code-block.md @@ -0,0 +1,80 @@ +--- +layout: post +title: Code Block in ##Platform_Name## Rich Text Editor Component | Syncfusion +description: Learn here all about Code Block in Syncfusion ##Platform_Name## Rich Text Editor component of Syncfusion Essential JS 2 and more. +platform: ej2-asp-core-mvc +control: Code Block +publishingplatform: ##Platform_Name## +documentation: ug +--- + +# Code Block in ##Platform_Name## Rich Text Editor control + +The Code Block feature in the Rich Text Editor, enabling users to insert and format code snippets effectively. It covers configuring supported languages, integrating syntax highlighters, editing tips, and enabling tab-based indentation, making it ideal for technical documentation, tutorials, and code-heavy content. While live code block highlighting is not supported during editing, syntax highlighting can be applied when content is displayed on the frontend. + +## Inserting a code block + +The Code Block feature allows users to embed formatted code snippets within the Rich Text Editor. To insert a code block: + +- **Using the Toolbar**: Click the **CodeBlock** button in the editor’s toolbar, typically represented by a code icon. +- **Using the Shortcut**: Press `Ctrl+Shift+B` (or `Cmd+Shift+B` on macOS) to insert a code block at the cursor’s position. +- A dropdown menu appears, allowing selection of the programming language for the code block, such as **JavaScript**, **Python**, **HTML**, or others configured in the system. + +The code block is rendered with a monospaced font and preserved indentation for readability. Language selection applies syntax-specific formatting and prepares the block for syntax highlighting when displayed on the frontend. + +## Configuring code block languages + +The Code Block feature supports customizable programming languages via the `CodeBlockSettings` property, specifically the `Languages` and `DefaultLanguage` options. The `Languages` property accepts an array of objects defining available languages, while `DefaultLanguage` sets the default language for new code blocks. This allows developers to customize the editor for project-specific languages. + +Below is an example of how to configure the `CodeBlockSettings` using the Rich Text Editor: + +{% if page.publishingplatform == "aspnet-core" %} + +{% tabs %} +{% highlight cshtml tabtitle="CSHTML" %} +{% include code-snippet/rich-text-editor/code-block/tagHelper %} +{% endhighlight %} +{% highlight c# tabtitle="Controller.cs" %} +{% include code-snippet/rich-text-editor/code-block/controller.cs %} +{% endhighlight %} +{% endtabs %} + +{% elsif page.publishingplatform == "aspnet-mvc" %} + +{% tabs %} +{% highlight razor tabtitle="CSHTML" %} +{% include code-snippet/rich-text-editor/code-block/razor %} +{% endhighlight %} +{% highlight c# tabtitle="Controller.cs" %} +{% include code-snippet/rich-text-editor/code-block/controller.cs %} +{% endhighlight %} +{% endtabs %} +{% endif %} + +In this example: + +* The **Languages** array defines four supported languages: JavaScript, Python, HTML, and CSS. +* The **DefaultLanguage** is set to **javascript**, so new code blocks default to JavaScript. +* Each language object specifies a **language** (for internal use, e.g., syntax highlighting) and a **label** (displayed in the dropdown). + +## Integrating syntax highlighters + +To enhance code block readability, integrate a third-party syntax highlighter like [Prism.js](https://prismjs.com/) or [Highlight.js](https://highlightjs.org/), which supports numerous languages and customizable themes. Although live code block highlighting (real-time syntax highlighting during editing) is not possible in the Rich Text Editor, The highlighter can apply color-coded formatting to code blocks when the content is displayed on the frontend, such as in blog posts, website content, or preview mode. This ensures a polished presentation for end users. + +## Tips for editing around code blocks + +Editing content around code blocks requires care to preserve code integrity and maintain clean formatting. Follow these tips for a smooth editing experience: +* **Inserting Text Before a Code Block**: Place the cursor at the start of the code block’s first line and press `Enter` to create an empty line above. Press Enter again to start a new paragraph for text. +* **Inserting Text After a Code Block**: Place the cursor at the end of the code block’s last line and press `Enter` three times to exit the code block and create a new paragraph below. +* **Preserving Formatting When Pasting**: Paste code into a code block using `Ctrl+Shift+V` (or `Cmd+Shift+V` on macOS) to avoid external formatting (e.g., fonts or colors) and maintain the monospaced style. +* **Changing Languages**: When switching the language of a code block via the dropdown, verify that the code aligns with the new language for accurate syntax highlighting in the rendered output. +* **Previewing Content**: Since live syntax highlighting is not available during editing, use the editor’s preview mode to verify how code blocks render with syntax highlighting before publishing. + +## Enabling tab-based line indentation in code blocks + +The Code Block feature supports tab-based indentation to align code properly, crucial for languages like Python where indentation is syntactically significant. The Rich Text Editor does not provide a specific property to configure the indentation character, but indentation can be enabled using the editor’s default behavior for the Tab key, toolbar commands, or custom event handling. + +To enable tab-based indentation: + +* **Using the Tab Key**: Pressing `Tab` within a code block typically inserts a tab character (\t) or spaces (usually four, depending on the editor’s default configuration). Use `Shift+Tab` to outdent selected lines. +* **Toolbar Commands**: Include the `Indent` and `Outdent` buttons in the toolbar to increase or decrease indentation. diff --git a/ej2-asp-core-mvc/rich-text-editor/EJ2_ASP.NETCORE/code-block.md b/ej2-asp-core-mvc/rich-text-editor/EJ2_ASP.NETCORE/code-block.md new file mode 100644 index 0000000000..fb0d0fac92 --- /dev/null +++ b/ej2-asp-core-mvc/rich-text-editor/EJ2_ASP.NETCORE/code-block.md @@ -0,0 +1,80 @@ +--- +layout: post +title: Code Block in ##Platform_Name## Rich Text Editor control | Syncfusion +description: Learn here all about Code Block in Syncfusion ##Platform_Name## Rich Text Editor control of Syncfusion Essential JS 2 and more. +platform: ej2-asp-core-mvc +control: Code Block +publishingplatform: ##Platform_Name## +documentation: ug +--- + +# Code Block in ##Platform_Name## Rich Text Editor control + +The Code Block feature in the Rich Text Editor, enabling users to insert and format code snippets effectively. It covers configuring supported languages, integrating syntax highlighters, editing tips, and enabling tab-based indentation, making it ideal for technical documentation, tutorials, and code-heavy content. While live code block highlighting is not supported during editing, syntax highlighting can be applied when content is displayed on the frontend. + +## Inserting a code block + +The Code Block feature allows users to embed formatted code snippets within the Rich Text Editor. To insert a code block: + +- **Using the Toolbar**: Click the **CodeBlock** button in the editor’s toolbar, typically represented by a code icon. +- **Using the Shortcut**: Press `Ctrl+Shift+B` (or `Cmd+Shift+B` on macOS) to insert a code block at the cursor’s position. +- A dropdown menu appears, allowing selection of the programming language for the code block, such as **JavaScript**, **Python**, **HTML**, or others configured in the system. + +The code block is rendered with a monospaced font and preserved indentation for readability. Language selection applies syntax-specific formatting and prepares the block for syntax highlighting when displayed on the frontend. + +## Configuring code block languages + +The Code Block feature supports customizable programming languages via the [e-richtexteditor-codeblocksettings](https://help.syncfusion.com/cr/aspnetcore-js2/Syncfusion.EJ2.RichTextEditor.RichTextEditorCodeBlockSettings.html) property, specifically the `languages` and `defaultLanguage` options. The `languages` property accepts an array of objects defining available languages, while `defaultLanguage` sets the default language for new code blocks. This allows developers to customize the editor for project-specific languages. + +Below is an example of how to configure the [e-richtexteditor-codeblocksettings](https://help.syncfusion.com/cr/aspnetcore-js2/Syncfusion.EJ2.RichTextEditor.RichTextEditorCodeBlockSettings.html) using the Rich Text Editor: + +{% if page.publishingplatform == "aspnet-core" %} + +{% tabs %} +{% highlight cshtml tabtitle="CSHTML" %} +{% include code-snippet/rich-text-editor/code-block/tagHelper %} +{% endhighlight %} +{% highlight c# tabtitle="Controller.cs" %} +{% include code-snippet/rich-text-editor/code-block/controller.cs %} +{% endhighlight %} +{% endtabs %} + +{% elsif page.publishingplatform == "aspnet-mvc" %} + +{% tabs %} +{% highlight razor tabtitle="CSHTML" %} +{% include code-snippet/rich-text-editor/code-block/razor %} +{% endhighlight %} +{% highlight c# tabtitle="Controller.cs" %} +{% include code-snippet/rich-text-editor/code-block/controller.cs %} +{% endhighlight %} +{% endtabs %} +{% endif %} + +In this example: + +* The **languages** array defines four supported languages: JavaScript, Python, HTML, and CSS. +* The **defaultLanguage** is set to **javascript**, so new code blocks default to JavaScript. +* Each language object specifies a **language** (for internal use, e.g., syntax highlighting) and a **label** (displayed in the dropdown). + +## Integrating syntax highlighters + +To enhance code block readability, integrate a third-party syntax highlighter like [Prism.js](https://prismjs.com/) or [Highlight.js](https://highlightjs.org/), which supports numerous languages and customizable themes. Although live code block highlighting (real-time syntax highlighting during editing) is not possible in the Rich Text Editor, The highlighter can apply color-coded formatting to code blocks when the content is displayed on the frontend, such as in blog posts, website content, or preview mode. This ensures a polished presentation for end users. + +## Tips for editing around code blocks + +Editing content around code blocks requires care to preserve code integrity and maintain clean formatting. Follow these tips for a smooth editing experience: +* **Inserting Text Before a Code Block**: Place the cursor at the start of the code block’s first line and press `Enter` to create an empty line above. Press Enter again to start a new paragraph for text. +* **Inserting Text After a Code Block**: Place the cursor at the end of the code block’s last line and press `Enter` three times to exit the code block and create a new paragraph below. +* **Preserving Formatting When Pasting**: Paste code into a code block using `Ctrl+Shift+V` (or `Cmd+Shift+V` on macOS) to avoid external formatting (e.g., fonts or colors) and maintain the monospaced style. +* **Changing Languages**: When switching the language of a code block via the dropdown, verify that the code aligns with the new language for accurate syntax highlighting in the rendered output. +* **Previewing Content**: Since live syntax highlighting is not available during editing, use the editor’s preview mode to verify how code blocks render with syntax highlighting before publishing. + +## Enabling tab-based line indentation in code blocks + +The Code Block feature supports tab-based indentation to align code properly, crucial for languages like Python where indentation is syntactically significant. The Rich Text Editor does not provide a specific property to configure the indentation character, but indentation can be enabled using the editor’s default behavior for the Tab key, toolbar commands, or custom event handling. + +To enable tab-based indentation: + +* **Using the Tab Key**: Pressing `Tab` within a code block typically inserts a tab character (\t) or spaces (usually four, depending on the editor’s default configuration). Use `Shift+Tab` to outdent selected lines. +* **Toolbar Commands**: Include the `Indent` and `Outdent` buttons in the toolbar to increase or decrease indentation. diff --git a/ej2-asp-core-toc.html b/ej2-asp-core-toc.html index 116f554057..7b9f7e87e7 100644 --- a/ej2-asp-core-toc.html +++ b/ej2-asp-core-toc.html @@ -2392,6 +2392,7 @@
  • List Formatting
  • Link
  • Table
    • +
  • Code Block
  • Remove Formatting
  • Format Painter
  • Paste Cleanup
    • diff --git a/ej2-asp-mvc-toc.html b/ej2-asp-mvc-toc.html index a88286d810..b530cbabeb 100644 --- a/ej2-asp-mvc-toc.html +++ b/ej2-asp-mvc-toc.html @@ -1285,7 +1285,7 @@