跳到主要内容

View

View 是构建 UI 最基本的组件,它是一个容器,支持使用 flexbox 进行布局、样式一些触摸处理无障碍 控制。无论 React Native 运行在什么平台上,View 都直接映射到对应的原生视图,例如 UIView<div>android.view 等。

View 设计用于嵌套在其他视图中,并且可以包含 0 到多个任何类型的子组件。

这个例子创建了一个 View,它包含两个带颜色的盒子和一个文本组件,并以行布局和内边距显示。

View 组件通常与 StyleSheet 配合使用以提高清晰度和性能,但也支持内联样式。

合成触摸事件

对于 View 的响应者属性(例如 onResponderMove),传递给它们的合成触摸事件是 PressEvent 的形式。


参考

属性


accessibilityActions

辅助功能操作允许辅助技术以编程方式调用组件的操作。accessibilityActions 属性应包含操作对象的列表。每个操作对象应包含字段名和标签。

有关更多信息,请参阅辅助功能指南

类型
数组

accessibilityElementsHidden
iOS

一个值,指示此无障碍元素内包含的无障碍元素是否隐藏。默认为 false

有关更多信息,请参阅无障碍指南

类型
布尔值

accessibilityHint

无障碍提示可帮助用户了解当他们在无障碍元素上执行操作时会发生什么,如果该结果无法从无障碍标签中清楚得知。

类型
字符串

无障碍语言
iOS

指示屏幕阅读器在用户与元素交互时应使用的语言值。它应遵循 BCP 47 规范

有关更多信息,请参阅 iOS accessibilityLanguage 文档

类型
字符串

accessibilityIgnoresInvertColors
iOS

一个值,指示当颜色反转开启时,此视图是否应该反转。值为 true 将告诉视图即使颜色反转开启也不要反转。

有关更多信息,请参阅无障碍指南

类型
布尔值

accessibilityLabel

当用户与元素交互时,覆盖屏幕阅读器读取的文本。默认情况下,标签是通过遍历所有子元素并累积所有由空格分隔的 Text 节点来构建的。

类型
字符串

accessibilityLiveRegion
Android

指示无障碍服务是否应该在此视图更改时通知用户。仅适用于 Android API >= 19。可能的值:

  • 'none' - 无障碍服务不应宣布此视图的更改。
  • 'polite' - 无障碍服务应宣布此视图的更改。
  • 'assertive' - 无障碍服务应中断正在进行的语音以立即宣布此视图的更改。

请参阅 Android View 文档了解更多信息。

类型
enum('none', 'polite', 'assertive')

accessibilityRole

accessibilityRole 向辅助技术用户传达组件的用途。

accessibilityRole 可以是以下之一

  • 'none' - 当元素没有角色时使用。
  • 'button' - 当元素应被视为按钮时使用。
  • 'link' - 当元素应被视为链接时使用。
  • 'search' - 当文本字段元素也应被视为搜索字段时使用。
  • 'image' - 当元素应被视为图像时使用。例如,可以与按钮或链接结合使用。
  • 'keyboardkey' - 当元素充当键盘键时使用。
  • 'text' - 当元素应被视为不能更改的静态文本时使用。
  • 'adjustable' - 当元素可以“调整”(例如滑块)时使用。
  • 'imagebutton' - 当元素应被视为按钮且同时是图像时使用。
  • 'header' - 当元素充当内容部分的标题时使用(例如导航栏的标题)。
  • 'summary' - 当应用程序首次启动时,元素可用于提供应用程序当前状态的快速摘要。
  • 'alert' - 当元素包含要呈现给用户的重要文本时使用。
  • 'checkbox' - 当元素表示一个复选框时使用,该复选框可以是选中、未选中或混合选中状态。
  • 'combobox' - 当元素表示一个组合框时使用,该组合框允许用户在多个选项中进行选择。
  • 'menu' - 当组件是选项菜单时使用。
  • 'menubar' - 当组件是多个菜单的容器时使用。
  • 'menuitem' - 用于表示菜单中的一个项目。
  • 'progressbar' - 用于表示指示任务进度的组件。
  • 'radio' - 用于表示一个单选按钮。
  • 'radiogroup' - 用于表示一组单选按钮。
  • 'scrollbar' - 用于表示一个滚动条。
  • 'spinbutton' - 用于表示一个按钮,该按钮打开一个选项列表。
  • 'switch' - 用于表示一个可以打开和关闭的开关。
  • 'tab' - 用于表示一个标签页。
  • 'tablist' - 用于表示标签页列表。
  • 'timer' - 用于表示一个计时器。
  • 'toolbar' - 用于表示一个工具栏(动作按钮或组件的容器)。
  • 'grid' - 与 ScrollView、VirtualizedList、FlatList 或 SectionList 结合使用,表示一个网格。为 Android GridView 添加进入/退出网格的通知。
