New Huajishe Check ChaoXing

This commit is contained in:
e2hang
2025-10-01 10:01:52 +08:00
parent 240b884eac
commit 80be8ae3cf
1094 changed files with 61709 additions and 0 deletions

View File

@@ -0,0 +1,100 @@
:: BASE_DOC ::
## API
### Cell Props
name | type | default | description | required
-- | -- | -- | -- | --
style | Object | - | CSS(Cascading Style Sheets) | N
custom-style | Object | - | CSS(Cascading Style Sheets)used to set style on virtual component | N
align | String | middle | options: top/middle/bottom | N
arrow | Boolean / Object | false | \- | N
bordered | Boolean | true | \- | N
description | String / Slot | - | [see more ts definition](https://github.com/Tencent/tdesign-miniprogram/blob/develop/src/common/common.ts) | N
hover | Boolean | - | \- | N
image | String / Slot | - | [see more ts definition](https://github.com/Tencent/tdesign-miniprogram/blob/develop/src/common/common.ts) | N
jump-type | String | navigateTo | options: switchTab/reLaunch/redirectTo/navigateTo | N
left-icon | String / Object / Slot | - | [see more ts definition](https://github.com/Tencent/tdesign-miniprogram/blob/develop/src/common/common.ts) | N
note | String / Slot | - | [see more ts definition](https://github.com/Tencent/tdesign-miniprogram/blob/develop/src/common/common.ts) | N
required | Boolean | false | \- | N
right-icon | String / Object / Slot | - | [see more ts definition](https://github.com/Tencent/tdesign-miniprogram/blob/develop/src/common/common.ts) | N
title | String / Slot | - | [see more ts definition](https://github.com/Tencent/tdesign-miniprogram/blob/develop/src/common/common.ts) | N
url | String | - | \- | N
### Cell Events
name | params | description
-- | -- | --
click | - | [see more ts definition](https://github.com/Tencent/tdesign-miniprogram/blob/develop/src/common/common.ts)
### Cell External Classes
className | Description
-- | --
t-class | \-
t-class-center | \-
t-class-description | \-
t-class-hover | \-
t-class-image | \-
t-class-left | \-
t-class-left-icon | \-
t-class-note | \-
t-class-right | \-
t-class-right-icon | \-
t-class-title | \-
### CellGroup Props
name | type | default | description | required
-- | -- | -- | -- | --
style | Object | - | CSS(Cascading Style Sheets) | N
custom-style | Object | - | CSS(Cascading Style Sheets)used to set style on virtual component | N
bordered | Boolean | false | \- | N
theme | String | default | options: default/card | N
title | String | - | \- | N
### CellGroup External Classes
className | Description
-- | --
t-class | \-
t-class-title | \-
### CSS Variables
The component provides the following CSS variables, which can be used to customize styles.
Name | Default Value | Description
-- | -- | --
--td-cell-group-border-color | @component-stroke | -
--td-cell-group-title-bg-color | @bg-color-secondarycontainer | -
--td-cell-group-title-color | @text-color-placeholder | -
--td-cell-group-title-font-size | 28rpx | -
--td-cell-group-title-line-height | 90rpx | -
--td-cell-group-title-padding-left | 32rpx | -
--td-cell-bg-color | @bg-color-container | -
--td-cell-border-color | @component-stroke | -
--td-cell-border-left-space | @cell-horizontal-padding | -
--td-cell-border-right-space | 0 | -
--td-cell-border-width | 1px | -
--td-cell-description-color | @text-color-secondary | -
--td-cell-description-font-size | @font-size-base | -
--td-cell-description-line-height | 44rpx | -
--td-cell-height | auto | -
--td-cell-horizontal-padding | 32rpx | -
--td-cell-hover-color | @bg-color-secondarycontainer | -
--td-cell-image-height | 96rpx | -
--td-cell-image-width | 96rpx | -
--td-cell-left-icon-color | @brand-color | -
--td-cell-left-icon-font-size | 48rpx | -
--td-cell-line-height | 48rpx | -
--td-cell-note-color | @text-color-placeholder | -
--td-cell-note-font-size | @font-size-m | -
--td-cell-required-color | @error-color | -
--td-cell-required-font-size | @font-size-m | -
--td-cell-right-icon-color | @text-color-placeholder | -
--td-cell-right-icon-font-size | 48rpx | -
--td-cell-title-color | @text-color-primary | -
--td-cell-title-font-size | @font-size-m | -
--td-cell-vertical-padding | 32rpx | -

View File

@@ -0,0 +1,145 @@
---
title: Cell 单元格
description: 用于各个类别行的信息展示。
spline: data
isComponent: true
---
<span class="coverages-badge" style="margin-right: 10px"><img src="https://img.shields.io/badge/coverages%3A%20lines-100%25-blue" /></span><span class="coverages-badge" style="margin-right: 10px"><img src="https://img.shields.io/badge/coverages%3A%20functions-100%25-blue" /></span><span class="coverages-badge" style="margin-right: 10px"><img src="https://img.shields.io/badge/coverages%3A%20statements-100%25-blue" /></span><span class="coverages-badge" style="margin-right: 10px"><img src="https://img.shields.io/badge/coverages%3A%20branches-100%25-blue" /></span>
## 引入
全局引入,在 miniprogram 根目录下的`app.json`中配置,局部引入,在需要引入的页面或组件的`index.json`中配置。
```json
"usingComponents": {
"t-cell": "tdesign-miniprogram/cell/cell",
"t-cell-group": "tdesign-miniprogram/cell-group/cell-group"
}
```
## 代码演示
<a href="https://developers.weixin.qq.com/s/bz7aGimL72S2" title="在开发者工具中预览效果" target="_blank" rel="noopener noreferrer"> 在开发者工具中预览效果 </a>
<blockquote style="background-color: #d9e1ff; font-size: 15px; line-height: 26px;margin: 16px 0 0;padding: 16px; border-radius: 6px; color: #0052d9" >
<p>Tips: 请确保开发者工具为打开状态。导入开发者工具后依次执行npm i > 构建npm包 > 勾选 "将JS编译成ES5"</p>
</blockquote>
### 类型
单行单元格
<img src="https://tdesign.gtimg.com/miniprogram/readme/cell-1.png" width="375px" height="50%">
{{ base }}
多行单元格
<img src="https://tdesign.gtimg.com/miniprogram/readme/cell-2.png" width="375px" height="50%">
{{ multiple }}
### 样式
卡片单元格
{{ theme }}
## API
### Cell Props
名称 | 类型 | 默认值 | 描述 | 必传
-- | -- | -- | -- | --
style | Object | - | 样式 | N
custom-style | Object | - | 样式,一般用于开启虚拟化组件节点场景 | N
align | String | middle | 右侧内容的对齐方式默认居中对齐。可选项top/middle/bottom | N
arrow | Boolean / Object | false | 是否显示右侧箭头 | N
bordered | Boolean | true | 是否显示下边框 | N
description | String / Slot | - | 下方内容描述。[通用类型定义](https://github.com/Tencent/tdesign-miniprogram/blob/develop/src/common/common.ts) | N
hover | Boolean | - | 是否开启点击反馈 | N
image | String / Slot | - | 主图。[通用类型定义](https://github.com/Tencent/tdesign-miniprogram/blob/develop/src/common/common.ts) | N
jump-type | String | navigateTo | 链接跳转类型。可选项switchTab/reLaunch/redirectTo/navigateTo | N
left-icon | String / Object / Slot | - | 左侧图标,出现在单元格标题的左侧。[通用类型定义](https://github.com/Tencent/tdesign-miniprogram/blob/develop/src/common/common.ts) | N
note | String / Slot | - | 和标题同行的说明文字。[通用类型定义](https://github.com/Tencent/tdesign-miniprogram/blob/develop/src/common/common.ts) | N
required | Boolean | false | 是否显示表单必填星号 | N
right-icon | String / Object / Slot | - | 最右侧图标。[通用类型定义](https://github.com/Tencent/tdesign-miniprogram/blob/develop/src/common/common.ts) | N
title | String / Slot | - | 标题。[通用类型定义](https://github.com/Tencent/tdesign-miniprogram/blob/develop/src/common/common.ts) | N
url | String | - | 点击后跳转链接地址。如果值为空,则表示不需要跳转 | N
### Cell Events
名称 | 参数 | 描述
-- | -- | --
click | - | 右侧内容。[通用类型定义](https://github.com/Tencent/tdesign-miniprogram/blob/develop/src/common/common.ts)
### Cell External Classes
类名 | 描述
-- | --
t-class | 根节点样式类
t-class-center | 中间(`title`, `description`)内容样式类
t-class-description | 下方描述内容样式类
t-class-hover | 悬停样式类
t-class-image | 图片样式类
t-class-left | 左侧内容样式类
t-class-left-icon | 左侧图标样式类
t-class-note | 右侧说明文字样式类
t-class-right | 右侧内容样式类
t-class-right-icon | 右侧图标样式类
t-class-title | 标题样式类
### CellGroup Props
名称 | 类型 | 默认值 | 描述 | 必传
-- | -- | -- | -- | --
style | Object | - | 样式 | N
custom-style | Object | - | 样式,一般用于开启虚拟化组件节点场景 | N
bordered | Boolean | false | 是否显示组边框 | N
theme | String | default | 单元格组风格。可选项default/card | N
title | String | - | 单元格组标题 | N
### CellGroup External Classes
类名 | 描述
-- | --
t-class | 根节点样式类
t-class-title | 标题样式类
### CSS Variables
组件提供了下列 CSS 变量,可用于自定义样式。
名称 | 默认值 | 描述
-- | -- | --
--td-cell-group-border-color | @component-stroke | -
--td-cell-group-title-bg-color | @bg-color-secondarycontainer | -
--td-cell-group-title-color | @text-color-placeholder | -
--td-cell-group-title-font-size | 28rpx | -
--td-cell-group-title-line-height | 90rpx | -
--td-cell-group-title-padding-left | 32rpx | -
--td-cell-bg-color | @bg-color-container | -
--td-cell-border-color | @component-stroke | -
--td-cell-border-left-space | @cell-horizontal-padding | -
--td-cell-border-right-space | 0 | -
--td-cell-border-width | 1px | -
--td-cell-description-color | @text-color-secondary | -
--td-cell-description-font-size | @font-size-base | -
--td-cell-description-line-height | 44rpx | -
--td-cell-height | auto | -
--td-cell-horizontal-padding | 32rpx | -
--td-cell-hover-color | @bg-color-secondarycontainer | -
--td-cell-image-height | 96rpx | -
--td-cell-image-width | 96rpx | -
--td-cell-left-icon-color | @brand-color | -
--td-cell-left-icon-font-size | 48rpx | -
--td-cell-line-height | 48rpx | -
--td-cell-note-color | @text-color-placeholder | -
--td-cell-note-font-size | @font-size-m | -
--td-cell-required-color | @error-color | -
--td-cell-required-font-size | @font-size-m | -
--td-cell-right-icon-color | @text-color-placeholder | -
--td-cell-right-icon-font-size | 48rpx | -
--td-cell-title-color | @text-color-primary | -
--td-cell-title-font-size | @font-size-m | -
--td-cell-vertical-padding | 32rpx | -

View File

@@ -0,0 +1,22 @@
import { SuperComponent, RelationsOptions } from '../common/src/index';
export default class Cell extends SuperComponent {
externalClasses: string[];
relations: RelationsOptions;
options: {
multipleSlots: boolean;
};
properties: import("./type").TdCellProps;
data: {
prefix: string;
classPrefix: string;
isLastChild: boolean;
};
observers: {
leftIcon(v: any): void;
rightIcon(v: any): void;
arrow(v: any): void;
};
setIcon(name: any, value: any, defaultValue: any): void;
onClick(e: any): void;
jumpLink(urlKey?: string, link?: string): void;
}

View File

@@ -0,0 +1,75 @@
var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
return c > 3 && r && Object.defineProperty(target, key, r), r;
};
import { SuperComponent, wxComponent } from '../common/src/index';
import config from '../common/config';
import props from './props';
import { calcIcon } from '../common/utils';
const { prefix } = config;
const name = `${prefix}-cell`;
let Cell = class Cell extends SuperComponent {
constructor() {
super(...arguments);
this.externalClasses = [
`${prefix}-class`,
`${prefix}-class-title`,
`${prefix}-class-description`,
`${prefix}-class-note`,
`${prefix}-class-hover`,
`${prefix}-class-image`,
`${prefix}-class-left`,
`${prefix}-class-left-icon`,
`${prefix}-class-center`,
`${prefix}-class-right`,
`${prefix}-class-right-icon`,
];
this.relations = {
'../cell-group/cell-group': {
type: 'parent',
},
};
this.options = {
multipleSlots: true,
};
this.properties = props;
this.data = {
prefix,
classPrefix: name,
isLastChild: false,
};
this.observers = {
leftIcon(v) {
this.setIcon('_leftIcon', v, '');
},
rightIcon(v) {
this.setIcon('_rightIcon', v, '');
},
arrow(v) {
this.setIcon('_arrow', v, 'chevron-right');
},
};
}
setIcon(name, value, defaultValue) {
this.setData({
[name]: calcIcon(value, defaultValue),
});
}
onClick(e) {
this.triggerEvent('click', e.detail);
this.jumpLink();
}
jumpLink(urlKey = 'url', link = 'jumpType') {
const url = this.data[urlKey];
const jumpType = this.data[link];
if (url) {
wx[jumpType]({ url });
}
}
};
Cell = __decorate([
wxComponent()
], Cell);
export default Cell;

View File

@@ -0,0 +1,8 @@
{
"component": true,
"styleIsolation": "apply-shared",
"usingComponents": {
"t-icon": "../icon/icon",
"t-image": "../image/image"
}
}

View File

@@ -0,0 +1,63 @@
<import src="../common/template/icon.wxml" />
<wxs src="../common/utils.wxs" module="_" />
<view
style="{{_._style([style, customStyle])}}"
class="class {{prefix}}-class {{_.cls(classPrefix, [['borderless', !bordered || isLastChild]])}}"
hover-class="{{ hover ? classPrefix + '--hover' : ''}}"
hover-stay-time="70"
bind:tap="onClick"
aria-role="{{ariaRole || (arrow ? 'button' : '')}}"
aria-label="{{ariaLabel}}"
>
<view class="{{classPrefix}}__left {{prefix}}-class-left">
<template
wx:if="{{_leftIcon}}"
is="icon"
data="{{tClass: classPrefix + '__left-icon ' + prefix + '-class-left-icon', ..._leftIcon }}"
/>
<slot name="left-icon" />
<t-image
wx:if="{{ image }}"
shape="round"
t-class="{{classPrefix}}__left-image {{prefix}}-class-image"
src="{{ image }}"
/>
<slot name="image" />
</view>
<view class="{{classPrefix}}__title {{prefix}}-class-center">
<view class="{{classPrefix}}__title-text {{prefix}}-class-title">
<block wx:if="{{ title }}"> {{ title}} </block>
<slot name="title" />
<block wx:if="{{required}}">
<text decode class="{{classPrefix}}--required">&nbsp;*</text>
</block>
</view>
<view class="{{classPrefix}}__description {{prefix}}-class-description">
<view wx:if="{{ description }}" class="{{classPrefix}}__description-text">{{description}}</view>
<slot name="description" />
</view>
</view>
<view class="{{classPrefix}}__note {{prefix}}-class-note">
<text wx:if="{{ note }}">{{note}}</text>
<slot name="note" />
</view>
<view class="{{_.cls(classPrefix + '__right', [align])}} {{prefix}}-class-right">
<template
wx:if="{{_arrow}}"
is="icon"
data="{{tClass: classPrefix + '__right-icon ' + prefix + '-class-right-icon', ..._arrow }}"
/>
<block wx:else>
<template
wx:if="{{_rightIcon}}"
is="icon"
data="{{tClass: classPrefix + '__right-icon ' + prefix + '-class-right-icon', ..._rightIcon }}"
/>
<slot name="right-icon" />
</block>
</view>
</view>

View File

@@ -0,0 +1,127 @@
.t-float-left {
float: left;
}
.t-float-right {
float: right;
}
@keyframes tdesign-fade-out {
from {
opacity: 1;
}
to {
opacity: 0;
}
}
.hotspot-expanded.relative {
position: relative;
}
.hotspot-expanded::after {
content: '';
display: block;
position: absolute;
left: 0;
top: 0;
right: 0;
bottom: 0;
transform: scale(1.5);
}
.t-cell {
position: relative;
display: flex;
box-sizing: border-box;
width: 100%;
padding: var(--td-cell-vertical-padding, 32rpx) var(--td-cell-horizontal-padding, 32rpx);
line-height: var(--td-cell-line-height, 48rpx);
height: var(--td-cell-height, auto);
background-color: var(--td-cell-bg-color, var(--td-bg-color-container, var(--td-font-white-1, #ffffff)));
}
.t-cell::after {
position: absolute;
box-sizing: border-box;
content: ' ';
pointer-events: none;
right: 0;
left: 0;
bottom: 0;
border-bottom: var(--td-cell-border-width, 1px) solid var(--td-cell-border-color, var(--td-component-stroke, var(--td-gray-color-3, #e7e7e7)));
transform: scaleY(0.5);
transform-origin: bottom;
left: var(--td-cell-border-left-space, var(--td-cell-horizontal-padding, 32rpx));
right: var(--td-cell-border-right-space, 0);
}
.t-cell--borderless::after {
display: none;
}
.t-cell__description {
font-size: var(--td-cell-description-font-size, var(--td-font-size-base, 28rpx));
line-height: var(--td-cell-description-line-height, 44rpx);
color: var(--td-cell-description-color, var(--td-text-color-secondary, var(--td-font-gray-2, rgba(0, 0, 0, 0.6))));
}
.t-cell__description-text {
margin-top: calc(var(--td-spacer, 16rpx) / 2);
}
.t-cell__note {
display: flex;
align-items: center;
justify-content: flex-end;
color: var(--td-cell-note-color, var(--td-text-color-placeholder, var(--td-font-gray-3, rgba(0, 0, 0, 0.4))));
font-size: var(--td-cell-note-font-size, var(--td-font-size-m, 32rpx));
}
.t-cell__title {
margin-right: var(--td-spacer-2, 32rpx);
}
.t-cell__title,
.t-cell__note {
flex: 1 1 auto;
}
.t-cell__title:empty,
.t-cell__note:empty {
display: none;
}
.t-cell__title-text {
display: flex;
font-size: var(--td-cell-title-font-size, var(--td-font-size-m, 32rpx));
color: var(--td-cell-title-color, var(--td-text-color-primary, var(--td-font-gray-1, rgba(0, 0, 0, 0.9))));
font-weight: 400;
}
.t-cell__left,
.t-cell__right {
align-self: stretch;
}
.t-cell__left:not(:empty) {
margin-right: var(--td-spacer-1, 24rpx);
}
.t-cell__left-icon {
color: var(--td-cell-left-icon-color, var(--td-brand-color, var(--td-primary-color-7, #0052d9)));
font-size: var(--td-cell-left-icon-font-size, 48rpx);
}
.t-cell__left-image {
height: var(--td-cell-image-height, 96rpx);
width: var(--td-cell-image-width, 96rpx);
}
.t-cell__note:not(:empty) + .t-cell__right {
margin-left: calc(var(--td-spacer, 16rpx) / 2);
}
.t-cell__right {
display: flex;
}
.t-cell__right-icon {
color: var(--td-cell-right-icon-color, var(--td-text-color-placeholder, var(--td-font-gray-3, rgba(0, 0, 0, 0.4))));
font-size: var(--td-cell-right-icon-font-size, 48rpx);
}
.t-cell__right--middle {
align-items: center;
}
.t-cell__right--top {
align-items: flex-start;
}
.t-cell__right--bottom {
align-items: flex-end;
}
.t-cell--hover {
background-color: var(--td-cell-hover-color, var(--td-bg-color-secondarycontainer, var(--td-gray-color-1, #f3f3f3)));
}
.t-cell--required {
font-size: var(--td-cell-required-font-size, var(--td-font-size-m, 32rpx));
color: var(--td-cell-required-color, var(--td-error-color, var(--td-error-color-6, #d54941)));
}

View File

@@ -0,0 +1,3 @@
import { TdCellProps } from './type';
declare const props: TdCellProps;
export default props;

View File

@@ -0,0 +1,48 @@
const props = {
align: {
type: String,
value: 'middle',
},
arrow: {
type: null,
value: false,
},
bordered: {
type: Boolean,
value: true,
},
description: {
type: String,
},
hover: {
type: Boolean,
},
image: {
type: String,
},
jumpType: {
type: String,
value: 'navigateTo',
},
leftIcon: {
type: null,
},
note: {
type: String,
},
required: {
type: Boolean,
value: false,
},
rightIcon: {
type: null,
},
title: {
type: String,
},
url: {
type: String,
value: '',
},
};
export default props;

View File

@@ -0,0 +1,54 @@
export interface TdCellProps {
align?: {
type: StringConstructor;
value?: 'top' | 'middle' | 'bottom';
};
arrow?: {
type: null;
value?: boolean | object;
};
bordered?: {
type: BooleanConstructor;
value?: boolean;
};
description?: {
type: StringConstructor;
value?: string;
};
hover?: {
type: BooleanConstructor;
value?: boolean;
};
image?: {
type: StringConstructor;
value?: string;
};
jumpType?: {
type: StringConstructor;
value?: 'switchTab' | 'reLaunch' | 'redirectTo' | 'navigateTo';
};
leftIcon?: {
type: null;
value?: string | object;
};
note?: {
type: StringConstructor;
value?: string;
};
required?: {
type: BooleanConstructor;
value?: boolean;
};
rightIcon?: {
type: null;
value?: string | object;
};
title?: {
type: StringConstructor;
value?: string;
};
url?: {
type: StringConstructor;
value?: string;
};
}

View File

@@ -0,0 +1 @@
export {};