一个小时搭建一个全栈 Web 应用框架(下)——美化与功能,web框架, 点击直达前文 >> 【


如果你遵循前面的教程中的步骤,现在应该有了一个可以工作的全栈Web应用程序框架。

点击直达前文 >> 【译】一个小时搭建一个全栈Web应用框架(上)

如果没有,但还是要继续学习本教程,可以到我的GitHub页面下载代码。

对于下一个魔术,我们将把一个显示“Hello World!”的简单静态页面转换成一个漂亮的单页面WEB应用。 这个页面能够与后端通信,并且在收到新信息时立即更新,而无需用户刷新页面。我们即将创建的页面,在每次点击按钮时,会以随机的欧洲语言返回“Hello”。

这是我们的页面:

2372598012-59a77c7d2a7de_articlex

为了能够实现这一点,我们需要先弄清楚以下的问题:

  1. 每次调用 /hello 端点时,如何返回一个随机的欧洲语言“Hello”。
  2. 如何从服务器请求信息。
  3. 如何将返回的信息无缝显示给用户,从而无需刷新页面。
  4. 如何在页面上添加样式,可以在页面上创建一个大的居中的按钮并添加文本。
  5. 最后,我们必须搞清楚应该如何添加一个背景图像。

从服务器返回随机语言的“Hello”

每当我们与服务器上的 /hello 端点进行通话时,为了能够请求一个随机的欧洲语言“Hello”,必须更改 server/server.py 文件中的功能。每次调用它时,都不会返回静态的“Hello World”,而是从“Hello”列表中选择一个随机语言的“Hello”。为了实现这个功能,需要进行以下更改:

Python
import random
def get_hello():
  greeting_list = [‘Ciao’, ‘Hei’, ‘Salut’, ‘Hola’, ‘Hallo’, ‘Hej’]
  return random.choice(greeting_list)

这个函数定义了一个欧洲语言的“hello”列表, 然后我们调用这个函数时,使用 random.choice()从列表中随机选择一个项目。

修改 hello() 函数,以便在每次调用它时返回get_hello()

Python
@app.route("/hello")
def hello():
  return get_hello()

修改 /hello 以返回我们感兴趣的信息,我们现在需要弄清楚如何从前端得到这些信息。

组件化的重要性 – 在 React 中创建一个Hello类

把问题分解被认为是良好的编程习惯。 只要有可能,你应该尽量使自己的函数只做一件事情,并且做好。这点同样适用于类。你可以考虑将每个函数或类都作为单独的组件。

React是为组件化而设计的。这意味着它是用多个较小的部分来构建你的网站的。就像玩乐高一样,可以轻松地将一个组件替换成另外一个,也可以复用组件,这也能帮助其他开发人员了解你的代码。我们应该努力的编写可理解的代码,因为这样可以使我们的程序更容易维护和扩展。

考虑到组件化,我们创建一个 Hello 类来处理我们网页上的问候语。该类将从服务器上的 /hello 端点点获取一个 “Hello” ,并将其显示给用户。 它也应该有一个“name”参数,这样就可以向某个具体的人进行问候。

通过更改 React App 类中的render函数,使其调用Hello类,我们就可以很快的完成功能,而不是使用旧的代码。传递名称“Rimini”作为参数。出于结构化的目的,我们将把Hello类放在一个 PageHeader 中。

创建Hello类

前面我们修改了 App 类使其能够调用 hello 类, 接下来需要创建 Hello 类。在 js/ 目录下创建一个名为 hello.jsx 的文件, 在此文件中定义一个名为 hello 的类。

Python
export default class Hello extends React.Component {
  constructor(props) {
    super(props);
    this.state = {greeting: 'Hello ' + this.props.name};
    // This binding is necessary to make `this` work in the callback    
    this.getPythonHello = this.getPythonHello.bind(this);
  }
}

组件与道具

在这一点上,你可能对构造函数中发生了什么有很多疑问。

在 React 中有一种叫做组件和道具的东西。 Props是创建时传递给构造函数的不可变参数。 道具是公开的,修改他们将违反 React 的基本使用原则。状态是内部的,可变的。每次更新状态时,都会在UI中重新展现。如果希望更深入地了解其运作方式,我强烈建议你阅读React文档中有关生命周期和状态的部分。

