From a87eb43d44d3aa91044e137634fda9089a4dd2cf Mon Sep 17 00:00:00 2001
From: J-Sek <J-Sek@users.noreply.github.com>
Date: Mon, 8 Sep 2025 11:50:20 +0200
Subject: [PATCH] feat(VTreeview): add `no-data` slot

---
 packages/docs/src/data/new-in.json            |   3 +
 .../src/examples/v-treeview/slot-no-data.vue  | 188 ++++++++++++++++++
 .../docs/src/pages/en/components/treeview.md  |   6 +
 .../src/components/VTreeview/VTreeview.tsx    |  15 +-
 4 files changed, 211 insertions(+), 1 deletion(-)
 create mode 100644 packages/docs/src/examples/v-treeview/slot-no-data.vue

diff --git a/packages/docs/src/data/new-in.json b/packages/docs/src/data/new-in.json
index 1557a31166f..02f16141a9d 100644
--- a/packages/docs/src/data/new-in.json
+++ b/packages/docs/src/data/new-in.json
@@ -279,12 +279,15 @@
   "VTreeview": {
     "props": {
       "hideActions": "3.9.0",
+      "hideNoData": "3.10.0",
+      "noDataText": "3.10.0",
       "separateRoots": "3.9.0",
       "indentLines": "3.9.0"
     },
     "slots": {
       "header": "3.10.0",
       "footer": "3.11.0",
+      "no-data": "3.11.0",
       "toggle": "3.10.0"
     }
   },
diff --git a/packages/docs/src/examples/v-treeview/slot-no-data.vue b/packages/docs/src/examples/v-treeview/slot-no-data.vue
new file mode 100644
index 00000000000..ece04d95501
--- /dev/null
+++ b/packages/docs/src/examples/v-treeview/slot-no-data.vue
@@ -0,0 +1,188 @@
+<template>
+  <v-treeview
+    v-model:activated="activated"
+    :items="items"
+    item-key="id"
+    item-value="id"
+    activatable
+    open-all
+  >
+    <template v-slot:append="{ item, depth, isFirst, isLast }">
+      <v-icon-btn :disabled="!depth" icon="mdi-arrow-left" @click.stop="move(item, 'left')"></v-icon-btn>
+      <v-icon-btn :disabled="isFirst" icon="mdi-arrow-up" @click.stop="move(item, 'up')"></v-icon-btn>
+      <v-icon-btn :disabled="isLast" icon="mdi-arrow-down" @click.stop="move(item, 'down')"></v-icon-btn>
+      <v-icon-btn :disabled="isFirst" icon="mdi-arrow-right" @click.stop="move(item, 'right')"></v-icon-btn>
+    </template>
+  </v-treeview>
+</template>
+
+<script setup>
+  import { ref, shallowRef } from 'vue'
+
+  const activated = ref([])
+  const root = {
+    id: 0,
+    children: [
+      {
+        id: 1,
+        title: 'Office Tools',
+        children: [
+          { id: 2, title: 'Calendar' },
+          { id: 3, title: 'Notepad' },
+        ],
+      },
+      {
+        id: 4,
+        title: 'Dev Tools',
+        children: [
+          { id: 5, title: 'VS Code' },
+          { id: 6, title: 'Figma' },
+          { id: 7, title: 'Webstorm' },
+        ],
+      },
+    ],
+  }
+  const items = shallowRef([...root.children])
+
+  function findParent (id, items = [root]) {
+    if (items.length === 0) return null
+    return items.find(item => item.children?.some(c => c.id === id)) ??
+      findParent(id, items.flatMap(item => item.children ?? []))
+  }
+
+  function findItemBefore (item) {
+    return findParent(item.id).children
+      .find((_, i, all) => all[i + 1]?.id === item.id)
+  }
+
+  function findItemAfter (item) {
+    return findParent(item.id).children
+      .find((_, i, all) => all[i - 1]?.id === item.id)
+  }
+
+  function detach (item) {
+    const parent = findParent(item.id)
+    parent.children.splice(parent.children.indexOf(item), 1)
+    if (parent.children.length === 0) parent.children = undefined
+  }
+
+  function injectNextTo (item, target, after = true) {
+    if (!target || target === root) return
+    detach(item)
+    const targetParent = findParent(target.id)
+    targetParent.children.splice(targetParent.children.indexOf(target) + (after ? 1 : 0), 0, item)
+    activated.value = [item.id]
+  }
+
+  function appendTo (item, target) {
+    if (!target) return
+    detach(item)
+    target.children ??= []
+    target.children.push(item)
+    activated.value = [item.id]
+  }
+
+  function move (item, direction) {
+    switch (direction) {
+      case 'left':
+        injectNextTo(item, findParent(item.id))
+        break
+      case 'up':
+        injectNextTo(item, findItemBefore(item), false)
+        break
+      case 'right':
+        appendTo(item, findItemBefore(item))
+        break
+      case 'down':
+        injectNextTo(item, findItemAfter(item))
+        break
+    }
+    items.value = [...root.children]
+  }
+</script>
+
+<script>
+  export default {
+    data: () => ({
+      activated: [],
+      root: {
+        id: 0,
+        children: [
+          {
+            id: 1,
+            title: 'Office Tools',
+            children: [
+              { id: 2, title: 'Calendar' },
+              { id: 3, title: 'Notepad' },
+            ],
+          },
+          {
+            id: 4,
+            title: 'Dev Tools',
+            children: [
+              { id: 5, title: 'VS Code' },
+              { id: 6, title: 'Figma' },
+              { id: 7, title: 'Webstorm' },
+            ],
+          },
+        ],
+      },
+      items: [],
+    }),
+    mounted () {
+      this.items = [...this.root.children]
+    },
+    methods: {
+      findParent (id, items) {
+        items ??= [this.root]
+        if (items.length === 0) return null
+        return items.find(item => item.children?.some(c => c.id === id)) ??
+          this.findParent(id, items.flatMap(item => item.children ?? []))
+      },
+      findItemBefore (item) {
+        return this.findParent(item.id).children
+          .find((_, i, all) => all[i + 1]?.id === item.id)
+      },
+      findItemAfter (item) {
+        return this.findParent(item.id).children
+          .find((_, i, all) => all[i - 1]?.id === item.id)
+      },
+      detach (item) {
+        const parent = this.findParent(item.id)
+        parent.children.splice(parent.children.indexOf(item), 1)
+        if (parent.children.length === 0) parent.children = undefined
+      },
+      injectNextTo (item, target, after = true) {
+        if (!target || target === this.root) return
+        this.detach(item)
+        const targetParent = this.findParent(target.id)
+        targetParent.children.splice(targetParent.children.indexOf(target) + (after ? 1 : 0), 0, item)
+        this.activated = [item.id]
+      },
+      appendTo (item, target) {
+        if (!target) return
+        this.detach(item)
+        target.children ??= []
+        target.children.push(item)
+        this.activated = [item.id]
+      },
+      move (item, direction) {
+        switch (direction) {
+          case 'left':
+            this.injectNextTo(item, this.findParent(item.id))
+            break
+          case 'up':
+            this.injectNextTo(item, this.findItemBefore(item), false)
+            break
+          case 'right':
+            this.appendTo(item, this.findItemBefore(item))
+            break
+          case 'down':
+            this.injectNextTo(item, this.findItemAfter(item))
+            break
+        }
+        this.items = [...this.root.children]
+      },
+    },
+  }
+</script>
diff --git a/packages/docs/src/pages/en/components/treeview.md b/packages/docs/src/pages/en/components/treeview.md
index 9ca44d6333f..b8559cb99f7 100644
--- a/packages/docs/src/pages/en/components/treeview.md
+++ b/packages/docs/src/pages/en/components/treeview.md
@@ -136,6 +136,12 @@ Both **append**, and **prepend** slots get additional information about the item
 
 <ExamplesExample file="v-treeview/slot-append-and-prepend-item" />
 
