自訂元件圖示 developing-component-icons-in-aem-sites
元件圖示可讓作者透過圖示或有意義的縮寫快速識別元件。 作者現在可以找到所需的元件,以前所未有的速度建置其網頁體驗。
元件瀏覽器現在會以一致的灰色主題顯示,並顯示:
-
元件群組
-
元件標題
-
元件說明
-
元件圖示
- 元件標題 (預設) 的前兩個字母
- 自訂PNG影像 (由開發人員設定)
- 自訂SVG影像 (由開發人員設定)
- CoralUI圖示 (由開發人員設定)
元件圖示組態選項 component-icon-configuration-options
縮寫 abbreviations
依預設,元件標題([cq:Component]@jcr:title)的前2個字元會作為縮寫。 例如,如果 [cq:Component]@jcr:title=Article List,縮寫會顯示為"Ar"。
縮寫可以透過 [cq:Component]@abbreviation 屬性自訂。 雖然此值可接受超過2個字元,但建議將縮寫限製為2個字元,以避免任何視覺干擾。
/apps/.../components/content/my-component
- jcr:primaryType = "cq:Component"
- abbreviation = "AL"
CoralUI圖示 coralui-icons
AEM提供的CoralUI圖示可用於元件圖示。 若要設定CoralUI圖示,請將 [cq:Component]@cq:icon 屬性設定為所需的CoralUI圖示的HTML圖示屬性值(列於CoralUI檔案)。
/apps/.../components/content/my-component
- jcr:primaryType = "cq:Component"
- cq:icon = "documentFragment"
PNG影像 png-images
PNG影像可用於元件圖示。 若要將PNG影像設定為元件圖示,請在 [cq:Component] 下將所需的影像新增為名為 cq:icon.png 的 nt:file。
PNG應該要有透明背景,或是背景顏色設定為 #707070。
PNG影像已縮放為 20px x x 20px。 不過,如果要讓 40px 與 40px 搭配使用,可能比較合適。
/apps/.../components/content/my-component
- jcr:primaryType = "cq:Component"
+ cq:icon.png
- jcr:primaryType = "nt:file"
SVG影像 svg-images
SVG影像(向量型)可用於元件圖示。 若要將SVG影像設定為元件圖示,請在 [cq:Component] 下將所需的SVG新增為名為 cq:icon.svg 的 nt:file。
SVG影像的背景顏色應設為 #707070,大小為 20px x 20px.
/apps/.../components/content/my-component
- jcr:primaryType = "cq:Component"
+ cq:icon.svg
- jcr:primaryType = "nt:file"
其他資源 additional-resources
recommendation-more-help
bb44cebf-d964-4e3c-b64e-ce882243fe4d