Skip to content

📚 The open-source, offline-first Notion, Obsidian & Confluence alternative. Advanced Markdown, multi-tenant teams, OIDC/SSO, and local S3 backups. Deploy in one command.

feat: implement NodeTagList component for tag display and filtering (#581)

Nipun Milinda Kumara87368b29e03e
diff --git a/frontend/app/components/Node/Card/NodeCard.vue b/frontend/app/components/Node/Card/NodeCard.vue
index 0e1a0ca4..aa7d815a 100644
--- a/frontend/app/components/Node/Card/NodeCard.vue
+++ b/frontend/app/components/Node/Card/NodeCard.vue
@@ -10,9 +10,7 @@
</div>
<div class="body">
<div class="category">{{ category?.name }}</div>
- <div v-if="node.tags" class="tags">
- <tag v-for="tag in node.tags.split(',')" :key="tag" class="primary">{{ tag.trim() }}</tag>
- </div>
+ <NodeTagList v-if="node.tags" :tags="node.tags" class="tags" />
<p class="description" v-text="node.description" />
</div>
</div>
diff --git a/frontend/app/components/Node/Document/Header.vue b/frontend/app/components/Node/Document/Header.vue
index 7fb1db68..072d9cd9 100644
--- a/frontend/app/components/Node/Document/Header.vue
+++ b/frontend/app/components/Node/Document/Header.vue
@@ -22,9 +22,7 @@
{{ doc.name }}
</Teleport>
<p class="description">{{ doc?.description }}</p>
- <div v-if="doc.tags" class="tags">
- <tag v-for="tag in doc.tags.split(',')" :key="tag" class="primary">{{ tag.trim() }}</tag>
- </div>
+ <NodeTagList v-if="doc.tags" :tags="doc.tags" :clickable="!public" class="tags" />
</div>
<div class="thumbnail">
<NodeDocumentThumbnail :document="doc" />
diff --git a/frontend/app/components/Node/Filter.vue b/frontend/app/components/Node/Filter.vue
index 5b6f7c83..51b8bf7b 100644
--- a/frontend/app/components/Node/Filter.vue
+++ b/frontend/app/components/Node/Filter.vue
@@ -12,6 +12,12 @@
<input ref="inputRef" v-model="options.query" />
</div>
+ <!-- Tags -->
+ <div>
+ <label>{{ t('components.filter.tags') }}</label>
+ <AppTagInput :model-value="(options.tags || []).join(',')" @update:model-value="options.tags = parseTags($event)" />
+ </div>
+
<!-- Sort & Match -->
<div class="row">
<label class="row">
@@ -49,6 +55,7 @@
</template>
<script setup lang="ts">
+import { parseTags } from '~/helpers/node';
import type { Node, SearchOptions } from '~/stores';
const props = defineProps<{ nodes: Node[] }>();
@@ -56,6 +63,7 @@ const emit = defineEmits<{ (e: 'update:nodes', v: Node[]): void }>();
const DEFAULT_OPTIONS: SearchOptions = {
query: '',
+ tags: [],
sortType: 'descending',
sortBy: 'created',
matchMode: 'includes',
@@ -63,8 +71,10 @@ const DEFAULT_OPTIONS: SearchOptions = {
const { t } = useI18nT();
const store = useNodesStore();
+const route = useRoute();
+const router = useRouter();
-const options = ref({ ...DEFAULT_OPTIONS });
+const options = ref<SearchOptions>({ ...DEFAULT_OPTIONS, tags: [] });
const opened = ref<boolean>(false);
const inputRef = ref<HTMLInputElement | null>(null);
const root = ref<HTMLDivElement | null>(null);
@@ -90,7 +100,21 @@ const toggle = () => {
const close = () => (opened.value = false);
-const reset = () => (options.value = { ...DEFAULT_OPTIONS });
+const reset = () => {
+ options.value = { ...DEFAULT_OPTIONS, tags: [] };
+ if (route.query.tags) router.replace({ query: { ...route.query, tags: undefined } });
+};
+
+// Initialize tags from the URL (e.g. /dashboard/docs?tags=foo) and react to later changes
+watch(
+ () => route.query.tags,
+ queryTags => {
+ if (!queryTags) return;
+ const raw = Array.isArray(queryTags) ? queryTags.filter(Boolean).map(String) : String(queryTags).split(',');
+ options.value.tags = raw.map(tag => tag.trim()).filter(Boolean);
+ },
+ { immediate: true },
+);
const focusInput = () => nextTick(() => inputRef.value?.focus());
diff --git a/frontend/app/components/Node/List/Inline.vue b/frontend/app/components/Node/List/Inline.vue
index c337011a..1e1777db 100644
--- a/frontend/app/components/Node/List/Inline.vue
+++ b/frontend/app/components/Node/List/Inline.vue
@@ -11,9 +11,7 @@
</div>
<NodeActionDotMenu :node="document" :user="user" @delete="deleteDoc" />
</header>
- <div v-if="document.tags" class="tags">
- <tag v-for="tag in document.tags?.split(', ')" :key="tag" class="primary">{{ tag }}</tag>
- </div>
+ <NodeTagList v-if="document.tags" :tags="document.tags" class="tags" />
<p class="desc">{{ document.description }}</p>
<footer>
<svg xmlns="http://www.w3.org/2000/svg" height="20px" viewBox="0 -960 960 960" width="20px" fill="var(--text-body)">
diff --git a/frontend/app/components/Node/TagList.vue b/frontend/app/components/Node/TagList.vue
new file mode 100644
index 00000000..d6397c1f
--- /dev/null
+++ b/frontend/app/components/Node/TagList.vue
@@ -0,0 +1,37 @@
+<template>
+ <div v-if="parsedTags.length" class="tags">
+ <tag v-for="tag in parsedTags" :key="tag" class="primary" :class="{ clickable }" @click="onClick($event, tag)">{{ tag }}</tag>
+ </div>
+</template>
+
+<script setup lang="ts">
+import { parseTags } from '~/helpers/node';
+
+const props = withDefaults(defineProps<{ tags?: string; clickable?: boolean }>(), { tags: '', clickable: true });
+
+const router = useRouter();
+
+const parsedTags = computed(() => parseTags(props.tags));
+
+function onClick(event: MouseEvent, tag: string) {
+ if (!props.clickable) return;
+ event.preventDefault();
+ event.stopPropagation();
+ router.push({ path: '/dashboard/docs', query: { tags: tag } });
+}
+</script>
+
+<style scoped lang="scss">
+.tags {
+ display: flex;
+ flex-wrap: wrap;
+}
+
+.clickable {
+ cursor: pointer;
+
+ &:hover {
+ text-decoration: underline;
+ }
+}
+</style>
diff --git a/frontend/i18n/locales/de/components.ts b/frontend/i18n/locales/de/components.ts
index d57dd64c..aa2c4693 100644
--- a/frontend/i18n/locales/de/components.ts
+++ b/frontend/i18n/locales/de/components.ts
@@ -55,6 +55,7 @@ export default {
contains: 'Enthält',
startsWith: 'Beginnt mit',
exact: 'Exakte Übereinstimmung',
+ tags: 'Tags',
},
kanban: {
diff --git a/frontend/i18n/locales/en/components.ts b/frontend/i18n/locales/en/components.ts
index 88de1638..80cee3d4 100644
--- a/frontend/i18n/locales/en/components.ts
+++ b/frontend/i18n/locales/en/components.ts
@@ -55,6 +55,7 @@ export default {
contains: 'Contains',
startsWith: 'Starts with',
exact: 'Exact match',
+ tags: 'Tags',
},
kanban: {
diff --git a/frontend/i18n/locales/fr/components.ts b/frontend/i18n/locales/fr/components.ts
index 87fd6236..75eeeab2 100644
--- a/frontend/i18n/locales/fr/components.ts
+++ b/frontend/i18n/locales/fr/components.ts
@@ -55,6 +55,7 @@ export default {
contains: 'Contient',
startsWith: 'Commence par',
exact: 'Correspondance exacte',
+ tags: 'Tags',
},
kanban: {
diff --git a/frontend/i18n/locales/ko/components.ts b/frontend/i18n/locales/ko/components.ts
index 75442e71..9eaba95c 100644
--- a/frontend/i18n/locales/ko/components.ts
+++ b/frontend/i18n/locales/ko/components.ts
@@ -55,6 +55,7 @@ export default {
contains: '포함',
startsWith: '시작 문자열',
exact: '정확히 일치',
+ tags: '태그',
},
kanban: {
diff --git a/frontend/i18n/locales/uk/components.ts b/frontend/i18n/locales/uk/components.ts
index 9fb070b0..159e2620 100644
--- a/frontend/i18n/locales/uk/components.ts
+++ b/frontend/i18n/locales/uk/components.ts
@@ -55,6 +55,7 @@ export default {
contains: 'Містить',
startsWith: 'Починається з',
exact: 'Точне співпадіння',
+ tags: 'Теги',
},
kanban: {