調適型表單的樣式建構 styling-constructs-for-adaptive-forms

Adobe 建議使用新式且可擴充的資料擷取核心元件,用來建立新的最適化表單將最適化表單新增到 AEM Sites 頁面。這些元件代表最適化表單建立方面的重大進步,可確保令人印象深刻的使用者體驗。本文會介紹使用基礎元件編寫最適化表單的舊方法。

先決條件 prerequisites

CSS和LESS架構的相關知識。

可自訂的專案 what-can-be-customized

本文列出可公開使用的調適型表單css類別。 您可以使用這些類別來設定最適化表單中各種元件的樣式。 製作元件的樣式(例如顯示警告的對話方塊和狀態列)超出本文範圍。 只有在您無法使用來樣式化元件時,才使用這些樣式建構來建立樣式(使用CSS或更少)。 主題編輯器.

在調適型表單中自訂樣式 customizing-styles-in-adaptive-forms

LESS框架簡化了使用案例,進而能夠在最適化表單中自訂樣式。 此框架可讓您使用一組變數和函式(mixin)來定義樣式。 LESS架構有助於減少套件程式碼的大小,並提高其重複使用性。

您可以透過下列方式自訂最適化表單樣式:

  • 變更主題
  • 變更元件的樣式

變更主題 changing-theme

您可以變更最適化表單的主題,以確保其外觀與內嵌最適化表單的網頁一致。

使用CSS屬性的最適化表單的整體外觀變更通常是主題變更的一部分。 最適化表單的「確定和感覺」的重大變更,例如元件版面配置和位置的變更,不被視為主題變更。

根據啟動程式,以下幾組CSS屬性會定義網頁的主題:

  • 背景色彩
  • 邊框(文字、顏色、粗細)
  • 字型色彩
  • 邊距
  • 邊距
  • 字型大小
  • 行高

目前,LESS變數僅針對最適化表單中各種元素的這些屬性而定義。

變更元件樣式 changing-component-style

您可以變更元素的外觀、配置、位置和可見度。 若要完成這項工作,請建立或更新您的自訂.css檔案,以包含本文列出的樣式建構。

若要將樣式套用至最適化表單,請在中開啟最適化表單以進行編輯,開啟最適化表單容器的屬性,在基本索引標籤中指定自訂CSS檔案的路徑。 預設最適化表單的樣式建構,並以自訂.css檔案中所列的建構覆寫。

元件 components

本文討論的元件具有其預先定義的CSS類別。 您可以編輯變數來修改CSS類別中的樣式。 或者,您可以重寫整個類別。 本節說明可以使用變數修改的元件和樣式中的類別。

容器樣式 container-styling

容器是頂層元件。 其他面板和欄位則位於容器元件下。

CSS 類別
guideContainerNode
變數說明
變數說明
container-bgColor
容器的背景顏色
container-padding
容器的內距
container-margin
容器的邊界
container-fontColor
容器的字型顏色

欄位樣式 field-styling

調適型表單包含各種欄位型別。 每個欄位都有唯一的類別名稱,即欄位名稱。 欄位也有常見的類別名稱 guideFieldNode.

欄位包含標籤、Widget、說明說明(完整和簡短說明)以及欄位說明圖示(問號)。

CSS 類別
guideFieldNode
變數
說明
field-padding
欄位內距
field-error-font-color
欄位錯誤訊息的字型顏色
field-error-font-size
欄位錯誤訊息的字型大小

標籤樣式 label-styling

HTML元素 標籤 用於欄位包括類別 左側top 標籤位於頂端還是左側。

CSS 類別
guideFieldLabel
變數
說明
label-font-color
欄位標籤的字型顏色
label-font-size
欄位標籤的字型大小
label-line-height
欄位標籤的CSS行高屬性
label-font-weight
欄位標籤的CSS字型權重屬性
label-margin
欄位標籤的邊界

標籤的CSS規則是使用 Guidelfiellabel 標籤。 如果您是作者,請覆寫此規則以顯示自訂變更。

Widget樣式 widgets-styling

視其型別而定,Widget也包含類別。 通常Widget包含 guideFieldWidget 類別。 附帶HTML的Widget通常使用標準HTML元素輸入並選取。 樣式會據此來設定。 您無法藉由變更變數來設定自訂Widget的樣式。

