浏览代码

feat:合并master_zyh分支代码

jack 5 月之前
父节点
当前提交
a414e4c2f0
共有 49 个文件被更改,包括 1504 次插入232 次删除
  1. 二进制
      src/assets/image/done-btn.png
  2. 二进制
      src/assets/image/next-btn.png
  3. 二进制
      src/assets/image/pervious-btn.png
  4. 二进制
      src/assets/image/start-btn.png
  5. 7 0
      src/assets/image/test.vue
  6. 37 2
      src/components/MoreFilters/src/MoreFilters.vue
  7. 12 4
      src/components/VBox_Dashboard/src/VBox_Dashboard.vue
  8. 26 14
      src/components/VDriverGuide/src/VDriverGuide.vue
  9. 二进制
      src/components/VDriverGuide/src/img/guide-icon.png
  10. 32 7
      src/components/VTipTooltip/src/VTipTooltip.vue
  11. 24 0
      src/stores/modules/guide.ts
  12. 50 37
      src/styles/driver.scss
  13. 6 0
      src/styles/theme.scss
  14. 45 24
      src/utils/driverGuide.ts
  15. 117 50
      src/views/Booking/src/BookingView.vue
  16. 235 0
      src/views/Booking/src/components/BookingGuide.vue
  17. 7 1
      src/views/Booking/src/components/BookingTable/src/BookingTable.vue
  18. 182 23
      src/views/Dashboard/src/DashboardView.vue
  19. 41 5
      src/views/Dashboard/src/components/DashFiters.vue
  20. 156 0
      src/views/Dashboard/src/components/DashboardGuide.vue
  21. 二进制
      src/views/Dashboard/src/guideImage/co2e-chart-tip.png
  22. 二进制
      src/views/Dashboard/src/guideImage/container-count-chart-tip.png
  23. 二进制
      src/views/Dashboard/src/guideImage/dark-kpi-chart-guide.png
  24. 二进制
      src/views/Dashboard/src/guideImage/dark-save-config-guide.png
  25. 二进制
      src/views/Dashboard/src/guideImage/dark-transport-mode.png
  26. 二进制
      src/views/Dashboard/src/guideImage/dark-view-management.png
  27. 二进制
      src/views/Dashboard/src/guideImage/etd-to-eta-chart-tip.png
  28. 二进制
      src/views/Dashboard/src/guideImage/kpi-chart-guide.png
  29. 0 0
      src/views/Dashboard/src/guideImage/kpi-chart-tip.png
  30. 二进制
      src/views/Dashboard/src/guideImage/pending-chart-tip.png
  31. 二进制
      src/views/Dashboard/src/guideImage/recent-status-chart-tip.png
  32. 二进制
      src/views/Dashboard/src/guideImage/revenue-spent-chart-tip.png
  33. 二进制
      src/views/Dashboard/src/guideImage/save-config-guide.png
  34. 7 0
      src/views/Dashboard/src/guideImage/test.vue
  35. 二进制
      src/views/Dashboard/src/guideImage/top-10-chart-tip.png
  36. 二进制
      src/views/Dashboard/src/guideImage/transport-mode.png
  37. 二进制
      src/views/Dashboard/src/guideImage/view-management.png
  38. 118 58
      src/views/Tracking/src/TrackingView.vue
  39. 84 0
      src/views/Tracking/src/components/MultiHighlightGuide.vue
  40. 53 6
      src/views/Tracking/src/components/TrackingDetail/src/TrackingDetail.vue
  41. 250 0
      src/views/Tracking/src/components/TrackingGuide.vue
  42. 8 1
      src/views/Tracking/src/components/TrackingTable/src/TrackingTable.vue
  43. 二进制
      src/views/Tracking/src/image/customize-columns.png
  44. 二进制
      src/views/Tracking/src/image/dark-customize-columns.png
  45. 二进制
      src/views/Tracking/src/image/dark-download-guide.png
  46. 二进制
      src/views/Tracking/src/image/dark-more-filters-guide.png
  47. 二进制
      src/views/Tracking/src/image/download-guide.png
  48. 二进制
      src/views/Tracking/src/image/more-filters-guide.png
  49. 7 0
      src/views/Tracking/src/image/test.vue

二进制
src/assets/image/done-btn.png


二进制
src/assets/image/next-btn.png


二进制
src/assets/image/pervious-btn.png


二进制
src/assets/image/start-btn.png


+ 7 - 0
src/assets/image/test.vue

@@ -0,0 +1,7 @@
+<script setup lang="ts"></script>
+
+<template>
+  <div></div>
+</template>
+
+<style lang="scss" scoped></style>

+ 37 - 2
src/components/MoreFilters/src/MoreFilters.vue

