组件总览

SwButton

语义化按钮，支持 loading、disabled 及图标

SwLink

智能链接，自动识别外链并加 rel 属性

SwBreadcrumb

面包屑导航，items 驱动 + 可选自带 BreadcrumbList JSON-LD

SwBackTop

长页回到顶部，滚超阈值淡入 + reduced-motion 降级瞬跳

SwIcon

业务 SVG 图标，通过 name 直接引用

SwImage

图片懒加载、优化 srcset 与占位图

SwThemeSwitch

主题切换器，随 theme.mode 自 gate（仅 toggle 渲染）

SwLangSwitch

语言切换器，读 i18n.locales 自动联动，i18n 关/单语言不渲染

SwFormField

带 label、校验提示的表单字段包装器

SwInput

文本输入框，表单控件族统一基线盒子（等高等字号）+ 原生属性全透传

SwSegmented

平铺单选选项组（segmented / pill），方向键 a11y 自带

SwSelect

下拉选择，单 / 多选、可清空、分组、可搜索、输入即建

SwUploadFile

普通文件上传（PDF / 文档 / zip），分片无转码

SwUploadImage

图片上传，含裁剪与预览

SwUploadVideo

视频上传，支持进度条与封面截图

SwModal

无样式弹窗，支持声明式（v-model）和命令式（useModal）两种用法

SwPagination

页码翻页器（替换式，与 SwGallery 组合）

SwToast

轻提示，支持 success / error / info 类型

SwAddToHomescreenGuide

H5 PWA 添加到主屏幕引导（底部 sheet，非阻断式）

SwVideoPlayer

视频播放器，支持 HLS 与自定义控件

SwAudioPlayer

音频播放器，带进度条与音量控制

SwVideoBackground

无声 MP4 背景与封面降级

SwVideoPreview

视频悬停预览，鼠标移入自动静音播放

SwQrcodeGenerator

根据文本生成二维码图片，支持自定义样式与下载

SwQrcodeScanner

上传图片识别其中的二维码并返回内容

SwAsyncText

异步加载远程文本（含 .bnc 加密自动分流 + IndexedDB 缓存）

SwTable

管理台数据表格：columns + 单元格插槽，内置排序 / 行选 / loading / 粘性表头

SwEditor

基于 Tiptap 的富文本编辑器：@提及 / #话题 / 内置 emoji / 图视频上传

SwRail

横向自由滚动横排，原生 scroll-snap + 桌面默认箭头

SwCarousel

整屏轮播 banner，无缝 loop + autoplay + dots / 缩略图

SwVideoFeed

抖音式竖划短视频流，裸 hls 视频池 + 虚拟化

SwGallery

响应式封面卡网格 + 加载更多（与 SwRail 横滚互补）

SwAdBanner

横幅广告位，单图直出或多图轮播，内置曝光/点击埋点

SwAdMrec

中矩形广告位（MREC，默认 300×250）

SwAdIcon

图标广告位，grid 宫格 / image 单图标

SwAdText

文字广告位，cell 文字链 / grid 宫格

SwAdMarquee

跑马灯文字广告，横向无缝滚动

SwAdNative

原生信息流广告卡（图+标题+描述+CTA）

SwAdSplash

进站开屏广告，进站自动弹 + 频控（ad_type=splash）

SwAdPopup

业务触发的全屏弹窗广告，ref.open() 触发 + 可选频控

SwAdPreroll

视频前贴片广告（#preroll-ad 插槽官配，挂载即曝光）

SwAdPause

视频暂停广告（#pause-ad 插槽官配，暂停 gating 通过即弹，可关闭）

SwAdFloating

侧边悬浮广告，窗口够宽才显示

SwAdLabel

「广告」合规角标