SwAdFloating

广告位四要素
使用场景：页面左 / 右侧固定悬浮位，窄屏自动隐藏（slotKey 例 floating_right）
业界形态：Floating / Anchor ads（framework 自有扩展，AdSDK 无对应格式，ad_type 用扩展值 floating）
表现形态：竖排多图（items 有几个显示几个，业务一般最多配 ~6 个、每个约 60×60），窗口宽 ≤ hiddenWidth 时隐藏
打点事件：adImpression（可见即报、整组一次）/ adClick（按条）；gate 关闭静默 no-op
选错场景 = 埋点 ad_type / 时机全错。按场景选组件见广告组件选型。

SwAdFloating 是侧边悬浮广告位组件，属广告底座「弹窗 / 悬浮类」自渲染组件。固定吸附在视口左 / 右侧，items 竖排全量渲染（有几个显示几个），仅当窗口宽度 ≥ hiddenWidth 时显示（窄屏自动隐藏，不挤占内容）。内置曝光 / 点击埋点。

加载中...

Props

名称	类型	必填	默认值	说明
`items`	`SwAdItem[]`	✓	—	广告创意数组
`slotKey`	`string`	✓	—	广告位键 → `ad_slot_key`
`slotName`	`string`		`undefined`	广告位名 → `ad_slot_name`
`pageKey`	`string`		`undefined`	页面键 → `page_key`
`pageName`	`string`		`undefined`	页面名 → `page_name`
`position`	`'left' \| 'right'`		`'right'`	吸附侧边
`hiddenWidth`	`number`		`1500`	窗口宽度小于此值（px）时隐藏
`ratio`	`string`		`'1/1'`	创意宽高比
`radius`	`number \| string`		`8`	圆角（number=px，string 原样透传 SwImage，如 `'1.125rem'`）
`showAdLabel`	`boolean`		`undefined`	「广告」合规角标（inline 形态，整组底部居中一枚）；不传时跟随全局 `swiftConfig.ad.showLabel`（默认 `true`），显式传值始终优先

CSS 变量

变量	默认值	说明
`--sw-ad-floating-width`	`3.75rem`（60px）	单图宽度（高度由 `ratio` 决定）
`--sw-ad-floating-gap`	`0.5rem`	图与图竖向间距

Events

名称	携带	说明
`load`	—	渲染完成
`empty`	—	`items` 为空
`impression`	`items: SwAdItem[]`	曝光（自动埋点）
`click`	`item: SwAdItem`	点击（自动埋点）
`error`	—	渲染 / 加载错误

<!-- items 数组竖排显示（最多由数据侧控制，一般 ≤6 个），每个默认 60×60 -->
<SwAdFloating :items="sideAds" slot-key="global_side" position="right" :hidden-width="1280" show-ad-label />

<!-- 调大单图尺寸 -->
<SwAdFloating :items="sideAds" slot-key="global_side" style="--sw-ad-floating-width: 5rem" />

注意事项

窄屏自动隐藏 —— 窗口 < hiddenWidth 时不渲染，避免遮挡移动端 / 窄视口内容。
通常在全局 layout 挂载一次，固定吸附；埋点内置，受 tracker 双重 gate。