React Native 添加自定义UI组件

前端之家收集整理的这篇文章主要介绍了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相关文章