chat-ui

Adrian Yang

Adrian Yang

Front End Engineer @ Facebook

React chat-ui

基于dribble 上的即时聊天通信UI 设计稿, 使用React 实现

React简介

属性 props

组件接收props

function Button(props) {
return <button>{props.label}</button>;
}
// 解构label 省去通过点来获取属性值
function Button(label) {
return <button>{label}</button>;
}
//APP.js
function App() {
return (
<div>
<Button label="按钮" />
<Button label="点我" />
</div>
);
}

children 属性

props 内置属性 在组件中 开始和结束标签里的任何内容

事件监听

事件监听函数

直接写在组件函数体内 // 但所有该组都有该函数

写在组件的父级组件中,在通过属性props 将函数传递进去

状态 state

props 是静态的 数据不会刷新,如果想要动态更改组减的数值,使用状态State

// 解构赋值 接收状态的默认值 返回一个数组 第一个元素是状态的值 第二个是改变状态值的函数
//style 接受一个对象形式

Hooks

用来定义可复用的逻辑

推荐Hooks 都以use开头

什么是 Hook ?

Hook是一种特殊函数,可让你 “接入” React 功能。 例如,useState 是一个 Hook,允许您将 React state(状态) 添加到函数式组件中。 我们稍后会学习其他的 Hooks。

我什么时候使用 Hook?

如果你编写一个函数式组件并意识到你需要为它添加一些 state(状态) ,那么之前你必须将它转换为一个 classes(类) 。 但是现在,您可以在现有函数式组件中使用 Hook 。 我们现在要做到这一点!

