1 Star 2 Fork 1

Jay_Ohhh / jay-ui(Vue UI组件库)

加入 Gitee
与超过 1200万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
克隆/下载
贡献代码
同步代码
取消
提示: 由于 Git 不支持空文件夾,创建文件夹后会生成空的 .keep 文件
Loading...
README
MIT

效果演示

  • 初始化vue项目

    vue create demo

  • 安装组件库

    yarn add heima-ui

  • 全局导入

    import HeimaUI from 'heima-ui' import 'heima-ui/lib/heimui.css'

    Vue.use(HeimaUI)

  • 使用组件

    显示登录框 男 女 登录 取消

常见组件封装

项目初始化

使用vue-cli脚手架快速搭建一个vue项目

// 选择scss babel 和 eslint
vue create itcast-ui

启动项目

cd itcast-ui
yarn serve

button组件

前置知识

组件通讯
组件插槽
props校验

参数支持

参数名 参数描述 参数类型 默认值
type 按钮类型(primary / success / warning / danger / info) string default plain 是否是朴素按钮 boolean false
round 是否是圆角按钮 boolean false
circle 是否是圆形按钮 boolean false
disabled 是否禁用按钮 boolean false
icon 图标类名 string 无

事件支持

事件名 事件描述 click 点击事件

基本结构

<template>
  <button class="hm-button">
    <span><slot></slot></span>
  </button>
</template>

样式

.hm-button {
  display: inline-block;
  line-height: 1;
  white-space: nowrap;
  cursor: pointer;
  background: #fff;
  border: 1px solid #dcdfe6;
  color: #606266;
  -webkit-appearance: none;
  text-align: center;
  box-sizing: border-box;
  outline: none;
  margin: 0;
  transition: 0.1s;
  font-weight: 500;
  // 禁止元素的文字被选中
  -moz-user-select: none;
  -webkit-user-select: none;
  -ms-user-select: none;
  padding: 12px 20px;
  font-size: 14px;
  border-radius: 4px;
  &:hover,
  &:focus {
    color: #409eff;
    border-color: #c6e2ff;
    background-color: #ecf5ff;
  }
}

type属性

结构

<button class="hm-button" :class="[`hm-button--${type}`]">

js

props: {
  type: {
    type: String,
    default: 'default'
  }
},

样式

.hm-button--primary {
  color: #fff;
  background-color: #409eff;
  border-color: #409eff;

  &:hover,
  &:focus {
    background: #66b1ff;
    border-color: #66b1ff;
    color: #fff;
  }
}
.hm-button--success {
  color: #fff;
  background-color: #67c23a;
  border-color: #67c23a;
  &:hover,
  &:focus {
    background: #85ce61;
    border-color: #85ce61;
    color: #fff;
  }
}
.hm-button--info {
  color: #fff;
  background-color: #909399;
  border-color: #909399;
  &:hover,
  &:focus {
    background: #a6a9ad;
    border-color: #a6a9ad;
    color: #fff;
  }
}
.hm-button--warning {
  color: #fff;
  background-color: #e6a23c;
  border-color: #e6a23c;
  &:hover,
  &:focus {
    background: #ebb563;
    border-color: #ebb563;
    color: #fff;
  }
}
.hm-button--danger {
  color: #fff;
  background-color: #f56c6c;
  border-color: #f56c6c;
  &:hover,
  &:focus {
    background: #f78989;
    border-color: #f78989;
    color: #fff;
  }
}

plain属性

// 朴素的按钮
.hm-button.is-plain {
  &:hover,
  &:focus {
    background: #fff;
    border-color: #409eff;
    color: #409eff;
  }
}
.hm-button--primary.is-plain {
  color: #409eff;
  background: #ecf5ff;
  border-color: #b3d8ff;
  &:hover,
  &:focus {
    background: #409eff;
    border-color: #409eff;
    color: #fff;
  }
}
.hm-button--success.is-plain {
  color: #67c23a;
  background: #f0f9eb;
  border-color: #c2e7b0;
  &:hover,
  &:focus {
    background: #67c23a;
    border-color: #67c23a;
    color: #fff;
  }
}

