稍早我們談過微軟如何用 Atlas 來回應 Ajax 的潮流。簡單說,Atlas 是一個用來打造跨瀏覽器、跨平台 Ajax 應用的 ASP.NET 2.0 框架。微軟在四月社群技術預覽版(CTP)中宣告已準備好開放 go-live 授權,本文就從它的核心——ScriptManager 類別談起。
ScriptManager 管理頁面上所有的 Atlas 元件。除此之外,它還負責三件事:處理部分頁面更新、產生客戶端腳本,以及讓你能透過代理物件從 JavaScript 呼叫 Web 服務方法。
每個使用 Atlas 元件的頁面只能有一個 ScriptManager。如果你用 ASP.NET 2.0 的 Master Page,把 ScriptManager 放在母版頁上,所有內容頁就都共用得到。
<atlas:ScriptManager
EnablePartialRendering="true|false"
EnableScriptComponents="true|false"
ID="string"
runat="server">
<Scripts>
<atlas:ScriptReference
Browser="browser reference"
Path="script file path"
ScriptName="script file name" />
</Scripts>
<Services>
<atlas:ServiceReference
GenerateProxy="true|false"
Path="server path name"
Type="type name" />
</Services>
</atlas:ScriptManager>
是否啟用部分渲染。設為 true 時,非同步控制項的常規回發只會把增量變化送到用戶端,而不重繪整頁。
決定 Atlas 的哪些部分預設可在客戶端使用,涵蓋 UI 元件、行為、行為綁定與 XML Scripting 相關的腳本。設為 false 時,可在 ScriptReference 中逐一指定要下載的元件。
放在 Scripts 元素內,用來加入不會自動包含的腳本。可用 Path 指定路徑,用 Browser 指定適用瀏覽器。Atlas 有些預設不送出的腳本(如 AtlasUIDragDrop、AtlasUIGlitz、AtlasUIMap),就得靠 ScriptName 補上。
用來宣告頁面腳本要使用的 Web 服務。GenerateProxy 可暫時關閉為服務產生代理物件。
<%@ Page Language="C#" %>
<html xmlns="https://www.w3.org/1999/xhtml">
<head id="hd" runat="server">
<title>TR Sample</title>
<atlas:ScriptManager ID="scriptManager" runat="server"
EnablePartialRendering="false"
EnableScriptComponents="false">
<Services>
<atlas:ServiceReference Path="testService.asmx" GenerateProxy="true" />
</Services>
<Scripts>
<atlas:ScriptReference Path="AtlasRuntime.js" />
</Scripts>
</atlas:ScriptManager>
<script type="text/javascript">
function callWebService() {
testService.displayTime("request data", handleResponse);
}
function handleResponse(response) {
alert("Server response: " + response);
}
</script>
</head>
<body>
<form id="frmTR" runat="server">
<div><input type="button" onclick="callWebService()"
value="Call Web Service" /></div>
</form>
</body>
</html>
這頁宣告了服務參考,部分頁面渲染與額外腳本庫都關閉,只保留隨 Atlas 安裝的 AtlasRuntime.js 以維持基本功能。對應的服務端:
<%@ WebService Language="C#" Class="testService" %>
using System;
using System.Web.Services;
[WebService(Namespace = "https://tempuri.org/")]
[WebServiceBinding(ConformsTo = WsiProfiles.BasicProfile1_1)]
public class testService : System.Web.Services.WebService {
[WebMethod]
public string displayTime() {
return DateTime.Now.ToString();
}
}
如果 ScriptManager 已經在母版頁宣告,而某個內容頁需要額外的腳本或服務參考,就用 ScriptManagerProxy:
<atlas:ScriptManagerProxy runat="server" id="smProxy"> </atlas:ScriptManagerProxy>
它的語法與 ScriptManager 相同,只是定位在「補充」而非「取代」。
除了 ScriptManager,Atlas 也提供了幾個幾乎不用寫程式就能加效果的元件:
AutoCompleteExtender:擴充文字方塊,提供自動完成建議(資料由 Web 服務提供)。
DragOverlayExtender:把伺服器控制項變成可隨滑鼠與鍵盤移動的浮動物件。
ProfileScriptService:建立可從用戶端存取 ASP.NET 使用者設定檔的元件。
TimerControl:建立客戶端計時器,依固定間隔回發。
DragOverlayExtender 是最容易上手的一個,只要把目標控制項的 ID 指派給 TargetControlID 即可:
<atlas:ScriptManager ID="scriptManager" runat="server"
EnablePartialRendering="false" EnableScriptComponents="true" />
...
<asp:Image runat="server" ImageUrl="~/testimage.jpg" id="imgTest" />
<atlas:DragOverlayExtender ID="doe" runat="server">
<atlas:DragOverlayProperties Enabled="True" TargetControlID="imgTest" />
</atlas:DragOverlayExtender>
部署上不需要管理員介入:把 Microsoft.Web.Atlas.dll 複製到專案的 bin 目錄,再把 ScriptLibrary 下的 .js 檔複製進專案即可。
雖然掛著微軟的名字,Atlas 並不綁特定瀏覽器,控制項的樣式全部以 CSS 實作,也能依瀏覽器差異輸出不同內容。至於「Atlas 只是把開發者從 Firefox 與 Opera 拉回來的策略」這種說法,筆者的看法比較務實:工具的價值在於能不能解決客戶的問題,到目前為止,Atlas 展現的東西令人滿意。