1 Star 0 Fork 0

李晓庆 / zs-vue-zxing

加入 Gitee
与超过 1200万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
克隆/下载
贡献代码
同步代码
取消
提示: 由于 Git 不支持空文件夾,创建文件夹后会生成空的 .keep 文件
Loading...
README
MIT

ht-vue-zxing

本包是基于下面vue-zxing的修改,原包地址:https://github.com/WAGFS/vue-zxing

vue-zxing

基于zxing-js/library插件封装的vue组件,组件可以扫描解析二维码、条形码。

注意:

  • 请尽可能的在https域名下调用组件,在http域名下只能是localhost或者是127.0.0.1,其他域名会导致相机唤醒失败。
  • 请在可调取摄像头的设备上使用组件。
  • 通过浏览器调用的摄像头清晰度可能并没有您想象的那么高,您可能需要将设备离要扫描的二维码或条形码足够近相机才能正确对焦并识别。
  • 您可以使用具有摄像头的设备通过访问 https://wagfs.github.io/Barcode-Dom/这个地址来查看示例(该示例暂无选择图片识别功能) 。

zxing-js/library 's wrapper for Vue.js

Installtion

npm

npm i vue-zxing

Basic Example

<template>
  <div>
    <v-zxing :success="success"></v-zxing>
  </div>
</template>

<script>
import Vue from 'vue'
import VueZxing from 'vue-zxing';

Vue.use(VueZxing);

export default {
  name: 'VueBarcodeTest',
  methods: {
    success(codeText){
    console.log(codeText)
    }
  }
}
</script>

Usage

Props

tipText:Number

默认文字为“对准条码扫描”

parseType:String

parseType决定使用相机模式📷还是静态文件📕模式,相机模式会调起手机后置摄像头,对准二维码或条形码即可解析,静态文件模式则是让用户手动选择需要解析的图片(一般来说这种模式准确率更高一点),默认为相机模式。

parseType:'Camera' | 'Image'

inputId:String

如果选择使用静态文件📕模式,那么可以传入一个input的id,这个input类型需要是file类型,如果不传入id则采用组件默认的input。

showDefaultInput:Boolean

如果不想要默认的input框展示可以传入showDefaultInput,然后通过组件下的parseStaticImg方法传入图片路径来获取解析后的值。

showScanBox:Boolean

在相机📷模式下,默认会展示一个扫描框(条形码),和提示文字,如果不需要的话,可以传入showScanBox:false

showToggleBtn:Boolean

是否展示切换镜头图标,用于切换前置摄像头和后置摄像头。

videoWidth:Number

设置相机的宽度,默认为100vw。

videoHeight:Number

设置相机高度,默认为100vh。

scanBoxWidth:Number

设置扫描框宽度,默认为70%。

scanBoxWidth:Number

设置扫描框高度,默认为20%。

success:Function(codeText)

解析成功后的回调,codeText为解析后的结果字符,默认会当作success回调的第一个参数传递进去,并使用alert将成功结果弹出。

fail:Function(error)

解析失败后的回调,error为解析失败后的错误对象,默认会当作fail回调的第一个参数传递进去,并使用alert将失败原因弹出。

getVideoFail:Function(error)

调取用户摄像头失败后的回调,error为解析失败后的错误对象,默认会当作getVideoFail回调的第一个参数传递进去,并使用alert将失败原因弹出。

slot

#default

组件内设有默认插槽,当模式为相机📷模式时,默认会有一个扫描框和提示文字,可查看 上文showScanBox属性。

#other

用户可以通过使用other插槽来添加自己想要的一些ui。

#header

头部工具栏,默认具有切换镜头工具和刷新工具(有些机型切换到后台再返回页面视频流会卡住)。切换镜头可调用组件下的decodeOnceFromConstraintsFunc方法,必须传入一个参数指定切换前置({ video: { facingMode: "user" } })还是后置({ video: { facingMode: { exact: "environment" } } })。刷新视频也可调用该方法。

MIT License Copyright (c) 2021 WAGFS Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

简介

基于vue-zxing的修改版本: 20220731: 增加tipText属性, 可以设置扫码框下的默认文字 展开 收起
JavaScript 等 2 种语言
MIT
取消

发行版

暂无发行版

贡献者

全部

近期动态

加载更多
不能加载更多了
1
https://gitee.com/huantime/zs-vue-zxing.git
git@gitee.com:huantime/zs-vue-zxing.git
huantime
zs-vue-zxing
zs-vue-zxing
master

搜索帮助