13.0.4 • Published 3 years ago

@ubirch/angularx-qrcode v13.0.4

Weekly downloads
-
License
MIT
Repository
github
Last release
3 years ago

@ubirch/angularx-qrcode

ATTENTION - This package will be removed soon - please use the original package angularx-qrcode again!!

@ubirch/angularx-qrcode is a fast and easy-to-use Ionic 4/5 and Angular 12/13 QR Code component/module library to generate QR Codes (Quick Response) in your Ionic and Angular app with support for AOT and the Ivy compiler and runtime. It is a drop-in replacement for the no-longer-maintained angularx-qrcode package of Andreas Jacob (http://cordobo.com/) which was a replacement for angular2 component ng2-qrcode and based on node-qrcode.

Demo App

An Angular app with a working implementation of angularx-qrcode is available as a project in this repository. Run the command

ng serve demo-app

and open the url http://localhost:4200/ in your browser

For versions prior to 12 use angularx-qrcode github.com/Cordobo/angularx-qrcode.

Install @ubirch/angularx-qrcode with Angular 13

The latest version of @ubirch/angularx-qrcode version works with Angular 13:

# Angular 13 and Ionic
npm install @ubirch/angularx-qrcode --save

Install @ubirch/angularx-qrcode 12.0.x with Angular 12

Angular 12 requires @ubirch/angularx-qrcode version 12.0.0:

# Angular 12 and Ionic
npm install @ubirch/angularx-qrcode@12.0.0 --save

Basic Usage

Import the module and add it to your imports section in your main AppModule:

// File: app.module.ts
// all your imports
import { QRCodeModule } from 'angularx-qrcode';

@NgModule({
declarations: [
  AppComponent
],
imports: [
  QRCodeModule
],
providers: [],
bootstrap: [AppComponent]
})
export class AppModule { }

Examples: How to implement angularx-qrcode

Generate a QR Code from a string (directive only)

Now that Angular/Ionic knows about the new QR Code module, let's invoke it from our template with a directive. If we use a simple text-string, we need no additional code in our controller.

<qrcode [qrdata]="'Your data string'" [width]="256" [errorCorrectionLevel]="'M'"></qrcode>

Create a QR Code from a variable in your controller

In addition to our <qrcode>-directive in example.html, lets add two lines of code to our controller example.ts.

// File: example.ts
export class QRCodeComponent {
  public myAngularxQrCode: string = null;
  constructor () {
    // assign a value
    this.myAngularxQrCode = 'Your QR code data string';
  }
}

// File: example.html
<qrcode [qrdata]="myAngularxQrCode" [width]="256" [errorCorrectionLevel]="'M'"></qrcode>

Parameters

AttributeTypeDefaultDescription
allowEmptyStringBooleanfalseAllow qrdata to be an empty string
colorDarkString'#000000ff'RGBA color, color of dark module
colorLightString'#ffffffff'RGBA color, color of light module
cssClassString'qrcode'CSS Class
elementTypeString'canvas''canvas', 'svg', 'img', 'url' (alias for 'img')
errorCorrectionLevelString'M'QR Correction level ('L', 'M', 'Q', 'H')
marginNumber4Define how much wide the quiet zone should be.
qrdataString''String to encode
scaleNumber4Scale factor. A value of 1 means 1px per modules (black dots).
versionNumber(auto)1-40
widthNumber10Height/Width (any value)

Note

Depending on the amount of data of the qrdata to encode, a minimum width is required.

AOT - Ahead Of Time Compilation

angularx-qrcode supports AOT Compilation (Ahead-of-Time Compilation) which results in significant faster rendering. An AOT-enabled module is included. Further reading: https://angular.io/guide/aot-compiler

Available commands

# Build
npm run build

License

MIT License

Copyright (c) 2021 - present Beate Fiss (UBIRCH.com) Copyright (c) 2018 - present Andreas Jacob (Cordobo.com)

13.0.4

3 years ago

13.0.2

3 years ago

13.0.3

3 years ago

13.0.1

3 years ago

13.0.0

4 years ago

12.0.0

4 years ago