新闻| 文章| 资讯| 行情| 企业| wap手机版| article文章| 首页|会员中心|保存桌面|手机浏览
普通会员

东明市幼翠科技公司

·hover-class

解释:这个属性时当我们写了两个样式的时候,当我们开打开发者工具时看到的时样式1,但是当我们点击样式1的时候会变化成样式2的效果。

wxml

wxss

效果

·hover-stop-propagation

解释:是否阻止父组件的点击状态,就是当我们两个view组件成嵌套关系时,尤其是当父view的样式面积较大而子view的样式面积较小时,会出现当我点击子view时父view也跟着变化,所以此属性的设置可以消除此问题。

没有设置·hover-stop-propagation这个属性时

wxml

wxss

 效果:我们会发现问题,就是:但点击子组件时,子组件在变化的同时父组件也在变化

 设置·hover-stop-propagation这个属性时

wxml

wxss

 效果:我们会发现问题,就是:但点击哪个组件,就只有被点击的组件变化

 ·hover-start-time

解释:当组件有hover-class这个属性时,点击组件时多久才会从样式1变换到样式2

wxml

wxss

效果:当点击组件时会发现,组件没有立即从样式1变换到样式2,而是等了500毫秒

 ·        

解释:当组件有hover-class这个属性时,点击后从样式1变换到样式2之后,在样式2停留多长时间,再变回原来的样式1

wxml

wxss

效果:点击会发现,从样式1变换到样式2后,再样式2停留了一段时间才变回到了原来的样式1

 当然这里有一些常用的属性例如

·indicator-dots        解释:是否显示面板指示点

·autoplay                解释:是否自动切换

·interval                  解释:自动切换时间间隔

·circular                 解释:是否采用衔接滑动

·duration(可不设置,默认值为500ms)                解释:滑动动画时长

一般在真正开发的时候轮播的效果会把上面的几个经常用的属性结合到一起用,下面我会把这几个常用的属性写到一起,来解释

1.带有circular属性的演示

wxml

wxss

效果展示

 2.不带circular属性的演示

wxml

wxss

效果显示

 由以上两个演示我们可以看出什么不同

答案1.的演示结果在显示到最后一个蓝色轮播块的时候后快速往前轮播到第一张红色轮播块,然后再一次的重复轮播

           2.的演示结果在显示到最后一个蓝色轮播块的时候"很丝滑"的进入另一轮重复轮播

这也是·circular ——是否采用衔接滑动起到的效果

注意到wxml里面的结构了吗

要想实现一个轮播的效果,我们采用的组件之间嵌套的方式

注意

<swiper><swiper-item>这两个都是组件哦~但是他们只能以上面的方式存在,所以我们可以把它们称作"上阵父子兵"

以上表格中是我们开发时最常用的几个属性

·scroll-x (默认值:false)               解释:允许横向滚动

·scroll-y(默认值:false)                解释:允许纵向滚动

