Alpine.js簡介:用于最小化列表的JavaScript框架?
譯文譯者 | 李睿
審校 | 孫淑娟
前端JavaScript框架的創(chuàng)新是當(dāng)今這個時代最偉大的技術(shù)文化現(xiàn)象之一。20多年來,人們見證了進化創(chuàng)造力的長尾。每一個新的想法都進行嘗試,在軟件開發(fā)過程和開發(fā)人員構(gòu)建的最終產(chǎn)品中都會促進改進。?
Alpine.js是近年來脫穎而出的框架之一。Alpine.js是一個極簡主義框架。顧名思義,用于克服大量的困難(在崎嶇的山地)進行輕操作。它在一個簡潔、易于掌握的軟件包中提供了很多的動力。本文將對Alpine.js進行介紹,這樣就可以理解它提供了什么,以及它在什么時候可能有用。?
Alpine的極簡API
正如Alpine.js文檔所描述的,Alpine的API是15個屬性、6個特性和2個方法的集合。這是一個非常小的API配置文件。其極簡主義的目的是以干凈的格式提供反應(yīng)性,并輔以一些周圍的細(xì)節(jié),例如事件和中央商店。?
考慮清單1中非常簡單的Web頁面。 ?
清單1.一個用Alpine.js構(gòu)建的簡單網(wǎng)頁
除了通過CDN包含Alpine包,這里僅有的兩個與Alpine相關(guān)的是指令x-data和x-text。
如果將其放入系統(tǒng)上的HTML頁面并在瀏覽器中查看,將會看到消息輸出“文本文字”。雖然這個應(yīng)用程序不是特別令人印象深刻,但它演示了Alpine的兩個有趣方面。 ?
首先,為了使反應(yīng)性發(fā)揮作用,必須將標(biāo)記包含在x-data指令中。如果刪除該指令,則x-text將不會生效。本質(zhì)上,x-data指令創(chuàng)建了一個Alpine組件。在這個例子中,x-data指令是空的。在實際使用中,這里幾乎總是有數(shù)據(jù)。畢竟,正在編寫的組件的目的是響應(yīng)數(shù)據(jù)。 ?
清單1中要注意的第二件事是,可以將任何有效的JavaScript放入x-text中。所有的Alpine指令都是如此。 ?
x-data和x-text元素
x-data內(nèi)容提供給所有包含的元素。要理解這個意思,可以查看清單2。 ?
清單2.x-data和x-text交互
現(xiàn)在該頁面將輸出美國《獨立宣言》的開頭部分。可以看到x-data定義了一個簡單的老舊JavaScript對象,只有一個字段“message”,其中包含聲明的序言。x-text指向這個對象字段。 ?
在Alpine.js中的反應(yīng)
接下來,將使用反應(yīng)性來修復(fù)聲明中的錯誤。可以了解清單3。 ?
清單3.x- on:click和反應(yīng)性
x-text指令指的是由x-data指令公開的代詞變量。這里的新部件是按鈕,它有一個x-on:click指令。這個單擊事件的處理程序?qū)⑴f的默認(rèn)代詞替換為中性代詞,反應(yīng)性負(fù)責(zé)更新x-text中的引用。?
數(shù)據(jù)中的函數(shù)
Alpine中的數(shù)據(jù)屬性是功能齊全的JavaScript對象。考慮處理上述需求的另一種方法,如清單4所示。 ?
清單4.使用數(shù)據(jù)函數(shù)
在清單4中,可以看到數(shù)據(jù)對象現(xiàn)在擁有一個由click處理程序調(diào)用的fixIt方法。 ?
另外,有時會看到應(yīng)用程序代碼從x-data指令調(diào)用腳本標(biāo)記中定義的函數(shù)——這是個人偏好,它的操作與內(nèi)聯(lián)x-data完全相同:?
獲取遠(yuǎn)程數(shù)據(jù)
現(xiàn)在轉(zhuǎn)換話題,可以考慮一個更復(fù)雜的需求。假設(shè)想從外部API加載一個json格式的美國總統(tǒng)列表。我們要做的第一件事是在頁面加載時加載它。為此將使用x-init指令,例如清單5所示。 ?
清單5.從x-init預(yù)加載數(shù)據(jù)
在這里發(fā)生了什么?首先,x-data指令應(yīng)該很清楚:它只是有一個帶有空數(shù)組的總統(tǒng)(presidents)字段。span元素中的x-text輸出該字段的內(nèi)容。 ?
x-init代碼有點復(fù)雜。首先,注意它被包裝在一個自動執(zhí)行的函數(shù)中。這是因為Alpine需要函數(shù),而不是函數(shù)定義。(如果要使用fetch的非異步回調(diào)形式,則不需要像這樣包裝函數(shù)。) ?
一旦從端點獲得了presidents列表,將其插入到presidents變量中,Alpine將其作為x-data對象的一部分公開。 ?
重申一下:Alpine.js正在使a-data中的數(shù)據(jù)可用于同一場景中的其他指令函數(shù)(例如x-init)。 ?
使用Alpine.js迭代
此時,應(yīng)用程序正在從遠(yuǎn)程端點提取數(shù)據(jù)并將其保存到狀態(tài)中。需要注意,它輸出的內(nèi)容類似于[Object],[Object]....這不是想要的。可以了解一下遍歷數(shù)據(jù)的過程,例如清單6所示。 ?
清單6.使用Alpine.js迭代
清單6包含一個普通的無序列表,后面跟著一個HTML模板元素,其中包含一個x-for指令。這個指令的操作與在其他響應(yīng)式框架中看到的類似。在本例中,它允許指定一個集合、總統(tǒng)(presidents)和一個標(biāo)識符,該標(biāo)識符將提供給表示該集合的每個實例的封閉標(biāo)記,在本例中為pres。 ?
標(biāo)記的其余部分使用pres變量通過x-text從對象中輸出數(shù)據(jù)。 ?
其應(yīng)用程序現(xiàn)在看起來如圖1所示。 ?
圖1美國總統(tǒng)的名單?
顯示/隱藏和onClick
現(xiàn)在要設(shè)置應(yīng)用程序,以便通過單擊總統(tǒng)的名稱來切換總統(tǒng)的數(shù)據(jù)。首先,將標(biāo)記修改為清單7所示的內(nèi)容。 ?
清單7.顯示/隱藏元素
現(xiàn)在,在清單7中,可以在包含總統(tǒng)詳細(xì)信息的div上使用x-show指令。x-show值的真實性決定內(nèi)容是否可見。在本例中,這是由pres.show字段決定的 (注意的是,在實際應(yīng)用程序中,可能不希望使用實際業(yè)務(wù)數(shù)據(jù)來承載show/hide變量) 。 ?
為了改變press.show的值,在標(biāo)頭文件中添加一個x-on:click處理程序。這個處理程序簡單地交換了press.show的true/false值:press.show=!pres.show。 ?
添加轉(zhuǎn)換動畫
Alpine包含內(nèi)置轉(zhuǎn)換功能,可以應(yīng)用于顯示/隱藏特性。清單8顯示了如何添加默認(rèn)動畫。 ?
清單8.添加轉(zhuǎn)換功能來顯示/隱藏
唯一改變的是,帶有x-show指令的元素現(xiàn)在也有一個x-transition指令。在默認(rèn)情況下,Alpine應(yīng)用合理的轉(zhuǎn)換。在這種情況下,轉(zhuǎn)換是一種滑動和漸變效果。可以廣泛地自定義轉(zhuǎn)換,包括將自己的CSS類應(yīng)用于動畫的各個階段。?
綁定到輸入
現(xiàn)在,將添加一個簡單的過濾器功能。這將需要添加一個綁定到數(shù)據(jù)的輸入,然后根據(jù)該值篩選返回的數(shù)據(jù)集。可以在清單9中看到更改。 ?
清單9.篩選presidents
注意,x-data對象現(xiàn)在有一個“filter”字段。這是通過指向“filter”的x-model指令雙向綁定到輸入元素的。 ?
已經(jīng)更改了模板x-for指令,以引用一個新的getPresidents()方法,該方法在x-data對象上實現(xiàn)。該方法使用標(biāo)準(zhǔn)JavaScript語法,根據(jù)總統(tǒng)是否在篩選字段中包含文本來篩選。 ?
結(jié)論
就像它的名字一樣,Alpine.js是一個輕量級的軟件包,里面有著基本的裝備,可以“穿越高山”。這是最小的軟件包,但已經(jīng)足夠了。 ?
該框架包括一些更高級的功能,特別是中央存儲和事件系統(tǒng),以及插件架構(gòu)和生態(tài)系統(tǒng)。?
總之,Alpine.js是符合人體工程學(xué)。如果你有使用其他響應(yīng)式框架的經(jīng)驗,那么Alpine應(yīng)該會很快學(xué)會,在x-data指令中聲明組件及其數(shù)據(jù)的簡單性。 ?
可能想知道組件間的通信。Alpine.js避免了組件之間的顯式連接(例如,沒有父-子道具)。與其相反,它通過$dispatch指令使用瀏覽器環(huán)境(即窗口)作為事件總線。這符合Alpine的理念,即添加足夠的功能來增強現(xiàn)有的功能。它工作得很好。 ?
隨著應(yīng)用程序的規(guī)模和復(fù)雜性的增長,所有這些元素都將受到考驗。所以它適用于選擇的任何堆棧。Alpine.js是你下次進行代碼冒險的一個誘人選擇。?
原文標(biāo)題:??Intro to Alpine.js: A JavaScript framework for minimalists??,作者:Matthew Tyson