feat: add filter chips for news

This commit is contained in:
Jovan Krunić
2021-07-12 16:40:42 +02:00
parent e48134eddc
commit 5435f85cc4
27 changed files with 456 additions and 86 deletions

View File

@@ -0,0 +1,7 @@
<ion-chip
[attr.color]="active ? 'primary' : 'medium'"
(click)="emitToggle(value)"
>
<ion-icon name="checkmark-circle" *ngIf="active"></ion-icon>
<ion-label>{{ displayValue }}</ion-label>
</ion-chip>

View File

@@ -0,0 +1,51 @@
/*
* Copyright (C) 2021 StApps
* This program is free software: you can redistribute it and/or modify it
* under the terms of the GNU General Public License as published by the Free
* Software Foundation, version 3.
*
* This program is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
* more details.
*
* You should have received a copy of the GNU General Public License along with
* this program. If not, see <https://www.gnu.org/licenses/>.
*/
import {Component, EventEmitter, Input, Output} from '@angular/core';
/**
* Shows a chip filter
*/
@Component({
selector: 'stapps-chip-filter',
templateUrl: './chip-filter.component.html',
styleUrls: ['./chip-filter.component.scss'],
})
export class ChipFilterComponent {
/**
* If the chip (filter) is active
*/
@Input() active: boolean;
/**
* Text to display on the chip
*/
@Input() displayValue: string;
/**
* Emits when the chip has been activated/deactivated
*/
@Output() toggle = new EventEmitter<unknown>();
/**
* Value to emit when chip has been activated/deactivated
*/
@Input() value: unknown;
/**
* Signalize that the chip filter has been activated/deactivated
*/
emitToggle(value: unknown) {
this.toggle.emit(value);
}
}

View File

@@ -19,8 +19,10 @@ import {
SCMultiSearchResponse, SCMultiSearchResponse,
SCSearchRequest, SCSearchRequest,
SCSearchResponse, SCSearchResponse,
SCSearchValueFilter,
SCThingOriginType, SCThingOriginType,
SCThings, SCThings,
SCThingsField,
SCThingType, SCThingType,
} from '@openstapps/core'; } from '@openstapps/core';
import {SCSaveableThing} from '@openstapps/core'; import {SCSaveableThing} from '@openstapps/core';
@@ -88,6 +90,25 @@ export class DataProvider {
*/ */
storageProvider: StorageProvider; storageProvider: StorageProvider;
/**
* Simplify creation of a value filter
*
* @param field Database field for apply the filter to
* @param value Value to match with
*/
static createValueFilter(
field: SCThingsField,
value: string,
): SCSearchValueFilter {
return {
type: 'value',
arguments: {
field: field,
value: value,
},
};
}
/** /**
* TODO * TODO
* *

View File

@@ -20,6 +20,7 @@ import {SCThings} from '@openstapps/core';
*/ */
@Component({ @Component({
selector: 'stapps-data-detail-content', selector: 'stapps-data-detail-content',
styleUrls: ['data-detail-content.scss'],
templateUrl: 'data-detail-content.html', templateUrl: 'data-detail-content.html',
}) })
export class DataDetailContentComponent { export class DataDetailContentComponent {

View File

@@ -6,8 +6,8 @@
<ion-row> <ion-row>
<ion-col> <ion-col>
<div class="ion-text-wrap"> <div class="ion-text-wrap">
<h2 class="name">{{ item.name }}</h2> <h2 class="name">{{ 'name' | thingTranslate: item }}</h2>
<ion-note>{{ item.type }}</ion-note> <ion-note>{{ 'type' | thingTranslate: item }}</ion-note>
</div> </div>
</ion-col> </ion-col>
</ion-row> </ion-row>

View File

@@ -0,0 +1,18 @@
:host ::ng-deep {
ion-slides.work-locations {
ion-slide {
display: block;
text-align: left;
}
}
ion-card {
ion-card-header {
font-weight: bold;
}
ion-grid, ion-col {
padding-inline-start: 0;
padding-top: 0;
padding-bottom: 0;
}
}
}

View File

@@ -12,11 +12,3 @@
} }
} }
} }
::ng-deep {
ion-grid, ion-col {
padding-inline-start: 0;
padding-top: 0;
padding-bottom: 0;
}
}

