@opentiny/tiny-robot 0.1.0-alpha.0 → 0.2.0-alpha.0

package/src/question/components/HotQuestions.vue

@@ -0,0 +1,148 @@
+<script setup lang="ts">
+import { ref, defineProps, defineEmits, watch, PropType, computed } from 'vue'
+import { IconClose } from '@opentiny/vue-icon'
+import { TinyButton } from '@opentiny/vue'
+import type { Category, Question } from '../index.type'
+
+import { IconHotQuestion, IconTypeAll } from '@opentiny/tiny-robot-svgs'
+
+const TinyIconClose = IconClose()
+
+const props = defineProps({
+  visible: {
+    type: Boolean,
+    default: false,
+  },
+  categories: {
+    type: Array as PropType<Category[]>,
+    default: () => [],
+  },
+  modalWidth: {
+    type: String,
+    default: '640px',
+  },
+  loading: {
+    type: Boolean,
+    default: false,
+  },
+  closeOnClickOutside: {
+    type: Boolean,
+    default: true,
+  },
+})
+
+const emit = defineEmits(['update:visible', 'close', 'select-category', 'question-click'])
+
+// 当前激活的分类
+const activeCategory = ref<string>('')
+
+// 计算当前激活分类的问题列表
+const activeQuestions = computed(() => {
+  if (!activeCategory.value && props.categories.length > 0) {
+    return props.categories[0].questions || []
+  }
+
+  const category = props.categories.find((cat) => cat.id === activeCategory.value)
+  return category ? category.questions : []
+})
+
+// 初始化激活的分类
+watch(
+  () => props.categories,
+  (categories) => {
+    if (categories.length > 0 && !activeCategory.value) {
+      activeCategory.value = categories[0].id
+    }
+  },
+  { immediate: true },
+)
+
+// 关闭弹窗
+const closeModal = () => {
+  emit('update:visible', false)
+  emit('close')
+}
+
+// 处理分类选择
+const handleCategorySelect = (categoryId: string) => {
+  activeCategory.value = categoryId
+  emit(
+    'select-category',
+    props.categories.find((cat) => cat.id === categoryId),
+  )
+}
+
+// 处理问题点击
+const handleQuestionClick = (question: Question) => {
+  emit('question-click', question)
+}
+
+// 处理点击外部关闭
+const handleClickOutside = (event: MouseEvent) => {
+  if (props.closeOnClickOutside && !event.composedPath().includes(modalRef.value!)) {
+    closeModal()
+  }
+}
+
+const modalRef = ref<HTMLElement | null>(null)
+</script>
+
+<template>
+  <div v-if="visible" class="tr-question-modal-backdrop" @mousedown="handleClickOutside">
+    <div ref="modalRef" class="tr-question-panel" :style="{ width: modalWidth }" @mousedown.stop>
+      <div class="tr-question-header">
+        <div style="display: flex; align-items: center; gap: 12px">
+          <div><IconHotQuestion /></div>
+          <div class="tr-question-header-title">热门问题</div>
+        </div>
+        <span class="tr-question-close-btn" @click="closeModal">
+          <TinyButton :icon="TinyIconClose" type="text" />
+        </span>
+      </div>
+
+      <div v-if="categories.length > 0" class="tr-question-categories">
+        <div
+          v-for="category in categories"
+          :key="category.id"
+          class="tr-question-categories-item"
+          :class="{ active: activeCategory === category.id }"
+          @click="handleCategorySelect(category.id)"
+        >
+          <slot name="category-label" :category="category">
+            <div class="category-icon">
+              <IconTypeAll />
+            </div>
+            <span>{{ category.label }}</span>
+          </slot>
+        </div>
+      </div>
+
+      <div class="tr-question-content">
+        <div v-if="loading" class="tr-question-loading">
+          <slot name="loading-indicator">
+            <div class="tr-question-loading-spinner"></div>
+          </slot>
+        </div>
+
+        <ul v-else-if="activeQuestions.length > 0">
+          <li
+            v-for="(question, index) in activeQuestions"
+            :key="question.id"
+            class="tr-question-list-item"
+            @click="handleQuestionClick(question)"
+          >
+            <slot name="question-item" :question="question" :index="index">
+              <span>{{ index + 1 }}.</span> {{ question.text }}
+            </slot>
+          </li>
+        </ul>
+
+        <div v-else class="tr-question-empty">
+          <slot name="empty-state">
+            <p>暂无相关问题</p>
+          </slot>
+        </div>
+      </div>
+    </div>
+  </div>
+</template>

