当前位置： 首页 > article >正文

uniapp的基本使用（easycom规范和条件编译）和uview组件的安装和使用

article 2024/11/14 11:40:25

文章目录

  • 1、uniapp
    • 1.uview组件安装
    • 2.uview-plus组件安装
  • 2、条件编译
  • 3、easycom规范
    • 1.组件路径符合规范
    • 2.自定义easycom配置的示例
  • 总结

1、uniapp

UniApp的UI组件库，如TMUI、uViewUI、FirstUI、TuniaoUI、ThorUI等，这些组件库适用于Vue3和TypeScript，支持跨平台开发，包括APP、小程序和H5。它们提供了丰富的组件和模板，旨在加速开发进程并提供流畅的用户体验。

  1. TMUI

    1. 优质Vue3 TS Pinia Vite跨端组件库,Uni App通用组件库跨端组件库,支持NVUE原生渲染,APP(安卓,IOS),微信小程序,H5,各家小程序;享受vue3的极速体验，享受TypeScript的强类型提示，性能强劲快速,vite编译速度极快；所有组件采用最新特性，性能翻倍。让uniapp在原生，小程序应用中流畅的运行，极致丝滑的体验
    2. tmui3.0 高性能、高颜值、多主题、暗黑模式vue3 ui组件库,没有比它更完美！
    3. 组件选项类别丰富,主要对标 vue3技术栈，UI视图风格新颖
    4. 插件地址：tmui3.2.0 vue3 typeScript nvue全平台ui组件库

  2. uview

    1. uView是遵循MIT (opens new window)开源协议开源的uni-app生态专用的UI框架，uni-app 是一个使用 Vue.js 开发所有前端应用的框架，开发者编写一套代码， 可发布到iOS、Android、H5、以及各种小程序(微信/支付宝/百度/头条/QQ/钉钉)等多个平台,2.0已全面兼容nvue.
    2. uview 生态完善，主要对标 vue2 技术栈
    3. uview-plus 特点 生态完善，主要对标 vue3 技术栈，为 uview 的升级版
      uview-plus，是全面兼容nvue的uni-app生态框架，全面的组件和便捷的工具，基于uView2.0初步修改，后续会陆续修复vue3兼容性，以及组合式API改造等。

  3. Taro

    Taro 是一个开放式跨端跨框架解决方案，支持使用 React/Vue/Nerv 等框架来开发 微信 / 京东 / 百度 / 支付宝 / 字节跳动 / QQ / 飞书 小程序 / H5 / RN 等应用。
    现如今市面上端的形态多种多样，Web、React Native、微信小程序等各种端大行其道。当业务要求同时在不同的端都要求有所表现的时候，针对不同的端去编写多套代码的成本显然非常高，这时候只编写一套代码就能够适配到多端的能力就显得极为需要。
    官网地址： Taro

  4. uni ui

    uni-ui就不用说了，是DCloud提供的一个跨端ui库，想必大家都用过，它是基于vue组件的、flex布局的、无dom的跨全端ui框架。
    官网地址

  5. ThorUI

    ThorUI 轻量、简洁、全面的移动端组件库。能大幅提升开发效率，包含uniapp与微信小程序原生版本组件库！
    目前uni版组件默认支持App端(IOS和Android)、H5、微信小程序、QQ小程序、支付宝小程序、百度小程序、头条小程序。
    官网插件链接