类型
字符串

accessibilityState

描述组件当前状态,供辅助技术用户使用。

有关更多信息,请参阅无障碍指南

类型
对象:{disabled: bool, selected: bool, checked: bool or 'mixed', busy: bool, expanded: bool}

accessibilityValue

表示组件的当前值。它可以是组件值的文本描述,或者对于基于范围的组件(如滑块和进度条),它包含范围信息(最小值、当前值和最大值)。

有关更多信息,请参阅无障碍指南

类型
对象:{min: number, max: number, now: number, text: string}

accessibilityViewIsModal
iOS

一个值,指示 VoiceOver 是否应忽略接收器同级视图中的元素。默认为 false

有关更多信息,请参阅无障碍指南

类型
布尔值

accessible

true 时,表示该视图是一个无障碍元素,可被屏幕阅读器和硬件键盘等辅助技术发现。默认情况下,所有可触摸元素都是可访问的。

有关更多信息,请参阅无障碍指南


aria-busy

表示元素正在被修改,辅助技术可能需要等待更改完成才能将更新通知用户。

类型默认
布尔值false

aria-checked

指示可检查元素的状态。此字段可以接受布尔值或“mixed”字符串来表示混合复选框。

类型默认
布尔值,'mixed'false

aria-disabled

表示元素可感知但已禁用,因此不可编辑或以其他方式操作。

类型默认
布尔值false

aria-expanded

指示可展开元素当前是展开还是折叠。

类型默认
布尔值false

aria-hidden

指示此无障碍元素中包含的无障碍元素是否隐藏。

例如,在一个包含同级视图 AB 的窗口中,将视图 Baria-hidden 设置为 true 会导致 VoiceOver 忽略视图 B 中的元素。

类型默认
布尔值false

aria-label

定义一个标记交互元素的字符串值。

类型
字符串

aria-labelledby
Android

标识标记它所应用的元素的元素。aria-labelledby 的值应与相关元素的 nativeID 匹配。

tsx
<View>
<Text nativeID="formLabel">Label for Input Field</Text>
<TextInput aria-label="input" aria-labelledby="formLabel" />
</View>
类型
字符串

aria-live
Android

指示元素将被更新,并描述用户代理、辅助技术和用户可以从实时区域获得的更新类型。

  • off 辅助服务不应宣布此视图的更改。
  • polite 辅助服务应宣布此视图的更改。
  • assertive 辅助服务应中断正在进行的语音,立即宣布此视图的更改。
类型默认
enum('assertive', 'off', 'polite')'off'

aria-modal
iOS

布尔值,指示 VoiceOver 是否应忽略接收器同级视图中的元素。优先于 accessibilityViewIsModal 属性。

类型默认
布尔值false

aria-selected

指示可选元素当前是否已选中。

类型
布尔值

aria-valuemax

表示基于范围的组件(如滑块和进度条)的最大值。优先于 accessibilityValue 属性中的 max 值。

类型
数字

aria-valuemin

表示基于范围的组件(如滑块和进度条)的最小值。优先于 accessibilityValue 属性中的 min 值。

类型
数字

aria-valuenow

表示基于范围的组件(如滑块和进度条)的当前值。优先于 accessibilityValue 属性中的 now 值。

类型
数字

aria-valuetext

表示组件的文本描述。优先于 accessibilityValue 属性中的 text 值。

类型
字符串

collapsable

仅用于布局子元素或不绘制任何内容的视图可能会作为优化自动从原生层级结构中移除。将此属性设置为 false 可禁用此优化,并确保此 View 存在于原生视图层级结构中。

类型默认
布尔值true

collapsableChildren

设置为 false 可防止视图的直接子视图从原生视图层级结构中移除,其效果类似于对每个子视图设置 collapsable={false}

