Adobe建議針對需要單頁應用程式架構式用戶端轉譯(例如_React_)的專案使用SPA編輯器。 了解更多.
設計您的網頁,使其與顯示其的用戶端檢視區相適應。 透過回應式設計,相同的頁面可以兩種方向有效地顯示在多個裝置上。 下列影像示範頁面可以透過哪些方式回應檢視區大小的變更:
開發Adobe Experience Manager(AEM)應用程式,產生可適應多種視窗大小和方向的HTML5頁面。 例如,下列檢視區寬度範圍對應於各種裝置類型和方向
如需實作回應式設計行為的相關資訊,請參閱下列主題:
在設計時,請使用Sidekick來預覽不同螢幕大小的頁面。
在開發支援您網頁的AEM應用程式之前,應先做出幾項設計決策。 例如,您需要下列資訊:
典型的AEM應用程式結構支援所有回應式設計實施:
媒體查詢可讓您選擇性使用CSS樣式來呈現頁面。 AEM開發工具和功能可讓您有效且有效地在應用程式中實施媒體查詢。
W3C群組提供媒體查詢建議,說明此CSS3功能和語法。
在您的CSS檔案中,根據您所定位裝置的屬性定義媒體查詢。 下列實施策略對於管理每個媒體查詢的樣式是有效的:
We.Retail媒體範例使用此策略來定義網站設計中的樣式。 We.Retail使用的CSS檔案位於*/apps/weretail/clientlibs/clientlib-site/less/grid.less
。
下表列出css子資料夾中的檔案。
檔案名 | 說明 | 媒體查詢 |
---|---|---|
style.css | 常見樣式。 | N/A |
bootstrap.css | 通用樣式,由TwitterBootstrap定義。 | 不適用 |
responsive-1200px.css | 1200像素寬或寬的所有介質的樣式。 | @media(最小寬度:1200px){ |
responsive-980px-1199px.css | 介質的樣式,介於980像素和1199像素之間。 | @media(最小寬度:980px)和(最大寬度:1199px){ |
responsive-768px-979px.css | 介質的樣式,介於768像素和979像素之間。 | @media(最小寬度:768px)和(最大寬度:979px){ |
responsive-767px-max.css | 寬小於768像素的所有媒體的樣式。 | @media(最大寬度:767px){ |
responsive-480px.css | 寬小於481像素的所有媒體的樣式。 | @media(最大寬度:480){ ... } |
/etc/designs/weretail/clientlibs
資料夾中的css.txt檔案會列出客戶端庫資料夾中包含的CSS檔案。 檔案的順序實現樣式優先。 隨著裝置大小減小,樣式會更具體。
#base=css
style.css
bootstrap.css
responsive-1200px.css
responsive-980px-1199px.css
responsive-768px-979px.css
responsive-767px-max.css
responsive-480px.css
提示:描述性檔案名稱可讓您輕鬆識別目標檢視區大小。
將客戶端庫資料夾包含在頁面元件的JSP指令碼中,以生成包含媒體查詢的CSS檔案,並引用該檔案。
<ui:includeClientLib categories="apps.weretail.all"/>
apps.weretail.all
用戶端程式庫資料夾內嵌clientlibs程式庫。
JSP指令碼會生成以下引用樣式表的HTML代碼:
<link rel="stylesheet" href="/etc/designs/weretail/clientlibs-all.css" type="text/css">
<link href="/etc/designs/weretail.css" rel="stylesheet" type="text/css">
以不同檢視區大小查看頁面的預覽,以測試回應式設計的行為。 在預覽模式中,Sidekick包含一個Devices下拉式選單,您可使用該下拉式選單來選取裝置。 選取裝置時,頁面會隨著檢視區大小而變更。
若要在Sidekick中啟用裝置預覽,您必須設定頁面和MobileEmulatorProvider服務。 另一個頁配置控制顯示在Devices清單中的設備清單。
當您的頁面包含轉譯Devices清單的JSP指令碼時,Devices清單會顯示在Sidekick中。 若要將Devices清單新增至Sidekick,請在頁面的head
區段中加入/libs/wcm/mobile/components/simulator/simulator.jsp
指令碼。
在定義head
節的JSP中包括以下代碼:
<cq:include script="/libs/wcm/mobile/components/simulator/simulator.jsp"/>
若要查看範例,請以CRXDE Lite開啟/apps/weretail/components/page/head.jsp
檔案。
若要啟用裝置模擬器以支援您的頁面,請使用MobileEmulatorProvider工廠服務註冊您的頁面元件,並定義mobile.resourceTypes
屬性。
使用AEM時,有數種方法可管理這類服務的組態設定;如需完整詳細資訊,請參閱設定OSGi 。
例如,要在應用程式中建立 [sling:OsgiConfig](/docs/experience-manager-64/deploying/configuring/configuring-osgi.md#adding-a-new-configuration-to-the-repository)
節點:
父資料夾:/apps/application_name/config
名稱: com.day.cq.wcm.mobile.core.impl.MobileEmulatorProvider-*alias*
需要 — *alias*
尾碼,因為MobileEmulatorProvider服務是工廠服務。 使用此工廠唯一的任何別名。
jcr:primaryType: sling:OsgiConfig
新增下列節點屬性:
名稱: mobile.resourceTypes
類型: String[]
值:呈現網頁之頁面元件的路徑。 例如,geometrixx-media應用程式使用下列值:
geometrixx-media/components/page
geometrixx-unlimited/components/pages/page
geometrixx-unlimited/components/pages/coverpage
geometrixx-unlimited/components/pages/issue
要指定顯示在「設備」清單中的設備組,請將cq:deviceGroups
屬性添加到站點根頁的jcr:content
節點。 屬性的值是指向設備組節點的路徑陣列。
設備組節點位於/etc/mobile/groups
資料夾中。
例如,Geometrixx Media網站的根頁面為/content/geometrixx-media
。 /content/geometrixx-media/jcr:content
節點包含以下屬性:
cq:deviceGroups
String[]
/etc/mobile/groups/responsive
使用工具控制台來建立和編輯設備組🔗。
對於用於響應式設計的設備組,編輯設備組,並在「常規」頁簽上選擇「禁用模擬器」。 此選項可防止模擬器輪播出現,這與回應式設計無關。
您可以使用媒體查詢來選取要顯示在頁面中的影像資源。 但是,每個使用媒體查詢來條件化其使用的資源都會下載到用戶端。 媒體查詢只會判斷是否顯示下載的資源。
對於影像等大型資源,下載所有資源並非有效使用用戶端的資料管道。 若要選擇性地下載資源,請在媒體查詢執行選取後,使用javascript起始資源要求。
以下策略載入使用媒體查詢選擇的單一資源:
W3C定義的MediaQueryList介面實作可讓您使用javascript評估媒體查詢。 您可以將邏輯套用至媒體查詢結果,並執行針對目前視窗的指令碼:
實作MediaQueryList介面的瀏覽器支援window.matchMedia()
函式。 此函式會針對指定字串測試媒體查詢。 函式返回MediaQueryList
對象,該對象提供對查詢結果的訪問。
若瀏覽器未實作介面,您可以使用matchMedia()
多填,例如matchMedia.js,一個可自由使用的javascript程式庫。
W3C-proposed picture element使用媒體查詢來確定要用於影像元素的源。 圖片元素使用元素屬性來將媒體查詢與影像路徑關聯。
可自由使用的picturefireld.js庫提供與建議的picture
元素類似的功能,並使用類似的策略。 picturefill.js程式庫會呼叫window.matchMedia
以評估為一組div
元素定義的媒體查詢。 每個div
元素也指定影像源。 當div
元素的媒體查詢傳回true
時,會使用來源。
picturefill.js
程式庫需要與下列範例類似的HTML程式碼:
<div data-picture>
<div data-src='path to default image'></div>
<div data-src='path to small image' data-media="(media query for phone)"></div>
<div data-src='path to medium image' data-media="(media query for tablet)"></div>
<div data-src='path to large image' data-media="(media query for monitor)"></div>
</div>
轉譯頁面時,picturefull.js插入img
元素作為<div data-picture>
元素的最後一個子項:
<div data-picture>
<div data-src='path to default image'></div>
<div data-src='path to small image' data-media="(media query for phone)"></div>
<div data-src='path to medium image' data-media="(media query for tablet)"></div>
<div data-src='path to large image' data-media="(media query for monitor)"></div>
<img src="path to medium image">
</div>
在AEM頁面中, data-src
屬性的值是存放庫中資源的路徑。
若要在AEM應用程式中實作最適化影像,您需要新增必要的javascript程式庫,並在頁面中加入必要的HTML標籤。
資料庫
取得下列javascript程式庫,並將其納入用戶端程式庫資料夾中:
/etc/clientlibs/granite/jquery
用戶端程式庫資料夾(category = jquery)驗證)提示: 您可以透過內嵌 自動串連多個用戶端程式庫資料夾。
HTML
建立元件,以產生picturefill.js程式碼預期的必要div元素。 在AEM頁面中, data-src屬性的值是存放庫中資源的路徑。 例如,頁面元件可以在DAM中為影像轉譯硬式編碼媒體查詢和相關路徑。 或者,建立自訂影像元件,讓作者選取影像轉譯或指定執行階段轉譯選項。
下列範例HTML會從相同影像的2個DAM轉譯中選取。
<div data-picture>
<div data-src='/content/dam/geometrixx-media/articles/meridien.png'></div>
<div data-src='/content/dam/geometrixx-media/articles/meridien.png/jcr:content/renditions/cq5dam.thumbnail.319.319.png' data-media="(min-width: 769px)"></div>
<div data-src='/content/dam/geometrixx-media/articles/meridien.png/jcr:content/renditions/cq5dam.thumbnail.140.100.png' data-media="(min-width: 481px)"></div>
</div>
自適應影像基礎元件會實施自適應影像:
/libs/foundation/components/adaptiveimage/clientlibs
/libs/foundation/components/adaptiveimage/adaptiveimage.jsp
後續章節提供此元件的詳細資訊。
若要自訂影像轉譯,您應了解預設的AEM靜態影像轉譯實施。 AEM提供影像元件和影像轉譯servlet,可搭配使用來轉譯網頁的影像。 當頁面的段落系統中包含影像元件時,會發生下列事件順序:
例如,影像元件的JSP會產生下列HTML元素:
<img title="My Image" alt="My Image" class="cq-dd-image" src="/content/mywebsite/en/_jcr_content/par/image_0.img.jpg/1358372073597.jpg">
瀏覽器載入頁面時,會使用src屬性的值作為URL來要求影像。 Sling會解壓縮URL:
/content/mywebsite/en/_jcr_content/par/image_0
.jpg
img
1358372073597.jpg
image_0
節點的jcr:resourceType
值為foundation/components/image
,sling:resourceSuperType
值為foundation/components/parbase
。 parbase元件包含img.GET.java指令碼,該指令碼與請求URL的選擇器和檔案名副檔名匹配。 CQ使用此指令碼(servlet)來轉譯影像。
要查看指令碼的原始碼,請使用CRXDE Lite開啟/libs/foundation/components/parbase/img.GET.java
檔案。
根據客戶端視區的特性在運行時縮放影像,以提供符合響應式設計原則的影像。 使用與靜態影像呈現相同的設計模式,使用servlet和製作元件。
元件需要執行下列工作:
div
元素,其中包含用於轉譯影像的媒體選取器和服務呼叫。Web用戶端使用matchMedia和Picturefill javascript程式庫(或類似的程式庫)來評估媒體選取器。
處理影像請求的Servlet需要執行下列任務:
可用的解決方案
AEM會安裝下列您可使用或擴充的實作。
自適應影像元件產生對自適應影像元件Servlet的調用,以呈現根據設備螢幕大小的影像。 元件包含下列資源:
cq:ClientLibraryFolder
,會組合matchMedia polyfill javascript程式庫和修改的Picturefill javascript程式庫。cq:editConfig
節點覆蓋CQ基礎影像元件,以便放置目標建立自適應影像元件,而不是基礎影像元件。adaptive-image.jsp指令碼包含下列程式碼,用於產生div元素和媒體查詢:
<div data-picture data-alt='<%= alt %>'>
<div data-src='<%= path + ".img.320.low." + extension + suffix %>' data-media="(min-width: 1px)"></div> <%-- Small mobile --%>
<div data-src='<%= path + ".img.320.medium." + extension + suffix %>' data-media="(min-width: 320px)"></div> <%-- Portrait mobile --%>
<div data-src='<%= path + ".img.480.medium." + extension + suffix %>' data-media="(min-width: 321px)"></div> <%-- Landscape mobile --%>
<div data-src='<%= path + ".img.476.high." + extension + suffix %>' data-media="(min-width: 481px)"></div> <%-- Portrait iPad --%>
<div data-src='<%= path + ".img.620.high." + extension + suffix %>' data-media="(min-width: 769px)"></div> <%-- Landscape iPad --%>
<div data-src='<%= path + ".img.full.high." + extension + suffix %>' data-media="(min-width: 1025px)"></div> <%-- Desktop --%>
<%-- Fallback content for non-JS browsers. Same img src as the initial, unqualified source element. --%>
<noscript>
<img src='<%= path + ".img.320.low." + extension + suffix %>' alt='<%= alt %>'>
</noscript>
</div>
path
變數包含目前資源的路徑(adaptive-image元件節點)。 程式碼會產生一系列div
元素,其結構如下:
<div data-scr = "*path-to-parent-node*.adaptive-image.adapt.*width*.*quality*.jpg" data-media="*media query*"></div>
data-scr
屬性的值是URL,Sling會解析至可轉譯影像的最適化影像元件Servlet。 data-media屬性包含根據用戶端屬性評估的媒體查詢。
以下HTML代碼是JSP生成的div
元素的示例:
<div data-src='/content/geometrixx-media/en/events/the-lineup-you-ve-been-waiting-for/jcr:content/article-content-par/adaptive_image.adapt.320.low.jpg'></div>
<div data-src='/content/geometrixx-media/en/events/the-lineup-you-ve-been-waiting-for/jcr:content/article-content-par/adaptive_image.adapt.320.medium.jpg' data-media="(min-width: 320px)"></div>
<div data-src='/content/geometrixx-media/en/events/the-lineup-you-ve-been-waiting-for/jcr:content/article-content-par/adaptive_image.adapt.480.medium.jpg' data-media="(min-width: 321px)"></div>
<div data-src='/content/geometrixx-media/en/events/the-lineup-you-ve-been-waiting-for/jcr:content/article-content-par/adaptive_image.adapt.476.high.jpg' data-media="(min-width: 481px)"></div>
<div data-src='/content/geometrixx-media/en/events/the-lineup-you-ve-been-waiting-for/jcr:content/article-content-par/adaptive_image.adapt.620.high.jpg' data-media="(min-width: 769px)"></div>
<div data-src='/content/geometrixx-media/en/events/the-lineup-you-ve-been-waiting-for/jcr:content/article-content-par/adaptive_image.adapt.full.high.jpg' data-media="(min-width: 1025px)"></div>
如果您自訂適用性影像元件並變更寬度選取器,您也必須設定適用性影像元件Servlet以支援寬度。
自適應影像元件Servlet根據指定的寬度調整JPEG影像的大小,並設定JPEG質量。
適用性影像元件Servlet系結至預設的Sling Servlet,並支援.jpg、.jpeg、.gif和.png副檔名。 Servlet選擇器為img。
AEM不支援動畫.gif檔案進行最適化轉譯。
因此,Sling會將下列格式的HTTP要求URL解析為此servlet:
*path-to-node*.img.*extension*
例如,Sling會將URL http://localhost:4502/content/geometrixx/adaptiveImage.img.jpg
的HTTP要求轉送至適用性影像元件Servlet。
另外兩個選擇器指定請求的影像寬度和JPEG質量。 下列範例要求寬度480像素且中等品質的影像:
http://localhost:4502/content/geometrixx/adaptiveImage.adapt.480.MEDIUM.jpg
支援的影像屬性
Servlet接受有限數量的影像寬度和質量。 預設支援以下寬度(以像素為單位):
完整值表示沒有縮放。
支援以下JPEG質量值:
數值分別為0.4、0.82和1.0。
更改預設支援寬度
使用Web主控台(http://localhost:4502/system/console/configMgr)或sling:OsgiConfig節點來設定Adobe CQ適用性影像元件Servlet支援的寬度。
有關如何配置AEM服務的資訊,請參閱配置OSGi。
Web主控台 | sling:OsgiConfig | |
---|---|---|
服務或節點名稱 | 「設定」標籤上的服務名稱為Adobe CQ適用性影像元件Servlet | com.day.cq.wcm.foundation.impl. AdaptiveImageComponentServlet |
屬性 | 支援的寬度
|
adapt.supported.widths
|
com.day.cq.wcm.foundation.impl.AdaptiveImageComponentServlet
類擴展了AbstractImageServlet類。 AdaptiveImageComponentServlet原始碼位於/libs/foundation/src/impl/src/com/day/cq/wcm/foundation/impl
資料夾中。
類使用Felix SCR注釋來配置servlet關聯的資源類型和副檔名以及第一個選擇器的名稱。
@Component(metatype = true, label = "Adobe CQ Adaptive Image Component Servlet",
description = "Render adaptive images in a variety of qualities")
@Service
@Properties(value = {
@Property(name = "sling.servlet.resourceTypes", value = "foundation/components/adaptiveimage", propertyPrivate = true),
@Property(name = "sling.servlet.selectors", value = "img", propertyPrivate = true),
@Property(name = "sling.servlet.extensions", value ={
"jpg",
"jpeg",
"png",
"gif"
}, propertyPrivate = true)
})
Servlet使用屬性SCR注釋來設定預設支援的影像質量和尺寸。
@Property(value = {
"320", // iPhone portrait
"480", // iPhone landscape
"476", // iPad portrait
"620" // iPad landscape
},
label = "Supported Widths",
description = "List of widths this component is permitted to generate.")
AbstractImageServlet
類提供處理HTTP請求的doGet
方法。 此方法會判斷與請求相關聯的資源,從儲存庫中擷取資源屬性,並在ImageContext物件中傳回。
com.day.cq.commons.DownloadResource類提供getFileReference method
,用於檢索資源fileReference
屬性的值。
AdaptiveImageComponentServlet
類覆蓋createLayer
方法。 該方法從ImageContext
對象獲取影像資源的路徑和所請求的影像寬度。 然後,它調用info.geometrixx.commons.impl.AdaptiveImageHelper
類的方法,這些方法執行實際影像縮放。
AdaptiveImageComponentServlet類還覆蓋writeLayer方法。 此方法將JPEG質量應用到影像。
示例Image Reference Modification Servlet為img元素生成大小屬性,以在網頁上縮放影像。
Servlet已綁定到cq:page
資源,並支援.jpg副檔名。 Servlet選擇器為image
。 因此,Sling會將下列格式的HTTP要求URL解析為此servlet:
path-to-page-node.image.jpg
例如,Sling會將URL為http://localhost:4502/content/geometrixx/en.image.jpg
的HTTP要求轉送至影像參考修改Servlet。
另外三個選取器會指定要求的影像寬度、高度和(選擇性)品質。 下列範例要求寬度770像素、高度360像素和中等品質的影像。
http://localhost:4502/content/geometrixx/en.image.770.360.MEDIUM.jpg
支援的影像屬性
Servlet接受有限數量的影像尺寸和質量值。
預設支援下列值(widthheight):
支援下列影像品質值:
使用AEM時,有數種方法可管理這類服務的組態設定;如需完整詳細資訊,請參閱設定OSGi 。
影像路徑、維度和質量值必須儲存為儲存庫中節點的屬性:
節點名稱為image
。
父節點是cq:page
資源的jcr:content
節點。
影像路徑儲存為fileReference
屬性的值。
編寫頁面時,請使用Sidekick指定影像,並將image
節點新增至頁面屬性:
info.geometrixx.commons.impl.servlets.ImageReferenceModificationServlet類擴展了AbstractImageServlet類。 如果已安裝cq-geometrixx-commons-pkg套件,則ImageReferenceModificationServlet原始碼位於/apps/geometrixx-commons/src/core/src/main/java/info/geometrixx/commons/impl/servlets
資料夾中。
類使用Felix SCR注釋來配置servlet關聯的資源類型和副檔名以及第一個選擇器的名稱。
@Component(metatype = true, label = "Adobe CQ Image Reference Modification Servlet",
description = "Render the image associated with a page in a variety of dimensions and qualities")
@Service
@Properties(value = {
@Property(name = "sling.servlet.resourceTypes", value = NameConstants.NT_PAGE, propertyPrivate = true),
@Property(name = "sling.servlet.selectors", value = "image", propertyPrivate = true),
@Property(name = "sling.servlet.extensions", value = "jpg", propertyPrivate = true)
})
Servlet使用屬性SCR注釋來設定預設支援的影像質量和尺寸。
@Property(label = "Image Quality",
description = "Quality must be a double between 0.0 and 1.0", value = "0.82")
@Property(value = {
"256x192", // Category page article list images
"370x150", // "Most popular" desktop & iPad & carousel min-width: 1px
"480x200", // "Most popular" phone
"127x127", // article summary phone square images
"770x360", // article summary, desktop
"620x290", // article summary, tablet
"480x225", // article summary, phone (landscape)
"320x150", // article summary, phone (portrait) and fallback
"375x175", // 2-column article summary, desktop
"303x142", // 2-column article summary, tablet
"1170x400", // carousel, full
"940x340", // carousel min-width: 980px
"770x300", // carousel min-width: 768px
"480x190" // carousel min-width: 480px
},
label = "Supported Resolutions",
description = "List of resolutions this component is permitted to generate.")
AbstractImageServlet
類提供處理HTTP請求的doGet
方法。 此方法會判斷與呼叫相關聯的資源,從存放庫中擷取資源屬性,並將其儲存在ImageContext物件中。
ImageReferenceModificationServlet
類覆蓋createLayer
方法並實現確定要呈現的影像資源的邏輯。 方法會擷取頁面jcr:content
節點(名為image
)的子節點。 從此image
節點建立影像對象,而getFileReference
方法從影像節點的fileReference
屬性返回影像檔案的路徑。
com.day.cq.commons.DownloadResource類提供getFileReferencemethod。
AEM可讓您有效實作流體格線。 本頁面說明如何將流體格線或現有格線實施(例如Bootstrap)整合至AEM應用程式。
如果您不熟悉流體格線,請參閱此頁面底部的流體格線簡介區段。 本文概述了流體網格的概述,並為流體網格的設計提供了指導。
使用頁面元件來產生定義頁面內容區塊的HTML元素。 頁面所參考的ClientLibraryFolder提供控制內容區塊配置的CSS:
例如,範例geometrixx-media應用程式包含media-home元件。 此頁元件插入兩個指令碼,它們生成類row-fluid
的兩個div
元素:
第一行包含span12
類的div
元素(內容跨越12列)。 div
元素包含parsys元件。
第二行包含兩個div
元素,一個是類span8
,另一個是類span4
。 每個div
元素都包含parsys元件。
<div class="page-content">
<div class="row-fluid">
<div class="span12">
<cq:include path="grid-12-par" resourceType="foundation/components/parsys" />
</div>
</div>
<div class="row-fluid">
<div class="span8">
<cq:include path="grid-8-par" resourceType="foundation/components/parsys" />
</div>
<div class="span4">
<cq:include path="grid-4-par" resourceType="foundation/components/parsys" />
</div>
</div>
</div>
當元件包含多個參考parsys元件的cq:include
元素時,每個path
屬性必須有不同的值。
與geometrixx-media頁面元件(/etc/designs/geometrixx-media
)相關聯的設計包含clientlibs
ClientLibraryFolder。 此ClientLibraryFolder定義row-fluid
類、span*
類和span*
類的CSS樣式,這些類是row-fluid
類的子類。 媒體查詢可根據不同的檢視區大小重新定義樣式。
以下範例CSS是這些樣式的子集。 此子集側重於span12
、span8
和span4
類,以及兩個視區大小的媒體查詢。 請注意CSS的下列特性:
.span
樣式使用絕對數字定義元素寬度。.row-fluid .span*
樣式將元素寬度定義為父項的百分比。 百分比是從絕對寬度計算。Geometrixx Media範例將Bootstrapjavascript架構整合至其流動格線實施中。 Bootstrap框架提供bootstrap.css檔案。
/* default styles (no media queries) */
.span12 { width: 940px }
.span8 { width: 620px }
.span4 { width: 300px }
.row-fluid .span12 { width: 100% }
.row-fluid .span8 { width: 65.95744680851064% }
.row-fluid .span4 { width: 31.914893617021278% }
@media (min-width: 768px) and (max-width: 979px) {
.span12 { width: 724px; }
.span8 { width: 476px; }
.span4 { width: 228px; }
.row-fluid .span12 { width: 100%;}
.row-fluid .span8 { width: 65.74585635359117%; }
.row-fluid .span4 { width: 31.491712707182323%; }
}
@media (min-width: 1200px) {
.span12 { width: 1170px }
.span8 { width: 770px }
.span4 { width: 370px }
.row-fluid .span12 { width: 100% }
.row-fluid .span8 { width: 65.81196581196582% }
.row-fluid .span4 { width: 31.623931623931625% }
}
範例Geometrixx Media應用程式的頁面在寬檢視區中水準分佈內容區塊列。 在較小的檢視區中,相同的區塊會垂直分佈。 下列範例CSS顯示為媒體首頁元件產生的HTML程式碼實作此行為的樣式:
media-welcome頁的預設CSS為span*
類內row-fluid
類指定float:left
樣式。
較小視區的媒體查詢會為相同類別指派float:none
樣式。
/* default styles (no media queries) */
.row-fluid [class*="span"] {
width: 100%;
float: left;
}
@media (max-width: 767px) {
[class*="span"], .row-fluid [class*="span"] {
float: none;
width: 100%;
}
}
將元件模組化,以有效使用程式碼。 您的網站可能會使用數種不同類型的頁面,例如歡迎頁面、文章頁面或產品頁面。 每種類型的頁面包含不同的內容類型,且可能使用不同的版面。 不過,當每個版面的某些元素在多個頁面間共用時,您可以重複使用實作該部分版面的程式碼。
使用頁面元件覆蓋
建立首頁元件,該元件提供用於生成頁面各個部分的指令碼,如主體內的head
和body
部分,以及header
、content
和footer
部分。
建立使用首頁面元件作為cq:resourceSuperType
的其他頁面元件。 這些元件包含可視需要覆寫主要頁面指令碼的指令碼。
例如, goemetrixx-media應用程式包含頁面元件(sling:resourceSuperType
是基礎頁面元件)。 有數個子元件(例如文章、類別和媒體首頁)使用此頁面元件作為sling:resourceSuperType
。 每個子元件都包含一個content.jsp檔案,該檔案將覆蓋頁元件的content.jsp檔案。
重複使用指令碼
建立多個JSP指令碼,這些指令碼生成多個頁面元件通用的行和列組合。 例如,文章的content.jsp
指令碼和media-home元件都參考8x4col.jsp
指令碼。
依目標檢視區大小組織CSS樣式
在個別檔案中包含不同檢視區大小的CSS樣式和媒體查詢。 使用用戶端程式庫資料夾來串連。
元件產生單一內容區塊時,通常頁面元件所建立的格線會控制內容的放置位置。
作者應注意,內容區塊可以以各種大小和相對位置呈現。 內容文字不應使用相對方向來參照其他內容區塊。
如有需要,元件應提供其產生之HTML程式碼所需的任何CSS或Javascript程式庫。 在元件內使用用戶端程式庫資料夾來產生CSS和JS檔案。 若要公開檔案,請建立相依性,或將程式庫嵌入/etc資料夾下的另一個客戶端程式庫資料夾。
子網格
如果元件包含多個內容區塊,請在列內新增內容區塊,以在頁面上建立子格線:
例如, /apps/geometrixx-media/components/2-col-article-summary
元件會產生兩欄內容。 其產生的HTML具有下列結構:
<div class="row-fluid mutli-col-article-summary">
<div class="span6">
<article>
<div class="article-summary-image">...</div>
<div class="social-header">...</div>
<div class="article-summary-description">...</div>
<div class="social">...</div>
</article>
</div>
</div>
頁面CSS的.row-fluid .span6
選取器會套用至此HTML中相同類別和結構的div
元素。 不過,元件也包含/apps/geometrixx-media/components/2-col-article-summary/clientlibs用戶端程式庫資料夾:
div
元素的multi-col-article-summary
類別來覆寫頁面row-fluid
類別的行為。例如,/apps/geometrixx-media/components/2-col-article-summary/clientlibs/css/responsive-480px.css
檔案中包括以下樣式:
@media (max-width: 480px) {
.mutli-col-article-summary .article-summary-image {
float: left;
width: 127px;
}
.mutli-col-article-summary .article-summary-description {
width: auto;
margin-left: 127px;
}
.mutli-col-article-summary .article-summary-description h4 {
padding-left: 10px;
}
.mutli-col-article-summary .article-summary-text {
margin-left: 127px;
min-height: 122px;
top: 0;
}
}
流暢的格線可讓頁面配置與用戶端檢視區的尺寸相適應。 網格由邏輯欄和列組成,這些列會在頁面上放置內容區塊。
使用HTML5技術,您可以實作格線並操控其,以調整頁面配置以適應不同的檢視區大小:
div
元素包含跨越特定數列的內容區塊。對於您要定位的每個檢視區寬度範圍,請使用靜態頁面寬度和內容區塊(以恆定寬度表示)。 手動調整瀏覽器視窗大小時,內容大小的變更會發生在離散的視窗寬度(也稱為中斷點)。 因此,頁面設計得更緊密地黏附,以最大化使用者體驗。
使用格線來縮放內容區塊,以適應不同的檢視區大小。 內容區塊會跨越特定數量的欄。 隨著欄寬增加或減少以適合不同的視區尺寸,內容區塊的寬度相應地增加或減少。 縮放可支援大型和中型檢視區,其寬度足以容納並排放置內容區塊。
內容區塊的大小可以受到最小寬度的限制,超過此寬度便不再有效縮放。 對於較小的檢視區,格線可用來垂直分佈內容區塊,而非水準分佈。
決定在頁面上放置內容區塊所需的欄和列。 您的頁面配置決定跨網格的欄和列數。
欄數
包括足夠的列,以水準放置所有佈局中的內容塊(所有視區大小)。 若要容納未來的頁面設計,您應使用的欄數應多於目前所需的欄數。
列內容
使用列來控制內容區塊的垂直定位。 決定共用相同列的內容區塊:
建立CSS類別和樣式以控制頁面上內容區塊的版面。 頁面設計通常以檢視區內內容區塊的相對大小和位置為基礎。 檢視區會決定內容區塊的實際大小。 您的CSS必須考慮相對大小和絕對大小。 您可以使用三種CSS類別來實作流動格線:
div
元素的類,它是所有行的容器。 此類設定網格的絕對寬度。div
元素的類。 此類控制其包含的內容塊的水準或垂直位置。div
元素的類,表示不同寬度的內容塊。 寬度以父項(列)的百分比表示。目標檢視區寬度(及其相關的媒體查詢)會標定用於頁面配置的離散寬度。
通常,內容塊類的width
樣式基於頁面和網格的以下特性:
CSS包含一系列使用下列結構的媒體查詢:
@media(query_for_targeted_viewport){
.class_for_container{ width:absolute_page_width }
.class_for_row { width:100%}
/* several selectors for content blocks */
.class_for_content_block1 { width:absolute_block_width1 }
.class_for_content_block2 { width:absolute_block_width2 }
...
/* several selectors for content blocks inside rows */
.class_for_row .class_for_content_block1 { width:relative_block_width1 }
.class_for_row .class_for_content_block2 { width:relative_block_width2 }
...
}
使用下列演算法作為開發頁面的元素類別和CSS樣式的起點。
為包含所有行的div元素定義類名,例如content.
為代表列的div元素(例如row-fluid
)定義CSS類別。
定義內容區塊元素的類別名稱。 所有可能的寬度(以列範圍計)都需要一個類。 例如,對跨3列的div
元素使用span3
類,對跨4列的span4
類使用類。 定義網格中列數。
針對您要定位的每個檢視區大小,將對應的媒體查詢新增至您的CSS檔案。 在每個媒體查詢中新增下列項目:
content
類的選擇器,例如.content{}
。.span3{ }
。row-fluid
類的選擇器,例如.row-fluid{ }
.row-fluid span3 { }
。為每個選取器新增寬度樣式:
content
選取器的寬度設定為頁面的絕對大小,例如width:480px
。(absolute width of page)/(number of columns)
。.row-fluid .span
選取器的寬度設定為總寬度的百分比。 使用(absolute span width)/(absolute page width)*100
公式計算此寬度。使用.row-fluid
類的浮點樣式來控制行中的內容塊是水準排列還是垂直排列。
float:left
或float:right
樣式會導致子元素(內容區塊)的水準分佈。
float:none
樣式會造成子元素的垂直分佈。
將樣式新增至每個媒體查詢內的.row-fluid
選取器。 根據您要用於該媒體查詢的頁面配置設定值。 例如,下圖說明的列會水準分配內容供寬檢視區使用,而垂直分配供窄檢視區使用。
下列CSS可實作此行為:
@media (min-width: 768px) and (max-width: 979px) {
.row-fluid {
width:100%;
float:left
}
}
@media (max-width:480px){
.row-fluid {
width:100%;
float:none
}
}
針對您要定位的每個檢視區大小的頁面版面,決定每個內容區塊涵蓋的欄數。 然後,決定要用於這些內容區塊的div元素的類別。
建立div類後,可以使用AEM應用程式實施網格。