# RBarcode
`RBarcode` renders strings as barcodes with JsBarcode. Use the [QR code component](./qr-code) for QR codes.
## Interactive example {#交互示例}
Edit the text or change the symbology to see the barcode and validation feedback. The example loads `RBarcode` directly.
::: details View example source
<<< @/examples/RBarcodeDemo.vue
:::
## Usage {#用法}
```tsx
import { RBarcode } from '@/components'
export const renderOrderBarcode = (orderNo: string) => (
console.error('Invalid barcode format', error)}
/>
)
```
| Prop | Default | Description |
| ------------------ | ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `text` | None | Barcode content. Empty or invalid values can fail to render. |
| `format` | `'CODE128'` | Symbology. Overrides `options.format`. |
| `barcodeRender` | `'canvas'` | `canvas` or `svg`. |
| `options` | `{}` | JsBarcode options, for example `displayValue`, `lineColor`, `margin`, and bar width and height. |
| `width` / `height` | `'auto'` | Display dimensions. Numbers are pixels. Set intrinsic bar width and height in `options`. |
| `responsive` | `false` | Observes the container. Use `width="responsive"` or `height="responsive"` for the corresponding dimension to follow its size. |
| `watchText` | `true` | Redraws on text changes. Changes to `format`, `options` (including nested reactive fields), dimensions, or rendering medium also redraw with the same key. |
| `loading` | `false` | Caller-controlled spinner. |
`responsive width="responsive" :height="48"` follows container width and keeps a 48 px height. Give the parent a definite height when using responsive height.
`onSuccess(text, format, options)`, `onError(error)`, and `onFinally()` accept one callback or an array. The success callback receives the original options. Responsive bar dimensions are internal. Rendering errors call `onError` so the caller can notify users or clear an old preview.
Supported formats are `CODE39`, `CODE128` and its `A/B/C` variants, `EAN13/EAN8/EAN5/EAN2`, `UPC`, `ITF14/ITF`, `MSI/MSI10/MSI11/MSI1010/MSI1110`, `pharmacode`, and `codabar`. Validate length and check digits for EAN or UPC. Verify printed barcodes on the intended scanner and at the final dimensions.
[Component implementation](https://github.com/XiaoDaiGua-Ray/ray-template/blob/main/packages/ui/src/RBarcode/src/Barcode.tsx) · [Format and option types](https://github.com/XiaoDaiGua-Ray/ray-template/blob/main/packages/ui/src/RBarcode/src/types.ts)