本文对于UI组件的封装,主要从两部分介绍:
基本视图封装
事件处理
demo中是封装原生Button组件,记录使用过程及需要注意的问题。
一、基本视图封装
创建一个ViewManager的子类。
实现createViewInstance方法。
导出视图的属性设置器:使用@ReactProp(或@ReactPropGroup)注解。
把这个视图管理类注册到应用程序包的createViewManagers里。
实现JavaScript模块。
1.1创建一个ViewManager的子类
SimpleViewManager是ViewManager的派生类,通过该类创建和管理视图对象。
public class RCTButton extends SimpleViewManager {
private static final String EVENT_NAME_ONCLICK = "onClick";
private ThemedReactContext mContext;
@Override
public String getName() {
return "RCTButton";
}
}
SimpleViewManager中的Button是需要封装的UI组件,该组件可以是自定义组件。
实现方法getName,返回值RCTButton在实现JavaScript模块时需要用到。
1.2实现createViewInstance方法
RCTButton类中,实现createViewInstance方法,创建、返回View对象。
@Override
protected Button createViewInstance(ThemedReactContext reactContext) {
this.mContext = reactContext;
Button button = new Button(reactContext);
return button;
}
1.3导出视图的属性设置器
使用@ReactProp(或@ReactPropGroup)注解,这里介绍@ReactProp。
@ReactProp(name = "text")
public void setText(Button button,String text){
button.setText(text);
}
name="text" : name对应的值是在js代码中使用该封装组件时的属性名。
1.4 视图管理类注册
//自定义RTCViewPackage
public class RTCViewPackage implements ReactPackage {
@Override
public List createNativeModules(ReactApplicationContext reactContext) {
return Collections.EMPTY_LIST;
}
@Override
public List createViewManagers(ReactApplicationContext reactContext) {
return Arrays.asList(new RCTButton());
}
}
实现了两个方法,在createViewManagers方法中添加自定义的视图管理类RCTButton。
自定义RTCViewPackage类需要在MainApplication中添加:
@Override
protected List getPackages() {
return Arrays.asList(
new MainReactPackage(),
new RTCViewPackage()
);
}
1.5 实现JavaScript模块
'use strict';
import React, { Component } from 'react';
import {
requireNativeComponent
} from 'react-native';
let RTCBtn = requireNativeComponent("RCTButton",RCTButton);
export default class RCTButton extends Component {
render() {
return ;
}
}
requireNativeComponent关联js和原生组件,方法中的两个参数:第一个参数是JS模块名称,第二个参数是原生封装该UI组件时的名称,对应getName返回值。
{...this.props} 必须有,否则组件不显示。
二、事件处理
当一个原生事件发生的时候,它应该也触发JS端视图上的事件,这两个视图会依据getId()而关联在一起。(可以理解为原生层View给JS层View发送消息--个人理解O(∩_∩)O~)
2.1 事件映射
重写getExportedCustomDirectEventTypeConstants方法,将原生事件name映射到js事件name,类似于key-value。
public class RCTButton extends SimpleViewManager {
private static final String EVENT_NAME_ONCLICK_NATIVE = "nativeClick";
private static final String EVENT_NAME_ONCLICK_JS = "jsClick";
@Nullable
@Override
public Map getExportedCustomDirectEventTypeConstants() {
return MapBuilder.builder().put(EVENT_NAME_ONCLICK_NATIVE,MapBuilder.of("registrationName",EVENT_NAME_ONCLICK_JS)).build();
}
}
2.2 接受事件,传递给JS层
在RCTButton类中重写addEventEmitters方法,添加点击事件监听。
@Override
protected void addEventEmitters(final ThemedReactContext reactContext, final Button view) {
super.addEventEmitters(reactContext, view);
view.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
WritableMap data = Arguments.createMap();
data.putString("msg","点击btn2");
reactContext.getJSModule(RCTEventEmitter.class).receiveEvent(
view.getId(),
EVENT_NAME_ONCLICK,
data
);
}
});
}
关键代码:
reactContext.getJSModule(RCTEventEmitter.class).receiveEvent( view.getId(), EVENT_NAME_ONCLICK_NATIVE, data ); } });
该代码的类似于:view组件接收到了事件,传递给JS层。
receiveEvent的第一个参数是关联原生组件和js组件,第二个参数是事件映射中的key值,第三个参数是传递给js层的数据。
另外,如果不重写addEventEmitters方法,在createViewInstance方法中发送事件给js端也可。但是优先级低于addEventEmitters。
@Override
protected Button createViewInstance(final ThemedReactContext reactContext) {
this.mContext = reactContext;
final Button button = new Button(reactContext);
button.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
//创建数据传递信使,雷士android中的bundle
WritableMap data = Arguments.createMap();
data.putString("msg","点击了btn");
mContext.getJSModule(RCTEventEmitter.class).receiveEvent(
button.getId(),
EVENT_NAME_ONCLICK_NATIVE,//通过该string,查找js层对应的方法名
data
);
}
});
return button;
}
2.3 js模块
'use strict';
import React, { Component } from 'react';
import {
requireNativeComponent
} from 'react-native';
let RTCBtn = requireNativeComponent("RCTButton",RCTButton,{nativeOnly:{jsClick:true}});
export default class RCTButton extends Component {
_onClick = (event)=>{
if (!this.props.onPress){
return;
}
//使用event.nativeEvent.msg获取原生层传递的数据
this.props.onPress(event.nativeEvent.msg);
}
render() {
return
{...this.props} jsClick = {(event)=>this._onClick(event)}/>;
}
}
关键代码:
{nativeOnly:{jsClick:true}} : 故名思议,nativeOnly--只在原生中生效的属性,该属性将不再propType中定义,若不添加编译时将会报错。
jsClick = {(event)=>this._onClick(event)} :通过event可以获取到原生传递的数据
jsClick 对应原生代码中的事件映射中的private static final String EVENT_NAME_ONCLICK_JS = "jsClick"值
2.4 使用JS模块**
render() {
return (
(msg)=>{
alert("原生传递的数据为:"+msg)}}/>
);
}
使用过程中,添加了onPress属性。
拓展知识:
1.原生发送消息,js层注册监听
reactContext
.getJSModule(RCTNativeAppEventEmitter.class)
.emit(eventName, params);
//eventName:String JS中通过eventName接收
//params:WritableMap 需要传递的参数
js层接收:
NativeAppEventEmitter.addListener('onVolumeChange', () => {})
//onVolumeChange =>原生代码中的eventName
2.自定义组件时,js层给native层发送消息
native层需重写getCommandsMap和receiveCommand方法。
/**
* 接收交互通知
* @return
*/
@Nullable
@Override
public Map getCommandsMap() {
return MapBuilder.of("handleTask",1);
}
//根据RN层发送的对应通知ID,处理对应任务请求
@Override
public void receiveCommand(ImageView root, int commandId, @Nullable ReadableArray args) {
switch (commandId){
case 1:
if(args != null) {
String name = args.getString(0);//获取第一个位置的数据
Toast.makeText(context, "收到RN层的任务通知...", Toast.LENGTH_SHORT).show();
}
break;
default:
break;
}
}
js层发送任务通知
import { UIManager, findNodeHandle } from 'react-native';
sendNotification() {
//向native层发送命令
UIManager.dispatchViewManagerCommand(
findNodeHandle(this.refs.rctBtn),
UIManager.RCTButton.Commands.handleTask, // Commands后面的值与原生层定义的`handleTask`一致
["from React Native"] // 向原生层传递的参数数据,数据形如:["第一个参数","第二个参数",...]
);
}
render() {
return
ref = 'rctBtn'
{...this.props} onClick = {(event)=>this._onClick(event)}/>;
}