From e7b6dc736f4607d153ac93bb3b67ea59ac0f43eb Mon Sep 17 00:00:00 2001
From: xudan <staysky25@outlook.com>
Date: Mon, 29 Sep 2025 17:40:12 +0800
Subject: [PATCH] =?UTF-8?q?feat:=20=E5=9C=A8=E6=92=AD=E6=94=BE=E6=8E=A7?=
 =?UTF-8?q?=E5=88=B6=E5=99=A8=E4=B8=AD=E6=B7=BB=E5=8A=A0=E6=97=B6=E9=97=B4?=
 =?UTF-8?q?=E8=BD=B4=E9=80=BB=E8=BE=91=E5=92=8C=E5=B0=8F=E6=97=B6=E9=80=89?=
 =?UTF-8?q?=E6=8B=A9=E5=99=A8=EF=BC=8C=E4=BC=98=E5=8C=96=E6=92=AD=E6=94=BE?=
 =?UTF-8?q?=E6=97=B6=E9=97=B4=E5=90=8C=E6=AD=A5=E5=92=8C=E7=95=8C=E9=9D=A2?=
 =?UTF-8?q?=E4=BA=A4=E4=BA=92?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 src/components/PlaybackController.vue | 173 ++++++++++++++++++++++++--
 src/hooks/useTimeFormat.ts            |  26 ++++
 src/hooks/useTimelineTicks.ts         |  56 +++++++++
 3 files changed, 242 insertions(+), 13 deletions(-)
 create mode 100644 src/hooks/useTimeFormat.ts
 create mode 100644 src/hooks/useTimelineTicks.ts

diff --git a/src/components/PlaybackController.vue b/src/components/PlaybackController.vue
index 62a72e9..1e6530d 100644
--- a/src/components/PlaybackController.vue
+++ b/src/components/PlaybackController.vue
@@ -1,6 +1,8 @@
 <script setup lang="ts">
 import { CaretRightOutlined, PauseOutlined } from '@ant-design/icons-vue';
