無論你是Ext庫的新手,抑或是想了解Ext的人,本篇文章的內容都適合你。本文將簡單地介紹Ext的幾個基本概念,和如何快速地做出一個動態(tài)的頁面并運行起來,假設讀者已具備了一些JavaScript經驗和初級了解HTML Dom。
Contents[hide] |
下載Ext
如果你未曾下載過,那應從這里下載最新版本的Ext http://extjs.com/downloads 。
針對你的下載需求,有幾個不同的彈性選項。通常地,最穩(wěn)定的版本,是較多人的選擇。下載解包后,那個example文件夾便是一個探索Ext的好地方!
開始!
Download Example File |
我們將使用Ext,來完成一些JavaScript任務。
Zip文件包括三個文件:ExtStart.html, ExtStart.js和ExtStart.css。解包這三個文件到Ext的安裝目錄中(例如,Ext是在“C:\code\Ext\v1.0”中,那應該在"v1.0"里面新建目錄“tutorial”。雙擊ExtStart.htm,接著你的瀏覽器打開啟動頁面,應該會有一條消息告訴你配置已完畢。如果是一個Javascript錯誤,請按照頁面上的指引操作。
在你常用的IDE中或文本編輯器中,打開ExtStart.js看看:
Ext.onReady可能是你接觸的第一個方法。這個方法是指當前DOM加載完畢后,保證頁面內的所有元素能被Script引用(reference)。你可刪除alert()那行,加入一些實際用途的代碼試試:
Ext.onReady(function() {
alert("Congratulations! You have Ext configured correctly!");
});
Element:Ext的核心
大多數的JavaScript操作都需要先獲取頁面上的某個元素(reference),好讓你來做些實質性的事情。傳統(tǒng)的JavaScript方法,是通過ID獲取Dom節(jié)點的:
var myDiv = document.getElementById('myDiv');
這毫無問題,不過這樣單單返回一個對象(DOM節(jié)點),用起來并不是太實用和方便。為了要用那節(jié)點干點事情,你還將要手工編寫不少的代碼;另外,對于不同類型瀏覽器之間的差異,要你處理起來可真頭大了。
進入Ext.element 對象。元素(element)的的確確是Ext的心臟地帶,--無論是訪問元素(elements)還是完成一些其他動作,都要涉及它。Element的API是整個Ext庫的基礎,如果你時間不多,只是想了解Ext中的一兩個類的話,Element一定是首選!
由ID獲取一個Ext Element如下(首頁ExtStart.htm包含一個div,ID名字為“myDiv”,然后,在ExtStart.js中加入下列語句):
Ext.onReady(function() {var myDiv = Ext.get('myDiv');});
再回頭看看Element對象,發(fā)現什么有趣的東東呢?
- Element包含了常見的DOM方法和屬性,提供一個快捷的、統(tǒng)一的、跨瀏覽器的接口(若使用Element.dom的話,就可以直接訪問底層DOM的節(jié)點。);
- Element.get()方法內置緩存處理(Cache),多次訪問同一對象效率上有極大優(yōu)勢;
- 內置常用的DOM節(jié)點的動作,并且是跨瀏覽器的定位的位置、大小、動畫、拖放等等(add/remove CSS classes, add/remove event handlers, positioning, sizing, animation, drag/drop)。
這意味著你可用少量的代碼來做各種各樣的事情,這里僅僅是一個簡單的例子(完整的列表在ElementAPI中)。
繼續(xù)在ExtStart.js中,在剛才我們獲取好myDiv的位置中加入:
myDiv.highlight(); //黃色高亮顯示然后漸退 myDiv.addClass('red'); // 添加自定義CSS類 (在ExtStart.css定義) myDiv.center(); //在視圖中將元素居中 myDiv.setOpacity(.25); // 使元素半透明
獲取多個DOM的節(jié)點
通常情況下,想獲取多個DOM的節(jié)點,難以依靠ID的方式來獲取。有可能因為沒設置ID,或者你不知道ID,又或者直接用ID方式引用有太多元素了。這種情況下,你就會不用ID來作為獲取元素的依據,可能會用屬性(attribute)或CSS Classname代替。基于以上的原因,Ext引入了一個功能異常強大的Dom Selector庫,叫做DomQuery。
DomQuery可作為單獨的庫使用,但常用于Ext,你可以在上下文環(huán)境中(Context)獲取多個元素,然后通過Element接口調用。令人欣喜的是,Element對象本身便有Element.selcect的方法來實現查詢,即內部調用DomQuery選取元素。這個簡單的例子中,ExtStart.htm包含若干段落(<p>標簽),沒有一個是有ID的,而你想輕松地通過一次操作馬上獲取每一段,全體執(zhí)行它們的動作,可以這樣做:
// 每段高亮顯示 Ext.select('p').highlight();
DomQuery的選取參數是一段較長的數組,其中包括W3C CSS3 Dom選取器、基本XPatch、HTML屬性和更多,請參閱DomQuery API文檔以了解這功能強大的庫個中細節(jié)。
響應事件
到這范例為止,我們所寫的代碼都是放在onReady中,即當頁面加載后總會立即執(zhí)行,功能較單一——這樣的話,你便知道,如何響應某個動作或事件來執(zhí)行你希望做的事情,做法是,先分配一個function,再定義一個event handler事件處理器來響應。我們由這個簡單的范例開始,打開ExtStart.js,編輯下列的代碼:
Ext.onReady(function() { Ext.get('myButton').on('click', function(){ alert("You clicked the button"); }); });
加載好頁面,代碼依然會執(zhí)行,不過區(qū)別是,包含alert()的function是已定義好的,但它不會立即地被執(zhí)行,是分配到按鈕的單擊事件中。用淺顯的文字解釋,就是:獲取ID為'myDottom'元素的引用,監(jiān)聽任何發(fā)生這個元素上被單擊的情況,并分配一個function,以準備任何單擊元素的情況。
正路來說,Element.select也能做同樣的事情,即作用在獲取一組元素上。下一例中,演示了頁面中的某一段落被單擊后,便有彈出窗口:
Ext.onReady(function() { Ext.select('p').on('click', function() { alert("You clicked a paragraph"); }); });
這兩個例子中,事件處理的function均是簡單幾句,沒有函數的名稱,這種類型函數稱為“匿名函數(anonymous function)”,即是沒有名的的函數。你也可以分配一個有名字的event handler,這對于代碼的重用或多個事件很有用。下一例等效于上一例:
Ext.onReady(function() { var paragraphClicked = function() { alert("You clicked a paragraph"); } Ext.select('p').on('click', paragraphClicked); });
到目前為止,我們已經知道如何執(zhí)行某個動作。但當事件觸發(fā)時,我們如何得知這個event handler執(zhí)行時是作用在哪一個特定的元素上呢?要明確這一點非常簡單,Element.on方法傳入到even handler的function中(我們這里先討論第一個參數,不過你應該瀏覽API文檔以了解even handler更多的細節(jié))。在我們之前的例子中,function是忽略這些參數的,到這里可有少許的改變,——我們在功能上提供了更深層次的控制。必須先說明的是,這實際上是Ext的事件對象(event object),一個跨瀏覽器和擁有更多控制的事件的對象。例如,可以用下列的語句,得到這個事件響應所在的DOM節(jié)點:
Ext.onReady(function() { var paragraphClicked = function(e) { Ext.get(e.target).highlight(); } Ext.select('p').on('click', paragraphClicked); });
注意得到的e.target是DOM節(jié)點,所以我們首先將其轉換成為EXT的Elemnet元素,然后執(zhí)行欲完成的事件,這個例子中,我們看見段落是高亮顯示的。
使用Widgets
(Widget原意為“小器件”,現指頁面中UI控件)
除了我們已經討論過的核心JavaScript庫,當前的Ext亦包括了一系列的最前端的JavaScirptUI組件庫。文本以一個常用的widget為例子,作簡單的介紹。
MessageBox
比起略為沉悶的“HelloWolrd”消息窗口,我們做少許變化,前面我們寫的代碼是,單擊某個段落便會高亮顯示,現在是單擊段落,在消息窗口中顯示段落內容出來。
在上面的paragraphClicked的function中,將這行代碼:
Ext.get(e.target).highlight();
替換為:
var paragraph = Ext.get(e.target); paragraph.highlight(); Ext.MessageBox.show({ title: 'Paragraph Clicked', msg: paragraph.dom.innerHTML, width:400, buttons: Ext.MessageBox.OK, animEl: paragraph });
這里有些新的概念需要討論一下。在第一行中我們創(chuàng)建了一個局部變量(Local Variable)來保存某個元素的引用,即被單擊的那個DOM節(jié)點(本例中,DOM節(jié)點指的是段落paragrah,事因我們已經定義該事件與<p>標簽發(fā)生關聯(lián)的了)。為什么要這樣做呢?嗯...觀察上面的代碼,我們需要引用同一元素來高亮顯示,在MessageBox中也是引用同一元素作為參數使用。
一般來說,多次重復使用同一值(Value)或對象,是一個不好的方式,所以,作為一個具備良好OO思維的開發(fā)者,應該是將其分配到一個局部變量中,反復使用這變量!
現在,為了我們接下來闡述新概念的演示,請觀察MessageBox的調用。乍一看,這像一連串的參數傳入到方法中,但仔細看,這是一個非常特別的語法。實際上,傳入到MessageBox.show的只有一個參數:一個Object literal,包含一組屬性和屬性值。在Javascript中,Object Literal是動態(tài)的,你可在任何時候用{和}創(chuàng)建一個典型的對象(object)。其中的字符由一系列的name/value組成的屬性,屬性的格式是[property name]:[property value]。在整個Ext中,你將會經常遇到這種語法,因此你應該馬上消化并吸收這個知識點!
使用Object Literal的原因是什么呢?主要的原因是“可伸縮性(flexibility)”的考慮",隨時可新增、刪除屬性,亦可不管順序地插入。而方法不需要改變。這也是多個參數的情況下,為最終開發(fā)者帶來不少的方便(本例中的MessageBox.show())。例如,我們說這兒的foo.action方法,有四個參數,而只有一個是你必須傳入的。本例中,你想像中的代碼可能會是這樣的foo.action(null, null, null, 'hello').,若果那方法用Object Literal來寫,卻是這樣, foo.action({ param4: 'hello' }),這更易用和易讀。
Grid
Grid是Ext中人們最想先睹為快的和最為流行Widgets之一。好,讓我們看看怎么輕松地創(chuàng)建一個Grid并運行。用下列代碼替換ExtStart.js中全部語句:
Ext.onReady(function() { var myData = [ ['Apple',29.89,0.24,0.81,'9/1 12:00am'], ['Ext',83.81,0.28,0.34,'9/12 12:00am'], ['Google',71.72,0.02,0.03,'10/1 12:00am'], ['Microsoft',52.55,0.01,0.02,'7/4 12:00am'], ['Yahoo!',29.01,0.42,1.47,'5/22 12:00am'] ]; var ds = new Ext.data.Store({ proxy: new Ext.data.MemoryProxy(myData), reader: new Ext.data.ArrayReader({id: 0}, [ {name: 'company'}, {name: 'price', type: 'float'}, {name: 'change', type: 'float'}, {name: 'pctChange', type: 'float'}, {name: 'lastChange', type: 'date', dateFormat: 'n/j h:ia'} ]) }); ds.load(); var colModel = new Ext.grid.ColumnModel([ {header: "Company", width: 120, sortable: true, dataIndex: 'company'}, {header: "Price", width: 90, sortable: true, dataIndex: 'price'}, {header: "Change", width: 90, sortable: true, dataIndex: 'change'}, {header: "% Change", width: 90, sortable: true, dataIndex: 'pctChange'}, {header: "Last Updated", width: 120, sortable: true, renderer: Ext.util.Format.dateRenderer('m/d/Y'), dataIndex: 'lastChange'} ]); var grid = new Ext.grid.Grid('grid-example', {ds: ds, cm: colModel}); grid.render(); grid.getSelectionModel().selectFirstRow(); });
注意:在新的版的 Ext 2.0 中, 已用新的 class Ext.grid.GridPanel 替換了原來版本中的 Ext.grid.Grid. 如果你想這個例子能在新版的 Ext 2.0+ 中正常運行的話, 那你的將代碼中的 var grid = new Ext.grid.Grid(...); 替換成新的寫法:
var grid = new Ext.grid.GridPanel({el: 'grid-example', ds: ds, cm: colModel});
這看上去很復雜,但實際上加起來,只有七行代碼。第一行創(chuàng)建數組并作為數據源。實際案例中,你很可能從數據庫、或者WebService那里得到動態(tài)的數據。接著,我們創(chuàng)建并加載data store, data store將會告訴Ext的底層庫接手處理和格式化這些數據。接著,我們定義一個column模型,用來輕松地調配Grid的每一列參數。最后我們生成這個Grid,傳入data store和column模型兩個對象,進行渲染并選好第一行。不是太困難吧?如果一切順利,完成之后你會看到像這樣的:
當然,你可能未掌握這段代碼的某些細節(jié)(像MemoryProxy究竟是什么?)但先不要緊,這個例子的目的是告訴你,用少量的代碼,創(chuàng)建一個富界面的多功能的UI組件而已——這是完全可能的,只要讀者您有興趣學習。這兒有許多學習Grid的資源。Ext Grid教程、交叉Gird演示和Grid API文檔。
還有更多的..
這只是冰山一角。還有一打的UI Widgets可以供調用,如 layouts, tabs, menus, toolbars, dialogs, tree view等等。請參閱API文檔中范例演示。
使用Ajax
在弄好一些頁面后,你已經懂得在頁面和腳本之間的交互原理(interact)。接下來,你應該掌握的是,怎樣與遠程服務器(remote server)交換數據,常見的是從數據庫加載數據(load)或是保存數據(save)到數據庫中。通過JavaScript異步無刷新交換數據的這種方式,就是所謂的Ajax。Ext內建卓越的Ajax支持,例如,一個普遍的用戶操作就是,異步發(fā)送一些東西到服務器,然后,UI元素根據回應(Response)作出更新。這是一個包含text input的表單,一個div用于顯示消息(注意,你可以在ExtStart.html中加入下列代碼,但這必須要訪問服務器):
<div id="msg" style="visibility: hidden"></div> Name: <input type="text" id="name" /><br /> <input type="button" id="oKButton" value="OK" />
接著,我們加入這些處理交換數據的JavaScript代碼到文件ExtStart.js中(用下面的代碼覆蓋):
Ext.onReady(function(){ Ext.get('oKButton').on('click', function(){ var msg = Ext.get('msg'); msg.load({ url: [server url], //換成你的URL params: 'name=' + Ext.get('name').dom.value, text: 'Updating...' }); msg.show(); }); });
這種模式看起來已經比較熟悉了吧!先獲取按鈕元素,加入單擊事件的監(jiān)聽。在事件處理器中(event handler),我們使用一個負責處理Ajax請求、接受響應(Response)和更新另一個元素的Ext內建類,稱作UpdateManager。UpdateManager可以直接使用,或者和我們現在的做法一樣,通過Element的load方法來引用(本例中該元素是id為“msg“的div)。當使用Element.load方法,請求(request)會在加工處理后發(fā)送,等待服務器的響應(Response),來自動替換元素的innerHTML。簡單傳入服務器url地址,加上字符串參數,便可以處理這個請求(本例中,參數值來自“name”元素的value),而text值是請求發(fā)送時提示的文本,完畢后顯示那個msg的div(因為開始時默認隱藏)。當然,和大多數Ext組件一樣,UpdateManager有許多的參數可選,不同的Ajax請求有不同的方案。而這里僅演示最簡單的那種。
PHP
<? if(isset($_GET['name'])) { echo 'From Server: '.$_GET['name']; } ?>
ASP.Net
protected void Page_Load(object sender, EventArgs e) { if (Request["name"] != null) { Response.Write("From Server: " + Request["name"]); Response.End(); } }
Cold Fusion
<cfif StructKeyExists(url, "name")> <cfoutput>From Server: #url.name#</cfoutput> </cfif>
最后一個關于Ajax隱晦的地方就是,服務器實際處理請求和返回(Resposne)是具體過程。這個過程會是一個服務端頁面,一個Servlet,一個Http調度過程,一個WebService,甚至是Perl或CGI腳本,即不指定一個服務器都可以處理的http請求。讓人無法預料的是,服務器返回什么是服務器的事情,無法給一個標準的例子來覆蓋闡述所有的可能性。(這段代碼輸出剛才我們傳入'name'的那個值到客戶端,即發(fā)送什么,返回什么)。
使用Ajax的真正挑戰(zhàn),是需要進行適當的手工編碼,并相應格式化為服務端可用接受的數據結構。有幾種格式供人們選擇(最常用為JSON/XML)。正因Ext是一種與服務器語言免依賴的機制,使得其它特定語言的庫亦可用于Ext處理Ajax服務。只要頁面接受到結果是EXT能處理的數據格式,Ext絕不會干涉服務器其他的事情!要全面討論這個問題,已超出本文的范圍。推薦正在Ajax環(huán)境下開發(fā)的您,繼續(xù)深入閱讀Ext Ajax教程。
下一步是?
現在你已經一睹Ext其芳容,知道她大概能做些什么了。下面的資源有助您進一步深入了解: