Nextjs之page router实战记录

动态表单

初始化必须给{}赋值表单的name与值，否则会报不受控（即使是遍历出来的表单）

动态样式

方案一：CSS Module + classnames

  import classNames from 'classnames'
  function Render () {  
    return (
        <div className={
          classNames(
            ProgressStyles.fragment, {
              [ProgressStyles.fragmentActive]: idx <= activeIndex
            }
          )
        } key={idx}>{idx}</div>
    )
}

Notes: CSS Modules不支持连字符、下划线衔接。

.fragment {
  background: rgba(0, 0, 0, 0.06);
  flex: 1;

  & + & {
    margin: {
      left: 10px;
    };
  }

  &Active {
    background: #0F68FF;
  }
}

方案二：样式渗透

:global

  :global {
    .ant-select-selector {
      border: 1px solid #E5E5E5;
      background: linear-gradient(125.85deg, rgba(59, 63, 238, 0.1) 0%, rgba(57, 159, 254, 0.1) 100%);
      @media screen and (min-width: 550px) {
        height: nth($lineHeight, 1)!important;
        line-height: nth($lineHeight, 1)!important;
      }
      @media screen and (max-width: 550px) {
        height: nth($lineHeight, 2)!important;
        line-height: nth($lineHeight, 2)!important;
      }
    }
    .ant-select-selection-placeholder {
      @include placeholder;
    }
  }
  :global(.swiper-slide) {
    cursor: pointer;
  }

组件定义

Slot定义

SwiperCommon组件的调用，需要用SwiperCommon内部遍历的列表项数据：

export default function Render () {
  return (
    <SwiperCommon className="newsSwiper" metas={data.list} options={}>
        {
          (meta) => (
            <section className={NewsStyles.swiperSlide} onClick={() => handleClick(meta.id)}>
              <div className={NewsStyles.coverWrapper}>
                <Image alt={meta.title} src={meta.cover} className={NewsStyles.img}/>
              </div>
              <p className={NewsStyles.slideTitle}>{meta.title}</p>
              <p className={NewsStyles.summary}>{meta.summary}</p>
              <p className={NewsStyles.date}>{meta.time}</p>
            </section>
          )
        }
      </SwiperCommon>
  )
}

ScopedSlot定义：

import { useEffect } from 'react';
import SwiperCommonStyles from '@/styles/swiper-common.module.scss'
function SwiperCommon ({ children, metas = [], className: externalClass, options = {}}) {
  useEffect(() => {
    const swiper = new Swiper(`.${externalClass || 'swiper'}`, {
      direction: 'horizontal',
      centerInsufficientSlides: true,
      ...options
    });
  }, [externalClass, options])
  return (
    <>
      {
        metas.length && (
          <div className={classNames(SwiperCommonStyles.swiper, `swiper ${externalClass}`)}>
            <div className={classNames(SwiperCommonStyles.swiperWrapper, 'swiper-wrapper')}>
              {
                metas.map((item, idx) => (
                  <div key={idx} className={classNames(SwiperCommonStyles.swiperSlide, 'swiper-slide')}>
                    {children && children(item)}
                  </div>
                ))
              }
            </div>
          </div>
        )
      }
    </>
  )
}
export default SwiperCommon

参数解构

  <!--闭合标签使用时，组件参数类型声明中包含children-->
  <NavigationBar
    title="This is title"
  >
  </NavigationBar>
  <!--空标签使用时，组件参数类型声明中不包含children-->
  <NavigationBar
    title="This is title"
  />

组件的参数解构：

import NavigationBarStyles from "../styles/navigationbar.module.scss"
function Navigationbar ({ children, title = "", historyBack = false }) {
  return (
    <div className={NavigationBarStyles.container}>
      {historyBack && (<div className={NavigationBarStyles.historyBack}>&lt;</div>)}
      <NavigationbarContent title={title}>{children}</NavigationbarContent>
    </div>
  )
}
export default Navigationbar

Notes:

  • <NavigationBar />形式调用组件，解构出来的children为undefined
  • <NavigationBar></NavigationBar> 形式调用组件，即使子节点为空，也能解构出来的children为[]

全局SCSS变量配置

https://stackoverflow.com/questions/60951575/next-js-using-sass-variables-from-global-scss

