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。