在这里插入图片描述

  1. Tuniao UI

    图鸟UI，是基于uni-app进行开发的UI框架，提供丰富的组件进行快速开发，已经支持APP、H5、微信小程序，包含常用表单组件、信息展示组件等，并提供丰富的酷炫页面模板。
    特性

    1. 包含基础常用的布局元素，flex、grid、浮动
    2. 完整一体的配色体系，包含 4 种色深模式，同时包含 4 套渐变配色
    3. 700+风格统一的图标 icon，60+精选组件，让开发者可以快速进行开发，icon 提供了单独的 npm 包，让开发者更加方便的更
    4. 新图鸟 UI 的 icon
    5. 酷炫常用的页面模板，更有让你眼前一亮的界面效果
    6. 图片素材语雀便捷下载，图鸟生态共同成长
      在这里插入图片描述
  2. FirstUI

    First UI 是一套基于uni-app开发的组件化、可复用、易扩展、低耦合的跨平台移动端UI 组件库。全面兼容App-Nvue、App-vue、小程序（微信、支付宝、百度、字节、QQ）、H5。UI 样式可配置，拓展灵活，轻松适应不同的设计风格，100+ 丰富的组件，能够满足移动端开发的基本需求，提供开箱即用的常用布局，极大程度节省开发成本
    特性

    1. UI 样式可配置，拓展灵活，轻松适应不同的设计风格
    2. 100+ 丰富的组件，能够满足移动端开发的基本需求
    3. 提供开箱即用的常用布局，极大程度节省开发成本
    4. 细致、漂亮的 UI
    5. 支持App-vue（Android、IOS）、App-Nvue（Android、IOS）、小程序、H5
    6. 支持在 vue2 或 vue3 下使用（支持在vue3组合式API下使用）。
      官网地址
      在这里插入图片描述
  3. Wot Design Uni

    wot-design-uni组件库基于vue3+Typescript构建，参照wot design的设计规范进行开发，提供70+高质量组件，支持暗黑模式、国际化和自定义主题，旨在给开发者提供统一的UI交互，同时提高研发的开发效率。
    特性

    1. 多平台覆盖，支持 微信小程序、支付宝小程序、钉钉小程序、H5、APP 等.
    2. 70+ 个高质量组件，覆盖移动端主流场景.
    3. 使用 Typescript 构建，提供良好的组件类型系统.
    4. 支持国际化，内置 15 种语言包.
    5. 提供丰富的文档和组件示例.
    6. 支持修改 CSS 变量实现主题定制.
    7. 支持暗黑模式
      在这里插入图片描述

1.uview组件安装

  1. uView依赖SCSS

    • 必须要安装此插件，否则无法正常运行。
    • 如果项目是由HBuilder X创建的，相信已经安装scss插件，如果没有，请在HX菜单的 工具->插件安装中找到"scss/sass编译"插件进行安装， 如不生效，重启HX即可
    • 如果您的项目是由vue-cli创建的，请通过以下命令安装对sass(scss)的支持，如果已安装，请略过。
    // 安装sass
npm i sass -D

// 安装sass-loader
npm i sass-loader -D

  2. Hbuilder X方式
    在uni-app插件市场右上角选择uni_modules版本下的使用HBuilderX导入插件，导入到对应的项目中即可。
    下载地址

  3. NPM方式

    // 如果您的根目录没有package.json文件的话，请先执行如下命令：
// npm init -y

npm install uview-ui@2.0.38

// 更新
// npm update uview-ui

    在这里插入图片描述

  4. 配置步骤

    • 引入uView主JS库
      在项目src目录中的main.js中，引入并使用uView的JS库，注意这两行要放在import Vue之后。
      	// main.js
	import uView from "uview-ui";
	Vue.use(uView);
    • 在引入uView的全局SCSS主题文件
      在项目src目录的uni.scss中引入此文件。
      		/* uni.scss */
		@import 'uview-ui/theme.scss';
    • 引入uView基础样式
      在App.vue中首行的位置引入，注意给style标签加入lang="scss"属性
      	<style lang="scss">
		/* 注意要写在第一行，同时给style标签加入lang="scss"属性 */
		@import "uview-ui/index.scss";
	</style>
    • 配置easycom组件模式
      	// pages.json
	{
		"easycom": {
			"^u-(.*)": "uview-ui/components/u-$1/u-$1.vue"
		},
		
		// 此为本身已有的内容
		"pages": [
			// ......
		]
	}
      • Cli模式额外配置
        如果您是vue-cli模式的项目，还需要在项目根目录的vue.config.js文件中进行如下配置：
      	// vue.config.js，如没有此文件则手动创建
	module.exports = {
	    transpileDependencies: ['uview-ui']
	}

2.uview-plus组件安装

  1. uView依赖SCSS

    • 必须要安装此插件，否则无法正常运行。
    • 如果项目是由HBuilder X创建的，相信已经安装scss插件，如果没有，请在HX菜单的 工具->插件安装中找到"scss/sass编译"插件进行安装， 如不生效，重启HX即可
    • 如果您的项目是由vue-cli创建的，请通过以下命令安装对sass(scss)的支持，如果已安装，请略过。
    // 安装sass
