Merge pull request #2095 from syncfusion-content/1003503-TextSearchReviewTs

1003503: Text Search Print Locale Review Updates

Author: AnanthaGokulaRaman

Document-Processing/PDF/PDF-Viewer/javascript-es6/Localization/default-language.md

@@ -12,6 +12,44 @@ domainurl: ##DomainURL##
 
 The PDF Viewer fully supports localization, allowing all UI text, tooltips, and messages to be replaced with culture-specific strings so the interface matches users’ language and regional settings.
 
+![Default Locale](../images/locale-us.gif)
+
+## Default language (en-US)
+
+By default, the PDF Viewer uses the en-US culture and requires no additional configuration.
+
+{% tabs %}
+{% highlight ts tabtitle="Standalone" %}
+import { PdfViewer, TextSelection, TextSearch, Print, Navigation, Toolbar, Magnification, Annotation, FormDesigner, FormFields, PageOrganizer } from '@syncfusion/ej2-pdfviewer';
+import {L10n} from '@syncfusion/ej2-base';
+// Inject required modules
+PdfViewer.Inject(TextSelection, TextSearch, Print, Navigation, Toolbar, Magnification, Annotation, FormDesigner, FormFields, PageOrganizer);
+
+const pdfviewer: PdfViewer = new PdfViewer({
+    documentPath: 'https://cdn.syncfusion.com/content/pdf/pdf-succinctly.pdf',
+    resourceUrl: "https://cdn.syncfusion.com/ej2/31.1.23/dist/ej2-pdfviewer-lib",
+    locale: 'en-US', //Using locale update culture
+});
+pdfviewer.appendTo('#PdfViewer');
+{% endhighlight %}
+{% highlight ts tabtitle="Server-Backed" %}
+import { PdfViewer, TextSelection, TextSearch, Print, Navigation, Toolbar, Magnification, Annotation, FormDesigner, FormFields, PageOrganizer } from '@syncfusion/ej2-pdfviewer';
+import {L10n} from '@syncfusion/ej2-base';
+// Inject required modules
+PdfViewer.Inject(TextSelection, TextSearch, Print, Navigation, Toolbar, Magnification, Annotation, FormDesigner, FormFields, PageOrganizer);
+
+const pdfviewer: PdfViewer = new PdfViewer({
+    documentPath: 'https://cdn.syncfusion.com/content/pdf/pdf-succinctly.pdf',
+    serviceUrl: 'https://document.syncfusion.com/web-services/pdf-viewer/api/pdfviewer/';
+    locale: 'en-US' //Using locale update culture
+});
+pdfviewer.appendTo('#PdfViewer');
+{% endhighlight %}
+{% endtabs %}
+
+[View Sample on GitHub](https://github.com/SyncfusionExamples/typescript-pdf-viewer-examples)
+
+
 ## Localization keys reference
 
 The PDF Viewer supports localization using culture-specific string collections. By default, the component uses the "en-US" culture.
@@ -270,65 +308,6 @@ The following table lists the default text values used by the PDF Viewer in the
 |Exact Matches|EXACT MATCHES|
 |Total Matches|TOTAL MATCHES|
 
-## Default language (en-US)
-
-By default, the PDF Viewer uses the en-US culture and requires no additional configuration.
-
-{% tabs %}
-{% highlight ts tabtitle="Standalone" %}
-import { PdfViewer, TextSelection, TextSearch, Print, Navigation, Toolbar, Magnification, Annotation, FormDesigner, FormFields, PageOrganizer } from '@syncfusion/ej2-pdfviewer';
-import {L10n} from '@syncfusion/ej2-base';
-// Inject required modules
-PdfViewer.Inject(TextSelection, TextSearch, Print, Navigation, Toolbar, Magnification, Annotation, FormDesigner, FormFields, PageOrganizer);
-
-const pdfviewer: PdfViewer = new PdfViewer({
-    documentPath: 'https://cdn.syncfusion.com/content/pdf/pdf-succinctly.pdf',
-    resourceUrl: "https://cdn.syncfusion.com/ej2/31.1.23/dist/ej2-pdfviewer-lib",
-    locale: 'en-US', //Using locale update culture
-});
-//Use Below code to Load other culutres
-L10n.load({
-            'ar-AE': {
-                'PdfViewer': {
-                    'PdfViewer': 'قوات الدفاع الشعبي المشاهد',
-                    'Cancel': 'إلغاء',
-                    'Download file': 'تحميل الملف',
-                    'Download': 'تحميل', 
-                     //Followed Up by more keys and values
-                    }
-                }
-            });
-pdfviewer.appendTo('#PdfViewer');
-{% endhighlight %}
-{% highlight ts tabtitle="Server-Backed" %}
-import { PdfViewer, TextSelection, TextSearch, Print, Navigation, Toolbar, Magnification, Annotation, FormDesigner, FormFields, PageOrganizer } from '@syncfusion/ej2-pdfviewer';
-import {L10n} from '@syncfusion/ej2-base';
-// Inject required modules
-PdfViewer.Inject(TextSelection, TextSearch, Print, Navigation, Toolbar, Magnification, Annotation, FormDesigner, FormFields, PageOrganizer);
-
-const pdfviewer: PdfViewer = new PdfViewer({
-    documentPath: 'https://cdn.syncfusion.com/content/pdf/pdf-succinctly.pdf',
-    serviceUrl: 'https://document.syncfusion.com/web-services/pdf-viewer/api/pdfviewer/';
-    locale: 'en-US' //Using locale update culture
-});
-// Use Below code to Load other culutres
-L10n.load({
-            'ar-AE': {
-                'PdfViewer': {
-                    'PdfViewer': 'قوات الدفاع الشعبي المشاهد',
-                    'Cancel': 'إلغاء',
-                    'Download file': 'تحميل الملف',
-                    'Download': 'تحميل', 
-                     //Followed Up by more keys and values
-                    }
-                }
-            });
-pdfviewer.appendTo('#PdfViewer');
-{% endhighlight %}
-{% endtabs %}
-
-[View Sample on GitHub](https://github.com/SyncfusionExamples/typescript-pdf-viewer-examples)
-
 ## See Also
 
 - [New Language](./new-language)

Document-Processing/PDF/PDF-Viewer/javascript-es6/Localization/new-language.md

@@ -14,6 +14,8 @@ You can localize the PDF Viewer UI by:
 - Registering localized strings for each culture using `L10n.load` at the application level
 - Setting the [`locale`](https://ej2.syncfusion.com/documentation/api/pdfviewer/index-default#locale) property of the `PdfViewer` instance to the desired culture
 
+![German Locale](../images/locale-de.gif)
+
 ## Example Code-snippet to change language using Locale
 
 {% tabs %}

Document-Processing/PDF/PDF-Viewer/javascript-es6/Localization/rtl-language-support.md

@@ -17,6 +17,8 @@ RTL support in TypeScript PDF Viewer:
 - Load culture-specific strings globally using `L10n.load`.
 - Set the PdfViewer [`locale`](https://ej2.syncfusion.com/documentation/api/pdfviewer/index-default#locale) property to the target culture.
 
+![Arabic Localization](../images/locale-ar.gif)
+
 ## Example Code-snippet to Enable RTL with Arabic Localization
 
 Use the below code-snippet to enable RTL for RTL Languages(Arabic, Hebrew, Persian)

Document-Processing/PDF/PDF-Viewer/javascript-es6/how-to/extract-text-ts.md

@@ -12,19 +12,28 @@ documentation: ug
 The `extractText` method extracts text from one or more pages and can return plain text or text with bounds for each element.
 
 ### extractText method
+
 Retrieves text data from one page or a range of pages based on the specified options.
 
 #### Parameters:
-**startIndex:** The starting page index for text extraction (0-based index).
 
-**endIndex or isOptions:** Either the ending page index (for multiple pages) or an option specifying extraction criteria for a single page.
+- **startIndex:** The starting page index for text extraction (0-based index).
+
+- **endIndex or isOptions:** Either the ending page index (for multiple pages) or an option specifying extraction criteria for a single page.
+
+- **options (optional):** Additional options, such as `TextOnly` for plain text or `TextAndBounds` for detailed text data with bounds.
+
+#### Available Options
 
-**options (optional):** Additional options, such as `TextOnly` for plain text or `TextAndBounds` for detailed text data with bounds.
+- **None:** No text information is extracted or returned. This is useful when you want to optimize memory usage and don't need any text data.
 
-- TextOnly: Extracts only plain text without bounds.
-- TextAndBounds: Extracts text with bounds (coordinates).
+- **TextOnly:** Extracts only the plain text from the document. This option excludes any layout or positional information.
 
-#### Returns:
+- **BoundsOnly:** Extracts layout information, such as bounds or coordinates, without including the plain text data.
+
+- **TextAndBounds:** Extracts both the plain text and the layout (bounds) information, which is the default behavior.
+
+#### Returns
 Returns a Promise with:
 - textData: An array of TextDataSettingsModel with details including bounds and page text.
 - pageText: A concatenated string of plain text from the specified page(s).
@@ -75,6 +84,73 @@ extractTextButtons.addEventListener('click', function () {
 - Single page: Extracts text from page 1 (`startIndex = 1`) using `TextOnly`.
 - Multiple pages: Extracts text from pages 0–2 (`startIndex = 0, endIndex = 2`) using `TextOnly`.
 
+### Programmatic Examples for Extract Text Option API
+Here is an example that demonstrates how to use the extractText Option along with event handling:
+
+```html
+<button id="extractNoneRange">None (Pages 0–2)</button>
+<button id="extractTextOnlyRange">TextOnly (Pages 0–2)</button>
+<button id="extractBoundsOnlyRange">BoundsOnly (Pages 0–2)</button>
+<button id="extractTextAndBoundsRange">TextAndBounds (Pages 0–2)</button>
+```
+
+```ts
+import { PdfViewer, TextSelection, TextSearch, Print, Navigation, Toolbar, Magnification, Annotation, FormDesigner, FormFields, PageInfoModel, ExtractTextOption } from '@syncfusion/ej2-pdfviewer';
+
+// Inject required modules
+PdfViewer.Inject(TextSelection, TextSearch, Print, Navigation, Toolbar, Magnification, Annotation, FormDesigner, FormFields);
+
+const viewer = new PdfViewer({
+  documentPath: 'https://cdn.syncfusion.com/content/pdf/pdf-succinctly.pdf',
+  resourceUrl: 'https://cdn.syncfusion.com/ej2/31.1.23/dist/ej2-pdfviewer-lib'
+});
+viewer.appendTo('#PdfViewer');
+
+// None (no text info)
+const btnNone = document.getElementById('extractNoneRange');
+if (btnNone) {
+  btnNone.addEventListener('click', function () {
+    viewer.extractText(0, 2, ExtractTextOption.None).then((val) => {
+      console.log('None (Pages 0–2):', val);
+    });
+  });
+}
+
+// TextOnly
+const btnTextOnly = document.getElementById('extractTextOnlyRange');
+if (btnTextOnly) {
+  btnTextOnly.addEventListener('click', function () {
+    viewer.extractText(0, 2, ExtractTextOption.TextOnly).then((val: any) => {
+      console.log('TextOnly (Pages 0–2):');
+      console.log(val);
+    });
+  });
+}
+
+// BoundsOnly
+const btnBoundsOnly = document.getElementById('extractBoundsOnlyRange');
+if (btnBoundsOnly) {
+  btnBoundsOnly.addEventListener('click', function () {
+    viewer.extractText(0, 2, ExtractTextOption.BoundsOnly).then((val: any) => {
+      // Typically returns val.textData with bounds per page
+      console.log('BoundsOnly (Pages 0–2):');
+      console.log(val);
+    });
+  });
+}
+
+// TextAndBounds
+const btnTextAndBounds = document.getElementById('extractTextAndBoundsRange');
+if (btnTextAndBounds) {
+  btnTextAndBounds.addEventListener('click', function () {
+    viewer.extractText(0, 2, ExtractTextOption.TextAndBounds).then((val: any) => {
+      console.log('TextAndBounds (Pages 0–2):');
+      console.log(val);
+    });
+  });
+}
+```
+
 [View sample in GitHub](https://github.com/SyncfusionExamples/typescript-pdf-viewer-examples/tree/master/How%20to/Extract%20Text)
 
 ## See Also