BarScanner"
Line 1: | Line 1: | ||
− | {{ZKComponentReferencePageHeader}} | + | [[File:[[File:Example.jpg]][[File:Example.jpg]]]]{{ZKComponentReferencePageHeader}} |
= BarScanner = | = BarScanner = | ||
Line 12: | Line 12: | ||
= Example = | = Example = | ||
+ | [[Image:BarScanner demo.png]] | ||
<source lang="xml" > | <source lang="xml" > |
Revision as of 06:29, 14 May 2018
BarScanner
- Demonstration: BarScanner
- Java API: BarScanner
- JavaScript API: BarScanner
- Available for ZK:
Employment/Purpose
A barScanner component is used to scan and decode the barcode on the client side. There are many properties to dealing with the barScan component. First, you could use the type property to specify the type of barcode, for example: qr, code128, ..., after choose the type you want, you could scan the barcode by the scanner. You can choose the continue scanning by setting contScan="true", and setting the scan rate by setting scanRate="1", the unit of scanRate is sec/time. You can turn on the scanner switch by setting open="true", or close it by open="false".
Example
<barScanner type="qr,code128" contScan="true" scanRate="0.5" height="100px"/>
type
The BarScanner has 9 types for 1D and 1 type for 2D by default. After choosing the type of barcode, and you can scan the barcode as the type you choose. You also can scan multiple types at one time, just setting type="xxx1,xxx2". For example
<barScanner type="qr,code128"/>
Note: (1) The type that barScanner supported can be referenced as Supported Barcode Type (Default). (2) Warn: if too many types are set for the widget, it may reduce the detecting accuracy.
contScan
contScan is a boolean attribute to let the barScanner can continue scan or not.
<barScanner type="qr" contScan="true"/>
scanRate
The scanRate is a subsidiary, integer attribute for contScan. The scanRate="0.5" means the scanner will scan once every 0.5 sec.
<barScanner type="code128" contScan="true" scanRate="0.5"/>
open
The open is boolean attribute to switch the barScanner. You can use the zk mvvm mechanism to to switch the barScanner.
<window viewModel="@id('vm')@init('xxxVM')">
<barScanner type="code128" open= "@bind('vm.open')"/>
height, width
Height and width are string attributes to define the height and width of barScanner component.
<barcode type="qr" height="100px", width="200px"/>
Note:
(1) height is a string as a format of "number+px"
(2) Because of some browsers issue, the ratio of camera screen can only show as default value. The camera screen would fill up the space as user defined.
registerLibrary
registerLibrary(function () {}, library_name, [array of types] ) is a client-side, class-level method to register a custom library into barcode widget. If you register the own custom library into Barcode, every single widget can use the custom library. The way to registering is zkmax.barcode.Barcode.registerLibrary(...). For example: you can register the library as the <zscript> below.
<?script src="mybarcodeLibrary.js"?>
<script>
...
zk.afterLoad('zkmax.barcode', function () {
zkmax.barcode.Barcode.registerLibrary(function mybarcode(wgt) {
...
};
}, 'library-name', ['type1', 'type2', ...]);
});
...
</script>
Note:
(1) registerLibrary is the pure-client-side method.
(2) If you want to register the custom library for all the web application, you can add <javascript src="mybarcodeLibrary.js"/>the source file at WEB-INF/lang-addon.xml.
myRegister.js
zk.afterLoad('zkmax.barcode', function () {
zkmax.barcode.Barcode.registerLibrary(function mybarcode(wgt) {
...
};
}, 'library-name', ['type1', 'type2', ...]);
});
Supported Barcode Type (Default)
1D |
CODE128, EAN, EAN8, CODE39, CODE39VIN, CODEBAR, UPC, UPC_E, I2OF5 |
2D |
QR |
Supported Children
*NONE
Use Cases
Version | Description | Example Location |
---|---|---|
Version History
Version | Date | Content |
---|---|---|
8.6 | May, 2018 | BarScanner |