+#### No data
+
+When searching within the treeview, you might want to show custom **no-data** slot to provide context or immediate action.
+
+<ExamplesExample file="v-treeview/slot-no-data" />
+
 #### Title
 
 In this example we use a custom **title** slot to apply a line-through the treeview item's text when selected.
diff --git a/packages/vuetify/src/components/VTreeview/VTreeview.tsx b/packages/vuetify/src/components/VTreeview/VTreeview.tsx
index d9d5c42f193..23e84de7c07 100644
--- a/packages/vuetify/src/components/VTreeview/VTreeview.tsx
+++ b/packages/vuetify/src/components/VTreeview/VTreeview.tsx
@@ -1,8 +1,10 @@
 // Components
 import { makeVTreeviewChildrenProps, VTreeviewChildren } from './VTreeviewChildren'
 import { makeVListProps, useListItems, VList } from '@/components/VList/VList'
+import { VListItem } from '@/components/VList/VListItem'
 
 // Composables
+import { useLocale } from '@/composables'
 import { provideDefaults } from '@/composables/defaults'
 import { makeFilterProps, useFilter } from '@/composables/filter'
 import { useProxiedModel } from '@/composables/proxiedModel'
@@ -31,6 +33,11 @@ export const makeVTreeviewProps = propsFactory({
   openAll: Boolean,
   indentLines: [Boolean, String] as PropType<boolean | IndentLinesVariant>,
   search: String,
+  hideNoData: Boolean,
+  noDataText: {
+    type: String,
+    default: '$vuetify.noDataText',
+  },
 
   ...makeFilterProps({ filterKeys: ['title'] }),
   ...omit(makeVTreeviewChildrenProps(), [
@@ -53,7 +60,9 @@ export const VTreeview = genericComponent<new <T>(
   props: {
     items?: T[]
   },
-  slots: VTreeviewChildrenSlots<T>
+  slots: VTreeviewChildrenSlots<T> & {
+    'no-data': never
+  }
 ) => GenericProps<typeof props, typeof slots>>()({
   name: 'VTreeview',
 
@@ -69,6 +78,7 @@ export const VTreeview = genericComponent<new <T>(
   },
 
   setup (props, { slots, emit }) {
+    const { t } = useLocale()
     const { items } = useListItems(props)
     const activeColor = toRef(() => props.activeColor)
     const baseColor = toRef(() => props.baseColor)
@@ -175,6 +185,9 @@ export const VTreeview = genericComponent<new <T>(
           v-model:activated={ activated.value }
           v-model:selected={ selected.value }
         >
+          { visibleIds.value?.size === 0 && !props.hideNoData && (
+            slots['no-data']?.() ?? (<VListItem key="no-data" title={ t(props.noDataText) } />)
+          )}
           <VTreeviewChildren
             { ...treeviewChildrenProps }
             density={ props.density }