View File

@@ -1,7 +0,0 @@
::ng-deep {
ion-grid, ion-col {
padding-inline-start: 0;
padding-top: 0;
padding-bottom: 0;
}
}

View File

@@ -1,4 +1,4 @@
.item { :host ::ng-deep {
ion-label { ion-label {
width: 100%; width: 100%;
@@ -7,26 +7,21 @@
flex-direction: column; flex-direction: column;
} }
} }
} ::ng-deep {
::ng-deep {
ion-grid, ion-col {
padding-inline-start: 0 ;
padding-top: 0;
padding-bottom: 0;
}
ion-note { ion-note {
ul { ul {
margin: 0; margin: 0;
padding: 0; padding: 0;
li { li {
list-style-type: none; list-style-type: none;
display: inline; display: inline;
} }
li:not(:first-child):before { li:not(:first-child):before {
content: ""; content: "";
} }
} }
} }
}
} }

View File

@@ -1,4 +1,4 @@
<ion-card> <ion-card class="compact">
<ion-card-header> <ion-card-header>
<stapps-data-list-item <stapps-data-list-item
[item]="item" [item]="item"

View File

@@ -0,0 +1,9 @@
<ng-container *ngFor="let setting of settings">
<stapps-chip-filter
[displayValue]="setting | settingValueTranslate | titlecase"
[value]="setting"
[active]="!!filtersMap.get($any(setting.name))"
(toggle)="stateChanged($any($event))"
>
</stapps-chip-filter>
</ng-container>

View File

@@ -0,0 +1,85 @@
/*
* Copyright (C) 2021 StApps
* This program is free software: you can redistribute it and/or modify it
* under the terms of the GNU General Public License as published by the Free
* Software Foundation, version 3.
*
* This program is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
* more details.
*
* You should have received a copy of the GNU General Public License along with
* this program. If not, see <https://www.gnu.org/licenses/>.
*/
import {Component, EventEmitter, Input, OnInit, Output} from '@angular/core';
import {
newsFilterSettingsFieldsMapping,
NewsFilterSettingsNames,
} from '../../news-filter-settings';
import {SCSearchValueFilter, SCSetting} from '@openstapps/core';
import {DataProvider} from '../../../data/data.provider';
@Component({
selector: 'stapps-news-settings-filter',
templateUrl: './news-settings-filter.component.html',
styleUrls: ['./news-settings-filter.component.scss'],
})
export class NewsSettingsFilterComponent implements OnInit {
/**
* A map of the filters where the keys are settings names
*/
filtersMap = new Map<NewsFilterSettingsNames, SCSearchValueFilter>();
/**
* Emits the current filters
*/
@Output() filtersChanged = new EventEmitter<SCSearchValueFilter[]>();
/**
* Provided settings to show the filters for
*/
@Input() settings: SCSetting[];
ngOnInit() {
for (const setting of this.settings) {
this.filtersMap.set(
setting.name as NewsFilterSettingsNames,
DataProvider.createValueFilter(
newsFilterSettingsFieldsMapping[
setting.name as NewsFilterSettingsNames
],
setting.value as string,
),
);
}
this.filtersChanged.emit([...this.filtersMap.values()]);
}
/**
* To be executed when a chip filter has been enabled/disabled
*
* @param setting The value of the filter
*/
stateChanged(setting: SCSetting) {
if (
typeof this.filtersMap.get(setting.name as NewsFilterSettingsNames) !==
'undefined'
) {
this.filtersMap.delete(setting.name as NewsFilterSettingsNames);
} else {
this.filtersMap.set(
setting.name as NewsFilterSettingsNames,
DataProvider.createValueFilter(
newsFilterSettingsFieldsMapping[
setting.name as NewsFilterSettingsNames
],
setting.value as string,
),
);
}
this.filtersChanged.emit([...this.filtersMap.values()]);
}
}

