跳到主要內容

View Style Props

範例

參考

Props

backfaceVisibility

類型
enum('visible', 'hidden')

backgroundColor

類型
color

borderBottomColor

類型
color

borderBottomEndRadius

類型
number

borderBottomLeftRadius

類型
number

borderBottomRightRadius

類型
number

borderBottomStartRadius

類型
number

borderStartEndRadius

類型
number

borderStartStartRadius

類型
number

borderEndEndRadius

類型
number

borderEndStartRadius

類型
number

borderBottomWidth

類型
number

borderColor

類型
color

borderCurve
iOS

在 iOS 13+ 上,可以更改邊框的轉角曲線。

類型
enum('circular', 'continuous')

borderEndColor

類型
color

borderLeftColor

類型
color

borderLeftWidth

類型
number

borderRadius

如果圓角邊框不可見,請嘗試同時應用 overflow: 'hidden'

類型
number

borderRightColor

類型
color

borderRightWidth

類型
number

borderStartColor

類型
color

borderStyle

類型
enum('solid', 'dotted', 'dashed')

borderTopColor

類型
color

borderTopEndRadius

類型
number

borderTopLeftRadius

類型
number

borderTopRightRadius

類型
number

borderTopStartRadius

類型
number

borderTopWidth

類型
number

borderWidth

類型
number

boxShadow

注意

boxShadow 僅在新架構上可用。外框陰影僅在 Android 9+ 上支援。內框陰影僅在 Android 10+ 上支援。

為元素添加陰影效果,可以控制陰影的位置、顏色、大小和模糊度。此陰影會出現在元素的邊框框外部或內部,具體取決於陰影是否為內嵌。這是符合規範的 同名網路樣式屬性 的實作。請參閱 BoxShadowValue 文件,以瞭解所有可用的引數。

這些陰影可以組合在一起,因此單個 boxShadow 可以由多個不同的陰影組成。

boxShadow 接受模仿 網路語法 的字串,或 BoxShadowValue 物件的陣列。

類型
BoxShadowValue 物件陣列 | 字串

cursor
iOS

在 iOS 17+ 上,設定為 pointer 允許當指標(例如 iOS 上的觸控板或觸控筆,或 visionOS 上的使用者視線)在視圖上方時產生懸停效果。

類型
enum('auto', 'pointer')

elevation
Android

使用 Android 的底層 elevation API 設定視圖的海拔高度。這會為項目添加陰影效果,並影響重疊視圖的 z 順序。僅在 Android 5.0+ 上支援,在較早版本上無效。

類型
number

filter

注意

filter 僅在新架構上可用

View 添加圖形濾鏡。此濾鏡由任意數量的濾鏡函數組成,每個函數都代表對 View 圖形組成的原子更改。有效濾鏡函數的完整列表定義如下。filter 也將應用於 View 的後代以及 View 本身。filter 意味著 overflow: hidden,因此後代將被裁剪以適合 View 的邊界。

以下濾鏡函數適用於所有平台

  • brightness:更改 View 的亮度。接受非負數或百分比。
  • opacity:更改 View 的不透明度或 alpha 值。接受非負數或百分比。
注意

由於效能和規範相容性問題,這些是在 iOS 上唯一可用的兩個濾鏡函數。目前有計畫探索使用 SwiftUI 而非 UIKit 來實現此功能的潛在解決方案。

Android

以下濾鏡函數僅適用於 Android

  • blur:使用 高斯模糊 模糊 View,其中指定的長度表示模糊演算法中使用的半徑。任何非負 DIP 值都有效(無百分比)。值越大,結果越模糊。
  • contrast:更改 View 的對比度。接受非負數或百分比。
  • dropShadow:在 View 的 alpha 遮罩周圍添加陰影(只有 View 中非零 alpha 像素才會投射陰影)。接受一個可選顏色,表示陰影顏色,以及 2 個或 3 個長度。如果指定了 2 個長度,它們將被解釋為 offsetXoffsetY,它們將分別在 X 和 Y 維度上平移陰影。如果給出了第三個長度,則它被解釋為用於陰影的高斯模糊的標準差 - 因此值越大,陰影越模糊。請參閱 DropShadowValue 以瞭解有關引數的更多資訊。
  • grayscale:按指定的量將 View 轉換為灰階。接受非負數或百分比,其中 1100% 表示完全灰階。
  • hueRotate:更改 View 的色相。此函數的引數定義了色輪的角度,色相將圍繞該角度旋轉,因此,例如,360deg 將不起作用。此角度可以具有 degrad 單位。
  • invert:反轉 View 中的顏色。接受非負數或百分比,其中 1100% 表示完全反轉。
  • sepia:將 View 轉換為棕褐色。接受非負數或百分比,其中 1100% 表示完全棕褐色。
  • saturate:更改 View飽和度。接受非負數或百分比。
注意

blurdropShadow 僅在 Android 12+ 上支援

filter 接受物件陣列(包含上述濾鏡函數)或模仿 網路語法 的字串。

類型
物件陣列:{brightness: number|string}{opacity: number|string}{blur: number|string}{contrast: number|string}{dropShadow: DropShadowValue|string}{grayscale: number|string}{hueRotate: number|string}{invert: number|string}{sepia: number|string}{saturate: number|string} 或字串

opacity

類型
number

outlineColor

注意

outlineColor 僅在新架構上可用

設定元素外框的顏色。請參閱 網路文件 以瞭解更多詳細資訊。

類型
color

outlineOffset

注意

outlineOffset 僅在新架構上可用

設定外框與元素邊界之間的空間量。不影響佈局。請參閱 網路文件 以瞭解更多詳細資訊。

類型
number

outlineStyle

注意

outlineStyle 僅在新架構上可用

設定元素外框的樣式。請參閱 網路文件 以瞭解更多詳細資訊。

類型
enum('solid', 'dotted', 'dashed')

outlineWidth

注意

outlineWidth 僅在新架構上可用

繪製在元素周圍邊框外部的外框寬度。不影響佈局。請參閱 網路文件 以瞭解更多詳細資訊。

類型
number

pointerEvents

控制 View 是否可以成為觸控事件的目標。

  • 'auto':View 可以成為觸控事件的目標。
  • 'none':View 永遠不會成為觸控事件的目標。
  • 'box-none':View 永遠不會成為觸控事件的目標,但其子視圖可以。
  • 'box-only':View 可以成為觸控事件的目標,但其子視圖不能。
類型
enum('auto', 'box-none', 'box-only', 'none' )