From 9d4b52fe07fa1af346f0d9b5b3ae48d228c09908 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Tu=C4=9F=C3=A7e=20K=C3=BC=C3=A7=C3=BCko=C4=9Flu?=
 <tugcekucukoglu.860@gmail.com>
Date: Thu, 31 Aug 2023 16:23:35 +0300
Subject: [PATCH] TabMenu router docs added

---
 doc/tabmenu/BasicDoc.vue  | 112 ++++++++++++---
 doc/tabmenu/RouterDoc.vue | 293 ++++++++++++++++++++++++++++++++++++++
 pages/tabmenu.vue         |   6 +
 3 files changed, 390 insertions(+), 21 deletions(-)
 create mode 100644 doc/tabmenu/RouterDoc.vue

diff --git a/doc/tabmenu/BasicDoc.vue b/doc/tabmenu/BasicDoc.vue
index ff9985033..9110bc73e 100644
--- a/doc/tabmenu/BasicDoc.vue
+++ b/doc/tabmenu/BasicDoc.vue
@@ -1,9 +1,18 @@
 <template>
     <DocSectionText v-bind="$attrs">
-        <p>Steps requires a collection of menuitems as its <i>model</i>. TabMenu can be also integrated with Vue Router.</p>
+        <p>TabMenu requires a collection of menuitems as its <i>model</i>.</p>
     </DocSectionText>
     <div class="card">
-        <TabMenu :model="items" />
+        <TabMenu v-model:activeIndex="active" :model="items">
+            <template #item="{ label, item, props }">
+                <router-link v-if="item.route" v-slot="routerProps" :to="item.route" custom>
+                    <a :href="routerProps.href" v-bind="props.action" @click="($event) => routerProps.navigate($event)" @keydown.enter.space="($event) => routerProps.navigate($event)">
+                        <span v-bind="props.icon" />
+                        <span v-bind="props.label">{{ label }}</span>
+                    </a>
+                </router-link>
+            </template>
+        </TabMenu>
         <router-view />
     </div>
     <DocSectionCode :code="code" />
