「設為首頁」和「加入收藏」是早期網站幾乎必備的兩個按鈕。問題在於瀏覽器基於安全考量,早就把這類改動本機設定的能力收得死緊,所以只能走「能成功就成功、不能就提示使用者手動操作」的路線。
<script type="text/javascript">
// 設為首頁
function SetHome(obj, url){
try{
obj.style.behavior = 'url(#default#homepage)';
obj.setHomePage(url);
}catch(e){
if(window.netscape){
try{
netscape.security.PrivilegeManager.enablePrivilege("UniversalXPConnect");
}catch(e){
alert("抱歉,此操作被瀏覽器拒絕!\n\n請在瀏覽器位址欄輸入 about:config 並回車,"
+ "然後將 signed.applets.codebase_principal_support 設定為 true");
}
}else{
alert("抱歉,您所使用的瀏覽器無法完成此操作。\n\n"
+ "您需要手動將【" + url + "】設定為首頁。");
}
}
}
// 收藏本站
function AddFavorite(title, url){
try{
window.external.addFavorite(url, title);
}catch(e){
try{
window.sidebar.addPanel(title, url, "");
}catch(e){
alert("抱歉,您所使用的瀏覽器無法完成此操作。\n\n"
+ "加入收藏失敗,請進入網站後使用 Ctrl+D 進行添加");
}
}
}
</script>
<a href="javascript:void(0);" onclick="SetHome(this,'https://www.jb51.net');">設為首頁</a>
<a href="javascript:void(0);" onclick="AddFavorite('','https://www.jb51.net')">收 藏 本 站</a>
三層 try...catch 是這類功能的基本防禦:第一層走 IE 的 behavior 與 setHomePage,失敗就試 Firefox 舊版的 netscape.security 授權,再失敗就老實告訴使用者怎麼手動設定。收藏那支同理,先試 window.external.addFavorite,再退到 window.sidebar.addPanel,最後提示 Ctrl+D。
第一種是把使用者當前正在看的頁面設為首頁,第二種是把指定網址設為首頁。兩者適用的場合不同:前者適合工具型頁面,後者適合官網。寫法上都是動態產生一個 <a>,再按瀏覽器分派。
<TEXTAREA id="runcode60377">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=gb2312">
<title>設為首頁的 JS 代碼</title>
</head>
<body>
<p>方法一:<a href="#">點此 設為首頁</a></p>
<p>方法二:<a href="#">設為首頁</a></p>
</body>
</html>
</TEXTAREA>
<INPUT onclick="runEx('runcode60377')" type="button" value="運行代碼"/>
<INPUT onclick="doCopy('runcode60377')" type="button" value="復制代碼"/>
<INPUT onclick="doSave(runcode60377)" type="button" value="保存代碼"/>
[Ctrl+A 全選 注:如需引入外部 Js 需刷新才能執行]
下面這份採用 XHTML 1.0 Transitional 的 DOCTYPE,語法上更貼近標準,缺點是 IE7 仍然不支援加入收藏。以那個年代來說,已經算是相當乾淨的寫法:
<TEXTAREA id="runcode52091">
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="https://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="content-type" content="text/html; charset=gb2312" />
<title>設為首頁與添加收藏夾代碼【兼容多浏覽器】</title>
</head>
<body>
設為首頁 - 加入收藏
</body>
</html>
</TEXTAREA>
<INPUT onclick="runEx('runcode52091')" type="button" value="運行代碼"/>
<INPUT onclick="doCopy('runcode52091')" type="button" value="復制代碼"/>
<INPUT onclick="doSave(runcode52091)" type="button" value="保存代碼"/>
[Ctrl+A 全選 注:如需引入外部 Js 需刷新才能執行]
最後提醒一句:現代瀏覽器(包含近年版本的 Chrome、Firefox、Edge、Safari)已經完全移除 setHomePage 與 addFavorite 這類 API,任何呼叫都會直接落到 catch 分支。今天要做這件事,務實的做法就是給一段清楚的手動教學,或直接引導使用者用 Ctrl+D/⌘+D。