Merge branch 'develop' into milestone/ff-admin-unit

src/components/QuillEditor.vue

@@ -0,0 +1,151 @@
+<template>
+  <div :id="id" :style="style" class="flex flex-col">
+    <div ref="quill"></div>
+  </div>
+</template>
+
+<script setup lang="ts">
+import { markRaw, onMounted, onUnmounted, ref, useTemplateRef, watch, type PropType } from "vue";
+import Quill, { Delta, type QuillOptions } from "quill";
+import "quill/dist/quill.core.css";
+import "quill/dist/quill.snow.css";
+import isEqual from "lodash.isequal";
+import cloneDeep from "lodash.clonedeep";
+
+type RangeStatic = { index: number; length: number };
+
+const quillElement = useTemplateRef("quill");
+
+const instance = ref<undefined | Quill>();
+const model = ref<string | Delta>("");
+
+const props = defineProps({
+  id: String,
+  style: [String, Object],
+  options: {
+    type: Object as PropType<QuillOptions>,
+    default: {},
+  },
+  toolbar: {
+    type: [String, Array, Object],
+    default: "",
+  },
+  content: {
+    type: [String, Object] as PropType<string | Delta | null>,
+    default: "",
+  },
+  contentType: {
+    type: String as PropType<"delta" | "html" | "text">,
+    default: "text",
+    validator: (value: string) => {
+      return ["delta", "html", "text"].includes(value);
+    },
+  },
+  readonly: { type: Boolean, default: false },
+  placeholder: String,
+});
+
+const emit = defineEmits({
+  "update:content": (content: Delta | string) => true,
+  textChange: (tc: { delta: Delta; oldDelta: Delta; source: string }) => true,
+  selectionChange: (sc: { range: RangeStatic; oldRange: RangeStatic; source: string }) => true,
+  focus: () => true,
+  blur: () => true,
+  ready: (quill: Quill) => true,
+});
+
+watch(
+  () => props.content,
+  (val, oldVal) => {
+    if (!instance.value || !val || isEqual(val, model.value)) return;
+    setContent(cloneDeep(val));
+  },
+  { deep: true }
+);
+watch(
+  () => props.readonly,
+  (val, oldVal) => {
+    instance.value?.enable(val);
+  }
+);
+watch(model, (val, oldVal) => {
+  emit("update:content", cloneDeep(val));
+});
+
+onMounted(() => {
+  if (!quillElement.value) return;
+  const quill = new Quill(quillElement.value, {
+    theme: "snow",
+    modules: {
+      toolbar: props.toolbar,
+    },
+    placeholder: props.placeholder,
+    readOnly: props.readonly,
+    ...props.options,
+  });
+
+  quill.on(Quill.events.SELECTION_CHANGE, (range, oldRange, source) => {
+    if (!range) {
+      emit("blur");
+    } else {
+      emit("focus");
+    }
+    emit("selectionChange", { range, oldRange, source });
+  });
+  quill.on(Quill.events.TEXT_CHANGE, (delta, oldDelta, source) => {
+    model.value = getContent();
+    emit("textChange", { delta, oldDelta, source });
+  });
+
+  emit("ready", quill);
+  instance.value = markRaw(quill);
+  setContent(cloneDeep(props.content ?? ""));
+});
+onUnmounted(() => {
+  if (instance.value) {
+    instance.value.off(Quill.events.SELECTION_CHANGE);
+    instance.value.off(Quill.events.TEXT_CHANGE);
+    instance.value = undefined;
+  }
+});
+
+function getContent(): string | Delta {
+  if (props.contentType === "delta") {
+    return (instance.value?.getContents() ?? {}) as Delta;
+  } else if (props.contentType === "html") {
+    return instance.value?.getSemanticHTML().replace(/&nbsp;/g, " ") ?? "";
+  } else {
+    return instance.value?.getText().replace(/&nbsp;/g, " ") ?? "";
+  }
+}
+function setContent(content: Delta | string) {
+  if (content == "") return;
+  if (props.contentType === "delta") {
+    if (typeof content !== "string") {
+      instance.value?.setContents(content);
+    }
+  } else if (props.contentType === "html") {
+    if (typeof content === "string" && instance.value) {
+      instance.value.clipboard.dangerouslyPasteHTML(content);
+      let delta = instance.value.clipboard.convert({ html: content });
+      instance.value?.setContents(delta);
+    }
+  } else {
+    if (typeof content === "string") {
+      instance.value?.setText(content);
+    }
+  }
+}
+</script>
+
+<style>
+.ql-container {
+  border-bottom-left-radius: 0.5em;
+  border-bottom-right-radius: 0.5em;
+}
+.ql-toolbar {
+  background: var(--color-gray-100);
+  border-top-left-radius: 0.5em;
+  border-top-right-radius: 0.5em;
+}
+</style>