Paragraph format in Angular Document editor component
27 Apr 202415 minutes to read
Document Editor supports various paragraph formatting options such as text alignment, indentation, paragraph spacing, and more.
Indentation
You can modify the left or right indentation of selected paragraphs using the following sample code.
this.documentEditor.selection.paragraphFormat.leftIndent= 24;
this.documentEditor.selection.paragraphFormat.rightIndent= 24;Special indentation
You can define special indent for first line of the paragraph using the following sample code.
this.documentEditor.selection.paragraphFormat.firstLineIndent= 24;Increase indent
You can increase the left indent of selected paragraphs by a factor of 36 points using the following sample code.
this.documentEditor.editor.increaseIndent()Decrease indent
You can decrease the left indent of selected paragraphs by a factor of 36 points using the following sample code.
this.documentEditor.editor.decreaseIndent()Text alignment
You can get or set the text alignment of selected paragraphs using the following sample code.
this.documentEditor.selection.paragraphFormat.textAlignment= 'Center' | 'Left' | 'Right' | 'Justify';You can toggle the text alignment of selected paragraphs by specifying a value using the following sample code.
this.documentEditor.editor.toggleTextAlignment('Center' | 'Left' | 'Right' | 'Justify');Line spacing and its type
You can define the line spacing and its type for selected paragraphs using the following sample code.
this.documentEditor.selection.paragraphFormat.lineSpacingType='AtLeast';
this.documentEditor.selection.paragraphFormat.lineSpacing= 6;Paragraph spacing
You can define the spacing before or after the paragraph by using the following sample code.
this.documentEditor.selection.paragraphFormat.beforeSpacing= 24;
this.documentEditor.selection.paragraphFormat.afterSpacing= 24;You can also set automatic spacing before and after the paragraph by using the following sample code.
this.documentEditor.selection.paragraphFormat.spaceBeforeAuto = true;
this.documentEditor.selection.paragraphFormat.spaceAfterAuto = true;Note: If auto spacing property is enabled, then value defined in the
beforeSpacingandafterSpacingproperty will not be considered.
Pagination properties
You can enable or disable the following pagination properties for the paragraphs in a Word document.
- Widow/Orphan control - whether the first and last lines of the paragraph are to remain on the same page as the rest of the paragraph when paginating the document.
- Keep with next - whether the specified paragraph remains on the same page as the paragraph that follows it while paginating the document.
- Keep lines together - whether all lines in the specified paragraphs remain on the same page while paginating the document.
The following example code illustrates how to enable or disable these pagination properties for the selected paragraphs.
this.documenteditor.selection.paragraphFormat.widowControl = false;
this.documenteditor.selection.paragraphFormat.keepWithNext = true;
this.documenteditor.selection.paragraphFormat.keepLinesTogether = true;Paragraph Border
You can apply borders to the paragraphs in a Word document. Using borders, decorate the paragraphs to set them apart from other paragraphs in the document.
The following example code illustrates how to apply box border for the selected paragraphs.
// left
this.documenteditor.selection.paragraphFormat.borders.left.lineStyle = 'Single';
this.documenteditor.selection.paragraphFormat.borders.left.lineWidth = 3;
this.documenteditor.selection.paragraphFormat.borders.left.color = "#000000";
//right
this.documenteditor.selection.paragraphFormat.borders.right.lineStyle = 'Single';
this.documenteditor.selection.paragraphFormat.borders.right.lineWidth = 3;
this.documenteditor.selection.paragraphFormat.borders.right.color = "#000000";
//top
this.documenteditor.selection.paragraphFormat.borders.top.lineStyle = 'Single';
this.documenteditor.selection.paragraphFormat.borders.top.lineWidth = 3;
this.documenteditor.selection.paragraphFormat.borders.top.color = "#000000";
//bottom
this.documenteditor.selection.paragraphFormat.borders.bottom.lineStyle = 'Single';
this.documenteditor.selection.paragraphFormat.borders.bottom.lineWidth = 3;
this.documenteditor.selection.paragraphFormat.borders.bottom.color = "#000000";Note: At present, the Document editor component displays all the border styles as single line. But you can apply any border style and get the proper display in Microsoft Word app when opening the exported Word document.
Show or Hide Paragraph marks
You can show or hide the hidden formatting symbols like spaces, tab, paragraph marks, and breaks in Document editor component. These marks help identify the start and end of a paragraph and all the hidden formatting symbols in a Word document.
The following example code illustrates how to show or hide paragraph marks.
this.documenteditor.documentEditorSettings.showHiddenMarks = true;Toolbar with paragraph formatting options
The following sample demonstrates the paragraph formatting options using a toolbar.
import { NgModule } from '@angular/core'
import { BrowserModule } from '@angular/platform-browser'
import { ButtonModule } from '@syncfusion/ej2-angular-buttons'
import { DocumentEditorAllModule } from '@syncfusion/ej2-angular-documenteditor'
import { ToolbarModule } from '@syncfusion/ej2-angular-navigations'
import { ComboBoxModule } from '@syncfusion/ej2-angular-dropdowns'
import {ColorPickerModule } from '@syncfusion/ej2-angular-inputs'
import { Component, ViewEncapsulation, ViewChild } from '@angular/core';
import {
DocumentEditorComponent, EditorService, SelectionService, EditorHistoryService, SfdtExportService, ContextMenuService
} from '@syncfusion/ej2-angular-documenteditor';
@Component({
imports: [
ButtonModule,
ToolbarModule,
DocumentEditorAllModule,
ComboBoxModule,
ColorPickerModule
],
standalone: true,
selector: 'app-container',
styleUrls: ['./style.css'],
//specifies the template string for the Document Editor component
template: `<div>
<div>
<ejs-toolbar (clicked)='toolbarButtonClick($event)'>
<e-items>
<e-item prefixIcon='e-de-ctnr-alignleft e-icons' id='AlignLeft' tooltipText='Align Left'></e-item>
<e-item prefixIcon='e-de-ctnr-aligncenter e-icons' id='AlignCenter' tooltipText='AlignCenter'></e-item>
<e-item prefixIcon='e-de-ctnr-alignright e-icons' id='AlignRight' tooltipText='AlignRight'></e-item>
<e-item prefixIcon='e-de-ctnr-justify e-icons' id='Justify' tooltipText='Justify'></e-item>
<e-item prefixIcon='e-de-ctnr-increaseindent e-icons' id='IncreaseIndent' tooltipText='Increase Indent'></e-item>
<e-item prefixIcon='e-de-ctnr-decreaseindent e-icons' id='DecreaseIndent' tooltipText='Decrease Indent'></e-item>
<e-item type='Separator'></e-item>
<e-item prefixIcon='e-de-ctnr-clearall e-icons' id='ClearFormat' tooltipText='ClearFormatting'></e-item>
<e-item type='Separator'></e-item>
<e-item prefixIcon='e-de-e-paragraph-mark e-icons' id='ShowParagraphMark' tooltipText='Show the hidden characters like spaces, tab, paragraph marks, and breaks.(Ctrl + *)'></e-item>
</e-items>
</ejs-toolbar>
</div>
<ejs-documenteditor #document_editor (selectionChange)='onSelectionChange()' [enableSelection]='true' [isReadOnly]='false' [enableEditor]=true [enableEditorHistory]=true [enableSfdtExport]=true [enableContextMenu]=true height="330px" style="display:block"></ejs-documenteditor>
</div>`,
encapsulation: ViewEncapsulation.None,
providers: [EditorService, SelectionService, EditorHistoryService, SfdtExportService, ContextMenuService]
})
export class AppComponent {
@ViewChild('document_editor')
public documentEditor?: DocumentEditorComponent;
public toolbarButtonClick(arg: any) {
switch (arg.item.id) {
case 'AlignLeft':
//Toggle the Left alignment for selected or current paragraph
(this.documentEditor as DocumentEditorComponent).editor.toggleTextAlignment('Left');
break;
case 'AlignRight':
//Toggle the Right alignment for selected or current paragraph
(this.documentEditor as DocumentEditorComponent).editor.toggleTextAlignment('Right');
break;
case 'AlignCenter':
//Toggle the Center alignment for selected or current paragraph
(this.documentEditor as DocumentEditorComponent).editor.toggleTextAlignment('Center');
break;
case 'Justify':
//Toggle the Justify alignment for selected or current paragraph
(this.documentEditor as DocumentEditorComponent).editor.toggleTextAlignment('Justify');
break;
case 'IncreaseIndent':
//Increase the left indent of selected or current paragraph
(this.documentEditor as DocumentEditorComponent).editor.increaseIndent();
break;
case 'DecreaseIndent':
//Decrease the left indent of selected or current paragraph
(this.documentEditor as DocumentEditorComponent).editor.decreaseIndent();
break;
case 'ClearFormat':
//Clear formatting for selected paragraph or content.
(this.documentEditor as DocumentEditorComponent).editor.clearFormatting();
break;
case 'ShowParagraphMark':
//Show or hide the hidden characters like spaces, tab, paragraph marks, and breaks.
(this.documentEditor as DocumentEditorComponent).documentEditorSettings.showHiddenMarks = !(this.documentEditor as DocumentEditorComponent).documentEditorSettings.showHiddenMarks;
break;
}
}
// Selection change to retrieve formatting
public onSelectionChange() {
if ((this.documentEditor as DocumentEditorComponent).selection) {
var paragraphFormat = (this.documentEditor as DocumentEditorComponent).selection.paragraphFormat;
var toggleBtnId = ['AlignLeft', 'AlignCenter', 'AlignRight', 'Justify', 'ShowParagraphMark'];
//Remove toggle state.
if (document.getElementById('AlignLeft')) {
for (var i = 0; i < toggleBtnId.length; i++) {
let toggleBtn: HTMLElement = document.getElementById(toggleBtnId[i]) as HTMLElement;
toggleBtn.classList.remove('e-btn-toggle');
}
//Add toggle state based on selection paragraph format.
if (paragraphFormat.textAlignment === 'Left') {
(document.getElementById('AlignLeft') as HTMLElement).classList.add('e-btn-toggle');
} else if (paragraphFormat.textAlignment === 'Right') {
(document.getElementById('AlignRight') as HTMLElement).classList.add('e-btn-toggle');
} else if (paragraphFormat.textAlignment === 'Center') {
(document.getElementById('AlignCenter') as HTMLElement).classList.add('e-btn-toggle');
} else {
(document.getElementById('Justify') as HTMLElement).classList.add('e-btn-toggle');
}
if ((this.documentEditor as DocumentEditorComponent).documentEditorSettings.showHiddenMarks) {
(document.getElementById('ShowParagraphMark') as HTMLElement).classList.add('e-btn-toggle');
}
}
// #endregion
}
}
}import { bootstrapApplication } from '@angular/platform-browser';
import { AppComponent } from './app.component';
import 'zone.js';
bootstrapApplication(AppComponent).catch((err) => console.error(err));