import { useState } from 'react';
function Example() {
// Declare a new state variable, which we'll call "count"
const [count, setCount] = useState(0);

调用 useState 有什么作用?

它声明了一个 “state(状态)变量”。 我们的变量叫做 count,但我们可以称之为其他任何东西,比如 banana。 这是一种在函数调用之间“保留”某些值的方法 - useState 提供了和使用在类中 this.state 完全相同功能的新方法。 通常,当函数退出时变量就会“销毁”,但 React 会保留 state(状态) 变量。

我们传递给 useState 的参数是什么?

seState() Hook 惟一参数是初始 state(状态) 。与 classes(类) 不同,这里的 state(状态) 不一定是对象。他可以是任何我们需要的内容,比如数字,字符串等。在我们的示例中,我们只需要一个数字来表示用户点击的次数,因此将 0 作为变量的初始状态。(如果我们想在状态中存储两个不同的值,我们将调用 seState()两次。)

useState返回的是什么?

它返回一对值:当前 state(状态) 和更新它的函数。 这就是我们编写 const [count, setCount] = useState() 的原因。 这与类中的 this.state.count 和 this.setState 类似,只不过它们是成对的。

Styled-components

负责模块化样式管理

可以根据组件的props来生成不同的样式,此外生成的CSS只在本组件生效,不会影响其他组件

Styled-components 创建的也是react 组件

传统样式的缺点

  1. 使用class 不够灵活 只能使用新的样式去覆盖旧的样式
  2. 不能根据逻辑判断 来决定最终样式
  3. 相同className 还容易造成命名冲突

styled-components 优点

可以使用主题 可以将主要颜色 次要颜色 文字大小 都定义在主题(theme.js)中, 之后 组件中使用主题中定义好的变量就可以了. 之后只要直接修改主题 组件就会自动应用新样式

styled-components 相关组件

所有用 styled-components 创建的组件,其 props 里带有 theme 属性,用来访问主题对象

<ThemeProvider/> 该组件用于加载主题

styled 该对象可以访问到与 HTML 标签相同的属性

//自定义宽度 ${} 来访问属性
const StyledButton = styled.div `
width: ${({ width } )=> width || "80px"};
background-color: ${({ theme }) => theme.primaryColor};
`;
function Button( {width, onClick, label, children }) {
return(
<StyledButton width={width} onClick={onClick}>
<button>{label}</button>
{children}
</StyledButton>
);
}

tagged template Literals 为模板字符串传递参数

CSS 辅助函数 用来定义可复用的样式

与 SASS 和 Less 中的Mixins 类似

const circleMixinFunc = (color, size = "8px") => css ` `

as style-components 中指定渲染为 p 标签

styled(StylesText) 使用该函数来直接使用其他组件的样式

StoryBook

负责独立组件开发 和 文档管理, 使用清晰的文档形式来组织 和 展示组件

引入StoryBook npx -p @StoryBoo/cli sb init

启动StoryBook yarn run storybook

StoryBook 会搜索所有以.stories.js 结尾的文件,然后渲染其中的内容

React Spring

制作过度动画

侧导航

组件说明

  • 头像
  • 菜单项
  • 高亮显示条

头像组件 Avatar

头像组件应用位置

  • 导航栏中的头像 (在线的状态展示)
  • 聊天窗口标题栏的头像
  • 好友资料中的头像
  • 个人资料的头像 (右下角有操作按钮)

index.js - 组件主体代码

rfcp 快捷键 (ES7 React/Redux/GraphQL/React-Native snippets)

import React from 'react'
import PropTypes from 'prop-types'
function $1(props) {
return <div>$0</div> // 函数 内返回最外层容器组件
}
$1.propTypes = {} // 添加了属性类型检查
export default $1 // 导出组件
  1. 导入 React 依赖
  2. 创建按一个函数式的组件,并返回一个空的 标签
  3. 引入 Proptype 并且给组件设置一个空的Protypes 属性

style.js

Styled-components 样式组件代码

import styled from 'styled-components' //导入 styled-components 的实例
const StyledAvatar = styled.div``;
//头像组件最外层的容器
const StatusIcon = styled.div``;
//头像的在线状态
const AvatarClip = styled.div``;
//头像蒙版
const AvatarImage = styled.img``;
//将最外层容器默认导出 其他的 作为命名导出
export default StyledAvatar;
export { StatusIcon,AvatarClip,AvatarImage };

avatar.stories.js

用来编写组件的stories, 展示组件实例

import Avatar from "./Avatar";
import React from "react";
export default {
title:"Avatar",
component: Avatar,
}; // 默认导出
export const Default = () => {
return <Avatar src={face1} />
}; // 组件默认的story

头像组件添加属性

我们想让其他组件在使用头像组件时,可以自定义头像图片,在线状态,尺寸,还有在线图标的大小

通过props 来进行灵活的设置

  • src
  • size
  • status 使用&& 符号进行状态判断
  • statusIconSize 在线状态图标尺寸

jsconfig.json 文件介绍

是Vscode 下的配置文件 基于 typescript 中 tsconig.json 文件演化而来

我们可以对工程进行配置,让vscode 提供更好的代码补全和提示功能

配置绝对路径导入 : compilerOptions

- include: ["src"] 表示vscode 会把那些目录下的文件夹当成 项目的源代码
- exclude:["node_modules"] 那些文件夹不属于项源代码 //一般noedmudles 存放依赖库 一般不属于项目源代码
-

Hygen 模板生成器配置

配置组件中三个文件模板,使用一条命令直接生成三个文件

npm i -g hygen // 安装
hygen init self // 初始化 生成了一个 _templates的文件夹
hygen generator new component // 创建一个名字为 component 的模板生成器
hygen component new Icon // Action hygen component new --name Icon

编写模板文件

index.js
---
to: src/components/<%= name %>/index.js
---
import React from 'react'
import PropTypes from 'prop-types'
import Styled<%= name %> from './style';
function <%= name %>({
children,
...rest
}) {
return (
<Styled<%= name %> {...rest}>
{children}
</Styled<%= name %>>
);
}
<%= name %>.propTypes = {
children: PropTypes.any
};
export default <%= name %>;
=================================================
style.js
---
to: src/components/<%= name %>/style.js
---
import styled from "styled-components";
const Styled<%= name %> = styled.div``;
export default Styled<%= name %>;
===================================================
stories.js
---
to: src/components/<%= name%>/<%= h.changeCase.lcFirst(name) %>.stories.js
---
import React from "react";
import <%= name%> from ".";
export default {
title: "<%= name%>",
component: <%= name%>
}
export const Default = () => <<%= name%>> 默认 </<%= name%>>;

ICON 组件

Fontawesome 图标库

λ yarn add @fortawesome/react-fontawesome //fontawesome 的react 组件
λ yarn add @fortawesome/fontawesome-svg-core // 核心图标库
λ yarn add @fortawesome/free-brands-svg-icons // 品牌图标库
λ yarn add @fortawesome/free-regular-svg-icons // 空心图标库
λ yarn add @fortawesome/free-solid-svg-icons // 实心图标库
const StyledIcon = styled.div`
display: inline-flex;
align-items: center;
justify-content: center;
svg,
svg * {
${({ color }) => (color ? `fill: ${color}`: "")};
${({ opacity }) => (opacity ? ` opacity: ${opacity}`: "")};
}
`;
===============================
sories.js
import React from "react";
import Icon from ".";
import { ReactComponent as SmileIcon } from "assets/icons/smile.svg"
// ReactComponent 来自于webpack的 svg loader creat react app 中 自己配置了
//将 svg看组组件导入 最终将 svg代码 渲染到 Dom 上 变成行内svg 
import { FontAwesomeIcon } from "@fortawesome/react-fontawesome"
import { faCommentDots } from '@fortawesome/free-solid-svg-icons'
export default {
title: "UI/Icon",
component: Icon
}
export const Default = () => <Icon icon={SmileIcon} />;
export const CustomColor = () => {
return <Icon icon={SmileIcon} color="#cccccc" />;
};
export const CustomSize = () => {
return <Icon icon={SmileIcon} width={48} height={48} color="#cccccc" />;
};
export const FontAwesome = () => {
return <FontAwesomeIcon icon={faCommentDots} />;
}

徽章组件

菜单项组件

由图标构成的 在激活的状态下 左侧有高亮显示条 (由高亮条和底层阴影构成)

因为消息列表中也有高亮线条条 所以将css 定义为 minxin

NavBar -> MenuItem

  • active 是否显示高亮条
  • icon
  • showBadge (Badge 组件在有children 的时候会自动显示红点)

怎么给一个React 图标库的 组件 的样式?

style.js 如何引用图标库 使用styled() 函数包裹图标

... rest 传递组件的剩余属性,在这里就保证了 被包裹的React 组件所需要的className 属性. 也可以将className 单独拿出来然后赋值给需要样式的组件

其中组件内使用的a标签 日后可以换成react-router 中的link 组件

当我向访问一个主题theme中的颜色,但是我又不想创造一个components 该怎么解决呢

storyBook 添加 Babellrc 来支持 stylecomponents 的css 属性 用来访问属性和主题

实质上背后通过Babel 生成了一个stylecomponents 组件

侧导航组件

其中头像1/5 即1fr 菜单项 占据 4/5 即4fr,并且菜单项之间使用Grid 布局.

剩下所有的空间分配给设置项 并且靠下对齐.

使用css Grid 进行布局

grid-template-rows: 1fr 4fr;
grid-template-rows: repeat(5, minmax(auto, 88px)) 1fr;
minmax(min, max)
是一个来定义大小范围的属性,大于等于min值,并且小于等于max值。如果max值小于min值,则该值会被视为min值。最大值可以设置为网格轨道系数值<flex> ,但最小值则不行

侧边栏

组件说明

  • 搜索框
  • 过滤选项 和 动作按钮
  • 绘画卡片列表

搜索框

外层的容器: 前缀图标 + 真实的输入框 + 后缀图标

使用 usetheme Hook 来访问主题中的属性

const theme = useTheme();
<Input
placeholder={placeholder}
prefix={
<Icon icon={SearchIcon} color={theme.gray3} width={18} height={18} />

排版组件

用于应用程序中需要展示文字的地方

本应用中使用 <Text /> 行内文本, <Paragraph> 块级元素每个段落单独占据一行

<Paragraph> 中的属性

  • ellipsis 用于 单行表示超长文本是否显示省略号
  • as style-components 中指定渲染为 p 标签
const StyledParagraph = styled(StyledText)`
${({ ellipsis }) =>
ellipsis &&
css`
text-overflow: ellipsis;
white-space: nowrap;
overflow: hidden;
`}
`;
//设置超长文本省略的CSS 样式

注意: 使用 <React.Fragment> 标签来进行返回: 避免使用多余 DIV 和 返回多余的 Children

按钮组件

漂浮动作按钮 按钮

过滤选项组件

  • 下拉选项框
  • Filter 左边的过滤选项菜单
  • Action 右侧的动作按钮

使用Grid 布局

grid-template-columns: 2fr 1fr;

消息卡片组件

  • 头像 + 状态
  • 消息文本

内容区域

组件整体说明

  • 聊天主界面
  • 标题栏
  • 绘画气泡
  • 底部聊天工具

标题栏

与消息卡片类似( 内容区 + 标题栏 ), 所以我们使用Grid 进行布局

oVAjG.png

会话气泡组件

oVJG2.png

组件属性

  • type 对方发送 or 自己发送
  • time 消息发送的时间
  • <BubbleTip> 代表会话气泡下的小尾巴

语音消息组件

设置不让语音组件的播放按钮宽度变化 设置缩放属性

flex-shrink:0;

oFC8U.png

Emoji 组件

简单使用 <span> 标签进行包裹

<span role = "img" aria-label = "smirk" >
// emoji 添加aria-lanbel 属性后,会被是视为图片 方便屏幕阅读器使用者

oIXUj.png

Popover 组件

一个弹出形式视图层,通常附着在其他组件上(z.B Button)

oIp5k.png

使用Hooks 来控制弹出层的展示 和 隐藏

const [visible, setVisible] = useState(false);
const handleClick = () => {
if (visible) {
setVisible(false);
onHide && onHide();
} else {
setVisible(true);
onVisible && onVisible();
}
};

滑动抽屉

组件整体说明

  • 头像
  • 昵称 地区 个性签名
  • 社交 和 联系信息
  • 相册

设置页面

InputText组件

设置了新的布局组件 <Labelcontainer>

其他列表组件

过滤列表组件

提取公共的布局 和 统一的事件处理

3GkcA.png

联系人列表组件

<ContactCard>

文件列表组件

笔记列表组件

视频通话组件

Dropdown组件