1.5.1 • Published 1 year ago

@wines/cell-group v1.5.1

Weekly downloads
-
License
-
Repository
-
Last release
1 year ago

@wines/cell-group

单元格组 (List 列表)

基础布局组件,布局时基于 cell-groupcell 来定义信息区块的外部框架。

使用指南

在 page.json 中引入组件

{
  "navigationBarTitleText": "List Cell Group",
  "usingComponents": {
    "wux-cell": "@wines/cell",
    "wux-cell-group": "@wines/cell-group"
  }
}

示例

<view class="page">
	<view class="page__hd">
		<view class="page__title">List</view>
		<view class="page__desc">列表</view>
	</view>
	<view class="page__bd">
		<wux-cell-group title="带说明的列表项">
			<wux-cell title="标题文字" />
			<wux-cell title="禁用状态" disabled></wux-cell>
		</wux-cell-group>
		<wux-cell-group title="带图标、说明的列表项">
			<wux-cell thumb="http://cdn.skyvow.cn/logo.png" title="标题文字" extra="说明文字" />
			<wux-cell thumb="http://cdn.skyvow.cn/logo.png" title="标题文字" extra="说明文字" />
		</wux-cell-group>
		<wux-cell-group title="带跳转的列表项" label="底部说明文字">
			<wux-cell title="标题文字" is-link extra="说明文字" />
			<wux-cell
			 title="标题文字"
			 is-link
			 label="附加描述"
			 extra="说明文字"
			/>
			<wux-cell title="只显示箭头" is-link></wux-cell>
			<wux-cell
			 title="跳转到首页"
			 is-link
			 url="/pages/index/index"
			 open-type="switchTab"
			/>
		</wux-cell-group>
		<wux-cell-group title="微信开放能力">
			<wux-cell
			 title="打开客服会话"
			 is-link
			 open-type="contact"
			 bind:contact="onContact"
			/>
			<wux-cell title="触发用户转发" is-link open-type="share" />
			<wux-cell
			 title="获取用户信息"
			 is-link
			 open-type="getUserInfo"
			 bind:getuserinfo="onGotUserInfo"
			/>
			<wux-cell
			 title="获取用户手机号"
			 is-link
			 open-type="getPhoneNumber"
			 bind:getphonenumber="onGotPhoneNumber"
			/>
		</wux-cell-group>
	</view>
</view>

API

CellGroup props

参数类型描述默认值
prefixClsstring自定义类名前缀wux-cell-group
titlestring标题-
labelstring描述-

CellGroup externalClasses

名称描述
wux-class根节点样式类

Cell props

参数类型描述默认值
prefixClsstring自定义类名前缀wux-cell
disabledboolean是否禁用false
openTypestring跳转方式,可选值为 navigateTo、redirectTo、switchTab、navigateBack、reLaunch;微信开放能力,可选值为 contact、share、getUserInfo、getPhoneNumber、launchApp、openSetting、feedbacknavigateTo
hoverClassstring指定按下去的样式类。当 hover-class="none" 时,没有点击态效果default
hoverStopPropagationboolean指定是否阻止本节点的祖先节点出现点击态false
hoverStartTimenumber按住后多久出现点击态,单位毫秒20
hoverStayTimenumber手指松开后点击态保留时间,单位毫秒70
langstring指定返回用户信息的语言,zh_CN 简体中文,zh_TW 繁体中文,en 英文。en
sessionFromstring会话来源-
sendMessageTitlestring会话内消息卡片标题当前标题
sendMessagePathstring会话内消息卡片点击跳转小程序路径当前分享路径
sendMessageImgstring会话内消息卡片图片截图
showMessageCardboolean显示会话内消息卡片false
appParameterstring打开 APP 时,向 APP 传递的参数-
thumbstring左侧缩略图-
titlestring左侧标题-
labelstring标题下方的描述信息-
extrastring右侧内容-
hasLineboolean是否有底部横线true
isLinkboolean是否展示右侧箭头并开启尝试以 url 跳转-
urlstring跳转链接-
deltanumber当 open-type 为 'navigateBack' 时有效,表示回退的层数1
bind:clickfunction点击事件-
bind:getuserinfofunction用户点击该按钮时,会返回获取到的用户信息,回调的detail数据与wx.getUserInfo返回的一致-
bind:contactfunction客服消息回调-
bind:getphonenumberfunction获取用户手机号回调-
bind:errorfunction当使用开放能力时,发生错误的回调-
bind:opensettingfunction在打开授权设置页后回调-

更多参数说明请参考微信官方的表单组件 Button

Cell slot

名称描述
-自定义标题或描述
header自定义左侧缩略图
footer自定义右侧内容

Cell externalClasses

名称描述
wux-class根节点样式类