On this page
d-sidebar
レイアウトスラッシングを完全に排除したオフキャンバス開閉、アイコン縮小モード、モバイルドロワー対応のアプリケーションサイドバーです。
1<d-sidebar id="app-sidebar" collapsible="icon" variant="sidebar" persist="app_sidebar">2 <div slot="header">3 <span class="d-sidebar-label">ワークスペース</span>4 </div>5 6 <div d-sidebar-group>7 <div d-sidebar-group-label>ナビゲーション</div>8 <div d-sidebar-menu>9 <a d-sidebar-item href="/dashboard" active>10 <i class="dstrn-dashboard-line"></i>11 <span class="d-sidebar-label">ダッシュボード</span>12 </a>13 <div d-sidebar-item d-collapsible>14 <div d-sidebar-item-trigger>15 <i class="dstrn-folder-line"></i>16 <span class="d-sidebar-label">プロジェクト</span>17 <i class="dstrn-down-small-line d-sidebar-chevron"></i>18 </div>19 <div d-sidebar-sub>20 <a d-sidebar-sub-item href="/projects/active">アクティブ</a>21 <a d-sidebar-sub-item href="/projects/archive">アーカイブ</a>22 </div>23 </div>24 </div>25 </div>26 27 <div slot="footer">28 <span class="d-sidebar-label">ユーザー設定</span>29 </div>30 <div d-sidebar-rail></div>31</d-sidebar>
属性とプロパティ(d-sidebar)
| 属性 | プロパティ | 型 | デフォルト | フォーム | 説明 |
|---|---|---|---|---|---|
side |
side |
string | "left" |
いいえ | サイドバーの配置位置("left"または"right") |
collapsible |
collapsible |
string | "offcanvas" |
いいえ | 折りたたみ方式("offcanvas"、"icon"、"none") |
variant |
variant |
string | "sidebar" |
いいえ | 表示スタイル("sidebar"、"floating"、"inset") |
opened |
opened |
boolean | true |
いいえ | 開閉状態 |
breakpoint |
breakpoint |
string | "md" |
いいえ | モバイルドロワーに切り替えるブレークポイント("sm"、"md"、"lg"、"xl"、メディアクエリ文字列、または"none") |
shortcut |
shortcut |
string | "cmd+b" |
いいえ | 開閉をトグルするキーボードショートカット |
persist |
persist |
string | "" |
いいえ | 開閉状態を保存するlocalstorageのキー |
contained |
contained |
boolean | false |
いいえ | ビューポートではなく親要素内にサイドバーを収める |
プログラム用api(d-sidebar)
1const sidebar = select('d-sidebar');2 3sidebar.open(); // 開く(展開)4sidebar.close(); // 閉じる(折りたたみ)5sidebar.toggle(); // 開閉を切り替え6 7console.log(sidebar.isOpen); // 展開中またはモバイル表示中の場合true8console.log(sidebar.isMobile); // ブレークポイント以下のモバイル幅の場合true
イベント(d-sidebar)
| イベント | 詳細 | バブリング | 説明 |
|---|---|---|---|
open |
オブジェクト({ mobile }) |
はい | サイドバーが開いたときに送出 |
close |
オブジェクト({ mobile }) |
はい | サイドバーが閉じたときに送出 |
動作仕様(d-sidebar)
- 静的スペーサーとcss変数による固定幅、gpu変形アニメーションによりレイアウト再計算スラッシングを防止。
- アイコンモード(
collapsible="icon")時はラベルを隠して幅を縮小し、各アイコンに自動的にツールチップを表示。 - 折りたたみ可能サブメニューはcssの
grid-template-rows: 0fr to 1frを活用して滑らかに開閉。 [d-sidebar-rail]のクリックや外部の[d-sidebar-trigger]要素(id指定は[d-sidebar-trigger="#id"])から簡単にトグル可能。- 設定されたブレークポイント以下では自動的にバックドロップ付きモバイルドロワーへ移行。