.hm-button--info.is-plain {
  color: #909399;
  background: #f4f4f5;
  border-color: #d3d4d6;
  &:hover,
  &:focus {
    background: #909399;
    border-color: #909399;
    color: #fff;
  }
}
.hm-button--warning.is-plain {
  color: #e6a23c;
  background: #fdf6ec;
  border-color: #f5dab1;
  &:hover,
  &:focus {
    background: #e6a23c;
    border-color: #e6a23c;
    color: #fff;
  }
}
.hm-button--danger.is-plain {
  color: #f56c6c;
  background: #fef0f0;
  border-color: #fbc4c4;
  &:hover,
  &:focus {
    background: #f56c6c;
    border-color: #f56c6c;
    color: #fff;
  }
}

round属性

.hm-button.is-round {
  border-radius: 20px;
  padding: 12px 23px;
}

circle属性

// 原形按钮
.hm-button.is-circle {
  border-radius: 50%;
  padding: 12px;
}

icon的支持

在main.js中引入字体图标文件

import './assets/fonts/font.scss'

结构

<i :class="icon" v-if="icon"></i>
<slot></slot>

js

icon: {
  type: String,
  default: ''
}

样式

// 按钮后的文本
.hm-button [class*=hm-icon-]+span {
    margin-left: 5px;
}

禁用按钮

  • props

    disabled: Boolean

  • 结构

    <button class="hm-button" :class="[`hm-button--${type}`, {
      'is-plain': plain,
      'is-round': round,
      'is-circle': circle,
      'is-disabled': disabled
      }]"
      :disabled="disabled"
      @click="handleClick"
    >
  • 样式

    // 禁用 .hm-button.is-disabled, .hm-button.is-disabled:focus, .hm-button.is-disabled:hover { color: #c0c4cc; cursor: not-allowed; background-image: none; background-color: #fff; border-color: #ebeef5; } .hm-button.is-disabled, .hm-button.is-disabled:focus, .hm-button.is-disabled:hover { color: #c0c4cc; cursor: not-allowed; background-image: none; background-color: #fff; border-color: #ebeef5; } .hm-button--primary.is-disabled, .hm-button--primary.is-disabled:active, .hm-button--primary.is-disabled:focus, .hm-button--primary.is-disabled:hover { color: #fff; background-color: #a0cfff; border-color: #a0cfff; } .hm-button--success.is-disabled, .hm-button--success.is-disabled:active, .hm-button--success.is-disabled:focus, .hm-button--success.is-disabled:hover { color: #fff; background-color: #b3e19d; border-color: #b3e19d; } .hm-button--info.is-disabled, .hm-button--info.is-disabled:active, .hm-button--info.is-disabled:focus, .hm-button--info.is-disabled:hover { color: #fff; background-color: #c8c9cc; border-color: #c8c9cc; } .hm-button--warning.is-disabled, .hm-button--warning.is-disabled:active, .hm-button--warning.is-disabled:focus, .hm-button--warning.is-disabled:hover { color: #fff; background-color: #f3d19e; border-color: #f3d19e; } .hm-button--danger.is-disabled, .hm-button--danger.is-disabled:active, .hm-button--danger.is-disabled:focus, .hm-button--danger.is-disabled:hover { color: #fff; background-color: #fab6b6; border-color: #fab6b6; }

click事件支持

结构

@click="handleClick"

js

methods: {
  handleClick (e) {
    this.$emit('click', e)
  }
}

dialog组件

前置知识

vue过渡与动画
sync修饰符
具名插槽与v-slot指令

参数支持