@@ -13,19 +22,38 @@
 export default {
     data() {
         return {
+            active: 0,
             items: [
-                { label: 'Home', icon: 'pi pi-fw pi-home', to: '/tabmenu' },
-                { label: 'Calendar', icon: 'pi pi-fw pi-calendar', to: '/tabmenu/calendar' },
-                { label: 'Edit', icon: 'pi pi-fw pi-pencil', to: '/tabmenu/edit' },
-                { label: 'Documentation', icon: 'pi pi-fw pi-file', to: '/tabmenu/documentation' },
-                { label: 'Settings', icon: 'pi pi-fw pi-cog', to: '/tabmenu/settings' }
+                { label: 'Home', icon: 'pi pi-fw pi-home', route: '/tabmenu' },
+                { label: 'Calendar', icon: 'pi pi-fw pi-calendar', route: '/tabmenu/calendar' },
+                { label: 'Edit', icon: 'pi pi-fw pi-pencil', route: '/tabmenu/edit' },
+                { label: 'Documentation', icon: 'pi pi-fw pi-file', route: '/tabmenu/documentation' },
+                { label: 'Settings', icon: 'pi pi-fw pi-cog', route: '/tabmenu/settings' }
             ],
             code: {
-                basic: `<TabMenu :model="items" />
+                basic: `<TabMenu v-model:activeIndex="active" :model="items">
+    <template #item="{ label, item, props }">
+        <router-link v-if="item.route" v-slot="routerProps" :to="item.route" custom>
+            <a :href="routerProps.href" v-bind="props.action" @click="($event) => routerProps.navigate($event)" @keydown.enter.space="($event) => routerProps.navigate($event)">
+                <span v-bind="props.icon" />
+                <span v-bind="props.label">{{ label }}</span>
+            </a>
+        </router-link>
+    </template>
+</TabMenu>
 <router-view />`,
                 options: `<template>
     <div class="card">
-        <TabMenu :model="items" />
+        <TabMenu v-model:activeIndex="active" :model="items">
+            <template #item="{ label, item, props }">
+                <router-link v-if="item.route" v-slot="routerProps" :to="item.route" custom>
+                    <a :href="routerProps.href" v-bind="props.action" @click="($event) => routerProps.navigate($event)" @keydown.enter.space="($event) => routerProps.navigate($event)">
+                        <span v-bind="props.icon" />
+                        <span v-bind="props.label">{{ label }}</span>
+                    </a>
+                </router-link>
+            </template>
+        </TabMenu>
         <router-view />
     </div>
 </template>
@@ -34,75 +62,109 @@ export default {
 export default {
     data() {
         return {
+            active: 0,
             items: [
                 {
                     label: 'Home',
                     icon: 'pi pi-fw pi-home',
-                    to: '/'
+                    route: '/'
                 },
                 {
                     label: 'Calendar',
                     icon: 'pi pi-fw pi-calendar',
-                    to: '/calendar'
+                    route: '/calendar'
                 },
                 {
                     label: 'Edit',
                     icon: 'pi pi-fw pi-pencil',
-                    to: '/edit'
+                    route: '/edit'
                 },
                 {
                     label: 'Documentation',
                     icon: 'pi pi-fw pi-file',
-                    to: '/documentation'
+                    route: '/documentation'
                 },
                 {
                     label: 'Settings',
                     icon: 'pi pi-fw pi-cog',
-                    to: '/settings'
+                    route: '/settings'
                 }
             ]
         }
+    },
+    watch: {
+        $route() {
+            this.active = this.items.findIndex((item) => this.$route.path === this.$router.resolve(item.route).path);
+        }
+    },
+    mounted() {
+        this.active = this.items.findIndex((item) => this.$route.path === this.$router.resolve(item.route).path);
     }
 }
 <\/script>`,
                 composition: `<template>
     <div class="card">
-        <TabMenu :model="items" />
+        <TabMenu v-model:activeIndex="active" :model="items">
+            <template #item="{ label, item, props }">
+                <router-link v-if="item.route" v-slot="routerProps" :to="item.route" custom>
+                    <a :href="routerProps.href" v-bind="props.action" @click="($event) => routerProps.navigate($event)" @keydown.enter.space="($event) => routerProps.navigate($event)">
+                        <span v-bind="props.icon" />
+                        <span v-bind="props.label">{{ label }}</span>
+                    </a>
+                </router-link>
+            </template>
+        </TabMenu>
         <router-view />
     </div>
 </template>
 
 <script setup>
-import { ref } from "vue";
+import { ref, onMounted } from "vue";
+import { useRouter, useRoute } from "vue-router";
 
+const router = useRouter();
+const route = useRoute();
+
+const actvie = ref(0);
 const items = ref([
     {
         label: 'Home',
         icon: 'pi pi-fw pi-home',
-        to: '/'
+        route: '/'
     },
     {
         label: 'Calendar',
         icon: 'pi pi-fw pi-calendar',
-        to: '/calendar'
+        route: '/calendar'
     },
     {
         label: 'Edit',
         icon: 'pi pi-fw pi-pencil',
-        to: '/edit'
+        route: '/edit'
     },
     {
         label: 'Documentation',
         icon: 'pi pi-fw pi-file',
-        to: '/documentation'
+        route: '/documentation'
     },
     {
         label: 'Settings',
         icon: 'pi pi-fw pi-cog',
-        to: '/settings'
+        route: '/settings'
     }
 ]);
 
+onMounted(() => {
+    active.value = items.value.findIndex((item) => route.path === router.resolve(item.route).path);
+})
+
+watch(
+    route,
+    () => {
+        active.value = items.value.findIndex((item) => route.path === router.resolve(item.route).path);
+    },
+    { immediate: true }
+);
 <\/script>`,
                 pages: [
                     {
@@ -187,6 +249,14 @@ export default {
                 ]
             }
         };
+    },
+    watch: {
+        $route() {
+            this.active = this.items.findIndex((item) => this.$route.path === this.$router.resolve(item.route).path);
+        }
+    },
+    mounted() {
+        this.active = this.items.findIndex((item) => this.$route.path === this.$router.resolve(item.route).path);
     }
 };
 </script>
diff --git a/doc/tabmenu/RouterDoc.vue b/doc/tabmenu/RouterDoc.vue
new file mode 100644
index 000000000..80adfc59f
--- /dev/null
+++ b/doc/tabmenu/RouterDoc.vue
@@ -0,0 +1,293 @@
+<template>
+    <DocSectionText v-bind="$attrs">
+        <p>
+            Since v3.33.0 the vue-router dependency of menu components is deprecated and templating should be used to define router links instead. This approach provides flexibility to be able to use any kind of router link component such as
+            <i>NuxtLink</i> or <i>router-link</i>. Here is an example with vue-router.
+        </p>
+    </DocSectionText>
+    <div class="card">
+        <TabMenu v-model:activeIndex="active" :model="items">
+            <template #item="{ label, item, props }">
+                <router-link v-if="item.route" v-slot="routerProps" :to="item.route" custom>
+                    <a :href="routerProps.href" v-bind="props.action" @click="($event) => routerProps.navigate($event)" @keydown.enter.space="($event) => routerProps.navigate($event)">
+                        <span v-bind="props.icon" />
+                        <span v-bind="props.label">{{ label }}</span>
+                    </a>
+                </router-link>
+                <a v-else :href="item.url" :target="item.target" v-bind="props.action">
+                    <span v-bind="props.icon" />
+                    <span v-bind="props.label">{{ label }}</span>
+                </a>
+            </template>
+        </TabMenu>
+        <router-view />
+    </div>
+    <DocSectionCode :code="code" />
+</template>
+
+<script>
+export default {
+    data() {
+        return {
+            active: 0,
+            items: [
+                { label: 'Home', icon: 'pi pi-fw pi-home', route: '/tabmenu' },
+                { label: 'Calendar', icon: 'pi pi-fw pi-calendar', route: '/tabmenu/calendar' },
+                { label: 'Edit', icon: 'pi pi-fw pi-pencil', route: '/tabmenu/edit' },
+                { label: 'Documentation', icon: 'pi pi-fw pi-file', route: '/tabmenu/documentation' },
+                { label: 'Settings', icon: 'pi pi-fw pi-cog', route: '/tabmenu/settings' },
+                { label: 'FileUpload', icon: 'pi pi-fw pi-upload', url: '/fileupload' }
+            ],
+            code: {
+                basic: `<TabMenu v-model:activeIndex="active" :model="items">
+    <template #item="{ label, item, props }">
+        <router-link v-if="item.route" v-slot="routerProps" :to="item.route" custom>
+            <a :href="routerProps.href" v-bind="props.action" @click="($event) => routerProps.navigate($event)" @keydown.enter.space="($event) => routerProps.navigate($event)">
+                <span v-bind="props.icon" />
+                <span v-bind="props.label">{{ label }}</span>
+            </a>
+        </router-link>
+        <a v-else :href="item.url" :target="item.target" v-bind="props.action">
+            <span v-bind="props.icon" />
+            <span v-bind="props.label">{{ label }}</span>
+        </a>
+    </template>
+</TabMenu>
+<router-view />`,
+                options: `<template>
+    <div class="card">
+        <TabMenu v-model:activeIndex="active" :model="items">
+            <template #item="{ label, item, props }">
+                <router-link v-if="item.route" v-slot="routerProps" :to="item.route" custom>
+                    <a :href="routerProps.href" v-bind="props.action" @click="($event) => routerProps.navigate($event)" @keydown.enter.space="($event) => routerProps.navigate($event)">
+                        <span v-bind="props.icon" />
+                        <span v-bind="props.label">{{ label }}</span>
+                    </a>
+                </router-link>
+                <a v-else :href="item.url" :target="item.target" v-bind="props.action">
+                    <span v-bind="props.icon" />
+                    <span v-bind="props.label">{{ label }}</span>
+                </a>
+            </template>
+        </TabMenu>
+        <router-view />
+    </div>
+</template>
+
+<script>
+export default {
+    data() {
+        return {
+            active: 0,
+            items: [
+                {
+                    label: 'Home',
+                    icon: 'pi pi-fw pi-home',
+                    route: '/'
+                },
+                {
+                    label: 'Calendar',
+                    icon: 'pi pi-fw pi-calendar',
+                    route: '/calendar'
+                },
+                {
+                    label: 'Edit',
+                    icon: 'pi pi-fw pi-pencil',
+                    route: '/edit'
+                },
+                {
+                    label: 'Documentation',
+                    icon: 'pi pi-fw pi-file',
+                    route: '/documentation'
+                },
+                {
+                    label: 'Settings',
+                    icon: 'pi pi-fw pi-cog',
+                    route: '/settings'
+                },
+                { 
+                    label: 'FileUpload',
+                    icon: 'pi pi-fw pi-upload',
+                    url: '/fileupload'
+                }
+            ]
+        }
+    },
+    watch: {
+        $route() {
+            this.active = this.items.findIndex((item) => this.$route.path === this.$router.resolve(item.route).path);
+        }
+    },
+    mounted() {
+        this.active = this.items.findIndex((item) => this.$route.path === this.$router.resolve(item.route).path);
+    }
+}
+<\/script>`,
+                composition: `<template>
+    <div class="card">
+        <TabMenu v-model:activeIndex="active" :model="items">
+            <template #item="{ label, item, props }">
+                <router-link v-if="item.route" v-slot="routerProps" :to="item.route" custom>
+                    <a :href="routerProps.href" v-bind="props.action" @click="($event) => routerProps.navigate($event)" @keydown.enter.space="($event) => routerProps.navigate($event)">
+                        <span v-bind="props.icon" />
+                        <span v-bind="props.label">{{ label }}</span>
+                    </a>
+                </router-link>
+                <a v-else :href="item.url" :target="item.target" v-bind="props.action">
+                    <span v-bind="props.icon" />
+                    <span v-bind="props.label">{{ label }}</span>
+                </a>
+            </template>
+        </TabMenu>
+        <router-view />
+    </div>
+</template>
+
+<script setup>
+import { ref, onMounted } from "vue";
+import { useRouter, useRoute } from "vue-router";
+
+const router = useRouter();
+const route = useRoute();
+
+const actvie = ref(0);
+const items = ref([
+    {
+        label: 'Home',
+        icon: 'pi pi-fw pi-home',
+        route: '/'
+    },
+    {
+        label: 'Calendar',
+        icon: 'pi pi-fw pi-calendar',
+        route: '/calendar'
+    },
+    {
+        label: 'Edit',
+        icon: 'pi pi-fw pi-pencil',
+        route: '/edit'
+    },
+    {
+        label: 'Documentation',
+        icon: 'pi pi-fw pi-file',
+        route: '/documentation'
+    },
+    {
+        label: 'Settings',
+        icon: 'pi pi-fw pi-cog',
+        route: '/settings'
+    },
+    { 
+        label: 'FileUpload',
+        icon: 'pi pi-fw pi-upload',
+        url: '/fileupload'
+    }
+]);
+
+onMounted(() => {
+    active.value = items.value.findIndex((item) => route.path === router.resolve(item.route).path);
+})
+
+watch(
+    route,
+    () => {
+        active.value = items.value.findIndex((item) => route.path === router.resolve(item.route).path);
+    },
+    { immediate: true }
+);
+
+<\/script>`,
+                pages: [
+                    {
+                        tabName: 'HomeDemo',
+                        content: `
+<template>
+    <div class="p-4">
+        <h5>Home Component Content</h5>
+    </div>
+</template>
+
+<script>
+export default {
+
+}
+<\/script>
+`
+                    },
+                    {
+                        tabName: 'CalendarDemo',
+                        content: `
+<template>
+    <div class="p-4">
+        <h5>Calendar Component Content</h5>
+    </div>
+</template>
+
+<script>
+export default {
+
+}
+<\/script>
+`
+                    },
+                    {
+                        tabName: 'EditDemo',
+                        content: `
+<template>
+    <div class="p-4">
+        <h5>Edit Component Content</h5>
+    </div>
+</template>
+
+<script>
+export default {
+
+}
+<\/script>
+`
+                    },
+                    {
+                        tabName: 'DocumentationDemo',
+                        content: `
+<template>
+    <div class="p-4">
+        <h5>Documentation Component Content</h5>
+    </div>
+</template>
+
+<script>
+export default {
+
+}
+<\/script>
+`
+                    },
+                    {
+                        tabName: 'SettingsDemo',
+                        content: `
+<template>
+    <div class="p-4">
+        <h5>Settings Component Content</h5>
+    </div>
+</template>
+
+<script>
+export default {
+
+}
+<\/script>`
+                    }
+                ]
+            }
+        };
+    },
+    watch: {
+        $route() {
+            this.active = this.items.findIndex((item) => this.$route.path === this.$router.resolve(item.route).path);
+        }
+    },
+    mounted() {
+        this.active = this.items.findIndex((item) => this.$route.path === this.$router.resolve(item.route).path);
+    }
+};
+</script>
diff --git a/pages/tabmenu.vue b/pages/tabmenu.vue
index 32f81d96e..94f529e0e 100755
--- a/pages/tabmenu.vue
+++ b/pages/tabmenu.vue
@@ -17,6 +17,7 @@ import AccessibilityDoc from '../doc/tabmenu/AccessibilityDoc.vue';
 import BasicDoc from '../doc/tabmenu/BasicDoc.vue';
 import ControlledDoc from '../doc/tabmenu/ControlledDoc.vue';
 import ImportDoc from '../doc/tabmenu/ImportDoc.vue';
+import RouterDoc from '../doc/tabmenu/RouterDoc.vue';
 
 export default {
     data() {
@@ -37,6 +38,11 @@ export default {
                     label: 'Controlled',
                     component: ControlledDoc
                 },
+                {
+                    id: 'router',
+                    label: 'Router',
+                    component: RouterDoc
+                },
                 {
                     id: 'accessibility',
                     label: 'Accessibility',