Django+React全栈开发:界面优化

创建于更新于文集:Django+React全栈开发

时间处理

不少博客都会在文章列表界面仅显示文章发布距今的时间(如下图),之前我们是粗暴地将后台传回的ISO 8601格式的时间字符串显示出来,现在我们来处理一下。

首先让我们看看后台的数据经rest_framework序列化后是什么样子:2021-04-10T08:56:01.576834Z,这样显示太不体面了,给它修改一下。

这里我们可以使用dayjs来处理时间,现在来到前端部分,打开DjangoWithReact/frontend目录,使用yarn安装依赖,运行命令yarn add dayjs。为了直接看到效果,别忘了把前后端两个程序都启动起来。现在来修改frontend/src/ArticleList.js

import React, {Component} from "react";
import dayjs from "dayjs";
import "dayjs/locale/zh-cn"

// 本地化
dayjs.locale('zh-cn')

class ArticleList extends Component {
  // 省略...

  render() {
      return (
      <div className="article-list">
        {this.state.articleList.map(item =>
          <div key={item.id}>
            <h4>{item.title}</h4>
            <p>
              <strong>{item.body}</strong>
              <br/>
              <em>创建时间:{dayjs(item.created).format("YYYY-MM-DD")}</em>
              <em>更新时间:{dayjs(item.updated).format("YYYY-MM-DD")}</em>
            </p>
          </div>
        )}
      </div>
    );
  }

}

现在打开浏览器浏览localhost:3000,你就能看到和上面图中一样的效果了,Django默认使用的是UTC时间,我们这里自动根据时区做了本地化,可以把格式化字符串改成YYYY-MM-DD HH:mm与后端数据对比。

为了简洁起见,可以把时间改成相对时间,如昨天、上个月等,这需要引入dayjsrelativeTime插件:

import relativeTime from "dayjs/plugin/relativeTime"

dayjs.locale('zh-cn')
dayjs.extend(relativeTime)

class ArticleList extends Component {
  // ...

  render() {
      return (
        ......
                {/* 加个title,鼠标悬浮显示原始时间字符 */}
              <em>创建时间:<time title={item.created}>{dayjs().to(dayjs(item.created))}</time></em>
              <em>更新时间:<time title={item.updated}>{dayjs().to(dayjs(item.updated))}</time></em>

    );
  }

}

效果如下:

效果图

其实这里的需求很简单,不太需要用到dayjs这种时间处理库,也可以拿原生的IntlAPI来实现,这里就不讲了。

条件渲染

之前我们自己定义的名为articleList的数组对象现在还在代码中,但是事实上我们并不需要它,我们的文章数据是从后台API中取出的。现在删去原本定义articleList部分的代码,并在我们的类组件ArticleList构造函数中修改以下部分:

constructor(props) {
    super(props);
    this.state = {
    // 将state中的内容改成空数组
      articleList: [],
    };
  }
  .......

现在来关注一个组件中的render函数:

render() {
    const {articleList} = this.state;
    ......
  }

增加这一行代码,从this.state对象中直接取出articleList,这样之前JSX中的this.state.articleList就都可以直接简写为articleList了。目前我们在本地环境中,获取API非常快速,并且数据量也很少,那么如果在网络不好的情况下,后台的数据还没有取到,我们的页面当然不能一片空白吧?

修改render函数的返回值部分如下:

return (
    Array.isArray(articleList) && articleList.length !== 0
    ?
    <div className="article-list">
        ......
    </div>
    :
    <div>Loading</div>
);

