要在網頁上放一個「可以記事」的小行事曆,資料存哪裡是個問題。沒有後端、不想讓訪客註冊,最省事的做法就是把資料寫進瀏覽器的 Cookie。這段腳本示範的正是這套思路:把整月的 31 天串成一份清單存進 Cookie,需要讀寫某一天時再用分隔字元定位。
仔細看 initCookie(),它做的事就是把 1 到 31 天拼成一串 ^1^^2^^3^…^31^ 格式的字串,然後寫進名為「月名 + Calendar」的 Cookie。用 ^ 這種不會出現在一般中文記事內容裡的字元當哨兵,是為了後續能靠 indexOf 精準切出某一天的區段,不必解析整份 JSON(那個年代 JSON 也還不普及)。
整份腳本的地基是 Cookie 的讀、寫、刪三件事:
var caution = false;
function setCookie(name, value, expires, path, domain, secure) {
var curCookie = name + "=" + escape(value)
+ ((expires) ? "; expires=" + expires.toGMTString() : "")
+ ((path) ? "; path=" + path : "")
+ ((domain) ? "; domain=" + domain : "")
+ ((secure) ? "; secure" : "");
if (!caution || (name + "=" + escape(value)).length <= 4000)
document.cookie = curCookie;
else if (confirm("Cookie exceeds 4KB and will be cut!"))
document.cookie = curCookie;
}
function getCookie(name) {
var prefix = name + "=";
var cookieStartIndex = document.cookie.indexOf(prefix);
if (cookieStartIndex == -1) return null;
var cookieEndIndex = document.cookie.indexOf(";", cookieStartIndex + prefix.length);
if (cookieEndIndex == -1) cookieEndIndex = document.cookie.length;
return unescape(document.cookie.substring(cookieStartIndex + prefix.length, cookieEndIndex));
}
function deleteCookie(name, path, domain) {
if (getCookie(name)) {
document.cookie = name + "=" + ((path) ? "; path=" + path : "")
+ ((domain) ? "; domain=" + domain : "")
+ "; expires=Thu, 01-Jan-70 00:00:01 GMT";
}
}
這裡有兩個值得記下的細節。第一,setCookie 裡那段 4KB 判斷,是因為 Cookie 有大小上限,寫入前先量一下長度、超了就跳確認框,避免資料被瀏覽器默默截斷。第二,deleteCookie 的標準手法就是把過期時間設到 1970 年——瀏覽器沒有「刪除 Cookie」的 API,只能讓它過期。
function fixDate(date) {
var base = new Date(0);
var skew = base.getTime();
if (skew > 0) date.setTime(date.getTime() - skew);
}
fixDate() 看起來莫名其妙,其實是在補一個歷史包袱:某些舊環境的 new Date(0) 不會回傳 0,而是回傳一個帶時差的數值。用這個差值去校正,可以讓 Cookie 的過期時間在不同時區下都算得準。現代的 Date 已經不需要這層防護。
function initCookie(monthName) {
var text = "";
for (var i = 1; i <= 31; ++i) { text += "^" + i + "^"; }
var now = new Date();
fixDate(now);
now.setTime(now.getTime() + 1000 * 60 * 60 * 24 * 31); // 一個月後過期
setCookie(monthName + "Calendar", text, now);
}
function getSpecificReminder(num, monthName) {
var prefix = "^" + num + "^";
var totalCookie = getCookie(monthName + "Calendar");
var startIndex = totalCookie.indexOf(prefix, 0);
var startData = totalCookie.indexOf("^", startIndex + 1) + 1;
var endData = (num == 31) ? totalCookie.length
: totalCookie.indexOf("^", startData);
return totalCookie.substring(startData, endData);
}
function setSpecificReminder(num, monthName, newValue) {
var prefix = "^" + num + "^";
var totalCookie = getCookie(monthName + "Calendar");
var startIndex = totalCookie.indexOf(prefix, 0);
var startData = totalCookie.indexOf("^", startIndex + 1) + 1;
var endData = (num == 31) ? totalCookie.length
: totalCookie.indexOf("^", startData);
var now = new Date();
fixDate(now);
now.setTime(now.getTime() + 1000 * 60 * 60 * 24 * 31);
setCookie(monthName + "Calendar",
totalCookie.substring(0, startData) + newValue
+ totalCookie.substring(endData, totalCookie.length), now);
}
讀與寫用的是同一套定位邏輯:先找 ^天數^ 的位置,再往後找下一個 ^,中間那段就是內容。第 31 天要特別處理,因為它後面沒有下一個哨兵,只能直接切到字串結尾。寫入時則用「頭 + 新值 + 尾」三段拼接覆蓋原本的內容,每次寫入都順手把過期時間往後延一個月,等於「有用到就自動續約」。
剩下的 getInput() 就是使用者互動層:先確認 Cookie 存在(不存在就呼叫 initCookie 初始化),再用 prompt 取得輸入,最後交給 setSpecificReminder 存回。搭配幾個 <input> 文字框當作 31 天的編輯區,就是一個能記事的月曆了。
要提醒的是,原始教學頁把這段程式碼拆成了好幾頁,手上的片段在 getInput() 取得輸入的地方就中斷了,最後的 prompt 呼叫與畫面更新邏輯需要自己補完。另外 Cookie 是明文、有大小上限、也會被使用者清除,適合放「提醒備忘」這種无关紧要的資料,重要的東西還是得放在伺服器端。