滑鼠立體時鐘 Mouse Clock

一個會跟著滑鼠跑的類比時鐘:鐘面數字、時針、分針、秒針一個字一個字拖著跑,外圈還有一圈旋轉的日期。這是 1990 年代末很多個人網頁都會放的經典效果,原作是 Kurt Grigg 的 Silly Clock 3,台灣的「網頁建置百寶箱」收錄過中文化版本。

這個版本由唐宋打油改寫,用在〈平淡文章的華麗產地:敲敲打打的工坊✨BBP 11〉。和原版相比:

  • 一個檔案、一行就能放進網頁,不用改任何程式。
  • 手機也能用:手指在畫面上滑動,時鐘會出現在手指上方(不會被手掌擋住)。
  • 顏色、大小、位置、速度、日期語言(中文/英文)都可以設定。
  • 分頁在背景時不計算;系統開啟「減少動態」的使用者預設不顯示。
  • 可以用程式開關(MouseClock.start()、MouseClock.stop())。

檔案

檔案 用途
mouse-clock.js 時鐘本體,只需要這個檔案
index.html 範例頁,下載後用瀏覽器打開就能試

放置教學

方法一:上傳檔案再引用(推薦)

  1. 下載 mouse-clock.js(在檔案頁按「原始檔」或「下載」)。
  2. 上傳到你的網站,例如放在網站根目錄的 js/ 資料夾。
  3. 在網頁的 </body> 前面加一行:
<script src="/js/mouse-clock.js"></script>

完成。重新整理網頁,移動滑鼠就會看到時鐘。

請不要直接引用本站(code.tsdylab.com)的檔案網址當作 src:程式碼平台送出的檔案類型是純文字,瀏覽器會拒絕執行;而且這個網址之後可能變動。請下載後放在自己的網站。

方法二:直接貼進網頁(沒辦法上傳檔案時)

打開 mouse-clock.js,全選複製,貼在網頁 </body> 前面,並用 <script> 包起來:

<script>
/* 這裡貼上 mouse-clock.js 的全部內容 */
</script>

各平台放法

WordPress

  • 只想在某一篇文章出現:編輯文章 → 新增「自訂 HTML」區塊 → 用方法二貼上。
  • 想全站都有:用「WPCode」這類可以在頁尾插入程式碼的外掛,把方法一的 <script> 那一行(或方法二整段)放進「頁尾(Footer)」。檔案可以先從「媒體 → 新增」上傳;WordPress 預設不允許上傳 .js,這時改用方法二。

Typecho

  • 只想在某一篇文章出現:在文章最後用方法二貼上。Typecho 預設會把文章裡的 HTML 原樣輸出;如果被當成文字顯示,在那段程式碼的開頭與結尾各加一行 !!!。
  • 想全站都有:把 mouse-clock.js 上傳到佈景主題資料夾,在主題的 footer.php 的 </body> 前加上:
    <script src="<?php $this->options->themeUrl('mouse-clock.js'); ?>"></script>
    

Blogger 版面配置 → 新增小工具 → 「HTML/JavaScript」→ 用方法二貼上 → 儲存。

Hugo/Hexo/Jekyll 等靜態網站 把 mouse-clock.js 放進靜態檔案資料夾(Hugo 是 static/js/、Hexo 是 source/js/、Jekyll 是 assets/js/),再在佈景主題的頁尾樣板加上方法一的那一行。

不能用的地方 Medium、方格子、Notion、Facebook 這類平台不允許文章放自己的 JavaScript,沒辦法使用。


設定

在 <script> 標籤加上 data- 屬性就能調整,例如換成柔和的顏色、日期改英文:

<script src="/js/mouse-clock.js"
        data-hour-color="#b5532f"
        data-minute-color="#33568b"
        data-second-color="#3f8f57"
        data-face-color="#555555"
        data-date-color="#999999"
        data-lang="en"></script>
屬性 預設 說明
data-date-color #000000 外圈日期的顏色
data-face-color #0000ff 鐘面數字 1~12 的顏色
data-hour-color #ff0000 時針顏色
data-minute-color #0000ff 分針顏色
data-second-color #00ff00 秒針顏色
data-size 40 鐘面半徑(px),日期環是它的 1.5 倍
data-offset-x 80 電腦:時鐘中心在游標右邊幾 px(負數=左邊)
data-offset-y 80 電腦:時鐘中心在游標下面幾 px(負數=上面)
data-touch-offset-x 0 手機:時鐘中心相對手指的水平位置
data-touch-offset-y -110 手機:時鐘中心相對手指的垂直位置(預設在手指上方)
data-speed 0.3 跟隨速度 0~1,越小拖得越長(原版是 0.6)
data-date-speed 0.015 日期環旋轉速度(原版是 0.06)
data-lang zh-TW 日期語言:zh-TW(2026年 十一月 20日 星期五)或 en(FRIDAY 20 NOVEMBER 2026)
data-z-index 9999 疊放順序;時鐘被網站的選單蓋住時調大
data-reduced-motion hide 使用者在系統開啟「減少動態」時:hide 不顯示,show 照常顯示

用程式控制

在 <script> 加上 data-manual,時鐘就不會自動出現,改由你決定什麼時候啟動:

<script src="/js/mouse-clock.js" data-manual></script>
<button onclick="MouseClock.start({ hourColor: '#c00', lang: 'en' })">開啟時鐘</button>
<button onclick="MouseClock.stop()">關閉時鐘</button>

MouseClock.start(設定) 的設定名稱和上表相同,只是改成駝峰寫法(data-hour-color → hourColor)。重複呼叫 start() 會先關掉舊的再開新的。


常見問題

時鐘沒有出現?

  • 確認 src 的路徑對:直接在瀏覽器打開那個網址,應該要看到程式碼。
  • 手機要先用手指在畫面上點一下或滑動,時鐘才會跑到手指附近;一開始會在畫面正中央。
  • 系統有開「減少動態」的話預設不顯示,可以加 data-reduced-motion="show"。

時鐘被網站的選單或標題列蓋住? 加大 data-z-index,例如 99999。

會影響網頁的點擊嗎? 不會。時鐘的每個字都設定成滑鼠點不到(pointer-events: none),也不會被螢幕閱讀器念出來。


授權與致謝

改寫的部分以 MIT 授權釋出,歡迎自由使用、修改、放在任何網站(包含商業網站)。原作的時鐘設計與演算法屬於 Kurt Grigg,請保留 mouse-clock.js 開頭的註解,讓原作者的名字繼續被看見。詳見 LICENSE。

S
Description
No description provided
Readme
138 KiB
0 Stars 1 Watchers 0 Forks
Languages
HTML 70.2%
JavaScript 29.8%