syncfusion-blazor-barcode

SKILL.md

Syncfusion Blazor Barcode Generator

Syncfusion's Blazor Barcode Generator package (Syncfusion.Blazor.BarcodeGenerator) provides three components for generating barcodes in Blazor applications:

Component Use For
SfBarcodeGenerator 1D linear barcodes (Code39, Code128, Codabar, etc.)
SfQRCodeGenerator QR codes with optional logo embedding
SfDataMatrixGenerator 2D Data Matrix codes for compact encoding

All three work in Blazor Server, Blazor WebAssembly, and Blazor Web App (.NET 8+).


When to Use This Skill

  • User needs to render or display a barcode in a Blazor component
  • User asks about QR code generation (e.g., product links, 2FA, contact cards)
  • User needs Data Matrix codes (pharmaceutical, logistics, label printing)
  • User is configuring SfBarcodeGenerator, SfQRCodeGenerator, or SfDataMatrixGenerator
  • User asks about exporting a barcode as an image (JPG/PNG) or Base64
  • User asks about barcode types, error correction, checksums, or validation events
  • User is embedding a logo in a QR code

Navigation Guide

Setting Up the Project

πŸ“„ Read: references/getting-started.md

  • NuGet package installation
  • _Imports.razor namespace configuration
  • Service registration in Program.cs
  • Stylesheet and script references
  • Setup for Blazor Server, WebAssembly, and Web App
  • Adding the first barcode component to a page

1D Barcode Types and Configuration

πŸ“„ Read: references/barcode-types.md

  • All supported BarcodeType enum values with descriptions
  • Code39, Code39 Extended, Code11, Code32, Code93, Codabar, Code128
  • Choosing the right type for your use case
  • EnableCheckSum configuration
  • OnValidationFailed event handling

QR Code Generator

πŸ“„ Read: references/qr-code-generator.md

  • Basic QR code usage
  • Error correction levels (L, M, Q, H)
  • Embedding a logo image in the QR code center
  • Customizing logo size
  • Color, dimension, and display text customization
  • OnValidationFailed event

Data Matrix Generator

πŸ“„ Read: references/data-matrix-generator.md

  • Basic Data Matrix code usage
  • Color, dimension, and display text customization
  • Common use cases (pharmaceuticals, labels)
  • OnValidationFailed event

Exporting and Customizing Barcodes

πŸ“„ Read: references/export-and-customization.md

  • Export barcode to image file (JPG/PNG)
  • Export as Base64 string
  • ForeColor for custom barcode color
  • Width / Height for sizing
  • BarcodeGeneratorDisplayText for label text
  • Applies to all three generator types

Quick Start Examples

1D Barcode

@using Syncfusion.Blazor.BarcodeGenerator

<SfBarcodeGenerator Width="200px" Height="150px"
                    Type="@BarcodeType.Code128"
                    Value="SYNCFUSION">
</SfBarcodeGenerator>

QR Code

@using Syncfusion.Blazor.BarcodeGenerator

<SfQRCodeGenerator Width="200px" Height="200px"
                   Value="https://www.syncfusion.com">
</SfQRCodeGenerator>

Data Matrix

@using Syncfusion.Blazor.BarcodeGenerator

<SfDataMatrixGenerator Width="200" Height="150"
                       Value="SYNCFUSION">
</SfDataMatrixGenerator>

Key Properties

Property Applies To Description
Value All The data string to encode
Width All Width of the barcode (px or %)
Height All Height of the barcode (px or %)
Type SfBarcodeGenerator BarcodeType enum β€” selects the 1D symbology
ForeColor All Color of the barcode bars (e.g., "red", "#333")
EnableCheckSum SfBarcodeGenerator Adds/validates checksum digit (default true for Code39)
ErrorCorrectionLevel SfQRCodeGenerator QR error recovery: Low, Medium, Quartile, High
OnValidationFailed All Event triggered when Value contains invalid characters

Common Use Cases

Need Component Read
Product/inventory labels SfBarcodeGenerator (Code128/Code39) barcode-types.md
URL / contact / 2FA QR code SfQRCodeGenerator qr-code-generator.md
Branded QR code with logo SfQRCodeGenerator + QRCodeLogo qr-code-generator.md
Pharmaceutical / shipping labels SfDataMatrixGenerator data-matrix-generator.md
Download barcode as image .Export() method export-and-customization.md
Embed barcode in email/PDF .ExportAsBase64Image() export-and-customization.md
Weekly Installs
4
First Seen
1 day ago
Installed on
opencode4
deepagents4
antigravity4
github-copilot4
codex4
warp4