Merge pull request #1863 from syncfusion-content/995120-extractPage

995120: UG Documentation for Extract Pages in Page Organizer

Author: AnanthaGokulaRaman

Document-Processing-toc.html

@@ -1433,6 +1433,7 @@
 									<li><a href="/document-processing/pdf/pdf-viewer/javascript-es6/organize-pages/programmatic-support">Programmatic Support</a></li>
 									<li><a href="/document-processing/pdf/pdf-viewer/javascript-es6/organize-pages/ui-interactions">UI Interactions</a></li>
 									<li><a href="/document-processing/pdf/pdf-viewer/javascript-es6/organize-pages/toolbar">Toolbar</a></li>
+									<li><a href="/document-processing/pdf/pdf-viewer/javascript-es6/organize-pages/extract-pages">Extract Pages</a></li>
 									<li><a href="/document-processing/pdf/pdf-viewer/javascript-es6/organize-pages/mobile-view">Mobile View</a></li>
 									<li><a href="/document-processing/pdf/pdf-viewer/javascript-es6/organize-pages/events">Events</a></li>
 								</ul>

Document-Processing/PDF/PDF-Viewer/javascript-es6/images/extract-page-checkboxes.png

@@ -0,0 +1,116 @@
+---
+layout: post
+title: Extract Pages in TypeScript PDF Viewer | Syncfusion
+description: Learn here all about Extract Pages in Organize Pages in Syncfusion TypeScript PDF Viewer control of Syncfusion Essential JS 2 and more.
+platform: document-processing
+control: PDF Viewer
+documentation: ug
+domainurl: ##DomainURL##
+---
+
+# Extract pages in TypeScript PDF Viewer
+
+The PDF Viewer component lets you extract pages from a document using the Extract Pages option in the Organize Pages UI, and also control extraction programmatically.
+The Extract Pages tool is available by default in Organize Pages.
+
+## Extract Pages in Organize Pages
+
+- Open the Organize Pages panel in the PDF Viewer toolbar.
+- Locate and click the Extract Pages option.
+
+![Extract Pages](../images/extract-page.png)
+
+When selected, a secondary toolbar dedicated to extraction is displayed.
+
+![Extract Pages secondary toolbar](../images/extract-page-secondary-toolbar.png)
+
+## Extract pages using the UI
+
+You can extract by typing page numbers/ranges or by selecting thumbnails.
+
+1. Click Extract Pages in the Organize Pages panel.
+2. In the input box, enter the pages to extract. Supported formats include:
+   - Single pages: 1,3,5
+   - Ranges: 2-6
+   - Combinations: 1,4,7-9
+3. Alternatively, select the page thumbnails you want instead of typing values.
+4. Click Extract to download the extracted pages as a new PDF. Click Cancel to close the tool.
+
+![Extract Pages with selected thumbnails](../images/extract-page-selected-thumbnail.png)
+
+ N> Page numbers are 1-based (first page is 1). You can start anywhere—enter single pages or ranges like 2-3, 5, or 7-9. Invalid or out-of-range entries are ignored.
+
+## Extraction options (checkboxes)
+
+Two options appear in the secondary toolbar:
+
+- **Delete Pages After Extracting:**
+  - When enabled, the selected/entered pages are removed from the document opened in the viewer after the extraction completes. The extracted pages are still downloaded as a new file.
+  - Example: If you enter 1,2 and extract, a PDF containing pages 1 and 2 is downloaded, and pages 1 and 2 are removed from the currently loaded document in the viewer.
+
+- **Extract Pages As Separate Files:**
+  - When enabled, every selected page is exported as an individual PDF file.
+  - Example: If you select pages 3, 5, and 6, three separate PDFs are downloaded (3.pdf, 5.pdf, and 6.pdf). If you enter a range (e.g., 2-4), pages 2, 3, and 4 are each downloaded as separate PDFs.
+
+![Checkboxes for extract options](../images/extract-page-checkboxes.png)
+
+## Programmatic options and APIs
+
+You can control the Extract Pages experience via settings and invoke extraction through code.
+
+### Enable/disable Extract Pages
+
+Use the `canExtractPages` API to enable or disable the Extract Pages option. When set to `false`, the Extract Pages tool is disabled in the toolbar. The default value is `true`.
+
+Use the following code snippet to enable or disable the Extract Pages option:
+
+```ts
+// Enable the Extract Pages Tool
+viewer.pageOrganizerSettings = { canExtractPages: true };
+```
+
+```ts
+// Disable the Extract Pages Tool
+viewer.pageOrganizerSettings = { canExtractPages: false };
+```
+
+Use the `showExtractPagesOption` API to show or hide the Extract Pages option. When set to `false`, the Extract Pages tool is removed from the toolbar. The default value is `true`.
+
+Use the following code snippet to remove the Extract Pages option:
+```ts
+// Remove the Extract Pages option entirely from the UI (redacted example as provided)
+viewer.pageOrganizerSettings = { showExtractPagesOption: false }
+```
+
+### Extract pages and load the result programmatically
+
+You can extract pages programmatically using the `extractPages` method.
+The following example extracts pages 1 and 2, then immediately loads the extracted pages back into the viewer. The returned value is a byte array (e.g., Uint8Array) representing the PDF file contents.
+
+```html
+<button id="extractPage">Extract Pages</button>
+```
+
+```ts
+document.getElementById('extractPage').addEventListener('click', function () {
+  // Extract pages 1 and 2
+  var array = viewer.extractPages("1,2");
+
+  // Load the extracted pages back into the viewer
+  viewer.load(array);
+
+  // Inspect the result if needed
+  console.log(array);
+});
+```
+
+[View sample in GitHub](https://github.com/SyncfusionExamples/typescript-pdf-viewer-examples/tree/master/How%20to)
+
+## See also
+
+- [Overview](../overview)
+- [UI interactions](../ui-interactions)
+- [Programmatic support](../programmatic-support)
+- [Toolbar](../toolbar)
+- [Events](../events)
+- [Mobile view](../mobile-view)