v-banner
コンポーネントは、1-2個のアクションを持つ、ユーザーへの中間割り込みメッセージとして使用されます。 single-lineとmulti-line(暗黙)の2つのバリエーションがあります。これらには、メッセージやアクションで使用できるアイコンを含めることができます。
確認したいコンポーネントを下から選び、利用できる props、slots、events、functions を確認してください。
v-main
の中で使用すると、アプリケーションの v-toolbar
と v-system-bar
に基づいてトップを計算します。
指定された色をコントロールに適用します。利用できるのは色の名前 (たとえば、success
または purple
) または css 表記の色 (#033
またはrgba(255, 0, 0, 0.5)
) です。colors のページ で、組み込みクラスのリストが確認できます。
コンポーネントにダークテーマを適応します。詳しく知りたい場合は、Material Design documentationのdark themesを参照してください。
コンポーネントに適用される高さを0〜24の範囲で指定します。詳細は、elevation のページで確認できます。
コンポーネントに高さを設定します。
アイコンを指定します。
アイコンの色を指定します。
コンポーネントにlightテーマを適用します。
コンテンツの高さの最大値を設定します。
コンテンツの横幅の最大値を設定します。
コンテンツの高さの最小値を設定します。
コンテンツの横幅の最小値を設定します。
Removes elevation (box-shadow) and adds a thin border.
Designates the border-radius applied to the component. You can find more information on the Border Radius page.
Applies a large border radius on the top left and bottom right of the card.
Forces the banner onto a single line.
position: sticky をコンポーネントに適用します(Evergreenブラウザのみ)。 スティッキーポジションのMDNドキュメント で詳細を確認できます。
コンポーネント内で使用するカスタムタグを指定します。
Removes the component's border-radius.
コンポーネントを表示するか非表示にするかを制御します。
コンポーネントに横幅を設定します。
The slot used for the action's content such as a v-btn. The dismiss function in this slots scope, when invoked, will close the banner.
{
dismiss: (): void
}
デフォルトの Vue slot
アイコンのコンテンツに使用されるスロット。
コンポーネントを表示するか非表示にするかを制御します。
(): void
8px !default;
90px !default;
0 !default;
8px !default;
0 !default;
8px !default;
16px !default;
20px !default;
12px !default;
24px !default;
10px !default;
36px !default;
16px !default;
16px !default;
map-get($rounded, 'xl') $banner-border-radius !default;
24px !default;
16px !default;
以下に、簡単な例から複雑な例まで示します。
Single-line VBannerは少量の情報に使用され、デスクトップのみの実装に推奨されます。必要に応じてsticky propを有効にして、コンテンツが画面に固定されていることを確認できます(注:IE11では動作しません)。スティッキーポジショニングの詳細については、 sticky positioning here をご覧ください。
Two-line VBannerはより長いメッセージに使用できます。
アイコンスロットでは、その中のコンテンツや機能を明示的にコントロールすることができます。
VBannerは、カスタムアイコンスロットがある場合でも、アイコンのクリック時に click:icon
イベントを発生させます。
actions
slotのスコープにはdismiss
関数があり、これを使用してバナーを簡単に閉じることができます。