Skip to Content
Дизайн

Руководство по дизайну Qokit

Публичный контракт дизайна для интеграции платформы, расширения разработки и использования компонентов.

Qokit Design GuidePublic components, tokens & integrationQokit 设计指南公共组件、设计令牌与平台集成Qokit 設計指南公開元件、設計權杖與平台整合Guía de diseño de QokitComponentes públicos, tokens e integraciónQokit DesignleitfadenÖffentliche Komponenten, Tokens und IntegrationGuide de conception QokitComposants publics, jetons et intégrationGuia de design QokitComponentes públicos, tokens e integraçãoQokit デザインガイド公開コンポーネント、トークン、統合Qokit 디자인 가이드공개 컴포넌트, 토큰 및 통합Guida al design QokitComponenti pubblici, token e integrazioneQokit-ontwerpgidsPublieke componenten, tokens en integratiePanduan Desain QokitKomponen publik, token, dan integrasiHướng dẫn thiết kế QokitThành phần công khai, token và tích hợpQokit Tasarım RehberiHerkese açık bileşenler, tokenlar ve entegrasyonGuia de design QokitComponentes públicos, tokens e integraçãoГайд по дизайну QokitПубличные компоненты, токены и интеграцияدليل تصميم Qokitمكوّنات عامة ورموز تصميم وتكاملQokit डिज़ाइन गाइडसार्वजनिक कॉम्पोनेंट, टोकन और इंटीग्रेशनคู่มือการออกแบบ Qokitคอมโพเนนต์สาธารณะ โทเค็น และการผสานรวมPrzewodnik projektowy QokitPubliczne komponenty, tokeny i integracja

Руководство по дизайну Qokit

Руководство по дизайну Qokit предназначено для будущих интеграторов платформы, разработчиков расширений и команд фронтенда. В нем открыто описано, на какие базовые элементы бренда, интерфейсы компонентов, визуальную иерархию, требования к адаптивности и стратегии совместимости можно опираться в долгосрочной перспективе.

Здесь описывается «чем могут опираться разработчики», не включая внутренние продуктовые маршруты, AI-подсказки, процессы принятия решений в репозитории или неопубликованные решения реализации.

Быстрый старт

import { Button, Card } from '@qokit/components/ui';
import { platformButtonSkin, platformCardSkin } from '@qokit/components/skins/platform';

export function IntegrationAction() {
  return (
    <Card layer="shell" skin={platformCardSkin}>
      <Button skin={platformButtonSkin} type="button" variant="primary">
        连接 Qokit
      </Button>
    </Card>
  );
}

При подключении выбирайте возможности в следующем порядке:

  1. Выберите базовые компоненты, такие как Button, Card, Dialog и другие, из @qokit/components/ui;
  2. Выберите стабильные продуктовые комбинации из @qokit/components/patterns;
  3. Адаптируйте целевой интерфейс с помощью @qokit/components/skins/platform, site или admin;
  4. Используйте общие CSS Token, не копируя базовые стили компонентов;
  5. Проверьте работу на десктопе, мобильных устройствах, с клавиатуры и при длинных текстах.

Карта руководства

Что нужно знатьДокументация
Цвета бренда, шрифты, отступы и Tokenfoundations.md
Адаптивность, клавиатура и доступностьaccessibility.md
Импорт компонентов, публичный контракт Skeleton/Skin и способы обновленияcomponent-integration.md
Button и IconButtonbutton-component-rules.md
Card, Shell, всплывающие окна и материалыcard-surface-materials.md
Публичные стандарты качества сгенерированных сайтовgenerated-site-quality.md
Изменения контракта и журнал обновленийchangelog.md

Публичный контракт

  • Структура компонентов, атрибуты и поведение доступности поддерживаются общим компонентом;
  • Skin изменяет только слоты class и CSS переменные, не меняя бизнес-логику;
  • Семантические Token сохраняют одну и ту же роль в светлой, темной темах и темах сгенерированных сайтов;
  • Критические изменения должны быть задокументированы в Changelog, с предоставлением инструкций по миграции;
  • При расхождении между документацией и кодом приоритет отдается опубликованному API компонента, а документация исправляется в той же версии.

На этой странице