Skip to content

Commit b090655

Browse files
Merge pull request #2306 from syncfusion-content/EJ2-1010807-diataxis-organize
1010807: Revamped react organize pages module using diataxis approach
2 parents 28f054a + d7a7465 commit b090655

12 files changed

Lines changed: 505 additions & 466 deletions

File tree

Document-Processing-toc.html

Lines changed: 10 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1028,13 +1028,18 @@
10281028
<li><a href="/document-processing/pdf/pdf-viewer/react/forms/form-fields-api">APIs</a></li>
10291029
</ul>
10301030
</li>
1031-
<li><a href="/document-processing/pdf/pdf-viewer/react/organize-pdf">Organize Pages</a>
1032-
<ul>
1033-
<li><a href="/document-processing/pdf/pdf-viewer/react/organize-pages/overview">Overview</a></li>
1031+
<li><a href="/document-processing/pdf/pdf-viewer/react/organize-pages/overview">Organize Pages</a>
1032+
<ul>
1033+
<li><a href="/document-processing/pdf/pdf-viewer/react/organize-pages/copy-pages">Copy pages</a></li>
1034+
<li><a href="/document-processing/pdf/pdf-viewer/react/organize-pages/import-pages">Import pages</a></li>
1035+
<li><a href="/document-processing/pdf/pdf-viewer/react/organize-pages/insert-blank-pages">Insert blank pages</a></li>
1036+
<li><a href="/document-processing/pdf/pdf-viewer/react/organize-pages/remove-pages">Remove pages</a></li>
1037+
<li><a href="/document-processing/pdf/pdf-viewer/react/organize-pages/reorder-pages">Reorder pages</a></li>
1038+
<li><a href="/document-processing/pdf/pdf-viewer/react/organize-pages/rotate-pages">Rotate pages</a></li>
1039+
<li><a href="/document-processing/pdf/pdf-viewer/react/organize-pages/zoom-pages">Zoom pages</a></li>
1040+
<li><a href="/document-processing/pdf/pdf-viewer/react/organize-pages/extract-pages">Extract Pages</a></li>
10341041
<li><a href="/document-processing/pdf/pdf-viewer/react/organize-pages/programmatic-support">Programmatic Support</a></li>
1035-
<li><a href="/document-processing/pdf/pdf-viewer/react/organize-pages/ui-interactions">UI Interactions</a></li>
10361042
<li><a href="/document-processing/pdf/pdf-viewer/react/organize-pages/toolbar">Toolbar</a></li>
1037-
<li><a href="/document-processing/pdf/pdf-viewer/react/organize-pages/extract-pages">Extract Pages</a></li>
10381043
<li><a href="/document-processing/pdf/pdf-viewer/react/organize-pages/mobile-view">Mobile View</a></li>
10391044
<li><a href="/document-processing/pdf/pdf-viewer/react/organize-pages/events">Events</a></li>
10401045
</ul>
Lines changed: 69 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,69 @@
1+
---
2+
layout: post
3+
title: Copy pages in Organize Pages in React PDF Viewer | Syncfusion
4+
description: Learn how to duplicate pages using the Organize Pages UI in the React PDF Viewer of Syncfusion Essential JS 2 and more.
5+
platform: document-processing
6+
control: PDF Viewer
7+
documentation: ug
8+
domainurl: ##DomainURL##
9+
---
10+
11+
# Copy Pages in React PDF Viewer
12+
13+
## Overview
14+
15+
This guide explains how to duplicate pages within the current PDF using the Organize Pages UI.
16+
17+
**Outcome**: Copied pages are inserted adjacent to the selection and included in exported PDFs.
18+
19+
## Prerequisites
20+
21+
- EJ2 React PDF Viewer installed
22+
- PDF Viewer injected with `PageOrganizer` module
23+
24+
## Steps
25+
26+
1. Open the Organize Pages view
27+
28+
- Click the **Organize Pages** button in the viewer toolbar to open the Organize Pages dialog.
29+
30+
2. Select pages to duplicate
31+
32+
- Click a single thumbnail or use Shift+click/Ctrl+click to select multiple pages.
33+
34+
3. Duplicate selected pages
35+
36+
- Click the **Copy Pages** button in the Organize Pages toolbar; duplicated pages are inserted to the right of the selected thumbnails.
37+
38+
4. Duplicate multiple pages at once
39+
40+
- When multiple thumbnails are selected, the Copy action duplicates every selected page in order.
41+
42+
![Copy pages in organize view](../images/organize-copy.png)
43+
44+
5. Undo or redo changes
45+
46+
- Use **Undo** (Ctrl+Z) or **Redo** to revert or reapply recent changes.
47+
48+
![Undo and redo Organize Pages toolbar](../images/undo-redo.png)
49+
50+
6. Persist duplicated pages
51+
52+
- Click **Save** or **Save As** to include duplicated pages in the saved/downloaded PDF.
53+
54+
## Expected result
55+
56+
- Selected pages are duplicated and included in the saved PDF.
57+
58+
## Enable or disable Copy Pages button
59+
60+
To enable or disable the **Copy Pages** button in the Organize Pages toolbar, update the [`pageOrganizerSettings`](https://ej2.syncfusion.com/react/documentation/api/pdfviewer/pageorganizersettings). See [Organize pages toolbar customization](./toolbar#enable-or-disable-the-copy-option) for the guidelines.
61+
62+
## Troubleshooting
63+
64+
- If duplicates are not created: verify that the changes are persisted using **Save**.
65+
66+
## Related topics
67+
68+
- [Organize pages toolbar customization](./toolbar)
69+
- [Organize pages event reference](./events)
Lines changed: 62 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,62 @@
1+
---
2+
layout: post
3+
title: Import pages in Organize Pages in React PDF Viewer | Syncfusion
4+
description: How to import pages from another PDF into the current document using the Organize Pages UI in the Syncfusion React PDF Viewer.
5+
platform: document-processing
6+
control: PDF Viewer
7+
documentation: ug
8+
domainurl: ##DomainURL##
9+
---
10+
11+
# Import pages using the Organize Pages tool
12+
13+
## Overview
14+
15+
This guide explains how to import pages from another PDF into the current document using the **Organize Pages** UI in the EJ2 React PDF Viewer.
16+
17+
**Outcome**: Imported pages appear as thumbnails and are merged into the original document when saved or exported.
18+
19+
## Prerequisites
20+
21+
- EJ2 React PDF Viewer installed
22+
- PDF Viewer is injected with `PageOrganizer` service
23+
- [`resourceUrl`](https://ej2.syncfusion.com/react/documentation/api/pdfviewer#resourceurl) (standalone) or [`serviceUrl`](https://ej2.syncfusion.com/react/documentation/api/pdfviewer#serviceurl) (server-backed) configured when required
24+
25+
## Steps
26+
27+
1. Open the Organize Pages view
28+
29+
- Click the **Organize Pages** button in the viewer navigation toolbar to open the Organize Pages dialog.
30+
31+
2. Start import
32+
33+
- Click **Import Document** and choose a valid PDF file from your local file system.
34+
35+
3. Place imported pages
36+
37+
- Imported pages appear as thumbnails. If a thumbnail is selected, the imported pages are inserted to the right of the selection; otherwise they are appended at the start of the document.
38+
39+
![Import PDF animation showing thumbnail insertion](../images/import.gif)
40+
41+
4. Persist changes
42+
43+
- Click **Save** or **Save As** (or download) to persist the merged document.
44+
45+
## Expected result
46+
47+
- Imported pages display as a single thumbnail in Organize Pages and are merged into the original PDF when saved or exported.
48+
49+
## Enable or disable Import Pages button
50+
51+
To enable or disable the **Import Pages** button in the Organize Pages toolbar, update the [`pageOrganizerSettings`](https://ej2.syncfusion.com/react/documentation/api/pdfviewer/pageorganizersettings). See [Organize pages toolbar customization](./toolbar#enable-or-disable-the-import-option) for the guidelines.
52+
53+
## Troubleshooting
54+
55+
- **Import fails**: Ensure the selected file is a valid PDF and the browser file picker is permitted.
56+
- **Imported pages not visible**: Confirm that the import is persisted using **Save** or **Save As**.
57+
- **Import option disabled**: Ensure [`pageOrganizerSettings.canImport`](https://ej2.syncfusion.com/react/documentation/api/pdfviewer/pageorganizersettingsmodel#canimport) is set to `true` to enable import option.
58+
59+
## Related topics
60+
61+
- [Organize pages toolbar customization](./toolbar)
62+
- [Organize pages event reference](./events)
Lines changed: 68 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,68 @@
1+
---
2+
layout: post
3+
title: Insert blank pages in Organize Pages in React PDF Viewer | Syncfusion
4+
description: How to insert blank pages into a PDF using the Organize Pages UI in the Syncfusion React PDF Viewer.
5+
platform: document-processing
6+
control: PDF Viewer
7+
documentation: ug
8+
domainurl: ##DomainURL##
9+
---
10+
11+
# Insert blank pages using the Organize Pages tool
12+
13+
## Overview
14+
15+
This guide describes inserting new blank pages into a PDF using the **Organize Pages** UI in the EJ2 React PDF Viewer.
16+
17+
**Outcome**: A blank page is added at the chosen position and will appear in thumbnails and exports.
18+
19+
## Prerequisites
20+
21+
- EJ2 React PDF Viewer installed
22+
- `PageOrganizer` services injected into `PdfViewerComponent`
23+
- [`resourceUrl`](https://ej2.syncfusion.com/react/documentation/api/pdfviewer#resourceurl) for standalone mode or [`serviceUrl`](https://ej2.syncfusion.com/react/documentation/api/pdfviewer#serviceurl) for server-backed mode configured as required
24+
25+
## Steps
26+
27+
1. Open the Organize Pages view
28+
29+
- Click the **Organize Pages** button in the viewer navigation toolbar to open the panel.
30+
31+
2. Select insertion point
32+
33+
- Hover over the thumbnail before or after which you want the blank page added.
34+
35+
3. Insert a blank page
36+
37+
- Click the **Insert Left** / **Insert Right** option and choose the position (Before / After). A new blank thumbnail appears in the sequence.
38+
39+
![Insert pages in Organize Pages](../images/organize-insert.png)
40+
41+
4. Adjust and confirm
42+
43+
- Reposition or remove the inserted blank page if needed using drag-and-drop or delete options.
44+
45+
5. Persist the change
46+
47+
- Click **Save** or **Save As** to include the blank page in the exported PDF.
48+
49+
## Expected result
50+
51+
- A blank page thumbnail appears at the chosen position and is present in any saved or downloaded PDF.
52+
53+
## Enable or disable Insert Pages button
54+
55+
To enable or disable the **Insert Pages** button in the page thumbnails, update the [`pageOrganizerSettings`](https://ej2.syncfusion.com/react/documentation/api/pdfviewer/pageorganizersettings). See [Organize pages toolbar customization](./toolbar#enable-or-disable-the-insert-option) for the guidelines
56+
57+
## Troubleshooting
58+
59+
- **Organize Pages button missing**: Verify `PageOrganizer` is included in `Inject` and `Toolbar` is enabled.
60+
- **Inserted page not saved**: Confirm [`resourceUrl`](https://ej2.syncfusion.com/react/documentation/api/pdfviewer#resourceurl) or [`serviceUrl`](https://ej2.syncfusion.com/react/documentation/api/pdfviewer#serviceurl) is configured for your selected processing mode.
61+
- **Insert options disabled**: Ensure [`pageOrganizerSettings.canInsert`](https://ej2.syncfusion.com/react/documentation/api/pdfviewer/pageorganizersettingsmodel#caninsert) is set to `true` to enable insert option.
62+
63+
## Related topics
64+
65+
- [Organize pages toolbar customization](./toolbar)
66+
- [Organize pages event reference](./events)
67+
- [Remove pages in Organize Pages](./remove-pages)
68+
- [Reorder pages in Organize Pages](./remove-pages)

Document-Processing/PDF/PDF-Viewer/react/organize-pages/overview.md

Lines changed: 4 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -27,13 +27,10 @@ The Organize Pages panel supports the following actions:
2727

2828
After completing the changes, apply them by selecting **Save** to overwrite the current document or **Save As** to download a new copy that retains the updated page order.
2929

30-
For a full guide to Organize Pages in React, see the feature landing page: [Organize pages in React PDF Viewer](./organize-pdf).
31-
3230
See also:
3331

34-
- [UI interactions for Organize Pages](./organize-pdf/ui-interactions-organize-page)
35-
- [Toolbar items for Organize Pages](./organize-pdf/toolbar-organize-page)
36-
- [Programmatic support for Organize Pages](./organize-pdf/programmatic-support-for-organize-page)
37-
- [Organize Pages events](./organize-pdf/organize-pdf-events)
38-
- [Organize Pages in mobile view](./organize-pdf/organize-page-mobile-view)
32+
- [Toolbar customization for Organize Pages](./toolbar)
33+
- [Programmatic support for Organize Pages](./programmatic-support)
34+
- [Organize Pages events](./events)
35+
- [Organize Pages in mobile view](./mobile-view)
3936

Lines changed: 74 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,74 @@
1+
---
2+
layout: post
3+
title: Remove pages using Organize Pages in React PDF Viewer | Syncfusion
4+
description: How to remove one or more pages from a PDF using the Organize Pages view in the Syncfusion React PDF Viewer.
5+
platform: document-processing
6+
control: PDF Viewer
7+
documentation: ug
8+
domainurl: ##DomainURL##
9+
---
10+
11+
# Remove pages using the Organize Pages tool
12+
13+
## Overview
14+
15+
This guide shows how to delete single or multiple pages from a PDF using the **Organize Pages** UI in the EJ2 React PDF Viewer.
16+
17+
**Outcome**: You will remove unwanted pages and save or download the updated PDF.
18+
19+
## Prerequisites
20+
21+
- EJ2 React PDF Viewer installed in your project
22+
- Basic PDF Viewer setup ([`resourceUrl`](https://ej2.syncfusion.com/react/documentation/api/pdfviewer#resourceurl) for standalone mode or [`serviceUrl`](https://ej2.syncfusion.com/react/documentation/api/pdfviewer#serviceurl) for server-backed mode)
23+
24+
## Steps
25+
26+
1. Open the Organize Pages view
27+
28+
- Click the **Organize Pages** button in the viewer navigation toolbar to open the Organize Pages dialog.
29+
30+
2. Select pages to remove
31+
32+
- Click a thumbnail to select a page. Use Shift+click or Ctrl+click to select multiple pages. Use the **Select all** button to select every page.
33+
34+
3. Delete selected pages
35+
36+
- Click the **Delete Pages** icon in the Organize Pages toolbar to remove the selected pages. The thumbnails update immediately to reflect the deletion.
37+
38+
- Delete a single page directly from its thumbnail: hover over the page thumbnail to reveal the per-page delete icon, then click that icon to remove only that page.
39+
40+
![Delete selected pages using the Organize Pages delete control](../images/organize-delete.png)
41+
42+
4. Multi-page deletion
43+
44+
- When multiple thumbnails are selected, the Delete action removes all selected pages at once.
45+
46+
5. Undo or redo deletion
47+
48+
- Use **Undo** (Ctrl+Z) to revert the last deletion.
49+
- Use **Redo** (Ctrl+Y) to revert the last undone deletion.
50+
51+
![Undo and redo Organize Pages toolbar](../images/undo-redo.png)
52+
53+
6. Save the PDF after deletion
54+
55+
- Click **Save** to apply changes to the currently loaded document, or **Save As** / **Download** to download a copy with the removed pages permanently applied.
56+
57+
## Expected result
58+
59+
- Selected pages are removed from the document immediately in the Organize Pages dialog.
60+
- After clicking **Save** or **Save As**, the resulting PDF reflects the deletions.
61+
62+
## Enable or disable Remove Pages button
63+
64+
To enable or disable the **Remove Pages** button in the Organize Pages toolbar, update the [`pageOrganizerSettings`](https://ej2.syncfusion.com/react/documentation/api/pdfviewer/pageorganizersettings). See [Organize pages toolbar customization](./toolbar#enable-or-disable-the-delete-option) for the guidelines.
65+
66+
## Troubleshooting
67+
68+
- **Delete button disabled**: Ensure `PageOrganizer` is injected and [`pageOrganizerSettings.canDelete`](https://ej2.syncfusion.com/react/documentation/api/pdfviewer/pageorganizersettingsmodel#candelete) is not set to `false`.
69+
- **Selection not working**: Verify that the Organize Pages dialog has focus; use Shift+click for range selection.
70+
71+
## Related topics
72+
73+
- [Organize pages toolbar customization](./toolbar)
74+
- [Organize pages event reference](./events)
Lines changed: 66 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,66 @@
1+
---
2+
layout: post
3+
title: Reorder pages in Organize Pages in React PDF Viewer | Syncfusion
4+
description: How to rearrange pages using drag-and-drop and grouping in the Organize Pages UI of the Syncfusion React PDF Viewer.
5+
platform: document-processing
6+
control: PDF Viewer
7+
documentation: ug
8+
domainurl: ##DomainURL##
9+
---
10+
11+
# Reorder pages using the Organize Pages view
12+
13+
## Overview
14+
15+
This guide describes how to rearrange pages in a PDF using the **Organize Pages** UI.
16+
17+
**Outcome**: Single or multiple pages can be reordered and the new sequence is preserved when the document is saved or exported.
18+
19+
## Prerequisites
20+
21+
- EJ2 React PDF Viewer installed
22+
- `Toolbar` and `PageOrganizer` services injected into the viewer
23+
24+
## Steps
25+
26+
1. Open the Organize Pages view
27+
28+
- Click the **Organize Pages** button in the navigation toolbar to open the page thumbnails panel.
29+
30+
2. Reorder a single page
31+
32+
- Drag a thumbnail to the desired position. The thumbnails update instantly to show the new order.
33+
34+
3. Reorder multiple pages
35+
36+
- Select multiple thumbnails using Ctrl or Shift, then drag the selected group to the new location.
37+
38+
![Rearrange pages animation showing drag-and-drop behavior](../images/rotate-rearrange.gif)
39+
40+
4. Verify and undo
41+
42+
- Use **Undo** / **Redo** options to revert accidental changes.
43+
44+
![Undo and redo Organize Pages toolbar](../images/undo-redo.png)
45+
46+
5. Persist the updated order
47+
48+
- Click **Save** or download the document using **Save As** to persist the new page sequence.
49+
50+
## Expected result
51+
52+
- Thumbnails reflect the new page order immediately and saved / downloaded PDFs preserve the reordered sequence.
53+
54+
## Enable or disable reorder option
55+
56+
To enable or disable the **Reorder pages** option in the Organize Pages, update the [`pageOrganizerSettings`](https://ej2.syncfusion.com/react/documentation/api/pdfviewer/pageorganizersettings). See [Organize pages toolbar customization](./toolbar#enable-or-disable-the-rearrange-option) for the guidelines
57+
58+
## Troubleshooting
59+
60+
- **Thumbnails won't move**: Confirm [`pageOrganizerSettings.canRearrange`](https://ej2.syncfusion.com/react/documentation/api/pdfviewer/pageorganizersettingsmodel#canrearrange) is is not set to `false`.
61+
- **Changes not saved**: Verify [`serviceUrl`](https://ej2.syncfusion.com/react/documentation/api/pdfviewer#serviceurl) (server) or [`resourceUrl`](https://ej2.syncfusion.com/react/documentation/api/pdfviewer#resourceurl) (standalone) is configured correctly.
62+
63+
## Related topics
64+
65+
- [Organize pages toolbar customization](./toolbar)
66+
- [Organize pages event reference](./events)

0 commit comments

Comments
 (0)