jslh-ui
v0.1.3
Published
jslh-ui
Downloads
3
Maintainers
Readme
快速使用
npm install jslh-ui --save
cnpm install jslh-ui --save
引入
import { createApp } from 'vue'
import App from '@/App.vue'
import jslh from 'jslh-ui'
import '../node_modules/jslh-ui/dist/style.css'
const app = createApp(App)
app.use(jslh)
app.mount('#app')
按需引用
import { mButton, mInput } from 'jslh-ui'
愉快开始
<m-button>默认按钮</m-buttonn>
<m-button type="primary">主要按钮</m-button>
文档集成规范
- 组件目录下新增 doc 文件夹用于文档编写。
- doc 文件夹下提供 doc.md,一个组件最多只允许一个 .md 文件。
- doc 文件同级存放 demo.vue 文件,demo 不限个数。
- 然后在 doc.md 文件顶部使用 setup 语法糖的方式引入 demo 文件,使用组件的形式展示。
- src/router/routerPage/page.js 引入 md 文件作为路由使用即可。
- 菜单管理文件在 /src/const/menuList.js, path 路劲二级路由名保持跟组件文件夹名及路由 path 配置一致。
- Attributes.vue 作为参数组件,具体使用示例请参考 buttom/doc/Attributes.vue。
- Events.vue 作为事件API组件,具体使用示例请参考 input/doc/Events.vue
- 如果有其他的api需要展示,新增相关组件文件并引入,例如:options.vue,具体使用示例请参考 tree/doc/options.vue
- 代码预览文件为 src/components/Preview.vue,同时在 doc.md 文件以组件的形式引入 Preview.vue ,接收两个props,compName 为组件目录名(建议与路由名保持一致),demoName 为要展示的 demo 文件名,例如:
//doc.md
<script setup>
import demo1 from './demo1.vue';
import demo2 from './demo2.vue';
import preview from '@/components/preview.vue'
<div class="componetnsBox">
<demo1/>
</div>
<preview compName="button" demoName="demo1"/>
<div class="componetnsBox">
<demo2/>
</div>
<preview compName="button" demoName="demo2"/>
</script>
项目启动
npm run dev
项目打包
npm run build
组件开发规范
- 通过在 packages 目录下创建组件目录结构,包含测试代码、入口文件、文档。
- 组件入口文件必须以 index.js 命名,并包含 install 方法,参考代码:
import mButton from "./index.vue";
mButton.install = (app) => {
app.component(mButton.name, mButton);
};
export default mButton;
packages 文件夹下 index.js 作为整体入口文件,须包含所有组件,若需要绑定全局变量或提供组件实例调用,参考代码:
app.config.globalProperties.$message = Message;
任何组件禁止使用三方依赖库。
组件内如果依赖了其他组件,需要在当前组件内引入,参考 select。