萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> ASP.NET 程式設計

ASP.NET 後端註冊 JavaScript 腳本的實用封裝類

在 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);
    }
}

注意事項

  • 所有腳本字串內的單引號需妥善跳脫,避免 JS 語法錯誤。
  • showModalDialog 在 Chrome 37+、Edge、Firefox 等現代瀏覽器已棄用,建議改用 window.open 搭配 CSS 模擬模態效果。
  • 若專案使用 UpdatePanel,需改用 ScriptManager.RegisterStartupScript。
copyright © 萬盛學電腦網 all rights reserved