Appearance
Components
@qxs-bns/components 是 QXS-BNS 的 Vue 3 组件库,包含桌面端业务组件、移动端组件和通用图标组件。
安装
bash
pnpm add @qxs-bns/components基础引入
vue
<script setup lang="ts">
import { QxsDataChart, QxsFixedActionBar } from '@qxs-bns/components'
</script>
<template>
<QxsDataChart :data="[]" />
<QxsFixedActionBar />
</template>组件默认按需导入。桌面端组件可能依赖 Element Plus、echarts、tinymce 等运行时能力,接入前建议先查看对应组件文档。
如果你需要题目编辑内核,优先使用 @qxs-bns/components-wc。
组件概览
桌面端组件
| 组件 | 说明 | 依赖 |
|---|---|---|
| QxsDataChart | 数据图表组件 | Element Plus, ECharts |
| QxsFileUpload | 文件上传组件 | Element Plus |
| QxsImageUpload | 图片上传组件 | Element Plus |
| QxsTinyMceEditor | 富文本编辑器 | TinyMCE |
| QxsSubjectList | 学科列表组件 | Element Plus |
| QxsAnswerContainer | 答案容器 | Element Plus |
移动端组件
| 组件 | 说明 | 依赖 |
|---|---|---|
| QxsFixedActionBar | 固定操作栏 | 无 |
| QxsPhotoCropTool | 图片裁剪工具 | 无 |
通用组件
| 组件 | 说明 | 依赖 |
|---|---|---|
| QxsIcon | 图标组件 | 无 |
适用场景
- 管理后台中的图表、上传、富文本编辑等业务组件。
- H5 页面中的固定操作栏、图片裁剪等轻量组件。
- 需要统一
QxsIcon入口的 Vue 3 项目。
使用建议
- 桌面端页面优先按需引入,并核对对应第三方依赖是否已安装。
- 移动端页面可以只使用轻量组件,不需要引入 Element Plus。
- 图标能力如果只需要 SVG 组件,可直接搭配
@qxs-bns/icons使用。