使いどころ
ダイアログは、ユーザーの能動的なアクションを起点に、主に以下の目的で使用されます。
- 別の情報を操作する必要がある場合
- 作業の確認（参照・追加・編集・削除）を促す場合
- メッセージや警告をユーザーに表示する場合
情報設計をしっかり行ない、ダイアログで表示したい内容が上記に挙げた目的に合うものか、メインコンテンツの画面で表示するよりも適切な整理なのかをよく考えましょう。
ダイアログの乱用は避ける
ダイアログの乱用は避けましょう。
ダイアログの表示中は、メインコンテンツの情報・状態は保持されますが、ユーザーは（それまでの操作を中断し）ダイアログでの操作に集中させられることになります。
また、以下も推奨されません。
- ダイアログの上にダイアログを表示すること
- 複数のダイアログを同時に表示すること
種類
ActionDialog
SmartHR UIではActionDialogです。
ActionDialogは、ユーザーに選択の確認や操作を求める場合に使用するモーダルダイアログです。アクションボタンをPrimaryButtonで強調表示します。
MessageDialog
SmartHR UIではMessageDialogです。
MessageDialogは、ユーザーの操作を中断させて、ユーザーへの警告や確認を明示的にしたい場合に利用するモーダルダイアログです。
ユーザーの操作を中断させる必要がない場合は、FlashMessageやCompactInformationPanel、InformationPanelの採用を検討してください。
ModelessDialog
SmartHR UIではModelessDialogです。
ModelessDialogは、ユーザーに任意のタイミングや順序で、情報の確認や操作をさせたい場合に使用します。
レイアウト
基準サイズ
ダイアログの横幅サイズの基準値は以下のとおりです。
サイズに意図がない場合は、下記の値から想定に近い値を選択してください。
デスクトップ、タブレット（TABLET）
| サイズ | 値 | 補足説明 |
|---|---|---|
| S | 480px | Dialogの最小値として使います。 |
| M | 640px | |
| L | 768px | |
| MAX | calc(100% - 32px) | Dialogの最大値として使います。 |
スマートフォン（SP）
スマートフォンは表示領域が狭いため、サイズの最大値/最小値は同じとします。
| サイズ | 値 | 補足説明 |
|---|---|---|
| 標準 | calc(100% - 32px) | Dialogの最大値/最小値として使います。 |
表示位置
意図的な場合をのぞき、ダイアログは画面の天地中央（上下左右中央）に表示します。
モードレスダイアログ（ModelessDialog）では、操作の起点を示すために、ダイアログを開くボタンやリンクテキストの付近から表示することがあります。
ライティング
タイトルのつけ方
ダイアログは、コンポーネントの用途がそれぞれ明確にあり、タイトルのつけ方もそれぞれ異なります。
冗長な表記をなるべく避けてください。複数行になる長いタイトルは見直しましょう。
ActionDialog
基本的に、Headingの見出しの書き方と同様に、画面上のオブジェクトや操作を簡潔に体言止めで書きます。
- アクションに関わる動詞（動名詞）は、基本的に「の」で接続して表記します。
- 例えば、オブジェクトの追加のための操作を行なう場合、タイトルは、
[オブジェクト名]の追加となります。 - アクションを伴う画面のタイトルは「の」で接続する | ライティングガイド
- 例えば、オブジェクトの追加のための操作を行なう場合、タイトルは、
- データを永久に消去するなど、破壊的なアクションを示す際は、ユーザーに確認を促すために疑問形とします。
- 例えば、オブジェクトの操作を行なう場合、
[オブジェクト名]の[操作名]をしますか？とします。（削除ダイアログ | 設計ガイド）
- 例えば、オブジェクトの操作を行なう場合、
MessageDialog
メッセージ確認を促す簡潔な文書を入れます。ユーザーに注意喚起を促す、お知らせをしたいなど、目的に合わせたタイトルを設定してください。
ModelessDialog
［WIP］
設計ガイド
サブタイトルの使い方
原則利用しません。タイトルだけではオブジェクトや機能を特定できない場合にのみ利用してください。
ダイアログ外領域への操作
ダイアログ表示中における、ダイアログ外の領域に対する操作の基準は以下のとおりです。
| 操作 | モーダルダイアログ （ActionDialog, MessageDialog） | モードレスダイアログ （MessageDialog） |
|---|---|---|
| ダイアログ外のUIに対するインタラクション | ダイアログ外にスクリム（幕）を表示しているため、受け付けません。 | 受け付けます。 |
| ダイアログ外の領域のクリック | MessageDialogなど、ダイアログ内の情報を保持する必要がない用途では、ダイアログを閉じる動作を許容します。 | モードレスダイアログは閉じす、ダイアログ外のUIに対するインタラクションとして受け付けます。 |
ダイアログを閉じる操作
ダイアログを閉じるアクションは、ダイアログの種類に応じて異なります。
「キャンセル」ボタン
ユーザーが、ダイアログの操作を明示的に中断するためのアクションボタンです。
主にActionDialogで使用し、ActionDialogのセカンダリアクションとして配置します。
ダイアログ内の情報の保持状態（フォームの入力状態など）を初期化して、ダイアログを閉じる動作をします。
ダイアログ内の情報を途中保存していたり、自動保存している場合は、再表示時にもっとも近い保存時点まで復帰します。
「閉じる」ボタン
ユーザーが、ダイアログを閉じるためのアクションボタンです。
主にMessageDialogおよびModelessDialogで使用し、ダイアログの（唯一の）アクションとして配置します。
同じダイアログ内で、閉じる役割が重複する「キャンセル」ボタンと同時に配置されることはありません。
ダイアログ内にフォームなどを含む場合は、閉じる際に入力状態を保存し、再表示時には復帰することを推奨します。
ESCキー
ダイアログ表示中のキーボード操作として機能し、「キャンセル」および「閉じる」と同じ動作をします。
Props
ActionDialog props
| Name | Required | Type | Default Value | Description |
|---|---|---|---|---|
| children | true | string,
number,
false,
true,
{},
ReactElement<any, string | JSXElementConstructor<any>>,
ReactNodeArray,
ReactPortal | Body of the dialog. | |
| title | true | string | Title of the dialog. | |
| subtitle | - | string | ||
| closeText | true | string | Label of close button. | |
| actionText | true | string | Label of action button. | |
| actionTheme | true | "primary",
"secondary",
"danger" | Action button style theme. | |
| onClickAction | true | (closeDialog: () => void) => void | Handler function when clicking on action button.<br /> Accepts a function that closes dialog as an argument. | |
| actionDisabled | - | false,
true | Whether action button should be disabled. | |
| closeDisabled | - | false,
true | Whether close button should be disabled. | |
| className | - | string | `className` of the component. | |
| onClickClose | true | (() => void) & (() => void) | Handler function when clicking on close button. | |
| responseMessage | - | responseMessageType | ||
| portalParent | - | HTMLElement | ||
| isOpen | true | false,
true | Whether to display a Dialog. | |
| onClickOverlay | - | () => void | Handler function when clicking on onverlay. | |
| onPressEscape | - | () => void | Handler function when pressing escape key. | |
| top | - | number | Specifies the top position of the Dialog content. | |
| right | - | number | Specifies the right position of the Dialog content. | |
| bottom | - | number | Specifies the bottom position of the Dialog content. | |
| left | - | number | Specifies the left position of the Dialog content. |
MessageDialog props
| Name | Required | Type | Default Value | Description |
|---|---|---|---|---|
| title | true | string | Title of the dialog. | |
| subtitle | - | string | ||
| description | true | string,
number,
false,
true,
{},
ReactElement<any, string | JSXElementConstructor<any>>,
ReactNodeArray,
ReactPortal | Description of the dialog. | |
| closeText | true | string | Label of close button. | |
| onClickClose | true | () => void | Handler function when clicking on close button. | |
| isOpen | true | false,
true | Whether to display a Dialog. | |
| onClickOverlay | - | () => void | Handler function when clicking on onverlay. | |
| onPressEscape | - | () => void | Handler function when pressing escape key. | |
| top | - | number | Specifies the top position of the Dialog content. | |
| right | - | number | Specifies the right position of the Dialog content. | |
| bottom | - | number | Specifies the bottom position of the Dialog content. | |
| left | - | number | Specifies the left position of the Dialog content. | |
| portalParent | - | HTMLElement |
ModelessDialog props
| Name | Required | Type | Default Value | Description |
|---|---|---|---|---|
| header | true | string,
number,
false,
true,
{},
ReactElement<any, string | JSXElementConstructor<any>>,
ReactNodeArray,
ReactPortal | ダイアログのヘッダ部分の内容 | |
| children | true | string,
number,
false,
true,
{},
ReactElement<any, string | JSXElementConstructor<any>>,
ReactNodeArray,
ReactPortal | ダイアログのコンテンツ部分の内容 | |
| footer | - | string,
number,
false,
true,
{},
ReactElement<any, string | JSXElementConstructor<any>>,
ReactNodeArray,
ReactPortal | ダイアログのフッタ部分の内容 | |
| isOpen | true | false,
true | ダイアログが開かれているかどうかの真偽値 | |
| onClickClose | - | (e: MouseEvent<HTMLButtonElement, MouseEvent>) => void | 閉じるボタンを押下したときのハンドラ | |
| onPressEscape | - | () => void | ダイアログが開いている状態で Escape キーを押下したときのハンドラ | |
| width | - | string,
number | ダイアログの幅 | |
| height | - | string,
number | ダイアログの高さ | |
| top | - | string,
number | ダイアログを開いたときの初期 top 位置 | |
| left | - | string,
number | ダイアログを開いたときの初期 left 位置 | |
| right | - | string,
number | ダイアログを開いたときの初期 right 位置 | |
| bottom | - | string,
number | ダイアログを開いたときの初期 bottom 位置 | |
| portalParent | - | HTMLElement | ポータルの container となる DOM 要素を追加する親要素 |