diff --git a/README.md b/README.md index 57dda4d..811f9c0 100644 --- a/README.md +++ b/README.md @@ -10,14 +10,14 @@ - 分頁在背景時不計算;系統開啟「減少動態」的使用者預設不顯示。 - 可以用程式開關(`MouseClock.start()`、`MouseClock.stop()`)。 -**線上範例:** +**線上編輯器:**——在網頁上調整顏色、大小、位置、速度,即時預覽,再一鍵複製或下載已經含設定的程式碼。不想手動改設定的話,從這裡開始最快。 ## 檔案 | 檔案 | 用途 | | --- | --- | | `mouse-clock.js` | 時鐘本體,只需要這個檔案 | -| `index.html` | 範例頁,下載後用瀏覽器打開就能試 | +| `index.html` | 線上編輯器(調整設定、預覽、複製程式碼)。要用網站伺服器打開,「完整內嵌」與下載才讀得到 `mouse-clock.js` | --- @@ -103,6 +103,17 @@ Medium、方格子、Notion、Facebook 這類平台不允許文章放自己的 J | `data-z-index` | `9999` | 疊放順序;時鐘被網站的選單蓋住時調大 | | `data-reduced-motion` | `hide` | 使用者在系統開啟「減少動態」時:`hide` 不顯示,`show` 照常顯示 | +### 用 `window.MouseClockOptions` 設定(1.1.0 起) + +不方便加 `data-` 屬性時(例如用「完整內嵌」貼進文章),可以在載入 `mouse-clock.js` 之前先寫好設定,名稱用駝峰寫法(見下一節)。同時有 `data-` 屬性的話以 `data-` 屬性為準。線上編輯器產生的「完整內嵌」程式碼就是這種寫法。 + +```html + + +``` + ### 用程式控制 在 ` +
+
+ 設定 點這裡收合 + +
+ 預設配色 +
+ +
+ +
+ 顏色 +
+
+ +
+ 大小與速度 +
+
+ +
+ 位置(電腦,相對滑鼠) +
+
+ +
+ 位置(手機,相對手指) +
+

負數的垂直位置=在手指上方,避免被手掌擋住。

+
+ +
+ 其他 +
+ + +
+
+ + +
+
+ + +
+

疊放順序:時鐘被網站選單蓋住時調大。

+ +
+
+ +
+
+

試玩區

+
+
+ 移動滑鼠,或用手指在畫面上滑動 + 時鐘會跟著你。電腦在游標右下方,手機在手指上方。 +
+
+
+ 預覽底色: + + + +
+
+ +
+

取得程式碼

+
+ + +
+
+

+ + +
+ + + + + +
+
+
+ +
+

怎麼放到網站上

+
    +
  1. 選上面的形式:能上傳檔案就用「一行引用」,先下載 mouse-clock.js 上傳到網站,再把那一行的 src 改成檔案位置;不能上傳就用「完整內嵌」。
  2. +
  3. 把程式碼貼在網頁 </body> 前面(或文章最後的 HTML 區塊)。
  4. +
  5. 重新整理網頁,移動滑鼠就會看到時鐘。
  6. +
+

WordPress、Typecho、Blogger、Hugo/Hexo 等平台的詳細放法,以及常見問題,請看 Gitea 上的說明(README)。Medium、方格子、Notion 這類不允許自訂 JavaScript 的平台無法使用。

+
+
+
+ + + + + diff --git a/mouse-clock.js b/mouse-clock.js index 95a50e2..b6059c2 100644 --- a/mouse-clock.js +++ b/mouse-clock.js @@ -1,5 +1,5 @@ /*! - * 滑鼠立體時鐘 Mouse Clock 1.0.0 + * 滑鼠立體時鐘 Mouse Clock 1.1.0 * https://code.tsdylab.com/tangsongdayo/mouse-clock * * 原作:Silly Clock 3 by Kurt Grigg @@ -177,11 +177,15 @@ } var current = document.currentScript; - window.MouseClock = { start: start, stop: function () { if (running) running.stop(); }, defaults: DEFAULTS }; + // 1.1.0:在載入前設定 window.MouseClockOptions = {...} 也可以調整(data-* 屬性優先) + var preset = window.MouseClockOptions; + window.MouseClock = { version: '1.1.0', start: start, stop: function () { if (running) running.stop(); }, defaults: DEFAULTS }; // 加上 data-manual 就不自動啟動,改由 MouseClock.start({...}) 啟動 if (!(current && current.dataset && current.dataset.manual !== undefined)) { - var opts = fromScriptTag(current); + var opts = {}, tagOpts = fromScriptTag(current), key; + if (preset && typeof preset === 'object') for (key in preset) opts[key] = preset[key]; + for (key in tagOpts) opts[key] = tagOpts[key]; if (document.body) start(opts); else document.addEventListener('DOMContentLoaded', function () { start(opts); }); }