@fibrae/semi-ui-svelte 0.9.1 → 0.10.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +8 -4
- package/README.zh-CN.md +8 -4
- package/dist/components/anchor/interface.d.ts +14 -0
- package/dist/components/audio-player/interface.d.ts +5 -0
- package/dist/components/auto-complete/interface.d.ts +29 -0
- package/dist/components/avatar/interface.d.ts +24 -0
- package/dist/components/backtop/interface.d.ts +2 -0
- package/dist/components/badge/interface.d.ts +7 -0
- package/dist/components/banner/interface.d.ts +7 -0
- package/dist/components/breadcrumb/interface.d.ts +10 -0
- package/dist/components/button/interface.d.ts +18 -0
- package/dist/components/calendar/interface.d.ts +16 -0
- package/dist/components/card/interface.d.ts +18 -0
- package/dist/components/carousel/interface.d.ts +16 -0
- package/dist/components/cascader/interface.d.ts +57 -0
- package/dist/components/checkbox/interface.d.ts +19 -0
- package/dist/components/code-highlight/interface.d.ts +3 -0
- package/dist/components/collapse/interface.d.ts +16 -0
- package/dist/components/collapsible/interface.d.ts +10 -0
- package/dist/components/color-picker/interface.d.ts +10 -0
- package/dist/components/config-provider/interface.d.ts +7 -0
- package/dist/components/cropper/interface.d.ts +11 -0
- package/dist/components/date-picker/interface.d.ts +47 -0
- package/dist/components/descriptions/interface.d.ts +6 -0
- package/dist/components/divider/interface.d.ts +4 -0
- package/dist/components/dropdown/interface.d.ts +8 -0
- package/dist/components/empty/interface.d.ts +7 -0
- package/dist/components/feedback/interface.d.ts +16 -0
- package/dist/components/float-button/interface.d.ts +14 -0
- package/dist/components/form/interface.d.ts +47 -0
- package/dist/components/grid/interface.d.ts +13 -0
- package/dist/components/highlight/interface.d.ts +7 -0
- package/dist/components/hot-keys/interface.d.ts +3 -0
- package/dist/components/image/interface.d.ts +59 -0
- package/dist/components/input/interface.d.ts +67 -0
- package/dist/components/input-number/interface.d.ts +24 -0
- package/dist/components/json-viewer/interface.d.ts +7 -0
- package/dist/components/layout/interface.d.ts +3 -0
- package/dist/components/list/interface.d.ts +18 -0
- package/dist/components/locale/interface.d.ts +4 -0
- package/dist/components/lottie/interface.d.ts +2 -0
- package/dist/components/markdown-render/interface.d.ts +5 -0
- package/dist/components/modal/interface.d.ts +29 -0
- package/dist/components/navigation/interface.d.ts +47 -0
- package/dist/components/overflow-list/interface.d.ts +11 -0
- package/dist/components/pagination/interface.d.ts +12 -0
- package/dist/components/pincode/interface.d.ts +8 -0
- package/dist/components/popconfirm/interface.d.ts +12 -0
- package/dist/components/popover/interface.d.ts +30 -0
- package/dist/components/progress/interface.d.ts +13 -0
- package/dist/components/radio/interface.d.ts +22 -0
- package/dist/components/rating/interface.d.ts +12 -0
- package/dist/components/resizable/interface.d.ts +30 -0
- package/dist/components/scroll-list/interface.d.ts +6 -0
- package/dist/components/select/interface.d.ts +63 -0
- package/dist/components/side-sheet/interface.d.ts +19 -0
- package/dist/components/skeleton/interface.d.ts +7 -0
- package/dist/components/slider/interface.d.ts +23 -0
- package/dist/components/space/interface.d.ts +4 -0
- package/dist/components/spin/interface.d.ts +7 -0
- package/dist/components/steps/interface.d.ts +9 -0
- package/dist/components/switch/interface.d.ts +7 -0
- package/dist/components/table/interface.d.ts +48 -0
- package/dist/components/tabs/interface.d.ts +29 -0
- package/dist/components/tag/interface.d.ts +22 -0
- package/dist/components/tag-input/interface.d.ts +29 -0
- package/dist/components/time-picker/interface.d.ts +31 -0
- package/dist/components/timeline/interface.d.ts +5 -0
- package/dist/components/tooltip/interface.d.ts +20 -0
- package/dist/components/transfer/interface.d.ts +18 -0
- package/dist/components/tree/interface.d.ts +45 -0
- package/dist/components/tree-select/interface.d.ts +55 -0
- package/dist/components/typography/interface.d.ts +33 -0
- package/dist/components/upload/interface.d.ts +64 -0
- package/dist/components/user-guide/interface.d.ts +15 -0
- package/dist/components/video-player/interface.d.ts +22 -0
- package/docs/advanced/dark-mode.md +288 -0
- package/docs/basic/button.md +605 -0
- package/docs/basic/divider.md +103 -0
- package/docs/basic/float-button.md +246 -0
- package/docs/basic/grid.md +427 -0
- package/docs/basic/layout.md +459 -0
- package/docs/basic/resizable.md +584 -0
- package/docs/basic/space.md +163 -0
- package/docs/basic/tokens.md +425 -0
- package/docs/basic/typography.md +615 -0
- package/docs/changes-from-semi.md +105 -0
- package/docs/ecosystem/tailwind.md +210 -0
- package/docs/experience/accessibility.md +82 -0
- package/docs/experience/content-guidelines.md +819 -0
- package/docs/experience/internationalization.md +7 -0
- package/docs/feedback/banner.md +198 -0
- package/docs/feedback/feedback.md +294 -0
- package/docs/feedback/notification.md +401 -0
- package/docs/feedback/popconfirm.md +243 -0
- package/docs/feedback/progress.md +389 -0
- package/docs/feedback/skeleton.md +388 -0
- package/docs/feedback/spin.md +172 -0
- package/docs/feedback/toast.md +393 -0
- package/docs/input/auto-complete.md +399 -0
- package/docs/input/cascader.md +1558 -0
- package/docs/input/checkbox.md +408 -0
- package/docs/input/color-picker.md +175 -0
- package/docs/input/date-picker.md +942 -0
- package/docs/input/form.md +2550 -0
- package/docs/input/input-number.md +451 -0
- package/docs/input/input.md +640 -0
- package/docs/input/pincode.md +191 -0
- package/docs/input/radio.md +337 -0
- package/docs/input/rating.md +214 -0
- package/docs/input/select.md +1230 -0
- package/docs/input/slider.md +347 -0
- package/docs/input/switch.md +206 -0
- package/docs/input/tag-input.md +465 -0
- package/docs/input/time-picker.md +358 -0
- package/docs/input/transfer.md +1061 -0
- package/docs/input/tree-select.md +1300 -0
- package/docs/input/upload.md +1811 -0
- package/docs/llms.txt +147 -0
- package/docs/navigation/anchor.md +377 -0
- package/docs/navigation/backtop.md +100 -0
- package/docs/navigation/breadcrumb.md +284 -0
- package/docs/navigation/navigation.md +851 -0
- package/docs/navigation/pagination.md +217 -0
- package/docs/navigation/steps.md +315 -0
- package/docs/navigation/tabs.md +754 -0
- package/docs/navigation/tree.md +1956 -0
- package/docs/other/config-provider.md +599 -0
- package/docs/other/locale.md +353 -0
- package/docs/plus/audio-player.md +155 -0
- package/docs/plus/code-highlight.md +150 -0
- package/docs/plus/drag-move.md +214 -0
- package/docs/plus/hot-keys.md +174 -0
- package/docs/plus/json-viewer.md +392 -0
- package/docs/plus/lottie.md +176 -0
- package/docs/plus/markdown-render.md +240 -0
- package/docs/plus/video-player.md +325 -0
- package/docs/show/avatar.md +475 -0
- package/docs/show/badge.md +276 -0
- package/docs/show/calendar.md +352 -0
- package/docs/show/card.md +485 -0
- package/docs/show/carousel.md +592 -0
- package/docs/show/collapse.md +289 -0
- package/docs/show/collapsible.md +216 -0
- package/docs/show/cropper.md +285 -0
- package/docs/show/descriptions.md +325 -0
- package/docs/show/dropdown.md +466 -0
- package/docs/show/empty.md +225 -0
- package/docs/show/highlight.md +144 -0
- package/docs/show/image.md +433 -0
- package/docs/show/list.md +927 -0
- package/docs/show/modal.md +517 -0
- package/docs/show/overflow-list.md +272 -0
- package/docs/show/popover.md +534 -0
- package/docs/show/scroll-list.md +156 -0
- package/docs/show/side-sheet.md +274 -0
- package/docs/show/table.md +5437 -0
- package/docs/show/tag.md +428 -0
- package/docs/show/timeline.md +277 -0
- package/docs/show/tooltip.md +442 -0
- package/docs/show/user-guide.md +419 -0
- package/docs/start/getting-started.md +234 -0
- package/docs/start/introduction.md +57 -0
- package/docs/start/overview.md +21 -0
- package/package.json +5 -4
|
@@ -0,0 +1,427 @@
|
|
|
1
|
+
# Grid
|
|
2
|
+
|
|
3
|
+
> 24 grid system.
|
|
4
|
+
|
|
5
|
+
Package: `@fibrae/semi-ui-svelte`. Web page: https://semi-design-next.pages.dev/en-US/svelte/basic/grid/
|
|
6
|
+
|
|
7
|
+
## Overview
|
|
8
|
+
|
|
9
|
+
The grid system of layout, we define the external framework of information blocks based on row and column (col) to ensure that each area of the page can be robustly arranged.
|
|
10
|
+
|
|
11
|
+
## Flex layout
|
|
12
|
+
|
|
13
|
+
Our grid system supports the Flex layout, allowing the horizontal alignment of child elements within the parent node - left, center, right, equal width, scattered arrangement. Between child elements and child elements, support top alignment, vertical center alignment, bottom alignment. At the same time, support the use of `order` To define the order of the elements.
|
|
14
|
+
|
|
15
|
+
## Demos
|
|
16
|
+
|
|
17
|
+
### How to import
|
|
18
|
+
|
|
19
|
+
```svelte
|
|
20
|
+
<script lang="ts">
|
|
21
|
+
import { Col, Row } from '@fibrae/semi-ui-svelte';
|
|
22
|
+
</script>
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
### Basic Usage
|
|
26
|
+
|
|
27
|
+
From stacking to horizontal arrangement.
|
|
28
|
+
|
|
29
|
+
Using a single set of Row and Col grid components, you can create a basic grid system. All Col must be placed in the Row.
|
|
30
|
+
|
|
31
|
+
```svelte
|
|
32
|
+
<script lang="ts">
|
|
33
|
+
import { Col, Row } from '@fibrae/semi-ui-svelte';
|
|
34
|
+
</script>
|
|
35
|
+
|
|
36
|
+
<div class="grid">
|
|
37
|
+
<Row>
|
|
38
|
+
<Col span={24}>
|
|
39
|
+
<div class="col-content">col-24</div>
|
|
40
|
+
</Col>
|
|
41
|
+
</Row>
|
|
42
|
+
<br />
|
|
43
|
+
<Row>
|
|
44
|
+
<Col span={12}>
|
|
45
|
+
<div class="col-content">col-12</div>
|
|
46
|
+
</Col>
|
|
47
|
+
<Col span={12}>
|
|
48
|
+
<div class="col-content">col-12</div>
|
|
49
|
+
</Col>
|
|
50
|
+
</Row>
|
|
51
|
+
<br />
|
|
52
|
+
<Row>
|
|
53
|
+
<Col span={8}>
|
|
54
|
+
<div class="col-content">col-8</div>
|
|
55
|
+
</Col>
|
|
56
|
+
<Col span={8}>
|
|
57
|
+
<div class="col-content">col-8</div>
|
|
58
|
+
</Col>
|
|
59
|
+
<Col span={8}>
|
|
60
|
+
<div class="col-content">col-8</div>
|
|
61
|
+
</Col>
|
|
62
|
+
</Row>
|
|
63
|
+
<br />
|
|
64
|
+
<Row>
|
|
65
|
+
<Col span={6}>
|
|
66
|
+
<div class="col-content">col-6</div>
|
|
67
|
+
</Col>
|
|
68
|
+
<Col span={6}>
|
|
69
|
+
<div class="col-content">col-6</div>
|
|
70
|
+
</Col>
|
|
71
|
+
<Col span={6}>
|
|
72
|
+
<div class="col-content">col-6</div>
|
|
73
|
+
</Col>
|
|
74
|
+
<Col span={6}>
|
|
75
|
+
<div class="col-content">col-6</div>
|
|
76
|
+
</Col>
|
|
77
|
+
</Row>
|
|
78
|
+
</div>
|
|
79
|
+
```
|
|
80
|
+
|
|
81
|
+
### Gutter interval
|
|
82
|
+
|
|
83
|
+
The grid often needs to work with the interval. You can use Row's `Gutter` Properties, we recommend using (16 + 8n) px as a grid interval. (n is a natural number)
|
|
84
|
+
|
|
85
|
+
Vertical gutter can be in the form of an array. The first item of the array is horizontal gutter and the second item is vertical gutter.
|
|
86
|
+
|
|
87
|
+
If you want to support responsiveness, you can write {xs: 8, sm: 16, md: 24, lg: 32}.
|
|
88
|
+
|
|
89
|
+
Dark for content area, light for spacing
|
|
90
|
+
|
|
91
|
+
```svelte
|
|
92
|
+
<script lang="ts">
|
|
93
|
+
import { Col, Row } from '@fibrae/semi-ui-svelte';
|
|
94
|
+
</script>
|
|
95
|
+
|
|
96
|
+
<div class="grid grid-gutter">
|
|
97
|
+
<p>horizontal</p>
|
|
98
|
+
<hr />
|
|
99
|
+
<Row gutter={16}>
|
|
100
|
+
<Col span={6}><div class="col-content">col-6</div></Col>
|
|
101
|
+
<Col span={6}><div class="col-content">col-6</div></Col>
|
|
102
|
+
<Col span={6}><div class="col-content">col-6</div></Col>
|
|
103
|
+
<Col span={6}><div class="col-content">col-6</div></Col>
|
|
104
|
+
<Col span={6}><div class="col-content">col-6</div></Col>
|
|
105
|
+
<Col span={6}><div class="col-content">col-6</div></Col>
|
|
106
|
+
<Col span={6}><div class="col-content">col-6</div></Col>
|
|
107
|
+
<Col span={6}><div class="col-content">col-6</div></Col>
|
|
108
|
+
</Row>
|
|
109
|
+
<p>vertical</p>
|
|
110
|
+
<hr />
|
|
111
|
+
<Row gutter={[16, 24]}>
|
|
112
|
+
<Col span={6}><div class="col-content">col-6</div></Col>
|
|
113
|
+
<Col span={6}><div class="col-content">col-6</div></Col>
|
|
114
|
+
<Col span={6}><div class="col-content">col-6</div></Col>
|
|
115
|
+
<Col span={6}><div class="col-content">col-6</div></Col>
|
|
116
|
+
<Col span={6}><div class="col-content">col-6</div></Col>
|
|
117
|
+
<Col span={6}><div class="col-content">col-6</div></Col>
|
|
118
|
+
<Col span={6}><div class="col-content">col-6</div></Col>
|
|
119
|
+
<Col span={6}><div class="col-content">col-6</div></Col>
|
|
120
|
+
</Row>
|
|
121
|
+
</div>
|
|
122
|
+
```
|
|
123
|
+
|
|
124
|
+
### Offset
|
|
125
|
+
|
|
126
|
+
```svelte
|
|
127
|
+
<script lang="ts">
|
|
128
|
+
import { Col, Row } from '@fibrae/semi-ui-svelte';
|
|
129
|
+
</script>
|
|
130
|
+
|
|
131
|
+
<div class="grid">
|
|
132
|
+
<Row>
|
|
133
|
+
<Col span={8}>
|
|
134
|
+
<div class="col-content">col-8</div>
|
|
135
|
+
</Col>
|
|
136
|
+
<Col offset={8} span={8}>
|
|
137
|
+
<div class="col-content">col-8</div>
|
|
138
|
+
</Col>
|
|
139
|
+
</Row>
|
|
140
|
+
<br />
|
|
141
|
+
<Row>
|
|
142
|
+
<Col offset={6} span={6}>
|
|
143
|
+
<div class="col-content">col-6</div>
|
|
144
|
+
</Col>
|
|
145
|
+
<Col offset={6} span={6}>
|
|
146
|
+
<div class="col-content">col-6</div>
|
|
147
|
+
</Col>
|
|
148
|
+
</Row>
|
|
149
|
+
<br />
|
|
150
|
+
<Row>
|
|
151
|
+
<Col offset={6} span={12}>
|
|
152
|
+
<div class="col-content">col-12</div>
|
|
153
|
+
</Col>
|
|
154
|
+
</Row>
|
|
155
|
+
</div>
|
|
156
|
+
```
|
|
157
|
+
|
|
158
|
+
### Use Flex layout
|
|
159
|
+
|
|
160
|
+
Row is always a Flex container. The `justify` values `start`, `center`, `end`, `space-between` and `space-around` define how the child elements are arranged in the parent node.
|
|
161
|
+
|
|
162
|
+
```svelte
|
|
163
|
+
<script lang="ts">
|
|
164
|
+
import { Col, Row } from '@fibrae/semi-ui-svelte';
|
|
165
|
+
</script>
|
|
166
|
+
|
|
167
|
+
<div class="grid">
|
|
168
|
+
<p>sub-element align left</p>
|
|
169
|
+
<Row justify="start">
|
|
170
|
+
<Col span={4}>
|
|
171
|
+
<div class="col-content">col-4</div>
|
|
172
|
+
</Col>
|
|
173
|
+
<Col span={4}>
|
|
174
|
+
<div class="col-content">col-4</div>
|
|
175
|
+
</Col>
|
|
176
|
+
<Col span={4}>
|
|
177
|
+
<div class="col-content">col-4</div>
|
|
178
|
+
</Col>
|
|
179
|
+
<Col span={4}>
|
|
180
|
+
<div class="col-content">col-4</div>
|
|
181
|
+
</Col>
|
|
182
|
+
</Row>
|
|
183
|
+
|
|
184
|
+
<p>sub-element align center</p>
|
|
185
|
+
<Row justify="center">
|
|
186
|
+
<Col span={4}>
|
|
187
|
+
<div class="col-content">col-4</div>
|
|
188
|
+
</Col>
|
|
189
|
+
<Col span={4}>
|
|
190
|
+
<div class="col-content">col-4</div>
|
|
191
|
+
</Col>
|
|
192
|
+
<Col span={4}>
|
|
193
|
+
<div class="col-content">col-4</div>
|
|
194
|
+
</Col>
|
|
195
|
+
<Col span={4}>
|
|
196
|
+
<div class="col-content">col-4</div>
|
|
197
|
+
</Col>
|
|
198
|
+
</Row>
|
|
199
|
+
|
|
200
|
+
<p>sub-element align right</p>
|
|
201
|
+
<Row justify="end">
|
|
202
|
+
<Col span={4}>
|
|
203
|
+
<div class="col-content">col-4</div>
|
|
204
|
+
</Col>
|
|
205
|
+
<Col span={4}>
|
|
206
|
+
<div class="col-content">col-4</div>
|
|
207
|
+
</Col>
|
|
208
|
+
<Col span={4}>
|
|
209
|
+
<div class="col-content">col-4</div>
|
|
210
|
+
</Col>
|
|
211
|
+
<Col span={4}>
|
|
212
|
+
<div class="col-content">col-4</div>
|
|
213
|
+
</Col>
|
|
214
|
+
</Row>
|
|
215
|
+
|
|
216
|
+
<p>sub-element monospaced arrangement</p>
|
|
217
|
+
<Row justify="space-between">
|
|
218
|
+
<Col span={4}>
|
|
219
|
+
<div class="col-content">col-4</div>
|
|
220
|
+
</Col>
|
|
221
|
+
<Col span={4}>
|
|
222
|
+
<div class="col-content">col-4</div>
|
|
223
|
+
</Col>
|
|
224
|
+
<Col span={4}>
|
|
225
|
+
<div class="col-content">col-4</div>
|
|
226
|
+
</Col>
|
|
227
|
+
<Col span={4}>
|
|
228
|
+
<div class="col-content">col-4</div>
|
|
229
|
+
</Col>
|
|
230
|
+
</Row>
|
|
231
|
+
|
|
232
|
+
<p>sub-element align full</p>
|
|
233
|
+
<Row justify="space-around">
|
|
234
|
+
<Col span={4}>
|
|
235
|
+
<div class="col-content">col-4</div>
|
|
236
|
+
</Col>
|
|
237
|
+
<Col span={4}>
|
|
238
|
+
<div class="col-content">col-4</div>
|
|
239
|
+
</Col>
|
|
240
|
+
<Col span={4}>
|
|
241
|
+
<div class="col-content">col-4</div>
|
|
242
|
+
</Col>
|
|
243
|
+
<Col span={4}>
|
|
244
|
+
<div class="col-content">col-4</div>
|
|
245
|
+
</Col>
|
|
246
|
+
</Row>
|
|
247
|
+
</div>
|
|
248
|
+
```
|
|
249
|
+
|
|
250
|
+
### Flex subelements vertically aligned
|
|
251
|
+
|
|
252
|
+
```svelte
|
|
253
|
+
<script lang="ts">
|
|
254
|
+
import { Col, Row } from '@fibrae/semi-ui-svelte';
|
|
255
|
+
</script>
|
|
256
|
+
|
|
257
|
+
<div class="grid grid-flex">
|
|
258
|
+
<p>Align Top</p>
|
|
259
|
+
<Row align="top" justify="center">
|
|
260
|
+
<Col span={4}>
|
|
261
|
+
<div class="col-content">col-4</div>
|
|
262
|
+
</Col>
|
|
263
|
+
<Col span={4}>
|
|
264
|
+
<div class="col-content">col-4</div>
|
|
265
|
+
</Col>
|
|
266
|
+
<Col span={4}>
|
|
267
|
+
<div class="col-content">col-4</div>
|
|
268
|
+
</Col>
|
|
269
|
+
<Col span={4}>
|
|
270
|
+
<div class="col-content">col-4</div>
|
|
271
|
+
</Col>
|
|
272
|
+
</Row>
|
|
273
|
+
|
|
274
|
+
<p>Align Center</p>
|
|
275
|
+
<Row align="middle" justify="space-around">
|
|
276
|
+
<Col span={4}>
|
|
277
|
+
<div class="col-content">col-4</div>
|
|
278
|
+
</Col>
|
|
279
|
+
<Col span={4}>
|
|
280
|
+
<div class="col-content">col-4</div>
|
|
281
|
+
</Col>
|
|
282
|
+
<Col span={4}>
|
|
283
|
+
<div class="col-content">col-4</div>
|
|
284
|
+
</Col>
|
|
285
|
+
<Col span={4}>
|
|
286
|
+
<div class="col-content">col-4</div>
|
|
287
|
+
</Col>
|
|
288
|
+
</Row>
|
|
289
|
+
|
|
290
|
+
<p>Align Bottom</p>
|
|
291
|
+
<Row align="bottom" justify="space-between">
|
|
292
|
+
<Col span={4}>
|
|
293
|
+
<div class="col-content">col-4</div>
|
|
294
|
+
</Col>
|
|
295
|
+
<Col span={4}>
|
|
296
|
+
<div class="col-content">col-4</div>
|
|
297
|
+
</Col>
|
|
298
|
+
<Col span={4}>
|
|
299
|
+
<div class="col-content">col-4</div>
|
|
300
|
+
</Col>
|
|
301
|
+
<Col span={4}>
|
|
302
|
+
<div class="col-content">col-4</div>
|
|
303
|
+
</Col>
|
|
304
|
+
</Row>
|
|
305
|
+
</div>
|
|
306
|
+
```
|
|
307
|
+
|
|
308
|
+
### Flex element sorting
|
|
309
|
+
|
|
310
|
+
Change the sorting of elements through `order` of the Col.
|
|
311
|
+
|
|
312
|
+
```svelte
|
|
313
|
+
<script lang="ts">
|
|
314
|
+
import { Col, Row } from '@fibrae/semi-ui-svelte';
|
|
315
|
+
</script>
|
|
316
|
+
|
|
317
|
+
<div class="grid">
|
|
318
|
+
<Row>
|
|
319
|
+
<Col order={4} span={6}>
|
|
320
|
+
<div class="col-content">col-4</div>
|
|
321
|
+
</Col>
|
|
322
|
+
<Col order={3} span={6}>
|
|
323
|
+
<div class="col-content">col-3</div>
|
|
324
|
+
</Col>
|
|
325
|
+
<Col order={2} span={6}>
|
|
326
|
+
<div class="col-content">col-2</div>
|
|
327
|
+
</Col>
|
|
328
|
+
<Col order={1} span={6}>
|
|
329
|
+
<div class="col-content">col-1</div>
|
|
330
|
+
</Col>
|
|
331
|
+
</Row>
|
|
332
|
+
</div>
|
|
333
|
+
```
|
|
334
|
+
|
|
335
|
+
### Responsive
|
|
336
|
+
|
|
337
|
+
Referring to Bootstrap's responsive design, preset six response sizes:`xs`, `sm`, `md`, `lg`, `Xl`, `xxl`.
|
|
338
|
+
|
|
339
|
+
`xs` is the base layer without a media query and applies at every screen width; `sm` and above override the smaller breakpoints step by step according to the viewport width.
|
|
340
|
+
|
|
341
|
+
Col writes `span`, `offset`, `push`, `pull` and `order` as inline CSS variables (`--semi-col-*`), with a single style rule per breakpoint and no generated classes such as `semi-col-6`; a `span` of `0` hides the Col at that breakpoint.
|
|
342
|
+
|
|
343
|
+
In the object form, `order`, `offset`, `push` and `pull` set to `0` reset the value a smaller breakpoint set, for example `md` set to `{ offset: 0 }`.
|
|
344
|
+
|
|
345
|
+
```svelte
|
|
346
|
+
<script lang="ts">
|
|
347
|
+
import { Col, Row } from '@fibrae/semi-ui-svelte';
|
|
348
|
+
</script>
|
|
349
|
+
|
|
350
|
+
<div class="grid">
|
|
351
|
+
<Row gutter={{ xs: 16, sm: 16, md: 16, lg: 24, xl: 24, xxl: 24 }}>
|
|
352
|
+
<Col lg={8} md={6} sm={4} xl={10} xs={2}>
|
|
353
|
+
<div class="col-content">Col</div>
|
|
354
|
+
</Col>
|
|
355
|
+
<Col lg={8} md={12} sm={16} xl={4} xs={20}>
|
|
356
|
+
<div class="col-content">Col</div>
|
|
357
|
+
</Col>
|
|
358
|
+
<Col lg={8} md={6} sm={4} xl={10} xs={2}>
|
|
359
|
+
<div class="col-content">Col</div>
|
|
360
|
+
</Col>
|
|
361
|
+
</Row>
|
|
362
|
+
<br />
|
|
363
|
+
<Row>
|
|
364
|
+
<Col lg={{ span: 6, offset: 2 }} xs={{ span: 5, offset: 1 }}>
|
|
365
|
+
<div class="col-content">Col</div>
|
|
366
|
+
</Col>
|
|
367
|
+
<Col lg={{ span: 6, offset: 2 }} xs={{ span: 11, offset: 1 }}>
|
|
368
|
+
<div class="col-content">Col</div>
|
|
369
|
+
</Col>
|
|
370
|
+
<Col lg={{ span: 6, offset: 2 }} xs={{ span: 5, offset: 1 }}>
|
|
371
|
+
<div class="col-content">Col</div>
|
|
372
|
+
</Col>
|
|
373
|
+
</Row>
|
|
374
|
+
</div>
|
|
375
|
+
```
|
|
376
|
+
|
|
377
|
+
## API reference
|
|
378
|
+
|
|
379
|
+
### Row
|
|
380
|
+
|
|
381
|
+
**Props**
|
|
382
|
+
|
|
383
|
+
| Property | Description | Type | Default |
|
|
384
|
+
| - | - | - | - |
|
|
385
|
+
| align | Vertical alignment of the children: top, middle or bottom. | `'bottom' \| 'middle' \| 'top'` | - |
|
|
386
|
+
| children | Col components in the row. | `Snippet` | - |
|
|
387
|
+
| gutter | Grid gutter in pixels, a responsive object `{ xs, sm, md, lg, xl, xxl }`, or a `[horizontal, vertical]` pair. | `Gutter \| [Gutter, Gutter]` | `0` |
|
|
388
|
+
| justify | Horizontal arrangement of the children: start, end, center, space-around or space-between. | `'center' \| 'end' \| 'space-around' \| 'space-between' \| 'start'` | - |
|
|
389
|
+
|
|
390
|
+
`class`, `style` and native attributes land on the root `<div>` of Row; the `style` string comes after the gutter variables, so your value wins.
|
|
391
|
+
|
|
392
|
+
### Col
|
|
393
|
+
|
|
394
|
+
**Props**
|
|
395
|
+
|
|
396
|
+
| Property | Description | Type | Default |
|
|
397
|
+
| - | - | - | - |
|
|
398
|
+
| children | Content of the column. | `Snippet` | - |
|
|
399
|
+
| lg | Responsive grid for screens ≥992px, as a column count or an object. | `number \| ColSize` | - |
|
|
400
|
+
| md | Responsive grid for screens ≥768px, as a column count or an object. | `number \| ColSize` | - |
|
|
401
|
+
| offset | Number of columns to offset from the start side. No column can sit inside the offset. | `number` | - |
|
|
402
|
+
| order | Column order. | `number` | - |
|
|
403
|
+
| pull | Number of columns to move toward the start side. | `number` | - |
|
|
404
|
+
| push | Number of columns to move toward the end side. | `number` | - |
|
|
405
|
+
| sm | Responsive grid for screens ≥576px, as a column count or an object. | `number \| ColSize` | - |
|
|
406
|
+
| span | Number of columns the cell spans. 0 behaves like display: none. | `number` | - |
|
|
407
|
+
| xl | Responsive grid for screens ≥1200px, as a column count or an object. | `number \| ColSize` | - |
|
|
408
|
+
| xs | Base-layer responsive grid. It applies at every screen width, as a column count or an object. | `number \| ColSize` | - |
|
|
409
|
+
| xxl | Responsive grid for screens ≥1600px, as a column count or an object. | `number \| ColSize` | - |
|
|
410
|
+
|
|
411
|
+
`class`, `style` and native attributes land on the root `<div>` of Col.
|
|
412
|
+
|
|
413
|
+
## Design Tokens
|
|
414
|
+
|
|
415
|
+
The design token table of this component is on the web page: <https://semi-design-next.pages.dev/en-US/svelte/basic/grid/>
|
|
416
|
+
|
|
417
|
+
## Changes from Semi Design
|
|
418
|
+
|
|
419
|
+
From the project release notes (written in Chinese). Your knowledge of Semi Design does not cover these.
|
|
420
|
+
|
|
421
|
+
- 破坏性:Row 一律是 flex 布局,删除 `type` 属性(List 的 `grid` 同样不再接受 `type`),`align`、`justify` 始终生效;类名 `semi-row-flex*` 改为 `semi-row`、`semi-row-justify-*`、`semi-row-align-*`,float 与 clearfix 删除。没设 `span` 的 Col 按内容定宽。
|
|
422
|
+
- 破坏性(样式钩子):Col 的 `span`、`offset`、`push`、`pull`、`order` 改为行内 CSS 变量 `--semi-col-*`,每个断点一组规则,小断点的值向大断点继承;`semi-col-12`、`semi-col-md-6` 等预生成类名删除,手写这些类名不再生效。Grid 的 CSS 由约 74 KB 降到约 8 KB。使用方传给 Col 的 `style` 与生成的变量合并,同名时使用方优先。
|
|
423
|
+
- Form 不再用 Row 包裹 `<form>`;顶部标签的包裹层用 `flex-basis: 100%` 代替 `overflow: hidden`。
|
|
424
|
+
- 破坏性(深路径导入):`semi-ui-react/grid/row` 不再导出 `RowContext`、`RowContextType`。
|
|
425
|
+
- Row 的 `gutter` 改为 CSS 变量 `--semi-row-gutter-{x,y}-{xs..xxl}` 加媒体查询,不再写入 Row、Col 的行内 style;Col 不在 Row 内时 gutter 为 0 正常渲染;Col 断点层的 `0`(如 `md={0}`)只在命中断点及以上隐藏,`order`、`offset`、`push`、`pull` 设为 0 现在生效。
|
|
426
|
+
- 具名导出 `Row`、`Col`,无 default 导出;Vue:`gutter`、`span`、`xs` 等数字与对象 prop 必须用 `:` 绑定。
|
|
427
|
+
- Svelte:具名导出 `Row`、`Col`;`style` 只接受字符串,写在 gutter 变量之后,使用方的值优先。
|