Skip to content

sinashahoveisi/react-drilld

Repository files navigation

react-drilld

The best DrillDown for folder or graph or tree structure package for react

GitHub branch checks state GitHub issues GitHub npm Website GitHub language count GitHub top language GitHub code size in bytes

What is this?

This package is a React component that can display graphic, tree or folder structures as a drill-down technique. You can call the data simply or using the api and display it to the users. Users can now easily analyze unstructured data that is difficult to understand and select their items in an analyzed and comprehensible way.


Table of Contents


Installation

You can install this package in two ways simultaneously

install with npm

npm install react-drilld

install with yarn

yarn add react-drilld

Usage

import {DrillD} from 'react-drilld';

or

import DrillD from 'react-drilld';

Examples

Simple

simple example for show simple folder structure data

simple

import React, { Component } from 'react';
import {DrillD} from 'react-drilld';

function App() {
  return (
    <div className="App">
      <DrillD
        title="Choose Folder or File"
        folders={[
          {
            name: 'Folder A',
            children: [{name: 'File A1'}, {name: 'File A2'}, {name: 'Folder AA', children: [{name: 'File AA1'}]}]
          },
          {
            name: 'File 1'
          },
          {
            name: 'Folder B',
            children: [{name: 'File B1'}, {name: 'File A2'}, {name: 'Folder BB', children: [{name: 'File BB1'}]}]
          },
        ]}
      />
    </div>
  );
}

Advance

advance example for show folder structure data with fetch from url

advance

import React, { Component } from 'react';
import {DrillD} from 'react-drilld';

function App() {
  return (
    <DrillD
      title="Choose Category"
      url="https://api.stlouisfed.org/fred/category/children"
      mode="multiple"
      showFullPath
      isSelectableFolder
      queryParams={{api_key: 'f8d2c84d4b22cefd6a6e1d5e78128c61', file_type: 'json'}}
      selectFolderQueryParams={(folder: any) => ({category_id: folder?.id})}
      fetchedChildrenDataPath={['categories']}
      folderKey
    />
  );
}

Demo

A demo is worth a thousand words


Documentation

Check the documentation to get you started!


Creator

Sina Shah Oveisi @sinashahoveisi

I love programming and I am interested in popular frameworks or programming languages and I am currently coding with JavaScript and React framework.


License

MIT © Sina Shahoveisi