docbrown/app/javascript/readingList/readingList.jsx
Makar c6cef39694
Persist selectedTag filtering of the reading list (#20601)
* persist selectedTag filtering of the reading list when coming back after reading an article

* bugfix -- could not filter back by all tags in mobile

* e2e tests for persisted filtering

---------

Co-authored-by: Mac Siri <mac@forem.com>
2024-02-16 13:06:21 +00:00

299 lines
9 KiB
JavaScript

import { h, Component, Fragment } from 'preact';
import PropTypes from 'prop-types';
import {
loadNextPage,
onSearchBoxType,
performInitialSearch,
search,
selectTag,
checkForPersistedTag,
clearSelectedTags,
} from '../searchableItemList/searchableItemList';
import { addSnackbarItem } from '../Snackbar';
import { ItemListItem } from './components/ItemListItem';
import { ItemListItemArchiveButton } from './components/ItemListItemArchiveButton';
import { TagList } from './components/TagList';
import { MediaQuery } from '@components/MediaQuery';
import { BREAKPOINTS } from '@components/useMediaQuery';
import { debounceAction } from '@utilities/debounceAction';
import { ButtonNew as Button, Link } from '@crayons';
import { request } from '@utilities/http';
const NO_RESULTS_WITH_FILTER_MESSAGE = 'Nothing with this filter 🤔';
const STATUS_VIEW_VALID = 'valid,confirmed';
const STATUS_VIEW_ARCHIVED = 'archived';
const READING_LIST_ARCHIVE_PATH = '/readinglist/archive';
const READING_LIST_PATH = '/readinglist';
function ItemList({ items, archiveButtonLabel, toggleArchiveStatus }) {
return items.map((item) => {
return (
<ItemListItem item={item} key={item.id}>
<ItemListItemArchiveButton
text={archiveButtonLabel}
onClick={(e) => toggleArchiveStatus(e, item)}
/>
</ItemListItem>
);
});
}
export class ReadingList extends Component {
constructor(props) {
super(props);
const { statusView } = this.props;
this.state = {
query: '',
index: null,
page: 0,
hitsPerPage: 80,
items: [],
itemsLoaded: false,
itemsTotal: 0,
availableTags: [],
selectedTag: '',
showLoadMoreButton: false,
statusView,
};
// bind and initialize all shared functions
this.onSearchBoxType = debounceAction(onSearchBoxType.bind(this), {
leading: true,
});
this.loadNextPage = loadNextPage.bind(this);
this.performInitialSearch = performInitialSearch.bind(this);
this.search = search.bind(this);
this.selectTag = selectTag.bind(this);
this.clearSelectedTags = clearSelectedTags.bind(this);
}
async componentDidMount() {
const { statusView } = this.state;
await this.performInitialSearch({
searchOptions: { status: `${statusView}` },
});
const persistedTag = checkForPersistedTag();
if (persistedTag) {
this.selectTag({
target: { value: persistedTag },
preventDefault(){},
});
}
}
toggleStatusView = (event) => {
event.preventDefault();
const { query, selectedTag } = this.state;
const isStatusViewValid = this.statusViewValid();
const newStatusView = isStatusViewValid
? STATUS_VIEW_ARCHIVED
: STATUS_VIEW_VALID;
const newPath = isStatusViewValid
? READING_LIST_ARCHIVE_PATH
: READING_LIST_PATH;
// empty items so that changing the view will start from scratch
this.setState({ statusView: newStatusView, items: [], selectedTag });
this.search(query, {
page: 0,
tags: selectedTag ? [selectedTag] : [],
statusView: newStatusView,
});
// change path in the address bar
window.history.replaceState(null, null, newPath);
};
toggleArchiveStatus = (event, item) => {
event.preventDefault();
const { statusView, items, itemsTotal } = this.state;
const isStatusViewValid = this.statusViewValid();
request(`/reading_list_items/${item.id}`, {
method: 'PUT',
body: { current_status: statusView },
});
const newItems = items;
newItems.splice(newItems.indexOf(item), 1);
this.setState({
items: newItems,
itemsTotal: itemsTotal - 1,
});
addSnackbarItem({
message: isStatusViewValid ? 'Archiving...' : 'Unarchiving...',
});
};
statusViewValid() {
const { statusView } = this.state;
return statusView === STATUS_VIEW_VALID;
}
renderEmptyItems() {
const { itemsLoaded, selectedTag = '', query } = this.state;
const showMessage = selectedTag.length === 0 && query.length === 0;
if (itemsLoaded && this.statusViewValid()) {
return (
<section className="align-center p-9 py-10 color-base-80">
<h2 className="fw-bold fs-l">
{showMessage
? 'Your reading list is empty'
: NO_RESULTS_WITH_FILTER_MESSAGE}
</h2>
<p class="color-base-60 pt-2">
Click the{' '}
<span class="fw-bold">
bookmark reaction
<svg
width="24"
height="24"
viewBox="0 0 24 24"
className="crayons-icon mx-1"
xmlns="http://www.w3.org/2000/svg"
role="img"
>
<path d="M5 2h14a1 1 0 011 1v19.143a.5.5 0 01-.766.424L12 18.03l-7.234 4.536A.5.5 0 014 22.143V3a1 1 0 011-1zm13 2H6v15.432l6-3.761 6 3.761V4z" />
</svg>
</span>
when viewing a post to add it to your reading list.
</p>
</section>
);
}
return (
<h2 className="align-center p-9 py-10 color-base-80 fw-bold fs-l">
{showMessage
? 'Your Archive is empty...'
: NO_RESULTS_WITH_FILTER_MESSAGE}
</h2>
);
}
render() {
const {
items = [],
itemsTotal,
availableTags,
selectedTag = '',
showLoadMoreButton,
loading = false,
} = this.state;
const isStatusViewValid = this.statusViewValid();
const archiveButtonLabel = isStatusViewValid ? 'Archive' : 'Unarchive';
return (
<main
id="main-content"
className="crayons-layout crayons-layout--header-inside crayons-layout--2-cols"
>
<header className="crayons-page-header block s:flex">
<div className="flex justify-between items-center flex-1 mb-2 s:mb-0">
<h1 class="crayons-title flex-1">
{isStatusViewValid ? 'Reading list' : 'Archive'}
{` (${itemsTotal})`}
</h1>
<Link
onClick={(e) => this.toggleStatusView(e)}
href={
isStatusViewValid
? READING_LIST_ARCHIVE_PATH
: READING_LIST_PATH
}
className="whitespace-nowrap ml-auto s:w-auto"
block
data-no-instant
>
{isStatusViewValid ? 'View archive' : 'View reading list'}
</Link>
</div>
<fieldset className="m:flex justify-end s:pl-2 w-100 s:w-auto">
<legend className="hidden">Filter</legend>
<input
aria-label="Filter reading list by text"
onKeyUp={this.onSearchBoxType}
type="text"
placeholder="Search..."
className="crayons-textfield mb-2 s:mb-0"
/>
<MediaQuery
query={`(max-width: ${BREAKPOINTS.Medium - 1}px)`}
render={(matches) => {
return (
matches && (
<TagList
availableTags={availableTags}
selectedTag={selectedTag}
onSelectTag={this.selectTag}
isMobile={true}
/>
)
);
}}
/>
</fieldset>
</header>
<MediaQuery
query={`(min-width: ${BREAKPOINTS.Medium}px)`}
render={(matches) => {
return (
<Fragment>
{matches && (
<div className="crayons-layout__sidebar-left">
<TagList
availableTags={availableTags}
selectedTag={selectedTag}
onSelectTag={this.selectTag}
/>
</div>
)}
<section className="crayons-layout__content crayons-card pb-4">
{items.length > 0 ? (
<Fragment>
<ItemList
items={items}
archiveButtonLabel={archiveButtonLabel}
toggleArchiveStatus={this.toggleArchiveStatus}
/>
{showLoadMoreButton && (
<div className="flex justify-center my-2">
<Button onClick={this.loadNextPage} className="w-max">
Load more
</Button>
</div>
)}
</Fragment>
) : loading ? null : (
this.renderEmptyItems()
)}
</section>
</Fragment>
);
}}
/>
</main>
);
}
}
ReadingList.defaultProps = {
statusView: STATUS_VIEW_VALID,
};
ReadingList.propTypes = {
availableTags: PropTypes.arrayOf(PropTypes.string).isRequired,
statusView: PropTypes.oneOf([STATUS_VIEW_VALID, STATUS_VIEW_ARCHIVED]),
};