在 Web Forms 開發中,常需從伺服器端動態輸出 JavaScript 以彈出訊息、導向頁面、操作父視窗等。本文整理一組靜態工具方法,均採用 Page.ClientScript.RegisterStartupScript 確保腳本在頁面載入完成後執行,並避免重複註冊。
public static class JsHelper
{
/// <summary> 彈出警告視窗 </summary>
public static void Alert(string message, Page page)
{
string js = $"<script>alert('{message}');</script>";
RegisterScript(page, "alert", js);
}
/// <summary> 彈出訊息並導向新網址 </summary>
public static void AlertAndRedirect(string message, string toUrl, Page page)
{
string js = $"<script>alert('{message}');window.location.replace('{toUrl}');</script>";
RegisterScript(page, "AlertAndRedirect", js);
}
/// <summary> 瀏覽歷史前進/後退 </summary>
public static void GoHistory(int value, Page page)
{
string js = $"<script>history.go({value});</script>";
RegisterScript(page, "GoHistory", js);
}
/// <summary> 刷新父視窗並關閉自身 </summary>
public static void RefreshParent(string url, Page page)
{
string js = $"<script>window.opener.location.href='{url}';window.close();</script>";
RegisterScript(page, "RefreshParent", js);
}
/// <summary> 刷新開啟視窗 </summary>
public static void RefreshOpener(Page page)
{
string js = "<script>opener.location.reload();</script>";
RegisterScript(page, "RefreshOpener", js);
}
/// <summary> 開啟指定尺寸的新視窗 </summary>
public static void OpenWebFormSize(string url, int width, int height, int top, int left, Page page)
{
string js = $@"<script>window.open('{url}','','height={height},width={width},top={top},left={left},location=no,menubar=no,resizable=yes,scrollbars=yes,status=yes,titlebar=no,toolbar=no,directories=no');</script>";
RegisterScript(page, "OpenWebFormSize", js);
}
/// <summary> 導向指定網址 </summary>
public static void JavaScriptLocationHref(string url, Page page)
{
string js = $"<script>window.location.replace('{url}');</script>";
RegisterScript(page, "JavaScriptLocationHref", js);
}
/// <summary> 開啟模態對話框 </summary>
public static void ShowModalDialogWindow(string webFormUrl, int width, int height, int top, int left, Page page)
{
string features = $"dialogWidth:{width}px;dialogHeight:{height}px;dialogLeft:{left}px;dialogTop:{top}px;center:yes;help=no;resizable:no;status:no;scroll=yes";
ShowModalDialogWindow(webFormUrl, features, page);
}
public static void ShowModalDialogWindow(string webFormUrl, string features, Page page)
{
string js = $"<script>window.showModalDialog('{webFormUrl}', '', '{features}');</script>";
RegisterScript(page, "ShowModalDialogWindow", js);
}
private static void RegisterScript(Page page, string key, string script)
{
if (!page.ClientScript.IsStartupScriptRegistered(page.GetType(), key))
page.ClientScript.RegisterStartupScript(page.GetType(), key, script);
}
}
// 在 Button_Click 事件中呼叫
protected void BtnLogin_Click(object sender, EventArgs e)
{
if (ValidateUser())
{
JsHelper.AlertAndRedirect("登入成功", "Default.aspx", this.Page);
}
else
{
JsHelper.Alert("帳號或密碼錯誤", this.Page);
}
}
showModalDialog 在 Chrome 37+、Edge、Firefox 等現代瀏覽器已棄用,建議改用 window.open 搭配 CSS 模擬模態效果。ScriptManager.RegisterStartupScript。