CSS 類別
guideFieldWidget
變數``
說明
widgets-bg-color
Widget的背景顏色(核取方塊和選項按鈕無法運作)
widgets-border-color
Widget的邊框顏色
widgets-border-thickness
Widget的邊框大小
widgets-border-radius
Widget邊框半徑
widgets-border-type
Widget的邊框型別
widget-border-focus-type
Widget邊框的焦點型別
widgets-border
Widget的整合邊框樣式
widgets-font-color
Widget內文字的色彩
widgets-font-size
Widget內文字的大小
widgets-line-height
Widget的CSS lineheight屬性
widgets-padding
Widget的CSS填補屬性
widgets-focus-border-color
Widget成為焦點時的邊框顏色
widgets-mandatory-border-color
必要欄位的Widget邊框顏色
widgets-mandatory-bg-color
必要欄位的Widget背景顏色
widgets-disabled-bg-color
欄位停用時小工具的背景顏色
widgets-disabled-font-color
停用欄位時Widget的字型顏色
widgets-disabled-border-color
欄位停用時之Widget的邊框顏色
widget-height
Widget的高度(核取方塊和選項按鈕無法運作)
checkbutton-height
核取方塊和選項按鈕的高度。
listboxwidget-height
多選下拉式清單的最大高度

Widget樣式限制 limitations-in-widget-styling

焦點、強制和停用欄位的樣式會使用變數加以限制。 不過,您可以覆寫樣式來變更它。 提供使用變數的限制主要是為了控制變數的數量。 如果欄位處於先前討論的任何狀態,因此其外觀會大幅變更,則可放寬限制。

說明說明 help-description

作者可以使用簡短和完整說明元件,在欄位中指定說明內容。 兩個元件都有共同類別 .guideHelpDescription 和另一個類別 .long/ .short,視說明型別而定。 說明內容會包含在段落元素中,以覆寫說明的樣式。 說明說明(長與短)會使用以widgetshelp開頭的變數加以修改,如下表所述:

變數
說明
widgets-help-long-bg-color
Widget長說明的背景顏色
widgets-help-long-border-color
Widget長說明的邊框顏色
widgets-help-long-border-indicator-color
Widget長說明的左側指標邊框顏色
widgets-help-short-bg-color
Widget簡短說明的背景顏色
widgets-help-short-color
Widget簡短說明的字型顏色
widgets-help-short-tooltip-bg-color
Widget簡短工具提示的背景色彩說明
widgets-help-short-tooltip-color
Widget簡短工具提示說明的字型顏色

條款與條件 terms-and-conditions

條款與條件(TnC) ``) widget可讓您指定條款與條件。 您可以使用下表所述的變數來自訂Widget。

變數
說明
tnc-unvisited
未造訪的Tnc連結的字型顏色。
tnc-visited
造訪的tnc連結的字型色彩。

按鈕 button

按鈕也是Widget。 不過,它們的樣式與Widget稍有不同。 在調適型表單中,下列任一項構成按鈕:

  • 輸入[型別=文字]
  • 按鈕
  • 具有類別.button的元素

按鈕的HTML代碼:

<button type="button" >

<span class="iconButtonicon"></

span>

<span class="iconButtonlabel"></

span>

</button>

CSS 類別
說明
iconButton-icon
提供按鈕的圖示
iconButton-label
樣式按鈕標籤/標題
變數``
說明
button-border-size
按鈕的邊框大小
button-border-type
邊框型別
button-padding
按鈕的CSS邊框間距屬性
button-font-size
按鈕的字型大小
button-background-color
按鈕的背景顏色
button-font-color
按鈕的字型顏色
button-border-color
按鈕的邊框顏色
button-large-padding
大型按鈕(類別為.buttonlarge的按鈕)的邊距
button-large-font-size
大型按鈕的字型大小
button-small-padding
小型按鈕(類別為.buttonsmall的按鈕)的邊距
button-small-font-size
小型按鈕的字型大小
button-info-background-color
資訊按鈕(類別為.buttoninformative的按鈕)的背景顏色
button-info-font-color
資訊按鈕的字型顏色
button-info-border-color
資訊按鈕的邊框顏色
button-warning-background-color
警告樣式按鈕(具有.buttonwarning類別的按鈕)的背景顏色
button-warning-font-color
警告樣式按鈕的字型色彩
button-warning-border-color
警告樣式按鈕的邊框顏色
button-alert-background-color
警示按鈕(類別為.buttonalert的按鈕)的背景顏色
button-alert-font-color
警示按鈕的字型顏色
button-alert-border-color
警示按鈕的邊框顏色

問號 question-mark

對於Widget,當作者在說明內容中新增詳細說明,會顯示問號。 系統會使用bootstrap中提供的預設圖示。 若要使用自訂圖示,您可以自訂啟動程式圖示。

CSS 類別
guideHelpQuestionMark
變數
說明
questionmark-font-color
圖示的顏色
questionmark-hover-font-color
當滑鼠停留在圖示上時的圖示顏色

表格 table

您可以使用下列變數來變更表格中標題列和本文列的顏色主題。

