0.1.1 • Published 3 years ago

react-cmd-palette v0.1.1

Weekly downloads
-
License
MIT
Repository
github
Last release
3 years ago

react-cmd-palette

GitHub branch checks state GitHub npm bundle size

A command palette made for React, like Visual Studio Code's CTRL+SHIFT+P but then for your React application.

Common use cases

  • Search through a list of {pages, users, calendar appointments, emails, whatever} and {navigate to, remove, link, archive, whatever} it.
  • Add actions of your table like sorting, selecting, removing to the command palette so they can be accessed easier.

Installation

# Using npm
npm install react-cmd-palette
# Using yarn
yarn add react-cmd-palette

Documentation (using Storybook)

You can visit the online documentation on https://rbozan.github.io/react-cmd-palette .

Theming support

For theming support you could wrap the <CommandPalette> with styled-components, however you might just as well add a class to the input or modify the trailing or leading components based on your use case.

Why is this component designed to have an addAction and removeAction and not just pass an array as property?

The reason is that components within your application could have several dynamic actions, where organizing these actions is also important.

Let's say you want to add a sorting action when you are seeing a specific table, the action would then be registered and unregistered within that specific component. It is also immediately clear that the sorting action belongs to the table, as that sorting action is registered right in that component.

But had we used a property, you would have had to somehow pass that new action up the component tree so you can add it as a property.

License

MIT License, see LICENSE.md