DIV CSS 佈局教程網

您现在的位置: DIV+CSS佈局教程網 >> 網頁腳本 >  >> JavaScript入門知識 >> AJAX入門 >> AJAX詳解
用 Ajax 為 DataGrid / DataList 打造動態 ToolTip
編輯:AJAX詳解     

在列表型介面上,我們常常需要在有限的版面裡塞進大量資訊。圖片就是典型的例子:格子裡只放縮圖,使用者把滑鼠移上去,才即時顯示名稱與描述。若用傳統做法,得在每次資料綁定時就把提示文字寫進每一列的屬性,頁面因此變得笨重;改用 Ajax 之後,提示內容只在真正需要時才向伺服器索取,畫面輕盈、回應也不拖泥帶水。

本文以 ASP.NET 的 DataList(DataGrid 的作法完全相同)為示範對象,說明如何搭配一顆浮動的提示層、一段原生 XMLHttpRequest 呼叫,以及一支只回傳 HTML 片段的一般村民頁面,完成會跟著滑鼠走的動態 ToolTip。

一、整體結構

整個機制可以拆成三塊:

1. 資料層:一張存放使用者、圖片與描述的白名單資料表。
2. 服務端:同一支 ASPX 頁面負責兩件事——首次載入時輸出列表,收到帶有 ID 的請求時只輸出提示用的表格片段。
3. 客戶端:一個絕對定位的 DIV 充當提示框,滑鼠移入時發出非同步請求,滑鼠移動時更新座標,移出時隱藏。

二、資料表設計

先建立一張 TestImage 表,把圖片以二進位存進資料庫,同時保留路徑、型別與描述欄位:

if exists (select * from dbo.sysobjects
           where id = object_id(N'[dbo].[TestImage]')
             and OBJECTPROPERTY(id, N'IsUserTable') = 1)
drop table [dbo].[TestImage]
GO

CREATE TABLE [dbo].[TestImage] (
    [UserID]      [int] IDENTITY (1, 1) NOT NULL,
    [UserName]    [nvarchar] (500)  COLLATE Chinese_PRC_CI_AS NULL,
    [Image]       [image] NULL,
    [Path]        [nvarchar] (500)  COLLATE Chinese_PRC_CI_AS NULL,
    [Type]        [nvarchar] (20)   COLLATE SQL_Latin1_General_CP1_CI_AS NULL,
    [Description] [nvarchar] (2000) COLLATE Chinese_PRC_CI_AS NULL
) ON [PRIMARY] TEXTIMAGE_ON [PRIMARY]
GO

三、後端程式碼

頁面載入時,若不是回傳(PostBack)就先把列表綁好;接著判斷有沒有收到 ID 參數,有的話就改走「只輸出提示片段」的分支。這個雙重身分是整個技巧的關鍵。

using System.Data.SqlClient;
using System.IO;

protected void Page_Load(object sender, EventArgs e)
{
    if (!Page.IsPostBack)
    {
        BindData();
    }

    if (ID != "")
    {
        GetDescriptionByID(ID);
    }
}

#region property
private string ID
{
    get
    {
        if (Request["ID"] != null && Request["ID"].ToString() != "")
        {
            return Request["ID"];
        }
        else
        {
            return "";
        }
    }
}
#endregion

提示片段的產生方式,是手工組出一段兩列的小表格,第一列放名稱、第二列放描述,最後直接寫回 Response 並結束執行:

#region GetDescriptionByID
private void GetDescriptionByID(string id)
{
    string connStr = ConfigurationManager.AppSettings["ConnectionString"];

    using (SqlConnection conn = new SqlConnection(connStr))
    {
        string sql = "select UserName, Description from testimage where UserID = @id";
        SqlCommand cmd = new SqlCommand(sql, conn);
        cmd.Parameters.Add("@id", SqlDbType.Int).Value = int.Parse(id);

        conn.Open();
        SqlDataReader dr = cmd.ExecuteReader();

        string s = @"<table cellspacing='0' cellpadding='4' width='300'
                          border='0' style='color:#333333;border-collapse:collapse;'>";
        if (dr.Read())
        {
            s += "<tr style='background-color:#FFFBD6;'>";
            s += "<td width='50'>名稱:</td>";
            s += "<td>" + dr["UserName"] + "</td></tr>";

            s += "<tr style='background-color:White;'>";
            s += "<td>描述:</td>";
            s += "<td>" + dr["Description"] + "</td></tr>";
        }
        s += "</table>";

        dr.Close();
        this.Response.Write(s);
        this.Response.End();
    }
}
#endregion

這裡有兩點值得留意。第一,原範例把 ID 直接串進 SQL 字串裡,等於替使用者開了一扇 SQL 注入的門,改成參數化查詢是最起碼的防護。第二,組出來的 HTML 若含有使用者輸入的文字,正式環境應先做 HTML 編碼再輸出,避免提示框變成 XSS 的跳板。

列表綁定與資料存取

#region BindData
private void BindData()
{
    string sql = "select * from testimage";
    DataSet ds = GetDataSet(sql);
    this.DataList1.DataSource = ds;
    this.DataList1.DataBind();
}
#endregion

#region GetDataSet
private DataSet GetDataSet(string sql)
{
    string constring = ConfigurationManager.AppSettings["ConnectionString"];
    SqlDataAdapter sda = new SqlDataAdapter(sql, constring);
    DataSet ds = new DataSet();
    sda.Fill(ds);
    return ds;
}
#endregion

把圖片存進資料庫

示範用的上傳按鈕把檔案讀成位元組陣列,連同名稱、路徑、型別與描述一起寫入,這裡同樣全程使用參數:

#region save image
protected void Button2_Click(object sender, EventArgs e)
{
    Stream ImageStream;
    string Path = FileUpload1.PostedFile.FileName;      // 檔名
    int Size = FileUpload1.PostedFile.ContentLength;    // 檔案大小
    string Type = FileUpload1.PostedFile.ContentType;   // 檔案型別
    ImageStream = FileUpload1.PostedFile.InputStream;

    byte[] Content = new byte[Size];
    int Status = ImageStream.Read(Content, 0, Size);

    SqlConnection conn = new SqlConnection(
        ConfigurationManager.AppSettings["ConnectionString"]);

    SqlCommand comm = new SqlCommand(
        "insert into testimage (UserName,Image,Path,Type,Description) " +
        "values(@UserName,@Image,@Path,@Type,@Description)", conn);

    comm.CommandType = CommandType.Text;
    comm.Parameters.Add("@UserName",    SqlDbType.VarChar, 255).Value = txtUserName.Text;
    comm.Parameters.Add("@Image",       SqlDbType.Image).Value       = Content;
    comm.Parameters.Add("@Path",        SqlDbType.VarChar, 255).Value = Path;
    comm.Parameters.Add("@Type",        SqlDbType.VarChar, 255).Value = Type;
    comm.Parameters.Add("@Description", SqlDbType.VarChar, 2000).Value = this.TextBox1.Text;

    conn.Open();
    comm.ExecuteNonQuery();
    conn.Close();
}
#endregion

四、前端:提示層與非同步請求

提示框就是一個一開始隱藏的 DIV,樣式如下:

<style type="text/css">
  .logo { position: absolute; }
  .dek  { z-index: 200; visibility: hidden; position: absolute; }
</style>

<div class="dek" id="dek"></div>

接著是四個各司其職的函式:建立 XMLHttpRequest 物件、發出請求、接收回應、控制提示框的顯示與位置。

<script language="Javascript">
  Xoffset = -20;
  Yoffset =  20;
  var nav, yyy = -1000;
  var skn = dek.style;
  document.onmousemove = get_mouse;

  var XMLHttp;

  function createXMLHttpRequest() {
      if (window.ActiveXObject) {
          xmlHttp = new ActiveXObject("Microsoft.XMLHTTP");
      } else if (window.XMLHttpRequest) {
          xmlHttp = new XMLHttpRequest();
      }
  }

  function startRequest(id) {
      createXMLHttpRequest();
      XMLHttp.onreadystatechange = handleStateChange;
      XMLHttp.open("GET", "?ID=" + id, true);
      XMLHttp.send(null);
  }

  var content;

  function handleStateChange() {
      if (XMLHttp.readyState == 4) {
          if (XMLHttp.status == 200) {
              content = XMLHttp.responseText;
          }
      }
  }

  function popup(id) {
      startRequest(id);
      yyy = Yoffset;
      document.getElementById("dek").innerHTML = content;
      skn.visibility = "visible";
  }

  function get_mouse(e) {
      var x = event.x + document.body.scrollLeft;
      skn.left = x + Xoffset;
      var y = event.y + document.body.scrollTop;
      skn.top = y + yyy;
  }

  function kill() {
      yyy = -1000;
      skn.visibility = "hidden";
  }
</script>

這裡順手修掉了原範例的兩個小毛病:一是 innerHtml 應為 innerHTML,二是取元素時與其依賴 document.all,不如直接用 document.getElementById,後者在各瀏覽器上都吃得住。

還有一個結構性的限制要說明:popup() 在送出請求後立刻就把 content 寫進提示框,而 content 要等回應回來才會被填值。也就是說第一次移入的瞬間提示框會是空的,得等下一次 hover 才有內容。若要徹底解決,應該把「填入內容」這個動作搬到 handleStateChange() 的最後,並在請求送出前先顯示「載入中」的佔位訊息。

五、把行為綁到 DataList 上

最後在 ItemTemplate 裡把觸發條件掛到圖片上,滑鼠移入帶入該列的 UserID,移出則收起提示:

<asp:DataList id="DataList1" runat="server"
     BorderColor="black" CellPadding="1" CellSpacing="4"
     HorizontalAlign="Center" RepeatColumns="4" RepeatLayout="Table"
     ShowFooter="true" ShowHeader="true" width="100%">
  <ItemTemplate>
    <%# DataBinder.Eval(Container.DataItem, "UserName") %><br>
    <img ID="img1"
         onmouseover="popup(<%# DataBinder.Eval(Container.DataItem, "UserID") %>);"
         onmouseout="kill();"
         src='<%# DataBinder.Eval(Container.DataItem, "Path") %>'
         height='150' />
  </ItemTemplate>
</asp:DataList>

注意事件名稱是 onmouseout,原範例寫成 onmouSEOut,瀏覽器並不認得這個拼法,提示框會因此收不起來。

六、小結與延伸

這個做法的精神在於「延遲取得」:列表只帶最必要的欄位,其餘資訊等使用者真的想看時才去要。同一套骨架稍加變化就能服務其他場景——滑過訂單編號顯示明細、滑過產品名稱顯示規格、滑過使用者帳號顯示最後登入時間,都是同一個模式。

若要進一步打磨,可以往三個方向走:把提示框的寬高與是否超出視窗邊界納入計算,避免貼邊時被裁切;為同一個 ID 的回應做前端快取,第二次移入就不必再打伺服器;以及改用 POST 並加上驗證碼或參照字串,減少提示介面被當成資料探勘管道的風險。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved