Back to Intro to Storybook
Chapters
  • !ابدأ
  • مكون بسيط
  • مكون مركب
  • البياتات
  • واجهات
  • أطلق
  • الاختبار
  • الإضافات
  • الخلاصة
  • ساهم

جمّع مكون مركب

جمّع مكون مركب من مكونات بسيطة
هذه الترجمة المجتمعية لم يتم تحديثها إلى اخر اصدار من ستوريبوك بعد. ساعدنا في تحديثها عن طريق اتباع التغييرات في دليل العربية في هذه الترجمة طلبات Pull مرحب بها.

بنينا في أخر فصل مكوننا الأول; هذا الفصل يوسع مع تعلمناه لبناء قائمة مهام, قائمة بها مجموعة مهام. لندمج مكونات معا ونرى ما سيحصل عندما يتم إضافة مستوى جديد من التعقيد.

لائحة المهام

صندوق المهام يبين المهام المثبتة بوضعهم فوق المهام الافتراضية. هذا يكون نوعان من لائحة المهام الذان تحتاج لإنشاء ..ستوريز لهما: عناصر افتراضية وعناصر مثبتة.

مهام افتراضية ومثبتة

بما أن بيانات Task ترسل بشكل غير متزامن, سنحتاج إلى حالة تحميل للعرض خلال غياب الاتصال. إضافةً إلى ذلك سنحتاج أيضا حالة فارغة عندما لا توجد مهام في اللائحة.

مهام فارغة ومحملة

الإعداد

لا يختلف مكون مركب عن مكون بسيط من ناحية المحتوى. قم بإنشاء مكون لائحة مهام مع ملف ستوري المصاحب له: src/components/TaskList.js وsrc/components/TaskList.stories.js.

ابدأ بتنفيذ مبسط لـلائحة المهام. ستحتاج لاستيراد مكون Task الذي كوناه سابقا وتمرير الخصائص والأحداث كمدخل

Copy
src/components/TaskList.js
import React from 'react';

import Task from './Task';

export default function TaskList({ loading, tasks, onPinTask, onArchiveTask }) {
  const events = {
    onPinTask,
    onArchiveTask,
  };

  if (loading) {
    return <div className="list-items">loading</div>;
  }

  if (tasks.length === 0) {
    return <div className="list-items">empty</div>;
  }

  return (
    <div className="list-items">
      {tasks.map(task => (
        <Task key={task.id} task={task} {...events} />
      ))}
    </div>
  );
}

ثم قم بإنشاء حالات اختبار Tasklist في ملف الستوري.

Copy
src/components/TaskList.stories.js
import React from 'react';

import TaskList from './TaskList';
import * as TaskStories from './Task.stories';

export default {
  component: TaskList,
  title: 'TaskList',
  decorators: [story => <div style={{ padding: '3rem' }}>{story()}</div>],
};

const Template = args => <TaskList {...args} />;

export const Default = Template.bind({});
Default.args = {
  // Shaping the stories through args composition.
  // The data was inherited from the Default story in task.stories.js.
  tasks: [
    { ...TaskStories.Default.args.task, id: '1', title: 'Task 1' },
    { ...TaskStories.Default.args.task, id: '2', title: 'Task 2' },
    { ...TaskStories.Default.args.task, id: '3', title: 'Task 3' },
    { ...TaskStories.Default.args.task, id: '4', title: 'Task 4' },
    { ...TaskStories.Default.args.task, id: '5', title: 'Task 5' },
    { ...TaskStories.Default.args.task, id: '6', title: 'Task 6' },
  ],
};

export const WithPinnedTasks = Template.bind({});
WithPinnedTasks.args = {
  // Shaping the stories through args composition.
  // Inherited data coming from the Default story.
  tasks: [
    ...Default.args.tasks.slice(0, 5),
    { id: '6', title: 'Task 6 (pinned)', state: 'TASK_PINNED' },
  ],
};

export const Loading = Template.bind({});
Loading.args = {
  tasks: [],
  loading: true,
};

export const Empty = Template.bind({});
Empty.args = {
  // Shaping the stories through args composition.
  // Inherited data coming from the Loading story.
  ...Loading.args,
  loading: false,
};
💡 Decorators هي طريقة لتوفير أغلفة مجردة للستوريز. في هذه الحالة نستخدم `key` decorator مع التصديرة الافتراضية مع بعض الـ`padding` حول المكون المُغلف. يمكن أيضا استخدامهم لتغليف الستوريز في "providers" (يقصد بها مكون المكتبة الذي يستخدم مع رياكت context)

باستيراد TaskStories نحن قادرون على جمع الحجج (args) في الستوريز خاصتنا بأقل جهد. بهذه الطريقة تبقى البيانات والأحداث المتوقعة من كلتا المكونين محفوظة

تفقد الأن ستوريبوك لترى الستوريز الخاصة بـTaskList

قم ببناء الحالة

لا يزال مكوننا في حالته المبدئية ولكننا الأن نملك فكرة عن الستوريز التي سنعمل عليها. قد تعتقد بأن الغلاف .list-items مفرط في البساطة. فعلا هو كذلك, غالبا لن نحتاج لإنشاء مكون جديد فقط من أجل غلاف. ولكن التعقيد الفعلي لمكون TaskList يظهر في الحالات الطرفية withPinnedTasks, loading, وempty.

Copy
src/components/TaskList.js
import React from 'react';

import Task from './Task';

export default function TaskList({ loading, tasks, onPinTask, onArchiveTask }) {
  const events = {
    onPinTask,
    onArchiveTask,
  };

  const LoadingRow = (
    <div className="loading-item">
      <span className="glow-checkbox" />
      <span className="glow-text">
        <span>Loading</span> <span>cool</span> <span>state</span>
      </span>
    </div>
  );
  if (loading) {
    return (
      <div className="list-items">
        {LoadingRow}
        {LoadingRow}
        {LoadingRow}
        {LoadingRow}
        {LoadingRow}
        {LoadingRow}
      </div>
    );
  }
  if (tasks.length === 0) {
    return (
      <div className="list-items">
        <div className="wrapper-message">
          <span className="icon-check" />
          <div className="title-message">You have no tasks</div>
          <div className="subtitle-message">Sit back and relax</div>
        </div>
      </div>
    );
  }
  const tasksInOrder = [
    ...tasks.filter(t => t.state === 'TASK_PINNED'),
    ...tasks.filter(t => t.state !== 'TASK_PINNED'),
  ];
  return (
    <div className="list-items">
      {tasksInOrder.map(task => (
        <Task key={task.id} task={task} {...events} />
      ))}
    </div>
  );
}

نص الوصف المٌضاف يٌنتج الواجهة التالية:

لاحظ موضع العنصر المثبت في اللائحة. نريد إظهار العنصر المثبت في أعلى الائحة لإعطائه أولوية لمستخدمينا.

متطلبات البيانات والخاصيات

كلما نما المكون, نمت معه متطلبات الإدخال. حدد متطلبات الخاصيات لـTaskList. لأن Task هو مكون تابع, تأكد أن البيانات المعطاة في حالة صحيحة للإظهار. لحفظ الجهد والوقت, أعد استخدام propTypes التي حددتها في Task سابقا.

Copy
src/components/TaskList.js
import React from 'react';
import PropTypes from 'prop-types';

import Task from './Task';

export default function TaskList() {
  ...
}

+ TaskList.propTypes = {
+  /** Checks if it's in loading state */
+  loading: PropTypes.bool,
+  /** The list of tasks */
+  tasks: PropTypes.arrayOf(Task.propTypes.task).isRequired,
+  /** Event to change the task to pinned */
+  onPinTask: PropTypes.func,
+  /** Event to change the task to archived */
+  onArchiveTask: PropTypes.func,
+ };
+ TaskList.defaultProps = {
+  loading: false,
+ };

اختبار مميكن

في الفصل السابق تعلمنا كيفية إجراء اختبار لمحة على الستوريز خاصتنا باستخدام Storyshots. مع Task لا يوجد الكثير من التقيد لاختبار أن الإظهار يجري بشكل صحيح. بما أن TaskList تضيف طبقة أخرى من التعقيد نريد التأكد من أن بعض المدخلات تنتج إخراجات محددة بطريقة تتيح الاختبار المميكن. للقيام بذلك, سننشئئ اختبارات وحدة باستخدام مكتبة رياكت للاختبار و@storybook/testing-react.

شعار مكتبة الاختبار

اختبارات الوحدة ومكتبة اختبار رياكت