變數
說明
table-header-bg-color
標題列的背景顏色。 預設值為 #333.
table-odd-row-bg-color
奇數正文列的背景顏色。 預設值為 rgb(255, 255, 255)
table-even-row-bg-color
偶數正文列的背景顏色。 預設值為 #eee

檔案附件 file-attachment

最適化表單的檔案附件Widget可讓您上傳檔案。 您也可以使用變數自訂Widget。

變數
說明
fileItemPadding
Widget中顯示之檔案的內距
fileItemBackground
檔案專案的背景顏色
fileItemBorderColor
上邊框的邊框顏色
fileItemColor
檔案專案的字型顏色
filePreviewIconColor
小工具中預覽圖示(Bootstrap圖示)的顏色
fileItemCommentHeight
檔案專案的註解高度

瀏覽器樣式 navigator-styles

有四種型別的導覽器標籤。 這些標籤包括左側、頂部、精靈和摺疊式功能表。 每個瀏覽器都有不同的類別。

導覽器
CSS 類別
Accordion
.accordion-navigators
tabs on the left
.tab-navigators-vertical
tabs on the top
.tab-navigator
Wizard
.wizard-navigators

以下是Tab鍵瀏覽器元素的HTML代碼(類似於Bootstrap標籤):

<li>

<a>tab title</a>

</li>

Accordion navigator is an exception, it has following barebone

structure:

<div class="accordion.navigators">

<div>

<div class = "guideHeader">

<a>

<span class = "guideSummary" ></code>

........................... repeatable buttons, if the repeatable configuration is set ................................

<div class = "repeatableButtons">

<button name="Add" class="Add"/>

<button name="Remove" class="Remove"/>

</div>

</a>

</div>

................................ panel content ..................................

</div>

</div>

您可以使用CSS規則變更導覽器的樣式,CSS規則會使用以下方式選取元素 下級 選擇器。 例如,若要將文字裝飾樣式新增至錨點標籤:

頂端的Tab導覽器:

.tab-navigators

li a {

text-decoration:

underline;

}

Tab navigator on left:

.tab-navigators-vertical

li a {

text-decoration:

underline;

}

Accordion navigator:

.accordion-navigators .guideHeader a .guideSummary {

text-decoration:

underline;

}

Wizard navigator:

.wizard-navigators

li a {

text-decoration:

underline;

}

此外,根據標籤導覽器是否有巢狀/子項/子項導覽器,有類別可設定標籤導覽器的樣式(左側和頂部)。

CSS 類別
說明
nested_true
具有巢狀/子項/子項導覽器的標籤導覽器(左側和頂部)
nested_false
沒有巢狀/子項/子項導覽器的索引標籤導覽器(左和上)

guideNavIcon類別會提供預設圖示,供定位點導覽器(左側和頂部)和精靈導覽器使用。

CSS 類別
guideNavIcon
NOTE
您可以在編寫表單範例的面板上提供CSS類別,以變更特定導覽器的圖示 <class_name>. 您新增 <class_name>_nav 用於導覽器的圖示。
變數
說明
標籤導覽器
navigator-bg-color
整個標籤導覽器的背景顏色
tabs-bg-color
標籤的背景顏色
tabs-font-color
標籤的字型顏色
tabs-hover-bg-color
游標停留時索引標籤的背景顏色
tabs-hover-font-color
游標停留時索引標籤的字型顏色
tabs-active-bg-color
面板成為焦點時的背景顏色(作用中)
tabs-active-font-color
面板成為焦點時的字型顏色
tabs-completed-bg-color
面板的完成運算式傳回true時的背景顏色
tabs-completed-font-color
面板的完成運算式傳回true時的字型顏色
tabs-stepped-bg-color
面板成為焦點一次,但完成運算式傳回false時的背景顏色
tabs-stepped-font-color
面板成為焦點一次,但完成運算式傳回false時的字型顏色
tabs-border-color
標籤的邊框顏色
tabs-font-size
標籤的字型大小
tabs-padding
標籤的內距
tabs-margin
索引標籤的邊界
tabs-vertical-margin
垂直標籤的邊界
tabs-border-thickness
標籤的邊框大小
tabs-min-height
標籤的最小高度
heirarichal-indent
巢狀索引標籤的縮排
精靈導覽器
wizard-navigator-bg-color
整個精靈導覽器的背景顏色
wizard-tabs-bg-color
精靈的背景顏色
wizard-tabs-font-color
精靈的字型顏色
wizard-tabs-active-bg-color
面板成為焦點時的背景顏色(作用中)
wizard-tabs-active-font-color
面板成為焦點時的字型顏色(焦點)
wizard-tabs-completed-bg-color
面板的完成運算式傳回true時的背景顏色
wizard-tabs-completed-font-color
面板的完成運算式傳回true時的字型顏色
wizard-tabs-stepped-bg-color
面板成為焦點一次,但完成運算式傳回false時的背景顏色
wizard-tabs-stepped-font-color
面板已聚焦一次,但完成運算式傳回false時的字型顏色
wizard-tabs-border-color
精靈的顏色
wizard-tabs-font-size
精靈的字型大小
wizard-tabs-padding
精靈的內距
wizard-tabs-border-thickness
精靈的邊框大小
wizard-nav-bullet-border
精靈導覽器專案符號的邊框顏色(在標題/標籤前置)
wizard-progress-bg-color
精靈導覽器進度列的背景顏色
wizard-progress-color
進度列的填色色彩
摺疊式導覽器
accordion-tabs-padding
摺疊式功能表的內距