参数名 参数描述 参数类型 默认值
title 对话框标题 string 提示
width 宽度 string 50%
top 与顶部的距离 string 15vh visible 是否显示dialog(支持sync修饰符) boolean false

事件支持

事件名 事件描述
opened 模态框显示的事件 closed 模态框关闭的事件

插槽说明

插槽名称 插槽描述
default dialog的内容
title dialog的标题
footer dialog的底部操作区

基本结构

结构

<template>
  <div class="hm-dialog__wrapper">
    <div class="hm-dialog">
      <div class="hm-dialog__header">
        <span class="hm-dialog__title">提示</span>
        <button class="hm-dialog__headerbtn">
          <i class="hm-icon-close"></i>
        </button>
      </div>
      <div class="hm-dialog__body">
        <span>这是一段信息</span>
      </div>
      <div class="hm-dialog__footer">
        <hm-button>取消</hm-button>
        <hm-button type="primary">确定</hm-button>
      </div>
    </div>
  </div>
</template>

样式

.hm-dialog__wrapper {
  position: fixed;
  top: 0;
  right: 0;
  bottom: 0;
  left: 0;
  overflow: auto;
  margin: 0;
  z-index: 2001;
  background-color: rgba(0,0,0, .5);

  .hm-dialog {
    position: relative;
    margin: 15vh auto 50px;
    background: #fff;
    border-radius: 2px;
    box-shadow: 0 1px 3px rgba(0,0,0,.3);
    box-sizing: border-box;
    width: 30%;

    &__header {
      padding: 20px 20px 10px;
      .hm-dialog__title {
        line-height: 24px;
        font-size: 18px;
        color: #303133;
      }
      .hm-dialog__headerbtn {
        position: absolute;
        top: 20px;
        right: 20px;
        padding: 0;
        background: transparent;
        border: none;
        outline: none;
        cursor: pointer;
        font-size: 16px;
        .el-icon-close {
          color: #909399;
        }
      }
    }

    &__body {
      padding: 30px 20px;
      color: #606266;
      font-size: 14px;
      word-break: break-all;
    }
    &__footer {
      padding: 10px 20px 20px;
      text-align: right;
      box-sizing: border-box;
      .hm-button:first-child {
        margin-right: 20px;
      }
    }
  }
}

title属性

title属性既支持传入title属性,也只是传入title插槽

结构

<slot name="title">
  <span class="hm-dialog__title">{{title}}</span>
</slot>

js

props: {
  title: {
    type: String,
    default: '提示'
  }
}

width属性与top属性

结构

<div class="hm-dialog" :style="style">

js

  props: {
    title: {
      type: String,
      default: '提示'
    },
    width: {
      type: String,
      default: '50%'
    },
    top: {
      tpye: String,
      default: '15vh'
    }
  },
  computed: {
    style () {
      return {
        width: this.width,
        marginTop: this.top
      }
    }
  }

内容插槽

<div class="hm-dialog__body">
  <!-- 默认插槽 -->
  <slot></slot>
</div>

底部插槽

<div class="hm-dialog__footer" v-if="$slots.footer">
  <slot name="footer"></slot>
</div>

控制显示与隐藏

结构

<div class="hm-dialog__wrapper" v-show="visible">

点击遮罩层关闭

<div class="hm-dialog__wrapper" v-show="visible" @click.self="handleClose">

点击关闭按钮关闭

 <button class="hm-dialog__headerbtn" @click="handleClose">

关闭处理

handleClose () {
	this.$emit('update:visible', false)
}

动画处理

结构

<transition name="dialog-fade" @after-enter="afterEnter" @after-leave="afterLeave"></transition>

样式

.dialog-fade-enter-active {
  animation: dialog-fade-in .4s;
}

.dialog-fade-leave-active {
  animation: dialog-fade-out .4s;
}

@keyframes dialog-fade-in {
  0% {
    transform: translate3d(0, -20px, 0);
    opacity: 0;
  }
  100% {
    transform: translate3d(0, 0, 0);
    opacity: 1;
  }
}

