Next.js新手教程

Next.js 是一个轻量级的 React 服务端渲染应用框架。本教程演示使用Next.js制作一个显示比特币汇率的网站。详细的Next.js信息请访问https://nextjs.org/

安装

本文假设你使用的是windows操作系统,已经安装npm。npm的安装方法,请自行bing搜索。

我使用的是visual studio code环境。命令行在该环境的terminal下输入、运行。当然你也可以使用其它环境如windows自带的powershell,使用写字板编辑代码。

新建一个名为BitzPrice目录,并进入该目录。

C:\Users\HP\projects>mkdir bitzprice
C:\Users\HP\projects>cd bitzprice

查看npm版本,确认你已经安装:

PS C:\Users\HP\projects\bitzprices> npm --version
6.12.1

初始化:

PS C:\Users\HP\projects\bitzprices> npm init -y
Wrote to C:\Users\HP\projects\bitzprices\package.json:

{
  "name": "bitzprices",
  "version": "1.0.0",
  "description": "",
  "main": "index.js",
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1"
  },
  "keywords": [],
  "author": "",
  "license": "ISC"
}

安装next、react和react-dom。某国访问境外网站非常慢,建议使用国内镜像加速,当然也可以不用。

PS C:\Users\HP\projects\bitzprices> npm config set registry https://registry.npm.taobao.org
PS C:\Users\HP\projects\bitzprices> npm install next react react-dom
npm WARN deprecated core-js@2.6.10: core-js@<3.0 is no longer maintained and not recommended for usage due to the number of issues. Please, upgrade your dependencies to the actual
version of core-js@3.
npm WARN deprecated fsevents@1.2.9: One of your dependencies needs to upgrade to fsevents
v2: 1) Proper nodejs v10+ support 2) No more fetching binaries from AWS, smaller package size
...
+ react-dom@16.12.0
+ react@16.12.0
+ next@9.1.4
added 760 packages from 356 contributors in 70.692s

修改package.json

现在目录下应该有package.json文件了。修改这个文件,将scripts部分修改为:

"scripts": {
    "dev": "next",
    "build": "next build",
    "start": "next start"
  },

建立index页面

新建pages目录放置页面,在pages目录中新建Index.js文件,输入以下内容:

export default () => (<div>Hello Next.js</div>)

运行服务器

terminal输入:

C:\Users\Administrator\projects\bitzprice> npm run dev
> bitzprices@1.0.0 dev C:\Users\HP\projects\bitzprices
> next

[ wait ]  starting the development server ...
[ info ]  waiting on http://localhost:3000 ...
[ ready ] compiled successfully - ready on http://localhost:3000

现在浏览器访问http://localhost:3000,应该可以看到以下画面:

index.js

新建about页面

pages中新建文件About.js,输入以下内容:

export default () => (<div>About BitzPrices</div>)

在浏览器输入http://localhost:3000/about,会看到以下内容:

about.js

让代码更React化

Index.js修改成下面的样子:

const Index = () => (
    <div>
        <h1>Hello BitzPrices</h1>
    </div>
);

export default Index;

现在访问页面,应该是这样:

index

About.js也做类似修改:

const About = () => (
    <div>
        <h1>About BitzPrices</h1>
        <p>查看比特币汇率的应用。</p>
    </div>
);

export default About;

About页面:


about

添加导航

我们使用nextLink作为导航。修改Index.js,内容如下:

import Link from 'next/link';

const Index = () => (
    <div>
        <ul>
            <li><Link href="/"><a>主页</a></Link></li>
            <li><Link href="/about"><a>关于</a></Link></li>
        </ul>
        <h1>Hello BitzPrices</h1>
    </div>
);

export default Index;

修改About.js内容如下:

import Link from 'next/link';

const About = () => (
    <div>
        <ul>
            <li><Link href="/"><a>主页</a></Link></li>
            <li><Link href="/about"><a>关于</a></Link></li>
        </ul>
        <h1>关于BitzPrices</h1>
        <p>查看比特币汇率的应用。</p>
    </div>
);

export default About;

刷新浏览器页面,应该能够使用导航了。

about

将导航栏放入部件中

如果要创建多个页面,每个页面中都输入相同的代码显然太麻烦。我们可以将导航栏放入单独的部件,使用导航的页面只需要引入这个部件。

bitzprices目录下新建components目录,在这个目录中新建Navbar.js文件,内容如下:

import Link from 'next/link';

const Navbar = () => (
    <ul>
        <li><Link href="/"><a>主页</a></Link></li>
        <li><Link href="/about"><a>关于</a></Link></li>
    </ul>
);

export default Navbar;

Index.js现在只需要引入Navbar部件并使用它:

import Navbar from '../components/Navbar';

const Index = () => (
    <div>
        <Navbar />
        <h1>欢迎访问 BitzPrices</h1>
    </div>
);

export default Index;

About.js也做相同修改。

使用样式表

我们在Navbar.js中展示样式表的使用,在文件中添加样式表,代码如下:

import Link from 'next/link';

