@hanzo/ui

الكتل

المحتوى بيانات. الصفحة قائمة كتل؛ كل واحدة تسمّي نوعها، والنوع يختار الراسم، والراسم يقرأ الباقي.

import { Content, type Block } from '@hanzo/ui/blocks'

<Content blocks={page} />

الكتلة بيانات: blockType يختار الراسم وبقية الحقول دخل ذلك الراسم. فيمكن تأليف الصفحة في نظام إدارة، أو إيداعها في مستودع، أو إنتاجها من خادم، وهي منمّطة في كل حال. كل حقل specifiers كيس تلميحات تخطيط مفصولة بمسافة يقرأها الراسم؛ هو سلسلة لا اتحاد، فيضيف الموقع تلميحًا بكتابته، والتلميح المجهول يُتجاهل ولا يُسقط البناء.

صفحة

import { Content, type Block } from '@hanzo/ui/blocks'

const page: Block[] = [
  {
    blockType: 'enh-heading',
    preheading: { text: 'Blocks' },
    heading: { text: 'Content as data', level: 2 },
    byline: { text: 'A page is a list of blocks; the type picks the renderer.' },
  },
  { blockType: 'space', sizes: 4 },
  {
    blockType: 'bullet-cards',
    grid: { at: { xs: { columns: 1, gap: 2 }, md: { columns: 3, gap: 3 } } },
    cards: [{ text: 'Typed either way' }, { text: 'Authored anywhere' }, { text: 'Rendered once' }],
  },
  { blockType: 'space', sizes: 4 },
  {
    blockType: 'cta',
    elements: [
      { title: 'Read the docs', href: '/docs' },
      { title: 'Source', href: 'https://github.com/hanzoai/ui', variant: 'outline' },
    ],
  },
]

<Content blocks={page} />

Blocks

Content as data

A page is a list of blocks; the type picks the renderer.

Typed either way

Authored anywhere

Rendered once

المفردات

النوعما يرسمه
headingعنوان مع سطر تابع اختياري، level 0 لفقرة و1 إلى 6 للوسوم.
enh-headingالأجزاء المسماة: عنوان تمهيدي فوق، والعنوان، وسطر تابع تحت، ولكل مستواه وهامشه.
imageصورة من ImageDef — src وalt وdim — مع المحاذاة وتلميحات الهاتف في specifiers.
videoVideoDef: مصادر، وملصق، ومقاس لكل درجة.
spaceفراغ رأسي بوحدات التباعد، لكل درجة أو رقم واحد للكل.
ctaصف روابط وأزرار: fill وleft وright، وتلميحات الهاتف.
cardلوح معنون بوسائط ومحتوى ودعوة إلى فعل.
bullet-cardsشبكة بطاقات من سطر، كل واحدة أيقونة إلى جانب نصها.
gridGridDef — أعمدة وفراغ لكل درجة، تصاعديًا — فوق cells.
groupغلاف فوق elements، لتلميحات تنطبق على الجملة.
accordianالمحفّزات ومحتواها.
carte-blancheلوح حر: أي شيء فوق، وعنوان، وأي شيء تحت، ودعوة إلى فعل في القدم.
screenfulملء شاشة: شريط اختياري فوق عمود إلى ثلاثة، مع ترتيب على الهاتف.
elementعقدة بناها المؤلف سلفًا. ليس لها راسم، عن قصد، وهذا ما يدع صفحة الكتل تمسك أي شيء.

كل شكل يُصدَّر نوعًا من subpath نفسه — HeadingBlock وCTABlock وScreenfulBlock والباقي — إلى جانب التعريفات التي تشترك فيها: GridDef وImageDef وVideoDef وLinkDef وButtonDef. LinkDef ذو href من نوع http أو mailto خارجي من نفسه ويفتح في لسان جديد مع rel="noreferrer noopener"؛ اذكر external فقط حيث لا يستطيع المخطط أن يقول.

الجهاز prop

يأخذ كل راسم agent، صنف الجهاز، بدل أن يقرأ استعلام وسيط. هذه الكتل تُصيَّر على خادم عليه أن يُخرج الوسم الصحيح من أول مرة: تخطيط هاتف يصل وسم سطح مكتب ثم يصحّح نفسه عند الإماهة قفزة مرئية، ولكتل الفيديو تنزيل ضائع.

<Content blocks={page} agent={isPhone ? 'phone' : 'desktop'} />

أنواعك أنت

الخريطة من النوع إلى الراسم هي نقطة التوسعة. يضيف المُضيف نوعًا له، أو يستبدل واحدًا — وهكذا يضع تطبيق Next صورته المحسِّنة، وهكذا يبلغ الصفحة ما لا تشحنه المكتبة.

import { registerBlockType, type BlockComponentProps } from '@hanzo/ui/blocks'

registerBlockType('quote', ({ block }: BlockComponentProps) => (
  <blockquote>{(block as { text: string }).text}</blockquote>
))

يجيب has(specifiers, token) هل التلميح في الكيس، وfit(dim, within) هو أكبر صندوق لنسبة داخل أخرى؛ والاثنان مصدَّران لراسمك. فهرس الكتل يصيّر أمثلة كل راسم إلى جانب أنواعه.