类型默认
布尔值true

focusable
Android

View 是否应该可以通过非触摸输入设备(例如硬件键盘)获取焦点。

类型
布尔值

hitSlop

这定义了触摸事件可以从视图开始的距离。典型的界面指南建议触摸目标至少为 30 - 40 点/密度无关像素。

例如,如果一个可触摸视图的高度为 20,则可以通过 hitSlop={{top: 10, bottom: 10, left: 0, right: 0}} 将可触摸高度扩展到 40。

触摸区域永远不会超出父视图边界,并且如果触摸到两个重叠视图,兄弟视图的 Z 轴顺序始终优先。

类型
对象:{top: number, left: number, bottom: number, right: number}

id

用于从原生类定位此视图。优先于 nativeID 属性。

这会禁用此视图的“仅布局视图移除”优化!

类型
字符串

importantForAccessibility
Android

控制视图对于可访问性的重要性,即它是否触发可访问性事件以及是否向查询屏幕的可访问性服务报告。仅适用于 Android。

可能的值

  • 'auto' - 系统确定视图对于可访问性是否重要 - 默认(推荐)。
  • 'yes' - 视图对于可访问性很重要。
  • 'no' - 视图对于可访问性不重要。
  • 'no-hide-descendants' - 视图及其任何后代视图对于可访问性都不重要。

请参阅 Android importantForAccessibility 文档了解更多信息。

类型
枚举('auto', 'yes', 'no', 'no-hide-descendants')

nativeID

用于从原生类定位此视图。

这会禁用此视图的“仅布局视图移除”优化!

类型
字符串

needsOffscreenAlphaCompositing

View 是否需要在屏幕外渲染并与 alpha 合成,以保持 100% 正确的颜色和混合行为。默认值 (false) 是将组件及其子组件绘制时,将 alpha 应用于用于绘制每个元素的画笔,而不是在屏幕外渲染整个组件并以 alpha 值合成。当您设置透明度的 View 具有多个重叠元素(例如,多个重叠的 View 或文本和背景)时,此默认值可能会很明显且不理想。

为了保持正确的 alpha 行为而在屏幕外渲染非常昂贵,而且对于非原生开发人员来说很难调试,这就是为什么默认不开启它的原因。如果您确实需要为动画启用此属性,如果视图内容是静态的(即,不需要每帧重新绘制),请考虑将其与 renderToHardwareTextureAndroid 结合使用。如果启用该属性,此 View 将在屏幕外渲染一次,保存到硬件纹理中,然后每帧使用 alpha 值合成到屏幕上,而无需在 GPU 上切换渲染目标。

类型
布尔值

nextFocusDown
Android

指定当用户向下导航时,下一个接收焦点的视图。请参阅 Android 文档

类型
数字

nextFocusForward
Android

指定当用户向前导航时,下一个接收焦点的视图。请参阅 Android 文档

类型
数字

nextFocusLeft
Android

指定当用户向左导航时,下一个接收焦点的视图。请参阅 Android 文档

类型
数字

nextFocusRight
Android

指定当用户向右导航时,下一个接收焦点的视图。请参阅 Android 文档

类型
数字

nextFocusUp
Android

指定当用户向上导航时,下一个接收焦点的视图。请参阅 Android 文档

类型
数字

onAccessibilityAction

当用户执行辅助功能操作时调用。此函数唯一的参数是一个事件,其中包含要执行的操作的名称。

有关更多信息,请参阅辅助功能指南

类型
函数

onAccessibilityEscape
iOS

accessibletrue 时,当用户执行退出手势时,系统将调用此函数。

类型
函数

onAccessibilityTap
iOS

accessible 为 true 时,系统会尝试在用户执行无障碍点击手势时调用此函数。

类型
函数

onLayout

在挂载和布局更改时调用。

此事件在布局计算完成后立即触发,但在接收到事件时,新的布局可能尚未在屏幕上反映出来,特别是在进行布局动画时。

类型
({nativeEvent: LayoutEvent}) => void

onMagicTap
iOS

accessibletrue 时,当用户执行魔术点击手势时,系统将调用此函数。

类型
函数

onMoveShouldSetResponder

此视图是否希望“声明”触摸响应?当 View 不是响应者时,对 View 的每次触摸移动都会调用此函数。

