ink-table

ink-table

A table component for Ink.

Install

npm install ink-table

Usage

import Table from 'ink-table'

const data = [
  {
    name: 'Sosa Saunders',
    gender: 'male',
    age: 17,
    email: '[e-mail]',
    phone: '[phone]',
  },
  {
    name: 'Angelina Kirk',
    gender: 'female',
    age: 3,
    email: '[e-mail]',
    phone: '[phone]',
  },
  {
    name: 'Bradford Rosales',
    gender: 'male',
    age: 20,
    email: '[e-mail]',
    phone: '[phone]',
  },
  {
    name: 'Gwen Schroeder',
    gender: 'female',
    age: 17,
    email: '[e-mail]',
    phone: '[phone]',
  },
  {
    name: 'Ellison Mann',
    gender: 'male',
    age: 5,
    email: '[e-mail]',
    phone: '[phone]',
  },
]

const Basic = () => <Table data={data} />

render(<Basic />)

Documentation

type ScalarDict = {
  [key: string]: string | number | boolean | null | undefined
}

export type TableProps<T extends ScalarDict> = {
  /**
   * List of values (rows).
   */
  data: T[]
  /**
   * Columns that we should display in the table.
   */
  columns: (keyof T)[]
  /**
   * Cell padding.
   */
  padding: number
  /**
   * Header component.
   */
  header: (props: React.PropsWithChildren<{}>) => JSX.Element
  /**
   * Component used to render a cell in the table.
   */
  cell: (props: React.PropsWithChildren<{}>) => JSX.Element
  /**
   * Component used to render the skeleton of the table.
   */
  skeleton: (props: React.PropsWithChildren<{}>) => JSX.Element
}

License

MIT © Matic Zavadlal

Similar packages

Other packages similar to ink-table

cli-table

cli-table is a widely-used package for rendering tables in the command line. It offers a lot of customization options for table appearance, including column alignment, padding, and border styles. Compared to ink-table, cli-table is more focused on traditional CLI applications and does not integrate with React-like components.

table

The table package is another popular option for creating tables in the command line. It provides a simple API for defining table data and supports various formatting options. Like cli-table, it is not designed to work with Ink or React-like components, making it less suitable for Ink-based applications.

blessed-contrib

blessed-contrib is a library for building dashboards and other terminal-based UIs. It includes a table component among many other widgets like charts and graphs. While it offers more features than ink-table, it is also more complex and not specifically designed for use with Ink.