React-Native封装带阴影的Card组件

全局安装 react-native-create-library 命令工具,用于创建自定义组件模板。

npm install -g react-native-create-library

通过该命令工具我们创建一个组件项目,并指定平台为 androidios ,指定 android 中的 package

react-native-create-library --package-identifier com.zhangyu.card --platforms android,ios card

将项目重命名为 react-native-zy-card 方便上传到 npm

mv card react-native-zy-card

可看到当前目录结构为

.
└── react-native-zy-card
    ├── README.md
    ├── android
    │   ├── build.gradle
    │   └── src
    │       └── main
    │           ├── AndroidManifest.xml
    │           └── java
    │               └── com
    │                   └── zhangyu
    │                       └── card
    │                           ├── RNCardModule.java
    │                           └── RNCardPackage.java
    ├── index.js
    ├── ios
    │   ├── RNCard.h
    │   ├── RNCard.m
    │   ├── RNCard.podspec
    │   ├── RNCard.xcodeproj
    │   │   └── project.pbxproj
    │   └── RNCard.xcworkspace
    │       └── contents.xcworkspacedata
    └── package.json

这里主要编写 android 部分的代码,因为只有安卓端比较特殊,RN设置的阴影颜色,阴影透明度,阴影偏移量在安卓端是无法生效的,只有在 ios 端才生效。所以我们需要桥接Android原生来实现自定义阴影的效果。

Android

Android Studio 打开 android 项目目录,会看到有 RNCardModule.javaRNCardPackage.java 两个文件

其中 RNCardModule.java 通过 getName 方法来定义模块名称

package com.zhangyu.card;

import com.facebook.react.bridge.ReactApplicationContext;
import com.facebook.react.bridge.ReactContextBaseJavaModule;
import com.facebook.react.bridge.ReactMethod;
import com.facebook.react.bridge.Callback;

public class RNCardModule extends ReactContextBaseJavaModule {

  private final ReactApplicationContext reactContext;

  public RNCardModule(ReactApplicationContext reactContext) {
    super(reactContext);
    this.reactContext = reactContext;
  }

  @Override
  public String getName() {
    return "RNCard";
  }
}

然后我们新建一个 RNCardManager.java 视图管理类,用于实现原生效果。

其中原生实现用到了一个非常强大的原生组件库 ShadowLayout 所以我们需要在 build.gradle 中引入

dependencies {
    compile 'com.facebook.react:react-native:+'
    compile 'com.github.lihangleo2:ShadowLayout:3.1.8'
}

然后实现原生样式

package com.zhangyu.card;

import android.graphics.Color;

import com.lihang.ShadowLayout;
import com.facebook.react.uimanager.ViewGroupManager;
import com.facebook.react.uimanager.ThemedReactContext;
import com.facebook.react.views.view.ReactViewGroup;
import com.facebook.react.uimanager.PixelUtil;
import com.facebook.react.uimanager.annotations.ReactProp;

public class RNCardManager extends ViewGroupManager<ShadowLayout> {

    @Override
    public String getName() {
        return "RNCard";
    }

    @Override
    public ShadowLayout createViewInstance(ThemedReactContext reactContext) {
        ShadowLayout cardView = new ShadowLayout(reactContext);
        cardView.setShadowHidden(false);
        ReactViewGroup reactViewGroup = new ReactViewGroup(reactContext);
        cardView.addView(reactViewGroup);
        return cardView;
    }

    // 设置卡片的圆角
    @ReactProp(name = "borderRadius", defaultInt = 0)
    public void setCornerRadius(ShadowLayout view, int borderRadius) {
        view.setCornerRadius(borderRadius);
    }

    // 设置阴影颜色
    @ReactProp(name = "borderShadowColor")
    public void setShadowColor(ShadowLayout view, String borderShadowColor){
        view.setShadowColor(Color.parseColor(borderShadowColor));
    }

    // 设置卡片颜色
    @ReactProp(name = "backgroundColor")
    public void setLayoutBackground(ShadowLayout view, String backgroundColor){
        view.setLayoutBackground(Color.parseColor(backgroundColor));
    }

    // 设置是否隐藏阴影
    @ReactProp(name = "shadowHidden")
    public void setShadowHidden(ShadowLayout view,boolean isHidden){
        view.setShadowHidden(isHidden);
    }

    // 设置阴影扩散区域
    @ReactProp(name = "shadowLimit",defaultInt = 0)
    public void setShadowLimit(ShadowLayout view,int limit){
        view.setShadowLimit(limit);
    }

    // 设置X轴偏移量
    @ReactProp(name = "shadowOffsetX",defaultFloat = 0)
    public void setShadowOffsetX(ShadowLayout view,float mDx){
        view.setShadowOffsetX(mDx);
    }

    // 设置Y轴偏移量
    @ReactProp(name = "shadowOffsetY",defaultFloat = 0)
    public void setShadowOffsetY(ShadowLayout view,float mDx){
        view.setShadowOffsetY(mDx);
    }

    // 设置是否隐藏上边阴影
    @ReactProp(name = "shadowHiddenTop")
    public void setShadowHiddenTop(ShadowLayout view,boolean isHidden){
        view.setShadowHiddenTop(isHidden);
    }

