标签: vue

  • 如何从零创建 Vue 项目

    Vue.js 是一个流行的前端框架,可以用于构建现代化的 Web 应用。本文将介绍如何从零创建一个 Vue 项目。

    1. 安装 Node.js

    在创建 Vue 项目前,需要先安装 Node.js,因为 Vue 依赖 npm(或 yarn)来管理包。

    • 访问 Node.js 官网 下载并安装最新版。
    • 安装完成后,可以运行以下命令检查安装是否成功:
    node -v
    npm -v

    如果成功安装,会输出 Node.js 和 npm 的版本号。

    2. 使用 npm 创建 Vue 项目

    Vue 官方提供了 create-vue 工具来快速创建 Vue 3 项目。

    运行以下命令创建一个新的 Vue 项目:

    npm create vue@latest

    在执行命令后,终端会提示你选择一些选项,例如是否使用 TypeScript、Pinia、Vue Router 等。根据需要进行选择。

    如果希望直接指定项目名称,例如 my-vue-app,可以使用:

    npm create vue@latest my-vue-app

    然后进入项目目录:

    cd my-vue-app

    3. 安装依赖

    Vue 创建完成后,需要安装项目依赖:

    npm install

    如果你使用 yarn 或 pnpm,也可以使用:

    yarn install
    # 或
    pnpm install

    4. 启动开发服务器

    安装依赖后,运行以下命令启动本地开发服务器:

    npm run dev

    终端会输出一个本地访问地址,例如:

    Local: http://localhost:5173/

    打开浏览器访问该地址,即可看到 Vue 应用的默认页面。

    5. 目录结构介绍

    Vue 项目生成后,基本的目录结构如下:

    my-vue-app/
    ├── node_modules/       # 依赖包目录
    ├── public/             # 静态资源
    ├── src/                # 源代码
    │   ├── assets/         # 资源文件
    │   ├── components/     # 组件
    │   ├── App.vue         # 根组件
    │   ├── main.js         # 入口文件
    ├── .gitignore          # Git 忽略文件
    ├── package.json        # 项目配置文件
    ├── README.md           # 项目说明文件

    6. 构建生产环境代码

    当开发完成后,可以运行以下命令打包生产环境代码:

    npm run build

    生成的静态文件会被放在 dist/ 目录下,可以部署到服务器。

    7. 其他常用命令

    • 运行测试:npm run test
    • 格式化代码:npm run lint

    至此,你已经成功从零创建了一个 Vue 项目,并可以进行开发和部署。希望这篇教程对你有所帮助!

  • Vue3 + Element Plus 日期时间选择器 (el-date-picker) 格式化指南

    在 Vue3 + Element Plus 项目中,el-date-picker 是一个强大的日期时间选择组件,支持多种格式化方式。在使用 el-date-picker 组件时,我们可以通过 value-format 来控制其绑定值的格式。

    1. value-format 参数介绍

    el-date-picker 组件中,value-format 主要用于定义 v-model 绑定的数据格式。常见格式如下:

    timestamp:时间戳格式,例如 1709376600000

    YYYY-MM-DD:日期格式,例如 2025-03-02

    YYYY-MM-DD hh:mm:ss:日期时间格式,例如 2025-03-02 14:30:00

    YYYY/MM/DD HH:mm:ss:斜杠分隔格式,例如 2025/03/02 14:30:00

    2. 示例代码

    以下是一个 el-date-picker 组件的使用示例,绑定到 form.start_time,并使用 YYYY-MM-DD hh:mm:ss 作为 value-format

    <template>
      <el-form :model="form">
        <el-form-item label="开始时间">
          <el-date-picker
            v-model="form.start_time"
            type="datetime"
            value-format="YYYY-MM-DD hh:mm:ss"
            placeholder="请选择日期时间" />
        </el-form-item>
      </el-form>
    </template>
    
    <script setup>
    import { reactive } from 'vue';
    
    const form = reactive({
      start_time: '' // 初始值为空
    });
    </script>

    3. value-format 的作用

    • value-format 定义了 v-model 绑定的值的格式,适用于表单提交时传输标准化格式的数据。
    • 如果不设置 value-format,默认绑定的是 Date 对象,而不是字符串。
    • 在处理时间格式化时,建议根据后端要求设置合适的 value-format,如 YYYY-MM-DD HH:mm:ss 以确保数据兼容性。

    4. format 与 value-format 的区别

    参数作用
    format控制 UI 组件显示的格式
    value-format控制 v-model 绑定的值的格式

    例如,如果 format="YYYY/MM/DD"value-format="YYYY-MM-DD hh:mm:ss",那么用户在界面上看到的格式是 2025/03/02,但提交的数据格式是 2025-03-02 14:30:00

    总结:

    在 Vue3 + Element Plus 中,el-date-picker 组件的 value-format 参数用于控制数据的格式化,以便前后端数据交互。通过合理配置 value-format,可以确保数据在前端展示与后端存储之间保持一致。

    如果需要更多自定义格式或处理时间转换,可以结合 dayjsmoment.js 进行进一步操作。

    希望本文能帮助你更好地理解 el-date-picker 的格式化配置!