From 147867ad833b84d628b572248891f6e78bba78d7 Mon Sep 17 00:00:00 2001 From: DMGithubPublisher Date: Tue, 12 Aug 2025 16:51:11 +0800 Subject: [PATCH 1/3] update to internal commit b986aa54 --- _data/product_version.yml | 3 +- .../programming-javascript.html | 7 + .../sidelist-parameters.html | 2 + assets/js/dbrWebVersionSearch.json | 6 + .../api-reference/barcode-scanner.md | 10 +- programming/javascript/release-notes/index.md | 1 + programming/javascript/release-notes/js-11.md | 21 + .../samples-demos/index-v11.0.3000.md | 310 +++++++ programming/javascript/samples-demos/index.md | 15 + .../javascript/upgrade-guide/10to11.md | 4 +- .../barcode-scanner-customization.md | 15 +- .../user-guide/barcode-scanner-v11.0.3000.md | 230 ++++++ .../javascript/user-guide/barcode-scanner.md | 30 +- .../javascript/user-guide/index-v11.0.3000.md | 754 ++++++++++++++++++ programming/javascript/user-guide/index.md | 85 +- .../user-guide/use-in-framework-v10.5.3000.md | 391 +++++++++ .../javascript/user-guide/use-in-framework.md | 10 +- .../javascript/user-guide/zip-guide.md | 82 ++ 18 files changed, 1903 insertions(+), 73 deletions(-) create mode 100644 programming/javascript/samples-demos/index-v11.0.3000.md create mode 100644 programming/javascript/user-guide/barcode-scanner-v11.0.3000.md create mode 100644 programming/javascript/user-guide/index-v11.0.3000.md create mode 100644 programming/javascript/user-guide/use-in-framework-v10.5.3000.md create mode 100644 programming/javascript/user-guide/zip-guide.md diff --git a/_data/product_version.yml b/_data/product_version.yml index 67794b3b..49e6e7fb 100644 --- a/_data/product_version.yml +++ b/_data/product_version.yml @@ -1,9 +1,10 @@ useGroupedVersion: true version_info_list_js: - - value: latest version(11.0.3000) + - value: latest version(11.0.6000) - value: 10.x child: + - 11.0.3000 - 10.5.3000 - 10.4.3100 - 10.4.2002 diff --git a/_includes/sidelist-programming/programming-javascript.html b/_includes/sidelist-programming/programming-javascript.html index a8df2c79..ba15d3af 100644 --- a/_includes/sidelist-programming/programming-javascript.html +++ b/_includes/sidelist-programming/programming-javascript.html @@ -1057,6 +1057,13 @@ >Edge +
  • + ErrorInfo +
  • EnableQRCodeModel1
  • FindUnevenModuleBarcode
  • HeadModuleRatio
    • +
  • IncludeImpliedAI01
    • +
  • IncludeTrailingCheckDigit
  • MinQuietZoneWidth
  • MinRatioOfBarcodeZoneWidthToHeight
  • MinResultConfidence
    • diff --git a/assets/js/dbrWebVersionSearch.json b/assets/js/dbrWebVersionSearch.json index b3756951..7d4c2a70 100644 --- a/assets/js/dbrWebVersionSearch.json +++ b/assets/js/dbrWebVersionSearch.json @@ -1,4 +1,10 @@ [ + { + "version": "11.0.6000", + "matchVersion": { + "javascript": "3.0.6000" + } + }, { "version": "11.0.3000", "matchVersion": { diff --git a/programming/javascript/api-reference/barcode-scanner.md b/programming/javascript/api-reference/barcode-scanner.md index 2ae77451..d56f1565 100644 --- a/programming/javascript/api-reference/barcode-scanner.md +++ b/programming/javascript/api-reference/barcode-scanner.md @@ -125,6 +125,7 @@ interface BarcodeScannerConfig { barcodeFormats?: EnumBarcodeFormat | Array; duplicateForgetTime?: number; showPoweredByDynamsoft?: boolean; + autoStartCapturing? : boolean; container?: HTMLElement | string | undefined; onUniqueBarcodeScanned?: (result: BarcodeResultItem) => void | Promise; showResultView?: boolean; @@ -134,6 +135,7 @@ interface BarcodeScannerConfig { onInitPrepare?: () => void; onInitReady?: (components: {cameraView: CameraView;cameraEnhancer: CameraEnhancer;cvRouter: CaptureVisionRouter;}) => void; onCameraOpen?: (components: {cameraView: CameraView;cameraEnhancer: CameraEnhancer;cvRouter: CaptureVisionRouter;}) => void; + onCaptureStart?: (components: {cameraView: CameraView;cameraEnhancer: CameraEnhancer;cvRouter: CaptureVisionRouter;}) => void; } ``` @@ -148,6 +150,7 @@ interface BarcodeScannerConfig { | `barcodeFormats`(optional) | `EnumBarcodeFormat` \| `Array` | `N/A` | [EnumBarcodeFormat](https://www.dynamsoft.com/capture-vision/docs/core/enums/barcode-reader/barcode-format.html?lang=js&product=dbr) or an array of `EnumBarcodeFormat` specifying the formats to recognize. | | `duplicateForgetTime`(optional) | `number` | `3000` | Time interval in milliseconds before duplicate barcodes can be reported again. | | `showPoweredByDynamsoft`(optional) | `boolean` | `true` | Whether to show the "powered by" message. | +| `autoStartCapturing`(optional) | `boolean` | `true` | Whether to start capturing directly after opening the camera. | | `container`(optional) | `HTMLElement` \| `string` | `N/A` | A container element or selector for rendering the scanner and/or result view. | | `showResultView`(optional) | `boolean` | `true` | Whether to display a result view in SM_MULTI_UNIQUE mode. | | `showUploadImageButton`(optional) | `boolean` | `false` | Determines the visibility of the "uploadImage" button that allows the user to upload an image for decoding. | @@ -157,6 +160,7 @@ interface BarcodeScannerConfig { | `onInitPrepare` | `N/A` | `N/A` | A callback function that is triggered before the scanner components are initialized. | | `onInitReady` | `N/A` | `N/A` | Called when the scanner components have been successfully initialized and are ready. | | `onCameraOpen` | `N/A` | `N/A` | Called when the camera is successfully opened for the first time or after each camera switch. | +| `onCaptureStart` | `N/A` | `N/A` | Called when the capture process begins. | **Code Snippet** @@ -178,6 +182,7 @@ interface BarcodeScannerConfig { showPoweredByDynamsoft: false, duplicateForgetTime: 3000, showUploadImageButton: true, + autoStartCapturing: true, // The container for rendering the scanner and/or result view. Note that ResultView is only valid for SM_MULTI_UNIQUE mode. If not specified, a full-viewport default UI will be created. container: "#camera-view-container", scannerViewConfig: { @@ -211,7 +216,10 @@ interface BarcodeScannerConfig { components.cameraEnhancer.setScanRegion(region); }, onCameraOpen: (components) => { - // Do something with the foundational components + // Do something with the foundational components when the camera is successfully opened for the first time or after each camera switch + }, + onCaptureStart: (components) => { + // Do something with the foundational components when the capture process begins }, }; // Initialize the BarcodeScanner with the above BarcodeScannerConfig object diff --git a/programming/javascript/release-notes/index.md b/programming/javascript/release-notes/index.md index b24e70a8..53986d22 100644 --- a/programming/javascript/release-notes/index.md +++ b/programming/javascript/release-notes/index.md @@ -10,6 +10,7 @@ permalink: /programming/javascript/release-notes/index.html # DBR JavaScript SDK - Release Notes +- [11.0.6000 (08/00/2025)](js-11.html#1106000-08002025) - [11.0.3000 (07/09/2025)](js-11.html#1103000-07092025) - [10.5.3000 (04/24/2025)](js-10.html#1053000-04242025) - [10.4.3100 (01/03/2025)](js-10.html#1043100-01032025) diff --git a/programming/javascript/release-notes/js-11.md b/programming/javascript/release-notes/js-11.md index cd894424..d7ea4fca 100644 --- a/programming/javascript/release-notes/js-11.md +++ b/programming/javascript/release-notes/js-11.md @@ -10,6 +10,27 @@ noTitleIndex: true # Release Notes for Dynamsoft Barcode Reader JavaScript SDK +## 11.0.6000 (08/00/2025) + +### New + +- Introduced new samples: + + - [`Pick One to Fill`](https://github.com/Dynamsoft/barcode-reader-javascript-samples/tree/main/barcode-scanner-api-samples/scan-single-barcode/pick-one-to-fill/index.html) - [run↗](https://demo.dynamsoft.com/samples/dbr/js/barcode-scanner-api-samples/scan-single-barcode/pick-one-to-fill/index.html?utm_source=sampleReadme): Pick one and auto-fill fields by simply opening the camera and scanning a group of barcodes. + - [`Use Customized Template`](https://github.com/Dynamsoft/barcode-reader-javascript-samples/tree/main/barcode-scanner-api-samples/scan-single-barcode/use-customized-template/index.html) - [run↗](https://demo.dynamsoft.com/samples/dbr/js/barcode-scanner-api-samples/scan-single-barcode/use-customized-template/index.html?utm_source=sampleReadme): Use different customized templates for scanning various barcode types. + - [`Batch Inventory`](https://github.com/Dynamsoft/barcode-reader-javascript-samples/blob/main/barcode-scanner-api-samples/scan-multiple-barcodes/batch-inventory/index.html) - [run↗](https://demo.dynamsoft.com/samples/dbr/js/barcode-scanner-api-samples/scan-multiple-barcodes/batch-inventory/index.html?utm_source=sampleReadme): An inventory management tool scan barcodes in batches and provide real-time analysis of the scanned data. + - [`Read and Parse GS1-AI`](https://github.com/Dynamsoft/barcode-reader-javascript-samples/tree/main/foundational-api-samples/use-case/read-and-parse-GS1-AI/index.html) - [run↗](https://demo.dynamsoft.com/samples/dbr/js/foundational-api-samples/use-case/read-and-parse-GS1-AI/index.html?utm_source=sampleReadme): Read GS1 Application Identifier (AI) barcode and parse its structured data. + +- Template Version Validation: Introduced version checking for templates to prevent compatibility issues and mismatches. + +### Changed + +- License Validation Behavior: Instead of stopping execution immediately on an invalid license module, the library now continues processing and returns results from modules with valid licenses. An warning is still reported to indicate the license issue. + +### Fixed + +Fixed various minor bugs and improved overall stability. + ## 11.0.3000 (07/09/2025) ### [Highlights](https://www.dynamsoft.com/release-highlights/?product=dcv3.0) diff --git a/programming/javascript/samples-demos/index-v11.0.3000.md b/programming/javascript/samples-demos/index-v11.0.3000.md new file mode 100644 index 00000000..0c466488 --- /dev/null +++ b/programming/javascript/samples-demos/index-v11.0.3000.md @@ -0,0 +1,310 @@ +--- +layout: default-layout +title: Samples and Demos Index - Dynamsoft Barcode Reader JavaScript Edition +description: Refer these samples and demos for different frameworks such as Angular, React, NuxtJS, etc, of Dynamsoft Barcode Reader JavaScript Edition. +keywords: javascript, js +breadcrumbText: Samples and Demos +noTitleIndex: true +needAutoGenerateSidebar: false +--- + + +
    + + + +
    +

    BarcodeScanner API Samples

    +
    +
    +
    Scan Single Barcode
    +
    +
    Hello World + +
    +
    Scan and Search + +
    +
    Hello World in + Angular (Angular logo) + + +
    +
    + Hello World in + React (React logo) + + +
    +
    + Hello World in + Vue (Vue logo) + + +
    +
    +
    Scan Multiple Barcodes
    +
    +
    Hello World + + +
    +
    Scan + to Cart Simulation + +
    +
    +
    +
    +

    Foundational API Samples

    +
    +
    +
    Hello World
    +
    +
    Hello + World + +
    +
    Read + an Existing + Image + +
    +
    Hello World in + Angular (Angular logo) + + +
    +
    Hello World in + Blazor (Blazor logo) + + +
    +
    + Hello World in + React (React logo) + + +
    +
    + Hello World in + React(using Hooks)(React logo) + + +
    +
    + Hello World in + Vue (Vue logo) + + +
    +
    + Hello World in + Next.js ( + + + + + + + + + + + + + ) + +
    +
    + Hello World in + NuxtJS ( + + + + + + ) + +
    +
    + Hello World in + Electron (Electron logo) + + +
    +
    Hello World in + PWA + +
    +
    Hello + World with + RequireJS + +
    +
    Hello + World with + ES6 + +
    +
    + Hello World in + WebView + +
    +
    +
    Use Case
    +
    +
    Read Video and + Fill a + Form + +
    +
    Read a + Driver's License + +
    +
    Show Result Texts on the Video + +
    +
    Find Item via Barcode + +
    +
    +
    Others
    +
    +
    Collect + Images for Debugging + +
    +
    +
    +
    Official Online Demo + + +
    +
    \ No newline at end of file diff --git a/programming/javascript/samples-demos/index.md b/programming/javascript/samples-demos/index.md index 0c466488..17a9e31f 100644 --- a/programming/javascript/samples-demos/index.md +++ b/programming/javascript/samples-demos/index.md @@ -109,6 +109,14 @@ needAutoGenerateSidebar: false and simulate a search from a product database.">Scan and Search +
    Pick One to Fill + +
    +
    Use Customized Template + +
    Hello World in Angular (Angular logo
    +
    Batch Inventory + +
    @@ -294,6 +306,9 @@ needAutoGenerateSidebar: false
    Find Item via Barcode
    +
    Read the GS1-AI Barcode and Parse It + +
    Others
    diff --git a/programming/javascript/upgrade-guide/10to11.md b/programming/javascript/upgrade-guide/10to11.md index a8244089..e036d73c 100644 --- a/programming/javascript/upgrade-guide/10to11.md +++ b/programming/javascript/upgrade-guide/10to11.md @@ -14,10 +14,10 @@ permalink: /programming/javascript/upgrade-guide/10to11.html To use version 11, include the following script in your HTML: ```html - + ``` -## APIs changes introduced in v11.0.3000 +## APIs changes introduced in v11 ### BarcodeScanner API Changes diff --git a/programming/javascript/user-guide/barcode-scanner-customization.md b/programming/javascript/user-guide/barcode-scanner-customization.md index 792a8a69..507e5342 100644 --- a/programming/javascript/user-guide/barcode-scanner-customization.md +++ b/programming/javascript/user-guide/barcode-scanner-customization.md @@ -3,7 +3,7 @@ layout: default-layout needAutoGenerateSidebar: true needGenerateH3Content: true noTitleIndex: true -title: Customizations - Dynamsoft Barcode Scanner v11.0.3000 JavaScript Edition +title: Customizations - Dynamsoft Barcode Scanner v11.0.6000 JavaScript Edition keywords: Documentation, Barcode Scanner, Dynamsoft Barcode Scanner JavaScript Edition, customization description: Dynamsoft Barcode Scanner customization --- @@ -101,7 +101,12 @@ Here is a quick breakdown of the `MULTI_UNIQUE` UI elements of the `BarcodeResul ### Manually modify the UI file -Another way to fully customize the UI is by directly editing the `.xml` file. In the `dist/` directory, you'll find the `barcode-scanner.ui.xml` file, which is the default UI for the `BarcodeScanner`. You can make a copy of it and apply your own modifications. For example, to double the size of the `UploadImage` icon, you can edit the file like this: +Another way to fully customize the UI is by directly editing the `.xml` file. In the `dist/` directory, you'll find the `barcode-scanner.ui.xml` file, which is the default UI for the `BarcodeScanner`. + +> [!NOTE] +> Although it is essentially HTML, using a .xml extension can help prevent compatibility issues with the Live Server plugin. + +You can make a copy of it and apply your own modifications. For example, to double the size of the `UploadImage` icon, you can edit the file like this: ```xml