@hoanghiep-pham/ema-react-ui User Manual

Introduction

@hoanghiep-pham/ema-react-ui is a versatile table component designed for React applications. It provides a rich set of features for displaying, sorting, filtering, and editing tabular data.

Installation

To install the package, run:

npm install @hoanghiep-pham/ema-react-ui

Required Stylesheets

Ensure you import the required styles in your project:

import "bootstrap/dist/css/bootstrap.min.css";
import "react-datepicker/dist/react-datepicker.css";
import "@hoanghiep-pham/ema-react-ui/dist/emaui.css";
import "react-toastify/dist/ReactToastify.css";

Additionally, add the ToastContainer component in your App.js:

import { ToastContainer } from "react-toastify";

function App() {
  return (
    <>
      <ToastContainer />
      {/* Other components */}
    </>
  );
}

Usage in React

In your React component, include @hoanghiep-pham/ema-react-ui:

import React from 'react';
import { EmaTable } from '@hoanghiep-pham/ema-react-ui';

const YourComponent = () => {
  const yourData = [
    { id: 1, name: "John Doe", age: 28 },
    { id: 2, name: "Jane Doe", age: 25 },
  ];

  const yourColumns = [
    { header: "ID", accessor: "id" },
    { header: "Name", accessor: "name" },
    { header: "Age", accessor: "age" },
  ];

  return (
    <div>
      <EmaTable tableData={yourData} columns={yourColumns} />
    </div>
  );
};

export default YourComponent;

Configuration

@hoanghiep-pham/ema-react-ui offers various configuration options to customize its behavior and appearance. Some of the key props include:

• tableData: An array of objects representing the table's data.
• columns: An array defining the table structure, including headers and data accessors.
• sortable: Enables sorting functionality.
• filterable: Allows filtering of data.

For a detailed list of props and customization options, refer to the official documentation.

Contributing

Contributions are welcome! If you encounter a bug or have an enhancement in mind, open an issue or submit a pull request on the GitHub repository.

License

This project is licensed under the MIT License.