angularx-qrcode-cil
v1.0.2
Published
Ionic 3/4 and Angular4/5/6/7/8+ QRCode module generator using qrcodejs
Downloads
33
Maintainers
Readme
Modify source files for project development
angularx-qrcode
angularx-qrcode
is an Ionic 3 and Angular4-8 QR Code component/module library to generate QR Codes (Quick Response) in your Ionic and Angular 4/5/6/7/8+ app with support for AOT. It is a drop-in replacement for the no-longer-maintained angular2 component ng2-qrcode
and based on qrcodejs.
Demo App
An Angular app with a working implementation of angularx-qrcode is available on github.com/Cordobo/angularx-qrcode-sample-app.
Install 1.6.4 with Angular 8
# Angular 8 and Ionic
npm install angularx-qrcode-cil --save
When you create a production version with ng build
you might encounter issue #49.
As a temporary workaround set the target
-property in your tsconfig.json from es2015 to es5:
"target": "es5"
Installation 1.6.4
# Angular 5/6/6.1/7/7.1/7.2 and Ionic
npm install angularx-qrcode-cil --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-cil';
@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 QR code data string'" [size]="256" [level]="'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" [size]="256" [level]="'M'"></qrcode>
Parameters
| Attribute | Type | Default | Description | | ------------- |-------------| -----|------------| | allowEmptyString | Boolean | false | Allow empty string | | colorlight | String | '#ffffff' | Light color | | colordark | String | '#000000' | Dark Color | | level | String | 'M' | QR Correction level ('L', 'M', 'Q', 'H') | | qrdata | String | '' | String to encode | | size | Number | 256 | Height/Width (any value) | | usesvg | Boolean | false | SVG Output |
Note
Depending on the amount of data of the qrdata to encode, a minimum size 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
SSR - Server Side Rendering
As of version 1.6.0, SSR support is fully implemented, the following workaround is no longer needed. HowTo use Angular QRCode with SSR
Available commands
# Build
npm run build
# Watch
npm run watch
Credits
Based on no-longer-maintained angular2 component https://github.com/PragmaticClub/ng2-qrcode
Contribution
- Please open your PR against the development branch.
- Make sure your editor uses the packages .editorconfig file to minimioze commited code changes.
- Use
npm run lint
before you commit
License
MIT License
Copyright (c) 2018 - present Andreas Jacob (Cordobo.com)