@@ -527,7 +527,8 @@ const drawer = ref(false)
 
 const props = defineProps({
   isShipment: Boolean,
-  searchTableQeury: Object
+  searchTableQeury: Object,
+  isShowMoreFiltersGuidePhoto: Boolean
 })
 const PartyTypeoptions = computed(() => {
   if (props.isShipment) {
@@ -1007,9 +1008,28 @@ watch(
     searchTableQeurytest.value = current
   }
 )
+import moreFiltersImgLight from '@/views/Tracking/src/image/more-filters-guide.png'
+import moreFiltersImgDark from '@/views/Tracking/src/image/dark-more-filters-guide.png'
+import { useThemeStore } from '@/stores/modules/theme'
+
+const themeStore = useThemeStore()
+
+const moreFiltersGuideImg = computed(() => {
+  return themeStore.theme === 'dark' ? moreFiltersImgDark : moreFiltersImgLight
+})
 </script>
 <template>
-  <div>
+  <div style="position: relative">
+    <div style="width: 0; height: 0">
+      <img
+        id="more-filters-guide"
+        v-show="props.isShowMoreFiltersGuidePhoto"
+        :class="{ 'dark-more-filters-guide-class': themeStore.theme === 'dark' }"
+        class="more-filters-guide-class position-absolute"
+        :src="moreFiltersGuideImg"
+        alt=""
+      />
+    </div>
     <el-button class="More_Filters el-button--grey" @click="clickmorefilters">
       <span class="iconfont_icon icon_more">
         <svg class="iconfont" aria-hidden="true">
@@ -1211,6 +1231,21 @@ watch(
 </template>
 
 <style lang="scss" scoped>
+.position-absolute {
+  position: absolute;
+}
+img.more-filters-guide-class {
+  right: -1px;
+  top: -1px;
+  height: 579x;
+  width: 202px;
+  z-index: 20000;
+  &.dark-more-filters-guide-class {
+    right: 0px;
+    width: 250px;
+  }
+}
+
 .icon_more {
   margin-left: 8px;
   margin-right: 0;

+ 12 - 4
src/components/VBox_Dashboard/src/VBox_Dashboard.vue

@@ -3,6 +3,7 @@ import { ref } from 'vue'
 const props = withDefaults(
   defineProps<{
     id?: number
+    isShowDragIconGudie?: boolean
   }>(),
   {}
 )
@@ -44,13 +45,20 @@ const vBoxPopoverRef = ref()
   <div class="v-box">
     <div class="header">
       <slot name="header">Title</slot>
-      <div class="option">
-        <el-button type="text" class="sort handle-draggable">
-          <span class="iconfont_icon">
+      <div class="option" style="width: 48px; height: 48px">
+        <el-button
+          type="text"
+          class="sort handle-draggable"
+          :id="isShowDragIconGudie ? 'drag-icon-guide' : ''"
+        >
+          <!-- <span class="iconfont_icon">
             <svg class="iconfont" aria-hidden="true">
               <use xlink:href="#icon-icon_dragsort__b"></use>
             </svg>
-          </span>
+          </span> -->
+
+          <!--  -->
+          <span class="font_family icon-icon_dragsort__b"></span>
         </el-button>
       </div>
       <div class="cancel" @click="changeCancel">

+ 26 - 14
src/components/VDriverGuide/src/VDriverGuide.vue

@@ -1,20 +1,32 @@
 <script setup lang="ts"></script>
 
 <template>
-  <el-button style="height: 24px; margin-left: 8px" class="driver-guide-btn el-button--text">
-    <span class="font_family icon-icon_guidelines_b" style="color: var(--color-theme)"></span>
-    <span
-      style="
-        display: inline-block;
-        margin-top: 2px;
-        margin-left: 2px;
-        font-size: 12px;
-        color: var(--color-theme);
-      "
-    >
-      Guidelines
+  <div id="page-guide-btn-guide" class="driver-guide-btn">
+    <img src="./img/guide-icon.png" alt="" />
+    <span style="margin-top: 2px; font-size: 12px; font-style: italic; color: var(--color-theme)">
+      Page Guide
     </span>
-  </el-button>
+  </div>
 </template>
 
-<style lang="scss" scoped></style>
+<style lang="scss" scoped>
+.driver-guide-btn {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  height: 24px;
+  padding: 0 7px;
+  margin-left: 8px;
+  border-radius: 24px;
+  background: var(--color-guide-icon-bg);
+  cursor: pointer;
+  &:hover {
+    background: var(--color-guide-icon-hover-bg);
+  }
+  img {
+    width: 16px;
+    height: 16px;
+    margin-right: 2px;
+  }
+}
+</style>

二进制
src/components/VDriverGuide/src/img/guide-icon.png


+ 32 - 7
src/components/VTipTooltip/src/VTipTooltip.vue

@@ -1,12 +1,12 @@
 <script setup lang="ts">
 const props = withDefaults(
   defineProps<{
-    content?: string
-    placement?: 'top' | 'bottom' | 'left' | 'right'
+    label?: string
+    placement?: string
     img?: string
+    width?: number
   }>(),
   {
-    content: '',
     placement: 'bottom'
   }
 )
@@ -16,14 +16,39 @@ const visible = ref(false)
 
 <template>
   <div style="display: inline-block">
-    <el-tooltip v-model="visible" :placement="props.placement">
+    <el-tooltip
+      popper-class="v-tip-tooltip"
+      v-model="visible"
+      :placement="props.placement"
+      trigger="click"
+    >
       <span class="font_family icon-icon_info_b"></span>
       <template #content>
-        <div class="label">KPI Report:Day difference between actual and estimate.</div>
-        <img :src="props.img" alt="" />
+        <div class="label">{{ props.label }}</div>
+        <div style="text-align: center">
+          <img :style="{ width: props.width + 'px' }" class="photo" :src="props.img" alt="" />
+        </div>
       </template>
     </el-tooltip>
   </div>
 </template>
 
-<style lang="scss" scoped></style>
+<style lang="scss">
+div.v-tip-tooltip {
+  padding: 16px;
+  border-radius: 12px;
+  background-color: var(--color-tour-next-btn-color) !important;
+  border: 0 !important;
+  box-shadow: 4px 4px 16px rgba(0, 0, 0, 0.1) !important;
+  // .el-popper__arrow:before {
+  //   border: 2 !important;
+  //   background-color: var(--color-tour-next-btn-color) !important;
+  //   box-shadow: 4px 4px 16px rgba(0, 0, 0, 0.1) !important;
+  // }
+  .photo {
+    width: 368px;
+    margin-top: 8px;
+    border-radius: 6px;
+  }
+}
+</style>

+ 24 - 0
src/stores/modules/guide.ts

@@ -0,0 +1,24 @@
+// store/guide.ts
+import { defineStore } from 'pinia'
+export const useGuideStore = defineStore('guide', {
+  state: () => ({
+    booking: {
+      isShowMoreFiltersGuidePhoto: false,
+      isShowDownloadFileGuidePhoto: false,
+      isShowFilterGuidePhoto: false,
+      isShowCustomizeColumnsGuidePhoto: false
+    },
+    tracking: {
+      isShowFilterGuidePhoto: false,
+      isShowMoreFiltersGuidePhoto: false,
+      isShowDownloadFileGuidePhoto: false,
+      isShowCustomizeColumnsGuidePhoto: false
+    },
+    dashboard: {
+      isShowViewManagementGuidePhoto: false,
+      isShowTransportModeGuidePhoto: false,
+      isShowSaveConfigGuidePhoto: false,
+      isShowKpiChartGuidePhoto: false
+    }
+  })
+})

+ 50 - 37
src/styles/driver.scss

@@ -3,7 +3,8 @@ div.driver-popover {
   max-width: 400px;
   padding: 15px;
   padding-bottom: 8px;
-  background-color: var(--color-tour-popover-bg);
+  background-image: linear-gradient(96deg, #b58eff 2.25%, #fdbc94 97.98%);
+  box-shadow: 4px 4px 16px rgba(0, 0, 0, 0.1);
 }
 // 标题
 header.driver-popover-title {
@@ -12,16 +13,16 @@ header.driver-popover-title {
 
 // 角标
 div.driver-popover-arrow-side-left {
-  border-left-color: var(--color-tour-popover-bg);
+  border-left-color: #b78ffc;
 }
 div.driver-popover-arrow-side-right {
-  border-right-color: var(--color-tour-popover-bg);
+  border-right-color: #b78ffc;
 }
 div.driver-popover-arrow-side-top {
-  border-top-color: var(--color-tour-popover-bg);
+  border-top-color: #b78ffc;
 }
 div.driver-popover-arrow-side-bottom {
-  border-bottom-color: var(--color-tour-popover-bg);
+  border-bottom-color: #b78ffc;
 }
 
 // 遮罩
@@ -32,8 +33,8 @@ div.driver-popover-arrow-side-bottom {
 }
 // 关闭图标
 button.driver-popover-close-btn {
-  top: 9px;
-  right: 9px;
+  top: 1px;
+  right: -2px;
   color: var(--color-neutral-1);
   &:hover,
   &:focus {
@@ -44,11 +45,15 @@ button.driver-popover-close-btn {
 div.driver-popover-description {
   color: var(--color-neutral-1);
   text-align: left;
+  ul {
+    margin-left: 16px;
+    list-style: disc;
+  }
 }
 
 // 页数
 span.driver-popover-progress-text {
-  color: var(--color-tour-step-color);
+  color: rgba($color: #fff, $alpha: 0.7);
   font-size: 12px;
 }
 .driver-popover-footer {
@@ -57,40 +62,48 @@ span.driver-popover-progress-text {
     button.driver-popover-prev-btn {
       width: 96px;
       height: 32px;
-      background-color: var(--color-btn-default-bg-color);
-      color: var(--color-neutral-1);
-      fill: var(--color-neutral-1);
-      text-shadow: none;
-      border: 1px solid var(--color-tour-prev-btn-border);
-      margin-left: 8px !important;
-      border-radius: 6px;
-      text-align: center;
-      &:hover {
-        // border: 1px solid var(--color-btn-default-bg-hover);
-        background-color: var(--color-btn-default-bg-hover);
-        fill: var(--color-theme);
-        span {
-          color: var(--color-theme);
-        }
-      }
+      padding: 0;
+      background-color: transparent;
+      border: none;
+      // width: 96px;
+      // height: 32px;
+      // background-color: var(--color-btn-default-bg-color);
+      // color: var(--color-neutral-1);
+      // fill: var(--color-neutral-1);
+      // text-shadow: none;
+      // border: 1px solid var(--color-tour-prev-btn-border);
+      // margin-left: 8px !important;
+      // border-radius: 6px;
+      // text-align: center;
+      // &:hover {
+      //   // border: 1px solid var(--color-btn-default-bg-hover);
+      //   background-color: var(--color-btn-default-bg-hover);
+      //   fill: var(--color-theme);
+      //   span {
+      //     color: var(--color-theme);
+      //   }
+      // }
     }
     button.driver-popover-next-btn {
       width: 96px;
       height: 32px;
-      background-color: var(--color-tour-next-btn-bg);
-      fill: var(--color-tour-next-btn-color);
+      padding: 0;
+      background-color: transparent;
       border: none;
-      text-shadow: none;
-      color: var(--color-tour-next-btn-color);
-      border-radius: 6px;
-      text-align: center;
-      &:hover {
-        background-color: var(--color-tour-next-btn-hover-bg);
-        fill: var(--color-tour-next-btn-bg);
-        span {
-          color: var(--color-tour-next-btn-color) !important;
-        }
-      }
+      // background-color: var(--color-tour-next-btn-bg);
+      // fill: var(--color-tour-next-btn-color);
+      // border: none;
+      // text-shadow: none;
+      // color: var(--color-tour-next-btn-color);
+      // border-radius: 6px;
+      // text-align: center;
+      // &:hover {
+      //   background-color: var(--color-tour-next-btn-hover-bg);
+      //   fill: var(--color-tour-next-btn-bg);
+      //   span {
+      //     color: var(--color-tour-next-btn-color) !important;
+      //   }
+      // }
     }
   }
 }

+ 6 - 0
src/styles/theme.scss

@@ -324,6 +324,9 @@
   --color-tour-next-btn-color: #fff;
   --color-tour-step-color: #b5b9bf;
   --color-tour-mask-bg: rgba(43, 47, 54, 0.7);
+
+  --color-guide-icon-bg: rgba(237, 237, 237, 0.6);
+  --color-guide-icon-hover-bg: rgba(237, 237, 237, 0.45);
 }
 
 :root.dark {
@@ -526,4 +529,7 @@
   --color-tour-next-btn-color: #ed6d00;
   --color-tour-step-color: rgba(240, 241, 243, 0.7);
   --color-tour-mask-bg: rgba(0, 0, 0, 0.7);
+
+  --color-guide-icon-bg: rgba(237, 237, 237, 0.1);
+  --color-guide-icon-hover-bg: rgba(237, 237, 237, 0.15);
 }

+ 45 - 24
src/utils/driverGuide.ts

@@ -1,8 +1,8 @@
-// src/composables/useDriver.ts
 import { driver, type DriveStep, type Config } from 'driver.js'
 import 'driver.js/dist/driver.css'
-
-let driverInstance: ReturnType<typeof driver> | null = null
+import nextBtnImg from '@/assets/image/next-btn.png'
+import previousBtnImg from '@/assets/image/pervious-btn.png'
+import doneBtnImg from '@/assets/image/done-btn.png'
 
 /**
  * useDriver composable
@@ -10,31 +10,52 @@ let driverInstance: ReturnType<typeof driver> | null = null
  * @param globalConfig 可选的 driver 配置
  */
 export function useDriver(steps: DriveStep[], globalConfig?: Config) {
-  if (!driverInstance) {
-    driverInstance = driver({
-      ...globalConfig,
-      animate: false,
-      showProgress: true, // 显示进度条
-      overlayOpacity: 0.7, // 遮罩透明度
-      overlayColor: '#2b2f36', // 遮罩颜色
-      // allowClose: false, // 禁止用户关闭引导
-      showButtons: ['previous', 'next', 'close'],
-      onPopoverRender: (popoverDOM, { config, state, driver }) => {
-        // 如果用户配置了自己的 onPopoverRender,也执行它
-        globalConfig?.onPopoverRender?.(popoverDOM, { config, state, driver })
+  const driverInstance = driver({
+    ...globalConfig,
+    animate: false,
+    showProgress: true,
+    overlayOpacity: 0.7,
+    overlayColor: '#2b2f36',
+    showButtons: ['previous', 'next', 'close'],
+    onPopoverRender: (popoverDOM, { config, state, driver }) => {
+      globalConfig?.onPopoverRender?.(popoverDOM, { config, state, driver })
+
+      const stepsLength = steps.length
+      const nextBtn = popoverDOM.nextButton
+      if (nextBtn) {
+        nextBtn.innerHTML = '' // 清空原内容
+        const img = document.createElement('img')
+        img.src = stepsLength - 1 === state.activeIndex ? doneBtnImg : nextBtnImg // 替换成你的图片路径
+        img.alt = 'next'
+        img.style.width = '96px'
+        img.style.height = '32px'
+        nextBtn.appendChild(img)
       }
-    })
-  }
+
+      const previousBtn = popoverDOM.previousButton
+      if (previousBtn) {
+        previousBtn.innerHTML = '' // 清空原内容
+        const img = document.createElement('img')
+        img.src = previousBtnImg // 替换成你的图片路径
+        img.alt = 'previous'
+        img.style.width = '96px'
+        img.style.height = '32px'
+        previousBtn.appendChild(img)
+      }
+    }
+  })
 
   driverInstance.setSteps(steps)
 
   return {
-    start: (stepIndex = 0) => driverInstance?.drive(stepIndex),
-    moveNext: () => driverInstance?.moveNext(),
-    movePrevious: () => driverInstance?.movePrevious(),
-    highlight: (step: DriveStep) => driverInstance?.highlight(step),
-    destroy: () => driverInstance?.destroy(),
-    isActive: () => driverInstance?.isActive(),
-    driverInstance // 暴露实例给你更多操作
+    start: (stepIndex = 0) => driverInstance.drive(stepIndex),
+    moveNext: () => driverInstance.moveNext(),
+    movePrevious: () => driverInstance.movePrevious(),
+    highlight: (step: DriveStep) => driverInstance.highlight(step),
+    destroy: () => driverInstance.destroy(),
+    isActive: () => driverInstance.isActive(),
+    hasNextStep: () => driverInstance.hasNextStep(),
+    moveTo: (stepIndex: number) => driverInstance.moveTo(stepIndex),
+    driverInstance
   }
 }

+ 117 - 50
src/views/Booking/src/BookingView.vue

@@ -388,71 +388,89 @@ const SearchInput = () => {
   sessionStorage.setItem('searchTableQeury', JSON.stringify(searchTableQeury))
   getbookingdata()
 }
+
+import BookingGuide from './components/BookingGuide.vue'
+import { useGuideStore } from '@/stores/modules/guide'
+
+const guideStore = useGuideStore()
+const bookingGuideRef = ref()
+const handleGuide = () => {
+  bookingGuideRef.value.startGuide() // 开始引导
+}
 </script>
 
 <template>
-  <div class="Title">Booking</div>
+  <div class="Title">
+    <span>Booking</span>
+    <VDriverGuide @click="handleGuide"></VDriverGuide>
+  </div>
+  <BookingGuide ref="bookingGuideRef"></BookingGuide>
   <div class="display" ref="filterRef">
-    <FilterTags :TagsListItem="TagsList" @changeTag="changeTag"></FilterTags>
-    <div class="heaer_top">
-      <div class="search">
-        <el-input
-          placeholder="Enter Booking/HBL/PO/Carrier Booking No. "
-          v-model="BookingSearch"
-          class="log_input"
-          @keyup.enter="SearchInput"
-        >
-          <template #prefix>
-            <span class="iconfont_icon">
-              <svg class="iconfont icon_search" aria-hidden="true">
-                <use xlink:href="#icon-icon_search_b"></use>
-              </svg>
-            </span>
-          </template>
-          <template #suffix>
-            <el-tooltip
-              v-if="isShowAlertIcon"
-              :offset="6"
-              popper-class="ShowAlerIcon"
-              effect="dark"
-              content="We support the following references number to find bookings:· Booking No./HAWB No./MAWB No./PO No./Carrier Booking No./Contract No./File No./Quote No."
-              placement="bottom"
+    <div class="filter-box">
+      <div class="filters-container" id="booking-filters-container-guide">
+        <FilterTags :TagsListItem="TagsList" @changeTag="changeTag"></FilterTags>
+        <div class="heaer_top">
+          <div class="search">
+            <el-input
+              placeholder="Enter Booking/HBL/PO/Carrier Booking No. "
+              v-model="BookingSearch"
+              class="log_input"
+              @keyup.enter="SearchInput"
             >
-              <span class="iconfont_icon iconfont_icon_tip">
-                <svg class="iconfont icon_search" aria-hidden="true">
-                  <use xlink:href="#icon-icon_info_b"></use>
-                </svg>
-              </span>
-            </el-tooltip>
-          </template>
-        </el-input>
+              <template #prefix>
+                <span class="iconfont_icon">
+                  <svg class="iconfont icon_search" aria-hidden="true">
+                    <use xlink:href="#icon-icon_search_b"></use>
+                  </svg>
+                </span>
+              </template>
+              <template #suffix>
+                <el-tooltip
+                  v-if="isShowAlertIcon"
+                  :offset="6"
+                  popper-class="ShowAlerIcon"
+                  effect="dark"
+                  content="We support the following references number to find bookings:· Booking No./HAWB No./MAWB No./PO No./Carrier Booking No./Contract No./File No./Quote No."
+                  placement="bottom"
+                >
+                  <span class="iconfont_icon iconfont_icon_tip">
+                    <svg class="iconfont icon_search" aria-hidden="true">
+                      <use xlink:href="#icon-icon_info_b"></use>
+                    </svg>
+                  </span>
+                </el-tooltip>
+              </template>
+            </el-input>
+          </div>
+          <TransportMode
+            :isShipment="false"
+            :TransportListItem="TransportListItem"
+            @TransportSearch="TransportSearch"
+            @defaultTransport="defaultTransport"
+            @clearTransportTags="clearTransportTags"
+          ></TransportMode>
+          <DateRange
+            :isShipment="false"
+            @DateRangeSearch="DateRangeSearch"
+            @clearDaterangeTags="clearDaterangeTags"
+            @defaultDate="defaultDate"
+          ></DateRange>
+        </div>
       </div>
-      <TransportMode
-        :isShipment="false"
-        :TransportListItem="TransportListItem"
-        @TransportSearch="TransportSearch"
-        @defaultTransport="defaultTransport"
-        @clearTransportTags="clearTransportTags"
-      ></TransportMode>
-      <DateRange
-        :isShipment="false"
-        @DateRangeSearch="DateRangeSearch"
-        @clearDaterangeTags="clearDaterangeTags"
-        @defaultDate="defaultDate"
-      ></DateRange>
       <MoreFilters
         :isShipment="false"
         :searchTableQeury="searchTableQeury"
         @MoreFiltersSearch="MoreFiltersSearch"
         @clearMoreFiltersTags="clearMoreFiltersTags"
         @defaultMorefilters="defaultMorefilters"
+        :isShowMoreFiltersGuidePhoto="guideStore.booking.isShowMoreFiltersGuidePhoto"
       ></MoreFilters>
       <el-button class="el-button--dark" style="margin-left: 8px" @click="SearchInput"
         >Search</el-button
       >
     </div>
     <!-- 筛选项 -->
-    <div class="filtersTag" v-if="tagsData.length">
+    <div class="filtersTag" v-if="tagsData.length" id="booking-filter-tag-guide">
       <el-tag
         :key="tag"
         class="tag"
@@ -484,6 +502,55 @@ const SearchInput = () => {
 </template>
 
 <style lang="scss" scoped>
+.position-absolute {
+  position: absolute;
+  z-index: 1200;
+}
+.filter-box {
+  width: 100%;
+  display: flex;
+  flex-direction: row;
+  align-items: flex-end;
+  height: 100%;
+}
+.filters-container {
+  max-width: 1426px;
+  width: 80%;
+  display: flex;
+  flex-direction: column;
+}
+.filter-guide-class {
+  top: -3px;
+  left: -2px;
+  height: 29px;
+  width: 592px;
+}
+img.more-filters-guide-class {
+  right: 38px;
+  top: 155px;
+  height: 634px;
+  width: 243px;
+  z-index: 20000;
+}
+.download-file-guide-class {
+  right: 85px;
+  top: 243px;
+  width: 377px;
+  height: 236px;
+}
+.customize-columns-guide-class {
+  right: 8px;
+  top: 249px;
+  width: 694px;
+  height: 474px;
+}
+.tab-filter-guide-class {
+  left: 248px;
+  top: 118px;
+  height: 42px;
+  z-index: 20000;
+}
+
 .Title {
   display: flex;
   height: 68px;
@@ -500,7 +567,6 @@ const SearchInput = () => {
 }
 .heaer_top {
   margin-top: 6.57px;
-  margin-bottom: 8px;
   display: flex;
 }
 .search {
@@ -508,8 +574,9 @@ const SearchInput = () => {
   height: 32px;
 }
 .filtersTag {
-  margin-bottom: 8.7px;
-  display: flex;
+  margin-top: 8px;
+  margin-bottom: 4px;
+  display: inline-flex;
   align-items: center;
   flex-wrap: wrap;
 }

+ 235 - 0
src/views/Booking/src/components/BookingGuide.vue

@@ -0,0 +1,235 @@
+<script setup lang="ts">
+import { useDriver } from '@/utils/driverGuide'
+import { useGuideStore } from '@/stores/modules/guide'
+import { useThemeStore } from '@/stores/modules/theme'
+
+import customizeColumnsImgLight from '@/views/Tracking/src/image/customize-columns.png'
+import customizeColumnsImgDark from '@/views/Tracking/src/image/dark-customize-columns.png'
+
+import downloadFileImgLight from '@/views/Tracking/src/image/download-guide.png'
+import downloadFileImgDark from '@/views/Tracking/src/image/dark-download-guide.png'
+
+const themeStore = useThemeStore()
+
+const customizeColumnsImg = computed(() => {
+  return themeStore.theme === 'dark' ? customizeColumnsImgDark : customizeColumnsImgLight
+})
+const downloadFileImg = computed(() => {
+  return themeStore.theme === 'dark' ? downloadFileImgDark : downloadFileImgLight
+})
+
+const guideStore = useGuideStore()
+const bookingGuideStore = guideStore.booking
+
+const steps: any = [
+  {
+    element: '#booking-filters-container-guide',
+    popover: {
+      title: '',
+      description: `Frequently Used Search Criteria Display Area:
+        <ul>
+          <li>Key Booking Status</li>
+          <li>Reference Numbers</li>
+          <li>Transport Mode</li>
+          <li>Date Type & Range</li>
+        </ul>`,
+      side: 'bottom'
+    }
+  },
+  {
+    element: '#booking-filter-tag-guide',
+    popover: {
+      title: '',
+      description: `
+        <ul>
+          <li>Selected query criteria display area</li>
+          <li>You can quickly clear selected conditions at this position</li>
+        </ul>
+      `,
+      side: 'bottom'
+    }
+  },
+  {
+    element: '#more-filters-guide',
+    popover: {
+      title: '',
+      description: 'Click "more filters" to see more search options.',
+      side: 'left'
+    }
+  },
+  {
+    element: '.booking-no-header',
+    popover: {
+      title: '',
+      description:
+        'Click on the Booking No. or double-click anywhere on a single booking data to enter the detailed page.',
+      side: 'bottom'
+    }
+  },
+  {
+    element: '#booking-download-file-guide',
+    popover: {
+      title: '',
+      description: `
+        <ul>
+          <li>View the number of shipments selected for download</li>
+          <li>Two download list templates are available</li>
+        </ul>
+      `,
+      side: 'bottom'
+    }
+  },
+  {
+    element: '#booking-customize-columns-guide',
+    popover: {
+      title: '',
+      description: `
+        <ul>
+          <li>Drag to right to add columns</li>
+          <li>Drag to left to unselect columns</li>
+          <li>Drag up and down to reorder or select/unselect</li>
+        </ul>
+      `,
+      side: 'bottom'
+    }
+  },
+  {
+    element: '#page-guide-btn-guide',
+    popover: {
+      title: '',
+      description:
+        'After closing, you can still click the "page guide" button to view the page guide of the current page.',
+      side: 'bottom'
+    }
+  }
+]
+
+const guideTimer = ref<ReturnType<typeof setTimeout> | null>(null)
+const { start, moveNext, movePrevious, destroy, hasNextStep, moveTo } = useDriver(steps, {
+  onNextClick: (element, step, options) => {
+    if (options?.state?.activeIndex === 1) {
+      bookingGuideStore.isShowMoreFiltersGuidePhoto = true
+    } else if (options?.state?.activeIndex === 2) {
+      bookingGuideStore.isShowMoreFiltersGuidePhoto = false
+    } else if (options?.state?.activeIndex === 3) {
+      bookingGuideStore.isShowDownloadFileGuidePhoto = true
+    } else if (options?.state?.activeIndex === 4) {
+      bookingGuideStore.isShowDownloadFileGuidePhoto = false
+
+      bookingGuideStore.isShowCustomizeColumnsGuidePhoto = true
+    } else if (options?.state?.activeIndex === 5) {
+      bookingGuideStore.isShowCustomizeColumnsGuidePhoto = false
+    }
+    nextTick(() => {
+      moveNext() // 执行下一步
+    })
+  },
+  onPrevClick: (element, step, options) => {
+    if (options?.state?.activeIndex === 2) {
+      bookingGuideStore.isShowMoreFiltersGuidePhoto = false
+    } else if (options?.state?.activeIndex === 3) {
+      bookingGuideStore.isShowMoreFiltersGuidePhoto = true
+    } else if (options?.state?.activeIndex === 4) {
+      bookingGuideStore.isShowDownloadFileGuidePhoto = false
+    } else if (options?.state?.activeIndex === 5) {
+      bookingGuideStore.isShowDownloadFileGuidePhoto = true
+
+      bookingGuideStore.isShowCustomizeColumnsGuidePhoto = false
+    } else if (options?.state?.activeIndex === 6) {
+      bookingGuideStore.isShowCustomizeColumnsGuidePhoto = true
+    }
+    if (guideTimer.value) {
+      clearTimeout(guideTimer.value)
+      guideTimer.value = null
+    }
+    nextTick(() => {
+      movePrevious() // 执行上一步
+    })
+  },
+  onHighlightStarted: () => {
+    if (!hasNextStep()) {
+      guideTimer.value = setTimeout(() => {
+        destroy()
+      }, 3000)
+    }
+  },
+  onDestroyStarted: (element, step, options) => {
+    bookingGuideStore.isShowFilterGuidePhoto = false
+    bookingGuideStore.isShowMoreFiltersGuidePhoto = false
+    bookingGuideStore.isShowDownloadFileGuidePhoto = false
+    bookingGuideStore.isShowCustomizeColumnsGuidePhoto = false
+    if (hasNextStep()) {
+      moveTo(options.config.steps.length - 1)
+      return
+    }
+    nextTick(() => {
+      destroy() // 销毁导览
+    })
+  },
+  onDestroyed: () => {
+    bookingGuideStore.isShowFilterGuidePhoto = false
+    bookingGuideStore.isShowMoreFiltersGuidePhoto = false
+    bookingGuideStore.isShowDownloadFileGuidePhoto = false
+    bookingGuideStore.isShowCustomizeColumnsGuidePhoto = false
+    if (guideTimer.value) {
+      clearTimeout(guideTimer.value)
+      guideTimer.value = null
+    }
+  }
+})
+const startGuide = () => {
+  bookingGuideStore.isShowFilterGuidePhoto = true // 设置状态
+  nextTick(() => {
+    start() // 开始引导
+  }) // 延时1秒开始引导,确保图片加载完成
+}
+
+defineExpose({
+  startGuide
+})
+</script>
+
+<template>
+  <div>
+    <!-- download-file-guide -->
+    <Teleport to="body">
+      <img
+        id="booking-download-file-guide"
+        v-show="bookingGuideStore.isShowDownloadFileGuidePhoto"
+        class="position-absolute download-file-guide-class"
+        :src="downloadFileImg"
+        alt=""
+      />
+    </Teleport>
+    <!-- customize-columns-guide  -->
+    <Teleport to="body">
+      <img
+        id="booking-customize-columns-guide"
+        v-show="bookingGuideStore.isShowCustomizeColumnsGuidePhoto"
+        class="position-absolute customize-columns-guide-class"
+        :src="customizeColumnsImg"
+        alt=""
+      />
+    </Teleport>
+  </div>
+</template>
+
+<style lang="scss" scoped>
+.position-absolute {
+  position: absolute;
+  z-index: 1200;
+}
+
+.download-file-guide-class {
+  right: 204px;
+  top: 245px;
+  width: 488px;
+  height: 333px;
+}
+.customize-columns-guide-class {
+  right: 24px;
+  top: 246px;
+  width: 515px;
+  height: 353px;
+}
+</style>

+ 7 - 1
src/views/Booking/src/components/BookingTable/src/BookingTable.vue

@@ -70,6 +70,12 @@ const handleColumns = (columns: any, status?: string) => {
         formatter: ({ cellValue }: any) => formatNumber(Number(cellValue), item?.digits)
       }
     }
+    if (item.title === 'Booking No.') {
+      curColumn = {
+        ...curColumn,
+        headerClassName: 'booking-no-header'
+      }
+    }
     return curColumn
   })
   return newColumns
@@ -477,7 +483,7 @@ defineExpose({
           <span style="margin-right: 8px" class="font_family icon-icon_download_b"></span>
           Download
         </el-button>
-        <el-button type="default" @click="handleCustomizeColumns">
+        <el-button style="padding-left: 10px" type="default" @click="handleCustomizeColumns">
           <span style="margin-right: 8px" class="font_family icon-icon_column_b"></span>
           Customize Columns
         </el-button>

+ 182 - 23
src/views/Dashboard/src/DashboardView.vue

@@ -775,24 +775,72 @@ const ClickParams = (val: any) => {
     })
   }
 }
+import kpiChartTip from './guideImage/kpi-chart-tip.png'
+import pendingChartTip from './guideImage/pending-chart-tip.png'
+import etdToEtaChartsTip from './guideImage/etd-to-eta-chart-tip.png'
+import containerChartTip from './guideImage/container-count-chart-tip.png'
+import top10ChartTip from './guideImage/top-10-chart-tip.png'
+import co2eChartTip from './guideImage/co2e-chart-tip.png'
+import revenueSpentChartTip from './guideImage/revenue-spent-chart-tip.png'
+import recentStatusChartTip from './guideImage/recent-status-chart-tip.png'
+
+import DashboardGuide from '../src/components/DashboardGuide.vue'
+import { useGuideStore } from '@/stores/modules/guide'
+import { useThemeStore } from '@/stores/modules/theme'
+
+import viewManagementLight from './guideImage/view-management.png'
+import viewManagementDark from './guideImage/dark-view-management.png'
+import saveConfigLight from './guideImage/save-config-guide.png'
+import saveConfigDark from './guideImage/dark-save-config-guide.png'
+import kpiChartLight from './guideImage/kpi-chart-guide.png'
+import kpiChartDark from './guideImage/dark-kpi-chart-guide.png'
+
+const themeStore = useThemeStore()
+
+const viewManagementImg = computed(() => {
+  return themeStore.theme === 'dark' ? viewManagementDark : viewManagementLight
+})
+const saveConfigImg = computed(() => {
+  return themeStore.theme === 'dark' ? saveConfigDark : saveConfigLight
+})
+const kpiChartImg = computed(() => {
+  return themeStore.theme === 'dark' ? kpiChartDark : kpiChartLight
+})
+const guideStore = useGuideStore()
+const handleGuide = () => {
+  dashboardGuideRef.value?.startGuide()
+}
+const dashboardGuideRef = ref(null)
 </script>
 <template>
   <div class="dashboard">
     <!-- 评分 -->
     <ScoringSystem></ScoringSystem>
+    <DashboardGuide ref="dashboardGuideRef"></DashboardGuide>
     <!-- Title -->
     <div class="Title">
-      <div>Dashboard</div>
+      <div>
+        <span>Dashboard</span>
+        <VDriverGuide style="margin-top: -1px" @click="handleGuide"></VDriverGuide>
+      </div>
+
       <div>
         <el-popover trigger="click" width="400" popper-style="border-radius: 12px">
           <template #reference>
-            <el-button class="el-button--default">
+            <el-button class="el-button--default" style="position: relative">
               <span class="iconfont_icon">
                 <svg class="iconfont" aria-hidden="true">
                   <use xlink:href="#icon-icon_view__management_b"></use>
                 </svg>
               </span>
               View Management
+              <img
+                id="view-management-guide"
+                v-if="guideStore.dashboard.isShowViewManagementGuidePhoto"
+                class="view-management-guide-class"
+                :src="viewManagementImg"
+                alt=""
+              />
             </el-button>
           </template>
           <div class="Management">
@@ -831,6 +879,7 @@ const ClickParams = (val: any) => {
           <template #reference>
             <el-button
               class="el-button--default"
+              style="position: relative"
               @blur="SaveVisible = false"
               @click="SaveVisible = !SaveVisible"
             >
@@ -840,6 +889,15 @@ const ClickParams = (val: any) => {
                 </svg>
               </span>
               Save
+
+              <!-- v-if="guideStore.dashboard.isShowSaveConfigGuidePhoto" -->
+              <img
+                id="save-config-guide"
+                v-if="guideStore.dashboard.isShowSaveConfigGuidePhoto"
+                class="save-config-guide-class"
+                :src="saveConfigImg"
+                alt=""
+              />
               <span class="iconfont_icon">
                 <svg class="iconfont" aria-hidden="true">
                   <use xlink:href="#icon-icon_dropdown_b"></use>
@@ -886,15 +944,32 @@ const ClickParams = (val: any) => {
         <template v-for="item in Management" :key="item">
           <div v-if="item.title === 'KPI' && item.switchValue" class="filters_left">
             <!-- KPI -->
-            <VBox_Dashboard @changeCancel="changeCancel(item.id)">
+            <VBox_Dashboard
+              style="overflow: visible"
+              @changeCancel="changeCancel(item.id)"
+              :isShowDragIconGudie="true"
+            >
               <template #header>
-                <div class="Title_flex">
-                  <span>
+                <div class="Title_flex" style="position: relative">
+                  <img
+                    v-if="guideStore.dashboard.isShowKpiChartGuidePhoto"
+                    id="kpi-chart-guide"
+                    class="kpi-chart-guide-class"
+                    :src="kpiChartImg"
+                    alt=""
+                  />
+                  <div>
                     {{ item.title }}
-                    <!-- <VTipTooltip></VTipTooltip> -->
-                  </span>
+                    <VTipTooltip
+                      :img="kpiChartTip"
+                      :width="410"
+                      :label="'KPI Report:Day difference between actual and estimate.'"
+                      placement="bottom-start"
+                    ></VTipTooltip>
+                  </div>
                   <DashFilters
                     :defaultData="KPIDefaulteData"
+                    :isShowTransportModeGuide="true"
                     @FilterSearch="GetKpiData"
                   ></DashFilters>
                   <!-- <el-tooltip
@@ -940,7 +1015,14 @@ const ClickParams = (val: any) => {
             <VBox_Dashboard @changeCancel="changeCancel(item.id)">
               <template #header>
                 <div class="Title_flex">
-                  {{ item.title }}
+                  <div>
+                    {{ item.title }}
+                    <VTipTooltip
+                      :img="pendingChartTip"
+                      :width="420"
+                      :label="'Pending Report:Showing shipments which are soon to depart/arrive.'"
+                    ></VTipTooltip>
+                  </div>
                   <DashFilters
                     :defaultData="PendingDefaulteData"
                     :radioisDisabled="true"
@@ -981,7 +1063,14 @@ const ClickParams = (val: any) => {
             <VBox_Dashboard @changeCancel="changeCancel(item.id)">
               <template #header>
                 <div class="Title_flex">
-                  {{ item.title }}
+                  <div>
+                    {{ item.title }}
+                    <VTipTooltip
+                      :img="etdToEtaChartsTip"
+                      :width="430"
+                      :label="'ETD to ETA (Days):Distribution of Transit Time (ETA-ETD) for All Shipments in Last 12 Months.'"
+                    ></VTipTooltip>
+                  </div>
                   <DashFilters
                     :defaultData="ETDDefaulteData"
                     @FilterSearch="GetETDEcharts"
@@ -1009,7 +1098,13 @@ const ClickParams = (val: any) => {
             <VBox_Dashboard @changeCancel="changeCancel(item.id)">
               <template #header>
                 <div class="Title_flex">
-                  {{ item.title }}
+                  <div>
+                    {{ item.title }}
+                    <VTipTooltip
+                      :img="containerChartTip"
+                      :label="'Container Count:Total Container Volume by Month (Last 12 Months)'"
+                    ></VTipTooltip>
+                  </div>
                   <DashFilters
                     :defaultData="ContainerefaultData"
                     @FilterSearch="GetContainerCountEcharts"
@@ -1037,15 +1132,23 @@ const ClickParams = (val: any) => {
             <VBox_Dashboard @changeCancel="changeCancel(item.id)" style="width: 100%">
               <template #header>
                 <div class="Title_flex" style="height: 48px">
-                  <el-tabs
-                    v-model="activeName"
-                    class="demo-tabs"
-                    style="height: 48px"
-                    @tab-click="handleTabClick"
-                  >
-                    <el-tab-pane :label="item.title1" name="first"></el-tab-pane>
-                    <el-tab-pane :label="item.title2" name="second"></el-tab-pane>
-                  </el-tabs>
+                  <div style="display: flex">
+                    <el-tabs
+                      v-model="activeName"
+                      class="demo-tabs"
+                      style="height: 48px"
+                      @tab-click="handleTabClick"
+                    >
+                      <el-tab-pane :label="item.title1" name="first"></el-tab-pane>
+                      <el-tab-pane :label="item.title2" name="second"></el-tab-pane>
+                    </el-tabs>
+                    <VTipTooltip
+                      style="margin-left: 4px"
+                      :img="top10ChartTip"
+                      :label="'Top 10 Origin & Destination: Last 12 Months Shipment Volume Rankings: Top 10 Origin Cities and Top 10 Destination Cities'"
+                      :width="700"
+                    ></VTipTooltip>
+                  </div>
                   <DashFilters
                     :defaultData="Top10DefaultData"
                     @FilterSearch="GetTop10ODEcharts"
@@ -1097,7 +1200,14 @@ const ClickParams = (val: any) => {
             <VBox_Dashboard @changeCancel="changeCancel(item.id)">
               <template #header>
                 <div class="Title_flex">
-                  {{ item.title }}
+                  <div>
+                    {{ item.title }}
+                    <VTipTooltip
+                      :img="co2eChartTip"
+                      :label="'CO2e Emission by Origin or Destination: Last 12 Months CO2e Emission Rankings: Top 10 Origin Cities and Top 10 Destination Cities'"
+                      :width="700"
+                    ></VTipTooltip>
+                  </div>
                   <DashFilters
                     :defaultData="Co2OriginDefaultData"
                     @FilterSearch="GetCo2EmissionEcharts"
@@ -1125,7 +1235,10 @@ const ClickParams = (val: any) => {
             <VBox_Dashboard @changeCancel="changeCancel(item.id)">
               <template #header>
                 <div class="Title_flex">
-                  {{ item.title }}
+                  <div>
+                    {{ item.title }}
+                    <!-- <VTipTooltip :img="co2eChartTip"></VTipTooltip> -->
+                  </div>
                   <DashFilters
                     :defaultData="Co2DestinationDefaultData"
                     @FilterSearch="GetCo2DestinationEcharts"
@@ -1159,7 +1272,14 @@ const ClickParams = (val: any) => {
             <VBox_Dashboard @changeCancel="changeCancel(item.id)" style="width: 100%">
               <template #header>
                 <div class="Title_flex">
-                  {{ item.title }}
+                  <div>
+                    {{ item.title }}
+                    <VTipTooltip
+                      :img="recentStatusChartTip"
+                      :label="'Recent Status: Active shipment list with ETD within the past three months and the next month.'"
+                      :width="700"
+                    ></VTipTooltip>
+                  </div>
                   <DashFilters
                     :defaultData="RecentDefaulteData"
                     @FilterSearch="getTableData"
@@ -1190,7 +1310,15 @@ const ClickParams = (val: any) => {
             <VBox_Dashboard @changeCancel="changeCancel(item.id)" style="width: 100%">
               <template #header>
                 <div class="Title_flex">
-                  Revenue Spent
+                  <div>
+                    Revenue Spent
+                    <VTipTooltip
+                      :img="revenueSpentChartTip"
+                      :label="'Revenue Spent: Based on the billto object, display the corresponding revenue data. '"
+                      :width="700"
+                    ></VTipTooltip>
+                  </div>
+
                   <DashFilters
                     :defaultData="RevenueDefaultData"
                     @FilterSearch="GetRevenueEcharts"
@@ -1230,6 +1358,32 @@ const ClickParams = (val: any) => {
 .iconfont {
   vertical-align: -2px;
 }
+
+.view-management-guide-class {
+  position: absolute;
+  top: -1px;
+  right: -17px;
+  width: 343px;
+  height: 478px;
+  z-index: 1500;
+}
+.save-config-guide-class {
+  position: absolute;
+  top: -1px;
+  right: -1px;
+  width: 117px;
+  height: 115px;
+  z-index: 1500;
+}
+.kpi-chart-guide-class {
+  position: absolute;
+  top: -1px;
+  right: -1px;
+  width: 589px;
+  height: 478px;
+  z-index: 3500;
+}
+
 .Management {
   max-height: 640px;
   overflow-y: hidden;
@@ -1423,3 +1577,8 @@ const ClickParams = (val: any) => {
   margin-bottom: 0;
 }
 </style>
+<style lang="scss">
+:not(body):has(> img.driver-active-element) {
+  overflow: visible !important;
+}
+</style>

+ 41 - 5
src/views/Dashboard/src/components/DashFiters.vue

@@ -27,6 +27,10 @@ const props = defineProps({
   isRevenue: {
     type: Boolean,
     default: false
+  },
+  isShowTransportModeGuide: {
+    type: Boolean,
+    default: false
   }
 })
 
@@ -164,6 +168,18 @@ const DateRangeSearch = () => {
   }
   filters_visible.value = false
 }
+
+import { useThemeStore } from '@/stores/modules/theme'
+
+import { useGuideStore } from '@/stores/modules/guide'
+import transportModeLight from '@/views/Dashboard/src/guideImage/transport-mode.png'
+import transportModeDark from '@/views/Dashboard/src/guideImage/dark-transport-mode.png'
+
+const themeStore = useThemeStore()
+const transportModeImg = computed(() => {
+  return themeStore.theme === 'dark' ? transportModeDark : transportModeLight
+})
+const guideStore = useGuideStore()
 </script>
 <template>
   <div class="DashFilters">
@@ -175,7 +191,11 @@ const DateRangeSearch = () => {
       :offset="8"
     >
       <template #reference>
-        <el-button class="el-button--default" @click="filters_visible = !filters_visible">
+        <el-button
+          style="position: relative"
+          class="el-button--default"
+          @click="filters_visible = !filters_visible"
+        >
           <span class="iconfont_icon">
             <svg class="iconfont" aria-hidden="true">
               <use xlink:href="#icon-icon_filter_b"></use>
@@ -187,6 +207,14 @@ const DateRangeSearch = () => {
               <use xlink:href="#icon-icon_dropdown_b"></use>
             </svg>
           </span>
+
+          <img
+            v-if="isShowTransportModeGuide && guideStore.dashboard.isShowTransportModeGuidePhoto"
+            id="transport-mode-guide"
+            :src="transportModeImg"
+            class="transport-mode-guide-class"
+            alt=""
+          />
         </el-button>
       </template>
       <div class="Dash_title">Transport Mode</div>
@@ -277,6 +305,14 @@ const DateRangeSearch = () => {
   display: flex;
   align-items: center;
 }
+.transport-mode-guide-class {
+  position: absolute;
+  right: -1px;
+  top: -2px;
+  width: 417px;
+  height: 314px;
+  z-index: 1000;
+}
 :deep(.el-checkbox-button__inner) {
   color: var(--tag-info-text-color);
   font-size: var(--font-size-3);
@@ -381,10 +417,10 @@ const DateRangeSearch = () => {
   align-items: center;
 }
 :deep(
-    .el-radio-button.is-active
-      .el-radio-button__original-radio:not(:disabled)
-      + .el-radio-button__inner
-  ) {
+  .el-radio-button.is-active
+    .el-radio-button__original-radio:not(:disabled)
+    + .el-radio-button__inner
+) {
   height: 40px;
   display: flex;
   align-items: center;

+ 156 - 0
src/views/Dashboard/src/components/DashboardGuide.vue

@@ -0,0 +1,156 @@
+<script setup lang="ts">
+import { useDriver } from '@/utils/driverGuide'
+import { useGuideStore } from '@/stores/modules/guide'
+
+const guideStore = useGuideStore()
+
+const dashboardGuideStore = guideStore.dashboard
+const steps: any = [
+  {
+    element: '#view-management-guide',
+    popover: {
+      title: '',
+      description:
+        'The Dashboard integrates different types of reports. You can freely select the reports you need. ',
+      side: 'bottom'
+    }
+  },
+  {
+    element: '#transport-mode-guide',
+    popover: {
+      title: '',
+      description:
+        'Each report comes with its own filter options. Simply make your selection and click "Search" to refresh the data. ',
+      side: 'bottom'
+    }
+  },
+  {
+    element: '#kpi-chart-guide',
+    popover: {
+      title: '',
+      description:
+        'Click the icon next to the report name to view the data explanation for each report.',
+      side: 'bottom'
+    }
+  },
+  {
+    element: '#drag-icon-guide',
+    popover: {
+      title: '',
+      description:
+        'Drag and drop reports using the drag handle (eight-dot icon) to reposition them in any direction. ',
+      side: 'bottom'
+    }
+  },
+  {
+    element: '#save-config-guide',
+    popover: {
+      title: '',
+      description: 'Click "Save Layout" to preserve your customized report arrangement.',
+      side: 'bottom'
+    }
+  },
+  {
+    element: '#page-guide-btn-guide',
+    popover: {
+      title: '',
+      description:
+        'After closing, you can still click the "page guide" button to view the page guide of the current page.',
+      side: 'bottom'
+    }
+  }
+]
+
+const guideTimer = ref<ReturnType<typeof setTimeout> | null>(null)
+const { start, moveNext, movePrevious, destroy, hasNextStep, moveTo } = useDriver(steps, {
+  onNextClick: (element, step, options) => {
+    if (options?.state?.activeIndex === 0) {
+      dashboardGuideStore.isShowViewManagementGuidePhoto = false
+      dashboardGuideStore.isShowTransportModeGuidePhoto = true
+    } else if (options?.state?.activeIndex === 1) {
+      dashboardGuideStore.isShowTransportModeGuidePhoto = false
+      dashboardGuideStore.isShowKpiChartGuidePhoto = true
+    } else if (options?.state?.activeIndex === 2) {
+      dashboardGuideStore.isShowKpiChartGuidePhoto = false
+    } else if (options?.state?.activeIndex === 3) {
+      dashboardGuideStore.isShowSaveConfigGuidePhoto = true
+    } else if (options?.state?.activeIndex === 4) {
+      dashboardGuideStore.isShowSaveConfigGuidePhoto = false
+    }
+    nextTick(() => {
+      moveNext() // 执行下一步
+    })
+  },
+  onPrevClick: (element, step, options) => {
+    if (options?.state?.activeIndex === 1) {
+      dashboardGuideStore.isShowViewManagementGuidePhoto = true
+      dashboardGuideStore.isShowTransportModeGuidePhoto = false
+    } else if (options?.state?.activeIndex === 2) {
+      dashboardGuideStore.isShowTransportModeGuidePhoto = true
+      dashboardGuideStore.isShowKpiChartGuidePhoto = false
+    } else if (options?.state?.activeIndex === 3) {
+      dashboardGuideStore.isShowKpiChartGuidePhoto = true
+      dashboardGuideStore.isShowSaveConfigGuidePhoto = false
+    } else if (options?.state?.activeIndex === 4) {
+      dashboardGuideStore.isShowSaveConfigGuidePhoto = false
+    } else if (options?.state?.activeIndex === 5) {
+      dashboardGuideStore.isShowSaveConfigGuidePhoto = true
+    }
+    if (guideTimer.value) {
+      clearTimeout(guideTimer.value)
+      guideTimer.value = null
+    }
+    nextTick(() => {
+      movePrevious() // 执行上一步
+    })
+  },
+  onHighlightStarted: () => {
+    if (!hasNextStep()) {
+      guideTimer.value = setTimeout(() => {
+        destroy()
+      }, 3000)
+    }
+  },
+  // 关闭导览时,隐藏所有图片
+  onDestroyStarted: (element, step, options) => {
+    dashboardGuideStore.isShowViewManagementGuidePhoto = false
+    dashboardGuideStore.isShowTransportModeGuidePhoto = false
+    dashboardGuideStore.isShowSaveConfigGuidePhoto = false
+    dashboardGuideStore.isShowKpiChartGuidePhoto = false
+    if (hasNextStep()) {
+      moveTo(options.config.steps.length - 1)
+      return
+    }
+    // showExtraHighlights.value = false // 隐藏额外高亮
+    nextTick(() => {
+      destroy() // 销毁导览
+    }) // 确保在下一次DOM更新后执行销毁
+  },
+  onDestroyed: () => {
+    dashboardGuideStore.isShowViewManagementGuidePhoto = false
+    dashboardGuideStore.isShowTransportModeGuidePhoto = false
+    dashboardGuideStore.isShowSaveConfigGuidePhoto = false
+    dashboardGuideStore.isShowKpiChartGuidePhoto = false
+    if (guideTimer.value) {
+      clearTimeout(guideTimer.value)
+      guideTimer.value = null
+    }
+  }
+})
+const startGuide = () => {
+  dashboardGuideStore.isShowViewManagementGuidePhoto = true
+  nextTick(() => {
+    start() // 开始引导
+  }) // 延时1秒开始引导,确保图片加载完成
+}
+
+defineExpose({
+  startGuide
+})
+</script>
+
+<template>
+  <div></div>
+</template>
+
+<style lang="scss" scoped></style>

二进制
src/views/Dashboard/src/guideImage/co2e-chart-tip.png


二进制
src/views/Dashboard/src/guideImage/container-count-chart-tip.png


二进制
src/views/Dashboard/src/guideImage/dark-kpi-chart-guide.png


二进制
src/views/Dashboard/src/guideImage/dark-save-config-guide.png


二进制
src/views/Dashboard/src/guideImage/dark-transport-mode.png


二进制
src/views/Dashboard/src/guideImage/dark-view-management.png


二进制
src/views/Dashboard/src/guideImage/etd-to-eta-chart-tip.png


二进制
src/views/Dashboard/src/guideImage/kpi-chart-guide.png


+ 0 - 0
src/views/Dashboard/src/image/kpi-chart-tip.png → src/views/Dashboard/src/guideImage/kpi-chart-tip.png


二进制
src/views/Dashboard/src/guideImage/pending-chart-tip.png


二进制
src/views/Dashboard/src/guideImage/recent-status-chart-tip.png


二进制
src/views/Dashboard/src/guideImage/revenue-spent-chart-tip.png


二进制
src/views/Dashboard/src/guideImage/save-config-guide.png


+ 7 - 0
src/views/Dashboard/src/guideImage/test.vue

@@ -0,0 +1,7 @@
+<script setup lang="ts"></script>
+
+<template>
+  <div></div>
+</template>
+
+<style lang="scss" scoped></style>

二进制
src/views/Dashboard/src/guideImage/top-10-chart-tip.png


二进制
src/views/Dashboard/src/guideImage/transport-mode.png


二进制
src/views/Dashboard/src/guideImage/view-management.png


+ 118 - 58
src/views/Tracking/src/TrackingView.vue

@@ -8,13 +8,7 @@ import MoreFilters from '@/components/MoreFilters'
 import { ref, reactive, onMounted } from 'vue'
 import { useCalculatingHeight } from '@/hooks/calculatingHeight'
 import { useHeaderSearch } from '@/stores/modules/headerSearch'
-import { useDriver } from '@/utils/driverGuide'
 
-const steps = []
-const { start } = useDriver(steps)
-const handleGuide = () => {
-  start() // 开始引导
-}
 const headerSearch = useHeaderSearch()
 
 const filterRef: Ref<HTMLElement | null> = ref(null)
@@ -640,75 +634,91 @@ const SearchInput = () => {
   sessionStorage.setItem('searchTableQeuryTracking', JSON.stringify(searchTableQeuryTracking))
   Gettrackingdata()
 }
+
+import TrackingGuide from './components/TrackingGuide.vue'
+import { useGuideStore } from '@/stores/modules/guide'
+
+const guideStore = useGuideStore()
+const trackingGuideRef = ref()
+const handleGuide = () => {
+  trackingGuideRef.value.startGuide() // 开始引导
+}
 </script>
 
 <template>
   <div class="Title">
     <span>Tracking</span>
-    <!-- <VDriverGuide @click="handleGuide"></VDriverGuide> -->
+    <VDriverGuide @click="handleGuide"></VDriverGuide>
   </div>
-
+  <TrackingGuide ref="trackingGuideRef"></TrackingGuide>
   <div class="display" ref="filterRef">
-    <FilterTags :TagsListItem="TagsList" @changeTag="changeTag"></FilterTags>
-    <div class="heaer_top">
-      <div class="search">
-        <el-input
-          placeholder="Enter Booking/HBL/PO/Container/Carrier Booking No. "
-          v-model="TrackingSearch"
-          class="log_input"
-          @keyup.enter="SearchInput"
-        >
-          <template #prefix>
-            <span class="iconfont_icon">
-              <svg class="iconfont icon_search" aria-hidden="true">
-                <use xlink:href="#icon-icon_search_b"></use>
-              </svg>
-            </span>
-          </template>
-          <template #suffix>
-            <el-tooltip
-              v-if="isShowAlertIcon"
-              :offset="6"
-              popper-class="ShowAlerIcon"
-              effect="dark"
-              content="We support the following references number to find bookings:· Booking No./HAWB No./MAWB No./PO No./Carrier Booking No./Contract No./File No./Quote No."
-              placement="bottom"
+    <div class="filter-box">
+      <div class="filters-container" id="filters-container-guide">
+        <FilterTags :TagsListItem="TagsList" @changeTag="changeTag"></FilterTags>
+        <div class="heaer_top">
+          <div class="search">
+            <el-input
+              placeholder="Enter Booking/HBL/PO/Container/Carrier Booking No. "
+              v-model="TrackingSearch"
+              class="log_input"
+              @keyup.enter="SearchInput"
             >
-              <span class="iconfont_icon iconfont_icon_tip">
-                <svg class="iconfont icon_search" aria-hidden="true">
-                  <use xlink:href="#icon-icon_info_b"></use>
-                </svg>
-              </span>
-            </el-tooltip>
-          </template>
-        </el-input>
+              <template #prefix>
+                <span class="iconfont_icon">
+                  <svg class="iconfont icon_search" aria-hidden="true">
+                    <use xlink:href="#icon-icon_search_b"></use>
+                  </svg>
+                </span>
+              </template>
+              <template #suffix>
+                <el-tooltip
+                  v-if="isShowAlertIcon"
+                  :offset="6"
+                  popper-class="ShowAlerIcon"
+                  effect="dark"
+                  content="We support the following references number to find bookings:· Booking No./HAWB No./MAWB No./PO No./Carrier Booking No./Contract No./File No./Quote No."
+                  placement="bottom"
+                >
+                  <span class="iconfont_icon iconfont_icon_tip">
+                    <svg class="iconfont icon_search" aria-hidden="true">
+                      <use xlink:href="#icon-icon_info_b"></use>
+                    </svg>
+                  </span>
+                </el-tooltip>
+              </template>
+            </el-input>
+          </div>
+
+          <TransportMode
+            :isShipment="true"
+            :TransportListItem="TransportListItem"
+            @TransportSearch="TransportSearch"
+            @defaultTransport="defaultTransport"
+            @clearTransportTags="clearTransportTags"
+          ></TransportMode>
+          <DateRange
+            :isShipment="true"
+            @DateRangeSearch="DateRangeSearch"
+            @clearDaterangeTags="clearDaterangeTags"
+            @defaultDate="defaultDate"
+          ></DateRange>
+        </div>
       </div>
-      <TransportMode
-        :isShipment="true"
-        :TransportListItem="TransportListItem"
-        @TransportSearch="TransportSearch"
-        @defaultTransport="defaultTransport"
-        @clearTransportTags="clearTransportTags"
-      ></TransportMode>
-      <DateRange
-        :isShipment="true"
-        @DateRangeSearch="DateRangeSearch"
-        @clearDaterangeTags="clearDaterangeTags"
-        @defaultDate="defaultDate"
-      ></DateRange>
       <MoreFilters
         :isShipment="true"
         :searchTableQeury="searchTableQeuryTracking"
         @MoreFiltersSearch="MoreFiltersSearch"
         @clearMoreFiltersTags="clearMoreFiltersTags"
         @defaultMorefilters="defaultMorefilters"
+        :isShowMoreFiltersGuidePhoto="guideStore.tracking.isShowMoreFiltersGuidePhoto"
+        :imgGuideId="'more-filters-guide'"
       ></MoreFilters>
       <el-button class="el-button--dark" style="margin-left: 8px" @click="SearchInput"
         >Search</el-button
       >
     </div>
     <!-- 筛选项 -->
-    <div class="filtersTag" v-if="tagsData.length">
+    <div class="filtersTag" v-if="tagsData.length" id="filter-tag-guide">
       <el-tag
         :key="tag"
         class="tag"
@@ -740,6 +750,55 @@ const SearchInput = () => {
 </template>
 
 <style lang="scss" scoped>
+.position-absolute {
+  position: absolute;
+  z-index: 1200;
+}
+.filter-box {
+  width: 100%;
+  display: flex;
+  flex-direction: row;
+  align-items: flex-end;
+  height: 100%;
+}
+.filters-container {
+  max-width: 1426px;
+  width: 80%;
+  display: flex;
+  flex-direction: column;
+}
+.filter-guide-class {
+  top: -3px;
+  left: -2px;
+  height: 29px;
+  width: 592px;
+}
+img.more-filters-guide-class {
+  right: 38px;
+  top: 155px;
+  height: 634px;
+  width: 243px;
+  z-index: 20000;
+}
+.download-file-guide-class {
+  right: 85px;
+  top: 243px;
+  width: 377px;
+  height: 236px;
+}
+.customize-columns-guide-class {
+  right: 8px;
+  top: 249px;
+  width: 694px;
+  height: 474px;
+}
+.tab-filter-guide-class {
+  left: 248px;
+  top: 118px;
+  height: 42px;
+  z-index: 20000;
+}
+
 .Title {
   display: flex;
   height: 68px;
@@ -757,17 +816,18 @@ const SearchInput = () => {
   padding: 0 24px;
 }
 .heaer_top {
+  position: relative;
   margin-top: 6.57px;
-  margin-bottom: 8px;
   display: flex;
 }
 .search {
-  width: 400px;
+  // width: 400px;
   height: 32px;
 }
 .filtersTag {
-  margin-bottom: 8.7px;
-  display: flex;
+  margin-top: 8px;
+  margin-bottom: 4px;
+  display: inline-flex;
   align-items: center;
   flex-wrap: wrap;
 }

+ 84 - 0
src/views/Tracking/src/components/MultiHighlightGuide.vue

@@ -0,0 +1,84 @@
+<template>
+  <teleport to="body">
+    <div style="background-color: red">
+      <div v-for="(item, index) in positionedItems" :key="index">
+        <div class="highlight-box" :style="item.boxStyle"></div>
+        <div class="highlight-tip" :style="item.tipStyle">
+          {{ item.tip }}
+        </div>
+      </div>
+    </div>
+  </teleport>
+</template>
+
+<script setup lang="ts">
+import { onMounted, onBeforeUnmount, ref, watch, nextTick } from 'vue'
+
+interface Item {
+  selector: string
+  tip: string
+}
+
+const props = defineProps<{ items: Item[] }>()
+
+const positionedItems = ref<{ boxStyle: any; tipStyle: any; tip: string }[]>([])
+
+const updatePositions = () => {
+  positionedItems.value = props.items.map(({ selector, tip }) => {
+    const el = document.querySelector(selector) as HTMLElement
+    if (!el) return { boxStyle: {}, tipStyle: {}, tip }
+    const rect = el.getBoundingClientRect()
+    return {
+      tip,
+      boxStyle: {
+        position: 'absolute',
+        top: `${rect.top + window.scrollY}px`,
+        left: `${rect.left + window.scrollX}px`,
+        width: `${rect.width}px`,
+        height: `${rect.height}px`,
+        borderRadius: '6px',
+        zIndex: 99998
+      },
+      tipStyle: {
+        position: 'absolute',
+        top: `${rect.top + window.scrollY - 52}px`,
+        left: `${rect.left + window.scrollX}px`,
+        backgroundColor: 'var(--color-tour-popover-bg)',
+        color: 'var(--color-neutral-1)',
+        padding: '16px',
+        borderRadius: '4px',
+        fontSize: '14px',
+        zIndex: 99999,
+        boxShadow: '0 2px 6px rgba(0, 0, 0, 0.2)'
+      }
+    }
+  })
+}
+
+onMounted(() => {
+  nextTick(updatePositions)
+  window.addEventListener('resize', updatePositions)
+  window.addEventListener('scroll', updatePositions)
+})
+
+onBeforeUnmount(() => {
+  window.removeEventListener('resize', updatePositions)
+  window.removeEventListener('scroll', updatePositions)
+})
+
+watch(
+  () => props.items,
+  () => nextTick(updatePositions),
+  { deep: true }
+)
+</script>
+
+<style scoped>
+.highlight-box {
+  pointer-events: none;
+}
+.highlight-tip {
+  pointer-events: none;
+  position: absolute;
+}
+</style>

+ 53 - 6
src/views/Tracking/src/components/TrackingDetail/src/TrackingDetail.vue

@@ -51,7 +51,7 @@ const oceanSteps: any = [
     element: '#tracking-map',
     popover: {
       description: `
-        <ol style="margin-left: 16px; list-style: disc">
+        <ul>
           <li>Actual Line(Actual Trajectory)</li>
           <li>Virtual Line(Planned Trajectory)</li>
           <li>Arrow (Current Real-time Position)</li>
@@ -65,7 +65,7 @@ const oceanSteps: any = [
     element: '#driver-step-tracking-detail-5',
     popover: {
       description: `
-      <ol style="margin-left: 16px; list-style: disc">
+      <ul>
         <li>Upload Files</li>
         <li>Clickable download icons to download files</li>
       </ol>
@@ -86,6 +86,15 @@ const oceanSteps: any = [
       side: 'bottom',
       align: 'start'
     }
+  },
+  {
+    element: '#page-guide-btn-guide',
+    popover: {
+      title: '',
+      description:
+        'After closing, you can still click the "page guide" button to view the page guide of the current page.',
+      side: 'bottom'
+    }
   }
 ]
 const airSteps: any = [
@@ -110,7 +119,7 @@ const airSteps: any = [
     element: '#tracking-map',
     popover: {
       description: `
-        <ol style="margin-left: 16px; list-style: disc">
+        <ul>
           <li>Actual Line(Actual Trajectory)</li>
           <li>Virtual Line(Planned Trajectory)</li>
           <li>Arrow (Current Real-time Position)</li>
@@ -124,7 +133,7 @@ const airSteps: any = [
     element: '#driver-step-tracking-detail-5',
     popover: {
       description: `
-      <ol style="margin-left: 16px; list-style: disc">
+      <ul>
         <li>Upload Files</li>
         <li>Clickable download icons to download files</li>
       </ol>
@@ -145,8 +154,19 @@ const airSteps: any = [
       side: 'bottom',
       align: 'start'
     }
+  },
+  {
+    element: '#page-guide-btn-guide',
+    popover: {
+      title: '',
+      description:
+        'After closing, you can still click the "page guide" button to view the page guide of the current page.',
+      side: 'bottom'
+    }
   }
 ]
+
+const guideTimer = ref<ReturnType<typeof setTimeout> | null>(null)
 const handleGuide = () => {
   let steps = []
   if (allData.value?.transportInfo?.mode === 'Ocean Freight') {
@@ -156,8 +176,35 @@ const handleGuide = () => {
   } else {
     return
   }
-  const { start } = useDriver(steps)
-  console.log(allData.value?.transportInfo?.mode, 'value')
+  const { start, movePrevious, hasNextStep, moveTo, destroy } = useDriver(steps, {
+    onPrevClick: () => {
+      if (guideTimer.value) {
+        clearTimeout(guideTimer.value)
+        guideTimer.value = null
+      }
+      movePrevious()
+    },
+    onHighlightStarted: () => {
+      if (!hasNextStep()) {
+        guideTimer.value = setTimeout(() => {
+          destroy()
+        }, 3000)
+      }
+    },
+    onDestroyStarted: (element, step, options) => {
+      if (hasNextStep()) {
+        moveTo(options.config.steps.length - 1)
+        return
+      }
+      destroy()
+    },
+    onDestroyed: () => {
+      if (guideTimer.value) {
+        clearTimeout(guideTimer.value)
+        guideTimer.value = null
+      }
+    }
+  })
   start() // 开始引导
 }
 

+ 250 - 0
src/views/Tracking/src/components/TrackingGuide.vue

@@ -0,0 +1,250 @@
+<script setup lang="ts">
+import { useDriver } from '@/utils/driverGuide'
+// import MultiHighlightGuide from './MultiHighlightGuide.vue'
+import { useGuideStore } from '@/stores/modules/guide'
+import { useThemeStore } from '@/stores/modules/theme'
+
+import customizeColumnsImgLight from '../image/customize-columns.png'
+import customizeColumnsImgDark from '../image/dark-customize-columns.png'
+import downloadFileImgLight from '../image/download-guide.png'
+import downloadFileImgDark from '../image/dark-download-guide.png'
+
+const themeStore = useThemeStore()
+const customizeColumnsImg = computed(() => {
+  return themeStore.theme === 'dark' ? customizeColumnsImgDark : customizeColumnsImgLight
+})
+const downloadFileImg = computed(() => {
+  return themeStore.theme === 'dark' ? downloadFileImgDark : downloadFileImgLight
+})
+
+const guideStore = useGuideStore()
+
+const trackingGuideStore = guideStore.tracking
+const steps: any = [
+  {
+    element: '#filters-container-guide',
+    popover: {
+      title: '',
+      description: `Frequently Used Search Criteria Display Area:
+        <ul>
+          <li>Key Booking Status</li>
+          <li>Reference Numbers</li>
+          <li>Transport Mode</li>
+          <li>Date Type & Range</li>
+        </ul>`,
+      side: 'bottom'
+    }
+  },
+  {
+    element: '#filter-tag-guide',
+    popover: {
+      title: '',
+      description: `
+        <ul>
+          <li>Selected query criteria display area</li>
+          <li>You can quickly clear selected conditions at this position</li>
+        </ul>
+      `,
+      side: 'bottom'
+    }
+    // onHighlightStarted: () => {
+    //   showExtraHighlights.value = true
+    // },
+    // onDeselected: () => {
+    //   showExtraHighlights.value = false
+    // }
+  },
+  {
+    element: '#more-filters-guide',
+    popover: {
+      title: '',
+      description: 'Click "more filters" to see more search options.',
+      side: 'left'
+    }
+  },
+  {
+    element: '.hbol-guide-header',
+    popover: {
+      title: '',
+      description:
+        'Click on the HBL No. or double-click anywhere on a single shipment data to enter the detailed page.',
+      side: 'bottom'
+    }
+  },
+  {
+    element: '#download-file-guide',
+    popover: {
+      title: '',
+      description: `
+        <ul>
+          <li>View the number of shipments selected for download</li>
+          <li>Two download list templates are available</li>
+        </ul>
+      `,
+      side: 'bottom'
+    }
+  },
+  {
+    element: '#customize-columns-guide',
+    popover: {
+      title: '',
+      description: `
+        <ul>
+          <li>Drag to right to add columns</li>
+          <li>Drag to left to unselect columns</li>
+          <li>Drag up and down to reorder or select/unselect</li>
+        </ul>
+      `,
+      side: 'bottom'
+    }
+  },
+  {
+    element: '#page-guide-btn-guide',
+    popover: {
+      title: '',
+      description:
+        'After closing, you can still click the "page guide" button to view the page guide of the current page.',
+      side: 'bottom'
+    }
+  }
+]
+
+// const showExtraHighlights = ref(false)
+// const extraHighlightItems = [
+//    { selector: '#tab-filter-guide', tip: 'Select booking status. The default is all.' }
+// ]
+
+const guideTimer = ref<ReturnType<typeof setTimeout> | null>(null)
+const { start, moveNext, movePrevious, destroy, hasNextStep, moveTo } = useDriver(steps, {
+  onNextClick: (element, step, options) => {
+    if (options?.state?.activeIndex === 1) {
+      trackingGuideStore.isShowMoreFiltersGuidePhoto = true
+    } else if (options?.state?.activeIndex === 2) {
+      trackingGuideStore.isShowMoreFiltersGuidePhoto = false
+    } else if (options?.state?.activeIndex === 3) {
+      trackingGuideStore.isShowDownloadFileGuidePhoto = true
+    } else if (options?.state?.activeIndex === 4) {
+      trackingGuideStore.isShowDownloadFileGuidePhoto = false
+
+      trackingGuideStore.isShowCustomizeColumnsGuidePhoto = true
+    } else if (options?.state?.activeIndex === 5) {
+      trackingGuideStore.isShowCustomizeColumnsGuidePhoto = false
+    }
+    nextTick(() => {
+      moveNext() // 执行下一步
+    })
+  },
+  onPrevClick: (element, step, options) => {
+    if (options?.state?.activeIndex === 2) {
+      trackingGuideStore.isShowMoreFiltersGuidePhoto = false
+    } else if (options?.state?.activeIndex === 3) {
+      trackingGuideStore.isShowMoreFiltersGuidePhoto = true
+    } else if (options?.state?.activeIndex === 4) {
+      trackingGuideStore.isShowDownloadFileGuidePhoto = false
+    } else if (options?.state?.activeIndex === 5) {
+      trackingGuideStore.isShowDownloadFileGuidePhoto = true
+      trackingGuideStore.isShowCustomizeColumnsGuidePhoto = false
+    } else if (options?.state?.activeIndex === 6) {
+      trackingGuideStore.isShowCustomizeColumnsGuidePhoto = true
+    }
+    if (guideTimer.value) {
+      clearTimeout(guideTimer.value)
+      guideTimer.value = null
+    }
+    nextTick(() => {
+      movePrevious() // 执行上一步
+    })
+  },
+  onHighlightStarted: () => {
+    if (!hasNextStep()) {
+      guideTimer.value = setTimeout(() => {
+        destroy()
+      }, 3000)
+    }
+  },
+  // 关闭导览时,隐藏所有图片
+  onDestroyStarted: (element, step, options) => {
+    trackingGuideStore.isShowFilterGuidePhoto = false
+    trackingGuideStore.isShowMoreFiltersGuidePhoto = false
+    trackingGuideStore.isShowDownloadFileGuidePhoto = false
+    trackingGuideStore.isShowCustomizeColumnsGuidePhoto = false
+    if (hasNextStep()) {
+      moveTo(options.config.steps.length - 1)
+      return
+    }
+    // showExtraHighlights.value = false // 隐藏额外高亮
+    nextTick(() => {
+      destroy() // 销毁导览
+    }) // 确保在下一次DOM更新后执行销毁
+  },
+  onDestroyed: () => {
+    trackingGuideStore.isShowFilterGuidePhoto = false
+    trackingGuideStore.isShowMoreFiltersGuidePhoto = false
+    trackingGuideStore.isShowDownloadFileGuidePhoto = false
+    trackingGuideStore.isShowCustomizeColumnsGuidePhoto = false
+    if (guideTimer.value) {
+      clearTimeout(guideTimer.value)
+      guideTimer.value = null
+    }
+  }
+})
+const startGuide = () => {
+  trackingGuideStore.isShowFilterGuidePhoto = true
+  nextTick(() => {
+    start() // 开始引导
+  }) // 延时1秒开始引导,确保图片加载完成
+}
+
+defineExpose({
+  startGuide
+})
+</script>
+
+<template>
+  <div>
+    <!-- 多区域自定义高亮组件 -->
+    <!-- <MultiHighlightGuide v-if="showExtraHighlights" :items="extraHighlightItems" /> -->
+
+    <!-- download-file-guide -->
+    <Teleport to="body">
+      <img
+        style="box-shadow: 4px 4px 16px rgba(0, 0, 0, 0.1)"
+        id="download-file-guide"
+        class="position-absolute download-file-guide-class"
+        v-if="trackingGuideStore.isShowDownloadFileGuidePhoto"
+        :src="downloadFileImg"
+        alt=""
+      />
+    </Teleport>
+    <!-- customize-columns-guide -->
+    <Teleport to="body">
+      <img
+        id="customize-columns-guide"
+        v-if="trackingGuideStore.isShowCustomizeColumnsGuidePhoto"
+        class="position-absolute customize-columns-guide-class"
+        :src="customizeColumnsImg"
+        alt=""
+      />
+    </Teleport>
+  </div>
+</template>
+
+<style lang="scss" scoped>
+.position-absolute {
+  position: absolute;
+  z-index: 1200;
+}
+
+.download-file-guide-class {
+  right: 204px;
+  top: 245px;
+  width: 488px;
+  height: 333px;
+}
+.customize-columns-guide-class {
+  right: 24px;
+  top: 246px;
+  width: 515px;
+  height: 353px;
+}
+</style>

+ 8 - 1
src/views/Tracking/src/components/TrackingTable/src/TrackingTable.vue

@@ -67,6 +67,13 @@ const handleColumns = (columns: any, status?: string) => {
         formatter: ({ cellValue }: any) => formatNumber(Number(cellValue), item?.digits)
       }
     }
+
+    if (item.title === 'HBOL/HAWB No.') {
+      curColumn = {
+        ...curColumn,
+        headerClassName: 'hbol-guide-header'
+      }
+    }
     return curColumn
   })
   return newColumns
@@ -590,7 +597,7 @@ defineExpose({
           <span style="margin-right: 8px" class="font_family icon-icon_download_b"></span>
           Download
         </el-button>
-        <el-button type="default" @click="handleCustomizeColumns">
+        <el-button style="padding-left: 10px" type="default" @click="handleCustomizeColumns">
           <span style="margin-right: 8px" class="font_family icon-icon_column_b"></span>
           Customize Columns
         </el-button>

二进制
src/views/Tracking/src/image/customize-columns.png


二进制
src/views/Tracking/src/image/dark-customize-columns.png


二进制
src/views/Tracking/src/image/dark-download-guide.png


二进制
src/views/Tracking/src/image/dark-more-filters-guide.png


二进制
src/views/Tracking/src/image/download-guide.png


二进制
src/views/Tracking/src/image/more-filters-guide.png


+ 7 - 0
src/views/Tracking/src/image/test.vue

@@ -0,0 +1,7 @@
+<script setup lang="ts"></script>
+
+<template>
+  <div></div>
+</template>
+
+<style lang="scss" scoped></style>