const path = require('path');
const nextConfig = (phase, { defaultConfig }) => {
  if ('sassOptions' in defaultConfig) {
    defaultConfig['sassOptions'] = {
      includePaths: [path.join(__dirname, 'styles')],
      prependData: `@import "utils.scss";`,
    };
  }
  return defaultConfig;
};
module.exports = nextConfig;

全局可访问变量

在根目录下定义.env、.env.development、.env.production、.env.local文件

Node环境

HOSTNAME=localhost
PORT=8080
HOST=http://$HOSTNAME:$PORT

Notes:

  • 以上变量在Node环境中可通过process.env.HOSTNAME形式获取，无法在浏览器中获取；
  • 可以通过$Variable的形式，在另一个变量定义中引用其他变量

Browser环境

NEXT_PUBLIC_API_BASEURL=http://127.0.0.1:3000

Notes:

  • 以上变量可以在Node、Browser环境中可通过process.env.NEXT_PUBLIC_API_BASEURL形式获取
  • 以NEXT_PUBLIC_ 前缀定义变量可以暴露在浏览器环境；

限制

  • 只能通过process.env.VarName的形式访问，无法通过解构、[变量]形式访问
    • process.env[varName] ——> Error
    • const env = process.env ——> Error

类型声明

https://dmitripavlutin.com/typescript-react-components/

https://github.com/DefinitelyTyped/DefinitelyTyped/blob/master/types/react/index.d.ts

图片渲染

Nextjs图片渲染官方文档

  • 使用'next/image'提供的组件，会提供图片优化 — 懒加载
  • 使用'next/image'提供的组件，必须设定图片尺寸，图片尺寸若要根据父级尺寸，需设置父元素position: relative，<Image layout="fill"... — 此时生成的img标签是绝对定位的。
import Image from 'next/image';
import welcomeStyles from '../styles/welcome.module.scss';

export default function Home() {
  return (
    <>
      <section className={welcomeStyles.navigationbar}>
        <h1 className='navigationbar-title'>new world</h1>
      </section>
      <section className={welcomeStyles.main}>
        <h2 className={welcomeStyles.title}>Welcome new world！</h2> 
        <div className={welcomeStyles.cover}>
          <Image layout="fill" objectFit="cover" src="/images/entries/wel.png" alt="" />
        </div>
      </section>
    </>
  );
}

客户端渲染

  useEffect(() => {
    import("../lib/flexible");
    import("../lib/flexibleHelper");
  }, []);

api Route

api定义

范指/pages/api/**/*.js路径下的文件，该处主要是转接服务端接口，中转前端数据结构。

//  /pages/api/blog
export default function handler(req, res) { // 导出的函数方法名无实际意义
  res.status(200).json({ name: 'John Doe' })
}

Notes: 该JavaScript是服务端代码，而非H5前端代码；

api访问

export async function getStaticProps(context) {
  const res = await fetch(`${process.env.BaseUrl}/api/blog`)
  const features = await res.json()
  return {
    props: {
      features,
    },
  }
}
export default function Blog ({features}) {
  const features = response
  return (
    <>
      <News meta={features.NewsResponse} />
    </>
  )
}

Notes:

  • 前端必须通过http(s)协议请求，所以，必须启动服务才可以访问Api Route
  • getStaticProps只能在Pages下调用，在componets中调用无效

导出纯静态页面

导出不需要服务配置，可独立访问的HTML静态页面（注意：SSG也是需要服务端配置的）

  1. 示例中的Nextjs在13.3(不含)以下版本：13.2.4
  2. 页面内的数据都是本地Mock的JSON数据
  3. 修改next.config.js配置：
const nextConfig = (phase, {defaultConfig}) => {
  defaultConfig.reactStrictMode = true
  defaultConfig.exportPathMap = async function (defaultPathMap) {
    return {
      '/': { page: '/' },
      '/news': { page: '/news' },
      '/blog': { page: '/blog' },
    }
  }
  defaultConfig.images.unoptimized = true
  return defaultConfig
}

