Skip to content

Commit 5e3b7c8

Browse files
committed
添加了新文章:Touchable系列组建讲解
1 parent f1d951f commit 5e3b7c8

File tree

2 files changed

+328
-0
lines changed

2 files changed

+328
-0
lines changed

README.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,7 @@
99
- [短信验证码倒计时控件](/ReactNative相关/短信验证码倒计时控件.md)
1010
- [ReactNative报错记录](/ReactNative相关/ReactNative报错记录.md)
1111
- [ReactNative利用CodePush实现热更新](/ReactNative相关/ReactNative利用CodePush实现热更新.md)
12+
- [Touchable系列组建讲解](/ReactNative相关/Touchable系列组建讲解.md)
1213

1314
----
1415

Lines changed: 327 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,327 @@
1+
2+
> 声明,本文并非原创,本文属于优质好文,故转载了,[原文链接](https://github.com/crazycodeboy/RNStudyNotes/blob/master/React%20Native%E7%BB%84%E4%BB%B6%E8%AF%A6%E8%A7%A3/React%20Native%E6%8C%89%E9%92%AE%E8%AF%A6%E8%A7%A3%7CTouchable%E7%B3%BB%E5%88%97%E7%BB%84%E4%BB%B6%E4%BD%BF%E7%94%A8%E8%AF%A6%E8%A7%A3.md)
3+
4+
本文出自[《React Native学习笔记》](https://github.com/crazycodeboy/RNStudyNotes/)系列文章。
5+
6+
在做App开发过程中离不了的需要用户交互,说到交互,我们首先会想到的就是按钮了,在React Native中没有专门的按钮组件。
7+
为了能让视图能够响应用的的点击事件,我们需要借助Touchablexxx组件,来包裹我们的视图。为什么说是Touchablexxx呢,因为它不只是一个组件,而是一组组件,一下四个组件都可以用来包裹视图来响应用户的点击事件。
8+
9+
- TouchableWithoutFeedback:响应用户的点击事件,如果你想在处理点击事件的同时不显示任何视觉反馈,使用它是个不错的选择。
10+
- TouchableHighlight:在TouchableWithoutFeedback的基础上添加了当按下时背景会变暗的效果。
11+
- TouchableOpacity:相比TouchableHighlight在按下去会使背景变暗的效果,TouchableOpacity会在用户手指按下时降低按钮的透明度,而不会改变背景的颜色。
12+
- TouchableNativeFeedback:在Android上还可以使用TouchableNativeFeedback,它会在用户手指按下时形成类似水波纹的视觉效果。注意,此组件只支持Android。
13+
14+
>心得:以上四个组件,其中TouchableHighlight、TouchableOpacity以及TouchableNativeFeedback都是在TouchableWithoutFeedback的基础上做了一些扩展,我们从它们的源码中可以看出:
15+
16+
17+
**TouchableHighlight:**
18+
19+
```
20+
var TouchableHighlight = React.createClass({
21+
propTypes: {
22+
...TouchableWithoutFeedback.propTypes,
23+
```
24+
25+
**TouchableOpacity:**
26+
27+
```
28+
var TouchableOpacity = React.createClass({
29+
mixins: [TimerMixin, Touchable.Mixin, NativeMethodsMixin],
30+
31+
propTypes: {
32+
...TouchableWithoutFeedback.propTypes,
33+
```
34+
35+
**TouchableNativeFeedback:**
36+
37+
```
38+
var TouchableNativeFeedback = React.createClass({
39+
propTypes: {
40+
...TouchableWithoutFeedback.propTypes,
41+
```
42+
43+
>因为TouchableWithoutFeedback有其它三个组件的共同属性,所以我们先来学习一下TouchableWithoutFeedback。
44+
45+
## TouchableWithoutFeedback使用详解
46+
47+
TouchableWithoutFeedback一个Touchable系列组件中最基本的一个组价,只响应用户的点击事件不会做任何UI上的改变,在使用的过程中需要特别留意。
48+
49+
>提示:无论是TouchableWithoutFeedback还是其他三种Touchable组件,都是在根节点都是只支持一个组件,如果你需要多个组件同时相应单击事件,可以用一个View将它们包裹着,它的这种根节点只支持一个组件的特性和ScrollView很类似。
50+
51+
接下来让我们来看一下,TouchableWithoutFeedback有哪些常用的属性:
52+
53+
### TouchableWithoutFeedback常用的属性
54+
55+
说到常用的属性TouchableWithoutFeedback首先要提到的就是`onPress`了。
56+
57+
#### `onPress function`
58+
59+
当触摸操作结束时调用,但如果被取消了则不调用(譬如响应者被一个滚动操作取代)。
60+
>心得:`onPress`可谓是Touchable系列组件的最常用的属性之一了,如果你要让视图响应用户的单击事件,那么用`onPress`就可以了。
61+
62+
接下来呢,我们就来使用`onPress`属性来实现一个统计按钮单击次数的例子。
63+
64+
```js
65+
<TouchableWithoutFeedback
66+
onPress={()=> {
67+
this.setState({count: this.state.count+1})
68+
}}
69+
>
70+
<View style={styles.button}>
71+
<Text style={styles.buttonText}>
72+
我是TouchableWithoutFeedback,单击我
73+
</Text>
74+
</View>
75+
</TouchableWithoutFeedback>
76+
<Text style={styles.text}>您单击了:{this.state.count}次</Text>
77+
```
78+
[下载源码](https://github.com/crazycodeboy/RNStudyNotes/tree/master/Demo)
79+
80+
![TouchableWithoutFeedback_onPress](https://raw.githubusercontent.com/crazycodeboy/Resources-Blog/master/images/2017/1/React%20Native%E6%8C%89%E9%92%AE%E8%AF%A6%E8%A7%A3%7CTouchable%E7%B3%BB%E5%88%97%E7%BB%84%E4%BB%B6%E4%BD%BF%E7%94%A8%E8%AF%A6%E8%A7%A3/TouchableWithoutFeedback_onPress.gif)
81+
82+
#### `onLongPress function`
83+
84+
当用户长时间按压组件(长按效果)的时候调用该方法。
85+
>心得:`onLongPress`也是Touchable系列组件的最常用的属性之一,通常用于响应长按的事件,如长按列表弹出删除对话框等。
86+
87+
接下来呢,我们就来使用`onLongPress`属性来响应用户的长按事件。
88+
89+
```js
90+
<TouchableWithoutFeedback
91+
onPress={()=> {
92+
this.setState({count: this.state.count + 1})
93+
}}
94+
onLongPress={()=> {
95+
this.setState({countLong: this.state.countLong + 1})
96+
Alert.alert(
97+
'提示',
98+
'确定要删除吗?',
99+
[
100+
{text: '取消', onPress: () => console.log('Cancel Pressed'), style: 'cancel'},
101+
{text: '确实', onPress: () => console.log('OK Pressed')},
102+
]
103+
)
104+
}}
105+
>
106+
<View style={styles.button}>
107+
<Text style={styles.buttonText}>
108+
我是TouchableWithoutFeedback,单击我
109+
</Text>
110+
</View>
111+
</TouchableWithoutFeedback>
112+
<Text style={styles.text}>您单击了:{this.state.count}次</Text>
113+
<Text style={styles.text}>您长按了:{this.state.countLong}次</Text>
114+
```
115+
[下载源码](https://github.com/crazycodeboy/RNStudyNotes/tree/master/Demo)
116+
117+
![TouchableWithoutFeedback_onLongPress](https://raw.githubusercontent.com/crazycodeboy/Resources-Blog/master/images/2017/1/React%20Native%E6%8C%89%E9%92%AE%E8%AF%A6%E8%A7%A3%7CTouchable%E7%B3%BB%E5%88%97%E7%BB%84%E4%BB%B6%E4%BD%BF%E7%94%A8%E8%AF%A6%E8%A7%A3/TouchableWithoutFeedback_onLongPress.gif)
118+
119+
我们在上面例子的基础上为Touchable设置了`onLongPress`属性,当用户长时间按压按钮是会弹出一个对话框。
120+
121+
>心得:当我们没有对Touchable组件设置`onLongPress`属性而设置了`onPress`属性的时候,我们长按按钮之后会回调`onPress`方法。另外,我们也可以通过`delayLongPress `方法来这设置从`onPressIn`被回调开始,到`onLongPress`被调用的延迟。
122+
123+
#### `disabled bool`
124+
125+
如果设为true,则禁止此组件的一切交互。
126+
>心得:`disabled`也是Touchable系列组件的最常用的属性之一,通常用于禁止按钮相应用户的点击事件,比如,当用户单击按钮进行登录时,需要进行网络请求,在请求操作完成之前如果用户多次单击登录按钮我们通常不希望发起多次登录请求,这个时候就可以借助`disabled`的属性来禁用按钮的交互。
127+
128+
接下来呢,我们就来模拟用户登录的例子来介绍一下`disabled`的使用。
129+
130+
```js
131+
<TouchableWithoutFeedback
132+
disabled={this.state.waiting}
133+
onPress={()=> {
134+
this.setState({text:'正在登录...',waiting:true})
135+
setTimeout(()=>{
136+
this.setState({text:'网络不流畅',waiting:false})
137+
},2000);
138+
139+
}}
140+
>
141+
<View style={styles.button}>
142+
<Text style={styles.buttonText}>
143+
登录
144+
</Text>
145+
</View>
146+
</TouchableWithoutFeedback>
147+
<Text style={styles.text}>{this.state.text}</Text>
148+
```
149+
[下载源码](https://github.com/crazycodeboy/RNStudyNotes/tree/master/Demo)
150+
151+
![TouchableWithoutFeedback_disabled](https://raw.githubusercontent.com/crazycodeboy/Resources-Blog/master/images/2017/1/React%20Native%E6%8C%89%E9%92%AE%E8%AF%A6%E8%A7%A3%7CTouchable%E7%B3%BB%E5%88%97%E7%BB%84%E4%BB%B6%E4%BD%BF%E7%94%A8%E8%AF%A6%E8%A7%A3/TouchableWithoutFeedback_disabled.gif)
152+
153+
在上面例子中我们模拟了用户登录的效果,默认状态下按钮是可以响应用户点击事件的,在正在登录过程中我们通过`disabled`属性来禁用了按钮,这时无论是单击还是长按按钮都是没有任何响应的,在停隔2s后,我们又将按钮解除禁用,这时按钮又可以重新响应用户的点击事件了。
154+
当用户长时间按压按钮时会弹出一个对话框。
155+
156+
>心得:有朋友问我,想禁用按钮,但是通过设置Touchable的`accessible `属性为false没有效果,这也是因为即使`accessible`为false的情况下,Touchable组件还是可以响应交互事件的,要想禁用Touchable的交互事件,只能通过`disabled`属性。
157+
158+
#### onPressIn function与onPressOut function
159+
160+
这两个方法分别是当用户开始点击按钮时与点击结束后被回调。
161+
162+
通过这两个方法我们可以计算出用户单击按钮所用的时长, 另外也可以做一些其它个性化的功能。现在我们将通过一个例子来计算出用户点击按钮所用的时长。
163+
164+
```js
165+
<TouchableWithoutFeedback
166+
onPressIn={()=> {
167+
this.setState({text:'触摸开始',startTime:new Date().getTime()})
168+
}}
169+
onPressOut={()=>{
170+
this.setState({text:'触摸结束,持续时间:'+(new Date().getTime()-this.state.startTime)+'毫秒'})
171+
}}
172+
>
173+
<View style={styles.button}>
174+
<Text style={styles.buttonText}>
175+
点我
176+
</Text>
177+
</View>
178+
</TouchableWithoutFeedback>
179+
<Text style={styles.text}>{this.state.text}</Text>
180+
```
181+
[下载源码](https://github.com/crazycodeboy/RNStudyNotes/tree/master/Demo)
182+
183+
![TouchableWithoutFeedback Pressin_out](https://raw.githubusercontent.com/crazycodeboy/Resources-Blog/master/images/2017/1/React%20Native%E6%8C%89%E9%92%AE%E8%AF%A6%E8%A7%A3%7CTouchable%E7%B3%BB%E5%88%97%E7%BB%84%E4%BB%B6%E4%BD%BF%E7%94%A8%E8%AF%A6%E8%A7%A3/TouchableWithoutFeedback%20Pressin_out.gif)
184+
185+
在上述例子中我们记录下用户单击按钮的时间戳,当单击结束后我们获取当前时间减去刚单击时的时间,它们的差值就是用户单击按钮所用的时间了。
186+
187+
>心得:另外我们也可以通过`delayPressIn``delayPressOut`两个方法来分别设置,从用户点击按钮到`onPressIn `被回调的延时与从点击结束到`onPressOut `被回调时的延时。
188+
189+
## TouchableHighlight使用详解
190+
`TouchableHighlight `是Touchable系列组件中比较常用的一个,它是在`TouchableWithoutFeedback `的基础上添加了一些UI上的扩展,既当手指按下的时候,该视图的不透明度会降低,同时会看到相应的颜色(视图变暗或者变亮),从`TouchableHighlight `的源码中我们可以看出,其实这个颜色就是在`TouchableHighlight `的最外层个添加了一个View,通过改变这个View的背景色及透明度来达到这一效果。
191+
192+
```js
193+
render: function() {
194+
return (
195+
<View
196+
accessible={this.props.accessible !== false}
197+
accessibilityLabel={this.props.accessibilityLabel}
198+
accessibilityComponentType={this.props.accessibilityComponentType}
199+
accessibilityTraits={this.props.accessibilityTraits}
200+
ref={UNDERLAY_REF}
201+
style={this.state.underlayStyle}
202+
onLayout={this.props.onLayout}
203+
hitSlop={this.props.hitSlop}
204+
onStartShouldSetResponder={this.touchableHandleStartShouldSetResponder}
205+
onResponderTerminationRequest={this.touchableHandleResponderTerminationRequest}
206+
onResponderGrant={this.touchableHandleResponderGrant}
207+
onResponderMove={this.touchableHandleResponderMove}
208+
onResponderRelease={this.touchableHandleResponderRelease}
209+
onResponderTerminate={this.touchableHandleResponderTerminate}
210+
testID={this.props.testID}>
211+
{React.cloneElement(
212+
React.Children.only(this.props.children),
213+
{
214+
ref: CHILD_REF,
215+
}
216+
)}
217+
{Touchable.renderDebugView({color: 'green', hitSlop: this.props.hitSlop})}
218+
</View>
219+
);
220+
}
221+
```
222+
223+
### TouchableHighlight所扩展出来的属性
224+
225+
#### activeOpacity number
226+
我们可以通过activeOpacity来设置`TouchableHighlight `被按下时的不透明度,从`TouchableHighlight `的源码中可以看出,它的默认不透明度为0.85,我们可以根据需要进行调节。
227+
228+
```js
229+
var DEFAULT_PROPS = {
230+
activeOpacity: 0.85,
231+
underlayColor: 'black',
232+
};
233+
```
234+
235+
#### underlayColor color
236+
我们可以通过`underlayColor `属性来设置`TouchableHighlight `被按下去的颜色,默认状态下为`balck`黑色。
237+
238+
#### onHideUnderlay function
239+
当衬底(也就是上文讲到的最外层的View)被隐藏的时候调用。
240+
241+
>心得,通常情况下,当手指结束点击时衬底会被隐藏。
242+
243+
#### onShowUnderlay function
244+
当衬底(也就是上文讲到的最外层的View)显示的时候调用。
245+
246+
>心得,通常情况下,当手指刚开始点击时衬底会显示。
247+
248+
#### style View#style
249+
因为`TouchableHighlight `的最外层个添加了一个View,所以我们可以设置这个View的样式来做出一个形形色色的按钮。
250+
251+
接下来,我们通过一个例子来看一下这些属性的使用。
252+
253+
```js
254+
<TouchableHighlight
255+
style={{marginTop:20}}
256+
activeOpacity={0.7}
257+
underlayColor='green'
258+
onHideUnderlay={()=>{
259+
this.setState({text:'衬底被隐藏'})
260+
}}
261+
onShowUnderlay={()=>{
262+
this.setState({text:'衬底显示'})
263+
}}
264+
onPress={()=>{
265+
266+
}}
267+
>
268+
<View style={styles.button}>
269+
<Text style={styles.buttonText}>
270+
TouchableHighlight
271+
</Text>
272+
</View>
273+
</TouchableHighlight>
274+
<Text style={styles.text}>{this.state.text}</Text>
275+
```
276+
[下载源码](https://github.com/crazycodeboy/RNStudyNotes/tree/master/Demo)
277+
278+
![TouchableHighlight](https://raw.githubusercontent.com/crazycodeboy/Resources-Blog/master/images/2017/1/React%20Native%E6%8C%89%E9%92%AE%E8%AF%A6%E8%A7%A3%7CTouchable%E7%B3%BB%E5%88%97%E7%BB%84%E4%BB%B6%E4%BD%BF%E7%94%A8%E8%AF%A6%E8%A7%A3/TouchableHighlight.gif)
279+
280+
281+
## TouchableOpacity使用详解
282+
283+
`TouchableOpacity`也是Touchable系列组件中比较常用的一个,它是在`TouchableWithoutFeedback`的基础上添加了一些UI上的扩展,但这些扩展相比`TouchableHighlight `少了一个额外的颜色变化。它是通过在按下去改变视图的不透明度来表示按钮被点击的。
284+
285+
### TouchableOpacity所扩展出来的属性
286+
287+
在扩展属性方面`TouchableOpacity`相比`TouchableHighlight`,就少了很多,只有一个`activeOpacity`,来设置按下去的透明度。
288+
289+
#### activeOpacity number
290+
同,`TouchableHighlight `[activeOpacity](#activeOpacity)
291+
292+
另外我们也可以通过`TouchableOpacity``setOpacityTo(value, duration)`方法来动态修改`TouchableOpacity`被按下去的不透明度。
293+
294+
295+
## TouchableNativeFeedback使用详解
296+
为了支持Android5.0新增的触控反馈,React Native加入了`TouchableNativeFeedback `组件,`TouchableNativeFeedback ``TouchableWithoutFeedback `所支持的属性的基础上增加了按下去的水波纹效果。我们可以通过`background `属性来自定义原生触摸操作反馈的背景。
297+
298+
### TouchableNativeFeedback所扩展出来的属性
299+
300+
#### background backgroundPropType
301+
302+
决定在触摸反馈的时候显示什么类型的背景。它接受一个有着type属性和一些基于type属性的额外数据的对象。推荐使用以下的静态方法之一来创建这个对象:
303+
304+
1) TouchableNativeFeedback.SelectableBackground() - 会创建一个对象,表示安卓主题默认的对于被选中对象的背景。(?android:attr/selectableItemBackground)
305+
306+
2) TouchableNativeFeedback.SelectableBackgroundBorderless() - 会创建一个对象,表示安卓主题默认的对于被选中的无边框对象的背景。(?android:attr/selectableItemBackgroundBorderless)。只在Android API level 21+适用。
307+
308+
3) TouchableNativeFeedback.Ripple(color, borderless) - 会创建一个对象,当按钮被按下时产生一个涟漪状的背景,你可以通过color参数来指定颜色,如果参数borderless是true,那么涟漪还会渲染到视图的范围之外。(参见原生的actionbar buttons作为该效果的一个例子)。这个背景类型只在Android API level 21+适用也就是Android5.0或以上设备。
309+
310+
```js
311+
<TouchableNativeFeedback
312+
onPress={()=>{
313+
this.setState({count: this.state.count + 1})
314+
}}
315+
background={TouchableNativeFeedback.SelectableBackground()}>
316+
<View style={{width: 150, height: 100, backgroundColor: 'red'}}>
317+
<Text style={{margin: 30}}>TouchableNativeFeedback</Text>
318+
</View>
319+
</TouchableNativeFeedback>
320+
<Text style={styles.text}>{this.state.text}</Text>
321+
```
322+
[下载源码](https://github.com/crazycodeboy/RNStudyNotes/tree/master/Demo)
323+
324+
![TouchableNativeFeedback.gif](https://raw.githubusercontent.com/crazycodeboy/Resources-Blog/master/images/2017/1/React%20Native%E6%8C%89%E9%92%AE%E8%AF%A6%E8%A7%A3%7CTouchable%E7%B3%BB%E5%88%97%E7%BB%84%E4%BB%B6%E4%BD%BF%E7%94%A8%E8%AF%A6%E8%A7%A3/TouchableNativeFeedback.gif)
325+
326+
327+

0 commit comments

Comments
 (0)