    // 设置是否隐藏右边阴影
    @ReactProp(name = "shadowHiddenRight")
    public void setShadowHiddenRight(ShadowLayout view,boolean isHidden){
        view.setShadowHiddenRight(isHidden);
    }

    // 设置是否隐藏下边阴影
    @ReactProp(name = "shadowHiddenBottom")
    public void setShadowHiddenBottom(ShadowLayout view,boolean isHidden){
        view.setShadowHiddenBottom(isHidden);
    }

    // 设置是否隐藏左边阴影
    @ReactProp(name = "shadowHiddenLeft")
    public void setShadowHiddenLeft(ShadowLayout view,boolean isHidden){
        view.setShadowHiddenLeft(isHidden);
    }
}

RNCardPackage.java 中注册刚才实现的 RNCardManager.java 视图管理类


package com.zhangyu.card;

import java.util.Arrays;
import java.util.Collections;
import java.util.List;

import com.facebook.react.ReactPackage;
import com.facebook.react.bridge.NativeModule;
import com.facebook.react.bridge.ReactApplicationContext;
import com.facebook.react.uimanager.ViewManager;
import com.facebook.react.bridge.JavaScriptModule;
public class RNCardPackage implements ReactPackage {
    @Override
    public List<NativeModule> createNativeModules(ReactApplicationContext reactContext) {
      return Arrays.<NativeModule>asList(new RNCardModule(reactContext));
    }

    // Deprecated from RN 0.47
    public List<Class<? extends JavaScriptModule>> createJSModules() {
      return Collections.emptyList();
    }

    @Override
    public List<ViewManager> createViewManagers(ReactApplicationContext reactContext) {
      return Arrays.<ViewManager>asList(new RNCardManager());//修改这里
    }
}

编辑 index.js 文件,实现一个桥接组件,提供给RN调用

import React from 'react';

import {requireNativeComponent,Platform,View} from 'react-native';

// 桥接Android暴露出来的RNCard
const RNCard = requireNativeComponent('RNCard');

class CardView extends React.Component {
  // 默认参数
  static defaultProps = {
    shadowHidden: true, // 隐藏阴影
    borderRadius: 0, // 边框圆角
    borderShadowColor: '#000000', // 阴影颜色
    backgroundColor: '#ffffff', // 背景颜色
    shadowLimit: 0, // 阴影扩散区域
    shadowOffsetX: 0, // 阴影的X轴偏移量
    shadowOffsetY: 0, // 阴影的Y轴偏移量
    shadowHiddenTop: false, // 隐藏上边阴影
    shadowHiddenRight: false, // 隐藏右边阴影
    shadowHiddenBottom: false, // 隐藏下边阴影
    shadowHiddenLeft: false // 隐藏左边阴影
  }
  render() {
    return Platform.OS === 'android' ? <RNCard {...this.props}>{this.props.children}</RNCard> : 
    <View style={this.props.style}>{this.props.children}</View>;
  }
}

export default CardView;

为了方便测试,可以将你的组件整体拷贝到RN项目的 node_modules 目录下

image.png

package.json 中手动引入

image.png

如果测试没有问题的话,再上传到 npm ,以后就可以通过命令来安装组件了

yarn add react-native-zy-card

使用示例

import React from 'react';
import {Text, StyleSheet, View, Dimensions} from 'react-native';
import CardView from 'react-native-zy-card';

export default class App extends React.Component {
  render() {
    return (
      <View style={styles.content}>
        <CardView style={styles.iosStyle} shadowHidden={false}>
          <Text>123</Text>
        </CardView>
      </View>
    );
  }
}

const styles = StyleSheet.create({
  content: {
    display: 'flex',
    flexDirection: 'column',
    justifyContent: 'center',
    alignItems: 'center',
    width: Dimensions.get('window').width,
    height: Dimensions.get('window').height,
  },
  iosStyle: {
    width: 100,
    height: 100,
    marginTop: 10,
    backgroundColor: '#fff',
    shadowColor: 'rgba(0,0,0,.03)',
    elevation: 10,
    borderRadius: 10,
    shadowOpacity: 0.03,
    shadowOffset: {
      width: 0,
      height: 0,
    },
    borderColor: 'red',
    borderWidth: 1,
  },
});

ios 的样式内容正常写到 style 中, android 的样式单独指定,主要有以下属性可设置

属性 默认值 说明
shadowHidden true 是否隐藏阴影,默认隐藏
borderRadius 0 边框圆角
borderShadowColor #000000 阴影颜色,可指定透明度如#00000070就是70%
backgroundColor #ffffff 背景颜色
shadowLimit 0 阴影扩散区域
shadowOffsetX 0 阴影的X轴偏移量
shadowOffsetY 0 阴影的Y轴偏移量
shadowHiddenTop false 隐藏上边阴影
shadowHiddenRight false 隐藏右边阴影
shadowHiddenBottom false 隐藏下边阴影
shadowHiddenLeft false 隐藏左边阴影
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 205,236评论 6 478
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 87,867评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 151,715评论 0 340
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,899评论 1 278
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,895评论 5 368
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,733评论 1 283
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,085评论 3 399
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,722评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 43,025评论 1 300
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,696评论 2 323
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,816评论 1 333
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,447评论 4 322
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,057评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,009评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,254评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,204评论 2 352
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,561评论 2 343

推荐阅读更多精彩内容