VUE 实现 Studio 管理后台（十）：OptionBox，一个综合属性输入界面，可以级联重置

idlewater 的个人博客 / 35 / 0 / 创建于 4年前 / 更新于 4年前

为了便于阅读代码，已经把测试数据分离出来，放在了mock目录下：

阅读代码的话，稍微留意一下就好。本次介绍RXEditor界面最重要的部分，属性输入组件，该组件可以显示是否有数据被修改，还可以批量重置到缺省值，效果如下：

这个界面是动态构建的，根据Json数据，动态构建输入界面。我之前做过一个PHP larvel+Vuetify的框架，也是用这个原理，PHP段代码构造JSON数据，VUE代码根据数据动态构造输入界面。我用那个框架做了好几个网站和公司自己的订单管理系统，但是代码需要优化的地方不少，我自己用起来很方便，离开源发布还有些距离，框架的名字叫Vular，GIthub地址：https://github.com/vularsoft/vular，感兴趣的可以看看，等完成RXEditor，就继续这个框架，给自己加的工作太多了，时间不够。
本次实现的要比这个框架简单好多，原理相同。要理解代码，需要明白页面元素的结构及命名：

整个输入组件叫OptionBox，这个控件可以输入各种属性。OptionBox下包含若干OptionGroup，每个OptionGroup就是一个手风琴折叠的子项，OptionBox是一个手风琴式折叠控件（该控件的实现方式，请参看以前的文章），OptionGroup下包含多个RxInputRow，每个RxInputRow包含一个输入控件跟一个标签，OptionBox根据Json数据动态构建，Json数据结构如下：

[
  {
    label:'Row选项',
    rows:[
      {
        label:'Gutters',
        value:'no-gutters',
        defaultValue:'no-gutters',
        inputName:'RxSwitch',
        props:{
          onValue:'no-gutters',
          offValue:'',
        },
      },
      {
        label:'测试',
        value:'off',
        defaultValue:'off',
        inputName:'RxSwitch',
        props:{
          onValue:'on',
          offValue:'off',
        },
      },
    ],
  },

  {
    label:'文本选项',
    rows:[
      {
        label:'测试3',
        value:'no-gutters',
        defaultValue:'no-gutters',
        inputName:'RxSwitch',
        props:{
          onValue:'no-gutters',
          offValue:'',
        },
      },
      {
        label:'测试4',
        value:'off',
        defaultValue:'off',
        inputName:'RxSwitch',
        props:{
          onValue:'on',
          offValue:'off',
        },
      },
    ],
  },
  {
    label:'Bootstrap工具',
  },
]

到目前为止，我们只实现了一个输入控件:RxSwitch，所以测试数据中只有这一个控件，后面会逐步添加下拉列表等其它控件，到时也会更新测试数据。
代码目录结构：

Inputs目录下的RXSwitch.vue是以前实现的，RXSelect.vue只是个备忘文件，下次实现。accordion目录下是以前实现的手风琴式折叠组件，这次要用到。剩下的文件就是本次要实现的。
老习惯，先看OptionBox的调用代码，看看如何使用这个组件：

<OptionBox v-model="options"></OptionBox>

非常简单，用v-model的方式传入一个json数据。它的实现代码：

<template>
  <SimpleAccordion>
    <OptionGroup v-for="(optionGroup, i) in inputValue" :key="i" v-model="inputValue[i]">
    </OptionGroup>
  </SimpleAccordion>
</template>

<script> import SimpleAccordion from '../accordion/SimpleAccordion.vue' import OptionGroup from './OptionGroup.vue' export default {
  name: 'OptionBox',
  components:{
    SimpleAccordion,
    OptionGroup
  },
  props:{
    value:{ default:[] }, 
  },
  computed:{
    inputValue: {
      get:function() { return this.value;
      },
      set:function(val) { this.$emit('input', val);
      },
    },
  },
  methods: {
  },
} </script>

使用一个SimpleAccordion（手风琴式折叠组件）实现，内部循环调用OptionGroup。给OptionGroup传入的v-model，是一个row数据列表。它的实现代码：

<template>
  <CollapsibleItem class="option-item" @itemClick = "itemClick">
    <template #heading>
      {{inputValue.label}} 
      <div v-if="changed" class="reset-button" @click="resetAll">{{$t('widgets.reset')}}</div>
    </template>
    <template #body>
      <RxInputRow 
        v-for="(row, i) in inputValue.rows" 
        :key="i" 
        :label = "row.label"
        :inputName = "row.inputName"
        :inputProps = "row.props"
        :defaultValue = "row.defaultValue"
        v-model = "row.value"
      >
      </RxInputRow>
    </template>
  </CollapsibleItem>
