npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

vodo-react-components-test

v1.2.0

Published

React reusable components for VODO frontend developers

Downloads

18

Readme

VODO-REACT-COMPONENTS NPM Package

Npm package created to supply reusable components to VODO developers.

How to use it ?

Before installing package, you should have tailwindCSS installed and configured in your project as the package styling is built using tailwindCSS.

You should also include the index.css file of the package in the top of your app ( eg. in the top of App.tsx - your main file that contains the whole application - ) as following :

import React from "react";

// The following import must be included to apply styles used
// in the package
import "../node_modules/vodo-react-components/dist/index.css";

// This is an example for importing some components from package
import { Submit, UserNav } from "vodo-react-components";

function App() {
  return (
    <div className="container">
      <UserNav
        name="Zain Ali"
        avatarUrl="https://i.pravatar.cc/150?img=3"
        className="p-1.5 rounded-full shadow-[#EB3D34_7px_-3px]"
        avatarClass=" w-8 h-8"
        email="[email protected]"
      />
    </div>
  );
}

Table of components

🛠 Components included in the package :

1- UserNav

The userNav takes 5 props:

  • name : username
  • avatarUrl : url of avatar
  • className : TailwindCSS styles you want to add to the whole component.
  • avatarClass : TailwindCSS classes you want to apply to avatar
  • email : user's email
<UserNav
  name="Zain Ali"
  avatarUrl="https://i.pravatar.cc/150?img=3"
  className="p-1.5 rounded-full shadow-[#EB3D34_7px_-3px]"
  avatarClass=" w-8 h-8"
  email="[email protected]"
/>

This usernav acts as a like-popup card that appears when you press on a container with the username and the avatar. The card that appears contains : section containing username,avatar and user's email and two buttons which are edit account and logout.

App Screenshot

//=================================================

Go back to the table of components

//=================================================

2- Button

The Button takes 5 props :

  • Variant : each variant apply styles. Downwards you will find different varaints values with corresponding styles.
  • classname ?: TailwindCSS classes to apply
  • size ?: each size has corresponding style will be illustrated downwards.
  • props ?: additional button props (eg. onClick, onBlur, ...)
  • ref ?: to add refrence to the button
    <Button variant="destructive">destructive</Button>
    <Button variant="secondary">secondary</Button>
    <Button variant="ghost">ghost</Button>
    <Button variant="outline">outline</Button>
    <Button variant="link">link</Button>

Diffrent variants and sizes available :

    variant: {
        destructive:
          "bg-destructive text-destructive-foreground shadow-sm hover:bg-destructive/90 focus:bg-[#C4332B] active:bg-[#C4332B] active:shadow-custom",
        outline:
          "border border-destructive text-destructive bg-background shadow-sm hover:bg-destructive/[0.05] hover:text-destructive focus:bg-destructive/[0.05] active:bg-destructive/[0.15] active:shadow-custom",
        secondary:
          "bg-secondary text-secondary-foreground shadow-sm hover:bg-secondary/80",
        ghost: "hover:bg-accent hover:text-accent-foreground",
        link: "text-muted-foreground/50 underline-offset-4 hover:underline hover:text-primary",
      },
      size: {
        default: "h-10 px-4 py-2",
        sm: "h-9 rounded-md px-3",
        lg: "h-11 rounded-md px-8",
        icon: "h-10 w-10",
      },

**** HINT : The primary button is depricated

App Screenshot

//=================================================

Go back to the table of components

//=================================================

3- CardWrapper

The CardWrapper takes 4 props :

  • cardTitle : Title appears on the top of the card
  • classname ?: TailwindCSS classes to apply
  • showFooter ?: boolean value to show footer if true
  • footerHref ?: Link appears in the footer ( The footer has a - view all - word which refs to a link )
<CardWrapper
  className="w-[500px]"
  showFooter
  footerHref="#"
  cardTitle="Add business"
>
  Card Content
</CardWrapper>

App Screenshot

//=================================================

Go back to the table of components

//=================================================

4- businessCard

The businessCard takes 4 props :

  • title
  • description
  • imageUrl
  • addHref : link added to the - add - keyword
<BusinessCard
  addHref="#"
  imageUrl={businessCard}
  title="Business name"
  description="Quia fugiat magnam sed ut eum voluptas cumque."
/>

App Screenshot

CardWrapper containing business cards :

App Screenshot

//=================================================

Go back to the table of components

//=================================================

5- Switcher

A drop list with a search bar.

The Switcher takes 5 props :

  • placeHolder : The value appears initially in the droplist section
  • className?
  • items : items appear in the drop list
  • targetKey ?: If the items array is an array of string, you don't have to send this prop. But if you sent an array of objects, you have to specify the key which contains the options to appear in the selector. for example you have an array of objects like this ({ id:1 , nationality : "Egyptian " }, ...) and you want to show nationalities in the switcher so you have to specify the targetKey as "nationality".
  • heading : the title of the options in the drop list (eg. sizes)
  • setSelectedOption : will return the selected item from the array weather it is object or string
  • currentValue ?: It is the current selected value if You want the switcher to initially have a specific value