我们将在Hello类中添加一个名为personaliseGreeting() 的函数。 当我们点击按钮获得一个新的问候语时,它将会处理网页上的问候语的更新操作。 请注意,我们使用this.setState()与名为“greeting”的key。你必须使用这个语法才能让 React 自动刷新网页上的“greeting”状态。

Python
personaliseGreeting(greeting) {
  this.setState({greeting: greeting + ' ' + this.props.name + '!'});
}

渲染问候语

为了让问候语出现在页面上,必须在render函数中调用“{this.state.greeting}”。我们还必须添加一个带有回调函数的按钮,这个函数叫做getPythonHello(),我们很快就会实现它。这个函数在调用使用Python编写的后端时,将会得到一个新的“Hello”。

Python
render () {
  return (
    <h1>{this.state.greeting}</h1>
    <hr/>
    <Button bsSize="large" bsStyle="danger" onClick={this.getPythonHello}>
      Say Hello!
    </Button>
  )
}

请注意,我已经将标题和按钮HTML内嵌到了我的代码中,所以可以很轻松地控制他们在页面上的最终位置。

绑定“this”

因为JavaScript中的类方法没有做默认绑定,所以当我们想在函数回调中使用“this”时,就必须在构造函数中创建一个绑定。否则“this”将会是 undefined 的。 这适用于在 JavaScript 中调用without() 的情况。一个典型的例子就是 render() 中的 “onClick = {this.getPythonHello}”

从服务器请求信息

React 没有提供执行HTTP请求的内置方式。为了能够从服务器请求信息,我们将不得不找一个可以做这件事的库。 一个最简单的方法就是引入 jQuery 库。jQuery 是一个 javascript 库,通过在$符号后面提供缩写函数来简化标准的 JavaScript 功能。

首先安装jQuery依赖关系:

Python
$ npm i jquery --save-dev

将 jQuery 依赖添加到要使用的 React 文件中,也就是 Hello.jsx 中。应该将此依赖添加到 Hello 类的定义前面。

Python
var $ = require(‘jquery’);

将查询依赖添加到React文件中意味着可以在自己的React代码中使用标准的 jQuery 函数,只要它们以我们刚刚定义的“$”变量开始。下面让我们用它来从服务器获取一个“Hello”。

我们将使用 HTTP 协议的 GET 请求获取信息。GET 实质上是HTTP请求的“只读”模式。可以用来获取信息,但是不能要求服务器更改它。

在 hello.jsx 文件中的Hello类中添加以下函数:

Python
getPythonHello() {
  $.get(window.location.href + 'hello', (data) => {  
    console.log(data);
    this.personaliseGreeting(data);
  });
}

此函数通过jQuery 的 GET请求,连接 /hello 端点。然后得到从服务器返回的一个欧洲语言的“hello”信息,再它打印到浏览器的开发控制台,最后将它传递给Hello类中的另一个函数,调用 personaliseGreeting()

当 rebuild 前端代码(npm run watch),并重新启动 python 服务器后。 应该能看到以下内容:

2372598012-59a77c7d2a7de_articlex

 

有一行问候语,一个按钮,点击按钮可以更改问候语。 这个页面看起来很不错,因为我们在index.html中包含了Bootstrap样式。

使用CSS样式美化页面

我们终于有了一个能够与用户交互的产品。如果我们愿意,就可以到此为止了,并对自己说:我对这些成就感到满意。不过就我个人而言,我更喜欢在我的Web应用中添加一些设计元素,让他们变得更加漂亮。所以,我们将用CSS使标题能够覆盖整个屏幕,而不是在页面的顶部。CSS是为HTML设计的一种样式语言,它的作用相当于在Word文档中更改字体大小,样式和位置。

使 Webpack 能够处理 CSS

为了能够在我们的WEB应用中使用CSS,必须安装一些加载器和插件,并将它们添加到Webpack配置文件中。这是因为 Webpack 默认只能处理JavaScript。

安装下列插件:

  • css-loader
  • style-loader
  • extract-text-webpack-plugin

