跳到主要内容
新架构实战课 实操 + 基建 + 原理全维度包揽,抢先掌握 React Native 新架构精髓 立即查看 >Version: 0.74

直接操作

有时候我们需要直接改动组件并触发局部的刷新,但不使用 state 或是 props。譬如在浏览器中使用 React 库,有时候会需要直接修改一个 DOM 节点,而在手机 App 中操作 View 时也会碰到同样的情况。在 React Native 中,setNativeProps就是等价于直接操作 DOM 节点的方法。

注意

什么时候使用 setNativeProps 呢?在(不得不)频繁刷新而又遇到了性能瓶颈的时候。

直接操作组件并不是应该经常使用的工具。一般来说只是用来创建连续的动画,同时避免渲染组件结构和同步太多视图变化所带来的大量开销。setNativeProps是一个“简单粗暴”的方法,它直接在底层(DOM、UIView 等)而不是 React 组件中记录 state,这样会使代码逻辑难以理清。所以在使用这个方法之前,请尽量先尝试用setStateshouldComponentUpdate方法来解决问题。

setNativeProps 与 TouchableOpacity

TouchableOpacity这个组件就在内部使用了setNativeProps方法来更新其子组件的透明度:

const viewRef = useRef<View>();
const setOpacityTo = useCallback(value => {
// Redacted: animation related code
viewRef.current.setNativeProps({
opacity: value,
});
}, []);

由此我们可以写出下面这样的代码:子组件可以响应点击事件,更改自己的透明度。而子组件自身并不需要处理这件事情,也不需要在实现中做任何修改。

<TouchableOpacity onPress={this._handlePress}>
<View style={styles.button}>
<Text>Press me!</Text>
</View>
</TouchableOpacity>

如果不使用setNativeProps来实现这一需求,那么一种可能的办法是把透明值保存到 state 中,然后在onPress事件触发时更新这个值:

const [buttonOpacity, setButtonOpacity] = useState(1);
return (
<TouchableOpacity
onPressIn={() => setButtonOpacity(0.5)}
onPressOut={() => setButtonOpacity(1)}>
<View style={{opacity: buttonOpacity}}>
<Text>Press me!</Text>
</View>
</TouchableOpacity>
);

比起之前的例子,这一做法会消耗大量的计算 —— 每一次透明值变更的时候 React 都要重新渲染组件结构,即便视图的其他属性和子组件并没有变化。一般来说这一开销也不足为虑,但当执行连续的动画以及响应用户手势的时候,只有正确地优化组件才能提高动画的流畅度。

如果你看过NativeMethodsMixin中的setNativeProps方法的实现,你就会发现它实际是对RCTUIManager.updateView的封装 —— 而这正是重渲染所触发的函数调用,具体可以参看ReactNativeBaseComponent.js 中的 receiveComponent.

复合组件与 setNativeProps

复合组件并不是单纯的由一个原生视图构成,所以你不能对其直接使用setNativeProps。比如下面这个例子:

跑这个例子会马上看到一行报错: Touchable child must either be native or forward setNativeProps to a native component。这是因为MyButton并非直接由原生视图构成,而我们只能给原生视图设置透明值。你可以尝试这样去理解:如果你通过React.createClass方法自定义了一个组件,直接给它设置样式 prop 是不会生效的,你得把样式 props 层层向下传递给子组件,直到子组件是一个能够直接定义样式的原生组件。同理,我们也需要把setNativeProps传递给由原生组件封装的子组件。

将 setNativeProps 传递给子组件

具体要做的就是在我们的自定义组件中再封装一个setNativeProps方法,其内容为对合适的子组件调用真正的setNativeProps方法,并传递要设置的参数。

现在你可以用MyButton来代替TouchableOpacity了!有一点需要特别说明:这里我们使用了ref 回调语法,而不是传统的字符串型 ref 引用。

你可能还会注意到我们在向下传递 props 时使用了{...props}语法(这一用法的说明请参考对象的扩展运算符)。这是因为TouchableOpacity本身其实也是个复合组件, 它除了要求在子组件上执行setNativeProps 以外,还要求子组件对触摸事件进行处理。因此,它会传递多个 props,其中包含了onmoveshouldsetresponder 函数,这个函数需要回调给TouchableOpacity组件,以完成触摸事件的处理。与之相对的是TouchableHighlight组件,它本身是由原生视图构成,因而只需要我们实现setNativeProps

使用 setNativeProps 来直接编辑输入框的值

Another very common use case of setNativeProps is to edit the value of the TextInput. The controlled prop of TextInput can sometimes drop characters when the bufferDelay is low and the user types very quickly. Some developers prefer to skip this prop entirely and instead use setNativeProps to directly manipulate the TextInput value when necessary. For example, the following code demonstrates editing the input when you tap a button:

You can use the clear method to clear the TextInput which clears the current input text using the same approach.

避免和 render 方法的冲突

如果要更新一个由 render 方法来维护的属性,则可能会碰到一些出人意料的 bug。因为每一次组件重新渲染都可能引起属性变化,这样一来,之前通过setNativeProps所设定的值就被完全忽略和覆盖掉了。

setNativeProps 与 shouldComponentUpdate

通过巧妙运用shouldComponentUpdate方法,可以避免重新渲染那些实际没有变化的子组件所带来的额外开销,此时使用setState的性能已经可以与setNativeProps相媲美了。

其他原生方法

此处描述的方法大多数 React Native 已经提供。但是这些在组合组件是不支持的,因为原生的视图不提供支持,包含你自己的应用中你自定的绝大多数组件

measure(callback)

测量视图在屏幕上的坐标、宽度、高度,异步回调这些参数。如果测量成功则回调如下参数:

  • x
  • y
  • width
  • height
  • pageX
  • pageY

注意,这些参数必须在组件原生端渲染完成后才能返回视图测量值。若你想尽快的获取视图组件的测量值(且不需要pageXpageY),可考虑使用onLayout prop 来实现。

Also the width and height returned by measure() are the width and height of the component in the viewport. If you need the actual size of the component, consider using the onLayout property instead.

measureInWindow(callback)

获取指定视图在窗口上的位置,异步返回量测值。如果根视图在另一个视图上,将返回绝对的位置。获取成功返回如下参数:

  • x
  • y
  • width
  • height

measureLayout(relativeToNativeComponentRef, onSuccess, onFail)

类似measure()方法,测量相对于祖视图(通过relativeToNativeComponentRef来指定)的位置关系。返回的是相对于祖视图原点的xy

备注

This method can also be called with a relativeToNativeNode handler (instead of reference), but this variant is deprecated.

focus()

获取给定输入框或者视图的焦点。更进一步的变换操作依赖与不同的平台和不同的视图。

blur()

focus() 方法相反,该方法用来移除给定视图或者输入框的焦点。