package/src/question/composables/useQuestions.ts

@@ -0,0 +1,106 @@
+import { ref, computed, Ref, watch } from 'vue'
+import type { Category, ThemeType } from '../index.type'
+
+export function useQuestions(categories: Ref<Category[]> = ref([])) {
+  // 当前激活的分类ID
+  const activeCategory = ref<string>('')
+
+  // 是否展开悬浮面板
+  const isFloatingExpanded = ref(false)
+
+  // 弹窗是否可见
+  const modalVisible = ref(false)
+
+  // 当前主题
+  const currentTheme = ref<ThemeType>('light')
+
+  // 计算当前激活分类的问题列表
+  const activeQuestions = computed(() => {
+    if (!activeCategory.value && categories.value.length > 0) {
+      return categories.value[0].questions
+    }
+
+    const category = categories.value.find((cat) => cat.id === activeCategory.value)
+    return category ? category.questions : []
+  })
+
+  // 设置激活的分类
+  const setActiveCategory = (categoryId: string) => {
+    activeCategory.value = categoryId
+  }
+
+  // 打开弹窗
+  const openModal = () => {
+    modalVisible.value = true
+  }
+
+  // 关闭弹窗
+  const closeModal = () => {
+    modalVisible.value = false
+  }
+
+  // 切换悬浮面板展开状态
+  const toggleFloating = () => {
+    isFloatingExpanded.value = !isFloatingExpanded.value
+  }
+
+  // 防止滚动穿透的函数
+  const toggleBodyScroll = (isOpen: boolean) => {
+    const body = document.body
+
+    if (isOpen) {
+      // 保存当前滚动位置
+      const scrollTop = window.scrollY || document.documentElement.scrollTop
+      body.style.position = 'fixed'
+      body.style.width = '100%'
+      body.style.top = `-${scrollTop}px`
+      body.style.overflowY = 'scroll' // 保持滚动条宽度，防止页面抖动
+      body.classList.add('tr-modal-open')
+    } else {
+      body.style.position = ''
+      body.style.width = ''
+      body.style.top = ''
+      body.style.overflowY = ''
+      body.classList.remove('tr-modal-open')
+    }
+  }
+
+  // 监听弹窗变化应用滚动锁定
+  watch(modalVisible, (value) => {
+    toggleBodyScroll(value)
+  })
+
+  // 切换主题
+  const toggleTheme = () => {
+    currentTheme.value = currentTheme.value === 'light' ? 'dark' : 'light'
+    document.documentElement.setAttribute('data-theme', currentTheme.value)
+  }
+
+  // 设置主题
+  const setTheme = (theme: ThemeType) => {
+    currentTheme.value = theme
+    document.documentElement.setAttribute('data-theme', theme)
+  }
+
+  // 刷新数据（模拟异步操作）
+  const refreshData = async () => {
+    // 这里可以添加实际的数据刷新逻辑
+    return Promise.resolve()
+  }
+
+  return {
+    activeCategory,
+    isFloatingExpanded,
+    modalVisible,
+    currentTheme,
+    activeQuestions,
+    setActiveCategory,
+    openModal,
+    closeModal,
+    toggleFloating,
+    toggleTheme,
+    setTheme,
+    refreshData,
+    toggleBodyScroll,
+  }
+}

package/src/question/index.less

