wiztekui

wiztekui

wiztek UI project https://github.com/xoxleidu/wiztekui

Setup

# install wiztekui
npm install wiztekui -s
# main.js
import wiztekui from "wiztekui";
Vue.use(wiztekui);
import "wiztekui/lib/css/wiztekui.min.css";

使用 scss 更换主题颜色

# color theme
create myui.scss In main.js
## package.json
"sass-loader": "^7.3.1",
"node-sass": "^4.14.1",

# myui.scss:
$--color-primary: "#0062cc";
$--color-success: "#28a745";
$--color-warning: "#ffc107";
$--color-danger: "#dc3545";
$--color-info: "#6d757d";

## in end
@import "~wiztekui/lib/scss/wiztekui.scss";

button

<wzButton type="primary" size="medium">按钮</wzButton>
<wzButton type="success" size="small" :loading="loading">加载</wzButton>
<wzButton type="warning" size="mini" :disabled="disabled">禁用</wzButton>
<wzButton type="primary" icon="wz-icon-phone">带图标</wzButton>
<wzButton type="danger" size="big" @change="handleButtonChange">点击</wzButton>

export default {
  data() {
    return {
      loading: true,
      disabled: true
    };
  },
  methods: {
    handleButtonChange() {
      console.log("change...");
    }
  }
};

Attributes

Events

card

<wzCard type="primary" shadow="hover">
  <div slot="header" class="clearfix">
    <span>卡片名称</span>
    <wzButton size="mini" style="float: right; padding: 3px">操作按钮</wzButton>
  </div>
  <div>列表内容</div>
</wzCard>
<style>
  .clearfix {
    clear: both;
  }
</style>

Attributes

collapse

折叠面板

<wz-collapse v-model="activeNames" @change="collapseHandleChange">
  <wz-collapse-item name="1">
    <template slot="title">
      一致性 Consistency<i class="header-icon wz-icon-info"></i>
    </template>
    <div>
      与现实生活一致：与现实生活的流程、逻辑保持一致，遵循用户习惯的语言和概念；
    </div>
    <div>
      在界面中一致：所有的元素和结构需保持一致，比如：设计样式、图标和文本、元素的位置等。
    </div>
  </wz-collapse-item>
  <wz-collapse-item title="反馈 Feedback" name="2">
    <div>
      控制反馈：通过界面样式和交互动效让用户可以清晰的感知自己的操作；
    </div>
    <div>
      页面反馈：操作后，通过页面元素的变化清晰地展现当前状态。
    </div>
  </wz-collapse-item>
  <wz-collapse-item title="效率 Efficiency" name="3">
    <div>简化流程：设计简洁直观的操作流程；</div>
    <div>
      清晰明确：语言表达清晰且表意明确，让用户快速理解进而作出决策；
    </div>
    <div>
      帮助用户识别：界面简单直白，让用户快速识别而非回忆，减少用户记忆负担。
    </div>
  </wz-collapse-item>
  <wz-collapse-item title="可控 Controllability" name="4">
    <div>
      用户决策：根据场景可给予用户操作建议或安全提示，但不能代替用户进行决策；
    </div>
    <div>
      结果可控：用户可以自由的进行操作，包括撤销、回退和终止当前操作等。
    </div>
  </wz-collapse-item>
</wz-collapse>
<script>
  export default {
    data() {
      return {
        activeNames: ["1"]
      };
    },
    methods: {
      collapseHandleChange(val) {
        console.log(val);
      }
    }
  };
</script>

collapse Attributes

collapse Events

collapse Item Attributes

icon

<i class="wz-icon-loading"></i>

loading

<div v-loading="loading">
  <wzButton @change="handleDivLoadingChange">dom加载</wzButton>
  <wzButton @change="handleFusLoadingChange">全屏加载</wzButton>
</div>
<script>
  export default {
    data() {
      return {
        loading: false
      };
    },
    methods: {
      handleDivLoadingChange() {
        this.loading = true;
        setTimeout(() => {
          this.loading = false;
        }, 3000);
      },
      handleFusLoadingChange() {
        this.$loading();
        setTimeout(() => {
          this.$loading().close();
        }, 3000);
      }
    }
  };
</script>

如果完整引入了 loading, Vue.prototype 上会有一个全局方法 $loading，它的调用方式为：this.$loading(options)，同样会返回一个 Loading 实例。此时调用它们中任意一个的 close 方法都能关闭这个全屏 Loading。