View File

@@ -0,0 +1,32 @@
/*
* Copyright (C) 2021 StApps
* This program is free software: you can redistribute it and/or modify it
* under the terms of the GNU General Public License as published by the Free
* Software Foundation, version 3.
*
* This program is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
* FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
* more details.
*
* You should have received a copy of the GNU General Public License along with
* this program. If not, see <https://www.gnu.org/licenses/>.
*/
import {SCSettingCategories, SCThingsField} from '@openstapps/core';
/**
* Category of settings to use for news filter
*/
export const newsFilterSettingsCategory: SCSettingCategories = 'profile';
/**
* Settings to use for news filter
*/
export type NewsFilterSettingsNames = 'language' | 'group';
/**
* The mapping between settings and corresponding data fields for building a value filter
*/
export const newsFilterSettingsFieldsMapping: {
[key in NewsFilterSettingsNames]: SCThingsField;
} = {
language: 'inLanguage',
group: 'audiences',
};

View File

@@ -18,11 +18,15 @@ import {RouterModule, Routes} from '@angular/router';
import {IonicModule} from '@ionic/angular'; import {IonicModule} from '@ionic/angular';
import {TranslateModule} from '@ngx-translate/core'; import {TranslateModule} from '@ngx-translate/core';
import {MomentModule} from 'ngx-moment'; import {MomentModule} from 'ngx-moment';
import {ThingTranslateModule} from '../../translation/thing-translate.module';
import {DataModule} from '../data/data.module'; import {DataModule} from '../data/data.module';
import {SettingsProvider} from '../settings/settings.provider'; import {SettingsProvider} from '../settings/settings.provider';
import {NewsItemComponent} from './page/news-item.component'; import {NewsItemComponent} from './item/news-item.component';
import {NewsPageComponent} from './page/news-page.component'; import {NewsPageComponent} from './page/news-page.component';
import {SkeletonNewsItemComponent} from './page/skeleton-news-item.component'; import {SkeletonNewsItemComponent} from './item/skeleton-news-item.component';
import {ChipFilterComponent} from '../data/chips/filter/chip-filter.component';
import {SettingsModule} from '../settings/settings.module';
import {NewsSettingsFilterComponent} from './elements/news-filter-settings/news-settings-filter.component';
const newsRoutes: Routes = [{path: 'news', component: NewsPageComponent}]; const newsRoutes: Routes = [{path: 'news', component: NewsPageComponent}];
@@ -31,17 +35,21 @@ const newsRoutes: Routes = [{path: 'news', component: NewsPageComponent}];
*/ */
@NgModule({ @NgModule({
declarations: [ declarations: [
NewsItemComponent,
NewsPageComponent, NewsPageComponent,
SkeletonNewsItemComponent, SkeletonNewsItemComponent,
NewsItemComponent,
ChipFilterComponent,
NewsSettingsFilterComponent,
], ],
imports: [ imports: [
CommonModule,
DataModule,
IonicModule.forRoot(), IonicModule.forRoot(),
MomentModule,
RouterModule.forChild(newsRoutes),
TranslateModule.forChild(), TranslateModule.forChild(),
RouterModule.forChild(newsRoutes),
CommonModule,
MomentModule,
DataModule,
ThingTranslateModule,
SettingsModule,
], ],
providers: [SettingsProvider], providers: [SettingsProvider],
}) })

View File