@@ -0,0 +1,448 @@
+@import './vars.less';
+
+/**
+ * TR Question 组件样式
+ */
+
+/* ================ 滚动穿透防止 ================ */
+/**
+ * 当弹窗打开时应用于body的类
+ * 解决滚动穿透问题 - 防止弹窗打开时背景内容滚动
+ */
+body.tr-modal-open {
+  overflow: hidden !important;
+  position: fixed;
+  width: 100%;
+  height: 100%;
+}
+
+/* ================ 基础容器样式 ================ */
+/**
+ * 组件根容器
+ */
+.tr-question-container {
+  position: relative;
+  display: flex;
+  align-items: center;
+  height: var(--tr-question-container-height);
+  padding: 0;
+  font-size: var(--tr-question-font-size);
+  line-height: var(--tr-question-line-height);
+  color: var(--tr-question-text-color);
+  box-sizing: border-box;
+}
+
+/* ================ 触发按钮样式 ================ */
+/**
+ * 热门问题触发按钮
+ * 位于左侧，点击显示弹窗
+ */
+.tr-question-trigger {
+  position: absolute;
+  top: 5px;
+  left: 0;
+  display: flex;
+  justify-content: center;
+  align-items: center;
+  margin: 2px 8px 0 0;
+  cursor: pointer;
+
+  &:hover {
+    transform: scale(1.05);
+  }
+
+  /* 按钮图标 */
+  & > svg {
+    width: 28px;
+    height: 28px;
+    border-radius: 50%;
+    fill: #ffffff;
+  }
+
+  & > svg:hover {
+    fill: #f5f5f5;
+    transform: scale(1.05);
+  }
+}
+
+/* ================ 弹窗样式 ================ */
+/**
+ * 弹窗外层遮罩
+ * 全屏遮罩层，内部包含问题弹窗
+ */
+.tr-question-modal-backdrop {
+  position: fixed;
+  top: 0;
+  left: 0;
+  right: 0;
+  bottom: 0;
+  background-color: var(--tr-question-modal-backdrop-color);
+  display: flex;
+  justify-content: center;
+  align-items: center;
+  z-index: 1000;
+  overflow: hidden;
+  overscroll-behavior: contain; /* 防止滚动传递 */
+}
+
+/**
+ * 问题弹窗面板
+ * 包含标题、分类标签和问题列表
+ */
+.tr-question-panel {
+  position: relative;
+  border: none;
+  border-radius: var(--tr-question-border-radius);
+  padding: var(--tr-question-modal-padding);
+  box-shadow: var(--tr-question-panel-shadow);
+  background-color: var(--tr-question-modal-background-color);
+  max-height: var(--tr-question-modal-max-height);
+  max-width: var(--tr-question-modal-max-width);
+  width: 100%;
+  display: flex;
+  flex-direction: column;
+  overflow: hidden;
+  box-sizing: border-box;
+}
+
+/**
+ * 弹窗标题栏
+ * 包含标题文本和关闭按钮
+ */
+.tr-question-header {
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+  margin-bottom: var(--tr-question-spacing);
+
+  /* 标题文本 */
+  &-title {
+    font-size: var(--tr-question-title-font-size);
+    font-weight: var(--tr-question-title-font-weight);
+    color: var(--tr-question-title-color);
+  }
+
+  /* 关闭按钮 */
+  .tr-question-close-btn {
+    cursor: pointer;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    color: var(--tr-question-close-icon-color);
+    transition: var(--tr-question-hover-transition);
+
+    &:hover {
+      color: var(--tr-question-text-color);
+    }
+  }
+}
+
+/* ================ 分类标签样式 ================ */
+/**
+ * 分类标签容器
+ * 水平展示问题分类，支持点击切换
+ */
+.tr-question-categories {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 8px;
+
+  /**
+   * 单个分类标签
+   * 支持悬停和激活状态样式
+   */
+  &-item {
+    box-sizing: border-box;
+    border-radius: var(--tr-question-category-border-radius);
+    background: var(--tr-question-category-bg);
+    border: 1px solid transparent;
+    height: var(--tr-question-category-height);
+    padding: 10px 16px;
+    margin-right: 8px;
+    color: var(--tr-question-tab-text);
+    transition: var(--tr-question-hover-transition);
+    display: flex;
+    align-items: center;
+    gap: 4px;
+
+    /* 分类图标 */
+    .category-icon {
+      font-size: var(--tr-question-icon-size);
+      margin-right: 4px;
+    }
+
+    /* 悬停效果 */
+    &:hover {
+      cursor: pointer;
+      background: var(--tr-question-category-hover-bg);
+    }
+
+    /* 激活状态 */
+    &.active {
+      background: var(--tr-question-common-bg) !important;
+      border: 1px solid var(--tr-question-category-active-border) !important;
+      color: var(--tr-question-text-color);
+      font-weight: 500;
+    }
+  }
+}
+
+/* ================ 问题列表样式 ================ */
+/**
+ * 问题内容区
+ * 包含问题列表，支持滚动
+ */
+.tr-question-content {
+  flex: 1;
+  max-height: var(--tr-question-content-max-height);
+  overflow-y: auto;
+  padding: 10px 0;
+  overscroll-behavior: contain;
+  position: relative;
+
+  /**
+   * 自定义滚动条样式
+   */
+  &::-webkit-scrollbar {
+    width: var(--tr-question-scrollbar-width);
+    height: 10px;
+  }
+
+  &::-webkit-scrollbar-track {
+    background: var(--tr-question-scrollbar-track-bg);
+    border-radius: var(--tr-question-scrollbar-border-radius);
+  }
+
+  &::-webkit-scrollbar-thumb {
+    background-color: var(--tr-question-scrollbar-thumb-bg);
+    border-radius: var(--tr-question-scrollbar-border-radius);
+    transition: background-color var(--tr-question-transition-duration);
+  }
+
+  &::-webkit-scrollbar-thumb:hover {
+    background-color: var(--tr-question-scrollbar-thumb-hover-bg);
+  }
+
+  /**
+   * 问题列表
+   */
+  & > ul {
+    list-style: none;
+    padding: 0;
+    margin: 0;
+
+    /**
+     * 问题项
+     * 支持悬停效果和溢出文本处理
+     */
+    & > li {
+      color: var(--tr-question-common-text);
+      font-size: var(--tr-question-font-size);
+      font-weight: var(--tr-question-item-font-weight);
+      line-height: var(--tr-question-item-height);
+      text-align: left;
+      height: var(--tr-question-item-height);
+      border-radius: var(--tr-question-list-border-radius);
+      background: var(--tr-question-list-item-bg);
+      cursor: pointer;
+      margin: 5px 1px 2px 1px;
+      padding: 0 var(--tr-question-spacing);
+      white-space: nowrap;
+      overflow: hidden;
+      text-overflow: ellipsis;
+      border-bottom: 1px solid var(--tr-question-item-border-color);
+      transition: var(--tr-question-hover-transition);
+
+      /* 序号样式 */
+      span:first-child {
+        display: inline-block;
+        margin-right: 4px;
+        color: var(--tr-question-text-color-secondary);
+      }
+
+      /* 最后一项去除底部边框 */
+      &:last-child {
+        border-bottom: none;
+      }
+
+      /* 悬停效果 */
+      &:hover {
+        box-shadow: 0 2px 12px var(--tr-question-list-hover-shadow);
+        position: relative;
+        z-index: 10;
+        transform: translateY(-2px);
+      }
+    }
+  }
+
+  /**
+   * 换行模式下的问题项样式
+   */
+  &-wrap .tr-question-list-item {
+    white-space: normal;
+    height: auto;
+    min-height: var(--tr-question-item-height);
+    line-height: var(--tr-question-item-line-height);
+    padding-top: 8px;
+    padding-bottom: 8px;
+  }
+}
+
+/* ================ 常见问题样式 ================ */
+/**
+ * 常见问题容器
+ * 横向展示常见问题
+ */
+.tr-common-questions {
+  margin-left: 40px;
+  width: calc(100% - 40px);
+  display: flex;
+  align-items: center;
+  flex: 1;
+  height: 100%;
+  overflow-x: auto;
+  overflow-y: hidden;
+  white-space: nowrap;
+  flex-wrap: nowrap;
+  transition: all 0.3s ease;
+  position: relative;
+
+  &.expanded {
+    flex-wrap: wrap;
+    align-content: flex-end;
+    height: auto;
+    max-height: 200px; /* 可以根据需要调整 */
+    overflow-y: auto;
+    position: absolute;
+    bottom: 0;
+    z-index: 5;
+    padding: 8px 0;
+  }
+
+  /**
+   * 常见问题项
+   * 支持悬停效果和溢出文本处理
+   */
+  &_item {
+    max-width: 515px;
+    text-overflow: ellipsis;
+    overflow: hidden;
+    display: flex;
+    align-items: center;
+    gap: 8px;
+    white-space: nowrap;
+    color: var(--tr-question-common-text);
+    border: none;
+    background: var(--tr-question-common-bg);
+    margin: 1px 8px 4px 0;
+    cursor: pointer;
+    text-decoration: none;
+    height: var(--tr-question-common-item-height);
+    padding: 0 16px;
+    border-radius: var(--tr-question-common-border-radius);
+    box-shadow: var(--tr-question-common-item-shadow);
+    transition: var(--tr-question-hover-transition);
+
+    & > svg {
+      width: 16px;
+      height: 16px;
+    }
+
+    /* 悬停效果 */
+    &:hover {
+      background-color: var(--tr-question-common-hover-bg);
+      transform: translateY(-1px);
+    }
+  }
+
+  /* 自定义滚动条 */
+  &::-webkit-scrollbar {
+    height: var(--tr-question-scrollbar-width);
+  }
+
+  &::-webkit-scrollbar-track {
+    background: var(--tr-question-scrollbar-track-bg);
+    border-radius: var(--tr-question-scrollbar-border-radius);
+  }
+
+  &::-webkit-scrollbar-thumb {
+    background-color: var(--tr-question-scrollbar-thumb-bg);
+    border-radius: var(--tr-question-scrollbar-border-radius);
+  }
+
+  &::-webkit-scrollbar-thumb:hover {
+    background-color: var(--tr-question-scrollbar-thumb-hover-bg);
+  }
+}
+
+/* ================ 切换按钮样式 ================ */
+
+/**
+ * 换行切换按钮
+ * 控制问题展示方式
+ */
+.tr-question-wrap-trigger {
+  position: absolute;
+  right: 0;
+  z-index: 10;
+  cursor: pointer;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  width: 26px;
+  height: 26px;
+
+  /* 按钮图标 */
+  & > svg {
+    width: 1em;
+    height: 1em;
+    font-size: 32px;
+    border-radius: 50%;
+    fill: #ffffff;
+  }
+
+  & > svg:hover {
+    fill: #f5f5f5;
+  }
+}
+
+/* ================ 状态指示器样式 ================ */
+/**
+ * 加载状态
+ */
+.tr-question-loading {
+  padding: var(--tr-question-spacing);
+  text-align: center;
+
+  &-spinner {
+    width: 24px;
+    height: 24px;
+    border: 2px solid var(--tr-question-border-color);
+    border-top-color: var(--tr-question-primary-color);
+    border-radius: 50%;
+    margin: 0 auto;
+    animation: tr-question-spin 1s linear infinite;
+  }
+}
+
+/**
+ * 空状态
+ */
+.tr-question-empty {
+  padding: var(--tr-question-spacing);
+  text-align: center;
+  color: var(--tr-question-text-color-secondary);
+}
+
+/* ================ 动画效果 ================ */
+/**
+ * 加载动画
+ */
+@keyframes tr-question-spin {
+  0% {
+    transform: rotate(0deg);
+  }
+  100% {
+    transform: rotate(360deg);
+  }
+}

package/src/question/index.ts

@@ -0,0 +1,12 @@
+import { App } from 'vue'
+import Question from './index.vue'
+
+Question.name = 'TrQuestion'
+
+const install = function <T>(app: App<T>) {
+  app.component(Question.name!, Question)
+}
+
+Question.install = install
+
+export default Question as typeof Question & { install: typeof install }