@keyframes dialog-fade-out {
  0% {
    transform: translate3d(0, 0, 0);
    opacity: 1;
  }
  100% {
    transform: translate3d(0, -20px, 0);
    opacity: 0;
  }
}

js

afterEnter () {
  this.$emit('opened')
},
afterLeave () {
  this.$emit('closed')
}

input组件

参数支持

参数名称 参数描述 参数类型 默认值
placeholder 占位符 string 无
type 文本框类型(text/password) string text disabled 禁用 boolean false clearable 是否显示清空按钮 boolean false show-password 是否显示密码切换按钮 boolean false name name属性 string 无

事件支持

事件名称 事件描述
blur 失去焦点事件 change 内容改变事件 focus 获取的焦点事件

基本结构

节本结构

<template>
  <div class="hm-input">
    <input type="text" class="hm-input__inner">
  </div>
</template>

样式

.hm-input {
  width: 100%;
  position: relative;
  font-size: 14px;
  display: inline-block;
  .hm-input__inner {
    -webkit-appearance: none;
    background-color: #fff;
    background-image: none;
    border-radius: 4px;
    border: 1px solid #dcdfe6;
    box-sizing: border-box;
    color: #606266;
    display: inline-block;
    font-size: inherit;
    height: 40px;
    line-height: 40px;
    outline: none;
    padding: 0 15px;
    transition: border-color .2s cubic-bezier(.645,.045,.355,1);
    width: 100%;

    &:focus {
      outline: none;
      border-color: #409eff;
    }
  }
}

props处理placeholde, type,name

  • placeholer

    props: {
      placeholder: {
        type: String,
        default: ''
      }
    }
  • type属性-密码框

      <input
        class="hm-input__inner"
        :placeholder="placeholder"
        :type="type"
        :disabled="disabled"
      >
    
    
      type: {
        type: String,
        default: 'text'
      },

禁用按钮-disabled

结构

<div class="hm-input">
  <input
         class="hm-input__inner"
         :class="{'is-disabled': disabled}"
         :placeholder="placeholder"
         :type="type"
         :disabled="disabled"
         >
</div>

js

    disabled: {
      type: Boolean,
      default: false
    }

样式

    &.is-disabled {
      background-color: #f5f7fa;
      border-color: #e4e7ed;
      color: #c0c4cc;
      cursor: not-allowed;
    }

v-model语法糖

  • v-model语法糖

    给普通表单元素元素使用v-model

    给组件使用v-model指令,实质上相当于给组件传递了value属性以及监听了input事件 等价与

  • html结构

js

props: {
  value: [String, Number]
},
methods: {
    handleInput (e) {
      this.$emit('input', e.target.value)
    }
  }

clearable与show-password处理

如果给input组件传入clearable属性,会显示一个清空的按钮,如果传入show-password,则会显示一个用于切换密码显示的处理

  • 基本结构

  • props接收

    clearable: { type: Boolean, default: false }, showPassword: { type: Boolean, default: false }

  • 控制按钮显示和隐藏

样式

