lbry-desktop/ui/component/commentsList/view.jsx
2022-05-23 11:34:32 -03:00

567 lines
18 KiB
JavaScript

// @flow
import {
COMMENT_PAGE_SIZE_TOP_LEVEL,
SORT_BY,
LINKED_COMMENT_QUERY_PARAM,
THREAD_COMMENT_QUERY_PARAM,
} from 'constants/comment';
import { ENABLE_COMMENT_REACTIONS } from 'config';
import { useIsMobile, useIsMediumScreen } from 'effects/use-screensize';
import { getCommentsListTitle } from 'util/comments';
import * as ICONS from 'constants/icons';
import * as REACTION_TYPES from 'constants/reactions';
import Button from 'component/button';
import Card from 'component/common/card';
import classnames from 'classnames';
import CommentCreate from 'component/commentCreate';
import CommentView from 'component/comment';
import debounce from 'util/debounce';
import Empty from 'component/common/empty';
import React, { useEffect } from 'react';
import Spinner from 'component/spinner';
import usePersistedState from 'effects/use-persisted-state';
import useGetUserMemberships from 'effects/use-get-user-memberships';
import { useHistory } from 'react-router-dom';
const DEBOUNCE_SCROLL_HANDLER_MS = 200;
function scaleToDevicePixelRatio(value) {
const devicePixelRatio = window.devicePixelRatio || 1.0;
if (devicePixelRatio < 1.0) {
return Math.ceil(value / devicePixelRatio);
}
return Math.ceil(value * devicePixelRatio);
}
type Props = {
allCommentIds: any,
pinnedComments: Array<Comment>,
topLevelComments: Array<Comment>,
topLevelTotalPages: number,
uri: string,
claimId?: string,
channelId?: string,
claimIsMine: boolean,
isFetchingComments: boolean,
isFetchingCommentsById: boolean,
isFetchingReacts: boolean,
linkedCommentId?: string,
totalComments: number,
fetchingChannels: boolean,
myReactsByCommentId: ?{ [string]: Array<string> }, // "CommentId:MyChannelId" -> reaction array (note the ID concatenation)
othersReactsById: ?{ [string]: { [REACTION_TYPES.LIKE | REACTION_TYPES.DISLIKE]: number } },
activeChannelId: ?string,
settingsByChannelId: { [channelId: string]: PerChannelSettings },
commentsAreExpanded?: boolean,
threadCommentId: ?string,
threadComment: ?Comment,
notInDrawer?: boolean,
threadCommentAncestors: ?Array<string>,
linkedCommentAncestors: ?Array<string>,
fetchTopLevelComments: (uri: string, parentId: ?string, page: number, pageSize: number, sortBy: number) => void,
fetchComment: (commentId: string) => void,
fetchReacts: (commentIds: Array<string>) => Promise<any>,
resetComments: (claimId: string) => void,
claimsByUri: { [string]: any },
doFetchUserMemberships: (claimIdCsv: string) => void,
};
export default function CommentList(props: Props) {
const {
allCommentIds,
uri,
pinnedComments,
topLevelComments,
topLevelTotalPages,
claimId,
channelId,
claimIsMine,
isFetchingComments,
isFetchingReacts,
linkedCommentId,
totalComments,
fetchingChannels,
myReactsByCommentId,
othersReactsById,
activeChannelId,
settingsByChannelId,
commentsAreExpanded,
threadCommentId,
threadComment,
notInDrawer,
threadCommentAncestors,
linkedCommentAncestors,
fetchTopLevelComments,
fetchComment,
fetchReacts,
resetComments,
claimsByUri,
doFetchUserMemberships,
} = props;
const threadRedirect = React.useRef(false);
const {
push,
location: { pathname, search },
} = useHistory();
const isMobile = useIsMobile();
const isMediumScreen = useIsMediumScreen();
const currentFetchedPage = Math.ceil(topLevelComments.length / COMMENT_PAGE_SIZE_TOP_LEVEL);
const spinnerRef = React.useRef();
const commentListRef = React.useRef();
const DEFAULT_SORT = ENABLE_COMMENT_REACTIONS ? SORT_BY.POPULARITY : SORT_BY.NEWEST;
const [sort, setSort] = usePersistedState('comment-sort-by', DEFAULT_SORT);
const [page, setPage] = React.useState(currentFetchedPage > 0 ? currentFetchedPage : 1);
const [didInitialPageFetch, setInitialPageFetch] = React.useState(false);
const hasDefaultExpansion = commentsAreExpanded || !isMediumScreen || isMobile;
const [expandedComments, setExpandedComments] = React.useState(hasDefaultExpansion);
const [debouncedUri, setDebouncedUri] = React.useState();
const totalFetchedComments = allCommentIds ? allCommentIds.length : 0;
const channelSettings = channelId ? settingsByChannelId[channelId] : undefined;
const moreBelow = page < topLevelTotalPages;
const title = getCommentsListTitle(totalComments);
const threadDepthLevel = isMobile ? 3 : 10;
let threadCommentParent;
if (threadCommentAncestors) {
threadCommentAncestors.some((ancestor, index) => {
if (index >= threadDepthLevel - 1) return true;
threadCommentParent = ancestor;
});
}
const threadTopLevelComment = threadCommentAncestors && threadCommentAncestors[threadCommentAncestors.length - 1];
// Display comments immediately if not fetching reactions
// If not, wait to show comments until reactions are fetched
const [readyToDisplayComments, setReadyToDisplayComments] = React.useState(
Boolean(othersReactsById) || !ENABLE_COMMENT_REACTIONS
);
// get commenter claim ids for checking premium status
const commenterClaimIds = topLevelComments.map((comment) => comment.channel_id);
// update premium status
const shouldFetchUserMemberships = true;
useGetUserMemberships(
shouldFetchUserMemberships,
commenterClaimIds,
claimsByUri,
doFetchUserMemberships,
[topLevelComments],
true
);
const handleReset = React.useCallback(() => {
if (claimId) resetComments(claimId);
setPage(1);
}, [claimId, resetComments]);
function refreshComments() {
// Invalidate existing comments
setPage(0);
}
function changeSort(newSort) {
if (sort !== newSort) {
setSort(newSort);
refreshComments();
}
}
// If a linked comment is deep within a thread, redirect to it's own thread page
// based on the set depthLevel (mobile/desktop)
React.useEffect(() => {
if (
!threadCommentId &&
linkedCommentId &&
linkedCommentAncestors &&
linkedCommentAncestors.length > threadDepthLevel - 1 &&
!threadRedirect.current
) {
const urlParams = new URLSearchParams(search);
urlParams.set(THREAD_COMMENT_QUERY_PARAM, linkedCommentId);
push({ pathname, search: urlParams.toString() });
// to do it only once
threadRedirect.current = true;
}
}, [linkedCommentAncestors, linkedCommentId, pathname, push, search, threadCommentId, threadDepthLevel]);
// set new page on scroll debounce and avoid setting the page after navigated uris
useEffect(() => {
if (debouncedUri && debouncedUri === uri) {
setPage(page + 1);
setDebouncedUri(undefined);
}
// only for comparing uri with debounced uri
// eslint-disable-next-line react-hooks/exhaustive-deps
}, [debouncedUri, uri]);
// Force comments reset
useEffect(() => {
if (page === 0) {
handleReset();
}
}, [handleReset, page]);
// Set page back to 1 on every claim switch
useEffect(() => {
return () => setPage(1);
// eslint-disable-next-line react-hooks/exhaustive-deps
}, [uri]);
// When navigating to a new claim, the page will be 1 due to the above
// and if there was already fetched top level comments, the fetched page will be higher
// so set the current page as the fetched page to start fetching new pages from there
useEffect(() => {
if (page < currentFetchedPage) setPage(currentFetchedPage > 0 ? currentFetchedPage : 1);
// only on uri change
// eslint-disable-next-line react-hooks/exhaustive-deps
}, [uri]);
// Fetch top-level comments
useEffect(() => {
const isInitialFetch = currentFetchedPage === 0;
const isNewPage = page !== 1 && page !== currentFetchedPage;
// only one or the other should be true, if both are true it means
// it will fetch the wrong page initially. needs Number so it's 0 or 1
const hasRightFetchPage = Number(isInitialFetch) ^ Number(isNewPage);
if (page !== 0 && hasRightFetchPage) {
if (page === 1) {
if (threadCommentId) {
fetchComment(threadCommentId);
}
if (linkedCommentId) {
fetchComment(linkedCommentId);
}
}
fetchTopLevelComments(uri, undefined, page, COMMENT_PAGE_SIZE_TOP_LEVEL, sort);
}
}, [currentFetchedPage, fetchComment, fetchTopLevelComments, linkedCommentId, page, sort, threadCommentId, uri]);
React.useEffect(() => {
if (threadCommentId) {
refreshComments();
}
}, [threadCommentId]);
// Fetch reacts
useEffect(() => {
if (totalFetchedComments > 0 && ENABLE_COMMENT_REACTIONS && !fetchingChannels && !isFetchingReacts) {
let idsForReactionFetch;
if (!othersReactsById || !myReactsByCommentId) {
idsForReactionFetch = allCommentIds;
} else {
idsForReactionFetch = allCommentIds.filter((commentId) => {
const key = activeChannelId ? `${commentId}:${activeChannelId}` : commentId;
return !othersReactsById[key] || (activeChannelId && !myReactsByCommentId[key]);
});
}
if (idsForReactionFetch.length !== 0) {
fetchReacts(idsForReactionFetch)
.then(() => {
setReadyToDisplayComments(true);
})
.catch(() => setReadyToDisplayComments(true));
}
}
}, [
activeChannelId,
allCommentIds,
fetchReacts,
fetchingChannels,
isFetchingReacts,
myReactsByCommentId,
othersReactsById,
totalFetchedComments,
]);
// Scroll to linked-comment
useEffect(() => {
if (linkedCommentId || threadCommentId) {
window.pendingLinkedCommentScroll = true;
} else {
delete window.pendingLinkedCommentScroll;
}
// eslint-disable-next-line react-hooks/exhaustive-deps
}, []);
// Infinite scroll
useEffect(() => {
if (topLevelComments.length === 0) return;
function shouldFetchNextPage(page, topLevelTotalPages, yPrefetchPx = 1000) {
if (!spinnerRef || !spinnerRef.current) return false;
const rect = spinnerRef.current.getBoundingClientRect(); // $FlowFixMe
const windowH = window.innerHeight || document.documentElement.clientHeight; // $FlowFixMe
const windowW = window.innerWidth || document.documentElement.clientWidth; // $FlowFixMe
const isApproachingViewport = yPrefetchPx !== 0 && rect.top < windowH + scaleToDevicePixelRatio(yPrefetchPx);
const isInViewport =
rect.width > 0 &&
rect.height > 0 &&
rect.bottom >= 0 &&
rect.right >= 0 &&
// $FlowFixMe
rect.top <= windowH &&
// $FlowFixMe
rect.left <= windowW;
return (isInViewport || isApproachingViewport) && page < topLevelTotalPages;
}
const handleCommentScroll = debounce(() => {
if (shouldFetchNextPage(page, topLevelTotalPages)) {
setDebouncedUri(uri);
setInitialPageFetch(true);
}
}, DEBOUNCE_SCROLL_HANDLER_MS);
if (!didInitialPageFetch) {
handleCommentScroll();
setInitialPageFetch(true);
}
if (hasDefaultExpansion && !isFetchingComments && readyToDisplayComments && moreBelow) {
const commentsInDrawer = Boolean(document.querySelector('.MuiDrawer-root .card--enable-overflow'));
const scrollingElement = commentsInDrawer ? document.querySelector('.card--enable-overflow') : window;
if (scrollingElement) {
scrollingElement.addEventListener('scroll', handleCommentScroll);
return () => scrollingElement.removeEventListener('scroll', handleCommentScroll);
}
}
}, [
topLevelComments,
hasDefaultExpansion,
didInitialPageFetch,
isFetchingComments,
isMobile,
moreBelow,
page,
readyToDisplayComments,
topLevelTotalPages,
uri,
]);
const commentProps = {
isTopLevel: true,
uri,
claimIsMine,
linkedCommentId,
threadCommentId,
threadDepthLevel,
};
const actionButtonsProps = {
totalComments,
sort,
changeSort,
handleRefresh: refreshComments,
};
return (
<Card
className="card--enable-overflow comment__list"
title={(!isMobile || notInDrawer) && title}
titleActions={<CommentActionButtons {...actionButtonsProps} />}
actions={
<>
{isMobile && !notInDrawer && <CommentActionButtons {...actionButtonsProps} />}
<CommentCreate uri={uri} />
{threadCommentId && threadComment && (
<span className="comment__actions comment__thread-links">
<ThreadLinkButton
label={__('View all comments')}
threadCommentParent={threadTopLevelComment || threadCommentId}
threadCommentId={threadCommentId}
isViewAll
/>
{threadCommentParent && (
<ThreadLinkButton
label={__('Show parent comments')}
threadCommentParent={threadCommentParent}
threadCommentId={threadCommentId}
/>
)}
</span>
)}
{channelSettings &&
channelSettings.comments_enabled &&
!isFetchingComments &&
!totalComments &&
!threadCommentId && <Empty padded text={__('That was pretty deep. What do you think?')} />}
<ul
ref={commentListRef}
className={classnames('comments', {
'comments--contracted': isMediumScreen && !expandedComments && totalComments > 1,
})}
>
{readyToDisplayComments && (
<>
{pinnedComments && !threadCommentId && <CommentElements comments={pinnedComments} {...commentProps} />}
<CommentElements comments={topLevelComments} {...commentProps} />
</>
)}
</ul>
{!hasDefaultExpansion && (
<div className="card__bottom-actions card__bottom-actions--comments">
{(!expandedComments || moreBelow) && totalComments > 1 && (
<Button
button="link"
title={!expandedComments ? __('Expand') : __('More')}
label={!expandedComments ? __('Expand') : __('More')}
onClick={() => (!expandedComments ? setExpandedComments(true) : setPage(page + 1))}
/>
)}
{expandedComments && totalComments > 1 && (
<Button
button="link"
title={__('Collapse')}
label={__('Collapse')}
onClick={() => {
setExpandedComments(false);
if (commentListRef.current) {
const ADDITIONAL_OFFSET = 200;
const refTop = commentListRef.current.getBoundingClientRect().top;
window.scrollTo({
top: refTop + window.pageYOffset - ADDITIONAL_OFFSET,
behavior: 'smooth',
});
}
}}
/>
)}
</div>
)}
{(threadCommentId ? !readyToDisplayComments : isFetchingComments || (hasDefaultExpansion && moreBelow)) && (
<div className="main--empty" ref={spinnerRef}>
<Spinner type="small" />
</div>
)}
</>
}
/>
);
}
type CommentProps = {
comments: Array<Comment>,
};
const CommentElements = (commentProps: CommentProps) => {
const { comments, ...commentsProps } = commentProps;
return comments.map((comment) => <CommentView key={comment.comment_id} comment={comment} {...commentsProps} />);
};
type ActionButtonsProps = {
totalComments: number,
sort: string,
changeSort: (string) => void,
handleRefresh: () => void,
};
const CommentActionButtons = (actionButtonsProps: ActionButtonsProps) => {
const { totalComments, sort, changeSort, handleRefresh } = actionButtonsProps;
const sortButtonProps = { activeSort: sort, changeSort };
return (
<>
{totalComments > 1 && ENABLE_COMMENT_REACTIONS && (
<span className="comment__sort">
<SortButton {...sortButtonProps} label={__('Best')} icon={ICONS.BEST} sortOption={SORT_BY.POPULARITY} />
<SortButton
{...sortButtonProps}
label={__('Controversial')}
icon={ICONS.CONTROVERSIAL}
sortOption={SORT_BY.CONTROVERSY}
/>
<SortButton {...sortButtonProps} label={__('New')} icon={ICONS.NEW} sortOption={SORT_BY.NEWEST} />
</span>
)}
<Button button="alt" icon={ICONS.REFRESH} title={__('Refresh')} onClick={handleRefresh} />
</>
);
};
type SortButtonProps = {
activeSort: string,
sortOption: string,
changeSort: (string) => void,
};
const SortButton = (sortButtonProps: SortButtonProps) => {
const { activeSort, sortOption, changeSort, ...buttonProps } = sortButtonProps;
return (
<Button
{...buttonProps}
className={classnames(`button-toggle`, { 'button-toggle--active': activeSort === sortOption })}
button="alt"
iconSize={18}
onClick={() => changeSort(sortOption)}
/>
);
};
type ThreadLinkProps = {
label: string,
isViewAll?: boolean,
threadCommentParent: string,
threadCommentId: string,
};
const ThreadLinkButton = (props: ThreadLinkProps) => {
const { label, isViewAll, threadCommentParent, threadCommentId } = props;
const {
push,
location: { pathname, search },
} = useHistory();
return (
<Button
button="link"
label={label}
icon={ICONS.ARROW_LEFT}
iconSize={12}
onClick={() => {
const urlParams = new URLSearchParams(search);
if (!isViewAll) {
urlParams.set(THREAD_COMMENT_QUERY_PARAM, threadCommentParent);
// on moving back, link the current thread comment so that it auto-expands into the correct conversation
urlParams.set(LINKED_COMMENT_QUERY_PARAM, threadCommentId);
} else {
urlParams.delete(THREAD_COMMENT_QUERY_PARAM);
// links the top-level comment when going back to all comments, for easy locating
// in the middle of big comment sections
urlParams.set(LINKED_COMMENT_QUERY_PARAM, threadCommentParent);
}
window.pendingLinkedCommentScroll = true;
push({ pathname, search: urlParams.toString() });
}}
/>
);
};