1.0.6 • Published 3 months ago

exportdatafile v1.0.6

Weekly downloads
-
License
ISC
Repository
github
Last release
3 months ago

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.

PropertiTipeDeskripsi
typeStringTipe data ekspor, menentukan format file yang akan diekspor. Nilai contoh: "TXT", "PDF", "EXCEL", "ALL" (untuk mengekspor semua file data).
dateObjectObjek dengan properti start_date dan end_date yang menentukan rentang tanggal untuk ekspor data. Format: "DD-MM-YYYY".
dataArrayData 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.
columnsArrayKolom-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).
groupingArrayArray yang menentukan pengaturan pengelompokan untuk data yang diekspor. contoh [no_faktur]
excelSettingObjectPengaturan khusus untuk ekspor Excel, termasuk titleExcel, bgColor, txtColor, dan grandTotalSetting dengan colSpan.
txtSettingObjectPengaturan khusus untuk ekspor TXT, termasuk dataTxt, titleTxt, dan templateTxt yang berisi template untuk file TXT dengan placeholder.
pdfSettingObjectPengaturan khusus untuk ekspor PDF, termasuk titlePdf, orientation, unit, bgColor, txtColor, theme, grandTotalSetting dengan colSpan, dan openNewTab untuk membuka PDF di tab baru (boolean).
openNewTabBooleanJika true, membuka file PDF yang diekspor di tab baru.
1.0.6

3 months ago

1.0.5

3 months ago

1.0.4

3 months ago

1.0.3

3 months ago

1.0.2

3 months ago

0.0.2

3 months ago

0.0.1

3 months ago