·scroll-top                                          解释:设置竖向滚动条位置(因为横向的滚动条只能设置上下位置

·scroll-left                                          解释:设置横向滚动条位置(因为纵向的滚动条只能设置左右位置

下面我把开发中用到的两种滚动条的进行分别展示

1.横向(注意设置横向的时应在scroll-view{}中写入 white-space: nowrap;并且在每一个子组件的样式中写入display: inline-block;)

wxml

wxss:

效果展示

 

2.纵向

wxml:

wxss:

效果演示

 

wxml

 wxss

wxml

wxss

wxml

 wxss

wxml

这里注意

用的是组件名写样式

wxml中有组件名(例如上面的<scroll-view></scroll-view>)我们可以直接在wxss中写入组件名进行样式的编写,这一种写样式的方法

举例

wxml

 wxss

·scale-area (默认值:false)解释:当里面的 movable-view 设置为支持双指缩放时,设置此值可将缩放手势生效区域修改为整个movable-area

 常用的几个属性

·direction                解释:movable-view的移动方向,属性值有all、vertical、horizontal、none

·inertia  (默认值:false)                    解释:movable-view是否带有惯性

·scale        (默认值:false)                解释:是否支持双指缩放,默认缩放手势生效区域是在 movable-view 内

wxml

wxss

展示效果

 

·type                解释:icon的类型,有效值:success, success_no_circle, info, warn, waiting, cancel, download, search, clear

·size                解释:icon的大小,单位默认为px,2.4.0起支持传入单位(rpx/px),2.21.3起支持传入其余单位(rem 等)。

·color              解释:icon的颜色,同 css 的color(支持rbg及颜色名

wxml

效果展示

常有的几个属性

·percent                解释:百分比0~100(percent="xxx")xxx是输入的数字如:输入20,进度条会以20%的进度渲染

·show-info   (默认值)          解释:在进度条右侧显示百分比

·border-radius                解释:圆角大小(与wxss样式属性一样

·font-size(默认值:16)解释:右侧百分比字体大小(与wxss样式属性一样

·stroke-width(默认值:6)                     解释:进度条线的宽度

wxml

效果演示(当然以后开发熟悉了以后,可以通过js中一些逻辑事件函数来控制动态

 

解释:此组件只能存放及字母及数字

解释:此组件的样式与wxss中规定的样式一致,此组件可以通过绑定点击事件与Javascript之间联系完成开发者想要的逻辑事件

举例

wxml

js

效果显示

·checked(默认值)                解释:当前是否选中,可用来设置默认选中

 举例

说明:当前我们只是演示静态的组件内容,以后会讲到他与Javascript之间的通信(数据的传输

wxml

效果展示

将组件内的用户输入的switch input checkbox slider radio picker 提交。

当点击 form 表单中 form-type 为 submit 的 button 组件时,会将表单组件中的 value 值进行提交,需要在表单组件中加上 name 来作为 key。

他作为一个与Javascript相结合使用的组件,我们之后会仔细的讲到!现在我们只知道这个概念就ok

·value (string字符串类型)               解释:输入框的初始内容

·type        (string字符串类型)          解释:input 的类型

举例

wxml

 

js

 

效果展示

1.右下角按钮为“发送”

wxml

 

效果

 2.右下角按钮为“搜索”

wxml

 

 效果

 3.右下角按钮为“下一步”

wxml

 

效果

 4.右下角按钮为“前往/开始”

wxml

 

效果

 5.右下角按钮为“完成”

wxml

 

效果

·header-text                解释:选择器的标题,仅安卓可用

·mode                         解释:选择器类型

mode的类型包括

举例

1.selector:普通选择器

wxml

 

js

 

效果展示

 2.multiSelector:多列选择器

wxml

 

js

 

效果

 3.time:时间选择器

wxml

 

js

 

效果

 4.date:日期选择器

wxml

 

js

 

效果

5. region:省市区选择器

wxml

 

js

 

举例:单项选择器和多项选择器一样,都是与js的后台相同,但是我们这里先进行静态的编写(之后会讲解js相关

wxml

 

效果

·min                解释:最小值

·max                解释:最大值

举例

wxml

 

效果

 

wxml

 效果

wxml

效果:当我们用手机点击时会触发不同的效果

这里的图片路径是我之前传在我的云端中的

用法和image相同也是:src导入路径即可

功能

扫码二维码功能,需升级微信客户端至6.7.3。需要用户授权 。 2.10.0起 initdone 事件返回 maxZoom,最大变焦范围,相关接口 CameraContext.setZoom。

wxml

 js

效果显示

 

企业列表
新闻列表
  • 暂无新闻
推荐企业新闻
联系方式
  • 联系人:李女士
首页 > 新闻中心 > 两万字:讲述微信小程序之组件
新闻中心
两万字:讲述微信小程序之组件
发布时间:2024-11-12        浏览次数:1        返回列表

我是c站的一个小博主,近期我会每天分享前端知识包括(原生的web语句,以及vue2和vue3微信小程序的写法及知识点)本篇文章收录于微信小程序专栏中,如果想每天在我这学到一些东西,请关注我并订阅专栏,每天都分享前端知识哦~

两万字:讲述微信小程序之组件

目录

前言

组件书写的格式

所有组件有哪些及码文结合解释

一、视图容器

1.view

·hover-class

​编辑

·hover-stop-propagation

没有设置·hover-stop-propagation这个属性时

​编辑

 设置·hover-stop-propagation这个属性时

​编辑

 ·hover-start-time

 ·        

 2.swiper(轮播

 当然这里有一些常用的属性例如

 由以上两个演示我们可以看出什么不同

注意到wxml里面的结构了吗

注意

3.scroll-view(可滚动视图

以上表格中是我们开发时最常用的几个属性

微信小程序中具体的写方式的方法常见的几种

1.通过calss写样式

 2.通过id写样式

 3.通过组件名写样式

4.通过wxml内部写样式

 4.movable-area(可移动、放大区域,父组件

5.movable-view(可移动、放大区域,子组件

 常用的几个属性

6.cover-image目前原生组件均已支持同层渲染,建议使用 image 替代

7.cover-view目前原生组件均已支持同层渲染,建议使用 view 替代

二、基本内容

1.icon(图标

2.progress(进度条

常有的几个属性

3.text(文本组件

3.表单组件(常常与Javascript结合完成逻辑事件

1.button(按钮

2. checkbox(多选项目

3.checkbox-group(多项选择器,内部由多个checkbox组成。

 4.form(表单

5.input(输入框

type类型

 /confirm/i-type类型

 举例

1.右下角按钮为“发送”

 2.右下角按钮为“搜索”

 3.右下角按钮为“下一步”

 4.右下角按钮为“前往/开始”

 5.右下角按钮为“完成”

 6.picker(从底部弹起的滚动选择器

举例

1.selector:普通选择器

 2.multiSelector:多列选择器

 3.time:时间选择器

 4.date:日期选择器

5. region:省市区选择器

 

7.radio(单选项目)

8.radio-group(单项选择器,内部由多个 radio 组成)

 9.slider(滑动选择器

10.switch(开关选择器

 11.textarea(多行输入框

 4.媒体组件

1.image(存放图片组件

2.video(存视频组件

3.camera(系统相机


        组件是视图层的组成单元,具备UI风格样式以及特定的功能效果。当打开某款小程序后,界面中的图片、文字等都需要使用组件,小程序组件使用灵活,组件之间通过相互嵌套进行界面设计,开发者可以通过组件的选择属性设计出不同的界面效果。一个组件包括开始标签和结束标签,属性用来装饰这个组件的样式。

 
属性类型默认值必填说明最低版本
hover-classstringnone指定按下去的样式类。当  时,没有点击态效果1.0.0
hover-stop-propagationbooleanfalse指定是否阻止本节点的祖先节点出现点击态1.5.0
hover-start-timenumber50按住后多久出现点击态,单位毫秒1.0.0
hover-stay-timenumber400手指松开后点击态保留时间,单位毫秒1.0.0
属性类型默认值必填说明
indicator-dotsbooleanfalse是否显示面板指示点1.0.0
indicator-colorcolorrgba(0, 0, 0, .3)指示点颜色1.1.0
indicator-active-colorcolor#000000当前选中的指示点颜色1.1.0
autoplaybooleanfalse是否自动切换1.0.0
currentnumber0当前所在滑块的 index1.0.0
intervalnumber5000自动切换时间间隔1.0.0
durationnumber500滑动动画时长1.0.0
circularbooleanfalse是否采用衔接滑动1.0.0
verticalbooleanfalse滑动方向是否为纵向1.0.0
previous-marginstring"0px"前边距,可用于露出前一项的一小部分,接受 px 和 rpx 值1.9.0
next-marginstring"0px"后边距,可用于露出后一项的一小部分,接受 px 和 rpx 值1.9.0
snap-to-edgebooleanfalse当 swiper-item 的个数大于等于 2,关闭 circular 并且开启 previous-margin 或 next-margin 的时候,可以指定这个边距是否应用到第一个、最后一个元素2.12.1
display-multiple-itemsnumber1同时显示的滑块数量1.9.0
easing-functionstring"default"指定 swiper 切换缓动动画类型2.6.5
属性类型默认值必填说明
scroll-xbooleanfalse允许横向滚动1.0.0
scroll-ybooleanfalse允许纵向滚动1.0.0
scroll-topnumber/string设置竖向滚动条位置1.0.0
scroll-leftnumber/string设置横向滚动条位置1.0.0
属性类型默认值必填说明最低版本
scale-areaBooleanfalse当里面的 movable-view 设置为支持双指缩放时,设置此值可将缩放手势生效区域修改为整个movable-area1.9.90
属性类型默认值必填说明最低版本
directionstringnonemovable-view的移动方向,属性值有all、vertical、horizontal、none1.2.0
inertiabooleanfalsemovable-view是否带有惯性1.2.0
out-of-boundsbooleanfalse超过可移动区域后,movable-view是否还可以移动1.2.0
xnumber/string定义 x 轴方向的偏移,如果 x 的值不在可移动范围内,会自动移动到可移动范围;改变 x 的值会触发动画;单位支持px(默认)、rpx1.2.0
ynumber/string定义 y 轴方向的偏移,如果 y 的值不在可移动范围内,会自动移动到可移动范围;改变 y 的值会触发动画;单位支持px(默认)、rpx1.2.0
dampingnumber20阻尼系数,用于控制 x 或y改变时的动画和过界回弹的动画,值越大移动越快1.2.0
frictionnumber2摩擦系数,用于控制惯性滑动的动画,值越大摩擦力越大,滑动越快停止;必须大于0,否则会被设置成默认值1.2.0
disabledbooleanfalse是否禁用1.9.90
scalebooleanfalse是否支持双指缩放,默认缩放手势生效区域是在 movable-view 内1.9.90
scale-minnumber0.5定义缩放倍数最小值1.9.90
scale-maxnumber10定义缩放倍数最大值1.9.90
scale-valuenumber1定义缩放倍数,取值范围为 0.5 - 101.9.90
animationbooleantrue是否使用动画2.1.0
属性类型默认值必填说明最低版本
typestringicon的类型,有效值:success, success_no_circle, info, warn, waiting, cancel, download, search, clear1.0.0
sizenumber/string23icon的大小,单位默认为px,2.4.0起支持传入单位(rpx/px),2.21.3起支持传入其余单位(rem 等)。1.0.0
colorstringicon的颜色,同 css 的color1.0.0
属性类型默认值必填说明最低版本
percentnumber百分比0~1001.0.0
show-infobooleanfalse在进度条右侧显示百分比1.0.0
border-radiusnumber/string0圆角大小2.3.1
font-sizenumber/string16右侧百分比字体大小2.3.1
stroke-widthnumber/string6进度条线的宽度1.0.0
colorstring#09BB07进度条颜色(请使用activeColor1.0.0
activeColorstring#09BB07已选择的进度条的颜色1.0.0
backgroundColorstring#EBEBEB未选择的进度条的颜色1.0.0
activebooleanfalse进度条从左往右的动画1.0.0
active-modestringbackwardsbackwards: 动画从头播;forwards:动画从上次结束点接着播1.7.0
durationnumber30进度增加1%所需毫秒数2.8.2
bindactiveendeventhandle动画完成事件2.4.1
属性类型默认值必填说明最低版本
valuestringcheckbox标识,选中时触发checkbox-group的 change 事件,并携带 checkbox 的 value1.0.0
disabledbooleanfalse是否禁用1.0.0
checkedbooleanfalse当前是否选中,可用来设置默认选中1.0.0
colorstring#09BB07checkbox的颜色,同 css 的color1.0.0
属性类型默认值必填说明最低版本
bindchangeEventHandlecheckbox-group中选中项发生改变时触发 change 事件,detail = {value:[选中的 checkbox 的value的数组]}1.0.0
属性类型默认值必填说明
valuestring输入框的初始内容1.0.0
typestringtextinput 的类型1.0.0
passwordbooleanfalse是否是密码类型1.0.0
placeholderstring输入框为空时占位符1.0.0
placeholder-stylestring指定 placeholder 的样式1.0.0
placeholder-classstringinput-placeholder指定 placeholder 的样式类1.0.0
disabledbooleanfalse是否禁用1.0.0
maxlengthnumber140最大输入长度,设置为 -1 的时候不限制最大长度1.0.0
cursor-spacingnumber0指定光标与键盘的距离,取 input 距离底部的距离和 cursor-spacing 指定的距离的最小值作为光标与键盘的距离1.0.0
auto-focusbooleanfalse(即将废弃,请直接使用 focus )自动聚焦,拉起键盘1.0.0
focusbooleanfalse获取焦点1.0.0
/confirm/i-typestringdone设置键盘右下角按钮的文字,仅在type='text'时生效1.1.0
always-embedbooleanfalse强制 input 处于同层状态,默认 focus 时 input 会切到非同层状态 (仅在 iOS 下生效)2.10.4
/confirm/i-holdbooleanfalse点击键盘右下角按钮时是否保持键盘不收起1.1.0
cursornumber指定 focus 时的光标位置1.5.0
selection-startnumber-1光标起始位置,自动聚集时有效,需与 selection-end 搭配使用1.9.0
selection-endnumber-1光标结束位置,自动聚集时有效,需与 selection-start 搭配使用1.9.0
adjust-positionbooleantrue键盘弹起时,是否自动上推页面1.9.90
hold-keyboardbooleanfalsefocus时,点击页面的时候不收起键盘2.8.2
safe-password-cert-pathstring安全键盘加密公钥的路径,只支持包内路径2.18.0
safe-password-lengthnumber安全键盘输入密码长度2.18.0
safe-password-time-stampnumber安全键盘加密时间戳2.18.0
safe-password-noncestring安全键盘加密盐值2.18.0
text文本输入键盘
number数字输入键盘
idcard身份证输入键盘
digit带小数点的数字键盘
safe-password密码安全输入键盘 
nickname昵称输入键盘
合法值说明
send右下角按钮为“发送”
search右下角按钮为“搜索”
next右下角按钮为“下一个”
go右下角按钮为“前往”
done右下角按钮为“完成”
属性类型默认值必填说明
header-textstring选择器的标题,仅安卓可用2.11.0
modestringselector选择器类型1.0.0
disabledbooleanfalse是否禁用1.0.0
bindcanceleventhandle取消选择时触发1.9.90
selector普通选择器
multiSelector多列选择器
time时间选择器
date日期选择器
region省市区选择器
属性类型默认值必填说明最低版本
valuestringradio 标识。当该radio 选中时,radio-group 的 change 事件会携带radio的value1.0.0
checkedbooleanfalse当前是否选中1.0.0
disabledbooleanfalse是否禁用1.0.0
colorstring#09BB07radio的颜色,同 css 的color1.0.0
属性类型默认值必填说明最低版本
minnumber0最小值1.0.0
maxnumber100最大值1.0.0
stepnumber1步长,取值必须大于 0,并且可被(max - min)整除1.0.0
disabledbooleanfalse是否禁用1.0.0
valuenumber0当前取值1.0.0
colorcolor#e9e9e9背景条的颜色(请使用 backgroundColor1.0.0
selected-colorcolor#1aad19已选择的颜色(请使用 activeColor1.0.0
activeColorcolor#1aad19已选择的颜色1.0.0
backgroundColorcolor#e9e9e9背景条的颜色1.0.0
block-sizenumber28滑块的大小,取值范围为 12 - 281.9.0
block-colorcolor#ffffff滑块的颜色1.9.0
show-valuebooleanfalse是否显示当前 value1.0.0
bindchangeeventhandle完成一次拖动后触发的事件,event.detail = {value}1.0.0
bindchangingeventhandle拖动过程中触发的事件,event.detail = {value}2.18.0
属性类型默认值必填说明最低版本
valuestring输入框的内容1.0.0
placeholderstring输入框为空时占位符1.0.0
placeholder-stylestring指定 placeholder 的样式,目前仅支持 color ,font-size和font-weight1.0.0
placeholder-classstringtextarea-placeholder指定 placeholder 的样式类1.0.0
disabledbooleanfalse是否禁用1.0.0
maxlengthnumber140最大输入长度,设置为 -1 的时候不限制最大长度1.0.0
auto-focusbooleanfalse自动聚焦,拉起键盘。1.0.0
focusbooleanfalse获取焦点1.0.0
auto-heightbooleanfalse是否自动增高,设置 auto-height 时,style.height不生效1.0.0
fixedbooleanfalse如果 textarea 是在一个 `position:fixed` 的区域,需要显示指定属性 fixed 为 true1.0.0
cursor-spacingnumber0指定光标与键盘的距离。取`textarea`距离底部的距离和`cursor-spacing`指定的距离的最小值作为光标与键盘的距离1.0.0
cursornumber-1指定 focus 时的光标位置1.5.0
show-/confirm/i-barbooleantrue是否显示键盘上方带有”完成“按钮那一栏1.6.0
selection-startnumber-1光标起始位置,自动聚集时有效,需与`selection-end`搭配使用1.9.0
selection-endnumber-1光标结束位置,自动聚集时有效,需与`selection-start`搭配使用1.9.0
adjust-positionbooleantrue键盘弹起时,是否自动上推页面1.9.90
hold-keyboardbooleanfalsefocus时,点击页面的时候不收起键盘2.8.2
disable-default-paddingbooleanfalse是否去掉 iOS 下的默认内边距2.10.0
/confirm/i-typestringreturn设置键盘右下角按钮的文字2.13.0