npm i sass -D

// 安装sass-loader
npm i sass-loader -D

  2. Hbuilder X方式
    在uni-app插件市场右上角选择uni_modules版本下的使用HBuilderX导入插件，导入到对应的项目中即可。
    下载地址：零云®uview-plus3.0重磅发布，全面的Vue3移动组件库。

  3. NPM方式

    // 如果您的根目录没有package.json文件的话，请先执行如下命令：
// npm init -y
npm install uview-plus
npm install dayjs
npm install clipboard

    在这里插入图片描述

  4. 配置步骤

    • 引入uView主JS库
      在项目src目录中的main.js中，引入并使用uView的JS库，注意这两行要放在import Vue之后。

      	// main.js
	import uviewPlus from 'uview-plus'
	
	// #ifdef VUE3
	import { createSSRApp } from 'vue'
	export function createApp() {
	  const app = createSSRApp(App)
	  app.use(uviewPlus)
	  return {
	    app
	  }
	}
	// #endif

    • 在引入uView的全局SCSS主题文件
      在项目src目录的uni.scss中引入此文件。

      		/* uni.scss */
		@import 'uview-plus/theme.scss';

    • 引入uView基础样式
      在App.vue中首行的位置引入，注意给style标签加入lang="scss"属性

      	<style lang="scss">
		/* 注意要写在第一行，同时给style标签加入lang="scss"属性 */
		@import "uview-plus/index.scss";
	</style>

    • 配置easycom组件模式

      	// pages.json
		{
			"easycom": {
				"autoscan": true,
				// 注意一定要放在custom里，否则无效，https://ask.dcloud.net.cn/question/131175
				"custom": {
					"^u--(.*)": "uview-plus/components/u-$1/u-$1.vue",
					"^up-(.*)": "uview-plus/components/u-$1/u-$1.vue",
			        "^u-([^-].*)": "uview-plus/components/u-$1/u-$1.vue"
				}
			},
			
			// 此为本身已有的内容
			"pages": [
				// ......
			]
		}

    • typescript支持
      在tsconfig.json中参考如下配置增加"uview-plus/types"

      {
	"compilerOptions": {
    "sourceMap": true,
    "baseUrl": ".",
    "paths": {
      "@/*": ["./src/*"]
    },
    "lib": ["esnext", "dom"],
    "types": [
        "@dcloudio/types",
        "uview-plus/types"
    ]
  },
  "include": ["src/**/*.ts", "src/**/*.d.ts", "src/**/*.tsx", "src/**/*.vue"]
}

      <template>
	<view style="padding: 20px;">
		 <!-- #ifdef VUE3 -->
		 	<up-button type="primary" text="确定"></up-button>
		 		<up-button type="primary" :plain="true" text="镂空"></up-button>
		 		<up-button type="primary" :plain="true" :hairline="true" text="细边"></up-button>
		 		<up-button type="primary" :disabled="disabled" text="禁用"></up-button>
		 		<up-button type="primary" loading loadingText="加载中"></up-button>
		 		<up-button type="primary" icon="map" text="图标按钮"></up-button>
		 		<up-button type="primary" shape="circle" text="按钮形状"></up-button>
		 		<up-button text="渐变色按钮" color="linear-gradient(to right, rgb(66, 83, 216), rgb(213, 51, 186))"></up-button>
		 		<up-button type="primary" size="small" text="大小尺寸"></up-button>
		  <!-- #endif -->
	</view>
</template>
<script>
export default {
	data() {
		return {
			disabled: true
		};
	}
};	
</script>

      在这里插入图片描述

2、条件编译

条件编译是用特殊的注释作为标记，在编译时根据这些特殊的注释，将注释里面的代码编译到不同平台。

uni-app 已将常用的组件、API封装到框架中，开发者按照 uni-app 规范开发即可保证多平台兼容，大部分业务均可直接满足。
但每个平台有自己的一些特性，因此会存在一些无法跨平台的情况。

  • 大量写 if else，会造成代码执行性能低下和管理混乱。
  • 编译到不同的工程后二次修改，会让后续升级变的很麻烦。
  • 为每个平台重写，明明主业务逻辑又一样
  1. 使用方法
    以 #ifdef 或 #ifndef 加 %PLATFORM% 开头，以 #endif 结尾。
    • #ifdef：if defined 仅在某平台存在
    • #ifndef：if not defined 除了某平台均存在
    • %PLATFORM%：平台名称
