0.1.5 • Published 5 years ago

smecta-rn-easy-chat-ui v0.1.5

Weekly downloads
2
License
MIT
Repository
github
Last release
5 years ago

react-native-easy-chat-ui

中文文档

npm npm npm npm

ScreenShots

Installation

  • npm: npm install react-native-easy-chat-ui --save
  • Yarn: yarn add react-native-easy-chat-ui

Example

import React, { Component } from 'react';
import {
  Platform,
  StyleSheet,
  Text,
  View,
  StatusBar,
  PermissionsAndroid
} from 'react-native';
import { Header, NavigationActions } from 'react-navigation'
import {AudioRecorder, AudioUtils} from 'react-native-audio'
import RNFS from 'react-native-fs'
import Sound from 'react-native-sound'
import { ChatScreen } from 'react-native-easy-chat-ui'


class Example extends React.Component {
  state = {
    msg: {
      friend_12345678: {
        messages: [
          {
            id: `${new Date().getTime()}`,
            per: {
              type: 'text',
              content: 'hello world'
            } ,
            targetId: '12345678',
            chatInfo: {
              avatar: require('./app/source/image/avatar.png'),
              id: '12345678'
            },
            renderTime: true,
            sendStatus: 0,
            time: new Date().getTime()
          },
        ],
        inverted: false  // require
      }
    },
    voiceHandle: true,
    currentTime: 0,
    recording: false,
    paused: false,
    stoppedRecording: false,
    finished: false,
    audioPath: ''
  }


  sendMessage = (type, content, isInverted) => {
      console.log(type, content, isInverted, 'msg')
    }
  
  render() {
    return (
      <ChatScreen
        ref={(e) => this.chat = e}
        messageList={this.state.msg}
        isIphoneX={true}
        androidHeaderHeight={androidHeaderHeight}
        sendMessage={this.sendMessage}
      />
    )
  }
}

Advanced example (How to record voice)

See example/index.js for more!

About Message object

{
  friend_12345678: {
    messages: [
      {
        id: `${new Date().getTime()}`,
        per: {
          type: 'text',
          content: 'hello world'
        } ,
        targetId: '12345678',
        chatInfo: {
          avatar: require('./app/source/image/avatar.png'),
          id: '12345678'
        },
        renderTime: true,
        sendStatus: 0,
        time: new Date().getTime()
      }
    ],
    
    inverted: false  // require
  }
}
  • friend12345678: `${chatType}${chatId}`
  • id: message id
  • per: per message obj
  • targetId: The id of the person who sent the message
  • chatInfo: The profile of the person you're chatting with
  • renderTime: Whether to render time above message
  • sendStatus: 0 ---> sending, 1 ---> sendSuccess, -1 ---> You are deleted or on the blacklist, -2 ---> error
  • time: moment,messageList sorted by time
  • inverted: When messageList exceeds the screen height, set it to true otherwise false (You can change this value when componentWillUnmount or delete message)

Props

  • message
