syncfusion-blazor-barcode logo

syncfusion-blazor-barcode

syncfusion blazor barcode

SKILL.md

Full skill instructions

Syncfusion Blazor Barcode Generator

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

ComponentUse For
SfBarcodeGenerator1D linear barcodes (Code39, Code128, Codabar, etc.)
SfQRCodeGeneratorQR codes with optional logo embedding
SfDataMatrixGenerator2D 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

PropertyApplies ToDescription
ValueAllThe data string to encode
WidthAllWidth of the barcode (px or %)
HeightAllHeight of the barcode (px or %)
TypeSfBarcodeGeneratorBarcodeType enum — selects the 1D symbology
ForeColorAllColor of the barcode bars (e.g., "red", "#333")
EnableCheckSumSfBarcodeGeneratorAdds/validates checksum digit (default true for Code39)
ErrorCorrectionLevelSfQRCodeGeneratorQR error recovery: Low, Medium, Quartile, High
OnValidationFailedAllEvent triggered when Value contains invalid characters

Common Use Cases

NeedComponentRead
Product/inventory labelsSfBarcodeGenerator (Code128/Code39)barcode-types.md
URL / contact / 2FA QR codeSfQRCodeGeneratorqr-code-generator.md
Branded QR code with logoSfQRCodeGenerator + QRCodeLogoqr-code-generator.md
Pharmaceutical / shipping labelsSfDataMatrixGeneratordata-matrix-generator.md
Download barcode as image.Export() methodexport-and-customization.md
Embed barcode in email/PDF.ExportAsBase64Image()export-and-customization.md