Aller au contenu principal

Codes-barres

Les codes-barres sont intégrés en ligne dans le texte du paragraphe et rendus dans la sortie PDF ou DOCX. L'API supporte 63 symbologies couvrant les cas d'utilisation du détail, de la logistique, de la santé, du postal, de l'automobile et de l'industrie spécialisée — couvrant les zones silencieuses conformes à l'ISO et la gestion des chiffres de contrôle prêts à l'emploi.

Catalogue en direct​

Chaque symbologie supportée avec un rendu d'exemple. Ouvrez l'onglet Template pour voir le JSON source, ou Essayer dans Playground pour l'éditer en direct. Le même catalogue existe également en tant que tutoriel autonome dans Catalogue de codes-barres.

Syntaxe en ligne​

[barcode, type, payload]
[barcode, type, payload, width|height]
[barcode, type, payload, width|height, slot, slot, ...]

Les trois premiers emplacements sont positionnels. Le reste est discriminé par le contenu et indépendant de l'ordre.

EmplacementDescription
typeNom de la symbologie (p. ex. qrcode, code128, gs1-128, hibc-dm). Insensible à la casse ; les alias courants sont supportés. Voir Symbologies.
payloadLes données à encoder.
width|heightDimensions optionnelles sur la page en points. Revient aux valeurs par défaut par symbologie — voir Options & défauts.
#hexRemplacement optionnel de la couleur de premier plan (p. ex. #1A1A2E).
#fg|#bgPaire optionnelle de premier plan + arrière-plan.
quiet=NRemplacement optionnel de la zone silencieuse en multiples de module.
key=valueBoutons spécifiques au moteur de rendu (porte de secours pour les options avancées).

Démarrage rapide​

QR simple pour un lien de suivi​

{ "p": "Scan to track: [barcode, qrcode, https://track.docpayload.example/DOC-2026-04521, 100|100]" }

Étiquette d'expédition Code 128​

{ "p": "[barcode, code128, DOC-2026-04521, 200|50]" }

GS1-128 avec identifiants d'application entre crochets​

{ "p": "[barcode, gs1-128, [01]04150123456789[17]270630[10]A4521, 220|50]" }

L'analyseur de Shortcode gère les identifiants d'application entre crochets nativement — aucun échappement requis.

QR teinté de marque​

{ "p": "[barcode, qrcode, https://docpayload.example, 80|80, #1A1A2E]" }

Codes-barres dans les cellules du tableau​

{
  "table": {
    "widths": [2, 1, 2],
    "rows": [
      [
        { "p": "[b]Shipment[/b]" },
        { "p": "[b]Service[/b]" },
        { "p": "[b]Tracking[/b]" }
      ],
      [
        { "p": "DOC-CA-2026-04521" },
        { "p": "Express" },
        { "p": "[barcode, code128, DOC-CA-2026-04521, 120|35]" }
      ]
    ]
  }
}

Codes-barres dans les mises en page en colonnes​

{
  "columns": {
    "widths": [2, 1],
    "gap": 20,
    "rows": [
      [
        { "p": "[b]Shipment Details[/b]" },
        { "p": "From: Toronto, ON" },
        { "p": "To: San Francisco, CA" }
      ],
      [
        { "p": "[barcode, qrcode, https://track.docpayload.example/DOC-CA-2026-04521, 100|100]" },
        { "p": "[fontsize, 8]Scan to track[/fontsize]" }
      ]
    ]
  }
}

Codes-barres avec références de données​

Les charges utiles de codes-barres peuvent être remplies à partir des références $data au moment du rendu :

{ "p": "[barcode, qrcode, $data.shipment.trackingUrl, 80|80]" }
{ "p": "[barcode, code128, $data.shipment.trackingId, 180|45]" }

Inférence de forme DataMatrix​

DataMatrix supporte à la fois les variantes carrées et rectangulaires. W==H égal produit un carré ; W!=H inégal produit une variante rectangulaire. Aucun mot-clé explicite nécessaire — les dimensions parlent d'elles-mêmes.

{ "p": "Square: [barcode, datamatrix, X, 80|80] Rectangular: [barcode, datamatrix, X, 100|40]" }

Étapes suivantes​

  • Symbologies — référence complète de tous les 63 types supportés organisés par famille.
  • Options & défauts — tailles par défaut par symbologie, zones silencieuses, remplacements de couleur, gestion des erreurs.