const Navbar = () => (
    <div>
        <ul>
            <li><Link href="/"><a>主页</a></Link></li>
            <li><Link href="/about"><a>关于</a></Link></li>
        </ul>

        <style jsx>{`
            ul {
                background: #333;
                color: #fff;
                list-style: none;
                display: flex;
            }

            ul li {
                font-size: 18px;
                margin: 20px 20px 20px;
            }

            ul li a{
                color: #fff;
                text-decoration: none;
            }
        `}</style>
    </div>
);

export default Navbar;

现在的页面如下:

index

这个样式表只对Navbar这个部件有效,不影响其它地方的<ul>

使用布局

components目录下新建Layout.js文件,内容如下:

import Navbar from './Navbar';

const Layout = (props) => (
    <div>
        <Navbar />
        {props.children}
    </div>
);

export default Layout;

我们对Index.js做如下修改:

import Layout from '../components/Layout';

const Index = () => (
    <Layout>
        <div>
            <h1>欢迎访问 BitzPrices</h1>
        </div>
    </Layout>
);

export default Index;

About.js的修改也一样:

import Layout from '../components/Layout';

const About = () => (
    <Layout>
        <div>
            <h1>关于BitzPrices</h1>
            <p>查看比特币汇率的应用。</p>
        </div>
    </Layout>
);

export default About;

页面不会有任何变化,但我们现在已经使用布局了。

添加页面标题及样式表引用

修改Layout.js,引入Head,在Head中添加页面标题和样式表的引用(我们使用bootswatchcerulean样式)。Layout.js的内容:

import Head from 'next/head';
import Navbar from './Navbar';

const Layout = (props) => (
    <div>
        <Head>
            <title>BitzPrices</title>
            <link rel="stylesheet"
            href="https://bootswatch.com/4/cerulean/bootstrap.min.css" />
        </Head>
        <Navbar />
        {props.children}
    </div>
);

export default Layout;

刷新页面,


index

我们看到页面正文部分样式改变了,导航部分没有变。这是因为我们在Navbar.js中使用了样式表。为了应用cerulean样式,我们用ceruleanNavbar的源码代替Navbar.js的内容,注意要将所有的class=替换为className=,导航菜单内容及链接地址也做修改:

