Barcode Scanner Emulator
Hoe om strepieskodeskandeerders in webtoepassings te toets
Baie USB- en Bluetooth-strepieskodeskandeerders stuur gedekodeerde data as sleutelbordinvoer, sodat ’n gefokusde veld in ’n webtoepassing ’n skandering kan ontvang sonder ’n skandeerder-spesifieke blaaier-API. Seriepoorte en verkoper-SDK’s is afsonderlike integrasies. Jy kan die sleutelbordpad met ’n fisiese skandeerder of met gesimuleerde toetsaanslae toets.
’n Webtoepassing sien ’n strepieskodeskandeerder gewoonlik as ’n sleutelbord. Die toets is of die gefokusde kontrole die loonvrag ontvang wat jou toepassing verwag, en of die bladsy die afsluiter hanteer wat die skandeerder opgestel is om te stuur. Daardie afsluiter kan Enter, Tab of niks wees.
Gebruik ’n Strepieskode-invoertoetser-sessie wanneer ’n fisiese skandeerder gekoppel is. Gebruik die Barcode Scanner Emulator wanneer jy dieselfde sleutelbordpad tydens ontwikkeling nodig het en die hardeware nie op die lessenaar is nie. ’n Breër oorsig van fokus, uitleg en POS-werkvloeie is in Hoe om strepieskodeskandeerderinvoer te toets. Hierdie gids bly by die blaaiertoepassing: vaslegging, agtervoegsels, validering en die gebeure wat jy werklik kan waarneem.
Hoe strepieskodeskandeerders met webtoepassings kommunikeer
Die koppelvlakmodus besluit wat die bladsy kan ontvang. Bevestig dit voordat jy vormkode verander. ’n Skandeerder kan dikwels modus verander deur ’n opstellingstrepieskode uit die vervaardiger se handleiding te skandeer.
USB HID-sleutelbordwig
In USB HID-sleutelbordmodus registreer die skandeerder as ’n sleutelbord. Die bedryfstelsel laai sy gewone sleutelborddrywer. Nadat die skandeerder ’n simbool gedekodeer het, stuur dit die karakters as toetsaanslae na watter kontrole ook al sleutelbordfokus het. Die bladsy luister vir daardie toetsaanslae, of lees die teks wat hulle invoeg. Dit maak nie ’n verbinding met die toestel oop nie.
Daardie pad is waarom ’n betaalveld, ’n soekkassie of enige ander teksinvoer ’n skandering met gewone HTML kan aanvaar. Die gids HID-sleutelbordwig dek die toetsaanslagvolgorde, voorvoegsels en agtervoegsels in meer besonderhede.
Bluetooth HID
’n Bluetooth-skandeerder wat as ’n sleutelbord gepaar is, gebruik dieselfde toepassingspad. Die rekenaar hanteer dit as ’n HID-sleutelbord, en die gefokusde veld ontvang toetsaanslae. Paring, battery en die radio is toestelkwessies. Sodra die karakters die blaaier bereik, hanteer die bladsy hulle op dieselfde manier as USB-wiginvoer.
Serieel en virtuele COM-poort
’n Serieelskandeerder, insluitend baie USB-virtuele COM-poortmodusse, stuur die gedekodeerde teks as grepe op ’n poort. Fokus kies nie die bestemming nie. Die proses wat die poort oopmaak, doen dit. ’n Teksveld wat net vir toetsaanslae luister, sal nie daardie stroom sien nie.
Chromium-gebaseerde blaaiers kan ’n seriepoort deur die Web Serial API oopmaak nadat die gebruiker die poort kies en toestemming gee. Firefox en Safari verskaf nie daardie API nie. ’n Wigtoets oefen nie ’n serie-integrasie nie, en ’n serietoets sê nie wat ’n wigskandeerder sal tik nie.
Verkoperspesifieke koppelvlakke
Sommige toestelle gebruik ’n verkoper-SDK, OPOS, JPOS of ’n nie-sleutelbord-HID-koppelvlak soos USB HID POS. Daardie koppelvlakke tik nie in die gefokusde veld nie. ’n Gewone webbladsy kan nie ’n inheemse SDK laai nie. Chromium kan sommige nie-sleutelbord-HID-toestelle deur WebHID versoek ná ’n gebruikergebaar. HID-toestelle van die sleutelbordklas bly geblokkeer, sodat ’n wigskandeerder ononderskeibaar van ’n sleutelbord bly. Behandel ’n verkoperkoppelvlak as sy eie integrasie en toets dit met die sagteware wat daardie koppelvlak werklik oopmaak.
Wat die blaaier kan sien
’n Wigskandering kom as keydown- en keyup-gebeure aan, en drukbare karakters werk die gefokusde veld by. Die blaaier ontvang nie ’n toestelnaam, ’n USB-reeksnommer of ’n vlag wat aandui dat dit ’n skandeerder is nie. Blaaiers wat WebHID implementeer, weier steeds sleutelbordkoppelvlakke, sodat bladsyskrip ook nie die rou HID-verslae van ’n wigskandeerder kan lees nie.
event.key is die karakter of sleutelnaam nadat die bedryfstelsel die aktiewe sleutelborduitleg toegepas het. event.code benoem die fisiese sleutel, soos Digit1 of Numpad1, en kan dieselfde bly wanneer ’n uitlegwanpassing event.key verander. Nie een van die eienskappe identifiseer die hardeware nie.
Hoe om ’n fisiese strepieskodeskandeerder in ’n blaaier te toets
Doen dit voordat jy toepassingskode ontfout. Dit wys die presiese string en afsluiter wat die blaaier ontvang het.
- Koppel die skandeerder en wag totdat dit wys dat dit krag het. Vir Bluetooth, voltooi paring en bevestig dat die rekenaar ’n sleutelbordprofiel gebruik.
- Bevestig die invoermodus. Sleutelbordwig, USB HID-sleutelbord of Bluetooth HID-sleutelbord kan in ’n veld tik. Serieel, SPP en verkoper-SDK-modusse sal nie.
- Maak die Strepieskode-invoertoetser oop.
- Klik Begin toets, of klik die skandeerarea. Dit word blou wanneer dit gereed is. Die bladsy neem nie self fokus nie.
- Skandeer ’n strepieskode waarvan jy die loonvrag reeds ken. Begin met ’n kort numeriese waarde, en skandeer dan ’n waarde wat die leestekens insluit wat jou toepassing stoor.
- Lees die vasgevange waarde en die karaktertelling. Vergelyk albei met die loonvrag wat jy verwag, insluitend enige voorvoegsel wat die skandeerder voor die data invoeg.
- Kontroleer die agtervoegsel. Die toetser rapporteer ENTER, TAB of Geen. Met Outovang aan, verskyn die resultaat ná Enter, Tab of ’n kort pouse sodra die sleutels stop. Skakel Outovang af wanneer jy die vaslegging wil hou totdat jy Stop druk.
- Vergelyk daardie resultaat met die string wat jou toepassing moet stoor. ’n Voorvoegsel, ’n vervange karakter of ’n ontbrekende afsluiter moet in die skandeerderopstelling reggestel word of doelbewus op die bladsy hanteer word. Moenie dit as ’n dekodeerfout beskou totdat hierdie vergelyking gedoen is nie.
Die toetser teken sleutelbordgebeure aan wat die blaaier kan sien. Dit kan nie die USB-toestel identifiseer of ’n seriepoort lees nie. Wanneer ’n teksredigeerder die skandering ontvang en die blaaier nie, gaan voort met Skandeerder werk in Notepad maar nie in POS nie.
Vang strepieskodeskandeerderinvoer met JavaScript vas
’n Skandeerder tik in die element wat fokus het. Gee die veld ’n sigbare etiket, los dit as ’n gewone teksinvoer sodat sleutelbordgebruikers ’n kode kan tik, en lees die waarde wanneer die werkvloei sê dat die inskrywing voltooi is. Die bladsy hieronder doen dit. Enter dien die vorm een keer in. Tab voltooi ’n nie-leë waarde en laat die blaaier dan fokus skuif. ’n Skandering sonder afsluiter bly in die veld totdat iemand Look up aktiveer.
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Barcode input example</title>
</head>
<body>
<form id="barcode-form">
<label for="barcode">Barcode</label>
<input id="barcode" name="barcode" type="text" autocomplete="off" spellcheck="false">
<button type="submit">Look up</button>
</form>
<p id="message" role="status"></p>
<ul id="accepted"></ul>
<script>
const form = document.querySelector('#barcode-form')
const field = document.querySelector('#barcode')
const message = document.querySelector('#message')
const list = document.querySelector('#accepted')
if (
!(form instanceof HTMLFormElement) ||
!(field instanceof HTMLInputElement) ||
!(message instanceof HTMLElement) ||
!(list instanceof HTMLUListElement)
) {
throw new Error('Barcode form markup is missing.')
}
function payload(raw) {
return raw.replace(/[\r\n]/g, '').trim()
}
function classify(raw) {
const value = payload(raw)
if (!value) {
return { status: 'empty' }
}
if (/[\u0000-\u001F\u007F]/.test(value)) {
return {
status: 'invalid',
message: 'Control character in the barcode. Check the prefix, suffix, and symbology identifier.',
}
}
return { status: 'ok', value }
}
function accept(value) {
const item = document.createElement('li')
item.textContent = value
list.append(item)
message.textContent = 'Accepted ' + value
field.value = ''
}
function reject(text) {
message.textContent = text
}
form.addEventListener('submit', (event) => {
event.preventDefault()
const outcome = classify(field.value)
if (outcome.status === 'empty') {
reject('No barcode received.')
field.focus()
return
}
if (outcome.status === 'invalid') {
reject(outcome.message)
field.focus()
return
}
accept(outcome.value)
field.focus()
})
field.addEventListener('keydown', (event) => {
if (event.key !== 'Tab' || event.shiftKey) {
return
}
const outcome = classify(field.value)
if (outcome.status === 'empty') {
return
}
if (outcome.status === 'invalid') {
event.preventDefault()
reject(outcome.message)
return
}
accept(outcome.value)
})
field.focus()
</script>
</body>
</html>
Stoor daardie lêer en maak dit in ’n lessenaarblaaier oop. Klik die veld as fokus geskuif het. ’n Wigskandeerder, of die emulator in die volgende afdeling, tik dan in #barcode.
Fokus is nodig. As document.activeElement die dokumentliggaam, ’n knoppie of ’n ander invoer is, sien hierdie veld se luisteraars nie die skandering nie. Die karakters beland in die gefokusde kontrole, of hulle gaan verlore. Roep field.focus() wanneer die werkvloei gereed is vir ’n skandering, ook nadat ’n dialoog sluit.
Leë invoer word geïgnoreer. Die vorm bly in plek, en die statusteks sê dat niks ontvang is nie. Witspasie alleen is leeg ná trim().
Die voorbeeld voeg nie Enter of Tab by nie. As die skandeerder nie opgestel is om hulle te stuur nie, bly die waarde in die veld en Look up is die voltooiingspad. autocomplete="off" verklein die kans dat ’n gestoorde waarde die skandering vervang. Die etiket, die knoppie en Shift+Tab bly beskikbaar, sodat ’n persoon ’n kode sonder ’n skandeerder kan invoer.
Hanteer Enter op een plek. Hierdie voorbeeld gebruik die vorm se submit-gebeurtenis, wat ook die Look up-knoppie en ’n sleutelbord-Enter dek. ’n Tweede keydown-luisteraar vir Enter sou dieselfde skandering twee keer aanteken. As die invoer nie binne ’n vorm is nie, luister vir Enter op keydown en roep preventDefault() sodat ’n voorouervorm nie ook indien nie:
field.addEventListener('keydown', (event) => {
if (event.key !== 'Enter') {
return
}
event.preventDefault()
const value = field.value.trim()
if (!value) {
return
}
console.log(value)
field.value = ''
})
Maak die veld skoon ná ’n suksesvolle aanvaarding sodat die volgende skandering nie by die vorige loonvrag aanheg nie. Ná Enter fokus die voorbeeld weer dieselfde veld, omdat daardie werkvloei nog ’n skandering in dieselfde kassie verwag. Ná Tab los dit fokus alleen sodat die blaaier na die volgende kontrole kan skuif.
Hantering van ENTER- en TAB-agtervoegsels
’n Agtervoegsel is ’n sleutel wat die skandeerder ná die loonvrag kan stuur. Dit is ’n toestelinstelling. Enter is algemeen, en dit is opsioneel. Die gids ENTER- teenoor TAB-agtervoegsels in strepieskodeskandeerders beskryf hoe om die afsluiters van mekaar te onderskei. Bevestig die instelling op die skandeerder wat jy toets, en laat die bladsy dan by daardie werkvloei pas.
ENTER
Enter binne ’n eenlyn-teksveld dien die omringende vorm in huidige blaaiers in. Gebruik dit wanneer een skandering die waarde moet vaslê, soos in ’n opsoekkassie. preventDefault() op die submit-gebeurtenis keer dat die blaaier weg navigeer. Laat dit weg wanneer ’n volle bladsynavigasie die gedrag is wat jy wil hê.
As die strepieskode verskyn en die vorm niks doen nie, stuur die skandeerder dalk geen agtervoegsel nie. Strepieskodeskandeerder se ENTER ontbreek loop deur daardie opstelling. Sommige toestelle stuur NumPad Enter. event.key is steeds "Enter". Kontroleer event.key, nie net event.code === "Enter" nie, anders sal daardie skandeerder gebreek lyk.
TAB
Tab skuif fokus na die volgende fokusbare kontrole. Dit pas by ’n volgorde soos produkkode, dan hoeveelheid. Dit verras ’n vorm wat verwag het dat Enter sou indien.
Lees die waarde in keydown terwyl die veld nog fokus het. Die blaaier skuif fokus ná daardie gebeurtenis. Los die verstekaksie in plek wanneer die volgende kontrole fokus moet ontvang. preventDefault() hou fokus waar dit is, wat nuttig is wanneer die waarde ongeldig is en jy wil hê die operateur moet dit sien. Ignoreer Shift+Tab sodat ’n sleutelbordgebruiker agteruit deur die vorm kan beweeg. ’n Skandeerder-Tab-agtervoegsel is Tab sonder Shift.
’n Tab-agtervoegsel kan ook fokus skuif voordat jou kode die veld lees, as die luisteraar op blur of change is en iets anders die kontrole uitvee. Lees die waarde uit die teiken van die keydown-gebeurtenis.
Geen agtervoegsel
Sonder ’n agtervoegsel sit die loonvrag in die veld. Die toepassing moet besluit wanneer die skandering klaar is. ’n Uitdruklike knoppie, ’n latere Enter van die operateur, of ’n skuif na ’n ander stap is betroubare voltooiingspunte. ’n Onaktiwiteitstydhouer kan ’n pouse in tik as die einde van ’n skandering beskou. Daardie tydhouer is ’n heuristiek. ’n Stadige skandeerder, ’n Bluetooth-vertraging of ’n persoon wat vinnig tik, kan aan die verkeerde kant van die drempel beland. Verkies ’n opgestelde agtervoegsel wanneer die werkvloei ’n harde einde-van-skandering-sein nodig het.
Opstellingsverskille
Skandeerders van dieselfde handelsmerk kan met verskillende agtervoegsels verskeep word, en ’n opstellingstrepieskode kan die agtervoegsel verander sonder enige verandering in jou JavaScript. Sommige toestelle stuur ’n voorvoegsel, ’n simbologie-identifiseerder soos ]C1, of CR en LF. Toets die drie afsluiterinstellings wat jou gebruikers werklik kan kies: Enter, Tab en geen. Teken aan watter een die ontplooide skandeerders gebruik, en toets die bladsy teen daardie instelling.
Validering van strepieskodeskandeerderinvoer
Valideer die string wat die veld ontvang het. Moenie aanneem dat elke strepieskode dieselfde lengte, karakterstel of kontrolesom het nie. Code 128- en QR-loonvragte wissel. EAN-13 is 13 syfers. ’n Toepassing wat albei stoor, het reëls vir albei nodig.
Leë invoer. Verwerp of ignoreer dit. ’n Agtervoegsel sonder loonvrag, of ’n Look up-klik op ’n leë veld, moet nie ’n rekord skep nie.
Onverwagte karakters. Vergelyk die ontvangde string met ’n bekende etiket. ’n Uitlegwanpassing wys dikwels as ’n veranderde simbool, soos ’n verskuifde syfer of leesteken, terwyl die lengte dieselfde bly. Kontrolekarakters kan van ’n voorvoegsel of van ’n GS1-groepskeier kom. Laat die karakters toe wat jou formaat definieer. Die voorbeeld hierbo verwerp ASCII-kontrolekarakters sodat hulle sigbaar in die statusteks bly. ’n GS1-ontleder wat ’n groepskeier verwag, moet daardie karakter toelaat en die res verwerp.
Lengte. Dwing die lengtes af wat jou toepassing aanvaar. ’n Globale minimum en maksimum is veiliger as een vereiste lengte wanneer die vorm meer as een simbologie ontvang. maxlength op die invoer sal ’n langer loonvrag stilweg afkap, so stel dit net wanneer elke aanvaarde kode pas.
Voorvoegsel. Stroop ’n voorvoegsel net wanneer jy die skandeerder opgestel het om daardie presiese voorvoegsel te stuur en die toepassing dit nie stoor nie.
function withoutConfiguredPrefix(value, prefix) {
if (prefix && value.startsWith(prefix)) {
return value.slice(prefix.length)
}
return value
}
’n AIM-simbologie-identifiseerder is data as die skandeerder ingestel is om dit te versend. Los dit in plek totdat jy besluit het of die toepassing dit stoor.
Agtervoegsel. Hou die afsluiter uit die gestoorde waarde. Enter en Tab is sleutels. Hulle word nie in ’n gewone teksinvoer ingevoeg nie. ’n Serie-loonvrag kan steeds CR- of LF-grepe insluit. Stroop dié by die grens waar jy die seriestroom ontleed, en toets dat jy hulle nie uit die middel van ’n loonvrag stroop wat hulle wettig bevat nie.
Duplikaatindienings. Een skandering kan twee keer hanteer word as beide keydown en submit vir dieselfde Enter loop. Gebruik ’n enkele voltooiingspad. ’n Tweede skandering van dieselfde kode is ’n ander vraag. ’n Pakhuisvorm kan hoeveelheid verhoog. ’n Kaartjievorm kan ’n kode verwerp wat reeds ingewissel is. Sit daardie reël in die toepassing, en toets dit doelbewus. Die blaaier kan nie ’n tweede snellerdruk van ’n tweede luisteraar onderskei nie.
Toepassingsreëls. Kontrolesomme behoort aan spesifieke simbologieë. EAN-13 gebruik die laaste syfer as ’n kontrolesyfer. Hierdie funksie aanvaar net daardie formaat:
function isEan13(value) {
if (!/^\d{13}$/.test(value)) {
return false
}
let sum = 0
for (let index = 0; index < 12; index += 1) {
const digit = Number(value[index])
sum += index % 2 === 0 ? digit : digit * 3
}
const check = (10 - (sum % 10)) % 10
return check === Number(value[12])
}
Code 128, Code 39 en QR gebruik nie daardie berekening nie. Die skandeerder het dalk reeds sy eie simbologie nagegaan en die mensleesbare data versend. Valideer die formate wat jy stoor, en herhaal die kontrole op die bediener. Die ingediende string is gewone gebruikersinvoer. Die blaaier kan nie bewys dat ’n skandeerder dit geproduseer het nie.
Toets strepieskodeskandeerderinvoer sonder fisiese hardeware
Die Barcode Scanner Emulator is ’n lessenaartoepassing vir Windows, macOS en Linux. Jy voer die teks in om te stuur, kies ’n tikvertraging, en kies ’n agtervoegsel van geen, ENTER of TAB. ’n Globale kortpad tik daardie teks in die gefokusde toepassing. Dit reproduseer die sleutelbordpad wat ’n wigskandeerder gebruik. Dit verlig nie ’n etiket nie, lees nie ’n simbool nie en dekodeer nie ’n simbologie nie.
Gebruik die voorbeeldbladsy hierbo, of die bladsy wat jy bou:
- Maak die bladsy in ’n lessenaarblaaier oop en klik die strepieskodeveld.
- In die emulator, voer ’n bekende waarde soos
123456789012in. - Stel die agtervoegsel op ENTER. Stel die tikvertraging as jy wil hê die sarsie moet soos ’n skandeerder lyk wat jy reeds gemeet het.
- Druk die emulator se globale skandeerkortpad terwyl die blaaiveld nog fokus het.
- Bevestig die statusteks en dat die waarde een keer aanvaar is.
- Herhaal met TAB. Fokus moet skuif, en die waarde moet een keer aanvaar word.
- Herhaal met geen agtervoegsel. Die teks moet in die veld bly totdat jy Look up aktiveer.
- Fokus die Strepieskode-invoertoetser en stuur dieselfde waarde weer. Vergelyk die vasgevange string, voorvoegsel en agtervoegsel met wat die toepassing gestoor het.
Installasie en die eerste kortpad word in Aan die gang gedek. Ná ’n instellingsverandering, stuur een skandering na die invoertoetser voordat jy die resultaat in die toepassing vertrou.
Hardeware is steeds nodig vir die optiese en toestelspesifieke dele van die toets:
- Of daardie skandeerder die gedrukte of vertoonde simbool kan dekodeer, insluitend beskadigde etikette, grootte, kontras en afstand.
- Simbologie-ondersteuning. ’n 1D-laserskandeerder kan nie ’n QR-kode lees nie. Sien QR-kodetoetsing: hoe om QR-kodeskandeerders te toets.
- USB-registrasie, Bluetooth-paring, en die skandeerder se eie sleutelborduitleg en agtervoegselopstelling.
- Serieel-, HID POS- en verkoper-SDK-integrasies.
Die emulator is die regte hulpmiddel vir toepassingslogika langs die sleutelbordpad. Dit is die verkeerde hulpmiddel om te bewys dat ’n bepaalde skandeerder ’n bepaalde etiket lees.
Ontfouting van strepieskodeskandeerder-sleutelbordgebeure
Kyk die gebeure in hierdie volgorde wanneer die gestoorde waarde verkeerd is.
keydown. Vuur vir elke sleutel, insluitend Enter en Tab, voordat die blaaier ’n karakter invoeg of fokus skuif. Lees die afsluiter hier. event.repeat is waar wanneer ’n sleutel ingehou word. ’n Wigskandeerder stuur gewoonlik ’n afsonderlike druk vir elke karakter.
input. Vuur op die veld nadat ’n drukbare karakter sy waarde verander. Dit is die regte gebeurtenis om dop te hou as jy die teks nodig het soos dit groei. Dit vuur nie vir Enter of Tab nie, omdat daardie sleutels nie ’n karakter in ’n teksinvoer invoeg nie.
change. Vuur nadat die waarde vasgelê word, tipies wanneer die veld fokus verloor. ’n Skandeerder wat fokus in dieselfde veld los, sal nie change aan die einde van die skandering produseer nie. Moenie change as die enigste voltooiingsein gebruik nie.
event.key en event.code. Teken albei aan wanneer ’n karakter verkeerd is. ’n Wanpassing tussen die skandeerderuitleg en die bedryfstelseluitleg verander event.key en laat event.code lyk soos die sleutel wat die skandeerder bedoel het. Syfers van die numeriese sleutelbord gebruik Numpad1 en soortgelyke kodes. Sommige invoermaskers behandel dié anders as Digit1. Verkeerde sleutelborduitleg op die strepieskodeskandeerder verduidelik die uitlegwanpassing.
Fokus. Teken document.activeElement onmiddellik voor ’n skandering aan. As dit nie die strepieskodeveld is nie, verduidelik die res van die spoor die verkeerde kontrole. Iframes het hul eie fokus. ’n Skandering in ’n ingebedde raam is sigbaar vir skrip binne daardie raam.
Tydsberekening. Skandeerders voltooi dikwels ’n kort loonvrag in ruim minder as ’n sekonde. Die invoertoetser vergelyk die gemiddelde gaping tussen karakters met ’n drempel van 100 ms en benoem die resultaat as tydsberekening, nie as ’n hardeware-identifikasie nie. ’n Gapingdrempel kan ’n vinnige tikker, outomatiese invul of die emulator as ’n skandeerder beskou. ’n Skandeerder met ’n tussenskaraktervertraging, ’n Bluetooth-skakel of ’n lang loonvrag kan soos tik lyk. Gebruik die vasgevange waarde en die agtervoegsel. Gebruik tydsberekening as ’n leidraad.
Die Sleutelbordgebeurtenistoetser lys elke keydown en keyup met key, code, wysigers en tydstempels. Gebruik dit wanneer die saamgestelde string ’n voorvoegselsleutel of ’n numpad-kode versteek. Die log is blaaiergebeure. Dit is nie rou USB-verkeer nie.
Algemene probleme in webtoepassings
Die skandering gaan na die verkeerde veld. Wiginvoer volg fokus. Klik die teikenveld ná elke navigasie, dialoog of valideringsboodskap wat fokus skuif. ’n Modaal sonder ’n teksveld kan die skandering as kortpadsleutels insluk.
Die skandeerder werk in ’n teksredigeerder en nie in die blaaier nie. Die toestel tik. Die bladsy aanvaar nie daardie sleutels nie. Kontroleer fokus, ’n gedeaktiveerde of leesalleen-invoer, en ’n keydown-luisteraar wat preventDefault() op drukbare sleutels roep. ’n Luisteraar wat net paste hanteer, sien nooit wiginvoer nie. Begin met Strepieskodeskandeerder werk nie as geen toepassing karakters ontvang nie.
Enter dien die vorm twee keer in of navigeer weg. Die blaaier dien die vorm in, en jou luisteraar hanteer ook Enter. Roep preventDefault() op een van daardie paaie en verwerk die waarde een keer. ’n Meerveldvorm kan indien voordat latere velde gevul is wanneer die skandeerder Enter stuur. Gebruik Tab vir daardie werkvloei, of voorkom die indien totdat die vorm voltooi is.
Tab verander fokus. Dit is die Tab-sleutel. Stel Enter op die skandeerder op, of lees die waarde in keydown en laat die fokusskuif toe. Sien die agtervoegselafdeling hierbo.
Die sleutelborduitleg is verkeerd. Syfers kan ’n wanpassing oorleef wat leestekens verander. Skandeer ’n bekende waarde wat die simbole bevat wat jy stoor, op die uitleg wat die werkstasie werklik gebruik.
Dieselfde skandering skep twee rekords. Soek twee luisteraars op een Enter voordat jy na twee fisiese skanderings soek. Toets dan ’n doelbewuste tweede skandering en bevestig die hoeveelheid- of duplikaatreël wat jou toepassing dokumenteer.
Die waarde ontbreek of is afgekap. ’n maxlength-kenmerk, ’n invoermasker of preventDefault() op karaktersleutels kan die loonvrag laat val of sny. Vergelyk die karaktertelling in die invoertoetser met die waarde in jou veld. ’n Voorvoegsel kan ook ’n korrekte loonvrag te lank laat lyk.
QR-kodes verskyn nooit. Die skandeerder is dalk net 1D, of die QR-simbologie is dalk gedeaktiveer. Die toepassing kan dit nie regstel nie. Bevestig die hardeware met QR-kodetoetsing: hoe om QR-kodeskandeerders te toets, en keer dan terug na die veldtoets.
Kontrolelys vir webtoepassingstoetsing
Gebruik dit op die bou wat jy wil verskeep, in elke blaaier wat jy ondersteun. Kontroleer ’n vars profiel sowel as ’n profiel met uitbreidings vir wagwoordbestuur en outomatiese invul, omdat daardie uitbreidings fokus skuif.
- Die skandeerder is gekoppel of gepaar, en die rekenaar wys dat dit gereed is.
- Die skandeerder is in sleutelbordwigmodus, nie serieel of ’n verkoper-SDK-modus nie.
- Die strepieskodeveld is onmiddellik voor die skandering gefokus.
document.activeElementis daardie veld. - ’n Bekende strepieskode kom karakter vir karakter aan, insluitend lengte.
- ’n ENTER-agtervoegsel dien in of aanvaar die waarde een keer en los nie die afsluiter in die gestoorde string nie.
- ’n TAB-agtervoegsel skuif fokus na die kontrole wat jy bedoel, en die waarde word gelees voor die skuif.
- ’n Opstelling sonder agtervoegsel los die waarde beskikbaar totdat die toepassing dit voltooi.
- ’n Leë indiening word verwerp of geïgnoreer.
- Een skandering skep nie twee rekords nie. ’n Tweede werklike skandering volg die toepassing se duplikaatreël.
- Leestekens, simbole en enige GS1-skeier wat jou formate gebruik, oorleef die rondte.
- Die skandeerder se sleutelborduitleg en die bedryfstelseluitleg produseer die karakters wat op die etiket gedruk is.
- Ná ontkoppel en herkoppel, of nadat die Bluetooth-skakel val, bereik die volgende skandering steeds die veld.
- Verskeie skanderings in ’n ry bly afsonderlike waardes. Die veld heg hulle nie aan mekaar nie.
- Dieselfde kontroles slaag in die blaaiers wat jy ondersteun, met en sonder algemene uitbreidings vir outomatiese invul.
Vir dialoë, tabvolgorde oor ’n hele betaalpunt, en POS-hoeveelheidsvloeie, gaan voort met Hoe om strepieskodeskandeerderinvoer te toets.
Toetsgevalmatriks
Die skandeerderkolom is wat die toestel en die blaaier doen. Die kolom vir verwagte gedrag is wat die toepassing in reaksie moet doen. Besigheidsreëls, soos of ’n herhaalde produkkode hoeveelheid verhoog, behoort aan die toepassing. Stel hulle in die toets in plaas daarvan om een reël vir elke produk te aanvaar.
| Scenario | Verwagte gedrag |
|---|---|
| Geldige strepieskode | Die toepassing aanvaar die waarde en stoor die loonvrag sonder die afsluiter. |
| Leë invoer | Die toepassing verwerp of ignoreer dit en skep nie ’n rekord nie. |
| ENTER-agtervoegsel | Die toepassing dien in of aanvaar die waarde een keer. |
| TAB-agtervoegsel | Fokus skuif na die bedoelde volgende kontrole, en die waarde word gehou. |
| Geen agtervoegsel | Die invoer bly beskikbaar totdat die toepassing dit verwerk. |
| Vinnige opeenvolgende skanderings | Elke waarde word afsonderlik verwerk en word nie aan die vorige een geheg nie. |
| Verkeerde sleutelborduitleg | Onverwagte karakters is sigbaar in die vasgevange waarde en druip validering. |
| Duplikaatskandering | Die toepassing volg sy eie duplikaatreël, soos hoeveelheid verhoog of ’n herhaling verwerp. |
| Ongeldige strepieskodeformaat | Die toepassing wys die valideringsfout vir daardie formaat en stoor nie die waarde nie. |
| Verlore invoerfokus | Die toepassing versin nie ’n strepieskode nie. Die skandering is afwesig of beland in die gefokusde kontrole, en die bladsy bly in ’n veilige toestand. |
Voer die rye vir geldig, leeg, ENTER, TAB en geen agtervoegsel met die fisiese skandeerder uit en weer met die emulator. Voer die rye vir sleutelborduitleg, QR en herkoppel op die hardeware uit. Daardie rye hang van die toestel, die etiket of die bedryfstelseluitleg af, wat gesimuleerde toetsaanslae nie reproduseer nie.