目录

drawer

概述

抽屉组件,抽屉默认隐藏。可通过侧边滑动或者api调用显示,支持 flex 布局。

使用限制

限制条件

说明

适用终端

手机、平板、车机

适用区域

全球

子组件

支持,包括 <drawer-navigation> 子组件。

属性

除了支持 通用属性 以外,还支持如下属性。

名称

类型

默认值

是否必填

描述

enableswipe

boolean

true

否

能否通过手势滑出或者滑入抽屉。默认可滑出和滑入。

样式

支持 通用样式 。

事件

除了支持 通用事件 以外,还支持如下事件。

名称

参数

描述

change

{direction:directionValue, state: stateValue}

抽屉打开关闭时回调。

  • direction:抽屉的位置
    • start:左边
    • end:右边
  • state:抽屉的状态
    • 0:关闭
    • 1:打开

scroll

{direction:directionValue, slideOffset:offsetValue, state:stateValue}

抽屉滑动过程的事件回调。

  • direction:抽屉的位置
  • slideOffset:抽屉滑动过程中的偏移,取值范围0.0 ~ 1.0
  • state:抽屉当前状态
    • 0:静止状态
    • 1:用户正在用手势滑动抽屉
    • 2:用户已松手,抽屉正在滑动到目标位置

方法

名称

参数

描述

openDrawer

object

打开指定方向的抽屉。

closeDrawer

object

关闭指定方向的抽屉。

openDrawer 的参数说明:

名称

类型

是否必填

默认值

备注

direction

string

否

-

可指定为 start 或者 end。

如果未设置 direction 的值,且只存在一个 drawer-navigation 时,默认打开这个 drawer-navigation;如果左右 drawer-navigation 都存在,则默认打开左边的 drawer-navigation。当指定的 direction 与实际的 drawer-navigation 的 direction 的值不匹配时不生效。

closeDrawer 的参数说明:

名称

类型

是否必填

默认值

备注

direction

string

否

-

可指定为 start 或者 end。

如果未设置 direction 的值,且只存在一个 drawer-navigation 时,默认关闭这个 drawer-navigation;如果左右 drawer-navigation 都存在,则必须指定 direction 的值。当指定的 direction 与实际的 drawer-navigation 的 direction 的值不匹配时不生效。

示例代码

<template>
  <drawer class="drawer" id="drawer" enableswipe="{{enableSwipe}}" onchange="onDrawerStateChanged" onscroll="onDrawerScroll">
    <div class="content">
      <input class="btn" type="button" value="Toggle enableswipe" onclick="toggleEnableSwipe" />
      <input class="btn" type="button" value="Open Left" onclick="openLeft" />
      <input class="btn" type="button" value="Open Right" onclick="openRight" />
      <input class="btn" type="button" value="Open Default" onclick="openDefault" />
    </div>
    <drawer-navigation class="navigation" direction="start">
      <input class="btn" type="button" value="Toggle enableswipe" onclick="toggleEnableSwipe" />
      <input class="btn" type="button" value="Close Left" onclick="closeLeft" />
      <input class="btn" type="button" value="Close Default" onclick="closeDefault" />
    </drawer-navigation>
    <drawer-navigation class="navigation" direction="end">
      <input class="btn" type="button" value="Toggle enableswipe" onclick="toggleEnableSwipe" />
      <input class="btn" type="button" value="Close Right" onclick="closeRight" />
    </drawer-navigation>
  </drawer>
</template>
<style>
  .drawer {
    width: 100%;
    height: 100%;
  }

  .content {
    background-color: #808080;
    flex-direction: column;
    align-items: center;
  }

  .btn {
    width: 400px;
    height: 100px;
    margin: 16px;
    background-color: #00bfff;
    color: #ffffff;
  }

  .navigation {
    width: 70%;
    height: 100%;
    background-color: #ffffff;
    flex-direction: column;
    align-items: center;
  }
</style>
<script>
  module.exports = {
    data: {
      enableSwipe: true
    },
    onDrawerStateChanged(params) {
      console.log("change - direction:" + params.direction + " state:" + params.state);
    },
    onDrawerScroll(params) {
      console.log("scroll - direction:" + params.direction + " slideOffset:" + params.slideOffset + " state:" + params.state);
    },
    toggleEnableSwipe() {
      this.enableSwipe = !this.enableSwipe
    },
    openLeft() {
      this.$element('drawer').openDrawer({ direction: 'start' })
    },
    openRight() {
      this.$element('drawer').openDrawer({ direction: 'end' })
    },
    openDefault() {
      this.$element('drawer').openDrawer()
    },
    closeLeft() {
      this.$element('drawer').closeDrawer({ direction: 'start' })
    },
    closeRight() {
      this.$element('drawer').closeDrawer({ direction: 'end' })
    },
    closeDefault() {
      this.$element('drawer').closeDrawer()
    },
  }
</script>

版本更新说明

版本

发布日期

描述

1080

2021-12-28

第一次正式发布。