在电商应用中,预售模式是一种常见的营销手段,通过定金+尾款的方式提前锁定用户,同时帮助商家预测销量。本文将深入分析一个基于 React Native 实现的预售商品系统,探讨其架构设计、技术实现以及鸿蒙跨端适配策略。
核心数据
该系统构建了详细的预售商品数据模型,为预售流程提供了完整的数据支持:
typescript
// 预售商品类型
type PreSaleProduct = {
id: string;
name: string;
image: string;
originalPrice: number;
deposit: number;
finalPayment: number;
totalPreSalePrice: number;
preSaleStartTime: string;
preSaleEndTime: string;
deliveryTime: string;
status: 'pre-sale' | 'final-payment' | 'shipped' | 'delivered';
progress: number;
features: string[];
};
这种数据模型设计的优势:
- 完整性:涵盖了预售商品的所有核心属性,包括价格、时间、状态等
- 类型安全:使用 TypeScript 类型确保数据结构一致性
- 状态管理:通过 status 字段清晰定义预售流程的不同阶段
- 扩展性:支持添加更多属性,如商品规格、库存等
状态管理
系统采用了 React Hooks 中的 useState 进行轻量级状态管理:
typescript
const [products] = useState<PreSaleProduct[]>([
// 商品数据...
]);
const [activeTab, setActiveTab] = useState<'pre-sale' | 'my-orders'>('pre-sale');
这种状态管理方式具有以下优势:
- 模块化:将商品数据和标签页状态分离管理,提高代码可读性
- 响应式:状态变更自动触发组件重渲染,确保 UI 与数据同步
- 跨端兼容:React Hooks 在鸿蒙系统的 React Native 实现中通常都有良好支持
- 简洁性:代码结构清晰,易于理解和维护
系统实现了完整的预售流程功能,包括:
参与预售
typescript
const participatePreSale = (productId: string) => {
Alert.alert(
'参与预售',
`您确定要参与"${products.find(p => p.id === productId)?.name}"的预售吗?\n\n定金: ¥${products.find(p => p.id === productId)?.deposit}`,
[
{
text: '取消',
style: 'cancel'
},
{
text: '确定',
onPress: () => {
Alert.alert('成功', '您已成功参与预售!定金已支付');
}
}
]
);
};
参与预售功能支持:
- 显示商品名称和定金金额,让用户确认
- 提供取消和确定选项,确保用户操作的准确性
- 参与成功后显示提示信息,完成流程闭环
支付尾款
typescript
const payFinal = (productId: string) => {
Alert.alert(
'支付尾款',
`您需要支付尾款¥${products.find(p => p.id === productId)?.finalPayment}`,
[
{
text: '取消',
style: 'cancel'
},
{
text: '立即支付',
onPress: () => {
Alert.alert('成功', '尾款支付成功!商品即将发货');
}
}
]
);
};
支付尾款功能支持:
- 显示需要支付的尾款金额
- 提供取消和立即支付选项
- 支付成功后显示提示信息,告知用户商品即将发货
系统实现了详细的商品信息展示,包括:
- 商品图片
- 商品名称
- 价格信息(定金、尾款、原价、节省金额)
- 时间信息(预售时间、发货时间)
- 预售进度
- 产品特点
商品卡片的渲染逻辑清晰,信息层次分明,为用户提供全面的商品信息。
基础架构
该实现采用了 React Native 核心组件库,确保了在鸿蒙系统上的基本兼容性:
SafeAreaView:适配刘海屏等异形屏ScrollView:处理内容滚动,确保长页面可浏览TouchableOpacity:提供触摸反馈,增强用户体验FlatList:高效渲染商品列表,支持虚拟滚动Image:显示商品图片和其他视觉元素Alert:系统级弹窗提示,提供操作反馈
Base64 图标
系统使用 Base64 编码的图标库,这种处理方式在跨端开发中尤为重要:
- 避免了不同平台对资源文件格式的兼容性问题
- 减少了网络请求,提高了加载速度
- 简化了构建流程,无需处理多平台资源文件
- 确保图标在不同设备上的显示一致性
屏幕尺寸
系统通过 Dimensions API 获取屏幕尺寸,确保了在不同屏幕尺寸的设备上都能获得一致的布局体验,无论是 React Native 环境还是鸿蒙系统:
typescript
const { width, height } = Dimensions.get('window');
系统实现了流畅的交互体验:
- 标签切换:支持在预售商品和我的订单之间切换
- 参与预售:点击按钮后显示确认对话框,确认后显示成功提示
- 支付尾款:点击按钮后显示尾款金额,确认后显示支付成功提示
- 进度展示:动态显示预售进度,提供直观的视觉反馈
- 滚动体验:长页面支持流畅滚动,商品列表使用 FlatList 优化性能
系统采用了模块化的样式定义,确保了样式的一致性和可维护性:
typescript
const styles = StyleSheet.create({
container: {
flex: 1,
backgroundColor: '#f5f5f5',
},
// 其他样式...
});
这种方式为后续的主题定制和深色模式适配预留了扩展空间。
在鸿蒙系统上使用 React Native 时,应注意以下 API 兼容性问题:
- FlatList API:鸿蒙系统的 FlatList 实现可能与 React Native 有所差异,建议测试确认滚动和渲染行为
- Image API:鸿蒙系统的 Image 实现可能与 React Native 有所差异,建议测试确认图片加载行为
- Alert API:鸿蒙系统的 Alert 实现可能与 React Native 有所差异,建议测试确认弹窗行为
本预售商品系统实现了一个功能完整、用户友好的预售商品界面,通过合理的架构设计和代码组织,为用户提供了良好的预售体验。在跨端开发场景下,该实现充分考虑了 React Native 和鸿蒙系统的兼容性需求,为后续的功能扩展和性能优化预留了空间。
通过参与预售、支付尾款、进度展示等核心功能,结合 Base64 图标处理、FlatList 优化等技术手段,该系统不仅功能完善,而且具有良好的可维护性和可扩展性。这些实践经验对于构建其他跨端应用组件也具有参考价值。
拼团砍价作为电商场景的核心营销玩法,其前端实现需要兼顾数据驱动的动态展示、沉浸式的交互体验、跨端的一致性适配三大核心诉求。本文将从架构设计、核心逻辑、组件实现三个维度拆解这份 React Native 拼团砍价应用代码,并提供完整的鸿蒙(HarmonyOS)ArkTS 跨端适配方案,为跨端电商营销场景开发提供可落地的技术参考。
1. 类型系统
电商营销场景的核心是活动数据 与参与者数据的双向联动,代码通过 TypeScript 构建了精准匹配业务场景的类型体系,为后续的状态管理和 UI 渲染奠定了强类型基础:
typescript
// 活动类型:覆盖拼团/砍价两类核心营销场景
type Activity = {
id: string;
title: string;
type: 'group-buy' | 'bargain'; // 场景区分符
originalPrice: number; // 商品原价
targetPrice: number; // 优惠目标价
currentPrice: number; // 砍价当前价
participants: number; // 当前参与人数
maxParticipants: number; // 最大参与人数(拼团)
deadline: string; // 活动截止时间
status: 'ongoing' | 'completed' | 'failed'; // 活动状态
product: { // 关联商品信息
name: string;
image: string;
};
};
// 参与者类型:记录用户参与行为
type Participant = {
id: string;
name: string;
avatar: string;
joinedAt: string; // 参与时间戳(格式化)
};
设计亮点解析:
- 场景化类型约束 :通过联合类型
'group-buy' | 'bargain'严格限定活动类型,避免业务逻辑中出现非法值; - 数据分层合理:Activity 模型内置 product 子对象,既保证数据关联性,又符合电商场景的业务逻辑;
- 状态闭环完整:status 字段覆盖活动全生命周期,为后续的状态驱动渲染提供基础;
- 扩展性预留:砍价场景的 currentPrice、拼团场景的 maxParticipants 字段各司其职,兼顾不同营销玩法的特性;
- 类型安全保障:所有字段均明确类型定义,在编译阶段即可发现数据类型错误,降低运行时异常风险。
2. 状态管理
拼团砍价场景的交互核心是活动类型切换、参与/分享操作、动态进度展示 ,代码通过 React 的 useState 构建了轻量且高效的状态管理体系:
(1)核心状态初始化
typescript
// 活动列表:模拟后端返回的营销活动数据
const [activities] = useState<Activity[]>([/* 活动数据 */]);
// 参与者列表:模拟用户参与记录
const [participants] = useState<Participant[]>([/* 参与者数据 */]);
// 选项卡激活状态:控制拼团/砍价场景切换
const [activeTab, setActiveTab] = useState<'group' | 'bargain'>('group');
初始化策略分析:
- 静态数据不可变 :活动/参与者数据使用
const [x] = useState()声明,避免不必要的重渲染; - 默认状态合理:默认展示拼团活动,贴合多数电商平台的营销优先级;
- 数据模拟真实:活动数据包含不同类型、不同进度、不同商品的场景,覆盖真实业务的核心维度;
- 状态粒度精准:仅将选项卡激活状态作为动态状态,符合"最小状态原则"。
① 参与活动交互逻辑
typescript
const joinActivity = (activityId: string) => {
Alert.alert(
'参与活动',
`您确定要参与 "${activities.find(a => a.id === activityId)?.title}" 活动吗?`,
[
{ text: '取消', style: 'cancel' },
{
text: '确定',
onPress: () => {
Alert.alert('成功', '您已成功参与活动!快去邀请好友吧!');
}
}
]
);
};
交互设计亮点:
- 闭环式交互:包含"确认参与-成功反馈"的完整流程,符合移动端用户操作习惯;
- 空值保护 :使用可选链操作符
?.避免活动不存在时的空指针异常; - 扩展性预留:成功回调位置可直接对接后端参与活动 API,无需重构核心逻辑;
- 用户体验优化:提示文案包含活动标题,增强交互的个性化和友好性。
② 进度计算核心逻辑
typescript
<View
style={[
styles.progressFill,
{ width: `${(item.type === 'group-buy'
? (item.participants / item.maxParticipants) * 100
: (item.currentPrice - item.targetPrice) / (item.originalPrice - item.targetPrice) * 100)}%`
}
]}
/>
数学逻辑解析:
- 拼团进度:按参与人数占比计算(已参与/最大人数),直观反映成团进度;
- 砍价进度:按价格差额占比计算(当前价差/总价差),精准体现砍价完成度;
- 动态样式绑定:通过数组语法合并基础样式与动态宽度,符合 React Native 样式最佳实践;
- 百分比转换:自动将比例值转换为百分比,适配进度条宽度的样式需求。
拼团砍价场景的视觉核心是活动列表、参与者列表、进度展示 ,代码通过 FlatList 实现高性能渲染,并结合样式系统构建沉浸式的电商视觉体验:
(1)活动列表
typescript
<FlatList
data={activities.filter(activity =>
activeTab === 'group'
? activity.type === 'group-buy'
: activity.type === 'bargain'
)}
renderItem={renderActivity}
keyExtractor={item => item.id}
showsVerticalScrollIndicator={false}
contentContainerStyle={styles.activityList}
/>
性能优化亮点:
- 按需渲染:根据选项卡状态动态过滤数据,只渲染当前场景的活动列表;
- 复用机制 :使用
FlatList而非ScrollView + map,支持列表项复用,提升长列表性能; - 体验优化:隐藏垂直滚动条,符合移动端电商应用的视觉设计规范;
- 唯一标识 :通过
keyExtractor指定唯一 key,避免列表重渲染异常; - 样式解耦 :通过
contentContainerStyle配置列表容器样式,与列表项样式分离。
(2)参与者头像堆叠设计
typescript
<View style={styles.participantAvatars}>
{participants.slice(0, 3).map((participant, index) => (
<Image
key={participant.id}
source={{ uri: participant.avatar }}
style={[
styles.participantAvatar,
{ marginLeft: index === 0 ? 0 : -8 }
]}
/>
))}
{item.participants > 3 && (
<View style={styles.extraCount}>
<Text style={styles.extraCountText}>+{item.participants - 3}</Text>
</View>
)}
</View>
视觉设计解析:
- 数量控制:仅展示前3个参与者头像,避免视觉拥挤;
- 堆叠效果:通过负 margin 实现头像重叠效果,符合电商设计的视觉规范;
- 数量提示 :超过3人时展示
+N标识,兼顾信息完整性和视觉简洁性; - 条件渲染:仅在参与人数超过3时展示数量提示,避免无效UI元素;
- 样式适配:头像添加白色边框,提升堆叠效果的层次感。
(3)样式
代码通过 StyleSheet.create 构建了符合电商场景的样式体系,核心设计原则包括:
- 色彩体系统一 :主色调使用蓝色(
#3b82f6),价格色使用红色(#ef4444),中性色使用灰度系,符合电商视觉规范; - 卡片式布局 :所有功能区域均采用
borderRadius: 12的卡片设计,通过阴影提升层次感; - 间距规范:采用 16/12/8/4px 的间距体系,保证页面布局的呼吸感;
- 文字层级:通过字体大小和字重区分信息优先级,活动标题/价格加粗大号,说明文字小号浅色;
- 按钮区分:参与按钮(主按钮)使用蓝色背景,分享按钮(次要按钮)使用浅灰色背景,明确操作优先级;
- 底部导航:固定定位+边框高亮当前页,符合移动端导航设计习惯。
将 React Native 拼团砍价应用迁移至鸿蒙平台,核心是基于 ArkTS + ArkUI 实现数据模型、状态管理、列表渲染、交互逻辑的对等还原,同时适配鸿蒙的组件特性和交互范式。
1. 核心适配
typescript
@Entry
@Component
struct GroupBargainApp {
// 数据模型:完全复用 RN 端字段定义
@State activities: Activity[] = [/* 活动数据 */];
@State participants: Participant[] = [/* 参与者数据 */];
@State activeTab: 'group' | 'bargain' = 'group';
// 核心业务逻辑:对等实现
joinActivity(activityId: string) {
AlertDialog.show({
title: '参与活动',
message: `您确定要参与 "${this.activities.find(a => a.id === activityId)?.title}" 活动吗?`,
cancel: { value: '取消' },
confirm: {
value: '确定',
action: () => {
AlertDialog.show({
title: '成功',
message: '您已成功参与活动!快去邀请好友吧!',
confirm: { value: '确定' }
});
}
}
});
}
// 列表项渲染:使用 @Builder 封装
@Builder
renderActivity(item: Activity) {
// 活动卡片渲染逻辑(对等还原 RN 端 UI)
}
// 页面构建:镜像 RN 端布局结构
build() {
Column()
.flex(1)
.backgroundColor('#f5f7fa')
.safeArea(true) {
// 头部区域
// 选项卡区域
// 活动列表区域
// 参与者列表区域
// 规则说明区域
// 底部导航区域
}
}
}
| React Native 特性 | 鸿蒙 ArkUI 对应实现 | 适配关键说明 |
|---|---|---|
useState |
@State 装饰器 |
状态初始化与更新逻辑完全复用,仅调整语法形式 |
FlatList |
ForEach 组件 |
列表渲染逻辑对等,均通过唯一 key 提升性能 |
TouchableOpacity |
Button + onClick |
可点击组件的交互逻辑完全复用 |
ScrollView |
Scroll 组件 |
滚动容器语法差异,功能完全一致 |
Alert.alert |
AlertDialog.show |
弹窗 API 语法差异,交互逻辑对等 |
StyleSheet |
链式样式 | 样式属性(颜色、间距、圆角等)100% 复用 |
Position: 'absolute' |
Position.Fixed |
底部导航定位效果一致 |
renderItem 函数 |
@Builder 装饰器 |
列表项渲染逻辑封装方式不同,逻辑完全复用 |
条件渲染 && |
if 语句 |
参与者数量提示等条件渲染逻辑对等实现 |
| 文字删除线 | decoration 属性 |
原价删除线效果视觉一致 |
| 动态样式数组 | 条件样式绑定 | 进度条宽度动态计算逻辑一致 |
typescript
// 鸿蒙 ArkTS 完整实现
interface Activity {
id: string;
title: string;
type: 'group-buy' | 'bargain';
originalPrice: number;
targetPrice: number;
currentPrice: number;
participants: number;
maxParticipants: number;
deadline: string;
status: 'ongoing' | 'completed' | 'failed';
product: {
name: string;
image: string;
};
}
interface Participant {
id: string;
name: string;
avatar: string;
joinedAt: string;
}
@Entry
@Component
struct GroupBargainApp {
@State activities: Activity[] = [
{
id: '1',
title: 'iPhone 15 Pro Max 256GB',
type: 'group-buy',
originalPrice: 9999,
targetPrice: 8999,
currentPrice: 9499,
participants: 3,
maxParticipants: 5,
deadline: '2023-12-31 23:59',
status: 'ongoing',
product: {
name: 'iPhone 15 Pro Max',
image: 'https://via.placeholder.com/80x80'
}
},
{
id: '2',
title: '小米13 Ultra 256GB',
type: 'bargain',
originalPrice: 5999,
targetPrice: 4999,
currentPrice: 5599,
participants: 12,
maxParticipants: 20,
deadline: '2023-11-30 23:59',
status: 'ongoing',
product: {
name: '小米13 Ultra',
image: 'https://via.placeholder.com/80x80'
}
},
{
id: '3',
title: '戴尔XPS 13',
type: 'group-buy',
originalPrice: 8999,
targetPrice: 7999,
currentPrice: 8499,
participants: 1,
maxParticipants: 2,
deadline: '2023-11-15 23:59',
status: 'ongoing',
product: {
name: '戴尔XPS 13',
image: 'https://via.placeholder.com/80x80'
}
},
{
id: '4',
title: '索尼WH-1000XM5',
type: 'bargain',
originalPrice: 2999,
targetPrice: 1999,
currentPrice: 2499,
participants: 8,
maxParticipants: 15,
deadline: '2023-12-10 23:59',
status: 'ongoing',
product: {
name: '索尼WH-1000XM5',
image: 'https://via.placeholder.com/80x80'
}
}
];
@State participants: Participant[] = [
{ id: '1', name: '张三', avatar: 'https://via.placeholder.com/40', joinedAt: '2小时前' },
{ id: '2', name: '李四', avatar: 'https://via.placeholder.com/40', joinedAt: '1小时前' },
{ id: '3', name: '王五', avatar: 'https://via.placeholder.com/40', joinedAt: '30分钟前' },
{ id: '4', name: '赵六', avatar: 'https://via.placeholder.com/40', joinedAt: '15分钟前' },
{ id: '5', name: '钱七', avatar: 'https://via.placeholder.com/40', joinedAt: '5分钟前' },
];
@State activeTab: 'group' | 'bargain' = 'group';
joinActivity(activityId: string) {
AlertDialog.show({
title: '参与活动',
message: `您确定要参与 "${this.activities.find(a => a.id === activityId)?.title}" 活动吗?`,
cancel: {
value: '取消'
},
confirm: {
value: '确定',
action: () => {
AlertDialog.show({
title: '成功',
message: '您已成功参与活动!快去邀请好友吧!',
confirm: {
value: '确定'
}
});
}
}
});
}
shareActivity(activityId: string) {
AlertDialog.show({
title: '分享',
message: `分享活动ID: ${activityId}`,
confirm: {
value: '确定'
}
});
}
@Builder
renderActivity(item: Activity) {
Column()
.backgroundColor('#ffffff')
.borderRadius(12)
.padding(16)
.marginBottom(16)
.shadow({ color: '#000', offsetX: 0, offsetY: 1, opacity: 0.1, radius: 2 }) {
// 活动头部
Row()
.marginBottom(12) {
Image(item.product.image)
.width(60)
.height(60)
.borderRadius(8)
.marginRight(12);
Column()
.flex(1) {
Text(item.title)
.fontSize(16)
.fontWeight(FontWeight.Medium)
.fontColor('#1e293b')
.marginBottom(4);
Text(item.product.name)
.fontSize(14)
.fontColor('#64748b')
.marginBottom(4);
Text(`原价: ¥${item.originalPrice}`)
.fontSize(14)
.fontColor('#94a3b8')
.decoration({ type: TextDecorationType.LineThrough })
.marginBottom(2);
Text(`目标价: ¥${item.targetPrice}`)
.fontSize(16)
.fontColor('#ef4444')
.fontWeight(FontWeight.Bold);
}
}
// 进度条区域
Column()
.marginBottom(12) {
Stack()
.width('100%')
.height(8)
.borderRadius(4)
.backgroundColor('#e2e8f0')
.marginBottom(4) {
Row()
.height('100%')
.backgroundColor('#3b82f6')
.borderRadius(4)
.width(`${(item.type === 'group-buy'
? (item.participants / item.maxParticipants) * 100
: (item.currentPrice - item.targetPrice) / (item.originalPrice - item.targetPrice) * 100)}%`);
}
Text(item.type === 'group-buy'
? `还差 ${item.maxParticipants - item.participants} 人成团`
: `还差 ¥${Math.round(item.currentPrice - item.targetPrice)} 达到目标`)
.fontSize(12)
.fontColor('#64748b');
}
// 参与者区域
Row()
.justifyContent(FlexAlign.SpaceBetween)
.alignItems(ItemAlign.Center)
.marginBottom(16) {
Text(`已有 ${item.participants} 人参与`)
.fontSize(14)
.fontColor('#64748b');
Row()
.alignItems(ItemAlign.Center) {
ForEach(this.participants.slice(0, 3), (participant: Participant, index: number) => {
Image(participant.avatar)
.width(24)
.height(24)
.borderRadius(12)
.border({ width: 2, color: '#ffffff' })
.marginLeft(index === 0 ? 0 : -8);
})
if (item.participants > 3) {
Stack()
.width(24)
.height(24)
.borderRadius(12)
.backgroundColor('#e2e8f0')
.alignItems(ItemAlign.Center)
.justifyContent(FlexAlign.Center) {
Text(`+${item.participants - 3}`)
.fontSize(12)
.fontColor('#64748b');
}
}
}
}
// 按钮区域
Row()
.justifyContent(FlexAlign.SpaceBetween) {
Button()
.flex(0.7)
.backgroundColor('#3b82f6')
.paddingVertical(12)
.borderRadius(6)
.marginRight(8)
.onClick(() => this.joinActivity(item.id)) {
Text(item.type === 'group-buy' ? '立即参团' : '助力砍价')
.fontColor('#ffffff')
.fontSize(16)
.fontWeight(FontWeight.Medium);
}
Button()
.flex(0.3)
.backgroundColor('#f1f5f9')
.paddingVertical(12)
.borderRadius(6)
.onClick(() => this.shareActivity(item.id)) {
Text('邀请好友')
.fontColor('#475569')
.fontSize(16)
.fontWeight(FontWeight.Medium);
}
}
}
}
@Builder
renderParticipant(item: Participant) {
Row()
.alignItems(ItemAlign.Center)
.paddingVertical(8)
.borderBottom({ width: 1, color: '#e2e8f0' }) {
Image(item.avatar)
.width(32)
.height(32)
.borderRadius(16)
.marginRight(12);
Column()
.flex(1) {
Text(item.name)
.fontSize(14)
.fontColor('#1e293b')
.marginBottom(2);
Text(`参与时间: ${item.joinedAt}`)
.fontSize(12)
.fontColor('#64748b');
}
Text('助力')
.fontSize(14)
.fontColor('#3b82f6')
.fontWeight(FontWeight.Medium);
}
}
build() {
Column()
.flex(1)
.backgroundColor('#f5f7fa')
.safeArea(true) {
// 头部
Column()
.alignItems(ItemAlign.Center)
.padding(16)
.backgroundColor('#ffffff')
.borderBottom({ width: 1, color: '#e2e8f0' }) {
Text('拼团砍价')
.fontSize(20)
.fontWeight(FontWeight.Bold)
.fontColor('#1e293b')
.marginBottom(4);
Text('邀请好友,享受更多优惠')
.fontSize(14)
.fontColor('#64748b');
}
// 滚动内容区
Scroll()
.flex(1) {
Column() {
// 选项卡
Row()
.backgroundColor('#ffffff')
.marginLeft(16)
.marginRight(16)
.borderRadius(8)
.marginBottom(16)
.shadow({ color: '#000', offsetX: 0, offsetY: 1, opacity: 0.1, radius: 2 }) {
Button()
.flex(1)
.backgroundColor(this.activeTab === 'group' ? '#3b82f6' : Color.Transparent)
.borderRadius(8)
.paddingVertical(12)
.onClick(() => this.activeTab = 'group') {
Text('拼团活动')
.fontSize(16)
.fontColor(this.activeTab === 'group' ? '#ffffff' : '#64748b')
.fontWeight(FontWeight.Medium);
}
Button()
.flex(1)
.backgroundColor(this.activeTab === 'bargain' ? '#3b82f6' : Color.Transparent)
.borderRadius(8)
.paddingVertical(12)
.onClick(() => this.activeTab = 'bargain') {
Text('砍价活动')
.fontSize(16)
.fontColor(this.activeTab === 'bargain' ? '#ffffff' : '#64748b')
.fontWeight(FontWeight.Medium);
}
}
// 活动列表
Column()
.paddingLeft(16)
.paddingRight(16) {
ForEach(
this.activities.filter(activity =>
this.activeTab === 'group'
? activity.type === 'group-buy'
: activity.type === 'bargain'
),
(item: Activity) => {
this.renderActivity(item);
},
(item: Activity) => item.id
)
}
// 最新参与者
Column()
.backgroundColor('#ffffff')
.marginLeft(16)
.marginRight(16)
.marginBottom(16)
.borderRadius(12)
.padding(16)
.shadow({ color: '#000', offsetX: 0, offsetY: 1, opacity: 0.1, radius: 2 }) {
Text('最新参与者')
.fontSize(16)
.fontWeight(FontWeight.Medium)
.fontColor('#1e293b')
.marginBottom(12);
ForEach(
this.participants,
(item: Participant) => {
this.renderParticipant(item);
},
(item: Participant) => item.id
)
}
// 活动规则
Column()
.backgroundColor('#ffffff')
.marginLeft(16)
.marginRight(16)
.marginBottom(80)
.borderRadius(12)
.padding(16)
.shadow({ color: '#000', offsetX: 0, offsetY: 1, opacity: 0.1, radius: 2 }) {
Text('活动规则')
.fontSize(16)
.fontWeight(FontWeight.Medium)
.fontColor('#1e293b')
.marginBottom(12);
Text('• 拼团活动:邀请好友一起购买,达到人数即可享受优惠价')
.fontSize(14)
.fontColor('#64748b')
.lineHeight(22)
.marginBottom(8);
Text('• 砍价活动:好友助力帮你砍价,越多人砍价价格越低')
.fontSize(14)
.fontColor('#64748b')
.lineHeight(22)
.marginBottom(8);
Text('• 活动期间随时可退出,退款将在活动结束后处理')
.fontSize(14)
.fontColor('#64748b')
.lineHeight(22)
.marginBottom(8);
Text('• 邀请好友参与可获得额外优惠券奖励')
.fontSize(14)
.fontColor('#64748b')
.lineHeight(22);
}
}
}
// 底部导航
Row()
.justifyContent(FlexAlign.SpaceAround)
.backgroundColor('#ffffff')
.borderTop({ width: 1, color: '#e2e8f0' })
.paddingVertical(12)
.position(Position.Fixed)
.bottom(0)
.width('100%') {
Column()
.alignItems(ItemAlign.Center)
.flex(1) {
Text('🏠')
.fontSize(20)
.fontColor('#94a3b8')
.marginBottom(4);
Text('首页')
.fontSize(12)
.fontColor('#94a3b8');
}
Column()
.alignItems(ItemAlign.Center)
.flex(1)
.paddingTop(4)
.borderTop({ width: 2, color: '#3b82f6' }) {
Text('👥')
.fontSize(20)
.fontColor('#3b82f6')
.marginBottom(4);
Text('拼团砍价')
.fontSize(12)
.fontColor('#3b82f6')
.fontWeight(FontWeight.Medium);
}
Column()
.alignItems(ItemAlign.Center)
.flex(1) {
Text('🛒')
.fontSize(20)
.fontColor('#94a3b8')
.marginBottom(4);
Text('购物车')
.fontSize(12)
.fontColor('#94a3b8');
}
Column()
.alignItems(ItemAlign.Center)
.flex(1) {
Text('👤')
.fontSize(20)
.fontColor('#94a3b8')
.marginBottom(4);
Text('我的')
.fontSize(12)
.fontColor('#94a3b8');
}
}
}
}
- 数据层完全复用:Activity/Participant 数据模型字段100%复用,仅调整 TypeScript/ArkTS 类型定义语法;
- 业务逻辑对等实现:参与活动、分享活动、进度计算等核心逻辑完全复用,仅调整 API 调用方式;
- 交互体验统一:选项卡切换、进度条展示、参与者头像堆叠等交互细节保持一致;
- 视觉体验一致:复用相同的色彩体系、间距规范、圆角大小、字体层级;
- 布局架构镜像:保持"头部-选项卡-活动列表-参与者列表-规则说明-底部导航"的核心布局结构;
- 性能优化对等:两端均采用列表复用、条件渲染等性能优化手段。
- 拼团砍价场景的核心是数据驱动的动态交互:活动进度的精准计算、参与者信息的可视化展示、参与/分享的完整交互流程,是跨端适配的核心;
- 强类型数据模型是跨端复用的基础:精准的 TypeScript/ArkTS 类型定义,保证了数据层在不同平台的一致性;
- 列表渲染是性能优化的关键:使用平台原生的高性能列表组件(FlatList/ForEach),避免长列表性能问题;
- 跨端适配的核心是逻辑复用+语法适配:90%以上的业务逻辑和视觉规范可跨端复用,仅需适配平台特有 API 和组件语法;
- 电商场景的视觉体验需符合用户认知:进度条、价格展示、按钮设计等视觉元素需遵循电商平台的设计规范,保证用户体验一致性。
这份拼团砍价应用的跨端适配实践,验证了 React Native 与鸿蒙 ArkTS 在电商营销场景下的高度兼容性,为跨端电商应用开发提供了可落地的技术参考。
真实演示案例代码:
js
// App.tsx
import React, { useState } from 'react';
import { SafeAreaView, View, Text, StyleSheet, TouchableOpacity, ScrollView, Dimensions, Alert, Image, FlatList } from 'react-native';
// Base64 图标库
const ICONS_BASE64 = {
calendar: 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==',
money: 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==',
gift: 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==',
timer: 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==',
check: 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==',
cart: 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==',
home: 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==',
user: 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNkYPhfDwAChwGA60e6kgAAAABJRU5ErkJggg==',
};
const { width, height } = Dimensions.get('window');
// 预售商品类型
type PreSaleProduct = {
id: string;
name: string;
image: string;
originalPrice: number;
deposit: number;
finalPayment: number;
totalPreSalePrice: number;
preSaleStartTime: string;
preSaleEndTime: string;
deliveryTime: string;
status: 'pre-sale' | 'final-payment' | 'shipped' | 'delivered';
progress: number;
features: string[];
};
// 预售订单参与应用组件
const PreSaleApp: React.FC = () => {
const [products] = useState<PreSaleProduct[]>([
{
id: '1',
name: 'iPhone 15 Pro Max 256GB',
image: 'https://via.placeholder.com/100x100',
originalPrice: 9999,
deposit: 500,
finalPayment: 8999,
totalPreSalePrice: 9499,
preSaleStartTime: '2023-11-01',
preSaleEndTime: '2023-11-15',
deliveryTime: '2023-12-01',
status: 'pre-sale',
progress: 60,
features: [
'A17 Pro芯片',
'钛金属机身',
'48MP主摄',
'USB-C接口'
]
},
{
id: '2',
name: '华为Mate60 Pro+',
image: 'https://via.placeholder.com/100x100',
originalPrice: 8999,
deposit: 400,
finalPayment: 7999,
totalPreSalePrice: 8399,
preSaleStartTime: '2023-10-25',
preSaleEndTime: '2023-11-10',
deliveryTime: '2023-11-20',
status: 'final-payment',
progress: 85,
features: [
'麒麟9000S芯片',
'卫星通信',
'XMAGE影像',
'昆仑玻璃'
]
},
{
id: '3',
name: '小米14 Ultra',
image: 'https://via.placeholder.com/100x100',
originalPrice: 6999,
deposit: 300,
finalPayment: 6399,
totalPreSalePrice: 6699,
preSaleStartTime: '2023-11-10',
preSaleEndTime: '2023-11-25',
deliveryTime: '2023-12-10',
status: 'pre-sale',
progress: 40,
features: [
'骁龙8 Gen3',
'徕卡光学镜头',
'120Hz曲面屏',
'无线充电'
]
}
]);
const [activeTab, setActiveTab] = useState<'pre-sale' | 'my-orders'>('pre-sale');
const participatePreSale = (productId: string) => {
Alert.alert(
'参与预售',
`您确定要参与"${products.find(p => p.id === productId)?.name}"的预售吗?\n\n定金: ¥${products.find(p => p.id === productId)?.deposit}`,
[
{
text: '取消',
style: 'cancel'
},
{
text: '确定',
onPress: () => {
Alert.alert('成功', '您已成功参与预售!定金已支付');
}
}
]
);
};
const payFinal = (productId: string) => {
Alert.alert(
'支付尾款',
`您需要支付尾款¥${products.find(p => p.id === productId)?.finalPayment}`,
[
{
text: '取消',
style: 'cancel'
},
{
text: '立即支付',
onPress: () => {
Alert.alert('成功', '尾款支付成功!商品即将发货');
}
}
]
);
};
const renderProduct = ({ item }: { item: PreSaleProduct }) => (
<View style={styles.productCard}>
<Image source={{ uri: item.image }} style={styles.productImage} />
<View style={styles.productInfo}>
<Text style={styles.productName}>{item.name}</Text>
<View style={styles.priceContainer}>
<Text style={styles.depositPrice}>定金: ¥{item.deposit}</Text>
<Text style={styles.finalPrice}>尾款: ¥{item.finalPayment}</Text>
</View>
<Text style={styles.originalPrice}>原价: ¥{item.originalPrice}</Text>
<Text style={styles.savePrice}>节省: ¥{item.originalPrice - item.totalPreSalePrice}</Text>
<View style={styles.timeContainer}>
<Text style={styles.timeText}>预售时间: {item.preSaleStartTime} - {item.preSaleEndTime}</Text>
<Text style={styles.timeText}>发货时间: {item.deliveryTime}</Text>
</View>
<View style={styles.progressBar}>
<View
style={[
styles.progressFill,
{ width: `${item.progress}%` }
]}
/>
</View>
<Text style={styles.progressText}>{item.progress}% 已售</Text>
<View style={styles.featuresContainer}>
<Text style={styles.featuresTitle}>产品特点:</Text>
<View style={styles.featuresList}>
{item.features.map((feature, index) => (
<View key={index} style={styles.featureItem}>
<Text style={styles.featureText}>• {feature}</Text>
</View>
))}
</View>
</View>
<View style={styles.buttonContainer}>
{item.status === 'pre-sale' && (
<TouchableOpacity
style={styles.preSaleButton}
onPress={() => participatePreSale(item.id)}
>
<Text style={styles.preSaleButtonText}>参与预售</Text>
</TouchableOpacity>
)}
{item.status === 'final-payment' && (
<TouchableOpacity
style={styles.finalPaymentButton}
onPress={() => payFinal(item.id)}
>
<Text style={styles.finalPaymentButtonText}>支付尾款</Text>
</TouchableOpacity>
)}
<TouchableOpacity style={styles.detailButton}>
<Text style={styles.detailButtonText}>查看详情</Text>
</TouchableOpacity>
</View>
</View>
</View>
);
return (
<SafeAreaView style={styles.container}>
{/* 头部 */}
<View style={styles.header}>
<Text style={styles.title}>预售专区</Text>
<Text style={styles.subtitle}>提前预订,享受优惠价格</Text>
</View>
<ScrollView style={styles.content}>
{/* 选项卡 */}
<View style={styles.tabContainer}>
<TouchableOpacity
style={[
styles.tab,
activeTab === 'pre-sale' && styles.activeTab
]}
onPress={() => setActiveTab('pre-sale')}
>
<Text style={[
styles.tabText,
activeTab === 'pre-sale' && styles.activeTabText
]}>预售商品</Text>
</TouchableOpacity>
<TouchableOpacity
style={[
styles.tab,
activeTab === 'my-orders' && styles.activeTab
]}
onPress={() => setActiveTab('my-orders')}
>
<Text style={[
styles.tabText,
activeTab === 'my-orders' && styles.activeTabText
]}>我的预售</Text>
</TouchableOpacity>
</View>
{/* 预售商品列表 */}
<FlatList
data={products.filter(p =>
activeTab === 'pre-sale'
? p.status === 'pre-sale' || p.status === 'final-payment'
: true
)}
renderItem={renderProduct}
keyExtractor={item => item.id}
showsVerticalScrollIndicator={false}
contentContainerStyle={styles.productList}
/>
{/* 预售说明 */}
<View style={styles.informationCard}>
<Text style={styles.informationTitle}>预售说明</Text>
<Text style={styles.informationText}>• 预售商品需支付定金锁定优惠价格</Text>
<Text style={styles.informationText}>• 尾款支付时间有限,请及时支付</Text>
<Text style={styles.informationText}>• 预售商品通常会提前发货</Text>
<Text style={styles.informationText}>• 预售期间不支持退款,特殊情况除外</Text>
</View>
{/* 优惠提醒 */}
<View style={styles.reminderCard}>
<Text style={styles.reminderTitle}>优惠提醒</Text>
<Text style={styles.reminderText}>• 预售商品平均优惠200-500元</Text>
<Text style={styles.reminderText}>• 部分商品赠送专属配件</Text>
<Text style={styles.reminderText}>• 早鸟用户享受额外折扣</Text>
</View>
</ScrollView>
{/* 底部导航 */}
<View style={styles.bottomNav}>
<TouchableOpacity style={styles.navItem}>
<Text style={styles.navIcon}>🏠</Text>
<Text style={styles.navText}>首页</Text>
</TouchableOpacity>
<TouchableOpacity style={[styles.navItem, styles.activeNavItem]}>
<Text style={styles.navIcon}>🎁</Text>
<Text style={styles.navText}>预售</Text>
</TouchableOpacity>
<TouchableOpacity style={styles.navItem}>
<Text style={styles.navIcon}>🛒</Text>
<Text style={styles.navText}>购物车</Text>
</TouchableOpacity>
<TouchableOpacity style={styles.navItem}>
<Text style={styles.navIcon}>👤</Text>
<Text style={styles.navText}>我的</Text>
</TouchableOpacity>
</View>
</SafeAreaView>
);
};
const styles = StyleSheet.create({
container: {
flex: 1,
backgroundColor: '#f5f7fa',
},
header: {
flexDirection: 'column',
alignItems: 'center',
padding: 16,
backgroundColor: '#ffffff',
borderBottomWidth: 1,
borderBottomColor: '#e2e8f0',
},
title: {
fontSize: 20,
fontWeight: 'bold',
color: '#1e293b',
marginBottom: 4,
},
subtitle: {
fontSize: 14,
color: '#64748b',
},
content: {
flex: 1,
},
tabContainer: {
flexDirection: 'row',
backgroundColor: '#ffffff',
marginHorizontal: 16,
borderRadius: 8,
marginBottom: 16,
elevation: 1,
shadowColor: '#000',
shadowOffset: { width: 0, height: 1 },
shadowOpacity: 0.1,
shadowRadius: 2,
},
tab: {
flex: 1,
paddingVertical: 12,
alignItems: 'center',
},
activeTab: {
backgroundColor: '#3b82f6',
borderRadius: 8,
},
tabText: {
fontSize: 16,
color: '#64748b',
fontWeight: '500',
},
activeTabText: {
color: '#ffffff',
},
productList: {
paddingHorizontal: 16,
},
productCard: {
backgroundColor: '#ffffff',
borderRadius: 12,
padding: 16,
marginBottom: 16,
elevation: 1,
shadowColor: '#000',
shadowOffset: { width: 0, height: 1 },
shadowOpacity: 0.1,
shadowRadius: 2,
},
productImage: {
width: '100%',
height: 200,
borderRadius: 8,
marginBottom: 12,
},
productInfo: {
flex: 1,
},
productName: {
fontSize: 18,
fontWeight: 'bold',
color: '#1e293b',
marginBottom: 8,
},
priceContainer: {
flexDirection: 'row',
justifyContent: 'space-between',
marginBottom: 4,
},
depositPrice: {
fontSize: 16,
color: '#ef4444',
fontWeight: 'bold',
},
finalPrice: {
fontSize: 16,
color: '#f59e0b',
fontWeight: 'bold',
},
originalPrice: {
fontSize: 14,
color: '#94a3b8',
textDecorationLine: 'line-through',
marginBottom: 2,
},
savePrice: {
fontSize: 14,
color: '#10b981',
fontWeight: '500',
marginBottom: 8,
},
timeContainer: {
marginBottom: 12,
},
timeText: {
fontSize: 14,
color: '#64748b',
marginBottom: 4,
},
progressBar: {
height: 6,
backgroundColor: '#e2e8f0',
borderRadius: 3,
overflow: 'hidden',
marginBottom: 4,
},
progressFill: {
height: '100%',
backgroundColor: '#3b82f6',
borderRadius: 3,
},
progressText: {
fontSize: 12,
color: '#64748b',
alignSelf: 'flex-end',
marginBottom: 12,
},
featuresContainer: {
marginBottom: 16,
},
featuresTitle: {
fontSize: 14,
fontWeight: '500',
color: '#1e293b',
marginBottom: 8,
},
featuresList: {
flexDirection: 'row',
flexWrap: 'wrap',
},
featureItem: {
marginRight: 12,
marginBottom: 8,
},
featureText: {
fontSize: 12,
color: '#64748b',
},
buttonContainer: {
flexDirection: 'row',
justifyContent: 'space-between',
},
preSaleButton: {
flex: 0.7,
backgroundColor: '#3b82f6',
paddingVertical: 12,
borderRadius: 6,
alignItems: 'center',
marginRight: 8,
},
preSaleButtonText: {
color: '#ffffff',
fontSize: 16,
fontWeight: '500',
},
finalPaymentButton: {
flex: 0.7,
backgroundColor: '#f59e0b',
paddingVertical: 12,
borderRadius: 6,
alignItems: 'center',
marginRight: 8,
},
finalPaymentButtonText: {
color: '#ffffff',
fontSize: 16,
fontWeight: '500',
},
detailButton: {
flex: 0.3,
backgroundColor: '#f1f5f9',
paddingVertical: 12,
borderRadius: 6,
alignItems: 'center',
},
detailButtonText: {
color: '#475569',
fontSize: 16,
fontWeight: '500',
},
informationCard: {
backgroundColor: '#ffffff',
marginHorizontal: 16,
marginBottom: 16,
borderRadius: 12,
padding: 16,
elevation: 1,
shadowColor: '#000',
shadowOffset: { width: 0, height: 1 },
shadowOpacity: 0.1,
shadowRadius: 2,
},
informationTitle: {
fontSize: 16,
fontWeight: '500',
color: '#1e293b',
marginBottom: 12,
},
informationText: {
fontSize: 14,
color: '#64748b',
lineHeight: 22,
marginBottom: 8,
},
reminderCard: {
backgroundColor: '#fffbeb',
marginHorizontal: 16,
marginBottom: 80,
borderRadius: 12,
padding: 16,
elevation: 1,
shadowColor: '#000',
shadowOffset: { width: 0, height: 1 },
shadowOpacity: 0.1,
shadowRadius: 2,
},
reminderTitle: {
fontSize: 16,
fontWeight: '500',
color: '#1e293b',
marginBottom: 12,
},
reminderText: {
fontSize: 14,
color: '#f59e0b',
lineHeight: 22,
marginBottom: 8,
},
bottomNav: {
flexDirection: 'row',
justifyContent: 'space-around',
backgroundColor: '#ffffff',
borderTopWidth: 1,
borderTopColor: '#e2e8f0',
paddingVertical: 12,
position: 'absolute',
bottom: 0,
left: 0,
right: 0,
},
navItem: {
alignItems: 'center',
flex: 1,
},
activeNavItem: {
paddingTop: 4,
borderTopWidth: 2,
borderTopColor: '#3b82f6',
},
navIcon: {
fontSize: 20,
color: '#94a3b8',
marginBottom: 4,
},
activeNavIcon: {
color: '#3b82f6',
},
navText: {
fontSize: 12,
color: '#94a3b8',
},
activeNavText: {
color: '#3b82f6',
fontWeight: '500',
},
});
export default PreSaleApp;

打包
接下来通过打包命令npn run harmony将reactNative的代码打包成为bundle,这样可以进行在开源鸿蒙OpenHarmony中进行使用。

打包之后再将打包后的鸿蒙OpenHarmony文件拷贝到鸿蒙的DevEco-Studio工程目录去:

最后运行效果图如下显示:

本文探讨了电商预售系统的React Native实现与鸿蒙跨端适配策略。系统采用TypeScript构建完整预售商品数据模型,包含价格、时间、状态等核心属性,确保类型安全和扩展性。通过React Hooks进行轻量级状态管理,实现模块化、响应式的UI更新。系统核心功能包括参与预售、支付尾款、商品信息展示等,采用React Native基础组件确保跨端兼容性。技术亮点包括:Base64图标处理简化资源管理、Dimensions API适配多屏幕尺寸、模块化样式设计提升可维护性。同时针对鸿蒙系统提供了API兼容性注意事项,为跨端电商应用开发提供了可落地的技术方案。