開發核心元件 developing-core-components
何時該使用核心元件? when-to-use-the-core-components
核心元件不僅是全新功能,並且有多項優點,因此建議用於新的 AEM 專案。對於既有專案來說,移轉應該是品牌重塑或整體重構等較大專案工作的一部分。
因此,Adobe提供下列建議:
- 新專案
新專案應一律嘗試使用核心元件。 如果核心元件無法直接使用或延伸以滿足專案需求,請遵循核心元件中所述的元件架構建立自訂元件。 除非沒有其他方法,否則請避免使用foundation元件。 - 現有的專案
建議持續使用foundation元件,除非已計畫網站或元件重構。
由於大部分現有專案已廣泛使用基礎元件,因此將繼續支援基礎元件。 - 新自訂元件
評估是否可以自訂現有的核心元件。
如果不適用,建議依照元件指導方針建置新的自訂元件。 - 現有的自訂元件
如果您的元件如預期般運作,則請原樣保留。
否則,請參閱上方的「新自訂元件」。
如何使用核心元件獲得成功 how-to-succeed
核心元件功能強大、彈性好用,且易於自訂。 遵循幾項重要准則將確保您使用核心元件的專案成功進行。
移轉至核心元件
任何新專案都應使用核心元件實作。 不過,現有專案通常具有基礎元件的廣泛實作。
從基礎元件移轉 from-foundation
對現有專案進行較大的變動(例如品牌重塑或整體重構)通常會提供移轉至核心元件的機會。 為了協助此移轉,Adobe提供了許多移轉工具,以鼓勵採用核心元件和最新的AEM技術。
AEM現代化工具可讓您輕鬆轉換:
- 從靜態範本轉換為可編輯的範本
- 根據原則設計設定
- 從基礎元件轉換為核心元件
- 從傳統 UI 轉換為觸控式 UI
如需這些工具使用方式的詳細資訊,請參閱其檔案。
透過移轉至AEM as a Cloud Service進行移轉 via-aemaacs
由於AEM as a Cloud Service自動隨最新版本的核心元件提供,當您從內部部署AEM安裝移轉時,您必須在專案pom.xml
檔案中移除與核心元件的任何相依性。
您的Proxy元件仍會如往常般運作,原因如下 代理指向必要的超型別,而超型別路徑中有版本。 如此一來,只要移除相依性,核心元件就能像內部部署一樣在AEMaaCS中運作。
就像任何其他AEMaaCS專案一樣,您也需要將相依性新增到AEM SDK jar。 這並非核心元件所特有,但為必要專案。
<dependency>
<groupId>com.adobe.aem</groupId>
<artifactId>aem-sdk-api</artifactId>
</dependency>
如需AEMCS專案的詳細資訊,請參閱檔案AEMaaCS專案結構。
核心元件支援 core-component-support
核心元件是 AEM 不可或缺的一部分,並依照與 Quickstart 所提供相同的條款與條件給予支援。
如同其他AEM產品功能,一般規則是:首先宣佈元件將過時,並且最早從下列AEM版本中移除。 這可讓客戶在停止支援之前,至少有一個版本的週期可移至新版本的元件。
每個元件的版本都清楚說明其支援的 AEM 版本。當停止支援 AEM 的單一版本時,核心元件對該 AEM 版本的支援也會停止。
如需支援自訂元件的詳細資訊,請參閱自訂核心元件頁面。
技術功能 technical-capabilities
下表概述核心元件與基礎元件之間的差異。
如需有關其撰寫功能的詳細資訊以及可預先設定它們的選項,請參閱有關它們的撰寫頁面。
元件清單 component-list
下表列出可用的核心元件、其API的連結,並指出其取代的基礎元件。
/libs/foundation/components/text /libs/foundation/components/table /libs/wcm/foundation/components/text
/libs/foundation/components/image /libs/foundation/components/adaptiveimage /libs/foundation/components/logo /libs/foundation/components/mobileimage /libs/foundation/components/mobilelogo /libs/wcm/foundation/components/image
/libs/foundation/components/list /libs/foundation/components/mobilelist /libs/wcm/foundation/components/list
/libs/foundation/components/form/checkbox /libs/foundation/components/form/radio /libs/foundation/components/form/dropdown
核心元件的升級 upgrade-of-core-components
版本化元件的一個優點是,它允許將移轉至新AEM版本與移轉至新元件版本分開。 此外,如果有新的元件版本,可讓個別元件移轉至新版本。
移轉至新AEM版本不會影響核心元件的運作方式,前提是其版本也支援正在移轉至的新AEM版本。 對核心元件進行的自訂作業也不應受影響,只要這些自訂作業未使用已棄用或移除的API。
移轉至核心元件的新版本也不會影響元件的運作方式,但可能會為頁面作者引入新功能,這可能需要範本編輯器進行一些設定,以備不想要的預設行為時使用。 不過,可能需要調整自訂,如需詳細資訊,請參閱自訂核心元件頁面。