Skip to Content
Thiết kế

Hướng dẫn Thiết kế Qokit

Hợp đồng thiết kế công khai dành cho tích hợp nền tảng, phát triển mở rộng và sử dụng thành phần.

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

Hướng dẫn thiết kế Qokit

Hướng dẫn thiết kế Qokit hướng tới các bên tích hợp nền tảng trong tương lai, nhà phát triển mở rộng và đội ngũ frontend, công khai các nền tảng thương hiệu, giao diện thành phần, cấp độ trực quan, yêu cầu đáp ứng và chiến lược tương thích mà có thể dựa vào lâu dài.

Ở đây mô tả "nhà phát triển có thể dựa vào gì", không bao gồm lộ trình sản phẩm nội bộ, gợi ý AI, quá trình ra quyết định kho lưu trữ hoặc các giải pháp triển khai chưa được công khai.

Tiếp cận nhanh

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>
  );
}

Khi tiếp cận, hãy chọn khả năng theo thứ tự sau:

  1. Chọn Button, Card, Dialog và các thành phần cơ bản từ @qokit/components/ui;
  2. Chọn tổ hợp sản phẩm ổn định từ @qokit/components/patterns;
  3. Sử dụng @qokit/components/skins/platform, site hoặc admin để thích nghi với giao diện mục tiêu;
  4. Sử dụng Token CSS chia sẻ, không sao chép kiểu cơ bản của thành phần;
  5. Xác minh trạng thái trên máy tính để bàn, di động, bàn phím và văn bản dài.

Bản đồ hướng dẫn

Nội dung cần biếtTài liệu
Màu thương hiệu, phông chữ, khoảng cách và Tokenfoundations.md
Đáp ứng, bàn phím và khả năng tiếp cậnaccessibility.md
Nhập thành phần, Hợp đồng chung Skeleton/Skin và cách nâng cấpcomponent-integration.md
Button và IconButtonbutton-component-rules.md
Card, Shell, lớp nổi và vật liệucard-surface-materials.md
Tiêu chuẩn chất lượng công khai cho trang được tạogenerated-site-quality.md
Thay đổi hợp đồng và nhật ký nâng cấpchangelog.md

Hợp đồng công khai

  • Cấu trúc thành phần, thuộc tính và hành vi khả năng tiếp cận được duy trì bởi thành phần chia sẻ;
  • Skin chỉ thay đổi slot class và biến CSS, không thay đổi hành vi nghiệp vụ;
  • Token ngữ nghĩa giữ cùng trách nhiệm trong chủ đề sáng, tối và trang được tạo;
  • Các thay đổi phá vỡ phải được ghi lại trong Changelog và cung cấp hướng dẫn di chuyển;
  • Khi tài liệu và mã nguồn có sự khác biệt, hãy dựa vào API thành phần đã phát hành và sửa tài liệu trong cùng phiên bản đó.

Trong trang này