discus-lib
This package is a user discussion components where the user can comment on a post and discuss on that.
Overview
discus-lib is a React component library built using TypeScript. It provides Comment box
where users can post comments and a Comment
to display all the posted comments.
Installation
You can install discus-lib via npm:
npm i discus-lib
Usage
To use discus-lib, import the Discus
component and integrate it into your React application. Ensure to remove <React.StrictMode>
tags when using this component to prevent multiple renders.
The component can also take two properties:
name
: "string" that holds the name of the user to be displayed. If the property is not mentioned it will display as Unknown UsersetDiscussion
: "React state function" that hold the function to set the comments from the package and that can be manipulated in the actual component.
import React, { useState } from 'react';
import { Discus } from 'discus-lib';
// TypeScript types
type CommentType = {
id: string;
userName: string;
comment: string;
timestamp: Date;
reply: CommentType[];
likeCount: number;
dislikeCount: number;
};
type DiscusProps = {
name: string;
setDiscussion: React.Dispatch<React.SetStateAction<CommentType[] | undefined>>;
};
// App Component
const App: React.FC = () => {
const [discussion, setDiscussion] = useState<CommentType[] | undefined>([]);
const discusProps: DiscusProps = {
name: "Person 1",
setDiscussion
};
return (
<div className="App">
<h1>My App</h1>
<Discus {...discusProps} />
</div>
);
};
export default App;
Output
The comments schema which is captured in the setDiscussion
state function will be as an array[] of object that is shown as below.
CommentType = [
{
id: string;
userName: string;
comment: string;
timestamp: Date;
reply: [
{
id: string;
userName: string;
reply: CommentType[];
timestamp: Date;
likeCount: number;
dislikeCount: number;
},
],
likeCount: number;
dislikeCount: number;
},
]
Note
Discus component is a recursion based component where the Comment component will recursively call the CommentBox component for replying on that comment.
License
This project is licensed under the MIT License. See the LICENSE file for details.