@@ -13,7 +13,13 @@
* this program. If not, see <https://www.gnu.org/licenses/>. * this program. If not, see <https://www.gnu.org/licenses/>.
*/ */
import {Injectable} from '@angular/core'; import {Injectable} from '@angular/core';
import {SCMessage} from '@openstapps/core'; import {
SCBooleanFilterArguments,
SCMessage,
SCSearchBooleanFilter,
SCSearchFilter,
SCSearchQuery,
} from '@openstapps/core';
import {DataProvider} from '../data/data.provider'; import {DataProvider} from '../data/data.provider';
/** /**
* Service for providing news messages * Service for providing news messages
@@ -22,34 +28,59 @@ import {DataProvider} from '../data/data.provider';
providedIn: 'root', providedIn: 'root',
}) })
export class NewsProvider { export class NewsProvider {
constructor(private dataProvider: DataProvider) { constructor(private dataProvider: DataProvider) {}
}
/** /**
* Get news messages * Get news messages
* *
* @param size How many messages/news to fetch * @param size How many messages/news to fetch
* @param from From which (results) page to start * @param from From which (results) page to start
* @param filters Additional filters to apply
*/ */
async getList(size: number, from: number): Promise<SCMessage[]> { async getList(
const result = await this.dataProvider.search({ size: number,
from: number,
filters?: SCSearchFilter[],
): Promise<SCMessage[]> {
const query: SCSearchQuery = {
filter: { filter: {
type: 'boolean',
arguments: {
filters: [
{
type: 'value', type: 'value',
arguments: { arguments: {
field: 'type', field: 'type',
value: 'message', value: 'message',
}, },
}, },
sort: [{ ],
operation: 'and',
},
},
sort: [
{
type: 'generic', type: 'generic',
arguments: { arguments: {
field: 'datePublished', field: 'datePublished',
}, },
order: 'desc', order: 'desc',
}], },
],
size: size, size: size,
from: from, from: from,
}); };
if (typeof filters !== 'undefined') {
for (const filter of filters) {
(
(query.filter as SCSearchBooleanFilter)
.arguments as SCBooleanFilterArguments
).filters.push(filter);
}
}
const result = await this.dataProvider.search(query);
return result.data as SCMessage[]; return result.data as SCMessage[];
} }

View File

@@ -12,9 +12,20 @@
* You should have received a copy of the GNU General Public License along with * You should have received a copy of the GNU General Public License along with
* this program. If not, see <https://www.gnu.org/licenses/>. * this program. If not, see <https://www.gnu.org/licenses/>.
*/ */
import {Component} from '@angular/core'; import {Component, OnInit} from '@angular/core';
import {IonRefresher} from '@ionic/angular'; import {IonRefresher} from '@ionic/angular';
import {SCMessage} from '@openstapps/core'; import {
SCMessage,
SCSearchFilter,
SCSearchValueFilter,
SCSetting,
} from '@openstapps/core';
import {SettingsProvider} from '../../settings/settings.provider';
import {
newsFilterSettingsCategory,
newsFilterSettingsFieldsMapping,
NewsFilterSettingsNames,
} from '../news-filter-settings';
import {NewsProvider} from '../news.provider'; import {NewsProvider} from '../news.provider';
/** /**
* News page component * News page component
@@ -23,46 +34,86 @@ import {NewsProvider} from '../news.provider';
selector: 'stapps-news-page', selector: 'stapps-news-page',
templateUrl: 'news-page.html', templateUrl: 'news-page.html',
}) })
export class NewsPageComponent { export class NewsPageComponent implements OnInit {
/** /**
* Thing counter to start query the next page from * Thing counter to start query the next page from
*/ */
from = 0; from = 0;
/**
* Page size of queries
*/
pageSize = 10;
/** /**
* News (messages) to show * News (messages) to show
*/ */
news: SCMessage[] = []; news: SCMessage[] = [];
constructor(private newsProvider: NewsProvider) {} /**
* Page size of queries
*/
pageSize = 10;
/**
* Relevant settings
*/
settings: SCSetting[];
/**
* Active filters
*/
filters: SCSearchFilter[];
constructor(
private newsProvider: NewsProvider,
private settingsProvider: SettingsProvider,
) {}
/** /**
* Fetch news from the backend * Fetch news from the backend
*/ */
async fetchNews() { async fetchNews() {
this.news = await this.newsProvider.getList(this.pageSize, this.from); this.from = 0;
this.news = await this.newsProvider.getList(this.pageSize, this.from, [
...this.filters,
]);
} }
/** /**
* Loads more news * Loads more news
* *
* @param event Signal from the infinite scroll to load more data * @param infiniteScrollElement Infinite scroll element
*/ */
// tslint:disable-next-line:no-any async loadMore(
async loadMore(event: any): Promise<void> { infiniteScrollElement: HTMLIonInfiniteScrollElement,
): Promise<void> {
this.from += this.pageSize; this.from += this.pageSize;
this.news = this.news.concat(await this.newsProvider.getList(this.pageSize, this.from)); this.news = [
event.target.complete(); ...this.news,
...(await this.newsProvider.getList(this.pageSize, this.from, [
...this.filters,
])),
];
await infiniteScrollElement.complete();
} }
/** /**
* Initialize the local variables on component initialization * Initialize the local variables on component initialization
*/ */
ngOnInit() { async ngOnInit() {
void this.fetchNews(); // Helper method to provide the relevant settings
const getNewsSettings = async (settingNames: NewsFilterSettingsNames[]) => {
const settings = [];
for (const settingName of settingNames) {
settings.push(
await this.settingsProvider.getSetting(
newsFilterSettingsCategory,
settingName,
),
);
}
return settings;
};
this.settings = await getNewsSettings(
Object.keys(newsFilterSettingsFieldsMapping) as NewsFilterSettingsNames[],
);
} }
/** /**
@@ -72,12 +123,21 @@ export class NewsPageComponent {
*/ */
async refresh(refresher: IonRefresher) { async refresh(refresher: IonRefresher) {
try { try {
this.from = 0;
await this.fetchNews(); await this.fetchNews();
} catch (e) { } catch {
this.news = []; this.news = [];
} finally { } finally {
await refresher.complete(); await refresher.complete();
} }
} }
/**
* Executed when filters have been changed
*
* @param filters Current filters to be used
*/
toggleFilter(filters: SCSearchValueFilter[]) {
this.filters = filters;
void this.fetchNews();
}
} }