الستوريز الخاصة بستوريبوك والاختبارات اليدوية واختبارات اللمحة تساعد كثيرا في تجنب أخطاء الواجهات. إذا غطت الستوريز أنواع مختلفة من حالات استخدام المكون, واستخدامنا الأدوات التي تضمن أن شخص سيرى التغيير الذي يطرأ على ستوري, تكون احتمالية وقوع الأخطاء قليلة بشكل ملحوظ.

و لكن العبرة في التفاصيل, وجود منصة اختبار صريحة حول هذه التفاصيل مطلوبة وهو ما يقودنا إلى اختبارات الوحدة

في حالتنا هذه, نريد من TaskList إظهار المهام المثبتة قبل المهام الغير مثبتة التي تم تمريرها إلى خاصيات task. بالرغم من أن لدينا ستوري (WithPinnedTasks) لنختبرها في هذا السيناريو إلا أن الأمر قد يبدو مجهولا لشخص ما إذا كان المكون أوقف ترتيب المهام بهذا الشكل ام أنه خطأ برمجي فهي بالطبع لن تٌعلم المستخدم بأنها خطأ

لذلك ولتفادي هذه المشكلة يمكننا استخدام مكتبة اختبار رياكت لإظهار الستوري في الـDOM وتنفيذ بعض أوامر استعلام حول DOM للتأكد من أن المزايا الظاهرة. ما يميز صيغة الستوري هو أنه يمكننا وبكل بساطة استيراد الستوري إلى اختباراتنا, ثم إظهارها هناك!

أنشئ ملف اختبار اسمه src/components/TaskList.test.js هنا سنقوم ببناء اختباراتنا التي ستقوم بتأكيد المخرجات

Copy
src/components/TaskList.test.js
import { render } from '@testing-library/react';

import { composeStories } from '@storybook/testing-react';

import * as TaskListStories from './TaskList.stories'; //👈  Our stories imported here

//👇 composeStories will process all information related to the component (e.g., args)
const { WithPinnedTasks } = composeStories(TaskListStories);

it('renders pinned tasks at the start of the list', () => {
  const { container } = render(<WithPinnedTasks />);

  expect(
    container.querySelector('.list-item:nth-child(1) input[value="Task 6 (pinned)"]')
  ).not.toBe(null);
});
💡 @storybook/testing-react هي إضافة رائعة تسمح لك بإعادة استخدام ستوريز خاصتك في وحدات الاختبار. بإعادة استخدام الستوريز خاصتك في اختباراتك, يكون لديك فهرس من سيناريوهات المكون جاهزة للاختبار. إضافة إلى ذلك كل الحجج (args), مزينات, والمعلومات الأخرى من الستوري سيتم تجميعها عن طريق هذه المكتبة. كما لاحظت, كل ما عليك فعله في اختباراتك هو اختيار أي ستوري لإظهارها

مشغل اختبار لائحة المهام

لاحظ أننا كنا قادرين على إعادة استخدام ستوري WithPinnedTasks في اختبار الوحدة خاصتنا; بهذه الطريقة يمكننا الاستمرار في الاستفادة من مصادر موجودة بطرق مختلفة

لاحظ أيضا أن هذا الاختبار هش بعض الشيئ, من المحتمل أن بنضج المشروع والتنفيذ الخاص بـTask بحد ذاته يتبدل -- ربما باستخدام classname مختلف أو textarea بدلا من input-- سيفشل الاختبار وسيحتاج للتحديث. هذه ليست مشكلة بالضرورة وإنما مؤشر لتوخي الحذر عند استخدام اختبارات الوحدة بكثرة للواجهات. ذلك لان ليس من السهل متابعتهم. عوضا عن ذلك اعتمد الاختبارات اليدوية واللمحة والانحدار المظهري (يرجى مراجعة فصل الاختبار ) كلما أتاحت الفرصة.

💡 لا تنسى تنفيذ هذه التغييرات إلى git
Keep your code in sync with this chapter. View 429780a on GitHub.
Is this free guide helping you? Tweet to give kudos and help other devs find it.
Next Chapter
البياتات
تعلم كيفية ربط البيانات مع مكون واجهة المستخدم
✍️ Edit on GitHub – PRs welcome!
Join the community
6,582 developers and counting
WhyWhy StorybookComponent-driven UI
Open source software
Storybook

Maintained by
Chromatic
Special thanks to Netlify and CircleCI