@chitlangesahas/react-reactions
v0.8.4
Published
π² Create custom reaction pickers and counters or use your favorites!
Downloads
33
Maintainers
Readme
Create your own reaction bar or use one of your favorites!
- 4 Different Selectors - Slack, Facebook, Pokemon and GitHub
- 5 Different Counters - GitHub, YouTube, Facebook, Pokemon, and Slack
Install via npm (or from the GitHub Package Registry):
npm i @charkour/react-reactions
This originated as a fork of casesandberg/react-reactions which is been modified under the MIT license to include additional features.
New Features
- [x] Add ability to pass custom icons
- [x] Fixed security vulnerabilities
- [x] CJS and ESM support
- [x] Zero dependencies
- [x] Built in Typescript and modern React (with TSDX)
- [x] Works with React 16.8+ and Next 10
Road Map
- [ ] Update current Selectors and Counter to match 2021 styles
- [ ] Add Discord Selector and Counter
- [ ] Add unit testing
- [ ] More??? Suggest a feature on Github Issues
Custom Selectors
Reaction Bar Selector
import React from 'react';
import { ReactionBarSelector } from '@charkour/react-reactions';
const Component = () => {
return <ReactionBarSelector />;
};
Props:
iconSize?: number
β String icon pixel size. Defaults to 38px
reactions?: Reaction[];
β Array of Reaction objects {label: "haha", node: <div>π</div>}
to display.
onSelect: (label: string) => void;
β Function callback when emoji is selected
Also works with images.
Note: When passing an <img>
as a Reaction. Specify the iconSize
as the height of the image. <img height={iconSize} src="img-source" />
Reaction Counter
import React from 'react';
import { ReactionCounter } from '@charkour/react-reactions';
const Component = () => {
return <ReactionCounter />;
};
Props:*
iconSize?: number
- String icon pixel size. Defaults to 24px
bg?: string
- String of hex color for outline of overlapping reactions. Defaults to #fff
reactions: ReactionCounterObject[]
- Array of emoji to dispay
user?: string
- String name of user so that user displays as You
important?: string[]
- Array of strings for important users to display their name
showReactsOnly?: boolean
- If true
, only show the Reactions and no text. Defaults to false
showTotalOnly?: boolean
- If true
, only show the number of Reactions and no specific names. Defaults to false
showOthersAlways?: boolean
- Will display "and 0 others" if you are the only person who reacted. Defaults to true
className?: string
- Pass a string that applies to the counter container
onClick?: () => void
- Pass a callback that is added to the onClick
property to the counter container
style?: React.CSSProperties
- Pass a style object to the counter container
Selectors
Slack Selector
import React from 'react';
import { SlackSelector } from '@charkour/react-reactions';
const Component = () => {
return <SlackSelector />;
};
Props:
active
: String of active tab. Defaults to mine
scrollHeight
: String pixel height of scroll container. Defaults to 270px
removeEmojis
: Array of emojis to remove from emoji list
frequent
: Array of emojis to set Frequently Used. Defaults to ['π', 'π', 'π', 'πΏ', 'π', 'π¬', 'πΉ', 'π»', 'π', 'π', 'π', 'π¨π¦']
onSelect
: Function callback when emoji is selected
Github Selector
import React from 'react';
import { GithubSelector } from '@charkour/react-reactions';
const Component = () => {
return <GithubSelector />;
};
Props:
reactions
: Array of emoji to dispay. Defaults to ['π', 'π', 'π', 'π', 'π', 'β€οΈ']
onSelect
: Function callback when emoji is selected
Facebook Selector
import React from 'react';
import { FacebookSelector } from '@charkour/react-reactions';
const Component = () => {
return <FacebookSelector />;
};
Props:
reactions
: Array of strings for reactions to display. Defaults to ['like', 'love', 'haha', 'wow', 'sad', 'angry']
iconSize
: String icon pixel size. Defaults to 38px
onSelect
: Function callback when emoji is selected
Pokemon Selector
import React from 'react';
import { PokemonSelector } from '@charkour/react-reactions';
const Component = () => {
return <PokemonSelector />;
};
Props:
reactions
: Array of strings for reactions to display. Defaults to ['like', 'love', 'haha', 'wow', 'sad', 'angry']
iconSize
: String icon pixel size. Defaults to 38px
onSelect
: Function callback when emoji is selected
Counters
Github Counter
import React from 'react';
import { GithubCounter } from '@charkour/react-reactions';
const Component = () => {
return <GithubCounter />;
};
Props:
counters
: Array of counter objects structured such that:
{
emoji: 'π', // String emoji reaction
by: 'case', // String of persons name
}
user
: String name of user so that user displays as You
onSelect
: Function callback when emoji is selected
onAdd
: Function callback when add reaction is clicked
Youtube Counter
import React from 'react';
import { YoutubeCounter } from '@charkour/react-reactions';
const Component = () => {
return <YoutubeCounter />;
};
Props:
like
: String number of likes
dislike
: String number of dislikes
onLikeClick
: Function callback when like is clicked
onDislikeClick
: Function callback when dislike is clicked
Facebook Counter
import React from 'react';
import { FacebookCounter } from '@charkour/react-reactions';
const Component = () => {
return <FacebookCounter />;
};
Props:
counters
: Array of counter objects structured such that:
{
emoji: 'like', // String name of reaction
by: 'Case Sandberg', // String of persons name
}
user
: String name of user so that user displays as You
important
: Array of strings for important users to display their name
bg
: String of hex color for outline of overlapping reactions. Defaults to #fff
onClick
: Function callback when clicked
alwaysShowOthers
: boolean. Will display "and 0 others" if you are the only person who reacted.
Pokemon Counter
import React from 'react';
import { PokemonCounter } from '@charkour/react-reactions';
const Component = () => {
return <PokemonCounter />;
};
Props:
counters
: Array of counter objects structured such that:
{
emoji: 'like', // String name of reaction
by: 'Charles Kornoelje', // String of persons name
}
user
: String name of user so that user displays as You
important
: Array of strings for important users to display their name
bg
: String of hex color for outline of overlapping reactions. Defaults to #fff
onClick
: Function callback when clicked
alwaysShowOthers
: boolean. Will display "and 0 others" if you are the only person who reacted.
Slack Counter
import React from 'react';
import { SlackCounter } from '@charkour/react-reactions';
const Component = () => {
return <SlackCounter />;
};
Props:
counters
: Array of counter objects structured such that:
{
emoji: 'πΏ', // String emoji reaction
by: 'case', // String of persons name
}
user
: String name of user so that user displays as You
onSelect
: Function callback when emoji is selected
onAdd
: Function callback when add reaction is clicked
Animations
A simple animation can be done on the components using CSS. See this demo. More advaned animations can be done using dynamic styles. See this demo
Development
npm start
This builds to /dist
and runs the project in watch mode so any edits you save inside src
causes a rebuild to /dist
.
Then run either Storybook or the example playground:
Storybook
Run inside another terminal:
npm run storybook
This loads the stories from ./stories
.
NOTE: Stories should reference the components as if using the library, similar to the example playground. This means importing from the root project directory. This has been aliased in the tsconfig and the storybook webpack config as a helper.
Example
Then run the example inside another:
cd example
npm i
npm start
The default example imports and live reloads whatever is in /dist
, so if you are seeing an out of date component, make sure TSDX is running in watch mode like we recommend above. No symlinking required, we use Parcel's aliasing.
To do a one-off build, use npm run build
.
To run tests, use npm test
.
Configuration
Code quality is set up for you with prettier
, husky
, and lint-staged
. Adjust the respective fields in package.json
accordingly.
Jest
Jest tests are set up to run with npm test
.
GitHub Actions
main
which installs deps w/ cache, lints, tests, and builds on all pushes against a Node and OS matrix
Pokemon Illustrations by Chris Owens