Skip to Content
Diseño

Guía de diseño de Qokit

Contrato de diseño público dirigido a la integración de la plataforma, desarrollo de extensiones y uso de componentes.

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

Guía de diseño de Qokit

La guía de diseño de Qokit está dirigida a futuros integradores de la plataforma, desarrolladores de extensiones y equipos frontend, explicando públicamente las bases de marca, interfaces de componentes, jerarquía visual, requisitos de diseño responsivo y estrategias de compatibilidad en las que se puede confiar a largo plazo.

Aquí se describe "qué pueden depender los desarrolladores", sin incluir la hoja de ruta interna del producto, los prompts de IA, el proceso de decisión del repositorio ni soluciones de implementación no publicadas.

Integración rápida

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

Al integrar, seleccione las capacidades en el siguiente orden:

  1. Seleccione componentes básicos como Button, Card y Dialog desde @qokit/components/ui;
  2. Seleccione combinaciones de productos estables desde @qokit/components/patterns;
  3. Utilice @qokit/components/skins/platform, site o admin para adaptarse a la interfaz objetivo;
  4. Utilice los Tokens CSS compartidos, no copie los estilos base de los componentes;
  5. Verifique los estados de escritorio, móvil, teclado y texto largo.

Mapa de la guía

Contenido necesarioDocumento
Colores de marca, fuentes, espaciado y Tokensfoundations.md
Diseño responsivo, teclado y accesibilidadaccessibility.md
Importación de componentes, contrato público Skeleton/Skin y formas de actualizacióncomponent-integration.md
Button e IconButtonbutton-component-rules.md
Card, Shell, superposiciones y materialescard-surface-materials.md
Estándares de calidad públicos para sitios generadosgenerated-site-quality.md
Cambios en el contrato y registro de actualizacioneschangelog.md

Contrato público

  • La estructura de los componentes, sus atributos y el comportamiento de accesibilidad son mantenidos por componentes compartidos;
  • Skin solo cambia los slots de clase y las variables CSS, no altera el comportamiento empresarial;
  • Los Tokens semánticos mantienen la misma responsabilidad en temas de tema claro, oscuro y sitios generados;
  • Los cambios disruptivos deben registrarse en Changelog y proporcionar instrucciones de migración;
  • Cuando exista una discrepancia entre la documentación y el código, prevalece la API del componente publicado, y la documentación se corrige en la misma versión.

En esta página