LETUNOFF DOCS

Other. Порядок пропсов

🧱 Суть

Порядок пропсов (или полей объекта) – это способ сделать код предсказуемым и легко читаемым.

Главное правило: порядок должен быть логичным, а не просто “красивым”.

📦 Проблема

1. Разный порядок в разных местах

title, id, completed, description

и

id, title, description, completed

Код становится труднее читать и сравнивать.

2. Сложнее поддерживать API и типы

Когда полей много – легко запутаться и ошибиться при передаче.

3. Нет единого мышления

Каждый пишет по-своему → хаос в моделях и функциях.

✅ Решение

Использовать единый порядок полей во всех объектах и функциях.

💻 Подробности

🔵 1. Идентификаторы

id, userId, taskId, columnId

🟣 2. Основные данные

title, description, status, priority

🟢 3. Состояние и структура

position, date, startDate, endDate, completed

🟠 4. Метаданные

created_at, updated_at, deleted_at

Пример (Task):

export type Task = {
  id: string;
  columnId: string;
 
  title: string;
  description: string;
  status: TaskStatus;
  priority: TaskPriority;
 
  position: number;
  date: string;
  startDate: string;
  endDate: string | null;
  completed: boolean;
 
  created_at?: string;
};

Пример (API):

addTaskApi({
  id,
  columnId,
 
  title,
  description,
  status,
  priority,
 
  position,
  date,
  startDate,
  endDate,
  completed,
});

Пример (Функция)

const editTask = async (
  id: string,
  title: string,
  description: string,
  status: TaskStatus,
  priority: TaskPriority,
 
  startDate: string,
  endDate: string | null,
  date: string,
 
  completed: boolean
) => {}

🎯 Вывод

  • порядок пропсов влияет на читаемость
  • главное – единый стандарт в проекте
  • лучше группировать по смыслу (id → данные → состояние → мета)
  • идеальный порядок снижает ошибки и упрощает рефакторинг

🔗 Связано