const Navbar = () => (
    <nav className="navbar navbar-expand-lg navbar-dark bg-dark">
        <a className="navbar-brand" href="/">BitzPrices</a>
        <button className="navbar-toggler" type="button" data-toggle="collapse" data-target="#navbarColor02" aria-controls="navbarColor02" aria-expanded="false" aria-label="Toggle navigation">
            <span className="navbar-toggler-icon"></span>
        </button>

        <div className="collapse navbar-collapse" id="navbarColor02">
            <ul className="navbar-nav mr-auto">
                <li className="nav-item active">
                    <a className="nav-link" href="/">主页<span className="sr-only">(current)</span></a>
                </li>
                <li className="nav-item">
                    <a className="nav-link" href="/about">关于</a>
                </li>
            </ul>
            <form className="form-inline my-2 my-lg-0">
                <input className="form-control mr-sm-2" type="text" placeholder="Search"/>
                <button className="btn btn-secondary my-2 my-sm-0" type="submit">Search</button>`
            </form>
        </div>
    </nav>
);

export default Navbar;

将页面内容放入容器

修改Layout.js,将{props.children}放入div中:

        <div className="container">
            {props.children}
        </div>

通过API获取数据

我们要获取的数据来自https://www.coindesk.com/,地址为https://api.coindesk.com/v1/bpi/currentprice.json,通过这个地址获取的json数据为:

{
"time":{
"updated":"Dec 8, 2019 02:06:00 UTC",
"updatedISO":"2019-12-08T02:06:00+00:00",
"updateduk":"Dec 8, 2019 at 02:06 GMT"
},
"disclaimer":"This data was produced from the CoinDesk Bitcoin Price Index (USD). Non-USD currency data converted using hourly conversion rate from openexchangerates.org",
"chartName":"Bitcoin",
"bpi":{
"USD":{"code":"USD","symbol":"&#36;","rate":"7,454.3000","description":"United States Dollar","rate_float":7454.3},
"GBP":{"code":"GBP","symbol":"&pound;","rate":"5,674.7126","description":"British Pound Sterling","rate_float":5674.7126},
"EUR":{"code":"EUR","symbol":"&euro;","rate":"6,740.6328","description":"Euro","rate_float":6740.6328}
}
}

获取数据,我们需要用到isomorphic-unfetch。安装:

PS C:\Users\HP\projects\bitzprices> npm install isomorphic-unfetch

修改Index.js如下:

import Fetch from 'isomorphic-unfetch';
import Layout from '../components/Layout';

const Index = (props) => (
    <Layout>
        <div>
            <h1>欢迎访问 BitzPrices</h1>
            {props.bpi.time.updated}
        </div>
    </Layout>
);

Index.getInitialProps = async function() {
    const res = await Fetch(
        'https://api.coindesk.com/v1/bpi/currentprice.json'
    );
    const data = await res.json();
    return {
        bpi: data
    }
} 

export default Index;

刷新页面:


index

将Prices放入单独的部件

components目录下,新建Prices.js文件,内容如下:

class Prices extends React.Component {
    state = {
        currency: 'USD'
    }

    render() {
        return (<div>
            Prices
        </div>);
    }
}

export default Prices;

修改Index.js内容,

...
const Index = (props) => (
    <Layout>
        <div>
            <h1>欢迎访问 BitzPrices</h1>
            <Prices bpi={props.bpi} />
        </div>
    </Layout>
);
...

现在主页应该是这样:


index

显示汇率

修改Index.js内容:

import Fetch from 'isomorphic-unfetch';
import Layout from '../components/Layout';

import Prices from '../components/Prices';

const Index = (props) => (
    <Layout>
        <div>
            <h1>欢迎访问 BitzPrices</h1>
            <p>当前的比特币汇率:</p>
            <Prices bpi={props.bpi} />
        </div>
    </Layout>
);

Index.getInitialProps = async function() {
    const res = await Fetch(
        'https://api.coindesk.com/v1/bpi/currentprice.json'
    );
    const data = await res.json();
    return {
        bpi: data
    }
} 

export default Index;

修改Prices.js内容:

class Prices extends React.Component {
    state = {
        currency: 'USD'
    }

    render() {
        return (<div>
            <ul className="list-group">
                <li className="list-group-item">
                    Bitcoin rate for {this.props.bpi.bpi.USD.description}:<span className="badge badge-primary">{this.props.bpi.bpi.USD.code}</span><strong>{this.props.bpi.bpi.USD.rate}</strong>
                </li>
            </ul>
        </div>);
    }
}

export default Prices;

刷新页面:


index

获取其它币种汇率

修改Prices.js,增加获取其它币种的数据:

class Prices extends React.Component {
    state = {
        currency: 'EUR'
    }

    render() {
        let list = '';

        if (this.state.currency === 'USD') {
            list = <li className="list-group-item"> Bitcoin rate for {this.props.bpi.bpi.USD.description}:<span className="badge badge-primary">{this.props.bpi.bpi.USD.code}</span><strong>{this.props.bpi.bpi.USD.rate}</strong></li>
        } else if (this.state.currency === 'GBP') {
            list = <li className="list-group-item"> Bitcoin rate for {this.props.bpi.bpi.GBP.description}:<span className="badge badge-primary">{this.props.bpi.bpi.GBP.code}</span><strong>{this.props.bpi.bpi.GBP.rate}</strong></li>
        } else if (this.state.currency === 'EUR') {
            list = <li className="list-group-item"> Bitcoin rate for {this.props.bpi.bpi.EUR.description}:<span className="badge badge-primary">{this.props.bpi.bpi.EUR.code}</span><strong>{this.props.bpi.bpi.EUR.rate}</strong></li>
        }

        return (<div>
            <ul className="list-group">
                {list}
            </ul>
        </div>);
    }
}

export default Prices;

现在,因为currency的值为EUR,刷新页面,应该能够看到如下画面:

index

动态选择要查询的币种

修改Prices.js

class Prices extends React.Component {
    state = {
        currency: 'USD'
    }

    render() {
        let list = '';

        if (this.state.currency === 'USD') {
            list = <li className="list-group-item"> Bitcoin rate for {this.props.bpi.bpi.USD.description}:<span className="badge badge-primary">{this.props.bpi.bpi.USD.code}</span><strong>{this.props.bpi.bpi.USD.rate}</strong></li>
        } else if (this.state.currency === 'GBP') {
            list = <li className="list-group-item"> Bitcoin rate for {this.props.bpi.bpi.GBP.description}:<span className="badge badge-primary">{this.props.bpi.bpi.GBP.code}</span><strong>{this.props.bpi.bpi.GBP.rate}</strong></li>
        } else if (this.state.currency === 'EUR') {
            list = <li className="list-group-item"> Bitcoin rate for {this.props.bpi.bpi.EUR.description}:<span className="badge badge-primary">{this.props.bpi.bpi.EUR.code}</span><strong>{this.props.bpi.bpi.EUR.rate}</strong></li>
        }

        return (<div>
            <select onChange={e => this.setState({currency: e.target.value})} className="form-control">
                <option value="USD">USD</option>
                <option value="GBP">GBP</option>
                <option value="EUR">EUR</option>
            </select>
            <ul className="list-group">
                {list}
            </ul>
            <br/>
        </div>);
    }
}

export default Prices;

现在可以选择要查询的币种了:

index

本文章内容参考了Traversy Media在Youtube上的视频

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 204,293评论 6 478
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,604评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,958评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,729评论 1 277
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,719评论 5 366
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,630评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,000评论 3 397
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,665评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,909评论 1 299
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,646评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,726评论 1 330
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,400评论 4 321
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,986评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,959评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,197评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 44,996评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,481评论 2 342

推荐阅读更多精彩内容