uni-app vue h5转换指南（vue转uni-app、h5转uni-app）

发布于 1周前 作者 sinazl 来自 Uni-App

uni-app vue h5转换指南（vue转uni-app、h5转uni-app）

如果你已经有了一个基于vue开发的H5站点，想转换为uni-app。

首先注意2个前提：1、你的web站是适合手机屏幕的；2、你的H5代码是全后端分离的，uni-app只处理前端代码。

一切从新建一个uni-app项目开始。然后依次进行

文件处理

  1. 把之前的vue web项目的前端代码copy到新项目下

  2. 如果之前的文件后缀名是.html，需要改为.vue，并注意遵循Vue单文件组件SFC规范，比如必须一级根节点为template、script、style，template节点下必须且只能有一个根view节点，所有内容写在这个根view节点下。

  3. 处理页面路由
    uni-app默认是小程序的路由方式，在pages.json里管理页面。如果你使用vue router的话，一种是改造为pages.json方式，另一种是使用三方插件，比如vue router for uni-app

  4. 静态文件（如图片）挪到static目录
    uni-app工程目录下有个static目录，用于存放静态文件，这个目录不编译，直接整体copy到发行代码里的。
    如果你希望自定义静态资源目录，可以在vue.config.js中自定义。

标签代码处理

  1. 相同功能的组件自动转换
    uni-app的标签组件与小程序相同，比如<div>变成了<view>，<span>变成了<text>。
    但uni-app的编译器已经自动处理了这部分转换，如果源码中写了可自动转换的组件，在编译到非H5端时会被自动转换（再编译回到H5端时div还是div）。

  2. 区域滚动使用scroll-view，不再使用div的区域滚动处理方式

  3. 左右、上下滑动切换，有专门的swiper组件，不要使用div模拟

  4. input的search，原来的type没用了，改成confirmtype，详见

  5. audio组件不再推荐使用，改成api方式，背景音频api文档

  6. 之前的v-html，可以在H5端和App端（需v3编译器）使用，不能在小程序中使用。如需要在小程序使用，请使用rich-text组件或uparse扩展插件，详见

js代码处理

uni-app的非H5端，不管是App还是各种小程序，都不支持window、navigator、document等web专用对象。
uni-app的API与小程序保持一致，需要处理这些不同的API写法

  1. 处理window api

  2. 处理navigator api

  3. 处理dom api

    • 如果使用标准vue的数据绑定，是不需要操作dom来修改界面内容的。如果没有使用vue数据绑定，仍然混写了jquery等dom操作，需要改为纯数据绑定
    • 有时获取dom并不是为了修改显示内容，而是为了获取元素的长宽尺寸来做布局。此时uni-app提供了同小程序的另一种API，uni.createSelectorQuery

  4. 其他js api
    web中还有canvas、video、audio、websocket、webgl、webbluetooth、webnfc，这些在uni-app中都有专门的API。

  5. 生命周期
    uni-app补充了一批类小程序的声明周期，包括App的启动、页面的加载，详见https://uniapp.dcloud.io/collocation/frame/lifetime
    vue h5一般在created或者mounted中请求数据，而在uni-app的页面中，使用onLoad或者onShow中请求数据。（组件仍然是created或者mounted）

  6. 少量不常用的vue语法在非h5端仍不支持，data必须以return的方式编写，注意事项详见

注意：如果你使用了一些三方ui框架、js库，其中引用了包括一些使用了dom、window、navigator的三方库，除非你只做H5端，否则需要更换。去uni-app的插件市场寻找替代品。如果找不到对应库，必须使用for web的库，在App端可以使用renderjs来引入这些for web的库。

css代码处理

uni-app发布到App(非nvue)、小程序时，显示页面仍然由webview渲染，css大部分是支持的。但需要注意

  • 不支持 *选择器
  • 没有body元素选择器，改用page元素选择器。（编译到非H5时，编译器会自动处理。所以不改也行）
  • div等元素选择器改为view、span和font改为text、a改为navigator、img改为image…（编译到非H5时，编译器会自动处理。所以不改也行）
  • 不同端的浏览器兼容性仍然存在，避免使用太新的css语法，否则发布为App时，Android低端机（Android 4.4、5.x），会有样式错误。当然在App端也可以引用x5浏览器内核来抹平浏览器差异。

本文是思路，不是工具。我们鼓励和欢迎开发者编写垫片API和转换器，方便更多人使用。


Harmonyos Next教程
1 回复

在将Vue项目或H5项目转换为uni-app项目时，主要关注的是项目结构的调整、平台特定功能的适配以及组件库的迁移。以下是一个简要的转换指南，并通过代码示例展示如何进行转换。

1. 项目结构调整

首先，需要创建一个新的uni-app项目，并将原有Vue或H5项目的代码迁移到新项目中。uni-app项目的基本结构如下：

uni-app-project/
├── pages/
│   ├── index/
│   │   ├── index.vue
│   │   └── index.json
│   └── ...
├── static/
├── common/
│   └── ... (公共组件或样式)
├── App.vue
├── main.js
├── manifest.json
└── pages.json

2. Vue 转 uni-app

对于Vue项目，可以直接将.vue文件复制到uni-app的pages目录下，并调整pages.json以配置路由。例如：

// pages.json
{
  "pages": [
    {
      "path": "pages/index/index",
      "style": {
        "navigationBarTitleText": "首页"
      }
    }
  ]
}

Vue组件中的大部分代码可以直接在uni-app中使用，但需要注意平台特定的API调用，应使用uni-app提供的API进行替换。例如，将Vue中的window.alert替换为uni.showToast：

// Vue 代码
<template>
  <div @click="showAlert">点击我</div>
</template>

<script>
export default {
  methods: {
    showAlert() {
      window.alert('Hello, Vue!');
    }
  }
}
</script>

// 转换为 uni-app 代码
<template>
  <view @click="showAlert">点击我</view>
</template>

<script>
export default {
  methods: {
    showAlert() {
      uni.showToast({
        title: 'Hello, uni-app!',
        icon: 'none'
      });
    }
  }
}
</script>

3. H5 转 uni-app

H5项目转换为uni-app时，主要工作是调整CSS以适应不同平台的样式差异，并替换平台特定的JavaScript代码。例如，将H5中的document.getElementById替换为Vue的ref机制：

<!-- H5 代码 -->
<div id="myElement">Hello, H5!</div>
<script>
document.getElementById('myElement').innerText = 'Updated!';
</script>

<!-- 转换为 uni-app 代码 -->
<template>
  <view ref="myElement">Hello, uni-app!</view>
</template>

<script>
export default {
  mounted() {
    this.$refs.myElement.innerText = 'Updated!';
  }
}
</script>

总结

将Vue或H5项目转换为uni-app项目主要涉及到项目结构的调整、代码迁移以及平台特定功能的替换。通过合理使用uni-app提供的API和组件，可以高效地实现跨平台开发。

回到顶部