css-loader 和 style-loader 能够使 Webpack 处理 CSS。 通过添加这些加载器,Webpack 将能够将我们需要的任何 CSS 绑定到 bundle.js 中。 不过在这里存在一个问题,JavaScript 和 CSS 将不会在你的页面上单独进行加载,这可能导致 UI 组件在 JavaScript 加载之前无法显示。这点很差劲,因为在糟糕的网络上,我们辛辛苦苦设计出来的页面可能会加载的非常缓慢。

不过可以通过添加 extract-text-webpack-plugin 来解决这个问题。 这个插件能够将 CSS 分解成一个单独的包,我们可以把它附加到 HTML 上。 这样就可以使 CSS 再次独立于 JavaScript 进行加载。

在你的webpack.config.js文件的 modules.rules 部分添加下面的CSS规则:

Python
{
  test: /\.css$/,
  use: ExtractTextPlugin.extract({
         fallback: 'style-loader',
         use: 'css-loader',
       })
},

将ExtractTextPlugin插件添加到 webpack.config.js(如果您感到困惑,请查看我的 webpack 文件)。注意,在创建时,需要将捆绑的CSS文件名传给此插件。我们将调用文件’styles.css’。

Python
plugins: [ new ExtractTextPlugin('styles.css') ]

最后,我们需要将 styles.css 包添加到index.html中,以确保样式被加载。将以下行添加到你的index.html文件中的 head 部分(可以参考我的代码):

<link rel="stylesheet" href="dist/styles.css">

添加CSS规则

现在可以确保我们的设置可以正确处理CSS了,我们将在css文件夹中创建一个名为fullstack.css 的文件。我已经添加了几个不同的规则,以确保文本和按钮出现在正确的位置,并且文本是大号的细体。

这是我的 fullstack.css 文件中的一个规则。 它使 “Hello Rimini” 文本变得越来越细:

Python
.header-contents h1 { 
    font-size: 120px; 
    font-weight: 300;
}

在创建 fullstack.css 文件之后,我们需要将它添加到使用规则的 React 组件中,这样它们才能生效。由于标题在 App.jsx 中定义,所以需要添加以下代码:

Python
require('../css/fullstack.css');

fullstack.css 文件中的标题样式现在将由 Webpack 拾取,并绑定到 styles.css 文件中。当我们刷新页面时,应该如下图所示。注意,如果你用的浏览器不是 Chrome 的话,字体可能和图中不一样:

2372598012-59a77c7d2a7de_articlex

 

被CSS装饰后的页面

完成 – 添加背景图

Webpack 本身并不理解图像的概念。因此,我们还需要添加一个可以在Web应用程序中使用它们的加载程序。我们需要安装名为“file-loader”的loader。

安装 file-loader:

Python
$ npm i file-loader --save-dev

将file-loader规则添加到 webpack.config.js 文件中的modules.rules部分:

Python
{
  test: /\.(png|svg|jpg|gif)$/,
  use: 'file-loader'
}

将要使用的图像添加到images/ folder。将其命名为“header.jpg”。

为了能够使图像成为网页头部的背景,我们需要将其作为背景图像添加到 fullstack.css 文件的页眉部分。

Python
.page-header {
  background-image: url('../images/header.jpg');
  background-repeat: no-repeat;
  background-position: center;
  background-size: cover;
}

接下来要做的是把图像加载到使用它的 React 文件中。如果没有在 React 中显式加载图片,Webpack 将不会棒的它,也不会把它显示在页面上。这种行为不是很直观,在我第一次在自己的应用中添加一个背景图像时,曾经犯过这个错误。

在App.jsx中进行如下更改:

Python
import HeaderBackgroundImage from '../images/header.jpg';

将此函数添加到你的App类:

Python
addHeaderImg() {
  let headerBg = new Image();
  headerBg.src = HeaderBackgroundImage;
}

这个函数创建了一个新的Image对象,并将源设置为你的标题图片。

我们需要做的最后一件事是,确保在渲染页面时加载图像。 这意味着我们必须在render()函数中调用 addHeaderImg()函数。

将下列代码添加到render()函数中:

Python
{this.addHeaderImg()}

刷新浏览器窗口时,应该看到以下内容:

2372598012-59a77c7d2a7de_articlex

恭喜你!你已成功创建了一个全栈 Web 应用程序!

评论关闭