当前位置:首页 > 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和vue有什么区别

uniapp和vue有什么区别

uniapp和vue的区别 1. 定位与用途 Vue:一个渐进式JavaScript框架,专注于构建用户界面,适用于开发单页应用(SPA)或复杂前端项目。 UniApp:基于Vue.js的…

vue实现模板

vue实现模板

Vue 模板实现方法 Vue.js 使用基于 HTML 的模板语法,允许开发者声明式地将 DOM 绑定至底层 Vue 实例的数据。以下是实现 Vue 模板的几种常见方法: 使用字符串模板 在 Vu…

uniapp发布到应用商店

uniapp发布到应用商店

发布到苹果App Store 确保开发者账号已注册并加入Apple Developer Program,年费99美元。在Xcode中生成iOS发布证书(.p12)和描述文件(Provisioning…

uniapp隐私政策模板

uniapp隐私政策模板

隐私政策模板(UniApp适用) 以下是一个适用于UniApp的隐私政策模板,可根据实际业务需求调整内容。注意需符合《个人信息保护法》《网络安全法》等法律法规要求。 个人信息收集与使用 应用可能…

uniapp视频

uniapp视频

uniapp视频开发基础 uniapp支持通过video组件实现视频播放功能,该组件兼容多端(H5、小程序、App等),基本用法如下: <template> <video…

uniapp前端项目

uniapp前端项目

Uniapp 前端项目开发指南 Uniapp 是一个基于 Vue.js 的跨平台开发框架,支持一次开发,多端发布(如微信小程序、H5、App 等)。以下是关于 Uniapp 前端项目的关键信息: 环…