React之全屏化组件
介绍
本文基于React
+antd
,给大家演示一个完整的全屏demo
。
起因是开发今天给我提了一个sql编辑器输入框
比较小,不支持放大,不太方便。希望能够全屏显示,联想到自己以后可能也会需要,便研究并记录之。
其实我觉得也没有很小(orz)
image
全屏
大家应该都在web页面里面见过全屏
按钮,点击它以后页面就成了全屏,经常会在代码编辑器
中出现。
可以看到有对应的数据出现
上图就是leetcode全屏后的效果了,省略了菜单等内容
。
看起来全屏展示分为很多种
,我说说我的看法。
- leetcode这种 它只是页面全屏
- F11 我们可以按F11进入全屏模式,是chrome自带的,不需要修改代码
- 改变dom,其实和第一种一样,只不过会隐藏浏览器部分内容
image
如上图一样,浏览器
的躯壳已经不见了。
全屏的用处
全屏的话,似乎当你希望全身心投入
阅读的时候比较需要,就好像大家看电影
也喜欢全屏一样。主要还是放大
组件,让大量输入/阅读操作能够更愉快♀地进行。
安装react-full-screen
// yarn add react-full-screen npm install react-full-screen --save
使用yarn或者npm安装这个库。官网提供了一些demo,链接在此。
编写一个最简单的组件
这里就直接上代码了,代码
不多,很好懂。
import React, { useState } from "react"; import ReactDOM from "react-dom"; import "antd/dist/antd.css"; import "./index.css"; import { FullscreenOutlined, FullscreenExitOutlined } from "@ant-design/icons"; import { Tooltip, Card, Col, Row } from "antd"; import { FullScreen, useFullScreenHandle } from "react-full-screen"; const App = () => { // 定义full变量,为的是兼容全屏和非全屏的样式,比如full的时候高度为200,非full高度为100 const [full, setFull] = useState(false); // 创建一个fullScreen的handle const handle = useFullScreenHandle(); return ( <div style={{ background: "#ececec", height: 500 }}> <Row gutter={[8, 8]}> <Col span={8}> <Card style={{ height: 500 }}>左侧card</Card> </Col> <Col span={16}> <FullScreen handle={handle} onChange={setFull} style={{ background: "#ffffff" }} > <Card style={{ height: 500 }}> <div> <Tooltip title="全屏"> <FullscreenOutlined style={{ fontSize: 16 }} onClick={() => { // 点击设置full为true,接着调用handle的enter方法,进入全屏模式 setFull(true); handle.enter(); }} /> </Tooltip> <Tooltip title="退出全屏"> <FullscreenExitOutlined style={{ fontSize: 16, marginLeft: 16 }} // 退出全屏模式并把full设置为false onClick={() => { setFull(false); handle.exit(); }} /> </Tooltip> </div> <div>假设这是一个编辑器</div> </Card> </FullScreen> </Col> </Row> </div> ); }; ReactDOM.render(<App />, document.getElementById("container"));
image
展示出来是这个样子,代码里面加入了注释
,大家对着看即可。由于codesandbox
里面不太支持,所以我放到了一个antd pro的项目里面,给大家看看效果。
image
这样,我们做到了只放大编辑器
的效果,隐藏掉了其他不重要的部分(左侧部分)。
存在的问题
这样还远远不够,里面还有一些细节要优化
。
- 默认背景为黑色,不友好,我们需要设置样式
- 我们应该在全屏模式把编辑器高度变大
- 还有暗坑,待会再说
各个击破
- 背景色
我们使用的这个库,会默认包裹一个全局的div
,当全屏的时候,class为.fullscreen.fullscreen-enabled
,而非全屏的时候则为fullscreen
。
所以我们在全局/组件的样式里面写如下的css即可:
.fullscreen.fullscreen-enabled { background: #fff; padding: 24px; }
image
可以看到这个样式已经生效
了,而且我们加入了padding,这样看起来Card就不会被挤到边上
。
- 高度
我们之前设置了full变量,所以我们修改一下代码,根据full来判断高度。
image
image
可以看到盒子的高度
已经发生了变化。
扩展部分
如果你以为这就结束了,那就大错特错
了。接下来我们说一说暗坑。
在antd组件里面,modal/drawer/message等等都是在body中生成的dom元素,所以我们会遇到什么问题呢
?
在全屏模式
根本就看不到对话框/消息提示等。
但好在antd
提供了对应的参数,控制dom的挂载元素。
- Modal
modal可以这么解决,我们首先设置一个full_screen
的id:
image
注意,这个id一定要在FullScreen组件里面。
接着我们在Modal.info,Modal组件里面都加入如下参数:
image
注意: 这里的modal我的demo里面并没有写,这个属于扩展部分。写一个modal组件也不复杂,大家可以自己尝试下。
- Modal.info这样的api
Modal.info({ title: 'cud请求参数', width: 800, // 注意加上这个 getContainer: document.getElementById('full_screen') })
- message
通过message.config传入getContainer方法:
image
这里我没找到很好的办法,每次message.info的时候都需要config一下,还是比较麻烦的。如果作为全局配置
则又可能出问题,大家有更好的办法可以留言哈。