面板樣式 panel-styling

面板包含選用的工具列及其內容。

CSS 類別
guidePanelNode
變數
說明
panel-background-color
面板的背景顏色
panel-font-size
面板文字的字型大小
panel-font-color
面板文字的字型顏色
panel-padding
面板內的內距
panel-description-font-size
面板說明的字型大小
panel-description-padding
面板說明的內距
panel-help-bg-color
面板說明的背景顏色
panel-help-border-indicator-color
面板說明的指標邊框顏色

面板節點分為導覽器和內容。 那裡 ``內容沒有獨立的樣式元件。 所描述的變數會套用至導覽器和內容。

最上層的面板(RootPanel)沒有這個類別。

行動樣式 mobile-styling

標題列 header-bar

這些變數會影響在包含面板標題以及下一個和背面導覽器的行動裝置或小熒幕裝置上顯示的標題列。

CSS 類別
guide-header-bar
變數
說明
headerbar-background-color
標題列的背景顏色
headerbar-font-color
標頭列中文字的字型顏色
headerbar-padding
標頭列的邊框間距

捲動指示器 scroll-indicator

這些變數會影響捲動指示器,也就是出現在行動裝置或小熒幕裝置上的橘色箭頭。 捲動指示器表示畫面可見部分以外的內容存在。 您可以向下捲動以檢視它。 當您按下內容的結尾時,箭頭會消失。

CSS 類別
mobileScrollIndicator
變數
說明
scrollIndicatorBottom
從底部固定卷軸指示器的位置
scrollIndicatorRight
從右側固定卷軸指示器的位置
scrollIndicatorWidth
卷軸指示器的寬度
scrollIndicatorHeight
卷軸指示器的高度

行動固定工具列配置特定變數 mobile-fixed-toolbar-layout-specific-variables

下表中的這些變數會影響行動固定工具列的配置。

CSS 類別
mobileToolbar
變數
說明
mobileToolbarBottom
固定工具列位置,在行動裝置上,從底部
mobileToolbarTop
在行動裝置上從頂端固定工具列位置
mobileToolbarLeft
固定工具列位置,在行動裝置上,從左側
mobileToolbarRight
在行動裝置上從右固定工具列位置
mobileButtonIconTopMargin
從頂端修正工具列按鈕圖示的位置
mobileButtonIconWidth
行動裝置上工具列按鈕圖示的寬度
mobileButtonIconHeight
行動裝置上工具列按鈕圖示的高度
mobilefixedtoolbarbgcolor
行動裝置上工具列的背景顏色

主題特定變數 theme-specific-variable

簡單註冊 /etc/clientlibs/fd/af/guidetheme/simpleEnrollment的主題和類別 guide.theme.simpleEnrollment 也會介紹一些變數。 如果要建立主題來增強簡單註冊,您可以使用以下「額外變數:

變數
說明
button-focus-bg-color
焦點按鈕的背景顏色
button-hover-bg-color
游標停留時按鈕的背景顏色
button-radius
按鈕的半徑
navigation-button-bg-color
導覽按鈕的背景顏色(上一步/下一步)
navigation-button-bg-hover-color
暫留時導覽按鈕的背景顏色(上一步/下一步)
initial-nav-color
第一次轉譯時精靈導覽器和對應進度列的背景顏色。
active-nav-color
目前/作用中精靈導覽器的背景顏色與對應的進度列
visited-nav-color
精靈導覽器的背景顏色和對應的進度列(已瀏覽)。
tabs-bifercating-border-color
邊框顏色將容器分成導覽器和面板
tabs-navigator-separator-color
左側索引標籤(索引標籤導覽器)的底部邊框顏色分隔索引標籤。
tabs-child-nav-bg-color
導覽器的巢狀/子項/子項導覽器的背景顏色
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2