.hm-input--suffix {
  .hm-input__inner {
    padding-right: 30px;
  }
  .hm-input__suffix {
    position: absolute;
    height: 100%;
    right: 10px;
    top: 0;
    line-height: 40px;
    text-align: center;
    color: #c0c4cc;
    transition: all .3s;
    z-index: 900;
    i {
      color: #c0c4cc;
      font-size: 14px;
      cursor: pointer;
      transition: color .2s cubic-bezier(.645,.045,.355,1);
    }
  }
}
  • 控制hm-input--suffix的类名

  • 使用计算属性优化

    computed: { showSuffix () { return this.clearable || this.showPassword } }

  • 注册事件-清空内容和切换密码显示

      clear () {
        // console.log('123')
        this.$emit('input', '')
      }
  • 控制密码显示

    data () { return { // 是否显示密码 passwordVisible: false } },

    <input class="hm-input__inner" :class="{'is-disabled': disabled}" :placeholder="placeholder" :type="showPassword ? (passwordVisible ? 'text': 'password') : type" :name="name" :disabled="disabled" :value="value" @input="handleInput" ref="input"

    handlePasswordVisible () { // 切换type类型 this.passwordVisible = !this.passwordVisible }

  • 其他常见事件的支持

        handleFocus (e) {
          this.$emit('focus', e)
        },
        handleBlur (e) {
          this.$emit('blur', e)
        },
        handleChange (e) {
          this.$emit('change', e.target.value)
        }

    switch组件

    参数支持

    参数名称 参数描述 参数类型 默认值
    v-model 双向绑定 布尔类型 false name name属性 string text activeColor 自定义的激活的颜色 string
    inactiveColor 自定义的不激活的颜色 string

    事件支持

    事件名称 事件描述
    change change时触发的事件

    基本结构

    • 页面

    • 样式

      .hm-switch { display: inline-flex; align-items: center; position: relative; font-size: 14px; line-height: 20px; height: 20px; vertical-align: middle; .hm-switch__core { margin: 0; display: inline-block; position: relative; width: 40px; height: 20px; border: 1px solid #dcdfe6; outline: none; border-radius: 10px; box-sizing: border-box; background: #dcdfe6; cursor: pointer; transition: border-color .3s,background-color .3s; vertical-align: middle; .hm-switch__button { position: absolute; top: 1px; left: 1px; border-radius: 100%; transition: all .3s; width: 16px; height: 16px; background-color: #fff; } } }

    v-mode双向绑定

    • 接收value值

      props: { value: { type: Boolean, default: false } },

    • 注册点击事件

    • 事件处理程序

      methods: { handleClick () { this.$emit('input', !this.value) } }

    • 选中样式

      .hm-switch.is-checked { .hm-switch__core { border-color: #409eff; background-color: #409eff; .hm-switch__button { transform: translateX(20px); } } }

    • 控制选中样式

      自定义颜色

      在使用switch时,希望能够自定义开关的颜色

      <hm-switch
        v-model="value"
        active-color="#13ce66"
        inactive-color="#ff4949">
      </hm-switch>
      • props接收

        activeColor: { type: String, default: '' }, inactiveColor: { type: String, default: '' }

      • 封装设置颜色的方法

        setColor () { if (this.activeColor || this.inactiveColor) { let color = this.value ? this.activeColor : this.inactiveColor this.$refs.core.style.borderColor = color this.$refs.core.style.backgroundColor = color } }

      • 页面一进入调用

        mounted () { // 设置颜色 this.setColor() },

      • 改变状态后调用

        async handleClick () { this.$emit('input', !this.value) // 改变input框的值 await this.$nextTick() this.setColor() },

      name属性支持

      用户在使用switch组件的时候,实质上是当成表单元素来使用的。因此可能会用到组件的name属性。因此需要在switch组件中添加一个checkbox,并且当值改变的时候,也需要设置checkbox的value值

      • 结构

        <input class="hm-switch__input" type="checkbox"

      • 样式

        .hm-switch__input { position: absolute; width: 0; height: 0; opacity: 0; margin: 0; }

      • name属性的支持

        name: { type: String, default: '' }

      • 控制checkbox的值与value同步

        mounted () {
          this.$refs.input.checked = this.value
        },
        methods: {
          async handleChange () {
            this.$emit('input', !this.value)
            // 修改checkbox的值
            await this.$nextTick()
            this.$refs.input.checked = this.value
          }
        }

      radio组件

      前置知识点

      radio的基本使用

      参数支持

      参数名称 参数描述 参数类型 默认值
      v-model 双向绑定 布尔类型 false label 单选框的value值 string,num,boolean ''
      name name属性 string

      基本结构

      • html结构

        我是label
      • 样式

        .hm-radio { color: #606266; font-weight: 500; line-height: 1; position: relative; cursor: pointer; display: inline-block; white-space: nowrap; outline: none; font-size: 14px; margin-right: 30px; -moz-user-select: none; -webkit-user-select: none; -ms-user-select: none; .hm-radio__input { white-space: nowrap; cursor: pointer; outline: none; display: inline-block; line-height: 1; position: relative; vertical-align: middle; .hm-radio__inner { border: 1px solid #dcdfe6; border-radius: 100%; width: 14px; height: 14px; background-color: #fff; position: relative; cursor: pointer; display: inline-block; box-sizing: border-box; &:after { width: 4px; height: 4px; border-radius: 100%; background-color: #fff; content: ""; position: absolute; left: 50%; top: 50%; transform: translate(-50%,-50%) scale(0); transition: transform .15s ease-in; } } .hm-radio__original { opacity: 0; outline: none; position: absolute; z-index: -1; top: 0; left: 0px; right: 0; bottom: 0; margin: 0; } } .hm-radio__label { font-size: 14px; padding-left: 10px; } }

      选中的样式

      .hm-radio.is-checked {
        .hm-radio__input {
          .hm-radio__inner {
            border-color: #409eff;
            background: #409eff;
            &:after {
              transform: translate(-50%,-50%) scale(1);
            }
          }
        }
        .hm-radio__label {
          color: #409eff;
        }
      }

      label与插槽的处理

      • props接收

        props: { label: { type: String, default: '' }, name: { type: String, default: '' } }

      • 处理插槽

        {{label}}

      v-model处理

      • 接收props数据

        name: { type: String, default: '' }, value: { type: [String, Boolean, Number], default: '' }

      • 结构

        <input class="hm-radio__original" type="radio" :name="name" value="label" v-model="model"

      • 提供计算属性

        computed: { model: { get () { return this.value }, set (value) { this.$emit('input', value) } } },

      • 控制选中样式

      radio-group组件

      使用radio组件的缺点,需要给每个组件都绑定v-mode,可以使用radio-group包裹

      前置知识

      provide与inject

      基本结构

      结构

      <template>
        <div class="radio-group">
          <slot></slot>
        </div>
      </template>

      数据

      export default {
        name: 'HmRadioGroup',
        provide () {
          return {
            RadioGroup: this
          }
        },
        props: {
          value: null
        }
      }

      修改radio组件

      • 接收inject

        inject: { RadioGroup: { default: '' } },

      • 计算属性判断是否包裹在group中

        // 判断包裹在group中 isGroup () { return !!this.RadioGroup }

      • 修改代码

        model: { get () { return this.isGroup ? this.RadioGroup.value : this.value }, set (value) { this.isGroup ? this.RadioGroup.$emit('input', value) : this.$emit('input', value) } }

      checkbox组件

      基本结构

      <template>
        <label class="hm-checkbox">
          <span class="hm-checkbox__input">
            <span class="hm-checkbox__inner"></span>
            <input type="checkbox" class="hm-checkbox__original">
          </span>
          <span class="hm-checkbox__label">
            <slot></slot>
            <template v-if="!$slots.default">{{label}}</template>
          </span>
        </label>
      </template>

      样式

      .hm-checkbox {
        color: #606266;
        font-weight: 500;
        font-size: 14px;
        position: relative;
        cursor: pointer;
        display: inline-block;
        white-space: nowrap;
        user-select: none;
        margin-right: 30px;
        .hm-checkbox__input {
          white-space: nowrap;
          cursor: pointer;
          outline: none;
          display: inline-block;
          line-height: 1;
          position: relative;
          vertical-align: middle;
          .hm-checkbox__inner {
            display: inline-block;
            position: relative;
            border: 1px solid #dcdfe6;
            border-radius: 2px;
            box-sizing: border-box;
            width: 14px;
            height: 14px;
            background-color: #fff;
            z-index: 1;
            transition: border-color .25s cubic-bezier(.71,-.46,.29,1.46),background-color .25s cubic-bezier(.71,-.46,.29,1.46);
            &:after {
              box-sizing: content-box;
              content: "";
              border: 1px solid #fff;
              border-left: 0;
              border-top: 0;
              height: 7px;
              left: 4px;
              position: absolute;
              top: 1px;
              transform: rotate(45deg) scaleY(0);
              width: 3px;
              transition: transform .15s ease-in .05s;
              transform-origin: center;
            }
          }
          .hm-checkbox__original {
            opacity: 0;
            outline: none;
            position: absolute;
            left: 10px;
            margin: 0;
            width: 0;
            height: 0;
            z-index: -1;
          }
        }
        .hm-checkbox__label {
          display: inline-block;
          padding-left: 10px;
          line-height: 19px;
          font-size: 14px;
        }
      }

      选中的样式

      .hm-checkbox.is-checked {
        .hm-checkbox__input {
          .hm-checkbox__inner {
            background-color: #409eff;
            border-color: #409eff;
            &:after {
              transform: rotate(45deg) scaleY(1);
            }
          }
        }
        .hm-checkbox__label {
          color: #409eff;
        }
      }

      接收props数据

      value: {
        type: Boolean,
        default: false
      },
      name: {
        type: String,
        default: ''
      },
      label: {
        type: String,
        default: ''
      }

      控制checked样式

      • 控制label

        {{label}}
      • 提供model计算属性

        model: { get () { return this.value }, set (value) { this.$emit('input', value) } }

      • 判断是否选中

      checkbox-group组件

      使用checkbox-group组件包裹checkbox

      结构

      <template>
        <div class="hm-checkbox-group">
          <slot></slot>
        </div>
      </template>


      • 提供provide

        props: { value: { type: Array, default: function () { return [] } } }, provide () { return { CheckboxGroup: this } }

      修改checkbox

      • 接收inject

        inject: { CheckboxGroup: { default: '' } },

      • 修改

          model: {
            get () {
              return this.isGroup ? this.CheckboxGroup.value : this.value
            },
            set (value) {
              if (this.isGroup) {
                // 修改value属性
                console.log(value, this.label)
                this.CheckboxGroup.$emit('input', value)
              } else {
                this.$emit('input', value)
              }
            }
          },  

        isGroup () { return !!this.CheckboxGroup }, isChecked () { // 判断是否选中 // console.log(this.model) if (this.isGroup) { return this.model.includes(this.label) } else { return this.model } }

      form组件

      基本结构

      <template>
        <div class="hm-form">
          <slot></slot>
        </div>
      </template>
      
      <script>
      export default {
        name: 'HmForm',
        provide () {
          return {
            Form: this
          }
        },
        props: {
          model: {
            type: Object,
            required: true
          },
          labelWidth: {
            type: String,
            default: '80px'
          }
        }
      }
      </script>
      
      <style>
      
      </style>

      form-item组件

      基本结构

      <template>
        <div class="hm-form-item">
          <label class="hm-form-item__label" :style="labelStyle">{{label}}</label>
          <div class="hm-form-item__content">
            <slot></slot>
          </div>
        </div>
      </template>
      
      <script>
      export default {
        name: 'HmFormItem',
        props: {
          label: {
            type: String,
            default: ''
          }
        },
        inject: ['Form'],
        computed: {
          labelStyle () {
            return {
              width: this.Form.labelWidth
            }
          }
        }
      }
      </script>
      
      <style lang="scss">
      .hm-form-item {
        margin-bottom: 25px;
        .hm-form-item__label {
          text-align: right;
          vertical-align: middle;
          float: left;
          font-size: 14px;
          color: #606266;
          line-height: 40px;
          padding: 0 12px 0 0;
          box-sizing: border-box;
        }
        .hm-form-item__content {
          line-height: 40px;
          position: relative;
          font-size: 14px;
          overflow: hidden;
        }
      }
      </style>


      封装成UI组件库

      目录调整

      • 根目录创建两个文件夹packages和examples

        packages: 用于存放所有的组件 examples: 用于进行测试,把src改成examples

      • 把components中所有的组件放入到packages中

      • 把fonts放到packages中

      • 删除原来的src目录

      vue.config.js配置

      新增vue.config.js配置

      const path = require('path')
      module.exports = {
        pages: {
          index: {
            entry: 'examples/main.js',
            template: 'public/index.html',
            filename: 'index.html'
          }
        },
        // 扩展 webpack 配置,使 packages 加入编译
        chainWebpack: config => {
          config.module
            .rule('js')
            .include.add(path.resolve(__dirname, 'packages')).end()
            .use('babel')
            .loader('babel-loader')
            .tap(options => {
              // 修改它的选项...
              return options
            })
        }
      }

      • 统一导出packages中所有的组件

        // 统一导出 // 导入颜色选择器组件 import Button from './button' import Dialog from './dialog' import Input from './input' import Checkbox from './checkbox' import Radio from './radio' import RadioGroup from './radio-group' import Switch from './switch' import CheckboxGroup from './checkbox-group' import Form from './form' import FormItem from './form-item' import './fonts/font.scss'

        // 存储组件列表 const components = [ Button, Dialog, Input, Checkbox, Radio, RadioGroup, Switch, CheckboxGroup, Form, FormItem ]

        // 定义 install 方法,接收 Vue 作为参数。如果使用 use 注册插件,则所有的组件都将被注册 const install = function (Vue) { // 遍历注册全局组件 components.forEach(component => { Vue.component(component.name, component) }) }

        // 判断是否是直接引入文件,如果是,就不用调用 Vue.use() if (typeof window !== 'undefined' && window.Vue) { install(window.Vue) }

        // 导出的对象必须具有 install,才能被 Vue.use() 方法安装 export default { install }

      测试

      在examples中的main.js中进行导入测试

      import Vue from 'vue'
      import App from './App.vue'
      
      import HeimaUI from '../packages'
      
      Vue.use(HeimaUI)
      
      Vue.config.productionTip = false
      
      new Vue({
        render: h => h(App)
      }).$mount('#app')


      发布到npm与github

      发布到github

      发布到npm

      https://cli.vuejs.org/zh/guide/build-targets.html#%E5%BA%93

      • 在package.json的"scripts"中新增一条 打包命令

        "lib": "vue-cli-service build --target lib packages/index.js"

        然后运行 npm run lib

      • 发布到npm

      修改package.json文件

      // 设置为false
      "private": false, 
      "main": "dist/itcast-ui.umd.min.js",
      "author": {
        "name": "胡聪聪"
      },

      增加 `.npmignore文件

      # 忽略目录
      examples/
      packages/
      public/
       
      # 忽略指定文件
      vue.config.js
      babel.config.js
      *.map

      • npm发布

        npm -g install nrm , nrm ls 查看所有源地址 , nrm use npm 切换到 npm 的源地址

        npm login npm publish

        每次上传都要修改package.json的version(包的版本)

        如果遇到403错误,可能是package.json的name有其他人使用过。

MIT License Copyright (c) 2022 Jay_Ohhh Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

简介

将组件打包制作成组件库 基于Vue2.x 展开 收起
JavaScript 等 4 种语言
MIT
取消

发行版

暂无发行版

贡献者

全部

近期动态

加载更多
不能加载更多了
JavaScript
1
https://gitee.com/Jay_Ohhh/jay-ui.git
git@gitee.com:Jay_Ohhh/jay-ui.git
Jay_Ohhh
jay-ui
jay-ui(Vue UI组件库)
master

搜索帮助