View File

@@ -4,19 +4,31 @@
<ion-back-button></ion-back-button> <ion-back-button></ion-back-button>
<ion-menu-button></ion-menu-button> <ion-menu-button></ion-menu-button>
</ion-buttons> </ion-buttons>
<ion-title>{{'news.title' | translate}}</ion-title> <ion-title>{{ 'news.title' | translate }}</ion-title>
</ion-toolbar> </ion-toolbar>
</ion-header> </ion-header>
<ion-content fullscreen> <ion-content fullscreen>
<ion-refresher slot="fixed" (ionRefresh)="refresh($event.target)"> <ion-refresher slot="fixed" (ionRefresh)="refresh($event.target)">
<ion-refresher-content pullingIcon="chevron-down-outline" pullingText="{{'data.REFRESH_ACTION' | translate}}" <ion-refresher-content
refreshingText="{{'data.REFRESHING' | translate}}" pullingIcon="chevron-down-outline"
refreshingSpinner="crescent"> pullingText="{{ 'data.REFRESH_ACTION' | translate }}"
refreshingText="{{ 'data.REFRESHING' | translate }}"
refreshingSpinner="crescent"
>
</ion-refresher-content> </ion-refresher-content>
</ion-refresher> </ion-refresher>
<ion-grid> <ion-grid>
<ion-row *ngIf="news.length === 0"> <ion-row>
<ion-col size="12">
<stapps-news-settings-filter
*ngIf="settings"
[settings]="settings"
(filtersChanged)="toggleFilter($event)"
></stapps-news-settings-filter>
</ion-col>
</ion-row>
<ion-row *ngIf="!news">
<ion-col size="12" size-md="6" *ngFor="let skeleton of [1, 2, 3, 4, 5]"> <ion-col size="12" size-md="6" *ngFor="let skeleton of [1, 2, 3, 4, 5]">
<stapps-skeleton-news-item></stapps-skeleton-news-item> <stapps-skeleton-news-item></stapps-skeleton-news-item>
</ion-col> </ion-col>
@@ -27,7 +39,14 @@
</ion-col> </ion-col>
</ion-row> </ion-row>
</ion-grid> </ion-grid>
<ion-infinite-scroll id="infinite-scroll" threshold="20%" (ionInfinite)="loadMore($event)"> <ion-label *ngIf="news.length === 0" class="notFoundContainer">
{{ 'search.nothing_found' | translate | titlecase }}
</ion-label>
<ion-infinite-scroll
id="infinite-scroll"
threshold="20%"
(ionInfinite)="loadMore($event.target)"
>
<ion-infinite-scroll-content loading-spinner="crescent"> <ion-infinite-scroll-content loading-spinner="crescent">
</ion-infinite-scroll-content> </ion-infinite-scroll-content>
</ion-infinite-scroll> </ion-infinite-scroll>