module.exports = nextConfig
  • 配置exportPathMap字段，官网文档声明13.3版本以上会自动生成，无需配置
  • 配置images.unoptimized = true，不允许优化图片，否则会报错
  1. 补充package#scripts，运行npm run export 
  "scripts": {
    "dev": "next dev",
    "build": "next build",
    "export": "next build && next export && npm run build-static-repair-index && npm run build-favicon-repair-index && npm run build-logo-repair-index",
    "build-static-repair-index": "replace-in-files --string \"/_next/static\" --replacement \"/_next/static\" out/index.html",
    "build-favicon-repair-index": "replace-in-files --string \"/favicon.ico\" --replacement \"./favicon.ico\" out/*.html",
    "build-logo-repair-index": "replace-in-files --string \"/logo*.png\" --replacement \"./logo*.png\" out/*.html",
    "start": "next start",
    "lint": "next lint"
  },
  • 静态打包后的资源引用地址不对，目前没找到配置项可用，需借助于replace-in-files单独处理资源引用。
  1. 将/out中的静态资源部署即可
最后编辑于 ：
©著作权归作者所有,转载或内容合作请联系作者
  • 人面猴
    序言：七十年代末，一起剥皮案震惊了整个滨河市，随后出现的几起案子，更是在滨河造成了极大的恐慌，老刑警刘岩，带你破解...
    沈念sama阅读 205,132评论 6赞 478
  • 死咒
    序言：滨河连续发生了三起死亡事件，死亡现场离奇诡异，居然都是意外死亡，警方通过查阅死者的电脑和手机，发现死者居然都...
    沈念sama阅读 87,802评论 2赞 381
  • 救了他两次的神仙让他今天三更去死
    文/潘晓璐 我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事。” “怎么了？”我有些...
    开封第一讲书人阅读 151,566评论 0赞 338
  • 道士缉凶录：失踪的卖姜人
    文/不坏的土叔 我叫张陵，是天一观的道长。 经常有香客问我，道长，这世上最难降的妖魔是什么？ 我笑而不...
    开封第一讲书人阅读 54,858评论 1赞 277
  • 港岛之恋（遗憾婚礼）
    正文 为了忘掉前任，我火速办了婚礼，结果婚礼上，老公的妹妹穿的比我还像新娘。我一直安慰自己，他们只是感情好，可当我...
    茶点故事阅读 63,867评论 5赞 368
  • 恶毒庶女顶嫁案：这布局不是一般人想出来的
    文/花漫 我一把揭开白布。 她就那样静静地躺着，像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上，一...
    开封第一讲书人阅读 48,695评论 1赞 282
  • 城市分裂传说
    那天，我揣着相机与录音，去河边找鬼。 笑死，一个胖子当着我的面吹牛，可吹牛的内容都是我干的。 我是一名探鬼主播，决...
    沈念sama阅读 38,064评论 3赞 399
  • 双鸳鸯连环套：你想象不到人心有多黑
    文/苍兰香墨 我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
    开封第一讲书人阅读 36,705评论 0赞 258
  • 万荣杀人案实录
    序言：老挝万荣一对情侣失踪，失踪者是张志新（化名）和其女友刘颖，没想到半个月后，有当地人在树林里发现了一具尸体，经...
    沈念sama阅读 42,915评论 1赞 300
  • 护林员之死
    正文 独居荒郊野岭守林人离奇死亡，尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,677评论 2赞 323
  • 白月光启示录
    正文 我和宋清朗相恋三年，在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,796评论 1赞 333
  • 活死人
    序言：一个原本活蹦乱跳的男人离奇死亡，死状恐怖，灵堂内的尸体忽然破棺而出，到底是诈尸还是另有隐情，我是刑警宁泽，带...
    沈念sama阅读 33,432评论 4赞 322
  • 日本核电站爆炸内幕
    正文 年R本政府宣布，位于F岛的核电站，受9级特大地震影响，放射性物质发生泄漏。R本人自食恶果不足惜，却给世界环境...
    茶点故事阅读 39,041评论 3赞 307
  • 男人毒药：我在死后第九天来索命
    文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹，春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,992评论 0赞 19
  • 一桩弑父案，背后竟有这般阴谋
    文/苍兰香墨 我抬头看了看天上的太阳。三九已至，却和暖如春，着一层夹袄步出监牢的瞬间，已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,223评论 1赞 260
  • 情欲美人皮
    我被黑心中介骗来泰国打工， 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留，地道东北人。 一个月前我还...
    沈念sama阅读 45,185评论 2赞 352
  • 代替公主和亲
    正文 我出身青楼，却偏偏与公主长得像，于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子，可洞房花烛夜当晚...
    茶点故事阅读 42,535评论 2赞 343

推荐阅读更多精彩内容