当前位置:首页 > 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 推送

uniapp 推送

uniapp 推送实现方法 uniapp 推送功能可以通过多种方式实现,主要包括使用第三方推送服务、原生插件或云服务。以下是几种常见的实现方案: 使用 UniPush 服务 UniPush 是 D…

uniapp样式库

uniapp样式库

uniapp 常用样式库推荐 uView UI uView 是专为 uniapp 设计的多端兼容 UI 框架,提供丰富的组件和工具类。支持 Vue3 组合式 API,内置主题定制功能,常用于快速构建企…

uniapp安装axios

uniapp安装axios

安装axios 在uniapp项目中安装axios需要确保项目支持node_modules管理。通过npm或yarn安装axios: npm install axios # 或 yarn add a…

uniapp营销

uniapp营销

营销策略 采用社交媒体推广,结合微信、微博、抖音等平台进行内容营销。通过短视频、直播等形式展示产品特点,吸引用户关注。利用KOL合作,扩大品牌影响力,提高用户信任度。 用户裂变 设计裂变活动,如邀请…

elementui模板

elementui模板

ElementUI 模板使用指南 ElementUI 是一个基于 Vue.js 的组件库,提供丰富的 UI 组件,适用于快速开发中后台管理系统。以下是 ElementUI 模板的常见用法和资源推荐。…

uniapp探探

uniapp探探

uniapp实现探探滑动卡片效果 探探的滑动卡片效果主要包含卡片堆叠、左右滑动操作、动画反馈等功能。在uniapp中可以通过以下方式实现类似交互: 使用swiper组件实现基础滑动 uniapp的s…