设为首页收藏本站
开启辅助访问

Vue移动端系列 =＞ [01] 项目初始化

 您所在的位置：网站首页 › 初始化移动端默认样式可以使用的库是 › Vue移动端系列 =＞ [01] 项目初始化

Vue移动端系列 =＞ [01] 项目初始化

2024-03-09 04:52| 来源: 网络整理| 查看: 265

目录 一、项目初始化 使用 Vue CLI 创建项目 配置文件 加入 Git 版本管理 调整初始目录结构 导入图标素材 一、注册账户 二、创建项目 三、上传图标到项目 四、生成链接 五、配置到项目中使用 ==组件化开发== 引入 Vant 组件库 移动端 REM 适配 关于 `.postcssrc.js` 配置文件 封装请求模块 一、项目初始化

目标

能使用 Vue CLI 创建项目 了解 Vant 组件库的导入方式 掌握制作使用字体图标的方式 掌握如何在 Vue 项目中处理 REM 适配 理解 axios 请求模块的封装 使用 Vue CLI 创建项目

如果你还没有安装 VueCLI，请执行下面的命令安装或是升级：

npm install --global @vue/cli

在命令行中输入以下命令创建 Vue 项目：

vue create toutiao-m Vue CLI v4.2.3 ? Please pick a preset: default (babel, eslint) > Manually select features

default：默认勾选 babel、eslint，回车之后直接进入装包

manually：自定义勾选特性配置，选择完毕之后，才会进入装包

选择第 2 种：手动选择特性，支持更多自定义选项

? Please pick a preset: Manually select features ? Check the features needed for your project: (*) Babel ( ) TypeScript ( ) Progressive Web App (PWA) Support (*) Router (*) Vuex (*) CSS Pre-processors >(*) Linter / Formatter ( ) Unit Testing ( ) E2E Testing

分别选择： Babel：es6 转 es5 Router：路由 Vuex：数据容器，存储共享数据 CSS Pre-processors：CSS 预处理器，后面会提示你选择 less、sass、stylus 等 Linter / Formatter：代码格式校验

? Use history mode for router? (Requires proper server setup for index fallback in production) (Y/n) n

是否使用 history 路由模式，这里输入 n 不使用

? Pick a CSS pre-processor (PostCSS, Autoprefixer and CSS Modules are supported by default): Sass/SCSS (with dart-sass) Sass/SCSS (with node-sass) > Less Stylus

选择 CSS 预处理器，这里选择我们熟悉的 Less

? Pick a linter / formatter config: ESLint with error prevention only > ESLint + Airbnb config ESLint + Standard config ESLint + Prettier

选择校验工具，这里选择 ESLint + Standard config

? Pick additional lint features: > (*) Lint on save (*) Lint and fix on commit

选择在什么时机下触发代码格式校验：

Lint on save：每当保存文件的时候 Lint and fix on commit：每当执行 git commit 提交的时候

这里建议两个都选上，更严谨。

? Where do you prefer placing config for Babel, ESLint, etc.? (Use arrow keys) > In dedicated config files In package.json

Babel、ESLint 等工具会有一些额外的配置文件，这里的意思是问你将这些工具相关的配置文件写到哪里：

In dedicated config files：分别保存到单独的配置文件 In package.json：保存到 package.json 文件中

这里建议选择第 1 个，保存到单独的配置文件，这样方便我们做自定义配置。

? Save this as a preset for future projects? (y/N) N

这里里是问你是否需要将刚才选择的一系列配置保存起来，然后它可以帮你记住上面的一系列选择，以便下次直接重用。

这里根据自己需要输入 y 或者 n，我这里输入 n 不需要。

✨ Creating project in C:\Users\LPZ\Desktop\topline-m-fe89\topline-m-89. � Initializing git repository... ⚙ Installing CLI plugins. This might take a while... [ ........] - extract:object-keys: sill extract [email protected]

向导配置结束，开始装包。 安装包的时间可能较长，请耐心等待…

⚓ Running completion hooks... � Generating README.md... � Successfully created project topline-m-89. � Get started with the following commands: $ cd topline-m $ npm run serve

安装结束，命令提示你项目创建成功，按照命令行的提示在终端中分别输入：

# 进入你的项目目录 cd toutiao-webapp # 启动开发服务 npm run serve DONE Compiled successfully in 7527ms App running at: - Local: http://localhost:8080/ - Network: http://192.168.10.216:8080/ Note that the development build is not optimized. To create a production build, run npm run build.

启动成功，命令行中输出项目的 http 访问地址。 打开浏览器，输入其中任何一个地址进行访问。

如果能看到该页面，恭喜你，项目创建成功了。

配置文件