View File

@@ -0,0 +1,35 @@
import {Pipe, PipeTransform} from '@angular/core';
import {TranslateService} from '@ngx-translate/core';
import {SCSetting} from '@openstapps/core';
import {ThingTranslatePipe} from '../../translation/thing-translate.pipe';
import {ThingTranslateService} from '../../translation/thing-translate.service';
/**
* Translates a setting value (into the display value in current language)
*/
@Pipe({
name: 'settingValueTranslate',
})
export class SettingTranslatePipe implements PipeTransform {
constructor(
private readonly translate: TranslateService,
private readonly thingTranslate: ThingTranslateService,
) {}
transform(setting: SCSetting) {
const thingTranslatePipe = new ThingTranslatePipe(
this.translate,
this.thingTranslate,
);
const translatedSettingValues = thingTranslatePipe.transform(
'values',
setting,
);
return translatedSettingValues
? translatedSettingValues[
setting.values?.indexOf(setting.value as string) as number
]
: undefined;
}
}

View File

@@ -23,6 +23,7 @@ import {ThingTranslateModule} from '../../translation/thing-translate.module';
import {ConfigProvider} from '../config/config.provider'; import {ConfigProvider} from '../config/config.provider';
import {SettingsItemComponent} from './item/settings-item.component'; import {SettingsItemComponent} from './item/settings-item.component';
import {SettingsPageComponent} from './page/settings-page.component'; import {SettingsPageComponent} from './page/settings-page.component';
import {SettingTranslatePipe} from './setting-translate.pipe';
import {SettingsProvider} from './settings.provider'; import {SettingsProvider} from './settings.provider';
const settingsRoutes: Routes = [ const settingsRoutes: Routes = [
@@ -33,15 +34,19 @@ const settingsRoutes: Routes = [
* Settings Module * Settings Module
*/ */
@NgModule({ @NgModule({
declarations: [SettingsPageComponent, SettingsItemComponent], declarations: [
exports: [SettingsItemComponent], SettingsPageComponent,
SettingsItemComponent,
SettingTranslatePipe,
],
exports: [SettingsItemComponent, SettingTranslatePipe],
imports: [ imports: [
CommonModule, CommonModule,
FormsModule, FormsModule,
IonicModule.forRoot(), IonicModule.forRoot(),
RouterModule.forChild(settingsRoutes),
ThingTranslateModule.forChild(),
TranslateModule.forChild(), TranslateModule.forChild(),
ThingTranslateModule.forChild(),
RouterModule.forChild(settingsRoutes),
], ],
providers: [ConfigProvider, SettingsProvider], providers: [ConfigProvider, SettingsProvider],
}) })

View File

@@ -32,6 +32,14 @@ ion-item {
} }
} }
ion-item, ion-card.compact {
ion-grid, ion-col {
padding-inline-start: 0;
padding-top: 0;
padding-bottom: 0;
}
}
.notFoundContainer { .notFoundContainer {
display: flex; display: flex;
flex-direction: column; flex-direction: column;