チェックボックスグループ

チェックボックスグループは複数のチェックボックス選択肢からひとつ、または複数選択を行うコンポーネントです。選択肢となるチェックボックスはオプション設定によって行います。

ノート

コンポーネントの高さよりもチェックボックスの選択肢が多い場合、選択肢の一部が見えなくなります。その場合、高さを十分に大きくするか、[スクロールバー (scrollBar)]プロパティを [ON (true)]に設定します。

プロパティ

No	項目	入力値	デフォルト値	アクションプロパティ	タイプ	アクションデフォルト値	説明
1	ID	文字列	自動設定	id	string		[id]プロパティはアクションで設定はできません。
2	ラベル L	文字列	Checkbox Group	label	string	Checkbox Group	コンポーネントのラベル
3	幅	文字列	222	width	string	222	コンポーネントの幅
4	高さ	文字列	115	height	string	115	コンポーネントの高さ
5	X	文字列		x	string		X座標位置
6	Y	文字列		y	string		Y座標位置
7	位置固定	真偽	OFF	lock	boolean	false	ONの場合は画面をスクロールしてもコンポーネントが固定されて表示されます。 OFFの場合は画面をスクロールするとそれに合わせてコンポーネントも動きます。 v4.1.0で追加されたプロパティ
8	色	文字列 カラーピッカー		color	string		チェックボックスの色
9	背景色	文字列 カラーピッカー		backgroundColor	string		背景色
10	ラベル色	文字列 カラーピッカー		labelColor	string		ラベルの文字色
11	入力文字色	文字列 カラーピッカー		inputColor	string		入力文字の色
12	非アクティブ	真偽	OFF	disabled	boolean	false	非アクティブ状態
13	読み取り専用	真偽	OFF	readOnly	boolean	false	読み取り専用モード
14	必須	真偽	OFF	required	boolean	false	必須入力設定
15	表示	真偽	ON	visibility	boolean	true	表示状態
16	水平位置	選択 1. 左 2. 中央 3. 右	左	horizontalAlignment	string	left	水平方向の配置
17	垂直位置	選択 1. 上 2. 中央 3. 下	上	verticalAlignment	string	top	垂直方向の配置
18	スクロールバー	真偽	OFF	scrollBar	boolean	false	スクロールバーの表示
19	ヘルパーテキスト	文字列		helperText	string		ヘルパーテキスト
20	方向	選択 1. 垂直 2. 水平	垂直				チェックボックスの配置方向
21	オプション	表形式 [詳細1]	[詳細1]	options	array of object	[詳細1]	チェックボックスの選択肢
22	値	選択	[“option1”]	value	string array	[“option1”]	選択されている値
23	チェンジイベント	選択 1. なし 2. アクション 3. 切り離されたアクション	なし				値変更時のイベント 切り離されたアクションはv4.1.0で選択可能になりました。
24	エラー			error	boolean	false	エラー状態（ダイアログプロパティなし）
25	切り離されたアクション	選択 1.[切り離されたアクションのID]		detachedAction	string		切り離されたアクションを設定 v4.1.0で追加されたプロパティ

ノート

• ^L：多言語対応プロパティとなります。
• [オプション]はフィールド右上のアイコンからダイアログが起動します。
• [幅]、[高さ]プロパティ値には下記を入力できます。
  px表示したい場合は数値のみ、%表示したい場合は単位に%を指定してください。
  下記以外を入力した場合の動作はサポート外になります。
  • 数値
  • 数値%
  • calc()関数
• [X]、[Y]プロパティ値には下記を入力できます。
  px表示したい場合は数値のみを指定してください。
  下記以外を入力した場合の動作はサポート外になります。
  • 数値
  • calc()関数
• calc()関数はCSSの関数で、計算を可能にする関数です。（例：calc(100% - 30px)）
  calc()関数で使用できる単位は 「%」と 「px」です。それ以外の単位（例：em,remなど）はサポート外になります。
• calc()関数を用いてサイズを指定した際は、エディタ上の表示とアプリ上の見た目が異なることがあります。
  プレビューを用いてご確認ください。
• [背景色]に指定した色は、チェックボックスの□の枠部分に反映されます。
• [必須]プロパティをONにした場合、ラベルの横に * マークが付きます。
  必須チェックは自動では行いませんので、アクションを定義してください。
• [スクロールバー]プロパティを[ON]に設定した場合は、[水平位置]及び[垂直位置]プロパティの値が[左]と[上]で固定されます。

[詳細1] オプション

デフォルトの状態は以下のように登録されています。[ADD]ボタンから[Label]と[Value]の組を登録します。 削除する場合は、チェックボックスを選択して、[DELETE]ボタンをクリックします。

選択	Label	Value
チェックボックス	Option1	option1
チェックボックス	Option2	option2

イベント

イベント名	説明
onchange	値の変更が行われた時に発生します。