Options

message

<wzButton @change="handleMessageChange">message</wzButton>
<script>
  import { Message } from "wiztekui";
  export default {
    data() {
      return {
        loading: false
      };
    },
    methods: {
      handleMessageChange() {
        Message.primary("信息");
      }
    }
  };
</script>

Vue.prototype 上会有一个全局方法 $message，它的调用方式为：this.$message(options)，同样会返回一个 Message 实例。此时调用它们中任意一个的 close 方法都能关闭这个全屏 Message。

Options

message Methods

input

<wzInput v-model="input"></wzInput>
<wzInput v-model="input">
  <template slot="prepend">Http://</template>
</wzInput>

Attributes

Input Slots

Input Events

Input Methods

radio

<wzRadio v-model="radio" label="1"></wzRadio>
<wz-radio-group v-model="radio">
  <wz-radio :label="2">radio2</wz-radio>
  <wz-radio :label="3">radio3</wz-radio>
</wz-radio-group>
<wz-radio-group v-model="radio">
  <wz-radio-button :label="4">按钮4</wz-radio-button>
  <wz-radio-button :label="5">按钮5</wz-radio-button>
</wz-radio-group>

Radio Attributes

Radio-group Attributes

Radio-button Attributes

Events

checkbox

<wzCheckbox v-model="checkbox" label="1"></wzCheckbox>
<wz-checkbox-group v-model="checkbox">
  <wz-checkbox :label="2">多选项</wz-checkbox>
  <wz-checkbox :label="3">多选项</wz-checkbox>
</wz-checkbox-group>
<wz-checkbox-group v-model="checkbox">
  <wz-checkbox-button :label="4">多选项</wz-checkbox-button>
  <wz-checkbox-button :label="5">多选项</wz-checkbox-button>
</wz-checkbox-group>

<wz-checkbox
  :indeterminate="isAllCheck"
  v-model="checkAll"
  @change="handleCheckAllChange"
  >全选</wz-checkbox
>
<wz-checkbox-group v-model="checkbox2" @change="handleChecked2Change">
  <wz-checkbox :label="21">多选项</wz-checkbox>
  <wz-checkbox :label="22">多选项</wz-checkbox>
  <wz-checkbox :label="23">多选项</wz-checkbox>
  <wz-checkbox :label="24">多选项</wz-checkbox>
</wz-checkbox-group>
<script>
  export default {
    data() {
      return {
        checkAll: false,
        checkbox2: [],
        isAllCheck: false
      };
    },
    methods: {
      handleCheckAllChange(val) {
        this.checkbox2 = val ? [21, 22, 23, 24] : [];
        this.isAllCheck = false;
      },
      handleChecked2Change(value) {
        let checkedCount = value.length;
        this.checkAll = checkedCount === [21, 22, 23, 24].length;
        this.isAllCheck =
          checkedCount > 0 && checkedCount < [21, 22, 23, 24].length;
      }
    }
  };
</script>

checkbox Attributes

checkbox-group Attributes

checkbox-button Attributes

Events

switch

<wzSwitch v-model="meSwitch"></wzSwitch>
<wz-switch
  v-model="meSwitch"
  active-color="#0062cc"
  inactive-color="#0062cc"
  active-text="精确到日"
  inactive-text="精确到时"
>
</wz-switch>

switch Attributes

switch Events

switch Methods

Dialog

在保留当前页面状态的情况下，告知用户并承载相关操作。

<wz-button type="text" @change="dialogVisible = true"
  >点击打开 Dialog</wz-button
>

<wz-dialog
  title="提示"
  :visible.sync="dialogVisible"
  width="30%"
  :before-close="handleClose"
>
  <span>这是一段信息</span>
  <span slot="footer" class="dialog-footer">
    <wz-button @change="dialogVisible = false">取 消</wz-button>
    <wz-button type="primary" @change="dialogVisible = false">确 定</wz-button>
  </span>
</wz-dialog>

<script>
  export default {
    data() {
      return {
        dialogVisible: false
      };
    },
    methods: {
      handleClose(done) {
        done();
      }
    }
  };
</script>

Dialog 的内容是懒渲染的，即在第一次被打开之前，传入的默认 slot 不会被渲染到 DOM 上。因此，如果需要执行 DOM 操作，或通过 ref 获取相应组件，请在 open 事件回调中进行。

