https://github.com/defuj/printer-js
Printer Bluetooth Plugin Javascript
https://github.com/defuj/printer-js
bluetooth html javascript printer-thermal
Last synced: 2 days ago
JSON representation
Printer Bluetooth Plugin Javascript
- Host: GitHub
- URL: https://github.com/defuj/printer-js
- Owner: defuj
- Created: 2024-10-23T04:36:29.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-10-23T08:31:39.000Z (over 1 year ago)
- Last Synced: 2025-10-05T08:58:03.358Z (4 months ago)
- Topics: bluetooth, html, javascript, printer-thermal
- Language: HTML
- Homepage: https://defuj.github.io/printer-js/
- Size: 30.3 KB
- Stars: 6
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: readme.md
Awesome Lists containing this project
README
# PrintPlugin
[](https://badge.fury.io/js/bluetooth-print-js)
[](https://opensource.org/licenses/MIT)
PrintPlugin adalah plugin JavaScript untuk mencetak teks menggunakan printer thermal Bluetooth. Plugin ini mendukung dua ukuran kertas: "58mm" dan "80mm".
## Fitur
1. Mencetak teks dengan berbagai opsi seperti huruf tebal, garis bawah, perataan, dan ukuran teks.
2. Mencetak teks dengan dua kolom.
3. Mencetak garis putus-putus.
4. Mencetak baris baru.
5. Mendukung dua ukuran kertas: "58mm" dan "80mm".
6. Mendukung koneksi ke printer thermal Bluetooth.
7. Mendukung browser modern seperti Chrome, Firefox, dan Edge.
8. Mendukung Node.js.
9. Mendukung penggunaan CDN.
10. Mendukung penggunaan NPM.
11. Mendukung penggunaan ES6.
## Instalasi
### Menggunakan NPM
```bash
npm install bluetooth-print-js
```
import atau require PrintPlugin ke dalam proyek Anda.
```javascript
import PrintPlugin from "bluetooth-print-js";
```
or
```javascript
const PrintPlugin = require("bluetooth-print-js");
```
### Menggunakan CDN
```html
```
## Penggunaan
### Membuat Instance dari PrintPlugin
Anda dapat membuat instance dari PrintPlugin dengan atau tanpa menentukan ukuran kertas yang diinginkan. Ukuran kertas yang didukung adalah "58mm" dan "80mm". Jika ukuran kertas tidak ditentukan, ukuran kertas default adalah "58mm".
```javascript
// Create instance with paper size "80mm"
let printer = new PrintPlugin("80mm");
```
or
```javascript
// Create instance with default paper size "58mm"
let printer = new PrintPlugin();
```
### Menghubungkan ke Printer dan Mencetak Teks
Gunakan metode `connectToPrint` untuk menghubungkan ke printer Bluetooth dan mencetak teks. Anda perlu menyediakan dua fungsi callback: `onReady` dan `onFailed`.
- `onReady`: Dipanggil ketika koneksi ke printer berhasil. Anda dapat menggunakan objek print yang diteruskan ke callback ini untuk mencetak teks.
- `onFailed`: Dipanggil ketika koneksi ke printer gagal. Anda dapat menggunakan parameter message untuk mendapatkan pesan error.
### Cara Menggunakan PrintPlugin
1. Hubungkan ke printer dan cetak teks.
```javascript
printer.connectToPrint({
onReady: async (print) => {
await print.writeText("Hello, World!");
},
onFailed: (message) => {
console.log(message);
},
});
```
2. Contoh penggunaan lengkap (HTML):
```html
Bluetooth Print
Bluetooth Print
Connect and Print
document.getElementById("connect").addEventListener("click", () => {
let printer = new PrintPlugin("80mm");
printer.connectToPrint({
onReady: async (print) => {
// Print Header
await print.writeText("SADIGIT", {
align: "center",
bold: true,
size: "double",
});
await print.writeText(
"Jl. Kutamaya No.Ruko A, Kotakulon, Kec. Sumedang Sel., Kabupaten Sumedang, Jawa Barat 45311",
{ align: "center" }
);
await print.writeText("0852-2299-9699", { align: "center" });
await print.writeLineBreak();
await print.writeText("No.Transaksi: SDGT-ONL-0001", {
align: "center",
});
await print.writeText("Kasir: Otongsuke", { align: "center" });
await print.writeText("2024-10-23 10:20:18", { align: "center" });
// Print Items
await print.writeDashLine();
for (let i = 0; i < 5; i++) {
await print.writeText("Item Sample-" + i, { align: "left" });
await print.writeTextWith2Column("1 pcs x 10.000", "10.000");
}
await print.writeDashLine();
// Print Total
await print.writeTextWith2Column("Total :", "50.000");
await print.writeTextWith2Column("Bayar :", "100.000");
await print.writeTextWith2Column("Kembali :", "50.000");
await print.writeTextWith2Column("Metode :", "Tunai");
// Print Footer
await print.writeLineBreak();
await print.writeText(
"Terimakasih sudah mencoba Follow IG @sadigit.id",
{ align: "center" }
);
await print.writeLineBreak(3);
},
onFailed: (message) => {
console.log(message);
},
});
});
```
### Metode yang Tersedia
- `writeLineBreak({ count = 1 })`: Menulis baris baru.
- `writeDashLine()`: Menulis garis putus-putus.
- `writeTextWith2Column(text1, text2, options)`: Menulis teks dengan dua kolom.
- `writeText(text, options)`: Menulis teks.
- `connectToPrint({ onReady, onFailed })`: Menghubungkan ke printer dan memanggil callback onReady atau onFailed.
### Opsi untuk Metode `writeText` dan `writeTextWith2Column`
- `bold`: Menentukan apakah teks dicetak dengan huruf tebal. (default: false)
- `underline`: Menentukan apakah teks dicetak dengan garis bawah. (default: false)
- `align`: Menentukan perataan teks. Nilai yang didukung: "left", "center", "right". (default: "left")
- `size`: Menentukan ukuran teks. Nilai yang didukung: "normal", "double". (default: "normal")