アダプティブフォームのスタイル構成
- 適用対象:
- Experience Manager as a Cloud Service
- トピック:
- アダプティブフォーム
- 基盤コンポーネント
作成対象:
- ユーザー
前提条件
CSS および LESS フレームワークに関する知識。
カスタマイズの対象
この記事では、公開されているアダプティブフォームの CSS クラスについて説明します。これらのクラスを使用して、アダプティブフォームの様々なコンポーネントのスタイルを設定することができます。警告を表示するダイアログやステータスバーなど、オーサリングコンポーネントのスタイル設定については、ここでは説明しません。テーマエディターを使用してコンポーネントのスタイル設定ができない場合にのみ、これらのスタイル構造を使用してスタイル(CSS または Less)を作成してください。
アダプティブフォームのスタイルのカスタマイズ
LESS フレームワークにより、アダプティブフォームでのスタイルのカスタマイズを簡単に行うことができます。フレームワークでは、変数や関数のセット(Mixin)を使用したスタイルの定義が可能です。LESS フレームワークにより、バンドルされているコードのサイズを減らし、コードの再利用率を高めることができます。
アダプティブフォームのスタイルは、以下の方法でカスタマイズできます。
- テーマを変更
- コンポーネントのスタイルを変更
テーマを変更
アダプティブフォームのテーマを変更して、アダプティブフォームが組み込まれている Web ページと外観が一致するように変更できます。
テーマの変更は、通常、アダプティブフォームの全体的な外観を CSS プロパティを使用して変更することによって行われます。コンポーネントのレイアウトや配置の変更など、アダプティブフォームのルック&フィールへの大幅な変更は、テーマの変更とは見なされません。
Web ページのテーマは、ブートストラップに基づき、以下の CSS プロパティによって定義されます。
- 背景色
- ボーダー(種類、色、太さ)
- フォントカラー
- パディング
- 余白
- フォントサイズ
- 行の高さ
現在、LESS 変数は、アダプティブフォームの様々な要素のこれらのプロパティに対してのみ定義されています。
コンポーネントスタイルの変更
要素の外観、レイアウト、配置、可視性を変更できます。そのためには、カスタムの .css ファイルを作成または更新し、この記事で説明するスタイル構成をそのファイルに含めます。
アダプティブフォームにスタイルを適用するには、編集用としてアダプティブフォームを開き、アダプティブフォームコンテナのプロパティを開いて、「基本」タブでカスタム .css ファイルのパスを指定します。アダプティブフォームのデフォルトのスタイル構成は、カスタムの .css ファイル内の構成によって上書きされます。
コンポーネント
この記事で説明されているコンポーネントには、CSS クラスが事前に定義されています。変数を編集して、CSS クラスでスタイルを変更できます。または、クラス全体を書き換えることもできます。 このセクションでは、変数を使用して変更できるコンポーネントとスタイル内のクラスを説明します。
コンテナのスタイル設定
コンテナは、最上位のコンポーネントです。他のパネルおよびフィールドは、コンテナコンポーネントの下に位置しています。
guideContainerNode
container-bgColor
container-padding
container-margin
container-fontColor
フィールドのスタイル設定
アダプティブフォームには、様々なタイプのフィールドが含まれています。各フィールドには一意のクラス名があり、それがフィールドの名前となっています。また、フィールドには、guideFieldNode
という共通のクラス名もあります。
フィールドには、ラベル、ウィジェット、ヘルプの説明(詳細な説明と短い説明の両方)、フィールドヘルプアイコン(クエスチョンマーク)が含まれています。
guideFieldNode
field-padding
field-error-font-color
field-error-font-size
ラベルのスタイル設定
フィールドに使用される HTML 要素 label には、ラベルが上にあるか左にあるかによって、left または top のクラスが含まれます。
guideFieldLabel
label-font-color
label-font-size
label-line-height
label-font-weight
label-margin
ラベルに対する CSS ルールは、guideFieldLabel ラベルを使用して適用されます。カスタム変更を見えるようにするには、作成者がこのルールを上書きする必要があります。
ウィジェットのスタイル設定
タイプによっては、ウィジェットにもクラスが含まれています。一般的に、ウィジェットには guideFieldWidget
クラスが含まれています。HTML に付属のウィジェットは通常、標準の HTML 要素 input と select を使用しています。スタイル設定は、それに応じて行われます。変数を変更することによって、カスタムウィジェットのスタイル設定を行うことはできません。
guideFieldWidget
widgets-bg-color
widgets-border-color
widgets-border-thickness
widgets-border-radius
widgets-border-type
widget-border-focus-type
widgets-border
widgets-font-color
widgets-font-size
widgets-line-height
widgets-padding
widgets-focus-border-color
widgets-mandatory-border-color
widgets-mandatory-bg-color
widgets-disabled-bg-color
widgets-disabled-font-color
widgets-disabled-border-color
widget-height
checkbutton-height
listboxwidget-height
ウィジェットのスタイル設定における制限事項
フォーカスされたフィールド、必須フィールド、および無効なフィールドのスタイル設定は、変数を使用して制限されます。ただし、スタイルを上書きすることで変更することができます。変数の使用における制限は、主に変数の数を抑えるために設けられています。制限は、フィールドの外観が大きく変更され、前述の状態のいずれかにある場合に緩和できます。
ヘルプの説明
作成者は、短い説明と詳細な説明のコンポーネントを使用して、ヘルプコンテンツを指定できます。コンポーネントは両方とも、共通のクラス .guideHelpDescription
を持っており、説明のタイプによって、もう 1 つのクラス .long
/.short
を持っています。ヘルプコンテンツは、説明のスタイル設定を上書きする段落要素で囲まれています。ヘルプの説明(詳細な説明と短い説明の両方)は、以下の表で説明されるとおり、widgetshelp で始まる変数を使用して変更されます。
widgets-help-long-bg-color
widgets-help-long-border-color
widgets-help-long-border-indicator-color
widgets-help-short-bg-color
widgets-help-short-color
widgets-help-short-tooltip-bg-color
widgets-help-short-tooltip-color
利用条件
利用条件(TnC ``)ウィジェットでは、利用条件を指定できます。このウィジェットは、以下の表で説明する変数を使用してカスタマイズできます。
tnc-unvisited
tnc-visited
ボタン
ボタンもウィジェットの 1 つです。ただし、スタイル設定はウィジェットとは多少異なります。アダプティブフォームでは、以下のいずれかを含んでいればボタンと見なされます。
- input[type = text]
- button
- .button クラスを持つ要素
ボタンの HTML コード:
<button type="button" >
<span class="iconButtonicon"></
span>
<span class="iconButtonlabel"></
span>
</button>
iconButton-icon
iconButton-label
button-border-size
button-border-type
button-padding
button-font-size
button-background-color
button-font-color
button-border-color
button-large-padding
button-large-font-size
button-small-padding
button-small-font-size
button-info-background-color
button-info-font-color
button-info-border-color
button-warning-background-color
button-warning-font-color
button-warning-border-color
button-alert-background-color
button-alert-font-color
button-alert-border-color
疑問符
ウィジェットでは、作成者がヘルプ コンテンツに長い説明を追加すると、疑問符が表示されます。ブートストラップで提供されるデフォルトのアイコンが使用されます。カスタムアイコンを使用するには、ブートストラップアイコンをカスタマイズします。
guideHelpQuestionMark
questionmark-font-color
questionmark-hover-font-color
テーブル
テーブル内のヘッダーおよびボディ行のカラーテーマは、以下の変数を使用して変更できます。
table-header-bg-color
#333
です。table-odd-row-bg-color
rgb(255, 255, 255)
です。table-even-row-bg-color
#eee
です。ファイル添付
アダプティブフォームの添付ファイルウィジェットでは、ファイルをアップロードできます。変数を使用してウィジェットをカスタマイズすることもできます。
fileItemPadding
fileItemBackground
fileItemBorderColor
fileItemColor
filePreviewIconColor
fileItemCommentHeight
ナビゲーターのスタイル
ナビゲータータブは 4 種類あります。これらには、左側、上部、ウィザード、アコーディオンのタブがあります。各ナビゲーターには、異なるクラスが割り当てられています。
Accordion
tabs on the left
tabs on the top
Wizard
以下に示すのは、タブナビゲーター要素(ブートストラップタブに類似する)の HTML コードです。
<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>
descendant セレクターで要素を選択する CSS ルールを使用して、ナビゲーターのスタイル設定を変更できます。例えば、アンカータグにテキスト装飾スタイルを追加するには、以下のようにします。
上部のタブナビゲーター:
.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;
}
さらに、入れ子/子/サブナビゲーターの有無に基づいて、タブナビゲーター(左側と上部の両方)のスタイル設定を行うためのクラスがあります。
nested_true
nested_false
guideNavIcon クラスには、タブナビゲーター(左側と上部の両方)およびウィザードナビゲーターにデフォルトのアイコンがあります。
guideNavIcon
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
tabs-completed-font-color
tabs-stepped-bg-color
tabs-stepped-font-color
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
wizard-tabs-completed-font-color
wizard-tabs-stepped-bg-color
wizard-tabs-stepped-font-color
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
パネルのスタイル設定
パネルには、オプションのツールバーとそのコンテンツが含まれます。
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)にはこのクラスはありません。
モバイルのスタイル設定
ヘッダーバー
これらの変数は、ヘッダーバーに影響します。ヘッダーバーは、モバイルデバイスまたは画面の小さいデバイスに表示され、パネルタイトルおよび次へ/前へのナビゲーターを含むバーのことです。
guide-header-bar
headerbar-background-color
headerbar-font-color
headerbar-padding
スクロールインジケーター
これらの変数は、スクロールインジケーターに影響します。スクロールインジケーターは、モバイルデバイスまたは小さな画面のデバイスに表示されるオレンジ色の矢印です。スクロールインジケーターは、画面の表示されている部分を超えたコンテンツがあることを示します。下にスクロールして表示できます。矢印は、コンテンツの最後に到達すると消えます。
mobileScrollIndicator
scrollIndicatorBottom
scrollIndicatorRight
scrollIndicatorWidth
scrollIndicatorHeight
モバイル固定ツールバーのレイアウト固有の変数
以下の表に示すこれらの変数は、モバイル固定ツールバーのレイアウトに影響します。
mobileToolbar
mobileToolbarBottom
mobileToolbarTop
mobileToolbarLeft
mobileToolbarRight
mobileButtonIconTopMargin
mobileButtonIconWidth
mobileButtonIconHeight
mobilefixedtoolbarbgcolor
テーマ固有の変数
/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