lecen:一个更好的开源可视化系统搭建项目--数据(_data)、类名(class)--全低代码|所见即所得|利用可视化设计器构建你的应用系统-做一个懂你的人

35 阅读10分钟

_data 属性

我们在为组件做数据绑定的时候使用 _data,如 el-table 组件绑定数据的属性就是默认为这个字段,因此我们的一些自定义组件或者其他的数据绑定都统一定为 _data

一般类似于列表或者是通过 v-for 这种形式渲染的组件,都可以为其指定一个数组,然后循环遍历进行渲染

我们通过几个常用组件的示例,来介绍一下关于 _data 属性,也就是数据属性的使用方法

在页面设计器中,只要具有 data 属性的组件,都有两种方式进行数据的指定,一种是通过绑定接口的返回值来填充数据,另一种是手动指定数据

1. 表格组件 lc-table

假设现在要做一个歌单的列表

先拖入一个表格组件,然后给它设置几个列

空列表

有歌曲名称、歌手、时长、热度这四列,目前还是一个空列表,没有歌单的数据,这四列的值分别绑定到 titlesingertimehot 字段上面,关于如何绑定可详见 动态绑定

新建一个请求链接,并在当前页面中添加这个请求链接,该请求链接返回的数据被绑定在 songList 字段上面

填充数据

点击表格属性面板的填充数据选项,列出了当前可以绑定的数据字段

请求链接返回的数据格式如下:

{
  data: [{
    title: '研文真习性',
    singer: '宋伟',
    time: '05:32',
    hot: 190
  }, {
    title: '非是象',
    singer: '蔡军',
    time: '04:26',
    hot: 844
  }, {
    title: '近铁民家装还',
    singer: '易洋',
    time: '04:36',
    hot: 783
  }, {
    title: '界常',
    singer: '范秀兰',
    time: '03:04',
    hot: 704
  }, {
    title: '更白火',
    singer: '董桂英',
    time: '03:59',
    hot: 911
  }, {
    title: '具成',
    singer: '冯敏',
    time: '02:32',
    hot: 428
  }, {
    title: '存道根效长接',
    singer: '余伟',
    time: '03:29',
    hot: 934
  }, {
    title: '会据一光住',
    singer: '贺秀英',
    time: '02:12',
    hot: 668
  }, {
    title: '解保少情打强群',
    singer: '陈敏',
    time: '03:42',
    hot: 549
  }, {
    title: '际口名线所志论',
    singer: '谭娜',
    time: '03:50',
    hot: 635
  }]
}

其中 data 字段的值就会绑定到 songList 上面,我们选中这个数据字段,列表就会自动渲染出来

歌单列表

2. 虚拟列表组件 lc-list

在页面设计器中拖入一个列表组件,然后在列表组件中再放入一个卡片组件

这次我们通过手动指定数据的方式来对列表进行数据绑定,数据格式如下:

[{
  name: "苹果",
  description: "苹果,学名Malus pumila Mill.,别称西洋苹果、柰,属于蔷薇科苹果属的植物 [1-2]。苹果是全球最广泛种植和销售的水果之一,具有悠久的栽培历史和广泛的分布范围。苹果的原始种群主要起源于中亚的天山山脉附近,尤其是现代哈萨克斯坦的阿拉木图地区,提供了所有现代苹果品种的基因库。苹果通过早期的贸易路线,如丝绸之路,从中亚向外扩散到全球各地。"
},{
  name: "香蕉",
  description: "香蕉(Musa acuminata '(AAA)'),英文名(banana)芭蕉科芭蕉属多年生草本植物,植株丛生,有匐匍茎;假茎浓绿有黑色斑点;叶片长圆形,上面为深绿色,无白粉,下面浅绿色;花朵为乳白色或淡紫色;果实呈弯曲的弓状,有棱,果皮为青绿色,成熟后变黄;果肉松软,黄白色,味甜香味浓,无种子。"
},{
  name: "葡萄",
  description: "葡萄(学名:Vitis vinifera L.)是葡萄科葡萄属高大缠绕藤本,幼茎秃净或略被绵毛;叶片为纸质,圆卵形或圆形;花序大而长;萼很小,为黄绿色的杯状;花柱很短,为圆锥形;浆果为卵圆形至卵状长圆形,成熟时为紫黑色或红而带青色。 [7]花期4-5月,果期8-9月。 [1]李时珍在《本草纲目》中说:葡萄,《汉书》作蒲桃,可以造酒,人哺饮之,则陶然而醉,故有是名。"
},{
  name: "西瓜",
  description: "西瓜(学名:Citrullus lanatus (Thunb.) Matsum. et Nakai),为葫芦科西瓜属 [2]一年生蔓生藤本植物 [3],又名寒瓜、水瓜、西瓜皮等 [1]。茎、枝粗壮,被白色或淡黄褐色长柔毛。叶片纸质,轮廓三角状卵形,带白绿色。雌雄同株,雌、雄花均单生于叶腋。果实大型,近于球形或椭圆形,果皮光滑,色泽及纹饰各式。种子多数,卵形,黑色、红色,有时为白色、黄色、淡绿色或有斑纹。花果期夏季。 [3]在中国,西瓜因从西域(中国新疆和中亚一带)地区传入,因而得名西瓜,即来自西方的瓜。"
}]

然后我们将卡片的标题绑定到 name 字段,卡片的内容绑定到 description 字段

绑定属性

这时卡片就会通过列表进行渲染

卡片列表

同样,还有很多可以使用列表的组件,比如下拉框选项、单选按钮选项、多选按钮选项、折叠面板等等

通过将父组件中放入一个列表,然后再在列表中放入需要循环渲染的组件,这样就能够组合出各种各样的列表展示

列表组件中也可以放入多个组件进行组合式的循环渲染

3. 树组件 lc-tree

除了列表形式的组件可以绑定 data 属性字段,树组件也可以绑定 _data 字段

拖入一个树组件放入到页面中,然后我们绑定如下的数据:

[{
  id: 1,
  label: "一级1",
  children: [{
    id: 2,
    label: "二级1-1"
  },{
    id: 3,
    label: "二级1-2"
  }]
},{
  id: 4,
  label: "一级2",
  children: [{
    id: 5,
    label: "二级2-1",
    children: [{
      id: 6,
      label: "三级2-1-1"
    }]
  },{
    id: 7,
    label: "二级2-2"
  }]
}]

这样就渲染出了树结构

树组件

_class 属性

项目中预置了大多数常见的单属性,我们可以通过简写的形式去使用,要想类名生效一定要遵守约定。

举几个例子来说明一下:

  1. 设置display: none;可以通过d-n。
  2. 设置color: red;可以通过c-red。
  3. 设置position: relative;可以通过p-r。
  4. 设置padding-top: 5px;可以通过pt-5。
  5. 设置margin-top: -10px;可以通过mt--10;
  6. 设置cursor: pointer;可以通过c-p;
  7. 设置width: 50%;可以通过w_50。

类名的设定只要遵循以下几个原则:

  1. key中没有短横线,则直接取首字母,key中有短横线,则取短横线分割之后的每个首字母。
  2. value中没有短横线,直接取首字母,value中有短横线,则取短横线分割之后的每个首字母。
  3. 将上面取到的两部分用短横线拼接起来,这样就构成了简写类名。
  4. 如果属性是颜色,那么短横线后面就直接拼接去掉#的颜色值,或者完整英文。
  5. 如果属性是宽高等数值类型,那么默单位为px,短横线后面直接拼接数值即可,如果是负值那么就用两个短横线连接,如果是百分比值那么就用下划线连接。如果是其他单位,那么需要在最后面明确指定。
  6. 对于有冲突的属性,比如min-width和max-width简写都是mw,那么就需要前缀全拼,即minw-50或maxw-50。

上面这些约定是一个基本约定,但是也有一些特殊的属性具有特定的写法,具体内容可以浏览下面的示例部分

类名格式

与将自定义类名绑定给组件,一个类名绑定多个属性对不同,我们这里是使用的单元类名的方式,也就是说你写的每一个类名都对应了一个单独属性对。