1.settings.json 这个是vscode配置文件,去了公司,要会给新电脑配置环境, .gitconfig 配置我们git提交的一些内容 .npmrc 配置文件,我们下载了node.js以后,npm自带的源是国外的,下载包就是国外地址,比较慢,所以淘宝源必须配置 .vuerc 配置文件,是给 vue create xxxx 是给vue这个脚手架命令行工具看的

.selinrc.js 他是我们公司的代码规则,公司会由配置文件给我们,就是eslint.js文件,在这个文件内部rules就是各种规则 // quotes:0 这句话不管使用什么引号,eslint都不会校验引号的bug

3…prettierrc.js这个文件就是将我们代码自动格式化为我们规定的格式

加入 Git 版本管理

几个好处：

代码备份 多人协作 历史记录 …

（1）创建远程仓库

GitHub 码云 Coding …

（2）将本地仓库推到线上

如果没有本地仓库。

# 创建本地仓库 git init # 将文件添加到暂存区 git add 文件 # 提交历史记录 git commit "提交日志" # 添加远端仓库地址 git remote add origin 你的远程仓库地址 # 推送提交 git push -u origin master

如果已有本地仓库（Vue CLI 已经帮我们初始化好了）。

# 添加远端仓库地址 git remote add origin 你的远程仓库地址 # 推送提交 git push -u origin master

如果之后项目代码有了变动需要提交：

git add git commit git push 调整初始目录结构

默认生成的目录结构不满足我们的开发需求，所以这里需要做一些自定义改动。

这里主要就是下面的两个工作：

删除初始化的默认文件 新增调整我们需要的目录结构

1、将 App.vue 修改为

今日头条 export default { name: 'App' }

2、将 router/index.js 修改为

import Vue from 'vue' import VueRouter from 'vue-router' Vue.use(VueRouter) const routes = [ ] const router = new VueRouter({ routes }) export default router

3、删除

src/views/About.vue src/views/Home.vue src/components/HelloWorld.vue src/assets/logo.png

4、创建以下几个目录

src/api 目录

存储接口封装

src/utils 目录

存储一些工具模块

src/styles 目录

index.less 文件，存储全局样式 在 main.js 中加载全局样式 import './styles/index.less'

调整之后的目录结构如下。

. ├── README.md ├── babel.config.js ├── package-lock.json ├── package.json ├── public │ ├── favicon.ico │ └── index.html └── src ├── api ├── App.vue ├── assets 资源文件夹,放置各种字体文件ttf woff和图片 ├── components 这个里面放的是每个页面的子组件 ├── main.js ├── router 路由规则文件夹 ├── utils 放置一些工具函数,常见的是一些请求axios封装,防抖封装 ├── styles 放置全局的css文件 ├── store vuex 文件夹 ├── directives 文件夹 ├── filters 过滤器的文件夹 └── views 里面放置各种和路由相关的组件

将项目目录结构调整后更新到远程仓库

git add . git commit -m '项目目录结构初始化' git push 将本地仓库代码与远程仓库代码保持一致 导入图标素材

05-项目初始化-导入图标素材：07：41可以暂停，实现图标制作并获取代码

设计师为我们单独提供了设计稿中的图标，为了方便使用，我们在这里把它制作为字体图标。

制作字体图标的工具有很多，在这里我们推荐大家使用：www.iconfont.cn/。

一、注册账户 二、创建项目 三、上传图标到项目

把UI给我们做好的本地svg上传上去

四、生成链接

选择font-class,把//at.alicdn.com/t/font_2172660_wp7ff9l169l.css内容浏览器打开,复制内容导创建的iconfont.less里面,然后在index.less @import './iconfont.less'; 后面在项目里直接使用就可以了

如果是按照第四部用线上的,就不需要第五步了!!!

五、配置到项目中使用

在styles目录下创建iconfont.less,将对应的图标样式代码复制过来

在index.less中引用图标样式

// 全局样式文件 // 加载图标样式图标 @import './icon.less';

在App.vue中使用字体图标

将资料中的素材图片复制到自己项目的assets文件夹中，并将favicon.ico剪切到public目录下，替换默认的ico

一种方式是将 SVG 图标 包装为 Vue 组件来使用。

一种方式是将 SVG 制作为字体图标来使用：

组件化开发 css也有模块化的规范 模块化规范,就是多个文件直接数据的获取把 import xxxx from xx export default xx 比如我要引入iconfont.less,那我就需要在index.less中@import './iconfont.less'; 然后再import './styles/index.less'; 这样组件化开发就可以了 引入 Vant 组件库

Vant 是有赞商城前端开发团队开发的一个基于 Vue.js 的移动端组件库，它提供了非常丰富的移动端功能组件，简单易用。

官方文档 GitHub 仓库

下面是在 Vant 官网中列出的一些优点：

