全栈开发—博客前端展示(Nuxt.js)

个人博客开发系列文章:

全栈开发—博客前端展示(Nuxt.js)

这个开发的想法是这样来的,大概两个月前,腾讯云的工作人员打电话给我,说我的域名没有解析到腾讯云的服务器上,而且页脚也没有备案号。我当时就震惊了,居然会打电话给我,然而我的大学时代买的服务器已经过期了...于是为了拯救我的域名,拯救我申请了很久的备案号,决意要全栈打造一个属于自己的博客系统。

主要技术

  • Nuxt.js
  • Axios
  • marked + highlight.js
  • scss

项目特点

  • 适配多个分辨率,移动端到桌面端无缝切换
  • 支持白昼黑夜主题切换(试试点击shirmy的太阳或月亮)
  • 文章图片懒加载
  • 评论、留言、搜索、点赞、多个作者
  • SSR服务端渲染(seo)

技术总结

什么是服务端渲染(server side render)?

服务端渲染则把Ajax请求放到服务端,页面加载到浏览器或客户端前就已经把数据填充到页面模板行程完整的页面。

优势

  • 减少首次http请求,在服务端请求首屏数据,直接渲染html
  • 利于SEO,网络爬虫可以抓取到完整的页面信息

劣势

  • 服务端压力大
  • 需要掌握从前端到服务端的开发(多学点不好吗?)

什么是客户端渲染(client side render)?

客户端渲染就是就是在客户端通过Ajax请求获取数据,然后在客户端生成DOM插入到html

优势

  • 前后端分离,各司其职
  • 局部刷新,无需重新刷新页面
  • 服务器压力小
  • 更好的实现各种前端效果

劣势

  • 首屏渲染慢,需要下载JSCSS文件
  • 不利于SEO,爬虫抓取不到完整的页面数据

SSR vs CSR

门户网站、博客网站等需要SEO优化的网站使用服务端渲染,管理后台等内部系统或不需要SEO优化的网站使用客户端渲染

对比图

服务端渲染
前端渲染

如何实现白昼黑夜主题切换?

在这里,要使用CSS3变量配合scss进行控制,通过控制<body>标签的id来约束白昼或黑夜的颜色值,再给相应的属性加上transition属性实现颜色切换时的过渡,请看下面的示例:

@mixin theme(
  $theme-primary
) {
  --theme-primary: #{$theme-primary}
}

body {
  &#light {
    @include theme(
      #theme-primary: #fff,
    )
  }

  &#dark {
    @include theme(
      #theme-primary: #000,
    )
  }
}

全局引入上面的scss文件,这样就可以直接通过设置<body>标签的id的值为darklight--theme-primary赋予不同的颜色值,此时就能直接在需要应用该颜色的元素上进行如下设置:

.example-class {
  color: var(--theme-primary);
}

在我的博客shirmy中点击月亮/太阳即可看到效果,亦可用同样的方式定义多套主题色。

切换页面改变页面title

Nuxt内置了head属性配置,head配置直接修改根目录下的nuxt.config.js文件就可以了,并且还内置vue-meta插件,因此想要在不同页面改变相应的title,请看以下做法:

// nuxt.config.js
module.exports = {
  head: {
    // 组件中的 head() 方法返回的字符串会替换 %s
    titleTemplate: '%s | shirmy',
  }
}

// 文章详情页 pages/article/_id.vue
export default {
  head() {
    return {
      title: this.article.title
    }
  }
}

如此一来,当查看某篇文章详情的时候就会触发head()方法,title显示为article title | shirmy

切换页面让页面滚动保持在顶部

只要修改nuxt.config.js配置即可,并且可以根据传入的参数做一些自定义的配置。

// nuxt.config.js
module.exports = {
  router: {
    scrollBehavior: function (to, from, savedPosition) {
      return { x: 0, y: 0 }
    }
  },
}

Nuxt中的fetch()