-import { computed } from 'vue';
+import { computed, ref, watch } from 'vue';
+
+import { useTimelineTicks } from '../hooks/useTimelineTicks';
 
 const props = defineProps<{
   isPlaying: boolean;
@@ -14,11 +16,36 @@ const emit = defineEmits<{
   (e: 'seek', time: number): void;
 }>();
 
-// --- Computed properties for display ---
+// --- Constants ---
+const SLIDER_PADDING = 8; // Ant Design Slider has 8px padding on each side
+const HOUR_IN_MS = 3600 * 1000;
+
+// --- Internal State ---
+const internalCurrentTime = ref(props.currentTime);
+const selectedHour = ref(Math.floor(props.currentTime / HOUR_IN_MS));
+
+// --- Computed View Range ---
+const viewStartTime = computed(() => selectedHour.value * HOUR_IN_MS);
+const viewEndTime = computed(() => viewStartTime.value + HOUR_IN_MS);
+
+// --- Ticks Logic ---
+const { ticks } = useTimelineTicks(viewStartTime, viewEndTime);
+
+// --- Sync internal time with external prop ---
+watch(
+  () => props.currentTime,
+  (newValue) => {
+    internalCurrentTime.value = newValue;
+    const newHour = Math.floor(newValue / HOUR_IN_MS);
+    if (newHour !== selectedHour.value) {
+      selectedHour.value = newHour;
+    }
+  },
+);
+
+// --- Computed properties for display and binding ---
 const formatTime = (ms: number): string => {
-  if (isNaN(ms) || ms < 0) {
-    return '00:00:00';
-  }
+  if (isNaN(ms) || ms < 0) return '00:00:00';
   const totalSeconds = Math.floor(ms / 1000);
   const hours = Math.floor(totalSeconds / 3600);
   const minutes = Math.floor((totalSeconds % 3600) / 60);
@@ -26,16 +53,54 @@ const formatTime = (ms: number): string => {
   return `${String(hours).padStart(2, '0')}:${String(minutes).padStart(2, '0')}:${String(seconds).padStart(2, '0')}`;
 };
 
-const currentTimeFormatted = computed(() => formatTime(props.currentTime));
+const currentTimeFormatted = computed(() => formatTime(internalCurrentTime.value));
 const totalDurationFormatted = computed(() => formatTime(props.totalDuration));
 
 const sliderValue = computed({
-  get: () => props.currentTime,
+  get: () => internalCurrentTime.value,
   set: (val: number) => {
+    internalCurrentTime.value = val;
     emit('seek', val);
   },
 });
 
+const playheadPosition = computed(() => {
+  if (!props.totalDuration) return '0%';
+  const relativeTime = internalCurrentTime.value - viewStartTime.value;
+  const viewDuration = viewEndTime.value - viewStartTime.value;
+  return `${(relativeTime / viewDuration) * 100}%`;
+});
+
+const hourOptions = computed(() => {
+  const numHours = Math.ceil(props.totalDuration / HOUR_IN_MS);
+  return Array.from({ length: numHours }, (_, i) => {
+    const start = formatTime(i * HOUR_IN_MS).substring(0, 5);
+    const end = formatTime((i + 1) * HOUR_IN_MS).substring(0, 5);
+    return {
+      value: i,
+      label: `${start} - ${end}`,
+    };
+  });
+});
+
+// --- Event Handlers ---
+const timelineContainerRef = ref<HTMLElement | null>(null);
+
+const handleTimelineClick = (event: MouseEvent) => {
+  if (!timelineContainerRef.value || !props.totalDuration) return;
+
+  const rect = timelineContainerRef.value.getBoundingClientRect();
+  const effectiveWidth = rect.width - SLIDER_PADDING * 2;
+  const clickX = event.clientX - rect.left - SLIDER_PADDING;
+
+  const percentage = Math.max(0, Math.min(1, clickX / effectiveWidth));
+  const newTimeInView = percentage * HOUR_IN_MS;
+  const newAbsoluteTime = viewStartTime.value + newTimeInView;
+
+  internalCurrentTime.value = newAbsoluteTime;
+  emit('seek', newAbsoluteTime);
+};
+
 const handlePlayPause = () => {
   if (props.isPlaying) {
     emit('pause');
@@ -65,14 +130,34 @@ const handlePlayPause = () => {
         </a-typography-text>
       </a-col>
 
+      <!-- Hour Selector -->
+      <a-col>
+        <a-select v-model:value="selectedHour" style="width: 150px" :options="hourOptions" />
+      </a-col>
+
       <!-- Timeline Slider -->
       <a-col flex="1">
-        <a-slider
-          v-model:value="sliderValue"
-          :max="totalDuration"
-          :tip-formatter="formatTime as any"
-          :tooltip-open="false"
-        />
+        <div class="timeline-container" ref="timelineContainerRef" @click="handleTimelineClick">
+          <div class="timeline-ticks">
+            <div class="playhead-marker" :style="{ left: playheadPosition }"></div>
+            <span
+              v-for="(tick, index) in ticks"
+              :key="index"
+              class="tick"
+              :class="{ 'tick-major': tick.isMajor }"
+              :style="{ left: tick.position }"
+            >
+              <span v-if="tick.label" class="tick-label">{{ tick.label }}</span>
+            </span>
+          </div>
+          <a-slider
+            v-model:value="sliderValue"
+            :min="viewStartTime"
+            :max="viewEndTime"
+            :tip-formatter="formatTime as any"
+            :tooltip-open="false"
+          />
+        </div>
       </a-col>
     </a-row>
   </div>
@@ -102,4 +187,66 @@ const handlePlayPause = () => {
   font-size: 14px;
   min-width: 180px; // Prevents layout shift
 }
+
+.timeline-container {
+  position: relative;
+  padding-top: 20px; // Space for tick labels
+  margin-bottom: 5px;
+  cursor: pointer;
+}
+
+.playhead-marker {
+  position: absolute;
+  top: 0;
+  bottom: 0;
+  width: 1px;
+  background-color: red;
+  pointer-events: none;
+  z-index: 5;
+  transition: left 0.1s linear;
+}
+
+.timeline-ticks {
+  position: absolute;
+  top: 0;
+  left: 8px;
+  right: 8px;
+  height: 20px;
+  pointer-events: none;
+}
+
+.tick {
+  position: absolute;
+  bottom: 0;
+  width: 1px;
+  height: 6px;
+  background-color: #a0a0a0;
+
+  &.tick-major {
+    height: 10px;
+    background-color: #333;
+  }
+}
+
+.tick-label {
+  position: absolute;
+  bottom: 12px;
+  left: 50%;
+  transform: translateX(-50%);
+  font-size: 12px;
+  color: #555;
+  white-space: nowrap;
+}
+
+body[data-theme='dark'] {
+  .tick {
+    background-color: #777;
+    &.tick-major {
+      background-color: #ddd;
+    }
+  }
+  .tick-label {
+    color: #aaa;
+  }
+}
 </style>
diff --git a/src/hooks/useTimeFormat.ts b/src/hooks/useTimeFormat.ts
new file mode 100644
index 0000000..5806343
--- /dev/null
+++ b/src/hooks/useTimeFormat.ts
@@ -0,0 +1,26 @@
+// src/hooks/useTimeFormat.ts
+
+/**
+ * Formats seconds into a HH:mm:ss time string.
+ * @param seconds The total seconds.
+ * @returns A string in HH:mm:ss format.
+ */
+export function useTimeFormat() {
+  const formatTime = (seconds: number): string => {
+    if (isNaN(seconds) || seconds < 0) {
+      return '00:00:00';
+    }
+
+    const h = Math.floor(seconds / 3600);
+    const m = Math.floor((seconds % 3600) / 60);
+    const s = Math.floor(seconds % 60);
+
+    const pad = (num: number) => num.toString().padStart(2, '0');
+
+    return `${pad(h)}:${pad(m)}:${pad(s)}`;
+  };
+
+  return {
+    formatTime,
+  };
+}
diff --git a/src/hooks/useTimelineTicks.ts b/src/hooks/useTimelineTicks.ts
new file mode 100644
index 0000000..443356b
--- /dev/null
+++ b/src/hooks/useTimelineTicks.ts
@@ -0,0 +1,56 @@
+import { computed, type Ref } from 'vue';
+
+export interface Tick {
+  position: string; // Percentage position within the view
+  label: string | null;
+  isMajor: boolean;
+}
+
+// Formats time as hh:mm for labels
+const formatLabelTime = (ms: number): string => {
+  const totalSeconds = Math.floor(ms / 1000);
+  const hours = Math.floor(totalSeconds / 3600);
+  const minutes = Math.floor((totalSeconds % 3600) / 60);
+  const pad = (num: number) => num.toString().padStart(2, '0');
+  return `${pad(hours)}:${pad(minutes)}`;
+};
+
+export function useTimelineTicks(viewStartTime: Ref<number>, viewEndTime: Ref<number>) {
+  const ticks = computed<Tick[]>(() => {
+    const startTime = viewStartTime.value;
+    const endTime = viewEndTime.value;
+    const viewDuration = endTime - startTime;
+
+    if (isNaN(startTime) || isNaN(endTime) || viewDuration <= 0) {
+      return [];
+    }
+
+    const result: Tick[] = [];
+
+    // For a 1-hour view, we use fixed intervals
+    const majorTickInterval = 10 * 60 * 1000; // Every 10 minutes for labels
+    const minorTickInterval = 1 * 60 * 1000; // Every 1 minute for small ticks
+
+    for (let time = startTime; time <= endTime; time += minorTickInterval) {
+      // Ensure we only create ticks at exact minute marks relative to the start of the day
+      if (time % minorTickInterval !== 0) {
+        continue;
+      }
+
+      const relativeTime = time - startTime;
+      const isMajor = time % majorTickInterval === 0;
+
+      result.push({
+        position: `${(relativeTime / viewDuration) * 100}%`,
+        label: isMajor ? formatLabelTime(time) : null,
+        isMajor,
+      });
+    }
+
+    return result;
+  });
+
+  return {
+    ticks,
+  };
+}