React Native 添加自定义UI组件

需要React Native已经提供了不少的UI控件,但有时仍然需要将我们自定义的UI控件集成到React Native中,本文已ImageView为例,将ImageView集成到React里,使JS可以使用Android ImageView

Native view是通过继续ViewManager的子类创建和管理的,React Native里提供了SimpleViewManager子类,可以方便使用,SimpleViewManager已经提供了一些基本属性如背景色,透明度,FlexBox布局相关的封装。

步骤:

  1. 创建ViewManager子类
  2. 实现createViewInstance方法
  3. 使用@ReactProp注解声明JS可以访问的属性方法
  4. 注册ViewManager
  5. 实现JavaScript组件

创建ViewManager子类

public class MyReactimageManager extends SimpleViewManager<ImageView> {
    public static final String REACT_CLASS = "MyRCtimageView";

    //返回的名字用于在JavaScript中引用此View type
    @Override
    public String getName(){
        return REACT_CLASS;
    }
 ...
}

实现createViewInstance方法

@Override
public ImageView createViewInstance(ThemedReactContext context){
    return new ImageView(context);
}

使用@ReactProp声明JS里使用的属性

使用@ReactProp(或@ReactPropGroup)注解定义一些在JavaScript里使用的属性的setter方法
属性设置方法的第一个参数为当前View类型(本例中为ImageView),第二个参数为为属性值。设置方法应该声明为public void类型
当前支持属性类型:boolean,int,float,double,String,Boolean,Integer,ReadableArray,ReadableMap
注解@ReactProp有一个类型为String的name参数。JS里将会通过注解里的这个name来调用这个设置方法
除了name属性外,@ReactProp还有其它可选属性:defaultBoolean,defaultInt,defaultFloat(对应boolean,float)。当js里没有显示指定此值时就会使用此值。default值目前只支持基本类型,对于其它复杂类型,认值为null

//使用@ReactProp或@ReactPropGroup声明一些在Javascript里可以使用的setter方法
@ReactProp(name = "src")
public void setSrc(final ImageView view,@Nullable final String src){
    new Thread(new Runnable() {
        @Override
        public void run() {
            final Bitmap bitmap = getBitmap(src);
            view.post(new Runnable() {
                @Override
                public void run() {
                    view.setimageBitmap(bitmap);
                }
            });
        }
    }).start();
}

@ReactProp(name = ViewProps.RESIZE_MODE)
public void setResizeMode(ImageView view,@Nullable String resizeMode){
    ImageView.ScaleType scaleType = ImageView.ScaleType.CENTER;

    if ("contain".equals(resizeMode)) {
        scaleType = ImageView.ScaleType.CENTER_INSIDE;
    }
    ...

    view.setScaleType(scaleType);
}

注册ViewManager

@Override
public List<ViewManager> createViewManagers( ReactApplicationContext reactContext)
{
return Arrays.<ViewManager>asList( new ReactimageManager() );
}

实现JavaScript module

// ImageView.js

var { requireNativeComponent,PropTypes } = require('react-native');

var iface = {
  name: 'ImageView',propTypes: {
    src: PropTypes.string,resizeMode: PropTypes.oneOf(['cover','contain','stretch']),},};

module.exports = requireNativeComponent('RCtimageView',iface,{nativeOnly:{
  'scaleX': true,'scaleY': true,'testID': true,'decomposedMatrix': true,'backgroundColor': true,'accessibilityComponentType': true,'renderToHardwareTextureAndroid': true,'translateY': true,'translateX': true,'accessibilityLabel': true,'accessibilityLiveRegion': true,'importantForAccessibility': true,'rotation': true,'opacity': true,}});

在JavaScript中使用上这个UI控件

//引入这个模块
var ImageView = require('./ImageView.js');

...
render() {
  return (
    <View style={styles.container}> ... <ImageView src= "http://i.imgur.com/UePbdph.jpg" resizeMode = "stretch" style = {styles.thumbnail}/> </View> ) }

期间遇到的错误

在ImageView.js里导出模块时module.exports = requireNativeComponent(‘RCtimageView’,iface)
遇到‘ImageView’ has no propType for native prop ‘RCtimageView.scaleX’ of native type ‘number’

原因:所使用的基类SimpleViewManager里定义了大量@ReactProp属性声明,这些属性需要在js模块里需要声明。
解决方法:,在requireNativeComponent里带上第三个参数,将所有的属性指定一下

module.exports = requireNativeComponent('RCtimageView',...
}});

参考文档

Facebook官方文档

相关文章

一、前言 在组件方面react和Vue一样的,核心思想玩的就是组件...
前言: 前段时间学习完react后,刚好就接到公司一个react项目...
前言: 最近收到组长通知我们项目组后面新开的项目准备统一技...
react 中的高阶组件主要是对于 hooks 之前的类组件来说的,如...
我们上一节了解了组件的更新机制,但是只是停留在表层上,例...
我们上一节了解了 react 的虚拟 dom 的格式,如何把虚拟 dom...