在列表型介面上,我們常常需要在有限的版面裡塞進大量資訊。圖片就是典型的例子:格子裡只放縮圖,使用者把滑鼠移上去,才即時顯示名稱與描述。若用傳統做法,得在每次資料綁定時就把提示文字寫進每一列的屬性,頁面因此變得笨重;改用 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() 的最後,並在請求送出前先顯示「載入中」的佔位訊息。
最後在 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 並加上驗證碼或參照字串,減少提示介面被當成資料探勘管道的風險。