60+ 高质量组件 90% 单元测试覆盖率 完善的中英文文档和示例 支持按需引入 支持主题定制 支持国际化 支持 TS 支持 SSR

在我们的项目中主要使用 Vant 作为核心组件库，下面我们根据官方文档将 Vant 导入项目中。

将 Vant 引入项目一共有四种方式：

方式一：自动按需引入组件

和方式二一样，都是按需引入，但是加载更方便一些（需要额外配置插件） 优点：打包体积小 缺点：每个组件在使用之前都需要手动加载注册

方式二：手动按需引入组件

在不使用插件的情况下，可以手动引入需要的组件 优点：打包体积小 缺点：每个组件在使用之前都需要手动加载注册

方式三：导入所有组件

Vant 支持一次性导入所有组件，引入所有组件会增加代码包体积，因此不推荐这种做法 优点：导入一次，使用所有 缺点：打包体积大

方式四：通过 CDN 引入(不推荐)

使用 Vant 最简单的方法是直接在 html 文件中引入 CDN 链接，之后你可以通过全局变量vant访问到所有组件。 优点：适合一些演示、示例项目，一个 html 文件就可以跑起来 缺点：不适合在模块化系统中使用

这里建议为了前期开发的便利性我们选择方式三：导入所有组件，在最后做打包优化的时候根据需求配置按需加载以降低打包体积大小。

1、安装 Vant

npm i vant

2、在 main.js 中加载注册 Vant 组件

import Vue from 'vue' import Vant from 'vant' import 'vant/lib/index.css' Vue.use(Vant)

3、查阅文档使用组件

Vant 的文档非常清晰，左侧是组件目录导航，中间是效果代码，右边是效果预览。

例如我们在根组件使用 Vant 中的组件：

默认按钮 主要按钮 移动端 REM 适配

Vant 中的样式默认使用 px 作为单位，如果需要使用 rem 单位，推荐使用以下两个工具：

postcss-pxtorem 是一款 postcss 插件，用于将单位转化为 rem lib-flexible 用于设置 rem 基准值

下面我们分别将这两个工具配置到项目中完成 REM 适配。

一、使用 lib-flexible 动态设置 REM 基准值（html 标签的字体大小）

1、安装

# yarn add amfe-flexible npm i amfe-flexible

2、然后在 main.js 中加载执行该模块

import 'amfe-flexible'

最后测试：在浏览器中切换不同的手机设备尺寸，观察 html 标签 font-size 的变化。

例如在 iPhone 6/7/8 设备下，html 标签字体大小为 37.5 px

例如在 iPhone 6/7/8 Plus 设备下，html 标签字体大小为 41.4 px

二、使用 postcss-pxtorem 将 px 转为 rem

1、安装

# yarn add -D postcss-pxtorem # -D 是 --save-dev 的简写 npm install postcss-pxtorem -D

2、然后在项目根目录中创建 .postcssrc.js 文件

module.exports = { plugins: { 'autoprefixer': { browsers: ['Android >= 4.0', 'iOS >= 8'] }, 'postcss-pxtorem': { rootValue: 37.5, propList: ['*'] } } }

3、配置完毕，重新启动服务

最后测试：刷新浏览器页面，审查元素的样式查看是否已将 px 转换为 rem。

这是没有配置转换之前的。

这是转换之后的，可以看到 px 都被转换为了 rem。

需要注意的是：

该插件不能转换行内样式中的 px，例如 关于 .postcssrc.js 配置文件

10：33秒暂停

postCss基本介绍，解决项目运行报错问题

19：43建议暂停

rootValue的作用，以及项目和vant的冲突问题

module.exports = { plugins: { 'autoprefixer': { browsers: ['Android >= 4.0', 'iOS >= 8'] }, 'postcss-pxtorem': { rootValue: 37.5, propList: ['*'] } } }

.postcssrc.js 是 PostCSS 的配置文件。

（1）PostCSS 介绍

PostCSS 是一个处理 CSS 的处理工具，本身功能比较单一，它主要负责解析 CSS 代码，再交由插件来进行处理，它的插件体系非常强大，所能进行的操作是多种多样的，例如：

Autoprefixer 插件可以实现自动添加浏览器相关的声明前缀 PostCSS Preset Env 插件可以让你使用更新的 CSS 语法特性并实现向下兼容 postcss-pxtorem 可以实现将 px 转换为 rem …

目前 PostCSS 已经有 200 多个功能各异的插件。开发人员也可以根据项目的需要，开发出自己的 PostCSS 插件。

PostCSS 一般不单独使用，而是与已有的构建工具进行集成。

Vue CLI 默认集成了 PostCSS，并且默认开启了 autoprefixer 插件。

Vue CLI 内部使用了 PostCSS。

