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

ops/2024/11/14 5:04:41/

文章目录

  • 1、uniapp
  • 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. 支持暗黑模式
      在这里插入图片描述

uview_65">1.uview组件安装

  1. uView依赖SCSS

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

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

  3. NPM方式

    javascript">// 如果您的根目录没有package.json文件的话，请先执行如下命令：
// npm init -ynpm install uview-ui@2.0.38// 更新
// npm update uview-ui

    在这里插入图片描述

  4. 配置步骤

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

uviewplus_138">2.uview-plus组件安装

  1. uView依赖SCSS

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

    javascript">// 如果您的根目录没有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之后。

      javascript">	// main.jsimport uviewPlus from 'uview-plus'// #ifdef VUE3import { createSSRApp } from 'vue'export function createApp() {const app = createSSRApp(App)app.use(uviewPlus)return {app}}// #endif

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

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

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

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

    • 配置easycom组件模式

      javascript">	// 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"

      javascript">{"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"]
}

      javascript"><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中不能重复导入；
javascript">// #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.ppmy.cn/ops/132907.html

相关文章

GNU构建系统和Autotool

GNU构建系统和Autotool

1、前言 经常使用Linux的开发人员或者运维人员&#xff0c;可能对configure->make->make install相当熟悉。事实上&#xff0c;这叫GNU构建系统&#xff0c;利用脚本和make程序在特定平台上构建软件。这种方式成为一种习惯&#xff0c;被广泛使用。本文从用户视角和开发…
阅读更多...
【系统设计】数据库压缩技术详解：从基础到实践（附Redis内存优化实战案例）

【系统设计】数据库压缩技术详解：从基础到实践（附Redis内存优化实战案例）

概述 在现代数据库系统中&#xff0c;压缩技术对于提高存储效率和加速查询性能至关重要。特别是在处理大规模数据时&#xff0c;压缩能够极大地减少存储空间&#xff0c;并优化查询性能。本文将总结几种常见的压缩方式&#xff0c;并通过详细的解释和示例清晰地展示每种压缩方…
阅读更多...
大型语言模型（LLMs）关键技术指南

大型语言模型（LLMs）关键技术指南

在AI这个超火的领域&#xff0c;打好基础真的超级重要&#xff0c;尤其是当你开始研究那些超大型的语言模型&#xff0c;也就是LLMs的时候。这个指南就是想帮新手们把那些听起来高大上的概念变得简单易懂&#xff0c;比如神经网络、自然语言处理&#xff08;NLP&#xff09;还有…
阅读更多...
windows环境下手工创建oracle数据库监听

windows环境下手工创建oracle数据库监听

windows环境下手工创建oracle数据库监听 查看当前的服务名&#xff1a; NAME TYPE VALUE cell_offloadgroup_name string db_file_name_convert string db_name string ORCL db_unique_name string ORCL global_names boolean FALSE instance_name string orcl lock_name_spac…
阅读更多...
【PGCCC】Postgresql slru 缓存和存储

【PGCCC】Postgresql slru 缓存和存储

前言 简单的 lru 缓存管理&#xff08;简称 slru&#xff09;&#xff0c;用于持久化数据并且提供 lru 算法来缓存。slru 在 postgresql 存在着多处使用&#xff0c;比如存储事务状态的 clog 日志&#xff0c;就是使用 slru 来管理的。 缓存和文件的对应关系 文件的数据都是…
阅读更多...
面向对象技术简述(含设计模式)

面向对象技术简述(含设计模式)

6.9.2 面向对象技术 面向对象 对象 分类 继承 通过消息的通信 面向对象 对象 分类 继承 通过消息的通信 面向对象对象分类继承通过消息的通信其中包括&#xff1a; 对象 运行的实体&#xff1b;既包含属性/数据&#xff0c;又包含方法/行为/操作数据的函数&#xff1b;…
阅读更多...
【Django】Clickjacking点击劫持攻击实现和防御措施

【Django】Clickjacking点击劫持攻击实现和防御措施

Clickjacking点击劫持 1、clickjacking攻击2、clickjacking攻击场景 1、clickjacking攻击 clickjacking攻击又称为点击劫持攻击&#xff0c;是一种在网页中将恶意代码等隐藏在看似无害的内容&#xff08;如按钮&#xff09;之下&#xff0c;并诱使用户点击的手段。 2、clickj…
阅读更多...
Android CCodec Codec2 （二十）C2Buffer与Codec2Buffer

Android CCodec Codec2 （二十）C2Buffer与Codec2Buffer

在阅读Codec2框架代码时&#xff0c;我们可能会发现好几个名称中都带有“buffer”的类&#xff0c;如MediaCodecBuffer、ABuffer、CCodecBuffers、Codec2Buffer以及C2Buffer。它们分别是什么&#xff1f;各自承担着什么功能&#xff1f;它们之间有何联系&#xff1f;本文将围绕…
阅读更多...
最新文章

Copyright @ 2022~2023