条件编译写法说明
#ifdef APP-PLUS需条件编译的代码#endif 仅出现在 App 平台下的代码
#ifndef H5需条件编译的代码#endif 除了 H5 平台，其它平台均存在的代码（注意if后面有个n）
#ifdef H5 或 MP-WEIXIN需条件编译的代码#endif 在 H5 平台或微信小程序平台存在的代码（这里只有或，不可能出现&&，因为没有交集）

%PLATFORM%取值

值生效条件版本支持
VUE3uni-app js引擎版用于区分vue2和3HBuilderX 3.2.0+
VUE2uni-app js引擎版用于区分vue2和3
UNI-APP-X用于区分是否是uni-app x项目HBuilderX 3.9.0+
uniVersion用于区分编译器的版本HBuilderX 3.9.0+
APPApp
APP-PLUSuni-app js引擎版编译为App时
APP-PLUS-NVUE或APP-NVUEApp nvue 页面
APP-ANDROIDApp Android 平台
APP-IOSApp iOS 平台
APP-HARMONYApp HarmonyOS Next 平台
H5H5（推荐使用 WEB）
WEBweb（同H5）HBuilderX 3.6.3+
MP-WEIXIN微信小程序
MP-ALIPAY支付宝小程序
MP-BAIDU百度小程序
MP-TOUTIAO抖音小程序
MP-LARK飞书小程序
MP-QQQQ小程序
MP-KUAISHOU快手小程序
MP-JD京东小程序
MP-360360小程序
MP微信小程序/支付宝小程序/百度小程序/抖音小程序/飞书小程序/QQ小程序/360小程序
QUICKAPP-WEBVIEW快应用通用(包含联盟、华为)
QUICKAPP-WEBVIEW-UNION快应用联盟
QUICKAPP-WEBVIEW-HUAWEI快应用华为

支持的文件：

  • .vue/.nvue/.uvue
  • .js/.uts
  • .css
  • pages.json
  • 各预编译语言文件，如：.scss、.less、.stylus、.ts、.pug
    注意
  1. 条件编译是利用注释实现的，在不同语法里注释写法不一样，js/uts使用 // 注释、css 使用 /* 注释 */、vue/nvue/uvue 模板里使用 ；
  2. 条件编译APP-PLUS包含APP-NVUE和APP-VUE，APP-PLUS-NVUE和APP-NVUE没什么区别，为了简写后面出了APP-NVUE ；
  3. 对于未定义平台名称，可能是名称写错了，也可能是低版本HBuilderX还不认识这个平台。此时的条件编译，#ifdef 中的代码不会生效，而 #ifndef 中的代码会生效；
  4. 使用条件编译请保证编译前和编译后文件的语法正确性，即要保障无论条件编译是否生效都能通过语法校验。比如：json文件中不能有多余的逗号，js中不能重复导入；
// #ifdef MP-WEIXIN
import a as aWx from 'a/wx'
// #endif
// #ifndef MP-WEIXIN
import a as aIndex from 'a/index'
// #endif
var a
// #ifdef MP-WEIXIN
a = aWx
// #endif
// #ifndef MP-WEIXIN
a = aIndex
// #endif

3、easycom规范

传统vue组件，需要安装、引用、注册，三个步骤后才能使用组件。easycom将其精简为一步。
只要组件路径符合规范（具体见下），就可以不用引用、注册，直接在页面中使用

1.组件路径符合规范

  1. 安装在项目根目录的components目录下，并符合components/组件名称/组件名称.vue

  2. 安装在uni_modules下，路径为uni_modules/插件ID/components/组件名称/组件名称.vue

    ┌─components
    │ └─comp-a
    │ └─comp-a.vue 符合easycom规范的组件
    └─uni_modules uni_module中符合easycom规范的组件
    └─uni_modules
    └─uni-list
    └─components
    └─uni-list
    └─ uni-list.vue

    不管components目录下安装了多少组件，easycom打包会自动剔除没有使用的组件，对组件库的使用尤为友好。
    组件库批量安装，随意使用，自动按需打包。