const [item, setItem] = (useState < null) | (string > null);
<Switcher
  items={["Large", "Medium", "Small"]}
  heading="Sizes"
  setSelectedOption={(item: null | string) => setItem(item)}
  placeHolder="Select your size"
/>;

App Screenshot

//=================================================

Go back to the table of components

//=================================================

7- InputFile

Used to upload file to a specific URL ( images ony allowed !! ).

The InputFile takes 3 props :

  • className?
  • setState : setState for the to get the file value
  • disabled ?: boolean value to indicate of the input is disabled or not
  • name ?: name field of input
<InputFile setState={setState} />

App Screenshot

//=================================================

Go back to the table of components

//=================================================

8- SideBar

The SideBar takes 3 props :

  • modules ?: modules array of objects, each object takes 3 keys :
    • title
    • svg ?: icon
    • link : link to which page navigates when user clicks on the module
  • subModules ?: subModules array of objects, each object takes 3 keys :
    • title
    • svg ?: icon
    • submoduleArr : an array of sub modules appears as a drop list when you click on the main subModule. This array is an array of objects,each object has the same keys as the modules array ( title , svg? , link)
  • sideBarStyle ?: style of the whole sidebar
  • className : object that has two keys:
    • subModule : style applied to each element in the submodules list
    • module : styles applies to each element in the modules list

**** HINT : Styles here refers to TailwindCSS classes ( same as the remaining components )

<SideBar
  modules={modules}
  subModules={subModules}
  className={{
    subModule: "bg-green-300 px-2 py-1",
    module: "bg-red-300 px-2 py-1",
  }}
/>

App Screenshot

//=================================================

Go back to the table of components

//=================================================

9- UserInput

The UserInput takes same props as default input field with extra props :

  • label ?
  • labelStyle?: for styling label
  • success ?: success message if validation is OK
  • error ?: error message if there is a problem with validation
  • onChangeFn ?: useState function to get change in value
<UserInput label="Username" type={"text"} placeholder="type your username" />
<UserInput disabled label="Password" type={"password"} />

App Screenshot

//=================================================

Go back to the table of components

//=================================================

10- Status

Button contains on/off status

The Status takes one prop ( status ) which takes only two value : on - off

<Status status={"on"} />
<Status status={"off"} />

App Screenshot

//=================================================

Go back to the table of components

//=================================================

11- NavigationTrail

The NavigationTrail takes 2 props :

  • trailPage : The current page with the different color which will be the last element in the trial
  • trailLink : These are the remaining previous elements in the trial. It is an array of objects, each object contains two properties ( label : the name of elements & href : the link to which the label refers )
<NavigationTrail
  trailLink={[
    { label: "Home", href: "/" },
    { label: "Products", href: "/" },
  ]}
  trailPage="Products Details"
/>

App Screenshot

//=================================================

Go back to the table of components

//=================================================

12- UserProfile

The UserProfile takes 4 props :

  • name
  • email
  • avatarUrl : img url
  • className ?: addition TailwindCSS classes to apply
<UserProfile
  className=" rounded-b-[32px]"
  name="Zain Ali"
  email="[email protected]"
  avatarUrl={avatar}
/>

App Screenshot

//=================================================

Go back to the table of components

//=================================================

13- SearchInput

The SearchInput takes 4 props :

  • setInputValue : setState function to get the value of the input field
  • disabled ?
  • props ?: default input props
  • className ?: addition TailwindCSS classes to apply
<SearchInput setInputValue={setInputValue} disabled />
<SearchInput setInputValue={setInputValue}/>

App Screenshot

//=================================================

Go back to the table of components

//=================================================

14- TextArea

The TextArea takes 4 props :

  • label
  • disabled?: boolean;
  • placeHolder?
  • className?: TailwindCSS classes;
  • error?: error message to show;
  • success?: success message to show;
  • onChange?
  • onBlur?
  • onFocus?
<TextArea
    label="Tell us your opinion"
    placeHolder="Type something here"
/>
<TextArea
    label="Tell us your opinion"
    placeHolder="Type something here"
    disabled
/>

App Screenshot

//=================================================

Go back to the table of components

//=================================================

16- Table

