Vue - Navigation Tree Select
Last modified by Pierre Jeanjean on 2026/01/21 10:23
This component provides a way for the user to select a specific location from the navigation tree of the current wiki.
- sources: https://github.com/xwiki-contrib/cristal/blob/main/core/navigation-tree/navigation-tree-ui/src/vue/NavigationTreeSelect.vue
- since: 1.0.0-rc-1
Usage
<script lang="ts" setup">
import { NavigationTreeSelect } from "@xwiki/cristal-navigation-tree-ui";
import { ref } from "vue";
import type { Ref } from "vue";
const location: Ref<SpaceReference | undefined> = ref(undefined);
</script>
<template>
<navigation-tree-select
v-model="location"
label="Label"
help="Help message"
></navigation-tree-select>
</template>Visual results
Vuetify

Shoelace

Props
| Name | Since | Type | Mandatory | Default value | Comment |
|---|---|---|---|---|---|
| label | 1.0.0-rc-1 | string | yes | N/A | The component's label. |
| help | 1.0.0-rc-1 | string | no | undefined | An optional help message describing what the component is for. |
| includeTerminals | 1.0.0-rc-1 | boolean | no | false | Whether to include terminal pages. |
| modelValue | 1.0.0-rc-1 | SpaceReference | no | N/A | The model of the component, corresponding to the currently selected location. |

This project is being financed by the French State as part of the France 2030 program
Ce projet est financé par l’État Français dans le cadre de France 2030