</template>

<script>
import CollapsibleItem from '../accordion/CollapsibleItem.vue'
import RxInputRow from '../inputs/RxInputRow.vue'

export default {
  name: 'OptionGroup',
  components:{
    CollapsibleItem,
    RxInputRow
  },
  props:{
    value:{ default:{} }, 
  },
  computed:{
    inputValue: {
      get:function() {
        return this.value;
      },
      set:function(val) {
        this.$emit('input', val);
      },
    },

    changed(){
      for(var i in this.inputValue.rows){
        let row = this.inputValue.rows[i]
        if(row.value !== row.defaultValue){
          return true
        }
      }
      return false
    }
  },
  methods: {
    itemClick(item){
      this.$emit('itemClick', item)
    },

    resetAll(event){
      for(var i in this.inputValue.rows){
        this.inputValue.rows[i].value = this.inputValue.rows[i].defaultValue
      }
      event.stopPropagation()
    }
  },
}
</script>

<style>
.option-item.collapsible-item .item-heading{
  display: flex;
  flex-flow: row;
  justify-content: space-between;
}

.reset-button{
  margin-right:20px;
  color: #bbb;
}
</style>

它使用CollapsibleItem 实现，所以需要把CollapsibleItem 的事件通过$emit方法转发给父组件，要不然手风琴折叠就不灵了。

根据计算属性changed，确定是否显示重置按钮，如果有数据跟缺省值不一样，chenged就是true，反之为false。
重置按钮的处理事件resetAll，它把所有的值都设置成默认值。不得不感叹VUE双向数据绑定的强大，RXEditor第一个版本没有使用VUE，用的是原生JS，类似功能实现起来非常复杂。
样式随状态改变，具体参看CSS就好。
该组件循环调用RxInputRow ，注意他的传入参数。
RxInputRow 代码：

<template>
  <div class="rx-input-row" :class = "changed ? 'changed' :''">
    <div class="label">{{label}}</div>
    <component :is = "inputName" v-bind = "inputProps" v-model = "inputValue"
    ></component>
  </div>
</template>

<script> import RxSwitch from './RxSwitch.vue' export default {
  name: 'RxInputRow',
  props:{
    label:{ default:'' }, 
    defaultValue:{ default:'' }, 
    value:{ default:'' }, 
    inputProps:{ default:'' },
    inputName:{defalut:'input'},
  },
  components:{
    RxSwitch,
  },
  data () { return {
    }
  },
  computed:{
    changed(){ return this.inputValue !== this.defaultValue
    },

    inputValue: {
      get:function() { return this.value;
      },
      set:function(val) { this.$emit('input', val);
      },
    },
  },
  methods: {
  },
} 
</script>

<style>
  .rx-input-row{
    display: flex;
    flex-flow: row;
    align-items: center;
  }

  .rx-input-row .label{
    display: flex;
    height: 30px;
    align-items: center;
    padding-left: 6px;
    color:#c2c2c2;
    font-size: 12px;
    width: 100px;
  }
  .rx-input-row.changed .label{
    color:#7c9161;
  }
</style>

如果输入值有变化，也是通过changed计算属性通知界面，CSS用绿色字体显示标签。
通过VUE的component 动态绑定组件，可以省很多代码量，一定要记住的是，它使用的组件要注册。
这段代码：

<component 
  :is = "inputName" 
  v-bind = "inputProps" 
  v-model = "inputValue"
></component>

就相当于

<RxSwitch 
  v-if = "inputName === 'RxSwitch'" 
  onValue= "inputProps.onValue" 
  offValue= "inputProps.offValue" 
  v-model = "inputValue"
></RxSwitch>
<RxSelect 
  v-if = "inputName === 'RxSelect'" 
  list= "inputProps.list" 
  v-model = "inputValue"
></RxSelect>
......

这样的方式，需要大量的if判断，代码不好看。我在Vular框架里，因为要通过PHP代码控制每一个Vuetify细节，component 动态组件，也有些不方便，我直接做了一个自定义组件，通过重写render方法实现，太深入底层了。在这里，能用这样的方式完美实现，已经很幸福了。
今天作文就写到这里，感谢耐心阅读，详细代码，请参考Github：https://github.com/vularsoft/studio-ui
若有有问题，请留言交流。