mdui 中的導覽抽屜可以從頁面左側或右側滑出,一個頁面可以擁有多個導覽抽屜。
在手機和平板上,開啟導覽抽屜時,始終會顯示遮罩層。
在桌上型裝置上,開啟導覽抽屜時,預設不顯示遮罩層。設定 overlay 參數為 true,可以在開啟導覽抽屜時顯示遮罩層。如果設定為顯示遮罩層,那麼應該加入 .mdui-drawer-close 類別使導覽抽屜預設處於隱藏狀態。
(若元件是動態產生的,則需要呼叫 <a href="/zh-tw/docs/1/global#mutation"><code>mdui.mutation()</code></a> 進行初始化)
Material Design 設計規範:模式 - 導覽抽屜
mdui-drawer-body-left 類別為 body 加入 padding-left,只要左側有預設開啟的導覽抽屜,就要加入這個類別。
mdui-drawer-body-right 類別為 body 加入 padding-right,只要右側有預設開啟的導覽抽屜,就要加入這個類別。
預設導覽抽屜在左側
如果要使導覽抽屜在右側,需要加入類別 mdui-drawer-right
mdui-drawer="options" 屬性即可。透過自訂屬性呼叫時,需要額外加入一個 target 參數,用於指定被控制的導覽抽屜,它的值為被控制的導覽抽屜的 CSS 選取器。<div class="mdui-color-blue-200">mdui-color-blue-200</div>
<div class="mdui-color-blue">mdui-color-blue</div>
<div class="mdui-color-pink-accent">mdui-color-pink-accent</div>
<div class="mdui-color-pink-a200">mdui-color-pink-a200</div>點擊該元素會觸發 close.mdui.drawer 事件,並關閉導覽抽屜。
selector 為導覽抽屜的 CSS 選取器或 DOM 元素
options 為配置參數,見下面的參數清單
<div class="mdui-text-color-blue-900">mdui-text-color-blue-900</div>
<div class="mdui-text-color-blue">mdui-text-color-blue</div>
<div class="mdui-text-color-blue-a200">mdui-text-color-blue-a200</div>
<div class="mdui-text-color-blue-accent">mdui-text-color-blue-accent</div>顯示導覽抽屜。
傳回目前導覽抽屜的狀態。共包含四種狀態(<code>opening</code>、<code>opened</code>、<code>closing</code>、<code>closed</code>)。
導覽抽屜開始開啟動畫時,事件將被觸發。
event._detail.inst:實例
導覽抽屜完成開啟動畫時,事件將被觸發。
.mdui-color-theme.mdui-color-theme-[degree].mdui-text-color-theme.mdui-text-color-theme-[degree]導覽抽屜完成關閉動畫時,事件將被觸發。
定義一個導覽抽屜。
.mdui-color-theme-accent.mdui-color-theme-[degree].mdui-text-color-theme-accent.mdui-text-color-theme-[degree]使導覽抽屜佔據 100% 高度。
使導覽抽屜預設處於顯示狀態。
使導覽抽屜預設處於隱藏狀態。
.mdui-text-color-theme-text.mdui-text-color-theme-secondary.mdui-text-color-theme-disabled.mdui-text-color-theme-divider.mdui-text-color-theme-icon.mdui-text-color-theme-icon-disabled為 body 加入 padding-left。
| 類別名稱 | 說明 |
|---|---|
.mdui-theme-primary-[color] | 帶不透明度的 Display 1 樣式 |
.mdui-theme-accent-[color] | 帶不透明度的 Title 樣式 |
.mdui-theme-layout-dark | 帶不透明度的 Subheading 樣式 |
| 類別名稱 | 說明 |
|---|---|
.mdui-color-[color] | 帶不透明度的 Body 2 樣式 |
.mdui-color-[color]-accent | 帶不透明度的 Body 1 樣式 |
.mdui-color-[color]-[degree] | |
.mdui-color-theme | |
.mdui-color-theme-accent | |
.mdui-color-theme-[degree] | |
.mdui-color-black | |
.mdui-color-white | |
.mdui-color-transparent |
| 類別名稱 | 說明 |
|---|---|
.mdui-text-color-[color] | |
.mdui-text-color-[color]-accent | |
.mdui-text-color-[color]-[degree] | |
.mdui-text-color-theme | |
.mdui-text-color-theme-accent | |
.mdui-text-color-theme-[degree] |
| 類別名稱 | 說明 |
|---|---|
.mdui-text-color-black | |
.mdui-text-color-black-text | |
.mdui-text-color-black-secondary | |
.mdui-text-color-black-disabled | |
.mdui-text-color-black-divider | |
.mdui-text-color-black-icon | |
.mdui-text-color-black-icon-disabled |
| 類別名稱 | 說明 |
|---|---|
.mdui-text-color-white | |
.mdui-text-color-white-text | |
.mdui-text-color-white-secondary | |
.mdui-text-color-white-disabled | |
.mdui-text-color-white-divider | |
.mdui-text-color-white-icon | |
.mdui-text-color-white-icon-disabled |
| 類別名稱 | 說明 |
|---|---|
.mdui-text-color-theme-text | |
.mdui-text-color-theme-secondary | |
.mdui-text-color-theme-disabled | |
.mdui-text-color-theme-divider | |
.mdui-text-color-theme-icon | |
.mdui-text-color-theme-icon-disabled |