H5小游戏开发教程之页面基础布局的开发

上篇文章我们完成了基础项目搭建，童鞋们都跟着教程完成了吗？没完成的童鞋们可以阅读上篇文章，先搭建好基础项目；这篇文章我们来完成页面基础布局的开发。

先给大家看下本篇文章我们实现的界面，如下图所示：

首先，在components文件夹创建10个文件夹，分别是：2048，llk，maze，mine，pintu，snake，sudoku，tetris，wzq，xxk；然后，再创建一个index.js文件；然后，在刚才创建的10个文件夹中分别创建一个Index.vue文件，该文件的内容类似这样如下代码，其中2048是所属文件夹名字，目前该代码仅用于占位，以后将被我们真正可玩的游戏取代。

<template>
  <div>
    2048
  </div>
</template>

<script setup>

</script>

<style lang="scss">

</style>

现在，我们在components文件夹下的index.js文件中写下如下代码，代码都很简单，童鞋们都能看懂吧？我在JS中喜欢使用文档注释，文档注释可以使编辑器的语法提示更智能，编写代码不易出错，对文档注释不熟悉的童鞋们可以头条搜索一下jsdoc，学习一下文档注释的语法；下面的文档注释都添加了描述，希望童鞋们都能理解。

/**
 * @typedef Game 定义一个类型，我们叫它游戏类型
 * @property {string} name 声明一个属性name，游戏的名字
 * @property {import('vue').AsyncComponentLoader} component 异步组件加载器
 */

/** @type {object.<string, Game>} 声明类型一个对象类型，属性名为字符串，值为游戏类型 */
export const gameMap = {
  2048: {
    name: '2048',
    component: () => import('./2048/Index.vue')
  },
  llk: {
    name: '连连看',
    component: () => import('./llk/Index.vue')
  },
  maze: {
    name: '走出迷宫',
    component: () => import('./maze/Index.vue')
  },
  mine: {
    name: '扫雷',
    component: () => import('./mine/Index.vue')
  },
  pintu: {
    name: '拼图',
    component: () => import('./pintu/Index.vue')
  },
  snake: {
    name: '贪吃蛇',
    component: () => import('./snake/Index.vue')
  },
  sudoku: {
    name: '数独',
    component: () => import('./sudoku/Index.vue')
  },
  tetris: {
    name: '俄罗斯方块',
    component: () => import('./tetris/Index.vue')
  },
  wzq: {
    name: '五子棋',
    component: () => import('./wzq/Index.vue')
  },
  xxk: {
    name: '消消看',
    component: () => import('./xxk/Index.vue')
  }
}

/**
 * @param {string} id 声明一个参数：游戏ID
 * @returns {Game} 声明返回值类型：游戏
 */
export const getGame = id => gameMap[id]

现在，我们在src文件夹创建一个文件夹layouts，该文件夹用于存放布局组件，我们在该文件夹创建一个Main.vue文件，该组件定义了2个prop：title用于定义头部显示的标题，hasBack用于定义是否包含返回按钮，我们在main标签下定义了一个slot插槽，该插槽用于渲染游戏；本系列教程重点是JS部分，HTML和CSS都比较简单，我假装童鞋们都懂，就不多讲了；该文件源码如下：

<template>
  <div :class="cls">
    <header :class="`${cls}_header`">
      <span v-if="hasBack" :class="`${cls}_btn-back`" @click="goBack">< 后退</span>
      <div :class="`${cls}_title`">{{ title }}</div>
    </header>
    <main :class="`${cls}_main`">
      <slot />
    </main>
  </div>
</template>

<script setup>
import { useRouter } from 'vue-router'

const cls = 'ui-layout-main'
const router = useRouter()
const props = defineProps({ title: String, hasBack: Boolean })

const goBack = () => router.back()
</script>

<style lang="less">
.ui-layout-main {
  height: 100vh;
  max-width: 768px;
  margin: 0 auto;
  display: flex;
  flex-direction: column;
  &_header {
    height: 42px;
    display: flex;
    align-items: center;
    background-color: #2196f3;
    color: #fff;
    padding: 0 15px;
  }
  &_title {
    flex: 1;
    text-align: center;
    font-size: 16px;
    letter-spacing: .1em;
  }
  &_btn-back {
    cursor: pointer;
  }
  &_main {
    flex: 1;
    height: 0;
    padding: .8em;
    overflow-y: auto;
    background-color: #e3f2fd;
  }
}
</style>

然后，我们打开views文件夹下的Home.vue文件，替换为如下代码：

<template>
  <ui-layout title="H5经典小游戏">
    <div :class="cls">
      <ul :class="`${cls}_games`">
        <li v-for="(v, k) in gameMap" :key="k" :class="`${cls}_game-item`">
          <router-link :to="{ name: 'game', params: { id: k } }">{{ v.name }}</router-link>
        </li>
      </ul>
    </div>
  </ui-layout>
</template>

<script setup>
import { gameMap } from '../components'
import UiLayout from '../layouts/Main.vue'
const cls = 'page-home'
</script>

<style lang="less">
.page-home {
  &_games {
    border-radius: 4px;
    background-color: #fff;
    box-shadow: 0 1px 3px rgba(0, 0, 0, 0.2), 0 1px 1px rgba(0, 0, 0, 0.14), 0 2px 1px -1px rgba(0, 0, 0, 0.12);
  }
  &_game-item {
    &:not(:last-child) {
      border-bottom: 1px solid #dcdee2;
    }
    a {
      display: block;
      padding: 10px;
      color: #515a6e;
      transition: background-color .2s;
      &:hover {
        background-color: #f5f5f5;
      }
    }
  }
}
</style>

然后，打开views文件夹下的Game.vue文件，替换为如下代码。在Vue3中，component组件的is属性如果绑定的值为异步组件，则必须将异步组件加载器传入defineAsyncComponent函数，将defineAsyncComponent函数的返回值绑定到is属性，否则，直接绑定异步组件加载器的话，将什么都渲染不出来，而且还会抛出警告；在该路由组件中，我们通过路由参数id来渲染不同的游戏；

<template>
  <ui-layout has-back :title="game && game.name">
    <component v-if="game" :is="gameComponent" />
  </ui-layout>
</template>

<script setup>
import { computed, defineAsyncComponent } from 'vue'
import { useRoute } from 'vue-router'
import { getGame } from '../components'
import UiLayout from '../layouts/Main.vue'

const route = useRoute()
const game = computed(() => getGame(route.params.id))
const gameComponent = computed(() => defineAsyncComponent(game.value.component))
</script>

感谢阅读！以上就是我们本篇文章的全部内容，这些代码是不是很简单呢？童鞋们阅读起来是不是很轻松？从下篇文章开始，我们将进入真正的游戏开发！以上我提到的10款游戏中，大家最期待先上哪款呢？