umbraco-kinds

Umbraco Kinds

什么是 Kind？

Kind 是一种预设配置，扩展会继承它以保持一致性。它通过定义可供多个扩展共用的默认属性，减少重复。Kind 可确保扩展采用标准化结构，并通过提供扩展自动继承的预定义属性，简化定义。

文档

实现前务必获取最新文档：

• 主要文档：https://docs.umbraco.com/umbraco-cms/extend-your-project/backoffice-extensions/extending-overview/extension-types/kind
• 基础：https://docs.umbraco.com/umbraco-cms/extend-your-project/backoffice-extensions/foundation
• 扩展注册表：https://docs.umbraco.com/umbraco-cms/extend-your-project/backoffice-extensions/extending-overview/extension-registry

工作流

1. 获取文档 - 对上述 URL 使用 WebFetch
2. 询问问题 - 扩展类型是什么？要共享哪些默认属性？
3. 生成文件 - 根据最新文档创建 Kind 清单和使用它的扩展
4. 说明 - 展示创建的内容及测试方法

最小示例

注册 Kind

import type { UmbExtensionManifestKind } from '@umbraco-cms/backoffice/extension-api';

export const customButtonKind: UmbExtensionManifestKind = {
  type: 'kind',
  alias: 'My.Kind.HeaderAppButton',
  matchType: 'headerApp',
  matchKind: 'button',
  manifest: {
    elementName: 'umb-header-app-button',
  },
};

在扩展中使用 Kind

const manifest = {
  type: 'headerApp',
  kind: 'button',  // Uses the 'button' kind
  name: 'My Header App',
  alias: 'My.HeaderApp',
  meta: {
    label: 'My App',
    icon: 'icon-heart',
    href: '/my-app',
  },
};

带有默认 Meta 属性的 Kind

export const cardKind: UmbExtensionManifestKind = {
  type: 'kind',
  alias: 'My.Kind.DashboardCard',
  matchType: 'dashboard',
  matchKind: 'card',
  manifest: {
    elementName: 'my-dashboard-card',
    meta: {
      // Default meta properties
      size: 'medium',
      color: 'default',
    },
  },
};

// Extension inherits defaults, can override
const dashboard = {
  type: 'dashboard',
  kind: 'card',
  alias: 'My.Dashboard',
  name: 'My Dashboard',
  meta: {
    label: 'Stats',
    pathname: 'stats',
    // size and color inherited from kind
  },
};

就是这样！务必获取最新文档，保持示例简洁，并生成完整可运行的代码。