SwAdLabel

廣告位四要素

  • 使用場景:合規標示(非廣告位)——各 SwAd* 按 showAdLabel 內部渲染;自建非標位需合規標示時直接用(overlay 形態容器需 position: relative)
  • 業界形態:Ad badge / label(合規要求,非投放形態)
  • 表現形態:角落「廣告」浮層小角標(overlay,圖類)/ 行內小標籤(inline,文字類)
  • 打點事件:無(純標示元件,不上報)

選錯場景 = 埋點 ad_type / 時機全錯。按場景選元件見 廣告元件選型。

SwAdLabel 是「廣告」合規角標元件,渲染一個標註廣告身分的小角標(廣告法合規要求)。各 SwAd* 元件預設渲染它(showAdLabel 不傳時跟隨全域 swiftConfig.ad.showLabel,預設 true;素材圖自帶標示的站點全域關閉);自訂廣告位時也可單獨使用。

overlay 浮層角標(圖類廣告位)

加载中...

inline 行內標籤(文字類廣告位)

加载中...

自訂文案(贊助 / AD / 推廣)

加载中...

Props

名稱類型必填預設值說明
textstring'广告'角標文案(如 '推廣' / '贊助')
variant'overlay' | 'inline''overlay'形態:overlay 深底白字浮層(圖類,容器需 position: relative)/ inline 行內小標籤(文字類,token 配色明暗自適應)

使用範例

<!-- 預設「廣告」(overlay 浮層,圖類廣告位) -->
<SwAdLabel />

<!-- 行內形態(文字類廣告位:跟隨文字流,不糊字) -->
<SwAdLabel variant="inline" />

<!-- 自訂文案 -->
<SwAdLabel text="推廣" />

CSS 變數

變數預設值說明
--sw-ad-label-z10overlay 形態角標層級(合規 chrome,預設壓在創意之上)

注意事項

  • 優先用 SwAd* 元件的 showAdLabel prop —— 各廣告元件內建該角標,無需手動疊加。僅自訂廣告位才單獨用 SwAdLabel。
  • 形態按廣告位類型選:圖片類(Banner / Mrec / Icon / Native / Popup…)用預設 overlay;文字類(自建文字鏈 / 滾動條)用 inline——overlay 浮層會糊住一行高的文字(SwAdText / SwAdMarquee 內部已自動用 inline)。
  • 這是廣告底座裡最簡單的展示型元件,無事件、無埋點。