spz-sidebar 抽屉

支持布局: nodisplay

何时使用

当需要一个附加的面板来做更进一步的操作,不离开当前页面,这个面板在需要的时候才会打开。例如:快速加购弹窗。

代码演示

基本用法

基础抽屉,点击触发按钮抽屉从左滑出,点击遮罩区关闭。

<button @tap="sidebar.open">Open</button>

<spz-sidebar layout="nodisplay" side="left" id="sidebar">
  <div class="sidebar-wrapper">
    <div class="sidebar-header">
      <h3>Basic Drawer</h3>
      <button @tap="sidebar.close">Close</button>
    </div>
    <div>Some contents...</div>
    <div>Some contents...</div>
    <div>Some contents...</div>
  </div>
</spz-sidebar>

属性

属性名说明类型默认值是否必需
side打开的方向:left, right, bottom, topstring-
disable-unmount如果该属性存在,关闭抽屉后不卸载里面的内容--
open当抽屉打开时自动加上, 关闭时移除--
i-spzhtml-sidebar-opened当抽屉打开动画结束时自动加上, 关闭时移除--

方法

open

打开抽屉,不需要参数。

close

关闭抽屉。

参数名说明类型默认值是否必需
immediate传递这个参数用来判断关闭抽屉时是否需要过渡动画,当值为true时无动画booleantrue

toggle

切换抽屉开关状态,不需要参数。

事件

open

抽屉完全打开时自动触发。

beforeClose

抽屉开始关闭的那一刻自动触发。

close

当抽屉完全关闭时自动触发,仅在immediate=false时有效。

sidebarClose

当抽屉完全关闭时自动触发,仅在immediate=false时有效,同close事件。

AI 摘要(LLM Ready)

  • 组件标识spz-sidebar
  • 用途一句话:屏幕边缘滑出的浮层面板。
  • 可识别属性条目:4
  • 可识别方法小节:3
  • 可识别事件小节:4
  • 关键属性名(Top)sidedisable-unmountopeni-spzhtml-sidebar-opened
  • 关键方法名(Top)openclosetoggle
  • 关键事件名(Top)openbeforeCloseclosesidebarClose
  • 阅读顺序建议:先看「何时使用」与「代码演示」,再核对属性/方法/事件。
  • 关联文档/guide/actions-and-events//guide/layouts/