代码会根据类名自动生成相应的样式属性,不是穷举法预置的,也就是页面只会生成需要的样式,不会生成多余的样式,重用的样式只会生成一次,能达到复用的目的,这些对于使用者来说是无感的。

使用者只需要按照格式来命名类名即可。

我们秉持缩写的原则,即属性名的首字母缩写,然后再加上对应的值的首字母缩写,把他们用横线连接起来。

举几个例子:示例是表示它们可能的用法,各种用法之间可以自由组合。

  1. 宽度width

宽度有几种指定方式:固定值、百分比值、全局值等。

其中w是width的缩写,vw表示用视口宽度。

  • w-50: 表示宽度为50px,等同于width: 50px;

  • w_50: 表示宽度为50%,等同于width: 50%;,百分比的值使用下划线。

  • vw_50: 表示宽度为视口的50%,等同于width: 50vw;

  • minw-50: 表示最小宽度为50px,等同于min-width: 50px;,由于min和max首字母都是m,并且他们都起到形容修饰的作用,因此对这种直接写全,同理最小高度就是minh。

  1. 外边距margin

外边距也有几种指定方式:固定值、百分比值、全局值等。

其中m是margin的缩写,ml是margin-left的缩写,mx是margin-left和margin-right的缩写,x表示水平方向,同样my表示的是上下外边距。

  • m-10: 表示外边距10px,等同于margin: 10px;

  • ml-10: 表示左外边距为10px,等同于margin-left: 10px;

  • mt--10: 表示上外边距为-10px,等同于margin-top: -10px;

  • mx-10: 表示左右外边距为10px,等同于margin-left: 10px;margin-right: 10px;

  1. 定位position

其中p是positon的缩写,r是属性值relative的缩写。

  • p-r: 表示相对定位,等同于positon: relative;

  • p-a: 表示绝对定位,等同于positon: absolute;

  1. 显示类型display

其中d是display的缩写,b是属性值block的缩写。

  • d-i: 表示行内,等同于display: inline;

  • d-ib: 表示行内块,等同于display: inline-block;

  • d-n: 表示隐藏,等同于display: none;

  • d-f: 表示弹性布局,等同于display: flex;

  1. 鼠标形状cursor

其中c是cursor的缩写。

  • c-p: 表示手形状,等同于cursor: pointer;

  • c-na: 表示不允许操作,等同于cursor: not-allowed;

  1. 颜色color

其中c是color的缩写,不用担心跟鼠标形状cursor会冲突,因为它们的值格式不同。

  • c-red: 表示红色,等同于color: red;,可以直接指定颜色单词。

  • c-ff0000: 表示红色,等同于color: #ff0000;,也可是指定rgb形式的颜色值。

  1. 背景色background-color

其中bgc是background-color的缩写,这里没用bc的原因是因为我们熟悉背景的英文缩写就是bg,因此这里沿用下来,也让人容易理解,而且也是为了避免与border-color相冲突。

  • bgc-123456: 表示背景色为#123456,等同于background-color: #123465;

  1. 字体大小font-size

其中fs是font-size的缩写。

  • fs-18: 表示字体大小为18px,等同于font-size: 18px;

  1. 边框border

其中b是border的缩写,后面的值分为三个,第一个表示边框宽度,第二个表示线的类型,第三个表示线的颜色,颜色可以是英文单词或者十六进制或者rgb等。

  • b-n: 表示不显示边框,等同于border: none;

  • b-1-solid-red: 表示1px的红色实线边框,等同于border: 1px solid red;

  • b-1-solid-ff0000: 表示1px的红色实线边框,等同于border: 1px solid #ff0000;

  1. 对齐方式text-align

其中ta是text-align的缩写。

  • ta-c: 表示居中对齐,等同于text-align: center;

等等等等,其他的类名也都遵守上面的格式。不再一一列举。

【项目体验】

系统管理端地址www.lecen.top/manage

系统用户端地址www.liudaxianer.com/user

系统文档地址www.lnsstyp.com/web