一、创建vue项目步骤
要创建一个Vue + Element UI的项目,你可以按照以下步骤进行操作:
1.确保你已经安装了Node.js和npm(Node.js的包管理器)。你可以在命令行中运行以下命令来检查它们是否已经安装:
node -v
npm -v
2.使用Vue CLI来创建一个新的Vue项目。在命令行中运行以下命令:
npm install -g @vue/cli
vue 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进行暴露