The Table takes 2 props:

  • TabelHead : Array of objects that represent headers, each object has two keys (accessorKey : is the key used in the tabelData array's objects to specify the value at a specific column & header : is the header that appears in the UI )
  • TabelData : data added to table which is an array of objects, each object has keys ( which representthe accessorKey of the corresponding header ) and values
  • tableStyling ?: optional object for styling that takes 4 keys :
    • headStyle ?: style for the whole header
    • headElementStyle ?: style for all elements in the header
    • bodyStyle ?: style for each row in the body ( it doesn't work )
    • bodyElementStyle ?: style for all elements in body
    • bodyRowStyle?: style of rows in body , it has two keys :
      • general? : for the wrapper of the body element
      • text? : for the text appears in body element
    • outerStyle?: The outer div that wraps the table element;

This is how the table component is used :

<MainTabel
  TabelHead={TabelHead}
  TabelData={TabelData}
  tableStyling={tableStyling}
/>
How to set the headers ?

To set headers you need to pass an array of objects to the columns prop, each object consists of 3 keys : id of the column - acessorKey ( Which is used for passing data in the data array ) - header ( The column's header that will appear in the table ).

export const columns: ColumnDef<Column>[] = [
  const tableHead: tableHeaderType[] = [
  {
    accessorKey: "id",
    header: "ID",
  },
  {
    accessorKey: "image",
    header: "Image",
  },
  {
    accessorKey: "sku",
    header: "SKU",
  },
  {
    accessorKey: "name",
    header: "Name",
  },
  .... remaining of headers
];
How to set table's data ?

To set headers you need to pass an array of objects to the data prop, each object consists of keys, each key is the accessorKey of the header which is defined in the objects of the columns' array.

export const tableData: Column[] = [
  {
    id: 'id',
    imageUrl: 'image',
    sku: 'sku',
    name: 'name',
    category: 'category',
    priceCost: 100,
    price: 100,
    kind: 'kind',
    virtual: 'virtual',
    status: 'status',
    actions: (
    <DropDown
      selections={selections}
      mainIcon={<EditIcon className="w-6 h-6" />}
      title="Actions"
    />
  ),
  },
  {
    id: 'id',
    imageUrl: 'image',
    sku: 'sku',
    name: 'name',
    category: 'category',
    priceCost: 100,
    price: 200,
    kind: 'kind',
    virtual: 'virtual',
    status: 'status',
    supplierChair: 'supplierChair',
    actions: (
    <DropDown
      selections={selections}
      mainIcon={<EditIcon className="w-6 h-6" />}
      title="Actions"
    />
  ),
  },
  .... The remaining of the data ..
]
How to set table's style ?
const tableStyling = {
  headStyle: "bg-green-300  w-1/2",
  headElementStyle: "bg-red-200 p-4 ",
  bodyStyle: "bg-green-200",
  bodyElementStyle: "bg-yellow-400",
};

**** HINT : DropDown is illustrated down in the docs.

App Screenshot

//=================================================

Go back to the table of components

//=================================================

17- DropDown

The DropDown takes 4 props:

  • selections : Array of objects, each object has 3 keys (icon , name and action ( the method that is called when click on the corresponding option in the droplist ) )
  • mainIcon : Icon of the droplist
  • title : title appears upwards the options.
  • className?

This is how the table component is used :

<DropDown
  selections={selections}
  mainIcon={<EditIcon className="w-6 h-6" />}
  title="Actions"
/>
Selections array
interface dropOptions {
  icon?: ReactNode;
  name: string;
  action: any;
}

const selections: dropOptions[] = [
  {
    icon: <Copy className="w-4 h-4 mr-2" />,
    name: "Copy",
    action: () => {
      console.log("copy");
    },
  },

  {
    icon: <Edit className="w-4 h-4 mr-2" />,
    name: "Edit",
    action: () => {
      console.log("edit");
    },
  },
];

App Screenshot

//=================================================

Go back to the table of components

//=================================================

18- PaginationComponent

It has two sections :

  • The left one for pages
  • The right one for limit

The PaginationComponent takes 4 props:

  • totalDataLength : total number of rows (data)
  • setPageFn : setState function to get the current page
  • setLimitFn : setState function to get the limit
  • constantLimit ?: if your API doesn't allow you to set limit for data per page, you will have to set this prop with the length of the array received from the API. If you set this prop, the limit input field will disappear.

This is how the table component is used :

<PaginationComponent
  setLimitFn={() => {}}
  setPageFn={() => {}}
  totalDataLength={100}
  constantLimit={20}
/>

* HINT : If you don't know the totalDataLength from back-end you can set it to a big random number

App Screenshot

//=================================================

Go back to the table of components

//=================================================

19- selector

A drop list with items ( same as select HTML tag )

The selector takes 3 props:

  • items : items array of objects, each object has two keys (name , value)
  • placeholder ?: initial text that appears on the selector
  • showCheckIcon ?: boolean value
  • value ?: value of the selection
  • defaultValue:default value of the selector
  • onValueChange ?: setState function used to get the selected value
  • className ?: styles of the selector
  • itemsStyle ?: styles for each element in the selector
  • id?: id for the selector -name?:name for the selector

This is how the selector component is used :

<Selector
  items={[{ name: "Item 1", value: "1" }]}
  value="item 2"
  placeholder="change"
/>

//=================================================

Go back to the table of components

//=================================================

19- Login

A login page that will be used during development only to do login and get data needed for APIs' call ( token , secrect_key , ...). This login should be removed before deployment of your module.

The Login takes 1 prop:

  • url ?: url of login that will get the userNAme and password and return json contains all data. url is set by default to this value ("https://accounts.vodoerp.com/api/login")

This is how the login component is used :

<Login url="https://accounts.vodoerp.com/api/login" />