編輯器

Editor List Trash

游標位於清單項時,旁側浮出刪除鈕。

安裝

Terminal
pnpm dlx shadcn-vue add @admin/editor-list-trash
import { AdminEditorListTrash } from '@/registry/admin/ui/editor-list-trash'

admin-editor-list-trash 依賴 @admin/rich-editor,自帶刪除邏輯(不需 core 的 delete handler)。

用法

把 <AdminEditorListTrash> 放進 <AdminRichEditor> 的 default slot,游標移到清單項時即於右側浮出刪除鈕。

<script setup lang="ts">import type { JSONContent } from '@tiptap/core'import { ref } from 'vue'import { cn } from '@/lib/utils'import { baseProseClass } from '@/components/admin/editor'import { AdminEditorListTrash } from '@/components/admin/editor-list-trash'import { AdminEditorToolbar, defaultEditorItems } from '@/components/admin/editor-toolbar'import { AdminRichEditor, starterKitProseClass } from '@/components/admin/rich-editor'​const value = ref<JSONContent | string>(  '<ul><li>把游標移到清單項,右側會浮出刪除鈕</li><li>第二項</li><li>第三項</li></ul>')</script>​<template>  <admin-rich-editor    v-slot="{ editor, handlers }"    v-model="value"    :ui="{ base: cn(baseProseClass, starterKitProseClass) }"  >    <admin-editor-toolbar :editor :handlers="handlers" :items="defaultEditorItems" />    <admin-editor-list-trash :editor />  </admin-rich-editor></template>
<script setup lang="ts">import { ref } from 'vue'import { AdminEditorListTrash } from '@/registry/admin/ui/editor-list-trash'import { AdminEditorToolbar, defaultEditorItems } from '@/registry/admin/ui/editor-toolbar'import { AdminRichEditor } from '@/registry/admin/ui/rich-editor'​const value = ref('<ul><li>清單項</li></ul>')</script>​<template>  <admin-rich-editor v-slot="{ editor }" v-model="value">    <admin-editor-toolbar :editor :items="defaultEditorItems" />    <admin-editor-list-trash :editor />  </admin-rich-editor></template>

API 參考

admin-editor-list-trash

Props

名稱型別預設值說明
editor*Editor——
classClassValue——

* 代表必填

注意事項

  • 僅作用於清單項:只在游標位於 listItem / taskItem 時顯示;一般段落不出現。
  • 刪除整個節點:點擊會刪掉整個清單項(含內容),非僅清空文字。
  • 不支援 SSR:旁側刪除鈕依賴瀏覽器 DOM 定位;元件殼不含 <ClientOnly>。Nuxt 請自行以 <ClientOnly> 包覆,其他 SSR 框架用等價機制;純 CSR 不需處理。見 安裝 · SSR。

更新紀錄

  • feat: 新增 tiptap editor 元件系列273a0d0