跳到主要内容
版本:0.80

TouchableHighlight

如果你在寻找一种更全面、面向未来的方式来处理基于触摸的输入,请查看 Pressable API。

用于让视图正确响应触摸的包装器。按下时,被包裹视图的透明度会降低,这样底层颜色就会透出来,使视图变暗或带有色调。

底层颜色来自于将子元素包裹在一个新的 View 中,这可能会影响布局;如果使用不当,有时还会导致不希望出现的视觉瑕疵,例如没有明确将被包裹视图的 backgroundColor 设置为不透明颜色。

TouchableHighlight 必须有一个子元素(不能为零个,也不能多于一个)。如果你希望拥有多个子组件,请将它们包裹在一个 View 中。

React TSX
function MyComponent(props: MyComponentProps) {
return (
<View {...props} style={{flex: 1, backgroundColor: '#fff'}}>
<Text>我的组件</Text>
</View>
);
}

<TouchableHighlight
activeOpacity={0.6}
underlayColor="#DDDDDD"
onPress={() => alert('已按下!')}>
<MyComponent />
</TouchableHighlight>;

示例​


参考

属性​

TouchableWithoutFeedback Props​

继承自 TouchableWithoutFeedback Props。


activeOpacity​

决定触摸激活时被包裹视图的透明度。该值应在 0 到 1 之间。默认值为 0.85。需要设置 underlayColor。

类型
number

onHideUnderlay​

在底层隐藏后立即调用。

类型
function

onShowUnderlay​

在底层显示后立即调用。

类型
function

style​

类型
View.style

underlayColor​

触摸激活时会透出的底层颜色。

类型
color

hasTVPreferredFocus
iOS
​

(仅限 Apple TV) TV 首选焦点(请参阅 View 组件的文档)。

类型
bool

nextFocusDown
Android
​

TV 下一个焦点方向为下(请参阅 View 组件的文档)。

类型
number

nextFocusForward
Android
​

TV 下一个焦点方向为前(请参阅 View 组件的文档)。

类型
number

nextFocusLeft
Android
​

TV 下一个焦点方向为左(请参阅 View 组件的文档)。

类型
number

nextFocusRight
Android
​

TV 下一个焦点方向为右(请参阅 View 组件的文档)。

类型
number

nextFocusUp
Android
​

TV 下一个焦点方向为上(请参阅 View 组件的文档)。

类型
number

testOnly_pressed​

便于快照测试。

类型
bool