View

作为创建UI时最基础的组件,View是一个支持Flexbox布局、样式、一些触摸处理、和一些无障碍功能的容器,并且它可以放到其它的视图里,也可以有任意多个任意类型的子视图。不论在什么平台上,View都会直接对应一个平台的原生视图,无论它是UIView<div>还是android.view.View。下面的例子创建了一个View,包含了两个有颜色的方块和一个自定义的组件,并且设置了一个内边距:

<View style={{flexDirection: 'row', height: 100, padding: 20}}>
  <View style={{backgroundColor: 'blue', flex: 0.3}} />
  <View style={{backgroundColor: 'red', flex: 0.5}} />
  <MyCustomComponent {...customProps} />
</View>

View的设计初衷是和StyleSheet搭配使用,这样可以使代码更清晰并且获得更高的性能。尽管内联样式也同样可以使用。

截图#

属性#

accessibilityLabel string #

设置当用户与此元素交互时,“读屏器”(对视力障碍人士的辅助功能)阅读的文字。默认情况下,这个文字会通过遍历所有的子元素并累加所有的文本标签来构建。

accessible bool #

当此属性为true时,表示此视图时一个启用了无障碍功能的元素。默认情况下,所有可触摸操作的元素都是无障碍功能元素。

onAccessibilityTap function #

accessible为true时,如果用户做了一个轻触(tap)手势,系统会调用此函数。

onLayout function #

当组件挂载或者布局变化的时候调用,参数为:

{nativeEvent: { layout: {x, y, width, height}}}

这个事件会在布局计算完成后立即调用一次,不过收到此事件时新的布局可能还没有在屏幕上呈现,尤其是一个布局动画正在进行中的时候。

onMagicTap function #

accessible为true时,如果用户做了一个双指轻触(Magic tap)手势,系统会调用此函数。

onMoveShouldSetResponder function #

onMoveShouldSetResponderCapture function #

onResponderGrant function #

对于大部分的触摸处理,你只需要用TouchableHighlightTouchableOpacity包装你的组件。阅读Touchable.jsScrollResponder.jsResponderEventPlugin.js来了解更多信息。

onResponderMove function #

onResponderReject function #

onResponderRelease function #

onResponderTerminate function #

onResponderTerminationRequest function #

onStartShouldSetResponder function #

onStartShouldSetResponderCapture function #

pointerEvents enum('box-none', 'none', 'box-only', 'auto') #

用于控制当前视图是否可以作为触控事件的目标。

  • auto:视图可以作为触控事件的目标。
  • none:视图不能作为触控事件的目标。
  • box-none:视图自身不能作为触控事件的目标,但其子视图可以。类似于你在CSS 中这样设置:
  • .box-none {
      pointer-events: none; 
    } 
    .box-none  {
      pointer-events: all; 
    }
    
  • box-only:视图自身可以作为触控事件的目标,但其子视图不能。类似于你在CSS 中这样设置:

.box-none {
  pointer-events: all; 
} 
.box-none  {
  pointer-events: none; 
}

removeClippedSubviews bool #

这是一个特殊的性能相关的属性,由RCTView导出。在制作滑动控件时,如果控件有很多不在屏幕内的子视图,会非常有用。

要让此属性生效,首先要求视图有很多超出范围的子视图,并且子视图和容器视图(或它的某个祖先视图)都应该有样式overflow: hidden

style style #

backfaceVisibility enum('visible', 'hidden')
backgroundColor string
borderColor string
borderTopColor string
borderRightColor string
borderBottomColor string
borderLeftColor string
borderRadius number
borderTopLeftRadius number
borderTopRightRadius number
borderBottomLeftRadius number
borderBottomRightRadius number
borderStyle enum('solid', 'dotted', 'dashed')
borderWidth number
borderTopWidth number
borderRightWidth number
borderBottomWidth number
borderLeftWidth number
opacity number
overflow enum('visible', 'hidden')
android elevation number