2.自定义easycom配置的示例

easycom是自动开启的，不需要手动开启，有需求时可以在pages.json的easycom节点进行个性化设置，如关闭自动扫描，或自定义扫描匹配组件的策略。

  1. easycom方式引入的组件无需在页面内import，也不需要在components内声明，即可在任意页面使用。
  2. easycom方式引入组件不是全局引入，而是局部引入。例如在H5端只有加载相应页面才会加载使用的组件。
  3. 在组件名完全一致的情况下，easycom引入的优先级低于手动引入（区分连字符形式与驼峰形式）。
  4. 考虑到编译速度，直接在pages.json内修改easycom不会触发重新编译，需要改动页面内容触发。
  5. easycom只处理vue组件，不处理小程序专用组件（如微信的wxml格式组件）。不处理后缀为.nvue的组件。因为nvue页面引入的组件也是.vue组件。可以参考uni ui，使用vue后缀，同时兼容nvue页面。
  6. nvue页面里引用.vue后缀的组件，会按照nvue方式使用原生渲染，其中不支持的css会被忽略掉。这种情况同样支持easycom。
  7. vue 与 uvue 组件优先级
属性类型默认值描述
autoscanBooleantrue是否开启自动扫描，开启后将会自动扫描符合components/组件名称/组件名称.vue目录结构的组件
customObject-以正则方式自定义组件匹配规则。如果autoscan不能满足需求，可以使用custom自定义匹配规则

如果组件，不符合easycom前述的路径规范。可以在pages.json的easycom节点中自行定义路径规范。
如果需要匹配node_modules内的vue文件，需要使用packageName/path/to/vue-file-$1.vue形式的匹配规则，其中packageName为安装的包名，/path/to/vue-file-$1.vue为vue文件在包内的路径。

"easycom": {
  "autoscan": true,
  "custom": {
    "^uni-(.*)": "@/components/uni-$1.vue", // 匹配components目录内的vue文件
    "^vue-file-(.*)": "packageName/path/to/vue-file-$1.vue" // 匹配node_modules内的vue文件
  }
}

总结

提示：这里对文章进行总结：

例如：以上就是今天要讲的内容，本文仅仅简单介绍了pandas的使用，而pandas提供了大量能使我们快速便捷地处理数据的函数和方法。


http://www.kler.cn/a/390943.html

相关文章：

  • AWS认证SAA-C0303每日一题
  • 在linux中使用nload实时查看网卡流量
  • 基于非时空的离身与反身智能
  • MyBatisPlus 用法详解
  • redhat虚拟机
  • MTSET可溶于DMSO、DMF、THF等有机溶剂，并在水中有轻微的溶解性，91774-25-3
  • 天地图入门|标注|移动飞行|缩放，商用地图替换
  • 自动化新时代：机器取代工作，我们该如何重塑自我？
  • 企业级工位管理：Spring Boot解决方案
  • 自媒体素材10个4K分辨率Premiere胶片漏光划痕特效视频转场过渡模板
  • 【Python3】【力扣题】414. 第三大的数
  • 代码随想录算法训练营第二十天|39. 组合总和、40.组合总和II、131.分割回文串
  • [MySQL]隐式类型转换
  • 为何数据库推荐将IPv4地址存储为32位整数而非字符串？
  • Spring学习笔记(四)
  • Java基于SpringBoot+Vue框架的宠物寄养系统（V2.0），附源码，文档
  • 微软的新模拟器将为 Windows on Arm 带来更多游戏
  • android dvr黑屏
  • Python从0到100（七十一）：Python OpenCV-OpenCV进行红绿灯识别
  • 什么是结构体？什么是联合体？结构体和联合体有什么区别？能否在声明过程当中缺省名字？结构体可以包含函数吗？在 C 和 C++ 中有何不同？
  • 【板栗糖GIS】——如果安装的vscode版本落后了，如何无障碍更新
  • day57 图论章节刷题Part08（拓扑排序、dijkstra（朴素版））
  • C 语言标准库 - ＜errno.h＞
  • 创新培养：汽车零部件图像分割
  • yum配置，文件，命令详解
  • 综合案例铁锅炖（CSS项目大杂烩）