组装复合组件
上一章我们构建了第一个组件;本章扩展了我们学到的知识,构建了 TaskList,一个任务列表。让我们将组件组合在一起,看看引入更多复杂性后会发生什么。
Tasklist
Taskbox 通过将固定任务置于默认任务之上来强调固定任务。这产生了两种TaskList
变体,您需要为其创建故事:默认项和默认项和固定项。
由于Task
数据可以异步发送,因此我们也需要在没有连接的情况下渲染的加载状态。此外,当没有任务时,需要一个空状态。
开始设置
复合组件与它包含的基本组件没有什么不同。创建一个TaskList
组件和一个配套的故事文件:components/TaskList.jsx
和components/TaskList.stories.jsx
。
从TaskList
的粗略实现开始。您需要从之前的Task
组件导入,并将属性和操作作为输入传递。
import { Task } from './Task';
import { FlatList, StyleSheet, Text, View } from 'react-native';
import { styles } from './styles';
export const TaskList = ({ loading, tasks, onPinTask, onArchiveTask }) => {
const events = {
onPinTask,
onArchiveTask,
};
if (loading) {
return (
<View style={styles.listItems}>
<Text>loading</Text>
</View>
);
}
if (tasks.length === 0) {
return (
<View style={styles.listItems}>
<Text>empty</Text>
</View>
);
}
return (
<View style={styles.listItems}>
<FlatList
data={tasks}
keyExtractor={(task) => task.id}
renderItem={({ item }) => (
<Task key={item.id} task={item} {...events} />
)}
/>
</View>
);
};
接下来在故事文件中创建Tasklist
的测试状态。
import { TaskList } from './TaskList';
import { Default as TaskStory } from './Task.stories';
import { View } from 'react-native';
export default {
component: TaskList,
title: 'TaskList',
decorators: [
(Story) => (
<View style={{ padding: 42, flex: 1 }}>
<Story />
</View>
),
],
argTypes: {
onPinTask: { action: 'onPinTask' },
onArchiveTask: { action: 'onArchiveTask' },
},
};
export const Default = {
args: {
// Shaping the stories through args composition.
// The data was inherited from the Default story in Task.stories.js.
tasks: [
{ ...TaskStory.args.task, id: '1', title: 'Task 1' },
{ ...TaskStory.args.task, id: '2', title: 'Task 2' },
{ ...TaskStory.args.task, id: '3', title: 'Task 3' },
{ ...TaskStory.args.task, id: '4', title: 'Task 4' },
{ ...TaskStory.args.task, id: '5', title: 'Task 5' },
{ ...TaskStory.args.task, id: '6', title: 'Task 6' },
],
},
};
export const WithPinnedTasks = {
args: {
tasks: [
...Default.args.tasks.slice(0, 5),
{ id: '6', title: 'Task 6 (pinned)', state: 'TASK_PINNED' },
],
},
};
export const Loading = {
args: {
tasks: [],
loading: true,
},
};
export const Empty = {
args: {
// Shaping the stories through args composition.
// Inherited data coming from the Loading story.
...Loading.args,
loading: false,
},
};
装饰器是为故事提供任意包装器的一种方式。在这种情况下,我们使用装饰器在列表周围添加填充,以便更轻松地进行视觉验证。它们还可用于将故事包装在“提供者”中——例如,设置 React 上下文的库组件。
TaskStory.args.task
提供我们从Task.stories.js
文件中创建和导出的Task
的形状。类似地,我们为onPinTask
和onArchiveTask
添加的argTypes
告诉 Storybook 提供TaskList
组件需要的操作(模拟回调)。
如果您没有立即看到新的故事,请尝试重新加载应用程序。如果这不起作用,您可以重新运行yarn storybook-generate
来重新生成storybook.requires
文件。
现在检查 Storybook 中的新TaskList
故事。
构建状态
我们的组件仍然很粗糙,但现在我们对要努力实现的故事有了一个想法。您可能会认为listitems
包装器过于简单。您是对的——在大多数情况下,我们不会创建一个新组件只是为了添加一个包装器。但是,TaskList
组件的真正复杂性体现在withPinnedTasks
、loading
和empty
等边缘情况下。
对于加载情况,我们将创建一个新组件来显示加载动画。
创建一个名为LoadingRow.jsx
的新文件,内容如下
import { useState, useEffect } from 'react';
import { Animated, Text, View, Easing, StyleSheet } from 'react-native';
import { styles } from './styles';
const GlowView = ({ style, children }) => {
const [glowAnim] = useState(new Animated.Value(0.3));
useEffect(() => {
Animated.loop(
Animated.sequence([
Animated.timing(glowAnim, {
toValue: 1,
duration: 1500,
easing: Easing.ease,
useNativeDriver: true,
}),
Animated.timing(glowAnim, {
toValue: 0.3,
duration: 1500,
easing: Easing.ease,
useNativeDriver: true,
}),
])
).start();
}, []);
return (
<Animated.View
style={{
...style,
opacity: glowAnim,
}}
>
{children}
</Animated.View>
);
};
export const LoadingRow = () => (
<View style={styles.container}>
<GlowView>
<View style={styles.loadingItem}>
<View style={styles.glowCheckbox} />
<Text style={styles.glowText}>Loading</Text>
<Text style={styles.glowText}>cool</Text>
<Text style={styles.glowText}>state</Text>
</View>
</GlowView>
</View>
);
并更新TaskList.jsx
为以下内容
import { Task } from './Task';
import { FlatList, StyleSheet, Text, View } from 'react-native';
import { LoadingRow } from './LoadingRow';
import { MaterialIcons } from '@expo/vector-icons';
import { styles } from './styles';
export const TaskList = ({ loading, tasks, onPinTask, onArchiveTask }) => {
const events = {
onPinTask,
onArchiveTask,
};
if (loading) {
return (
<View style={[styles.listItems, { justifyContent: "center" }]}>
<LoadingRow />
<LoadingRow />
<LoadingRow />
<LoadingRow />
<LoadingRow />
<LoadingRow />
</View>
);
}
if (tasks.length === 0) {
return (
<View style={styles.listItems}>
<View style={styles.wrapperMessage}>
<MaterialIcons name="check" size={64} color={"#2cc5d2"} />
<Text style={styles.titleMessage}>You have no tasks</Text>
<Text style={styles.subtitleMessage}>Sit back and relax</Text>
</View>
</View>
);
}
const tasksInOrder = [
...tasks.filter((t) => t.state === 'TASK_PINNED'),
...tasks.filter((t) => t.state !== 'TASK_PINNED'),
];
return (
<View style={styles.listItems}>
<FlatList
data={tasksInOrder}
keyExtractor={(task) => task.id}
renderItem={({ item }) => (
<Task key={item.id} task={item} {...events} />
)}
/>
</View>
);
};
这些更改会产生以下 UI
成功!我们完成了我们开始的目标。如果我们检查更新后的 UI,我们可以很快看到我们的固定任务现在位于列表的顶部,符合预期设计。在接下来的章节中,我们将扩展我们学到的知识,并通过将这些原则应用于更复杂的 UI 来继续增加我们应用程序的复杂性。