当前位置:首页 > uni-app

uniapp h5模板

2026-02-06 17:04:19uni-app

uniapp H5 模板基础结构

uniapp 的 H5 模板基于 Vue.js 技术栈,通过 vue-cli 生成的项目结构适配多端(包括 H5)。核心目录和文件如下:

├── pages                 # 页面目录  
│   └── index.vue         # 示例首页  
├── static                # 静态资源(图片等)  
├── components            # 公共组件  
├── manifest.json         # 应用配置(如启动页、权限)  
├── pages.json            # 页面路由与样式配置  
├── App.vue               # 根组件  
└── main.js               # 入口文件  

关键配置说明

pages.json
定义页面路由、导航栏样式等,示例配置:

{
  "pages": [
    {
      "path": "pages/index/index",
      "style": {
        "navigationBarTitleText": "首页"
      }
    }
  ],
  "globalStyle": {
    "navigationBarTextStyle": "black",
    "navigationBarTitleText": "uni-app"
  }
}

manifest.json
配置 H5 特有的启动项,如基础路径(routerBase):

{
  "h5": {
    "router": {
      "base": "/h5/"  // 部署子目录时需配置
    },
    "template": "template.h5.html"  // 自定义模板文件
  }
}

自定义 H5 模板文件

在项目根目录创建 template.h5.html,可修改 HTML 骨架。示例:

uniapp h5模板

<!DOCTYPE html>
<html>
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width,initial-scale=1.0">
  <title>{{ title }}</title>
  <script>
    document.addEventListener('DOMContentLoaded', function() {
      // 可在此插入全局脚本
    });
  </script>
</head>
<body>
  <div id="app"></div>
</body>
</html>

适配 H5 的注意事项

路由模式
默认使用 hash 路由,如需 history 模式,在 manifest.json 中配置:

"h5": {
  "router": {
    "mode": "history"
  }
}

跨域问题
开发环境下,在 vue.config.js 中配置代理:

uniapp h5模板

module.exports = {
  devServer: {
    proxy: {
      '/api': {
        target: 'http://target-domain.com',
        changeOrigin: true
      }
    }
  }
};

静态资源路径
生产环境部署时,确保 publicPath 正确(在 vue.config.js 中配置):

module.exports = {
  publicPath: process.env.NODE_ENV === 'production' ? '/h5/' : '/'
};

扩展功能示例

动态修改标题
在页面中使用 uni.setNavigationBarTitle

export default {
  onLoad() {
    uni.setNavigationBarTitle({ title: '新标题' });
  }
}

H5 专用样式
通过条件编译区分平台:

<style>
/* 所有平台生效 */
.title { color: #333; }

/* 仅 H5 生效 */
/* #ifdef H5 */
.title { font-size: 16px; }
/* #endif */
</style>

标签: 模板uniapp
分享给朋友:

相关文章

uniapp中如何使用iconfont

uniapp中如何使用iconfont

使用 Iconfont 在 Uniapp 中的步骤 下载 Iconfont 资源 访问 Iconfont 官网,选择需要的图标并添加到项目。下载时选择 Font class 格式,解压后会得到 .tt…

uniapp特性

uniapp特性

uniapp的核心特性 跨平台开发 uniapp支持一套代码编译到多个平台,包括iOS、Android、H5、微信小程序、支付宝小程序、百度小程序、字节跳动小程序等。开发者无需为不同平台单独编写代码。…

uniapp指南

uniapp指南

开发环境搭建 下载HBuilderX作为官方推荐的开发工具,支持Windows和Mac系统。安装后创建uni-app项目,选择模板(如默认模板、Hello Uni-app等)。确保Node.js版本在…

海康 uniapp

海康 uniapp

海康威视与UniApp集成方案 海康威视的硬件设备(如摄像头、NVR等)与UniApp结合,通常需要通过海康的开放平台API或SDK实现功能调用。以下是具体实现方法: 获取海康威视开放平台权限 注册…

引擎uniapp

引擎uniapp

uniapp 引擎概述 uniapp 是一个基于 Vue.js 的跨平台开发框架,允许开发者使用单一代码库构建多端应用(如 iOS、Android、Web、小程序等)。其核心引擎通过条件编译和运行时适…

uniapp图文

uniapp图文

图文混排实现方式 在uniapp中实现图文混排通常采用<rich-text>组件或自定义样式布局。<rich-text>支持解析HTML字符串,适合动态内容渲染。 <te…