使无头组件易于设计

无头组件只是一个无样式组件，还是还有更多内容？

mallcloud商城

mallcloud商城基于SpringBoot2.x、SpringCloud和SpringCloudAlibaba并采用前后端分离vue的企业级微服务敏捷开发系统架构。并引入组件化的思想实现高内聚低耦合，项目代码简洁注释丰富上手容易，适合学习和企业中使用。真正实现了基于RBAC、jwt和oauth2的无状态统一权限认证的解决方案，面向互联网设计同时适合B端和C端用户，支持CI/CD多环境部署，并提

下载

网络已经通过要求定义样式来将样式与内容分开
在 css 中而不是 html 中。这种架构允许每个网页都采用全局
设计标准，无需定义任何特定于页面的样式。

随着网络演变成一个应用程序平台，开发人员寻找方法
他们不断增长的代码库更易于维护。如今，事实上的策略是
组织应用程序代码就是定义小型、轻量级的组件，这些组件可以
一起组成。因此，组件成为
中的组成单位 现代网络开发。

为了封装，组件通常会同时定义 html 和 css。
虽然这使它们更容易创作，但它们也可能更难
紧密结合到现有的设计系统中。这一点尤其正确
对于从外部供应商进口的第三方组件。

无头组件通过重新引入
之间的分离来解决这一挑战 内容和风格。然而现在分离是沿着组件边界的
反对 html 和 css 之间的关系。它们是创建出色的无头组件的关键
关键在于设计组件的接口，以便开发人员可以
清晰、轻松地应用自己的风格。

转发相关道具

从最基本的意义上来说，无头组件只是一个无样式的组件。
开发人员必须能够将自己的 css 应用到 html 元素中
组件定义.

对于简单的组件，这可能只是转发 classname 的问题
prop 到根元素，以便开发人员可以在他们的
中使用类选择器 css.

如果你的组件与原生 html 元素具有相同的语义，你可以使用
来自 react 的 componentprops 类型，以确保所有相关的 props
可转发。请记住省略任何您不希望用户使用的道具
您的组件能够覆盖。

import { type componentprops } from 'react'

function submitbutton({ ...props }: omit<componentprops<'button'>, 'type'>) {
  return <button type="submit" {...props} />
}

提供预定义类

对于包含一个或多个子元素的组件，开发者可能会
想要单独设置每个元素的样式。

支持这一点的一个策略是依赖
css 组合器。
例如，无头画廊组件的样式可能如下：

/* root container */
.gallery {
}

/* gallery items container */
.gallery > ul {
}

/* gallery item */
.gallery > ul > li {
}

/* next and previous buttons */
.gallery button {
}

但是这种方法产生了一个巨大的问题，因为现在
的内部 html 结构 该组件是其公共 api 的一部分。这会阻止您修改
稍后构建，而不会破坏下游代码。

更好的策略是为每个主要子元素预定义类。这边
开发人员可以使用类选择器，而不依赖于任何特定的 html
结构：

.xyz-gallery {
}

.xyz-gallery-next-button {
}

.xyz-gallery-previous-button {
}

.xyz-gallery-items-container {
}

.xyz-gallery-item {
}

记住给你的类添加前缀，这样它们就不会与
冲突 开发者自己的风格。

支持自定义布局

提供预定义的类可能是使开发人员能够实现的最快方法
设置你的组件的样式。然而，这种方法的一个缺点是
html 结构无法自定义。

这可能并不重要。毕竟，纯 html 的使用方式已经相当灵活了
可以渲染。然而，有时开发人员会按顺序获取额外的 html
来完成某些设计。如果您查看几乎所有的源代码
网站，您可能会看到大量无语义的

您可以通过将无头组件拆分为
来支持此类用例 多个相关组件。这样开发者就可以自由添加自己的
将元素布局到组件。例如，开发人员可以嵌入 next 和
自定义 flexbox 容器中图库示例中的上一个按钮：

<gallery>
  <galleryitems classname='gallery-items-container'>
    {data.map((item) => (
      <galleryitem key={item.id}>{item.content}</galleryitem>
    ))}
  </galleryitems>
  <div classname='gallery-buttons-container'>
    <gallerypreviousbutton>
    <gallerynextbutton>
  </div>
</gallery>

.gallery-items-container {
}

.gallery-buttons-container {
  display: flex;
  gap: 0.5rem;
  justify-content: flex-end;
}

这些类型的组件通常使用
实现 要传递的上下文
它们之间的数据。他们需要更多的工作来设计、实施和
文档。然而，它们所带来的多功能性通常意味着额外的努力
值得。

允许组件被覆盖

少数用例需要无头组件管理布局
其子组件。一个例子可能是层次树视图
允许通过拖放对其项目进行重新排序。另一个用例可能是
允许单页应用程序用 a 替换默认的锚元素 有助于客户端路由的自定义链接组件。

允许通过 props 覆盖正在渲染的实际子组件：

<treeview
  nodes={[...]}
  components={{
    customrow,
    customdragpreview: (props) => <div classname="drag-preview" {...props} />
  }}
/>

组件，同时允许无头组件管理其整体
结构.

通过道具。例如，这个按钮组件允许开发者渲染它
作为其他东西：

import { type elementtype } from 'react'

function headlessbutton({ as, ...props }: { as?: elementtype }) {
  const component = as ?? 'button'
  return <component {...props} />
}

开发人员可以指定应该使用锚元素来渲染
按钮：

<HeadlessButton as="a">Actually a link</HeadlessButton>

风格。优秀的无头组件是完全可扩展的，并允许开发人员
自定义整个内部 html 结构。