• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# divider
2
3
4分隔器组件,分隔不同内容块/内容元素。可用于列表或界面布局。
5
6> **说明:**
7>
8> 从API Version 8 开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
9
10## 属性
11
12除支持[通用属性](js-service-widget-common-attributes.md)外,还支持如下属性:
13
14| 名称 | 类型 | 默认值 | 必填 | 描述 |
15| -------- | -------- | -------- | -------- | -------- |
16| vertical | boolean | false | 否 | 使用水平分割线还是垂直分割线,默认水平分割线。 |
17
18
19## 样式
20
21仅支持如下样式:
22
23| 名称 | 类型 | 默认值 | 必填 | 描述 |
24| -------- | -------- | -------- | -------- | -------- |
25| margin | <length> | 0 | 否 | 使用简写属性设置所有的外边距属性,该属性可以有1到4个值。 |
26| margin-[left\|top\|right\|bottom] | <length> | 0 | 否 | 使用简写属性设置左、上、右、下外边距属性,类型length,单位px,默认值0。 |
27| color | <color> | - | 否 | 设置分割线颜色。 |
28| stroke-width | <length> | 1 | 否 | 设置分割线宽度。 |
29| display | string | flex | 否 | 确定分割线所产生的框的类型。值flex/none,默认值flex。 |
30| visibility | string | visible | 否 | 是否显示分割线,不可见的框会占用布局。visible代表显示元素,hidden代表不显示元素。 |
31| line-cap | string | butt | 否 | 设置分割线条的端点样式,默认为butt,可选值为:<br/>-&nbsp;"butt":分割线两端为平行线。<br/>-&nbsp;"round":分割线两端额外添加半圆。<br/>-&nbsp;"square":分割线两端额外添加半方形。<br/>"round"和"square"会额外增加一个线宽的分割线长度。 |
32| flex | number | - | 否 | 规定了分割线如何适应父组件中的可用空间。作为一个简写属性,用来设置组件的flex-grow。<br/>仅父容器为&lt;div&gt;、&lt;list-item&gt;、&lt;tabs&gt;时生效。 |
33| flex-grow | number | 0 | 否 | 设置分割线的伸展因子,指定父组件容器主轴方向上剩余空间(容器本身大小减去所有flex项加起来的大小)的分配系数。0为不伸展。<br/>仅父容器为&lt;div&gt;、&lt;list-item&gt;、&lt;tabs&gt;时生效。 |
34| flex-shrink | number | 1 | 否 | 设置分割线的收缩因子,flex元素仅在默认宽度之和大于容器的时候才会发生收缩,0为不收缩。<br/>仅父容器为&lt;div&gt;、&lt;list-item&gt;、&lt;tabs&gt;时生效。 |
35| flex-basis | &lt;length&gt; | - | 否 | 设置分割线在主轴方向上的初始大小。<br/>仅父容器为&lt;div&gt;、&lt;list-item&gt;、&lt;tabs&gt;时生效。 |
36
37
38## 事件
39
40不支持。
41
42
43## 示例
44
45
46```html
47<!-- xxx.hml -->
48<div class="container">
49  <div class="content">
50    <divider class="divider" vertical="false"></divider>
51  </div>
52</div>
53```
54
55
56```css
57/* xxx.css */
58.container {
59  margin: 20px;
60  flex-direction:column;
61  width:100%;
62  height:100%;
63  align-items:center;
64}
65.content{
66  width:80%;
67  height:40%;
68  margin-top:100px;
69  border:1px solid #000000;
70  align-items: center;
71  justify-content: center;
72  flex-direction:column;
73}
74.divider {
75  margin: 10px;
76  color: #ff0000ff;
77  stroke-width: 3px;
78  line-cap: round;
79}
80```
81**4*4卡片**
82
83![卡片divider](figures/divider.png)
84
85