From a68df49eb5a67c8dcd2cba820c1e72a27d2e88a7 Mon Sep 17 00:00:00 2001
From: DorraJaouad <dorra.jaoued7@gmail.com>
Date: Mon, 10 Jun 2024 18:22:00 +0200
Subject: [PATCH] feat(NcRichContenteditable): programmatically show tributes

Signed-off-by: DorraJaouad <dorra.jaoued7@gmail.com>
---
 .../NcRichContenteditable.vue                 | 66 +++++++++++++++++++
 1 file changed, 66 insertions(+)

diff --git a/src/components/NcRichContenteditable/NcRichContenteditable.vue b/src/components/NcRichContenteditable/NcRichContenteditable.vue
index cba89dc3b6..e2bfdbd47a 100644
--- a/src/components/NcRichContenteditable/NcRichContenteditable.vue
+++ b/src/components/NcRichContenteditable/NcRichContenteditable.vue
@@ -210,6 +210,48 @@ export default {
 </style>
 ```
 
+### Using public methods
+
+```vue
+<template>
+	<div>
+		<div class="buttons-wrapper">
+			<NcButton class="show-slash-button" @click="showSlashCommands">Slash commands</NcButton>
+			<NcButton class="focus-button" @click="focus">Focus on input</NcButton>
+		</div>
+		<NcRichContenteditable
+			ref="contenteditable"
+			v-model="message"
+			label="Write a comment"
+			:maxlength="100"/>
+	</div>
+</template>
+<script>
+export default {
+	data() {
+		return {
+			message: '**Lorem ipsum** dolor sit amet. ',
+		}
+	},
+	methods: {
+		showSlashCommands() {
+			this.$refs.contenteditable.showTribute('/')
+		},
+		focus() {
+			this.$refs.contenteditable.focus()
+		},
+	},
+}
+</script>
+<style lang="scss" scoped>
+	.buttons-wrapper {
+		display: flex;
+		gap: 10px;
+		margin-bottom: 20px;
+	}
+</style>
+```
+
 </docs>
 
 <template>
@@ -911,6 +953,8 @@ export default {
 				this.getTributeContainer().setAttribute('class', this.tribute.current.collection.containerClass || this.$style['tribute-container'])
 
 				this.setupTributeIntegration()
+				// Remove the event handler if any
+				document.removeEventListener('click', this.hideTribute, true)
 			} else {
 				// Cancel loading data for autocomplete
 				// Otherwise it could be received when another autocomplete is already opened
@@ -990,6 +1034,28 @@ export default {
 				this.getTributeContainer().classList.remove(this.$style['tribute-container--focus-visible'])
 			}
 		},
+
+		/**
+		 * Show tribute menu programmatically.
+		 * @param {string} trigger - trigger character, can be '/', '@', or ':'
+		 *
+		 * @public
+		 */
+		showTribute(trigger) {
+			this.focus()
+			const index = this.tribute.collection.findIndex(collection => collection.trigger === trigger)
+			this.tribute.showMenuForCollection(this.$refs.contenteditable, index)
+			document.addEventListener('click', this.hideTribute, true)
+		},
+
+		/**
+		 * Hide tribute menu programmatically
+		 *
+		 */
+		hideTribute() {
+			this.tribute.hideMenu()
+			document.removeEventListener('click', this.hideTribute, true)
+		},
 	},
 }
 </script>