139 lines
6.7 KiB
Markdown
139 lines
6.7 KiB
Markdown
# 滑鼠立體時鐘 Mouse Clock
|
||||
|
|
|
|||
|
|
一個會跟著滑鼠跑的類比時鐘:鐘面數字、時針、分針、秒針一個字一個字拖著跑,外圈還有一圈旋轉的日期。這是 1990 年代末很多個人網頁都會放的經典效果,原作是 Kurt Grigg 的 **Silly Clock 3**,台灣的「網頁建置百寶箱」收錄過中文化版本。
|
|||
|
|
|
|||
|
|
這個版本由[唐宋打油](https://tsdylab.com/)改寫,用在〈[平淡文章的華麗產地:敲敲打打的工坊✨BBP 11](https://tsdylab.com/savepoint/tinkering-workshop/)〉。和原版相比:
|
|||
|
|
|
|||
|
|
- 一個檔案、一行就能放進網頁,不用改任何程式。
|
|||
|
|
- 手機也能用:手指在畫面上滑動,時鐘會出現在手指上方(不會被手掌擋住)。
|
|||
|
|
- 顏色、大小、位置、速度、日期語言(中文/英文)都可以設定。
|
|||
|
|
- 分頁在背景時不計算;系統開啟「減少動態」的使用者預設不顯示。
|
|||
|
|
- 可以用程式開關(`MouseClock.start()`、`MouseClock.stop()`)。
|
|||
|
|
|
|||
|
|
## 檔案
|
|||
|
|
|
|||
|
|
| 檔案 | 用途 |
|
|||
|
|
| --- | --- |
|
|||
|
|
| `mouse-clock.js` | 時鐘本體,只需要這個檔案 |
|
|||
|
|
| `index.html` | 範例頁,下載後用瀏覽器打開就能試 |
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 放置教學
|
|||
|
|
|
|||
|
|
### 方法一:上傳檔案再引用(推薦)
|
|||
|
|
|
|||
|
|
1. 下載 `mouse-clock.js`(在檔案頁按「原始檔」或「下載」)。
|
|||
|
|
2. 上傳到你的網站,例如放在網站根目錄的 `js/` 資料夾。
|
|||
|
|
3. 在網頁的 `</body>` 前面加一行:
|
|||
|
|
|
|||
|
|
```html
|
|||
|
|
<script src="/js/mouse-clock.js"></script>
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
完成。重新整理網頁,移動滑鼠就會看到時鐘。
|
|||
|
|
|
|||
|
|
> 請不要直接引用本站(code.tsdylab.com)的檔案網址當作 `src`:程式碼平台送出的檔案類型是純文字,瀏覽器會拒絕執行;而且這個網址之後可能變動。請下載後放在自己的網站。
|
|||
|
|
|
|||
|
|
### 方法二:直接貼進網頁(沒辦法上傳檔案時)
|
|||
|
|
|
|||
|
|
打開 `mouse-clock.js`,全選複製,貼在網頁 `</body>` 前面,並用 `<script>` 包起來:
|
|||
|
|
|
|||
|
|
```html
|
|||
|
|
<script>
|
|||
|
|
/* 這裡貼上 mouse-clock.js 的全部內容 */
|
|||
|
|
</script>
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 各平台放法
|
|||
|
|
|
|||
|
|
**WordPress**
|
|||
|
|
- 只想在某一篇文章出現:編輯文章 → 新增「自訂 HTML」區塊 → 用方法二貼上。
|
|||
|
|
- 想全站都有:用「WPCode」這類可以在頁尾插入程式碼的外掛,把方法一的 `<script>` 那一行(或方法二整段)放進「頁尾(Footer)」。檔案可以先從「媒體 → 新增」上傳;WordPress 預設不允許上傳 `.js`,這時改用方法二。
|
|||
|
|
|
|||
|
|
**Typecho**
|
|||
|
|
- 只想在某一篇文章出現:在文章最後用方法二貼上。Typecho 預設會把文章裡的 HTML 原樣輸出;如果被當成文字顯示,在那段程式碼的開頭與結尾各加一行 `!!!`。
|
|||
|
|
- 想全站都有:把 `mouse-clock.js` 上傳到佈景主題資料夾,在主題的 `footer.php` 的 `</body>` 前加上:
|
|||
|
|
```php
|
|||
|
|
<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-` 屬性就能調整,例如換成柔和的顏色、日期改英文:
|
|||
|
|
|
|||
|
|
```html
|
|||
|
|
<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`,時鐘就不會自動出現,改由你決定什麼時候啟動:
|
|||
|
|
|
|||
|
|
```html
|
|||
|
|
<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`),也不會被螢幕閱讀器念出來。
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 授權與致謝
|
|||
|
|
|
|||
|
|
- 原作:**Silly Clock 3**,Kurt Grigg。
|
|||
|
|
- 中文化:網頁建置百寶箱 JavaScript 收集區(已停站)。原始碼參考自[國立臺灣海洋大學教學頁](http://squall.cs.ntou.edu.tw/Dreamweaver5/2-09MouseClockJavaScript.htm)。
|
|||
|
|
- 改寫:唐宋打油([tsdylab.com](https://tsdylab.com/)),2026。
|
|||
|
|
|
|||
|
|
改寫的部分以 MIT 授權釋出,歡迎自由使用、修改、放在任何網站(包含商業網站)。原作的時鐘設計與演算法屬於 Kurt Grigg,請保留 `mouse-clock.js` 開頭的註解,讓原作者的名字繼續被看見。詳見 [LICENSE](LICENSE)。
|