Announce new lines inserted with Enter

demo/scripts/controlsV2/mainPane/MainPane.tsx

@@ -630,6 +630,7 @@ const AnnounceStringMap: Record<KnownAnnounceStrings, string> = {
     announceUnderlineOff: 'Underline Off',
     selected: '{0}, selected',
     unselected: '{0}, unselected',
+    newLineInserted: 'New line',
 };
 
 function getAnnouncingString(key: KnownAnnounceStrings) {

packages/roosterjs-content-model-plugins/lib/edit/inputSteps/handleEnterOnParagraph.ts

@@ -23,5 +23,10 @@ export const handleEnterOnParagraph: (
         context.deleteResult = 'range';
         context.lastParagraph = newPara;
         context.insertPoint.paragraph = newPara;
+        if (context.formatContext) {
+            context.formatContext.announceData = {
+                defaultStrings: 'newLineInserted',
+            };
+        }
     }
 };

packages/roosterjs-content-model-plugins/test/edit/inputSteps/handleEnterOnParagraphTest.ts

@@ -1,5 +1,8 @@
 import { handleEnterOnParagraph } from '../../../lib/edit/inputSteps/handleEnterOnParagraph';
-import { ValidDeleteSelectionContext } from 'roosterjs-content-model-types';
+import {
+    FormatContentModelContext,
+    ValidDeleteSelectionContext,
+} from 'roosterjs-content-model-types';
 import {
     createContentModelDocument,
     createParagraph,
@@ -43,6 +46,11 @@ describe('handleEnterOnParagraph', () => {
         const mockedCache = {} as any;
         const text1 = createText('test1');
         const text2 = createText('test1');
+        const formatContext: FormatContentModelContext = {
+            newEntities: [],
+            deletedEntities: [],
+            newImages: [],
+        };
 
         para.segments.push(text1, marker, text2);
         doc.blocks.push(para);
@@ -55,6 +63,7 @@ describe('handleEnterOnParagraph', () => {
                 marker: marker,
                 path: [doc],
             },
+            formatContext,
         };
 
         handleEnterOnParagraph([])(context);
@@ -98,6 +107,9 @@ describe('handleEnterOnParagraph', () => {
             marker: marker,
             path: [doc],
         });
+        expect(formatContext.announceData).toEqual({
+            defaultStrings: 'newLineInserted',
+        });
     });
 
     it('Not deleted, split current paragraph with id', () => {

packages/roosterjs-content-model-types/lib/parameter/AnnounceData.ts

@@ -65,7 +65,15 @@ export type KnownAnnounceStrings =
      * @example
      * {0}, unselected
      */
-    | 'unselected';
+    | 'unselected'
+
+    /**
+     * String announced when a new line is inserted in the editor.
+     * Used when Enter is pressed and a new line is inserted in the editor.
+     * @example
+     * New line inserted
+     */
+    | 'newLineInserted';
 
 /**
  * Represents data, that can be used to announce text to screen reader.

packages/roosterjs-editor-adapter/lib/editor/utils/eventConverter.ts

@@ -61,6 +61,7 @@ const KnownAnnounceStringsNewToOld: Record<
     announceUnderlineOff: undefined,
     selected: undefined,
     unselected: undefined,
+    newLineInserted: undefined,
 };
 
 const EntityOperationOldToNew: Record<OldEntityOperation, NewEntityOperation | undefined> = {

packages/roosterjs-editor-adapter/test/editor/utils/eventConverterTest.ts

@@ -873,6 +873,34 @@ describe('newEventToOldEvent', () => {
         expect(result.additionalData!.getEntityState!()).toEqual(mockedEntityState);
     });
 
+    it('ContentChanged with unsupported announce string', () => {
+        const mockedSource = 'SOURCE';
+        const result = runTest(
+            {
+                eventType: 'contentChanged',
+                eventDataCache: mockedDataCache,
+                source: mockedSource,
+                announceData: {
+                    defaultStrings: 'newLineInserted',
+                },
+            },
+            undefined,
+            {
+                eventType: PluginEventType.ContentChanged,
+                eventDataCache: mockedDataCache,
+                additionalData: {
+                    formatApiName: undefined,
+                    getAnnounceData: jasmine.anything() as any,
+                    getEntityState: undefined,
+                },
+                data: undefined,
+                source: mockedSource,
+            }
+        ) as ContentChangedEvent;
+
+        expect(result.additionalData!.getAnnounceData!()).toBeUndefined();
+    });
+
     it('ContextMenu', () => {
         const mockedItems = 'ITEMS' as any;