更新记录

1.2.0（2026-10-14）

视觉与示例

• 示例工程首页展示当前版本与组件数量；Forge 为视觉体系代号（产品名仍为 KK UI）
• 新增精选合集入口：输入框合集、精选卡片合集
• 组件分类新增占位：导航合集、Radio 合集（提示下版开发）
• 插件静态资源自包含：图标迁入 uni_modules/kk-ui/static/kk-icons/

特效按钮

• 新增 / 完善：kk-pearl-button、kk-documents-button、kk-comic-button、kk-fill-button、kk-top-button
• 新增：kk-rainbow-button、kk-flip-button、kk-buy-button、kk-ban-button、kk-apply-button
• 新增：kk-discover-button、kk-delete-button、kk-realism-button

表单与反馈

• 完善 kk-input、kk-checkbox、kk-notice、kk-empty 演示与样式

精选输入

• 新增：kk-search-glow、kk-subscribe-input、kk-outline-input、kk-label-input、kk-google-search
• 新增：kk-soft-search、kk-inbox-subscribe、kk-float-input、kk-chip-input、kk-neon-search

精选卡片

• 新增：kk-blob-card、kk-cookie-card、kk-glass-card、kk-order-card、kk-soft-card
• 新增：kk-code-card、kk-spin-card、kk-ticket-card、kk-corner-card、kk-alert-card

文档

• 补全 readme.md、license.md 与示例工程根说明

平台兼容性

uni-app x(4.19)

KK UI 组件库

面向 uni-app x 的付费级前端 UI 组件库（插件 ID：kk-ui）。

• 产品名：KK UI
• 视觉体系：Forge（墨色文字 #12141A + 靛蓝主色 #1F6FEB，统一圆角 / 间距令牌）
• 定位：成套业务密度与精选视觉组件，而非再做一个市场常见的浅蓝皮肤

当前版本见 package.json / KK_UI_VERSION（发布时请保持二者一致）。

环境要求

安装

1. 通过 DCloud 插件市场购买 / 导入
2. 插件目录为 uni_modules/kk-ui
3. 按 easycom 直接使用 kk-* 标签（无需手动 import 组件）

主题与版本工具：

import { KK_UI_VERSION, getTheme } from '@/uni_modules/kk-ui'

快速开始

<template>
  <view>
    <kk-notice text="欢迎使用 KK UI" type="info"></kk-notice>
    <kk-button type="primary" text="主按钮" @click="onTap"></kk-button>
    <kk-price :value="99"></kk-price>
  </view>
</template>

<script setup lang="uts">
  import { KK_UI_VERSION, getTheme } from '@/uni_modules/kk-ui'

  function onTap() {
    const theme = getTheme()
    uni.showToast({ title: theme.primary + ' · ' + KK_UI_VERSION, icon: 'none' })
  }
</script>

完整演示见示例工程首页：精选合集 + 组件分类。

组件一览

基础

展示

反馈

表单

精选 · 输入交互

精选 · 卡片视觉

规划中（下版）

常用 API（节选）

kk-button

kk-switch

kk-input

kk-steps

kk-price

更多属性与事件请查看示例工程各演示页，或直接阅读组件源码（源码授权版）。

主题令牌

import { getTheme } from '@/uni_modules/kk-ui'

const theme = getTheme()
// theme.primary / theme.ink / theme.surface
// theme.radiusSm / theme.radiusMd / theme.radiusLg
// theme.success / theme.warning / theme.danger ...

静态资源（图标）位于插件内：

uni_modules/kk-ui/static/kk-icons/

组件内引用路径为 /uni_modules/kk-ui/static/kk-icons/...，不依赖示例工程目录。

授权与售卖

价格以插件市场页面及 package.json → dcloudext.sale 为准。详见 license.md。

开发约束（维护者 / 二次开发）

• easycom：components/组件名/组件名.uvue
• 插件自包含：禁止引用示例工程或其他外部目录资源
• 禁止混入 utssdk
• 对外导出仅通过根目录 index.uts
• 插件内不得包含 manifest.json / pages.json / App.uvue / main.uts / uni.scss

示例工程说明

随插件上传的示例工程为完整演示 App：

• 首页：版本号、组件数量、精选合集、组件分类
• 分类页：基础 / 展示 / 反馈 / 表单；导航与 Radio 为下版占位
• 演示页：各组件交互预览

导入插件后，建议用 HBuilderX 打开示例工程，真机或模拟器跑通再集成到业务项目。