章节索引 :

uni-app基础组件

1. 前言

组件是视图层的基本组成单元,其实也就是我们经常写的 HTML 标签。有开始标签和结束标签的都可以理解为组件,比如 <div> </div><view> </view>

uni-app 开发规范不推荐使用传统的 HTML 标签。uni-app 框架给我们提供了一系列基础组件,与传统 HTML 中的基础标签元素类似,与小程序中的标签元素是一样的,更适合手机端使用。比如 div 会被 view 标签代替,类似的还有 spantextanavigator 等。

一开始开发会很不习惯,但很容易上手,并且我们不需要担心弄混,如果我们不小心写了 div 这种不符合 uni-app 开发规范的标签,也是不会报错的。在编译到非H5平台时编译器会帮我们转换为 view 标签。

我们可以基于这些 uni-app 组件快速搭建页面的基础结构。下面来看看一些常用组件的应用。

2. view 视图容器

view 相当于传统 HTML 中的 div。用来包裹各种元素内容。

2.1 属性说明

属性 类型 默认值 说明
hover-class String none 点击效果
hover-stop-propagation Boolean false 是否阻止本节点的祖先节点出现点击效果,默认不阻止
hover-start-time Number 50 按住多久出现点击效果,单位毫秒
hover-stay-time Number 400 手指松开后点击效果的保留时间,单位毫秒

2.2 实例

<template>
	<view class="box" hover-class="click_active" :hover-start-time="100" :hover-stay-time='1000'>
	</view>
</template>

<style>
	.box {
		height: 50px;
		background:black;
	}
	.click_active {
	    background: red;
	}
</style>

效果
我们把点击效果设置成了红色。点击后,红色效果会保留1000毫秒。


Tips

  • 如果不小心用了 <div> 标签,编译不会报错,会自动帮我们转换为 <view> 标签。
  • 如果电脑网页版看不到点击效果,可以将切换到手机页面再试试。

3. text 文本组件

3.1 属性说明

属性 类型 默认值 说明
selectable boolean false 文本是否可选
space string . 显示连续空格,可选参数:enspemspnbsp
decode boolean false 是否解码

3.2 实例

<template>
	<view>
		<!-- 长按文本是否可选 -->
		<view>
			<text selectable='true'>长按文本可选</text>
		</view>

		<!-- 显示连续空格的方式 -->
		<view>
			<!-- 中文字符空格一半大小 -->
			<view>
				<text space='ensp'>慕课网 imooc</text>
			</view>
			<!-- 中文字符空格大小 -->
			<view>
				<text space='emsp'>慕课网 imooc</text>
			</view>
			<!-- 根据字体设置的空格大小 -->
			<view>
				<text space='nbsp'>慕课网 imooc</text>
			</view>
		</view>
	</view>
</template>

Tips

  • 如果用了 <span> 组件,编译时会被转换为 <text>
  • 组件内只支持嵌套 <text>,不支持其它组件或自定义组件,否则不同平台会有渲染差异。
  • decode 可以解析的有 < > & '
  • 除了文本节点以外的其他节点都无法长按选中。

4. button 按钮组件

4.1 属性说明

属性名 类型 默认值 说明
size String default 按钮大小
type String default 按钮样式类型
plain Boolean false 按钮是否镂空,背景色透明
disabled Boolean false 是否禁用
loading Boolean false 名称前是否带 loading 图标

4.2 实例

<button size='mini' disabled>被禁用的小按钮</button>
<button  type='warn' loading='true'>名称前带有 loading 图标的红色按钮</button>

效果

Tips

  • 按钮设置 sizemini 时,可以在一行显示多个按钮。size 为默认值时,会独占一行。

5.1 属性说明

属性名 类型 默认值 说明
url String 应用内的跳转链接,值为相对路径或绝对路径
open-type String navigate 跳转方式。navigate 对应 uni.navigateTo 的功能、redirect 对应 uni.redirectTo 的功能、switchTab 对应 uni.switchTab 的功能、reLaunch 对应 uni.reLaunch 的功能、navigateBack 对应 uni.navigateBack 的功能
delta Number 当 open-type 为 ‘navigateBack’ 时有效,表示回退的层数
animation-type String pop-in/out 当 open-type 为 navigate、navigateBack 时有效,窗口的显示/关闭动画效果
animation-duration Number 300 当 open-type 为 navigate、navigateBack 时有效,窗口显示/关闭动画的持续时间

5.2 实例

<template>
    <view>
		<navigator url="/pages/index/index">
			<button>保留当前页面,跳转到应用内的某个页面</button>
		</navigator>
		<navigator url="/pages/index/index" open-type="redirect" >
			<button>关闭当前页面,跳转到应用内的某个页面</button>
		</navigator>
		<navigator url="/pages/index/index" open-type="switchTab">
			<button>跳转tab页面</button>
		</navigator>
    </view>
</template>

6. image 图片组件

6.1 属性说明

属性名 类型 默认值 说明
src String 图片资源地址,支持相对路径和绝对路径
mode String ‘scaleToFill’ 图片裁剪、缩放的模式

6.2 实例

<template>
  <view>
    <!-- 引入存放在根文件夹static下面的imooc.png图片,保持纵横比缩放图片,使图片的长边适应容器的宽度或高度 -->
    <image src="/static/imooc.png" mode="aspectFit"></image>
  </view>
</template>

Tips

  • <image> 组件默认宽度 300px、高度 225px;
  • src 我们前面的小结讲过,支持相对路径和绝对路径,支持 base64 码;

7. 小结

本节课程我们主要学习了 uni-app 的一些常用基础组件,所有组件与属性名都是小写,单词之间以连字符-连接。本节课程的重点如下:

  • 了解 uni-app 基础组件与传统 HTML 基础组件的差异;
  • 掌握 uni-app 常用的基础组件的用法。

了解更多组件内容,可以查看官网:https://uniapp.dcloud.io/component/README