常用列表
常在iOS应用中看到的列表,是种多功能且强大的交互组件。列表将数据展现在一个可滚动的多行的列表中。
列表有以下用途:
- 让用户可以浏览结构化的多级数据
- 展现一个索引列表
- 在可视化的不同分组中,显示详细信息和控件
- 展现一个可以选择的列表
样式说明
-
ui-list-block
- 列表组件的顶层标示。 必选
元素。
-
ui-list-item-content
- 列表项的主要弹性(flex)容器。 必选
元素。
-
ui-list-item-link
- 需要该项有点击效果的时候,在该项最外层添加该样式。
可选
元素。
-
ui-list-item-inner
-
ui-list-item-title
和
ui-list-item-after
的主要弹性(flex)容器。
必选
元素。
-
ui-list-item-title
- 单行列表项目标题。
必选
元素。
-
ui-list-item-title
- 单行列表项目标题,帶箭頭。
可选
元素。
-
ui-list-item-after
- 列表项目标签。可以包含任意额外的html元素(例如标签文本、徽章、switch/toggle、按钮等等)。
可选
元素。
自定义列表(Custom List View)
自定义列表满足了个性化的列表需求
样式说明
-
ui-switch
- switch组件标示。 必选
元素。
-
ui-active
- switch组件默认开启标示。 可选
元素。
-
ui-switch-handle
- switch组件滑动按钮样式
可选
元素。
-
ui-badge
- 标记样式。
必选
元素。
-
ui-badge-red
- 标记颜色样式(紅色)。
可选
元素。
-
ui-btn
- 按钮样式。
必选
元素。
-
ui-btn-blue
- 按钮颜色样式。
可选
元素。
多媒体列表(Media List View)
多媒体列表是列表(list view)的扩展,它是为了展示更复杂的数据比如产品,服务,用户等等。
当然,它的布局更为复杂:
样式说明
-
ui-media-list
- 媒体列表组件标示。 必选
元素。
-
ui-item-media
- 媒体项标示。 必选
元素。
-
ui-list-item-title-row
- 媒体项主标题样式
可选
元素。
-
ui-media-item-subtitle
- 媒体项副标题样式。
可选
元素。
-
ui-list-item-after
- 媒体项标题补充。
可选
元素。
-
ui-media-item-text
- 媒体项文字描述样式。
可选
元素。
-
ui-media-inset
- 媒体项图标控制样式。
可选
元素。
滑动删除列表(Swipe List View)
滑动删除列表是列表(list view)的扩展,它是为了实现更复杂的数据操作。
当然,它的布局更为复杂:
JS 部分
通过swipelist方法返回一个或多个滑动列表对象的数组(根据选择器选到的dom对象个数)
样式说明
-
ui-swipeout
- 滑动列表组件标示。 必选
元素。
-
ui-swipeout-content
- 滑动列表项内容样式。 必选
元素。
-
ui-swipeout-actions-right
- 滑动列表右侧可滑动样式标示
可选
元素。
-
ui-swipeout-actions-left
- 滑动列表左侧可滑动样式标示。
可选
元素。
-
ui-swipeout-delete
- 删除按钮样式。
可选
元素。
-
ui-bg-orange
- 橙色背景样式。
可选
元素。
-
ui-bg-blue
- 蓝色背景样式。
可选
元素。
-
ui-bg-green
- 绿色背景样式。
可选
元素。
事件
在操作过程中可以通过以下事件来控制滑动删除的操作。
事件 |
参数 |
说明 |
open |
event, swip ,其中swip 是当前操作的滑块对象,可通过该对象调用滑动列表的方法 |
滑块被打开时触发 |
opened |
event, swip ,其中swip 是当前操作的滑块对象,可通过该对象调用滑动列表的方法 |
滑块被打开后触发 |
delete |
event, swip ,其中swip 是当前操作的滑块对象,可通过该对象调用滑动列表的方法 |
点击加有删除样式的按钮时触发,回调函数返回true直接删除,返回false则不执行删除,可做其他操作后通过回调函数返回的swip对象进行删除操作 |
deleted |
event, swip ,其中swip 是当前操作的滑块对象,可通过该对象调用滑动列表的方法 |
删除成功后出发 |
close |
event, swip ,其中swip 是当前操作的滑块对象,可通过该对象调用滑动列表的方法 |
关闭滑块时触发 |
closed |
event, swip ,其中swip 是当前操作的滑块对象,可通过该对象调用滑动列表的方法 |
关闭滑块后出发 |
tapped |
event, swip ,其中swip 是当前操作的滑块对象,可通过该对象调用滑动列表的方法 |
列表项被点击时触发 |
方法
在操作过程中可以通过以下方法来控制滑动删除的操作。
方法 |
参数 |
说明 |
close |
callback 操作成功回调函数 |
关闭滑块 |
delete |
callback 操作成功回调函数 |
删除当前行 |
折叠列表(Accordion List View)
JS 部分
通过accordionList方法返回一个或多个折叠列表对象的数组(根据选择器选到的dom对象个数)
样式说明
-
ui-accordion-list
- 折叠列表组件标示。 必选
元素。
-
ui-accordion-list-item
- 列表项样式。 必选
元素。
-
ui-accordion-list-item-link
- 列表项点击样式
必选
元素。
-
ui-accordion-list-item-inner
- 列表项标题内容样式。
必选
元素。
-
ui-accordion-list-item-content
- 列表项内容容器样式。
可选
元素。
属性
属性 |
取值范围 |
默认值 |
说明 |
toggleClose |
true /false |
true |
在打开折叠列表时是否自动关闭其他已经打开的项 |
事件
在操作过程中可以通过以下事件来控制折叠列表的操作。
事件 |
参数 |
说明 |
tapped |
event, el ,其中el 是当前操作的列表项的Zepto 对象 |
列表项被点击时若无内容项则触发 |
open |
event, el ,其中el 是当前操作的列表项的Zepto 对象 |
列表项被点击时若有内容项则触发 |
opened |
event, el ,其中el 是当前操作的列表项的Zepto 对象 |
列表项被展开后触发 |
close |
event, el ,其中el 是当前操作的列表项的Zepto 对象 |
列表项被折叠时触发 |
closed |
event, el ,其中el 是当前操作的列表项的Zepto 对象 |
列表项被折叠后触发 |
手风琴(Accordion)
JS 部分
通过accordion方法返回一个或多个手风琴对象的数组(根据选择器选到的dom对象个数)
样式说明
-
ui-accordion
- 手风琴组件标示。 必选
元素。
-
ui-accordion-item
- 手风琴单项样式
必选
元素。
-
ui-accordion-item-link
- 手风琴单项点击样式。
必选
元素。
-
ui-accordion-item-inner
- 手风琴单项标题内容样式。
必选
元素。
-
ui-accordion-item-expanded
- 手风琴单项展开样式(添加该样式默认展开)
可选
元素。
-
ui-accordion-item-content
- 手风琴单项内容区域样式。
必选
元素。
-
ui-accordion-level1
- 手风琴第一级顶层样式。 必选
元素。
-
ui-accordion-level2
- 手风琴第二级顶层样式。
可选
元素。
-
ui-accordion-level3
- 手风琴第三级顶层样式。
可选
元素。
属性
属性 |
取值范围 |
默认值 |
说明 |
toggleClose |
true /false |
true |
手风琴在打开单项时是否自动关闭其他已经打开的项 |
事件
在操作过程中可以通过以下事件来控制手风琴的操作。
事件 |
参数 |
说明 |
open |
event, el ,其中el 是当前操作的手风琴项Zepto 对象 |
手风琴被展开时触发 |
opened |
event, el ,其中el 是当前操作的手风琴项Zepto 对象 |
手风琴被展开后触发 |
close |
event, el ,其中el 是当前操作的手风琴项Zepto 对象 |
手风琴被展开关闭时触发 |
closed |
event, el ,其中el 是当前操作的手风琴项Zepto 对象 |
手风琴被关闭后触发 |
底部导航(TabBar)
JS 部分
样式说明
-
ui-tab-bar
- 底部导航组件标示。 必选
元素。
-
ui-tab-item
- 底部导航子元素样式
必选
元素。
-
ui-icon ui-icon-email
- 底部导航图标样式。
必选
元素。
-
ui-tab-label
- 底部导航描述样式。
可选
元素。
属性
属性 |
取值范围 |
默认值 |
说明 |
active |
Number |
0 |
初始选中下标(从0开始) |
事件
在操作过程中可以通过以下事件来控制底部导航的操作。
事件 |
参数 |
说明 |
activate |
event, to, from
,其中
to
当前选中的下标,
from
来源的下标
|
发生切换时触发 |
方法
在操作过程中可以通过以下方法来控制底部导航的操作。
方法 |
参数 |
说明 |
switchTo |
index :目标的下标
|
切换到目标项 |
顶部导航(Navigator)
JS 部分
样式说明
-
ui-navigator
- 顶部导航组件标示。 必选
元素。
-
ui-navigator-list
- 顶部导航列表样式 必选
元素。
属性
属性 |
取值范围 |
默认值 |
说明 |
active |
Number
|
0
|
初始选中下标(从0开始) |
事件
在操作过程中可以通过以下事件来控制顶部导航的操作。
事件 |
参数 |
说明 |
switch |
event, to, li
,其中
to
当前选中的下标,
li
选中的html对象
|
发生切换时触发 |
方法
在操作过程中可以通过以下方法来控制底部导航的操作。
方法 |
参数 |
说明 |
switchTo |
index
:目标的下标
|
切换到目标项 |
滚屏(Fullpage)
JS 部分
通过fullpage方法返回一个或多个滚屏对象的数组(根据选择器选到的dom对象个数)
样式说明
-
ui-fullpage
- 滚屏组件标示。 必选
元素。
-
ui-fullpage-page
- 滚屏页样式
必选
元素。
-
ui-fullpage-pageinner
- 滚屏内容区域样式。
必选
元素。
属性
属性 |
取值范围 |
默认值 |
说明 |
loop |
true /false |
false |
是否循环滚动 |
gesture |
true /false |
false |
是否手势跟随 |
dots |
true /false |
false |
是否显示滚动点 |
arrow |
true /false |
false |
是否显示向上指示箭头 |
speed |
Number(毫秒) |
500 |
滚动动画的速度 |
fullPage |
true /false |
true |
是否撑满整屏(取false时,默认以组件的父对象的高度为准) |
事件
在操作过程中可以通过以下事件来控制滚屏组件的操作。
事件 |
参数 |
说明 |
beforeChange |
event, cur, next ,其中cur 是当前页的下标,next 是目标页的下标 |
将要改变显示页之前触发 |
change |
event, cur, next ,其中cur 是当前页的下标,next 是目标页的下标 |
发生改变显示页时触发 |
afterChange |
event, cur ,其中cur 是当前页的下标 |
发生改变显示页后触发 |
方法
在操作过程中可以通过以下方法来控制滚屏组件的操作。
方法 |
参数 |
说明 |
start |
无 |
使滚屏对象可以滚动 |
stop |
无 |
禁止滚屏对象滚动 |
moveTo |
next 目标页的下标(从0 开始) |
移动到目标页 |
prev |
无 |
移动到上一页 |
next |
无 |
移动到下一页 |
getCurIndex |
无 |
获取当前页的下标 |
搜索框(Searchbar)
JS 部分
通过searchbar方法返回一个或多个搜索框对象的数组(根据选择器选到的dom对象个数)
样式说明
-
ui-searchbar
- 搜索框组件标示。 必选
元素。
-
ui-searchbar-container
- 搜索框容器样式。 必选
元素。
-
ui-searchbar-input
- 搜索框样式
必选
元素。
-
ui-searchbar-content
- 搜索内容区域样式。
可选
元素。
-
ui-list-block ui-searchbar-list
- 搜索列表样式。
可选
元素。
-
ui-list-item-content ui-searchbar-item
- 搜索列表项样式。
可选
元素。
-
ui-list-item-inner
- 搜索列表项内容样式。
可选
元素。
-
ui-list-item-title
- 搜索项标题样式。
可选
元素。
-
ui-searchbar-key
- 搜索项标示。
可选
元素。
-
ui-searchbar-ignore
- 搜索项排除标示(添加该样式始终显示)。
可选
元素。
属性
属性 |
取值范围 |
默认值 |
说明 |
customSearch |
true /false |
false |
是否启用自定义搜索(当该值为true时,可通过监听search事件来进行自定义搜索) |
cancel |
Sting |
取消 |
取消按钮显示内容 |
事件
在操作过程中可以通过以下事件来控制搜索框的操作。
事件 |
参数 |
说明 |
enableSearch |
event |
当搜索栏可以进行搜索时触发 |
disableSearch |
event |
搜索栏由可搜索状态变为普通状态时触发 |
clearSearch |
event |
清空搜索栏时触发 |
search |
event, query, foundItems ,其中query 是当前搜索栏的输入内容,foundItems 当customSearch为false时,传入的搜索结果集数组 |
进行搜索时触发 |
方法
在操作过程中可以通过以下方法来控制搜索框的操作。
方法 |
参数 |
说明 |
enable |
无 |
使搜索栏处于搜索状态 |
disable |
无 |
使搜索栏处于普通状态 |
clear |
无 |
清空搜索栏 |
search |
query 搜索关键字 |
根据传入值进行搜索 |
图片浏览器(Photobrowser)
JS 部分
通过photobrowser方法返回一个或多个图片浏览器对象的数组(根据选择器选到的dom对象个数)
样式说明
-
ui-photo-browser
- 图片浏览器组件标示。 必选
元素。
-
ui-photo-browser-container
- 图片浏览器组件内容区域样式。 必选
元素。
-
ui-slider-item
- 图片内容项样式
必选
元素。
-
ui-slider-img
- 图片样式。
必选
元素。
属性
属性 |
取值范围 |
默认值 |
说明 |
loop |
true /false |
false |
是否循环播放 |
speed |
Number(毫秒) |
400 |
滚动动画的速度 |
index |
Number |
0 |
默认显示的图片下标(从0开始) |
captions |
图片的描述(array) |
无 |
针对每张图片的描述数组 |
light |
true /false |
false |
是否采用白背景模式,默认为黑色系 |
space |
Number |
10 |
图片间的间隔 |
方法
在操作过程中可以通过以下方法来控制滑动删除的操作。
方法 |
参数 |
说明 |
open |
index 需要打开的图片下标 |
打开图片浏览器 |
moveTo |
next 目标图片的下标 |
移动到指定下标的图片 |
prev |
无 |
移动到上一张图片 |
next |
无 |
移动到下一张图片 |
close |
无 |
关闭图片浏览器 |
图片懒加载(Lazyloadimage)
JS 部分
通过lazyloadimage方法返回一个或多个图片懒加载对象的数组(根据选择器选到的dom对象个数)
样式说明
-
ui-lazy-loader
- 图片懒加载组件顶层标示。 必选
元素。
-
ui-lazy-loader-content
- 图片懒加载组件内容区域样式。 必选
元素。
-
ui-lazy
- 延迟加载项样式
必选
元素。
属性
属性 |
取值范围 |
默认值 |
说明 |
placeholderSrc |
Sting
|
data:image/png;base64,iVBORw0K
GgoAAAANSUhEUgAAAAEAAAABAQMAAAAl21bK
AAAAA1BMVEXCwsK592mkAAAACklEQVQI12Ng
AAAAAgAB4iG8MwAAAABJRU5ErkJggg==
|
默认图片站位图,base64图片格式 |
lazyContent |
selector(样式选择器)
|
.ui-lazy-loader-content
|
需要进行图片加载的区域 |
列表刷新(Refresh)
JS 部分
通过refresh方法返回一个或多个列表刷新对象的数组(根据选择器选到的dom对象个数)
属性
属性 |
取值范围 |
默认值 |
说明 |
down |
JSON
|
|
下拉配置项 |
up |
JSON
|
|
上拉配置项 |
enablePulldown |
true
/
false
|
true
|
是否可以下拉 |
enablePullup |
true
/
false
|
true
|
是否可以上拉 |
事件
在操作过程中可以通过以下事件来控制列表刷新的操作。
事件 |
参数 |
说明 |
pulldown |
event, refresh
,其中
refresh
是当前操作的列表刷新对象,可通过该对象调用列表刷新的方法
|
执行下拉刷新时触发 |
pullup |
event, refresh
,其中
refresh
是当前操作的列表刷新对象,可通过该对象调用列表刷新的方法
|
执行上拉加载时触发 |
方法
在操作过程中可以通过以下方法来控制列表刷新的操作。
方法 |
参数 |
说明 |
pulldownLoading |
无
|
执行下拉刷新 |
pullupLoading |
无
|
执行上拉加载 |
endPulldownToRefresh |
无
|
结束下拉刷新 |
endPullupToRefresh |
boolean 类型,
可选 ,为true时标志无更多数据
|
结束上拉加载 |
disablePulldown |
无
|
禁止下拉刷新 |
disablePullup |
无
|
禁止上拉加载 |
enablePulldown |
无
|
启用下拉刷新 |
enablePullup |
无
|
启用上拉加载 |
轮播图(Slider)
JS 部分
通过slider方法返回一个或多个轮播图对象的数组(根据选择器选到的dom对象个数)
样式说明
-
ui-slider
- 轮播图组件标示。 必选
元素。
-
ui-slider-group
- 手轮播图容器对象样式
必选
元素。
-
ui-slider-item
- 轮播图对象样式。
必选
元素。
-
ui-slider-img
- 轮播图内容样式。
必选
元素。
属性
属性 |
取值范围 |
默认值 |
说明 |
loop |
true /false |
false |
是否循环播放 |
speed |
Number (毫秒) |
500 |
轮播图切换速度(毫秒) |
index |
Number |
0 |
默认打开图片的下标 |
autoPlay |
true /false |
false |
是否自动播放 |
interval |
Number (毫秒) |
4000 |
自动播放的间隔时间(毫秒) |
dots |
true /false |
false |
是否显示轮播点 |
touch |
true /false |
true |
是否支持触摸切换 |
mulViewNum |
Number |
1 |
一页显示的图片数量 |
space |
Number |
0 |
图片之间的间隔 |
fullPage |
true /false |
false |
是否全屏显示 |
heightTarget |
'self' /'img' /'parent' |
self |
当fullPage为false时,轮播图高度取决于自身(self)、图片(img)、父对象(parent)三者 |
事件
在操作过程中可以通过以下事件来控制轮播图的操作。
事件 |
参数 |
说明 |
slide |
event, to, from
,其中
to
目标图片的下标,
from
来源图片的下标
|
图片切换时触发 |
slideend |
event, index
,其中
index
是当前图片的下标
|
执行上拉加载时触发 |
moveend |
event, index, dir
,其中
index
是当前图片的下标,
dir
滑动方向(1为向右滑动到头,-1为向左滑动到头)
|
当loop为false时,通过手势触摸滑动到尽头时触发 |
方法
在操作过程中可以通过以下方法来控制轮播图的操作。
方法 |
参数 |
说明 |
play |
无
|
使轮播图处于自动播放状态 |
stop |
无
|
停止自动播放 |
next |
无
|
切换到下一个 |
prev |
无
|
切换到上一个 |
slideTo |
to, [speed] 其中to 为目标图片的下标,speed 为切换速度(可选 )
|
切换到指定下标的图片 |
getIndex |
无
|
获取当前显示图片的下标 |
开关(Switche)
JS 部分
通过switch方法返回一个或多个开关对象的数组(根据选择器选到的dom对象个数)
样式说明
-
ui-switch
- 开关组件标示。 必选
元素。
-
ui-switch-handle
- 开关按钮样式 必选
元素。
-
ui-active
- 开关按钮默认打开样式。
可选
元素。
-
ui-switch-mini
- 小型开关组件样式。
可选
元素。
-
ui-switch-blue
- 开关组件蓝底色样式。
可选
元素。
-
ui-switch-blue
- 开关组件蓝底色样式。
可选
元素。
事件
在操作过程中可以通过以下事件来控制开关对象的操作。
事件 |
参数 |
说明 |
toggle |
event, active
,其中
active
开关的状态,true为打开,false为关闭
|
开关切换时触发 |
方法
在操作过程中可以通过以下方法来控制轮播图的操作。
方法 |
参数 |
说明 |
toggle |
无
|
切换开关组件的状态 |
文本框
样式说明
-
ui-input-group
- 输入框组件外层容器。 必选
元素。
-
ui-input-row
- 输入框组件行容器。 必选
元素。
-
ui-input-clear
- 清除图标样式。
可选
元素。
-
ui-input-speech
- 语音录入样式。
必选
元素。
-
ui-icon ui-icon-speech
- 语音录入图标样式。
必选
元素。
-
ui-checkbox ui-left
- 左侧多选框样式。
可选
元素。
-
ui-radio ui-left
- 左侧单选框样式。
可选
元素。
-
ui-input-textarea
- 文本域样式。
可选
元素。