exportdatafile
TypeScript icon, indicating that this package has built-in type declarations

1.0.6 • Public • Published

Modul ExportDataFile Modul ini memfasilitasi ekspor data ke format Excel PDF dan TXT. Ini mencakup fungsi, ExportDataFile, yang dapat dikonfigurasi untuk menghasilkan laporan berdasarkan data dan konfigurasi kolom yang diberikan. Berikut adalah panduan rinci tentang cara menggunakan modul ini.

Instalasi Untuk menggunakan modul ExportDataFile, Anda perlu menginstalnya di proyek Anda. Anda dapat melakukannya menggunakan npm:

Example Demo

Install

npm install exportdatafile

Fitur

  • Download File .xlsx .txt .pdf format
  • Tidak ada kode sisi server
  • Mudah digunakan
import { ColumnGenarator, ExportDataFile } from "exportdatafile";

const DemoPage = () => {
  interface FakturHutang {
    no_faktur_hutang: string;
    tgl_system: string;
    harga: number;
    berat: number;
    total: number;
    diskon: string;
    input_by: string;
  }
  const data: FakturHutang[] = [
    {
      no_faktur_hutang: "001",
      diskon: "rp",
      tgl_system: "2022-01-01",
      harga: 10000,
      berat: 2,
      total: 20000,
      input_by: "Samsul"
    },
    {
      no_faktur_hutang: "002",
      diskon: "rp",
      tgl_system: "2022-01-01",
      harga: 10000,
      berat: 2,
      total: 20000,
      input_by: "Samsul"
    }
  ];

  const columns: ColumnGenarator<FakturHutang>[] = [
    {
      label: "Tanngal",
      key: "tgl_system"
    },

    {
      label: "Diskon",
      key: "diskon",
      options: {
        halign: "center"
      }
    },
    {
      label: "Harga",
      key: "harga",
      options: {
        format: "RP"
      }
    },
    {
      label: "Berat",
      key: "berat",
      options: {
        format: "GR"
      }
    },

    {
      label: "Total",
      key: "total",
      options: {
        format: "RP"
      }
    }
  ];
  return (
    <div>
      <button
        onClick={() =>
          ExportDataFile({
            type: "TXT",
            date: {
              start_date: "11-01-2024",
              end_date: "11-01-2024"
            },
            data: data,
            columns: columns,
            grouping: [],
            excelSetting: {
              titleExcel: "Example Export Data Excel",
              bgColor: "000000",
              txtColor: "ffffff",
              grandTotalSetting: {
                colSpan: 2
              }
            },
            txtSetting: {
              dataTxt: data,
              titleTxt: "Example Export Data Txt",
              templateTxt: `--------------- SLIP ---------------\nFaktur         = {no_faktur_hutang}\nDiskon         = {diskon}\nTanggal System = {tgl_system}\nHarga          = {harga}\nBerat          = {berat}\nTotal          = {total}\nInput_by       = {input_by}`
            },
            pdfSetting: {
              titlePdf: "Example Export Data Pdf",
              orientation: "l",
              unit: "mm",
              bgColor: "000000",
              txtColor: "ffffff",
              theme: "grid",
              grandTotalSetting: {
                colSpan: 2
              },
              openNewTab: true
            }
          })
        }
      >
        Export Laporan
      </button>
    </div>
  );
};

export default DemoPage;

Option Daftar properti yang tersedia dapat ditemukan di bawah. Ini harus diteruskan ke komponen ExportDataFile.

Properti Tipe Deskripsi
type String Tipe data ekspor, menentukan format file yang akan diekspor. Nilai contoh: "TXT", "PDF", "EXCEL", "ALL" (untuk mengekspor semua file data).
date Object Objek dengan properti start_date dan end_date yang menentukan rentang tanggal untuk ekspor data. Format: "DD-MM-YYYY".
data Array Data yang akan diekspor. Jika ingin menggunakan pengelompokan (grouping), berikan detail dalam penggunaannya di dalam array. Setiap elemen array mewakili kolom atau properti berdasarkan mana data akan dikelompokkan.
columns Array Kolom-kolom data yang akan diekspor. Setiap elemen array merupakan objek dengan properti berikut:
- key: Kunci yang merujuk pada properti data yang akan ditampilkan dalam kolom.
- label (opsional): Label atau nama yang akan ditampilkan di header kolom.
- options (opsional): Objek yang berisi pengaturan tambahan untuk kolom, seperti:
- format (opsional): Tipe format untuk data dalam kolom (misalnya, tipe tanggal atau angka).
- halign (opsional): Penyelarasan horizontal untuk data dalam kolom.
- disabledColumn (opsional): Jika true, kolom akan dinonaktifkan dalam data yang diekspor.
- disabledFooter (opsional): Jika true, kolom akan dinonaktifkan dalam bagian footer (grand total).
grouping Array Array yang menentukan pengaturan pengelompokan untuk data yang diekspor. contoh [no_faktur]
excelSetting Object Pengaturan khusus untuk ekspor Excel, termasuk titleExcel, bgColor, txtColor, dan grandTotalSetting dengan colSpan.
txtSetting Object Pengaturan khusus untuk ekspor TXT, termasuk dataTxt, titleTxt, dan templateTxt yang berisi template untuk file TXT dengan placeholder.
pdfSetting Object Pengaturan khusus untuk ekspor PDF, termasuk titlePdf, orientation, unit, bgColor, txtColor, theme, grandTotalSetting dengan colSpan, dan openNewTab untuk membuka PDF di tab baru (boolean).
openNewTab Boolean Jika true, membuka file PDF yang diekspor di tab baru.

Package Sidebar

Install

npm i exportdatafile

Weekly Downloads

6

Version

1.0.6

License

ISC

Unpacked Size

132 kB

Total Files

8

Last publish

Collaborators

  • samsularifin05