你可以通过 .postcssrc 或任何 postcss-load-config 支持的配置源来配置 PostCSS。也可以通过 vue.config.js 中的 css.loaderOptions.postcss 配置 postcss-loader。

我们默认开启了 autoprefixer。如果要配置目标浏览器，可使用 package.json 的 browserslist 字段。

（2）Autoprefixer 插件的配置

autoprefixer 是一个自动添加浏览器前缀的 PostCss 插件，browsers 用来配置兼容的浏览器版本信息，但是写在这里的话会引起编译器警告。

Replace Autoprefixer browsers option to Browserslist config. Use browserslist key in package.json or .browserslistrc file. Using browsers option can cause errors. Browserslist config can be used for Babel, Autoprefixer, postcss-normalize and other tools. If you really need to use option, rename it to overrideBrowserslist. Learn more at: https://github.com/browserslist/browserslist#readme https://twitter.com/browserslist

警告意思就是说你应该将 browsers 选项写到 package.json 或 .browserlistrc 文件中。

[Android] >= 4.0 [iOS] >= 8

具体语法请参考这里。

（3）postcss-pxtorem 插件的配置

rootValue：表示根元素字体大小，它会根据根元素大小进行单位转换

propList 用来设定可以从 px 转为 rem 的属性

例如 * 就是所有属性都要转换，width 就是仅转换 width 属性

rootValue 应该如何设置呢？

如果你使用的是基于 lib-flexable 的 REM 适配方案，则应该设置为你的设计稿的十分之一。 例如设计稿是 750 宽，则应该设置为 75。

大多数设计稿的原型都是以 iphone6 为原型，iphone6 设备的宽是 750，我们的设计稿也是这样。

但是 Vant 建议设置为 37.5，为什么呢？

因为 Vant 是基于 375 写的，所以如果你设置为 75 的话，Vant 的样式就小了一半。

所以如果设置为 37.5 的话，Vant 的样式是没有问题的，但是我们在测量设计稿的时候都必须除2才能使用，否则就会变得很大。

这样做其实也没有问题，但是有没有更好的办法呢？我就想实现测量多少写多少（不用换算）。于是聪明的你就想，可以不可以这样来做？

如果是 Vant 的样式，就把 rootValue 设置为 37.5 来转换 如果是我们的样式，就按照 75 的 rootValue 来转换

通过查阅文档我们可以看到 rootValue 支持两种参数类型：

数字：固定值

函数：动态计算返回

postcss-pxtorem 处理每个 CSS 文件的时候都会来调用这个函数 它会把被处理的 CSS 文件相关的信息通过参数传递给该函数

所以我们修改配置如下：

/** * PostCSS 配置文件 */ module.exports = { // 配置要使用的 PostCSS 插件 plugins: { // 配置使用 autoprefixer 插件 // 作用：生成浏览器 CSS 样式规则前缀 // VueCLI 内部已经配置了 autoprefixer 插件 // 所以又配置了一次，所以产生冲突了 // 'autoprefixer': { // autoprefixer 插件的配置 // // 配置要兼容到的环境信息 // browsers: ['Android >= 4.0', 'iOS >= 8'] // }, // 配置使用 postcss-pxtorem 插件 // 作用：把 px 转为 rem 'postcss-pxtorem': { rootValue ({ file }) { return file.indexOf('vant') !== -1 ? 37.5 : 75 }, propList: ['*'] } } }

配置完毕，把服务重启一下，最后测试，very good。

封装请求模块

和之前项目一样，这里我们还是使用 axios 作为我们项目中的请求库，为了方便使用，我们把它封装为一个请求模块，在需要的时候直接加载即可。

1、安装 axios

npm i axios

2、创建 src/utils/request.js

/** * 封装 axios 请求模块 */ import axios from "axios" const request = axios.create({ baseURL: "http://ttapi.research.itcast.cn/" // 基础路径 }) export default request

3、如何使用

方式一（简单方便，但是不利于接口维护）：我们可以把请求对象挂载到 Vue.prototype 原型对象中，然后在组件中通过 this.xxx 直接访问 方式二（推荐）：我们把每一个请求都封装成每个独立的功能函数，在需要的时候加载调用，这种做法更便于接口的管理和维护

在我们的项目中建议使用方式二，更推荐（在随后的业务功能中我们就能学到）。 下面是错的只是大概的形式

1.在src下创建api文件夹,创建users文件夹,并创建user.js

import request from '@/utils/request'; const login = request({ url: '/api/getbooks', method: 'GET', }); export default { login };

2.在App.vue里面导入login

//在script里面导入 import login from '@/api/users/user'; //然后调用这个接口 created() { login(); },


【本文地址】


今日新闻

推荐新闻

CopyRight 2018-2019 办公设备维修网 版权所有 豫ICP备15022753号-3