propsdefaultInfo
messageList{}Messages to display
onScroll() => {}ListView Props
onEndReachedThreshold0.1ListView Props
chatWindowStyleundefinedContainer style
sendMessage(type, content, isInverted) => {}Callback when sending a message
reSendMessage(type, content) => {}Callback when you want send again
delMessage(indexs, isInverted) => {}Callback when delete message
avatarStyleundefinedStyle of avatar
chatId'123455678'The id of the person you're chatting with
chatType'friend'Your relationship with the person you're chatting with
onMessagePress(type, index, content) => {}Callback when press a message
onMessageLongPress(type, index, content) => {}Callback when longPress a message and usePopView is false
pressAvatar(isSelf) => {}Callback when press avatar
isIphoneXtrueIs iphoneX、iphoneXR、iphoneXS or iphoneXS Max?
androidHeaderHeight66Android navigation bar height + statusBar height
userProfile{id: '88888888', avatar: 'default.png'}Your own profile
historyLoadingfalseDisplay an ActivityIndicator when loading earlier messages
loadHistory() => {}Callback when loading earlier messages
renderMessageTime(time) => {}Custom time inside above message
renderErrorMessage(messageStatus) => {}Custom a message when the friend relationship is abnormal
panelSource{icon: <Image source={require('../source/image/photo.png')} style={{width: 30, height: 30}}/>,title: '照片',onPress: () => { console.log('takePhoto') }}, {icon: <Image source={require('../source/image/camera.png')} style={{width: 30, height: 30}}/>,title: '拍照',onPress: () => { console.log('takePhoto') }}Custom panel source
renderPanelRow<TouchableOpacity key={index} style={{width: (width - 30) / 4, height: (width - 30) / 4, justifyContent: 'center', alignItems: 'center', marginBottom: 20}} activeOpacity={0.7} onPress={() => data.onPress()} > <View style={{backgroundColor: '#fff', borderRadius: 8, padding: 15, borderColor: '#ccc', borderWidth: StyleSheet.hairlineWidth}}>{data.icon}<Text style={{color: '#7a7a7a', marginTop: 10}}>{data.title}Custom a tab icon
allPanelHeight200emojiPanel and plusPanel height
messageErrorIconicon elementCustom a icon when message failed to be sent
leftMessageBackground'#fffff'Custom background color on left
rightMessageBackground'#a0e75a'Custom background color on right
  • inputBarProps

    propsdefaultInfo
    emojiIconicon elementCustom emoticons
    placeholder'请输入...'Placeholder when text is empty
    keyboardIconiconCustom keyboard icon
    plusIconicon elementCustom plus icon
    sendIconicon elementCustom send icon
  • popViewProps

    propsdefaultInfo
    usePopViewtrueDisplay a popView when longPress a message
    popoverStyle{backgroundColor: '#333'}popView style
    renderDelPanelundefinedCustom any what you want, (isSelect)=> {}
    changeHeaderLeft() => {}Custom headerLeft
    setPopItems(type, index, text) => {let items = [{title: '删除',onPress: () => {that.props.delMessage(index)}},{title: '多选',onPress: () => {that.multipleSelect(index)}}]if (type === 'text') {items = [{title: '复制',onPress: () => Clipboard.setString(text)},{title: '删除',onPress: () => {that.props.delMessage(index)}},{title: '多选', onPress: () => {that.multipleSelect(index)}}]}return items}Custom PopView
    messageDelIconicon elementCustom delete icon
    messageSelectIconicon elementCustom selected icon
    renderMessageCheckundefinedCustom selected icon, (isSelect)=> {}
  • voiceProps

    propsdefaultInfo
    useVoicetruesend voice message
    pressInText'按住 说话'Custom pressIn text
    pressOutText'松开 发送'Custom pressOut text
    voiceIconicon elementCustom voice icon
    voiceLeftIconundefinedCustom icon of the message on the left
    voiceRightIconundefinedCustom icon of the message on the right
    voiceErrorIconicon elementCustom icon when record error
    voiceErrorText'说话时间太短'Custom text when record error
    voiceCancelIconicon elementCustom icon when cancel record
    voiceCancelText'松开手指取消发送'Custom text when cancel record
    voiceNoteText'手指上划,取消发送'Custom text when pressIn record button
    voiceSpeakIconicon elementCustom icon when pressIn record button
    audioPath''File path to store voice
    audioOnProgress() => {}Callback when recording
    audioOnFinish() => {}Callback when finish record
    audioInitPath() => {}Callback when init file path
    audioRecord() => {}Callback when start record
    audioStopRecord() => {}Callback when stop record
    audioPauseRecord() => {}Callback when pause record
    audioResumeRecord() => {}Callback when resume record
    audioCurrentTime0audio length
    audioHandletrueWhether to get a recording handle
    setAudioHandle() => {}Callback when get handle or not
    audioHasPermissionfalseWhether has permission
    checkAndroidPermission() => {}Callback when check permission on android
    voiceLoadingfalseLoading voice or not
    voicePlayingfalsePlaying voice or not
    voiceLeftLoadingColor'#cccccc'Custom background color on left when load voice
    voiceRightLoadingColor'#628b42'Custom background color on right when load voice
  • bubbleProps

propsdefaultInfo
renderTextMessageundefinedCustom message text, (data) => {}
renderImageMessageundefinedCustom message image, (data) => {}
renderVoiceMessageundefinedCustom message voice, (data) => {}
renderVoiceViewundefinedCustom voice container, (data) => {}
renderVideoMessageundefinedCustom message video, (data) => {}
renderLocationMessageundefinedCustom message location, (data) => {}
renderShareMessageundefinedCustom message share, (data) => {}

Notes for Android

  • Make sure you have android:windowSoftInputMode="adjustResize" in your AndroidManifest.xml:
android:windowSoftInputMode="adjustResize"

License