一、创建vue项目步骤
要创建一个Vue + Element UI的项目,你可以按照以下步骤进行操作:
1.确保你已经安装了Node.js和npm(Node.js的包管理器)。你可以在命令行中运行以下命令来检查它们是否已经安装:
node -vnpm -v
2.使用Vue CLI来创建一个新的Vue项目。在命令行中运行以下命令:
npm install -g @vue/clivue create my-project
这将安装Vue CLI并创建一个名为my-project的新项目。在创建项目时,你可以选择手动选择特性或使用默认配置。
3. 进入到项目目录中:
cd my-project
4.安装Element PLUS。在命令行中运行以下命令:
npm install element-plus
5.在项目中使用Element PLUS。在你的Vue应用的入口文件(通常是src/main.js)中,添加以下代码:
import { createApp } from 'vue'
import ElementPlus from 'element-plus'
import 'element-plus/dist/index.css'const app = createApp(App)
app.use(ElementPlus)
app.mount('#app')
这将引入Element PLUS库,并将其作为Vue应用的插件使用。
6. 运行项目。在命令行中运行以下命令来启动开发服务器:
npm run serve
这将启动开发服务器,并在浏览器中打开你的Vue应用。
现在,你已经成功创建了一个Vue + Element PLUS的项目。你可以根据需要在项目中使用Element UI的组件和样式。
也可以手动打开此网址。
二、项目结构说明
在Vue 中,通常使用Vue CLI来创建和管理项目,它会自动生成一套默认的目录结构。下面是一个典型的Vue 3项目的目录结构说明:
my-project/|- public/| |- index.html||- src/| |- assets/| |- components/| |- views/| |- App.vue| |- main.js||- package.json|- vue.config.js|- README.md
-
public/:这个目录包含了公共的静态资源,如index.html文件和其他不需要经过构建处理的文件。
-
src/:这个目录是项目的主要源代码目录。
-
assets/:这个目录用于存放项目的静态资源,如图片、样式文件等。
-
components/:这个目录用于存放项目的可复用组件。
-
views/:这个目录用于存放项目的页面组件。
-
App.vue:这是项目的根组件,包含了整个应用的布局和路由视图的渲染。
-
main.js:这是项目的入口文件,用于初始化Vue应用并挂载根组件。
-
package.json:这个文件是项目的配置文件,包含了项目的依赖和脚本等信息。
-
vue.config.js:这个文件是Vue CLI的配置文件,用于自定义构建配置和开发服务器等选项。
-
README.md:这个文件是项目的说明文档,通常包含了项目的介绍、安装和使用方法等信息。
这只是一个简单的目录结构示例,实际的项目可能会根据需求和团队的偏好进行调整和扩展。
三、安装路由
在Vue 3中,你可以使用Vue Router来进行路由管理。要在路由配置中添加新页面的路由,你可以按照以下步骤进行操作:
1.在你的Vue项目中,确保已经安装了Vue Router。如果没有安装,可以使用以下命令进行安装:
npm install vue-router
判断是否安装成功可以看一下package.json
是否显示vue-router的版本号
2.在项目的src文件中,创建一个新的文件夹router,里面放置index.js,用于配置路由。src/router/index.js
3.在此文件中,导入Vue和Vue Router,并创建一个新的路由实例。示例代码如下:
import { createRouter, createWebHistory } from 'vue-router'import Indexfrom '../views/Index/IndexPage.vue'const routes = [{path: '/',name: 'Index',component: Index}]const router = createRouter({history: createWebHistory(),routes})export default router
在上面的示例中,我们将路由实例作为Vue应用的插件使用。
现在,你已经成功在路由配置中添加了新页面的路由。你可以根据需要继续添加其他页面的路由配置。
4.在Vue 3应用程序的入口文件(通常是main.js)中使用了上述路由配置。示例代码如下:
import {createApp
} from 'vue'
import App from './App.vue'
import ElementPlus from 'element-plus'
import 'element-plus/dist/index.css'
import router from './router'const app = createApp(App)
app.use(ElementPlus)
app.use(router)
app.mount('#app')
我们将路由配置通过 use 方法注入到Vue应用程序中。
报错处理:
error Component name “XXX” should always be multi-word vue/multi-word-component-
这些错误信息是由Vue的ESLint插件生成的,用于检查和提醒开发者在Vue组件中的一些最佳实践和规范。如果出现这种错误,要么选择规范自己的代码,要么选择关闭验证。其他的处理情况可以进行百度。
可以在package.json文件里面添加rule规则:
"rules": {"vue/multi-word-component-names": "off"
}
四、创建首页并显示内容
indexPage.vue文件内容:
<template><!-- 页面内容 --><div>你好</div>
</template><script>export default {name: 'Index',// 组件逻辑代码}
</script><style>/* 样式规则 */
</style>
router/index.js文件:
import {createRouter,createWebHistory
} from 'vue-router'
import Index from '../views/Index/IndexPage.vue'const routes = [{path: '/',name: 'Index',component: Index
}]const router = createRouter({history: createWebHistory(),routes
})export default router
App.vue文件:
<template><div id="app"><router-view></router-view></div>
</template><script>
export default {name: 'App',components: {}
}
</script><style>
#app {font-family: Avenir, Helvetica, Arial, sans-serif;-webkit-font-smoothing: antialiased;-moz-osx-font-smoothing: grayscale;
}
</style>
(一)如果运行没有效果,(以下和上面项目目录文件等不关联,这里只是举例)可能有以下几个原因:
1.检查路由配置:确保你的路由配置正确,并且将根路径 /
与 index
组件关联起来。在路由配置文件中,确保你有类似以下的代码:
import { createRouter, createWebHistory } from 'vue-router';import Index from '@/views/Index.vue';const routes = [{path: '/',name: 'Index',component: Index},// 其他路由配置...];const router = createRouter({history: createWebHistory(),routes});export default router;
2.检查入口文件:在入口文件(通常是 main.js)中,确保你正确地使用了路由配置。示例代码如下:
import { createApp } from 'vue';import router from './router';import App from './App.vue';createApp(App).use(router).mount('#app');
确保你使用了正确的路由配置文件,并将其通过 use 方法注入到Vue应用程序中。
3. 检查组件名称:确保你的 index 组件的名称与路由配置中的组件名称一致。在 Index.vue 文件中,确保你有类似以下的代码:
<template><!-- 页面内容 --></template><script>export default {name: 'Index',// 组件逻辑代码}</script><style>/* 样式规则 */</style>
确保 name 属性的值与路由配置中的组件名称一致。
4.路由出口:在你的根组件(通常是App.vue)中,确保你有一个路由出口()来渲染对应的页面。
<template><div id="app"><!-- 其他内容... --><router-view></router-view></div></template>
五、跳转页面
路由链接:如果你在其他页面或组件中需要导航到views/Index/IndexPage页面,确保你使用了正确的路由链接。
【此处是根据你的命名写法来,代码不可生硬照搬】
<router-link to="/index">Go to Index Page</router-link>
写法还有其他形式
<router-link :to="{ path: 'home' }">Home</router-link>
<!-- 命名的路由 -->
<router-link :to="{ name: 'user', params: { userId: 123 }}">User</router-link>
<!-- 带查询参数,下面的结果为 /about?userName=qqq-->
<router-link :to="{ path: 'about', query: { userName: 'qqq' }}">about</router-link>
六、使用组件
1.创建公共组件,例如导航栏。在components文件夹里面创建一个NavBar.vue文件。
<template><div class="navBar"><!-- 单个 --><!-- <ul class="navList"><li :class="{ active: '/' === $route.path }" @click="goTo('/')">首页</li><li :class="{ active: '/About' === $route.path }" @click="goTo('/About')">关于</li><li :class="{ active: '/IndexDetail' === $route.path }" @click="goTo('/IndexDetail')">详情</li></ul> --><!-- 循环的 --><ul class="navList"><li v-for="item in navItems" :key="item.path" :class="{ active: item.path === $route.path }"@click="goTo(item)">{{ item.label }}</li></ul><!-- UI框架自适应的 --><el-menu :default-active="activeIndex" class="el-menu-demo" mode="horizontal"><el-menu-item :index="item.id" v-for="item in navItems" :key="item.path"@click="goTo(item)">{{ item.label }}</el-menu-item></el-menu></div>
</template><script>export default {name: 'NavBar',data() {return {navItems: [{id: '1',path: '/',label: '首页'},{id: '2',path: '/About',label: '关于'},{id: '3',path: '/IndexDetail',label: '详情'}],activeIndex: '1'}},mounted() {this.activeIndex = localStorage.getItem('activeIndex');},methods: {goTo(item) {this.$router.replace(item.path);localStorage.setItem('activeIndex', item.id);},}}
</script><style scoped>.navList {display: flex;list-style: none;}.navList li {width: 100px;line-height: 50px;height: 50px;border: 1px solid red;text-align: center;}.active {color: #3a82f3;position: relative;}.active::after {content: "";position: absolute;left: 0;bottom: 0;width: 100%;height: 4px;background-color: #3a82f3;}
</style>
2.在其他页面使用该组件。其他页面也是同样的操作,引入、注册、使用。
<template><!-- 页面内容 --><div><NavBar></NavBar>这是首页</div>
</template>
<script>import NavBar from '../../components/NavBar.vue' export default {name: 'Index',components:{NavBar}}
</script><style>
</style>
七、状态管理store
状态管理:
https://cn.vuejs.org/guide/scaling-up/state-management.html
在Vue 3中,store文件夹通常用于存放Vuex相关的代码和文件。Vuex是Vue的官方状态管理库,用于管理应用程序的状态。
在store文件夹中,一般会包含以下文件或目录:
1. index.js:这是Vuex的主要入口文件。在这个文件中,你可以创建Vuex的store实例,并导出它供应用程序使用。
2. state.js:这个文件用于定义应用程序的状态。你可以在这里定义和初始化应用程序的各种状态变量。
3. mutations.js:这个文件包含了Vuex的mutations。Mutations是用于修改状态的函数,它们接收state作为参数,并对其进行修改。
4. actions.js:这个文件包含了Vuex的actions。Actions是用于处理异步操作和提交mutations的函数。它们可以包含异步逻辑,并在需要时触发mutations。
5. getters.js:这个文件包含了Vuex的getters。Getters是用于从状态中派生出新的数据的函数。它们可以对状态进行计算或过滤,并返回派生的数据。
除了上述文件,你还可以根据需要在store文件夹中创建其他文件或目录,以组织和管理你的Vuex代码。
需要注意的是,这只是一种常见的组织方式,你可以根据你的项目需求和个人偏好进行调整和扩展。
ref:
https://cn.vuejs.org/api/reactivity-core.html#ref
ref是Vue 3中的一个函数,它是Vue Composition API的一部分。ref函数用于创建一个响应式的数据引用。
在Vue 3中,响应式是通过ref函数来实现的。当你使用ref函数创建一个变量时,它会返回一个包装了原始值的响应式引用。这意味着当引用的值发生变化时,Vue会自动追踪这个变化,并在需要时更新相关的视图。
以下是一个使用ref函数的示例:
import { ref } from 'vue';const count = ref(0);
console.log(count.value); // 输出: 0
count.value++; // 修改值
console.log(count.value); // 输出: 1
在上面的示例中,我们使用ref函数创建了一个名为count的变量,并将其初始值设置为0。通过访问count.value,我们可以获取到该变量的值。当我们修改count.value时,Vue会自动更新相关的视图。
需要注意的是,由于ref函数返回的是一个包装了原始值的引用,所以在访问或修改变量的值时,需要使用.value来进行操作。
reactive()
reactive()是Vue 3中的一个函数,它是Vue Composition API的一部分。reactive()函数用于创建一个响应式的对象。
在Vue 3中,响应式是通过reactive()函数来实现的。当你使用reactive()函数创建一个对象时,它会返回一个包装了原始对象的响应式代理。这意味着当代理对象的属性发生变化时,Vue会自动追踪这些变化,并在需要时更新相关的视图。
import { reactive } from 'vue';const state = reactive({
count: 0,
message: 'Hello'
});console.log(state.count); // 输出: 0
console.log(state.message); // 输出: 'Hello'state.count++; // 修改值
console.log(state.count); // 输出: 1
在上面的示例中,我们使用reactive()函数创建了一个名为state的响应式对象。state对象包含了count和message两个属性。通过访问state.count和state.message,我们可以获取到这些属性的值。当我们修改state.count时,Vue会自动更新相关的视图。
需要注意的是,由于reactive()函数返回的是一个包装了原始对象的代理对象,所以在访问或修改对象的属性时,不需要使用额外的.value来进行操作。
八、vue3.0代理配置以及接口封装
【1】vue3.0代理配置以及接口封装:
https://blog.csdn.net/x_Yanger/article/details/106079274
【2】vue中 关于proxy的理解:
https://blog.csdn.net/ks8380/article/details/110678815?spm=1001.2014.3001.5506
devServer 中的 proxy 选项用于配置代理,将以 /api 开头的请求转发到 http://e.dxy.net。
ws 设置为 true 表示开启 WebSocket 支持。
secure 设置为 false 表示不验证 SSL 证书。
changeOrigin 设置为 true 表示修改请求头中的 Host 字段。
【3】要在 Vue 3 中安装和使用 Axios,可以按照以下步骤进行操作:
1.打开终端,并进入你的 Vue 3 项目的根目录。
2.运行以下命令来安装 Axios 依赖:
npm install axios
或者如果你使用的是 Yarn 包管理器,可以运行以下命令:
yarn add axios
3.安装完成后,你可以在你的 Vue 3 项目中的任何组件中使用 Axios。在需要使用 Axios 的组件中,可以通过以下方式引入 Axios:
import axios from 'axios';
4.现在,你可以使用 Axios 来发送 HTTP 请求。例如,你可以在组件的方法中使用 Axios 发送 GET 请求:
axios.get('/api/data').then(response => {// 处理响应数据}).catch(error => {// 处理错误});
上面第一条链接是有关于接口封装的,前提就是得先安装axios,安装完之后可以去浏览使用。
九、运行自动弹出浏览器
在 Vue 3 中,你可以通过配置 devServer 的 open 属性来实现在运行应用程序后自动弹出浏览器。
在你的 vue.config.js 文件中,可以添加以下配置:
module.exports = {// 其他配置项...devServer: {open: true}
};
设置 open 为 true,这将告诉开发服务器在启动时自动打开浏览器。
十、vue3单页面
用到什么就需要引入什么。
<template><div><NavBar></NavBar><!-- 轮播图 --><el-carousel :interval="5000" arrow="always"><el-carousel-item v-for="(item, index) in bannerList" :key="index"><img :src="app.$utils.image(item.image)" class="bannerImg" /></el-carousel-item></el-carousel></div>
</template>
<script setup>
import app from '@/app/index'
import { onMounted } from 'vue';
import {ref
} from "vue";
import NavBar from '../../components/NavBar.vue'
onMounted(() => {getInfo()
})
const bannerList = ref([])function getInfo() {app.$api.addArticle({type: 'index'}).then(res => {console.log(res);bannerList.value = res.data});
}
</script><style scoped>
.bannerImg {width: 100%;height: 100%;object-fit: contain;
}
</style>
加上setup之后写法不再是之前的写法,不需要写export进行暴露