anchor-ui-vue
v1.0.0
Published
anchor ui toolkit
Downloads
15
Readme
Anchor-UI-Vue
基于 Element-UI 二次封装组件库, 简洁至上,灵活性高,99%支持原有属性
关于组件库文档
组件库文档先利用 vue-docgen
从源码注释中提取组件文档,然后结合组件示例文档,最终生成最终文档。利用vuepress
结合自定义插件(文档示例代码不用写两次)渲染出来。 这样做的好处有:
- 既规范,写好写全组件源码的注释,有利后续的维护。也可以从源码的注释中提取组件文档。
- 组件的示例 demo 与源码解偶开来,有利于各自的维护
- 自定义 vuepress 插件可以使写组件示例时,不用重复写两遍一样的代码
Component Kanban
目前提供如下组件
| Components | 快捷入口 | | ------------ | ---------------------------------------------------------------------- | | an-table | 文档实例 | | an-dialog | 文档实例 | | an-layout | 文档实例 | | an-separater | 文档实例 |
安装
1. 使用 npm 或 yarn 安装
推荐使用 npm 或 yarn 的方式进行开发,不仅可在开发环境轻松调试,也可放心地在生产环境打包部署使用,享受整个生态圈和工具链带来的诸多好处。
$ npm install anchor-ui-vue --save
$ yarn add anchor-ui-vue
2. 浏览器引入
在浏览器中使用 script 和 link 标签直接引入文件,并使用全局变量 AnchorUI
。
注:
anchor-ui-vue
是依赖element-ui
,所以务必先要引入 element-ui 相关 js 与 css
示例
1. vue-cli 脚手架搭建项目 -- github 地址
import Vue from "vue";
import ElementUI from "element-ui";
import "element-ui/lib/theme-chalk/index.css";
import AnchorUI from "anchor-ui-vue";
import App from "./App.vue";
Vue.use(ElementUI);
Vue.use(AnchorUI);
这是一个使用 vue-cli 搭建的 Anchor UI 在线 codesandbox 演示项目
2. 使用 CDN 静态页面
<!-- import Vue before Element -->
<script src="https://unpkg.com/vue/dist/vue.js"></script>
<!-- import ELEMTN CSS -->
<link
rel="stylesheet"
href="https://unpkg.com/element-ui/lib/theme-chalk/index.css"
/>
<!-- import ELMENT JavaScript -->
<script src="https://unpkg.com/element-ui/lib/index.js"></script>
<!-- anchor-ui -->
<script src="https://cdn.jsdelivr.net/gh/jackluson/anchor-ui@main/build/anchor-ui.umd.min.js"></script>
这是一个使用 CDN 引入的 Anchor UI 在线 codesandbox 演示项目。
遗留问题
- [] 偶尔出现源码改动,文档不会自动刷新问题
- []
Failed to execute 'appendChild' on 'Node'
问题 目前用 ClientOnly 解决, 可参考这篇文章