如果 visible 属性绑定的变量位于 Vuex 的 store 内，那么 .sync 不会正常工作。此时需要去除 .sync 修饰符，同时监听 Dialog 的 open 和 close 事件，在事件回调中执行 Vuex 中对应的 mutation 更新 visible 属性绑定的变量的值。

Dialog Attributes

Slot

Events

tooltip

文字提示

<wz-tooltip placement="top" content="top 提示文字"
  ><span>上提示</span></wz-tooltip
>

tooltip 内不支持 router-link 组件，请使用 vm.$router.push 代替。 tooltip 内不支持 disabled form 元素，参考 MDN，请在 disabled form 元素外层添加一层包裹元素。

tooltip Attributes

Popover

Popover 的属性与 Tooltip 很类似，它们都是基于 Vue-popper 开发的，因此对于重复属性，请参考 Tooltip 的文档，在此文档中不做详尽解释。

<template>
  <wz-popover
    placement="top-start"
    title="标题"
    width="200"
    trigger="hover"
    content="这是一段内容,这是一段内容,这是一段内容,这是一段内容。"
  >
    <wz-button slot="reference">hover 激活</wz-button>
  </wz-popover>

  <wz-popover
    placement="bottom"
    title="标题"
    width="200"
    trigger="click"
    content="这是一段内容,这是一段内容,这是一段内容,这是一段内容。"
  >
    <wz-button slot="reference">click 激活</wz-button>
  </wz-popover>

  <wz-popover
    ref="popover"
    placement="right"
    title="标题"
    width="200"
    trigger="focus"
    content="这是一段内容,这是一段内容,这是一段内容,这是一段内容。"
  >
  </wz-popover>
  <wz-button v-popover:popover>focus 激活</wz-button>

  <wz-popover
    placement="bottom"
    title="标题"
    width="200"
    trigger="manual"
    content="这是一段内容,这是一段内容,这是一段内容,这是一段内容。"
    v-model="visible"
  >
    <wz-button slot="reference" @change="visible = !visible"
      >手动激活</wz-button
    >
  </wz-popover>
</template>

<script>
  export default {
    data() {
      return {
        visible: false
      };
    }
  };
</script>

如需改变背景颜色，添加 popper-class='wz-popover-tooltip'，border的颜色位置为placement的选项，默认 bottom,参数为：border- + placement.split("-")[0] + -color

<style>
.wz-popover-tooltip {
  background-color: #333;
}
.wz-popover-tooltip .popper__arrow::after {
  border-bottom-color: #333 !important;
}
</style>

Popover Attributes

Slot

Events

Menu

<wz-menu>
  <wz-menu-item index="1">处理中心</wz-menu-item>
  <wz-submenu index="2">
    <template slot="title">我的工作台</template>
    <wz-menu-item index="2-1">选项1</wz-menu-item>
    <wz-menu-item index="2-2"
      ><template slot="title"
        ><i class="wz-icon-phone"></i><span>选项2</span></template
      ></wz-menu-item
    >
    <wz-menu-item index="2-3">选项3</wz-menu-item>
    <wz-submenu index="2-4">
      <template slot="title">选项4</template>
      <wz-menu-item index="2-4-1">选项1</wz-menu-item>
      <wz-menu-item index="2-4-2">选项2</wz-menu-item>
      <wz-menu-item index="2-4-3">选项3</wz-menu-item>
    </wz-submenu>
  </wz-submenu>
  <wz-menu-item index="3">
    <template slot="title">
      <i class="wz-icon-back-left"></i>
      <span>消息中心</span>
    </template>
  </wz-menu-item>
  <wz-submenu index="4">
    <template slot="title">订单管理</template>
    <wz-menu-item index="4-1">选项1</wz-menu-item>
    <wz-menu-item index="4-2">选项2</wz-menu-item>
  </wz-submenu>
</wz-menu>

Menu Attributes

Menu Methods

Menu Events

SubMenu Attribute

Menu-Item Attribute

Menu-Group Attribute

布局

<div class="wz-header">header</div>
<div class="wz-footer">footer</div>
<div class="wz-container">container</div>
<div class="wz-container wz-container-fixed wz-container-fixed-height">
  <div
    class="wz-container-child-norow-div wz-aside"
    style="background-color: #ccc"
  >
    aside
  </div>
  <div class="wz-container-child-norow-div wz-main">main</div>
</div>

Attribute

wz-container-child-norow-div Attribute