chat-ui
Adrian Yang
Front End Engineer @ FacebookReact 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.jsfunction 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 组件
传统样式的缺点
- 使用class 不够灵活 只能使用新的样式去覆盖旧的样式
- 不能根据逻辑判断 来决定最终样式
- 相同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 // 导出组件- 导入 React 依赖
- 创建按一个函数式的组件,并返回一个空的 标签
- 引入 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 用于 单行表示超长文本是否显示省略号
asstyle-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 进行布局
会话气泡组件
组件属性
- type 对方发送 or 自己发送
- time 消息发送的时间
<BubbleTip>代表会话气泡下的小尾巴
语音消息组件
设置不让语音组件的播放按钮宽度变化 设置缩放属性
flex-shrink:0;
Emoji 组件
简单使用 <span> 标签进行包裹
<span role = "img" aria-label = "smirk" >// emoji 添加aria-lanbel 属性后,会被是视为图片 方便屏幕阅读器使用者Popover 组件
一个弹出形式视图层,通常附着在其他组件上(z.B Button)

使用Hooks 来控制弹出层的展示 和 隐藏
const [visible, setVisible] = useState(false);
const handleClick = () => { if (visible) { setVisible(false); onHide && onHide(); } else { setVisible(true); onVisible && onVisible(); } };滑动抽屉
组件整体说明
- 头像
- 昵称 地区 个性签名
- 社交 和 联系信息
- 相册
设置页面
InputText组件
设置了新的布局组件 <Labelcontainer>
其他列表组件
过滤列表组件
提取公共的布局 和 统一的事件处理

联系人列表组件
<ContactCard>


