@hanzo/ui

블록

내용은 데이터입니다. 페이지는 블록의 목록이고, 각각이 타입을 부르면 타입이 렌더러를 고르고, 렌더러가 나머지를 읽습니다.

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

<Content blocks={page} />

블록은 데이터입니다. blockType 이 렌더러를 고르고, 다른 필드는 그 렌더러의 입력입니다. 페이지는 CMS 에서 쓰거나, 저장소에 넣거나, 서버가 만들어도 되고, 어느 쪽이든 타입이 붙습니다. 모든 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이름이 붙은 부분. 위의 앞제목, 제목, 아래의 바이라인. 각각 레벨과 마진이 있습니다.
imageImageDef 에서 온 이미지. src, alt, dim. 정렬과 휴대폰 힌트는 specifiers 안.
videoVideoDef. 소스, 포스터, 단마다의 크기.
space간격 단위의 세로 빈칸. 단마다, 또는 전체에 숫자 하나.
cta링크와 버튼의 행. fill, left, right, 그리고 휴대폰 힌트.
card제목이 있는 패널. 미디어, 내용, 행동 촉구.
bullet-cards한 줄 카드의 그리드. 각각 아이콘과 그 옆의 텍스트.
gridcells 위에 놓이는 GridDef. 단마다의 열과 gap 을 오름차순으로.
groupelements 위의 래퍼. 한꺼번에 먹는 힌트를 위해.
accordian트리거와 그 내용.
carte-blanche자유로운 패널. 위에 무엇이든, 제목, 아래에 무엇이든, 발에 행동 촉구.
screenful화면 한 장. 선택적인 배너 아래 한 열에서 세 열, 휴대폰 순서 포함.
element쓴 사람이 이미 만든 노드. 설계상 렌더러가 없습니다. 블록 페이지가 무엇이든 담을 수 있는 이유입니다.

모든 형태는 같은 서브패스에서 타입으로 익스포트됩니다. HeadingBlock, CTABlock, ScreenfulBlock 과 나머지입니다. 함께 쓰는 정의 GridDef, ImageDef, VideoDef, LinkDef, ButtonDef 도 옆에 있습니다. http 또는 mailto href 를 가진 LinkDef 는 그것만으로 외부이고, 새 탭에서 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) 은 한 종횡비의 상자를 다른 상자 안에 넣었을 때의 가장 큰 상자입니다. 둘 다 자기 렌더러를 위해 익스포트되어 있습니다. 블록 카탈로그는 각 렌더러의 예제를 타입 옆에 렌더합니다.