From 188db6940a942a83d7a2235c8b3a3e4757499b7e Mon Sep 17 00:00:00 2001 From: dynamsoft-h <172081603+dynamsoft-h@users.noreply.github.com> Date: Fri, 14 Nov 2025 19:49:51 -0800 Subject: [PATCH 1/4] fix: topchanged event description and entry --- _articles/info/api/WebTwain_Viewer.md | 35 +++++++++++++-------------- 1 file changed, 17 insertions(+), 18 deletions(-) diff --git a/_articles/info/api/WebTwain_Viewer.md b/_articles/info/api/WebTwain_Viewer.md index b8365ac2..c7a326ad 100644 --- a/_articles/info/api/WebTwain_Viewer.md +++ b/_articles/info/api/WebTwain_Viewer.md @@ -568,11 +568,11 @@ objThumbnailViewer.on("click", function(thumbnailViewerEvent, domEvent) { }); // Log the width of the thumbnail container that the user clicked on (secondary mouse button) objThumbnailViewer.on("contextmenu",function(thumbnailViewerEvent, domEvent) { - console.log("Width of selected thumbnail container: " + thumbnailViewerEvent.pageWidth); + console.log("Width of selected thumbnail container: " + thumbnailViewerEvent.pageWidth); }); // Log the index of the image when rendered objThumbnailViewer.on("pageRendered", function(index) { - console.log("Index of rendered page: " + index); + console.log("Index of rendered page: " + index); }); ``` @@ -622,22 +622,21 @@ For the `CheckboxSettings` and `PageNumberSettings` interface, please refer to t The following table shows the events available to a ThumbnailViewer object. -| Event Name | Arguments | Description | -| :------------- | :------------------------------------------------ | :------------------------------------------------------------------- | -| `click` | event: [ThumbnailViewerEvent](/_articles/info/api/interfaces.md#thumbnailviewerevent), domEvent: [MouseEvent](https://developer.mozilla.org/en-US/docs/Web/API/MouseEvent){:target="_blank"} | Triggered upon primary mouse click | -| `dblclick` | event: [ThumbnailViewerEvent](/_articles/info/api/interfaces.md#thumbnailviewerevent), domEvent: [MouseEvent](https://developer.mozilla.org/en-US/docs/Web/API/MouseEvent){:target="_blank"} | Triggered upon primary mouse double click | -| `contextmenu` | event: [ThumbnailViewerEvent](/_articles/info/api/interfaces.md#thumbnailviewerevent), domEvent: [MouseEvent](https://developer.mozilla.org/en-US/docs/Web/API/MouseEvent){:target="_blank"} | Triggered upon secondary mouse click | -| `mousemove` | event: [ThumbnailViewerEvent](/_articles/info/api/interfaces.md#thumbnailviewerevent), domEvent: [MouseEvent](https://developer.mozilla.org/en-US/docs/Web/API/MouseEvent){:target="_blank"} | Triggered upon mouse movements within the `ThumbnailViewer` | -| `mousedown` | event: [ThumbnailViewerEvent](/_articles/info/api/interfaces.md#thumbnailviewerevent), domEvent: [MouseEvent](https://developer.mozilla.org/en-US/docs/Web/API/MouseEvent){:target="_blank"} | Triggered upon pressing down the primary mouse button | -| `mouseup` | event: [ThumbnailViewerEvent](/_articles/info/api/interfaces.md#thumbnailviewerevent), domEvent: [MouseEvent](https://developer.mozilla.org/en-US/docs/Web/API/MouseEvent){:target="_blank"} | Triggered upon releasing the primary mouse button | -| `resize` | width:number, height:number | Triggered when the width or height of the `ThumbnailViewer` object changes | -| `pageRendered` | index: number | Triggered when a page becomes rendered. | -| `mouseout` | event: [ThumbnailViewerEvent](/_articles/info/api/interfaces.md#thumbnailviewerevent), domEvent: [MouseEvent](https://developer.mozilla.org/en-US/docs/Web/API/MouseEvent){:target="_blank"} | Triggered upon the mouse leaving the `ThumbnailViewer`; **only supported on desktop browsers** | -| `mouseover` | event: [ThumbnailViewerEvent](/_articles/info/api/interfaces.md#thumbnailviewerevent), domEvent: [MouseEvent](https://developer.mozilla.org/en-US/docs/Web/API/MouseEvent){:target="_blank"} | Triggered upon mouse hovering over the `ThumbnailViewer`; **only supported on desktop browsers** | -| `keydown` | keyboardEvent: KeyboardEvent | Triggered upon pressing a key; **only supported on desktop browsers** | -| `keyup` | keyboardEvent: KeyboardEvent | Triggered upon releasing a key; **only supported on desktop browsers** | - -By default, scrolling the scroll bar on the `ThumbnailViewer` does not trigger the `topchanged` event. +| Event Name | Arguments | Description | +| :------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------- | +| `click` | event: [ThumbnailViewerEvent](/_articles/info/api/interfaces.md#thumbnailviewerevent), domEvent: [MouseEvent](https://developer.mozilla.org/en-US/docs/Web/API/MouseEvent){:target="\_blank"} | Triggered upon primary mouse click | +| `dblclick` | event: [ThumbnailViewerEvent](/_articles/info/api/interfaces.md#thumbnailviewerevent), domEvent: [MouseEvent](https://developer.mozilla.org/en-US/docs/Web/API/MouseEvent){:target="\_blank"} | Triggered upon primary mouse double click | +| `contextmenu` | event: [ThumbnailViewerEvent](/_articles/info/api/interfaces.md#thumbnailviewerevent), domEvent: [MouseEvent](https://developer.mozilla.org/en-US/docs/Web/API/MouseEvent){:target="\_blank"} | Triggered upon secondary mouse click | +| `mousemove` | event: [ThumbnailViewerEvent](/_articles/info/api/interfaces.md#thumbnailviewerevent), domEvent: [MouseEvent](https://developer.mozilla.org/en-US/docs/Web/API/MouseEvent){:target="\_blank"} | Triggered upon mouse movements within the `ThumbnailViewer` | +| `mousedown` | event: [ThumbnailViewerEvent](/_articles/info/api/interfaces.md#thumbnailviewerevent), domEvent: [MouseEvent](https://developer.mozilla.org/en-US/docs/Web/API/MouseEvent){:target="\_blank"} | Triggered upon pressing down the primary mouse button | +| `mouseup` | event: [ThumbnailViewerEvent](/_articles/info/api/interfaces.md#thumbnailviewerevent), domEvent: [MouseEvent](https://developer.mozilla.org/en-US/docs/Web/API/MouseEvent){:target="\_blank"} | Triggered upon releasing the primary mouse button | +| `topchanged` | event: [ThumbnailViewerEvent](/_articles/info/api/interfaces.md#thumbnailviewerevent), domEvent: [MouseEvent](https://developer.mozilla.org/en-US/docs/Web/API/MouseEvent){:target="\_blank"} | Triggered upon scrolling through the thumbnail viewer, **except if using the scroll bar** | +| `resize` | width:number, height:number | Triggered when the width or height of the `ThumbnailViewer` object changes | +| `pageRendered` | index: number | Triggered when a page becomes rendered. | +| `mouseout` | event: [ThumbnailViewerEvent](/_articles/info/api/interfaces.md#thumbnailviewerevent), domEvent: [MouseEvent](https://developer.mozilla.org/en-US/docs/Web/API/MouseEvent){:target="\_blank"} | Triggered upon the mouse leaving the `ThumbnailViewer`; **only supported on desktop browsers** | +| `mouseover` | event: [ThumbnailViewerEvent](/_articles/info/api/interfaces.md#thumbnailviewerevent), domEvent: [MouseEvent](https://developer.mozilla.org/en-US/docs/Web/API/MouseEvent){:target="\_blank"} | Triggered upon mouse hovering over the `ThumbnailViewer`; **only supported on desktop browsers** | +| `keydown` | keyboardEvent: KeyboardEvent | Triggered upon pressing a key; **only supported on desktop browsers** | +| `keyup` | keyboardEvent: KeyboardEvent | Triggered upon releasing a key; **only supported on desktop browsers** | The method [`unbind()`](/_articles/info/api/WebTwain_Viewer.md#unbind) will dispose all created ThumbnailViewer objects. From 1e6533c8906142fcfab4cf8c017b93386188cf44 Mon Sep 17 00:00:00 2001 From: dynamsoft-h <172081603+dynamsoft-h@users.noreply.github.com> Date: Fri, 14 Nov 2025 19:50:46 -0800 Subject: [PATCH 2/4] fix: broken link typo for stable release notes --- _articles/faq/upgrade-to-latest-version.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/_articles/faq/upgrade-to-latest-version.md b/_articles/faq/upgrade-to-latest-version.md index 597fc182..44030675 100644 --- a/_articles/faq/upgrade-to-latest-version.md +++ b/_articles/faq/upgrade-to-latest-version.md @@ -22,7 +22,7 @@ Please refer to the upgrade guide and the release notes below to update your app [Dynamic Web TWAIN Development - Upgrade Guide](/_articles/indepth/development/upgrade.md){:target="_blank"} -[Dynamic Web TWAIN Schedule - Stable Release](/_articles/info/schedule/stable.md){:target="_blank"} +[Dynamic Web TWAIN Schedule - Stable Release](/_articles/info/schedule/Stable.md){:target="_blank"} Once you are ready to upgrade, please send an email to sales@dynamsoft.com requesting the upgrade be done. From 50643014dc8f3c1e242e0eefa1303ab1ca7b81e8 Mon Sep 17 00:00:00 2001 From: tony-xlh Date: Tue, 18 Nov 2025 10:06:06 +0800 Subject: [PATCH 3/4] Revert "fix: topchanged event description and entry" This reverts commit 188db6940a942a83d7a2235c8b3a3e4757499b7e. --- _articles/info/api/WebTwain_Viewer.md | 35 ++++++++++++++------------- 1 file changed, 18 insertions(+), 17 deletions(-) diff --git a/_articles/info/api/WebTwain_Viewer.md b/_articles/info/api/WebTwain_Viewer.md index c7a326ad..b8365ac2 100644 --- a/_articles/info/api/WebTwain_Viewer.md +++ b/_articles/info/api/WebTwain_Viewer.md @@ -568,11 +568,11 @@ objThumbnailViewer.on("click", function(thumbnailViewerEvent, domEvent) { }); // Log the width of the thumbnail container that the user clicked on (secondary mouse button) objThumbnailViewer.on("contextmenu",function(thumbnailViewerEvent, domEvent) { - console.log("Width of selected thumbnail container: " + thumbnailViewerEvent.pageWidth); + console.log("Width of selected thumbnail container: " + thumbnailViewerEvent.pageWidth); }); // Log the index of the image when rendered objThumbnailViewer.on("pageRendered", function(index) { - console.log("Index of rendered page: " + index); + console.log("Index of rendered page: " + index); }); ``` @@ -622,21 +622,22 @@ For the `CheckboxSettings` and `PageNumberSettings` interface, please refer to t The following table shows the events available to a ThumbnailViewer object. -| Event Name | Arguments | Description | -| :------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------- | -| `click` | event: [ThumbnailViewerEvent](/_articles/info/api/interfaces.md#thumbnailviewerevent), domEvent: [MouseEvent](https://developer.mozilla.org/en-US/docs/Web/API/MouseEvent){:target="\_blank"} | Triggered upon primary mouse click | -| `dblclick` | event: [ThumbnailViewerEvent](/_articles/info/api/interfaces.md#thumbnailviewerevent), domEvent: [MouseEvent](https://developer.mozilla.org/en-US/docs/Web/API/MouseEvent){:target="\_blank"} | Triggered upon primary mouse double click | -| `contextmenu` | event: [ThumbnailViewerEvent](/_articles/info/api/interfaces.md#thumbnailviewerevent), domEvent: [MouseEvent](https://developer.mozilla.org/en-US/docs/Web/API/MouseEvent){:target="\_blank"} | Triggered upon secondary mouse click | -| `mousemove` | event: [ThumbnailViewerEvent](/_articles/info/api/interfaces.md#thumbnailviewerevent), domEvent: [MouseEvent](https://developer.mozilla.org/en-US/docs/Web/API/MouseEvent){:target="\_blank"} | Triggered upon mouse movements within the `ThumbnailViewer` | -| `mousedown` | event: [ThumbnailViewerEvent](/_articles/info/api/interfaces.md#thumbnailviewerevent), domEvent: [MouseEvent](https://developer.mozilla.org/en-US/docs/Web/API/MouseEvent){:target="\_blank"} | Triggered upon pressing down the primary mouse button | -| `mouseup` | event: [ThumbnailViewerEvent](/_articles/info/api/interfaces.md#thumbnailviewerevent), domEvent: [MouseEvent](https://developer.mozilla.org/en-US/docs/Web/API/MouseEvent){:target="\_blank"} | Triggered upon releasing the primary mouse button | -| `topchanged` | event: [ThumbnailViewerEvent](/_articles/info/api/interfaces.md#thumbnailviewerevent), domEvent: [MouseEvent](https://developer.mozilla.org/en-US/docs/Web/API/MouseEvent){:target="\_blank"} | Triggered upon scrolling through the thumbnail viewer, **except if using the scroll bar** | -| `resize` | width:number, height:number | Triggered when the width or height of the `ThumbnailViewer` object changes | -| `pageRendered` | index: number | Triggered when a page becomes rendered. | -| `mouseout` | event: [ThumbnailViewerEvent](/_articles/info/api/interfaces.md#thumbnailviewerevent), domEvent: [MouseEvent](https://developer.mozilla.org/en-US/docs/Web/API/MouseEvent){:target="\_blank"} | Triggered upon the mouse leaving the `ThumbnailViewer`; **only supported on desktop browsers** | -| `mouseover` | event: [ThumbnailViewerEvent](/_articles/info/api/interfaces.md#thumbnailviewerevent), domEvent: [MouseEvent](https://developer.mozilla.org/en-US/docs/Web/API/MouseEvent){:target="\_blank"} | Triggered upon mouse hovering over the `ThumbnailViewer`; **only supported on desktop browsers** | -| `keydown` | keyboardEvent: KeyboardEvent | Triggered upon pressing a key; **only supported on desktop browsers** | -| `keyup` | keyboardEvent: KeyboardEvent | Triggered upon releasing a key; **only supported on desktop browsers** | +| Event Name | Arguments | Description | +| :------------- | :------------------------------------------------ | :------------------------------------------------------------------- | +| `click` | event: [ThumbnailViewerEvent](/_articles/info/api/interfaces.md#thumbnailviewerevent), domEvent: [MouseEvent](https://developer.mozilla.org/en-US/docs/Web/API/MouseEvent){:target="_blank"} | Triggered upon primary mouse click | +| `dblclick` | event: [ThumbnailViewerEvent](/_articles/info/api/interfaces.md#thumbnailviewerevent), domEvent: [MouseEvent](https://developer.mozilla.org/en-US/docs/Web/API/MouseEvent){:target="_blank"} | Triggered upon primary mouse double click | +| `contextmenu` | event: [ThumbnailViewerEvent](/_articles/info/api/interfaces.md#thumbnailviewerevent), domEvent: [MouseEvent](https://developer.mozilla.org/en-US/docs/Web/API/MouseEvent){:target="_blank"} | Triggered upon secondary mouse click | +| `mousemove` | event: [ThumbnailViewerEvent](/_articles/info/api/interfaces.md#thumbnailviewerevent), domEvent: [MouseEvent](https://developer.mozilla.org/en-US/docs/Web/API/MouseEvent){:target="_blank"} | Triggered upon mouse movements within the `ThumbnailViewer` | +| `mousedown` | event: [ThumbnailViewerEvent](/_articles/info/api/interfaces.md#thumbnailviewerevent), domEvent: [MouseEvent](https://developer.mozilla.org/en-US/docs/Web/API/MouseEvent){:target="_blank"} | Triggered upon pressing down the primary mouse button | +| `mouseup` | event: [ThumbnailViewerEvent](/_articles/info/api/interfaces.md#thumbnailviewerevent), domEvent: [MouseEvent](https://developer.mozilla.org/en-US/docs/Web/API/MouseEvent){:target="_blank"} | Triggered upon releasing the primary mouse button | +| `resize` | width:number, height:number | Triggered when the width or height of the `ThumbnailViewer` object changes | +| `pageRendered` | index: number | Triggered when a page becomes rendered. | +| `mouseout` | event: [ThumbnailViewerEvent](/_articles/info/api/interfaces.md#thumbnailviewerevent), domEvent: [MouseEvent](https://developer.mozilla.org/en-US/docs/Web/API/MouseEvent){:target="_blank"} | Triggered upon the mouse leaving the `ThumbnailViewer`; **only supported on desktop browsers** | +| `mouseover` | event: [ThumbnailViewerEvent](/_articles/info/api/interfaces.md#thumbnailviewerevent), domEvent: [MouseEvent](https://developer.mozilla.org/en-US/docs/Web/API/MouseEvent){:target="_blank"} | Triggered upon mouse hovering over the `ThumbnailViewer`; **only supported on desktop browsers** | +| `keydown` | keyboardEvent: KeyboardEvent | Triggered upon pressing a key; **only supported on desktop browsers** | +| `keyup` | keyboardEvent: KeyboardEvent | Triggered upon releasing a key; **only supported on desktop browsers** | + +By default, scrolling the scroll bar on the `ThumbnailViewer` does not trigger the `topchanged` event. The method [`unbind()`](/_articles/info/api/WebTwain_Viewer.md#unbind) will dispose all created ThumbnailViewer objects. From c1224a3c226a402ea2547ffc365ac5b2f9e452a4 Mon Sep 17 00:00:00 2001 From: tony-xlh Date: Tue, 18 Nov 2025 10:09:06 +0800 Subject: [PATCH 4/4] fix: remove the mention of the topchanged event and move unbind up --- _articles/info/api/WebTwain_Viewer.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/_articles/info/api/WebTwain_Viewer.md b/_articles/info/api/WebTwain_Viewer.md index b8365ac2..0e2195a6 100644 --- a/_articles/info/api/WebTwain_Viewer.md +++ b/_articles/info/api/WebTwain_Viewer.md @@ -618,6 +618,8 @@ objThumbnailViewer.on("pageRendered", function(index) { **Usage notes** +The method [`unbind()`](/_articles/info/api/WebTwain_Viewer.md#unbind) will dispose all created ThumbnailViewer objects. + For the `CheckboxSettings` and `PageNumberSettings` interface, please refer to the APIs [`updateCheckboxStyle()`](/_articles/info/api/WebTwain_Viewer.md#updatecheckboxstyle) and [`updatePageNumberStyle()`](/_articles/info/api/WebTwain_Viewer.md#updatepagenumberstyle). The following table shows the events available to a ThumbnailViewer object. @@ -637,9 +639,6 @@ The following table shows the events available to a ThumbnailViewer object. | `keydown` | keyboardEvent: KeyboardEvent | Triggered upon pressing a key; **only supported on desktop browsers** | | `keyup` | keyboardEvent: KeyboardEvent | Triggered upon releasing a key; **only supported on desktop browsers** | -By default, scrolling the scroll bar on the `ThumbnailViewer` does not trigger the `topchanged` event. - -The method [`unbind()`](/_articles/info/api/WebTwain_Viewer.md#unbind) will dispose all created ThumbnailViewer objects. ---