(限Android)使用Android原生的 elevation API来设置视图的高度(elevation)。这样可以为视图添加一个投影,并且会影响视图层叠的顺序。此属性仅支持Android5.0及以上版本。

testID string #

用来在端到端测试中定位这个视图。

androidaccessibilityComponentType AccessibilityComponentType #

使无障碍服务对这个UI组件与原生组件一致处理。仅对Android平台有效。

androidaccessibilityLiveRegion enum('none', 'polite', 'assertive') #

告知无障碍服务当此视图更新时,是否要通知用户。只对Android API >= 19 的设备有效。可以阅读http://developer.android.com/reference/android/view/View.html#attr_android:accessibilityLiveRegion了解更多信息。

iosaccessibilityTraits AccessibilityTraits, [AccessibilityTraits] #

为读屏器提供更多属性。除非在元素里指定,默认情况下不提供任何属性。

androidcollapsable bool #

如果一个View只用于布局它的子组件,则它可能会为了优化而从原生布局树中移除。 把此属性设为false可以禁用这个优化,以确保对应视图在原生结构中存在。

androidimportantForAccessibility enum('auto', 'yes', 'no', 'no-hide-descendants') #

控制一个视图在无障碍功能中有多重要:它是否产生一个辅助功能事件,以及它是否能被请求屏幕内容的无障碍服务知晓。只对Android平台生效。了解更多信息,可以阅读http://developer.android.com/reference/android/R.attr.html#importantForAccessibility

可选的值:

  • auto - 系统来决定这个视图对于辅助功能是否重要 - 默认(推荐)。

  • yes - 这个视图对于辅助功能而言重要。

  • no - 这个视图对辅助功能不重要。

  • no-hide-descendants - 这个视图,以及所有的后代视图,都对于辅助功能不重要。

androidneedsOffscreenAlphaCompositing bool #

决定这个视图是否要先离屏渲染再进行半透明度处理,来确保颜色和混合效果正确。默认值(false)会在渲染组件和它的所有子节点的时候直接应用透明通道,而不会先离屏渲染整个组件再将它附加一个透明通道后渲染到屏幕上。有时候当你给视图设置了一个透明度,且其中有较多元素层叠在一起的时候,默认的设置就会导致看起来不太正常(会比正常显得更加不透明)。

为了正确的透明表现而进行离屏渲染会带来极大的开销,而且对于非原生开发者来说很难调试。这就是为啥它被默认关闭。如果你需要在一个动画中启用这个属性,考虑与renderToHardwareTextureAndroid组合使用,前提是视图的内容不会发生变化(即:它不需要每帧重绘一次)。如果开启了renderToHardwareTextureAndroid,则视图只会离屏渲染一次之后保存为一个硬件纹理,然后以正确的透明度绘制到屏幕上,这样就不会导致GPU频繁切换渲染目标(GPU切换渲染目标会带来极大的开销)。

androidrenderToHardwareTextureAndroid bool #

决定这个视图是否要把它自己(以及所有的子视图)渲染到一个GPU上的硬件纹理中。

在Android上,这对于只修改不透明度、旋转、位移、或缩放的动画和交互十分有用:在这些情况下,视图不必每次都重新绘制,显示列表也不需要重新执行。纹理可以被重用于不同的参数。负面作用是这会大量消耗显存,所以当交互/动画结束后应该把此属性设置回false。

iosshouldRasterizeIOS bool #

决定这个视图是否需要在被混合之前绘制到一个位图上。

在iOS上,这对于不会修改组件的尺寸和孩子的动画和交互十分有用。举例来说,当我们移动一个静态视图的位置的时候,预渲染允许渲染器重用一个缓存了静态视图的位图,并快速合成。

预渲染会产生一个离屏的渲染过程,并且位图会消耗内存。所以使用此属性需要进行充分的测试和评估。