类型
({nativeEvent: PressEvent}) => boolean

onMoveShouldSetResponderCapture

如果父 View 希望阻止子 View 在移动时成为响应者,它应该有一个返回 true 的处理程序。

类型
({nativeEvent: PressEvent}) => boolean

onResponderGrant

View 现在正在响应触摸事件。这是突出显示并向用户展示正在发生什么的时候。

在 Android 上,从此回调返回 true 可防止任何其他原生组件成为响应者,直到此响应者终止。

类型
({nativeEvent: PressEvent}) => void | boolean

onResponderMove

用户正在移动他们的手指。

类型
({nativeEvent: PressEvent}) => void

onResponderReject

另一个响应者已处于活动状态,并且不会将其释放给要求成为响应者的 View

类型
({nativeEvent: PressEvent}) => void

onResponderRelease

在触摸结束时触发。

类型
({nativeEvent: PressEvent}) => void

onResponderTerminate

响应者已从 View 中移除。可能在调用 onResponderTerminationRequest 后被其他视图占用,或者可能在未经请求的情况下被操作系统占用(例如,在 iOS 上发生控制中心/通知中心时)。

类型
({nativeEvent: PressEvent}) => void

onResponderTerminationRequest

另一个 View 想要成为响应者,并要求此 View 释放其响应者。返回 true 允许其释放。

类型
({nativeEvent: PressEvent}) => void

onStartShouldSetResponder

此视图是否希望在触摸开始时成为响应者?

类型
({nativeEvent: PressEvent}) => boolean

onStartShouldSetResponderCapture

如果父 View 希望阻止子 View 在触摸开始时成为响应者,它应该有一个返回 true 的处理程序。

类型
({nativeEvent: PressEvent}) => boolean

pointerEvents

控制 View 是否可以是触摸事件的目标。

  • 'auto': View 可以是触摸事件的目标。
  • 'none': View 永远不是触摸事件的目标。
  • 'box-none': View 永远不是触摸事件的目标,但其子视图可以是。它的行为就像视图在 CSS 中具有以下类一样
css
.box-none {
pointer-events: none;
}
.box-none * {
pointer-events: auto;
}
  • 'box-only': 视图可以是触摸事件的目标,但其子视图不能。它的行为就像视图在 CSS 中具有以下类一样
css
.box-only {
pointer-events: auto;
}
.box-only * {
pointer-events: none;
}
类型
枚举('box-none', 'none', 'box-only', 'auto')

removeClippedSubviews

这是 RCTView 公开的一个保留性能属性,当有许多子视图(其中大部分在屏幕外)时,对于滚动内容非常有用。为了使此属性有效,它必须应用于包含许多超出其边界的子视图的视图。子视图也必须具有 overflow: hidden,包含视图(或其父视图之一)也应如此。

类型
布尔值

renderToHardwareTextureAndroid
Android

View 是否应将其自身(及其所有子视图)渲染到 GPU 上的单个硬件纹理中。

在 Android 上,这对于仅修改不透明度、旋转、平移和/或缩放的动画和交互非常有用:在这些情况下,视图无需重新绘制,显示列表也无需重新执行。纹理可以重复使用并与不同的参数重新合成。缺点是这会占用有限的视频内存,因此此属性应在交互/动画结束时重新设置为 false。

类型
布尔值

role

role 向辅助技术用户传达组件的用途。优先于 accessibilityRole 属性。

类型
角色

shouldRasterizeIOS
iOS

View 是否应在合成之前渲染为位图。

在 iOS 上,这对于不修改此组件尺寸或其子组件的动画和交互非常有用;例如,当平移静态视图的位置时,光栅化允许渲染器重用静态视图的缓存位图,并在每帧快速合成它。

光栅化会产生屏幕外绘制过程,并且位图会占用内存。使用此属性时请进行测试和测量。

类型
布尔值

style

类型
View 样式

tabIndex
Android

View 是否应可通过非触摸输入设备(例如硬件键盘)获取焦点。支持以下值:

  • 0 - 视图可聚焦
  • -1 - 视图不可聚焦
类型
枚举(0, -1)

testID

用于在端到端测试中定位此视图。

这会禁用此视图的“仅布局视图移除”优化!

类型
字符串