fetch()Nuxt中独有的方法,它会在组件初始化前被调用,因此无法通过this获取组件对象。比如进入首页或从首页切换到归档页,在进入页面前会先执行fetch()方法,为了异步获取数据,fetch()方法必须返回Promise,因此可以直接返回一个Promise或者使用async await(async await其本质就是返回Promise)。

该方法不会设置组件的数据,如果想要设置组件的数据,或者使用context上下文,可以使用asyncData

export default {
  // 虽然无法通过 this.$nuxt.$route 获取路由参数,但是可以通过 params 来获取
  async fetch({ store, params }) {
    await store.dispatch('about/getAuthor', params.id)
    await store.dispatch('about/getArticles', {
      authorId: params.id,
      page: 0
    })
  }
}

这样就能确保内容已经渲染好再下载到浏览器,如果使用mounted等生命周期钩子,则是在页面下载到浏览器后再获取数据,起不到SSR服务端渲染的效果。

style-resource

为了方便统一管理scss变量,通常会在目录中创建variables.scssmixin.scss,但是我们写的vue文件这么多,如果都要一个个导入岂不是吃力不讨好,这时可以借助style-resource

npm install -S @nuxtjs/style-resources

修改nuxt.config.js文件:

// nuxt.config.js
module.exports = {
  styleResources: {
    scss: ['./assets/scss/variables.scss', './assets/scss/mixin.scss']
  }
},

图片懒加载

图片懒加载的关键是使用IntersectionObserver,IE浏览器不兼容,需要使用polyfill。该WebAPI用于监听元素是否出现在顶级文档视窗中。

通过这个WebAPI,我们可以把<img>标签的src属性地址先挂在data-src属性上,当该元素出现在视窗时就会触发IntersectionObserver的的回调方法,此时再给<img>标签的src属性赋予先前挂在data-src上的地址

复制时携带转载声明

监听copy事件,然后通过getSelection()方法获取复制的内容,在通过clipboardDatasetData()方法在复制内容上加上转载信息:

if (process.env.NODE_ENV === 'production') {
  const copyText = `

---------------------
作者:shirmy
链接:${location.href}
来源:https://www.shirmy.me
商业转载请联系作者获得授权,非商业转载请注明出处。`

  document.addEventListener('copy', e => {
    if (!window.getSelection) {
      return
    }
    const content = window.getSelection().toString()

    e.clipboardData.setData('text/plain', content + copyText)
    e.clipboardData.setData('text/html', content + copyText)
    e.preventDefault()
  })
}

markdown防止XSS攻击

如果读者在评论中输入<script>alert('xss')</script>,那么进入文章详情页时就会触发这段代码,这时候,我们就需要把script过滤掉,当然XSS还有许多类似的方式,但是万变不离其宗

在这里,我借助了DOMPurify

npm install dompurify -S
DOMPurify.sanitize(html)

使用谷歌分析服务

首先进入官网Google 统计分析服务,并注册你的账号,得到一个格式如GA_MEASUREMENT_ID的媒体资源ID

然后直接修改nuxt.config.js,当然也可以自定义(gtag.js开发指南):

// nuxt.config.js
module.exports = {
  head: {
    // 其它配置...
    script: [
      // 其它配置...
      {
        async: 'async',
        type: 'text/javascript',
        // GA_MEASUREMENT_ID 替换为你刚刚注册得到的媒体资源ID
        src: 'https://www.googletagmanager.com/gtag/js?id=GA_MEASUREMENT_ID'
      },
      {
        // Global site tag (gtag.js) - Google Analytics
        type: 'text/javascript',
        // GA_MEASUREMENT_ID 替换为你刚刚注册得到的媒体资源ID
        innerHTML: `
          window.dataLayer = window.dataLayer || [];
          function gtag(){dataLayer.push(arguments);}
          gtag('js', new Date());

          gtag('config', 'GA_MEASUREMENT_ID');
        `
      }
    ]
  }
}

参考文档

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

推荐阅读更多精彩内容