用途:<sgds-drawer> 是一个从屏幕边缘滑入并覆盖页面内容的面板,适合放置次级导航、筛选器或不应打断主布局的上下文内容。使用前需参考 sgds-components-setup 完成安装与框架集成(React 19+ 与 React ≤18、Vue、Angular)。该组件不暴露自定义属性与 CSS part,因此不支持修改 CSS 样式。
主要能力:placement 决定滑入边缘,end(默认,右)、start(左)、top(上)、bottom(下);size 取 sm(默认)、md、lg;contained 让抽屉限定在定位父容器内而非整个视口;open 属性控制可见性。插槽包括 title、description、默认内容与 footer(通常放操作按钮)。事件有 sgds-show、sgds-after-show、sgds-hide、sgds-after-hide,以及可取消的 sgds-initial-focus 和 sgds-request-close(detail.source 为 close-button、keyboard 或 overlay)。公开方法为 show() 与 hide()。
使用方式:用按钮点击调用 show()/hide() 打开关闭;也可用 open 属性初始展开。要阻止点击遮罩或按 Escape 关闭,可监听 sgds-request-close 并在 source 非 close-button 时调用 event.preventDefault()。contained 需父元素设置 position: relative 和明确高度。
限制:不支持 CSS 样式定制;其余安装细节与框架差异见 setup 技能。