抽屉
WdDrawer
适用场景
用于实现侧边抽屉展示效果,常用于导航菜单、详情面板、筛选器等场景。支持从页面四个方向滑出。
基础功能
1. 打开/关闭抽屉
在抽屉的【默认打开抽屉】属性,控制首次抽屉的开关。
在【事件-组件方法】中调用抽屉的打开/关闭方法,可动态控制抽屉开关。
打开或关闭抽屉时,您可以配置 info 为传入的参数,传入后通过
$w.drawer1.openInfo
或$w.drawer1.closeInfo
获取参数。其中 drawer1 是抽屉组件 ID。
示例:按钮打开抽屉
- 加入按钮和抽屉组件

- 选中抽屉组件,设置抽屉为默认关闭,关闭抽屉属性【默认打开抽屉】

- 选中按钮组件,添加点击事件

- 选择要打开的抽屉,和执行方法。然后选中页面的组件,调用【打开抽屉 open】方法,即可实现点击按钮打开抽屉。

交互式预览
样式 API 自定义样式
属性说明
组件接收的外部传入的属性
属性名 | 属性标识 | 类型 | 说明 |
---|
抽屉默认打开状态 | visible | boolean | 示例:true |
抽屉方向 | placement | string | 抽屉方向。可选项:left/right/top/bottom 示例:"right" |
关闭方式 | closeType | array | 多选模式,outerClick-点击面板外收起面板,esc-点击键盘ESC关闭(仅在PC端生效) 示例:[ "outerClick" ] |
展示遮罩 | mask | boolean | 示例:true |
顶部插槽 | enableHeaderSlot | boolean | 默认值:true |
内容插槽 | enableContentSlot | boolean | 默认值:true |
底部插槽 | enableFooterSlot | boolean |
事件说明
组件暴露的事件,可以监听组件的事件来触发一些外部的动作
事件名 | 事件code | 事件出参 event.detail | 适用情况 | 说明 |
---|
抽屉打开时 | open | object
| 兼容三端 | - |
抽屉关闭时 | close | object
| 兼容三端 | - |
属性 API
通过属性 API,可以获取组件内部的状态和属性值,可以通过$w.componentId.propertyName
来访问组件内部的值,如 $w.input1.value
,详请请参考 属性 API
只读属性名 | 属性标识 | 类型 | 说明 |
---|
抽屉状态 | modalState | string | |
openInfo |
| 透传信息,在触发抽屉打开时接收的信息,信息来自于调用组件open方法的info | |
closeInfo |
| 透传信息,在触发抽屉关闭时接收的信息,信息来自于调用组件close方法的info |
方法 API
通过方法 API,可以通过程序触发组件内部的方法,比如提交表单,显示弹窗等, 可以通过$w.componentId.methodName
来调用组件方法,如 $w.form1.submit()
方法名 | 方法标识 | 参数 | 方法说明 |
---|
打开抽屉 | open | object
| - |
关闭抽屉 | close | object
| - |
样式 API
通过样式 API,可以覆盖组件中内部元素的样式来实现自定义,例如在低代码编辑器中中通过 #wd-page-root .wd-btn
即可为所有的按钮组件编写样式,通过 :scope
可以控制单个组件样式, 详细说明请参考样式 API
名称 | 类名 | 说明和示例 |
---|
根元素 | .wd-drawer | 组件根元素
|
PC 端根元素 | .wd-pc-drawer | 组件根元素
|
H5 端根元素 | .wd-h5-drawer | 可以为 H5 端的编写样式
|
小程序 端根元素 | .wd-mp-drawer | 可以为 小程序 端的编写样式
|
抽屉遮罩层样式 | .wd-drawer-mask | 可以为遮罩层编写样式
|
抽屉主体容器样式 | .wd-drawer-content-wrapper | 可以为主体容器编写样式
|
抽屉顶部容器样式 | .wd-drawer-header | 可以为顶部容器编写样式
|
抽屉内容容器样式 | .wd-drawer-body | 可以为内容容器编写样式
|
抽屉底部容器样式 | .wd-drawer-footer | 可以为底部容器编写样式
|