这里我们在JSX中使用了三元运算符,代码很简单,只是当articleList数组不为空时显示文章列表,否则渲染<p>加载中...</p>。不过在JS中判断一个数组是否为空不能用Python的思维,例如arr == []arr === []都只会返回false。(PS:忍不住又想吐槽JS了。。。

现在打开浏览器刷新,不过由于这里获取到数据很快,所以会“加载中”的字样会一闪而过,可以将整个componentDidMount函数注释掉看看效果。

这就是React中的条件渲染了,可以根据情况来决定组件的渲染,目前我们的页面还非常简单,等以后我们添加了导航栏、侧边栏等元素时,你当然不希望因为文章数据还没取到而使得页面空空如也吧。

后续讲到Hooks的时候,会用react-query这个强大的库来替代原生fetch,现在先用简陋实现吧。

可以尝试封装ErrorPage组件,在请求错误时显示

提示

对代码做以下修改,将fetch捕获到的错误,设置到this.state中。完成练习后,暂停Django的运行,验证你做的是否正确吧。

constructor(props) {
    super(props);
    this.state = {
      articleList: [],
      error: null,
    };
  }

  componentDidMount() {
    fetch('/articles/')
      ......
      .catch(e => this.setState({error: e}));
  }

添加样式

可能你已经发现了,frontend/src目录下,除了后缀名为js的文件,还有后缀为css的同名文件,打开App.js看一看(如果你还没有删除它),还能发现import './App.css';这一行代码。

现在让我们也来写一个ArticleList.css

.article-list {
    text-align: center;
}

只是个文本居中显示,注意到我们已经在组件render函数的JSX中定义了div元素的className。现在只要在App.js中引入样式文件就行,在代码顶部添加import './ArticleList.css';。现在可以在页面中看到文字居中显示了。

也可以在JSX中直接设定样式,例如:

<h4 style={{ color: "red" }}>{item.title}</h4>

现在可以看到标题变成了红色。

还可以使用CSS Module,我们使用了类名选择器,如className="btn",浏览器会对拥有这个类名的元素应用对应的样式规则,但是在不同组件里的按钮可能是不一样的样式,那么我们就要注意命名,名字相同很可能会导致意想不到的效果。CSS模块可以解决这个问题,这种样式文件的命名规则为组件名.module.css,例如ArticleList.module.css

.title {
    color: blueviolet;
    font-size: 20px;
}

接着修改组件:

// 注意引入方式
import style from "./ArticleList.module.css";


class ArticleList extends Component {
......

    render() {
        const { articleList } = this.state;
        return (
            Array.isArray(articleList) && articleList.length !== 0
                ?
                <div>
                    {articleList.map(item =>
                        <div key={item.id}>
                            {/* 使用对应命名空间的类名 */}
                            <div className={style.title}>{item.title}</div>
                        </div>
                    )}
                </div>
                :
                <div>Loading</div>
        );
    }

}

浏览器查看元素,可以发现这个元素的类名被自动格式化成这样<div class="ArticleList_title__m5rub">React</div>,如果在这个组件引入了其它样式文件,并且有同名的选择器,那么也不怕样式覆盖了。

原子化CSS

简单来说原子CSS就是每个类名对于唯一的CSS规则,通过在HTML中组合类名,而不是修改CSS文件来改变样式。下面使用TailwindCSS来感受下,首先按照官网教程配置好,然后可以删掉之前的文章列表组件的样式文件不用,修改组件:

// 直接使用预先定义好的类名组合
<div className="font-sans">
  {articleList.map(item =>
    <div key={item.id} className="py-3">
      <div className="text-2xl font-semibold">{item.title}</div>
      <div className="space-x-2">
        <span>创建时间:<time title={item.created}>{dayjs().to(dayjs(item.created))}</time></span>
        <span>更新时间:<time title={item.updated}>{dayjs().to(dayjs(item.updated))}</time></span>
      </div>
    </div>
  )}
</div>

此外,如果某个组合样式重复出现,那么也可以使用@apply方法:

.btn {
    @apply py-2 px-4 font-semibold rounded-lg shadow-md;
}
.btn-green {
    @apply text-white bg-green-500 hover:bg-green-700;
}

可以尝试修改类名,通过tailwindcss去美化页面。

其实React中是有像AntDesign这样的美观易用的组件库存在的,但是样式不是这个系列的重点,同时库提供的组件已经预先实现了很多我们要做的需求,学习嘛,还是以手动实现为主。

antd部分组件

Copyright © 2020-2021 公子政的宅日常