victory-group 30.6.1 → 31.2.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 +30 -34
- package/dist/victory-group.js +1748 -1500
- package/dist/victory-group.min.js +1 -1
- package/es/helper-methods.js +1 -4
- package/es/victory-group.js +13 -14
- package/lib/helper-methods.js +2 -4
- package/lib/victory-group.js +16 -14
- package/package.json +3 -2
- package/src/helper-methods.js +57 -28
- package/src/victory-group.js +44 -29
package/README.md
CHANGED
|
@@ -1,4 +1,3 @@
|
|
|
1
|
-
|
|
2
1
|
# VictoryGroup
|
|
3
2
|
|
|
4
3
|
`victory-group@^30.0.0` exports `VictoryGroup`
|
|
@@ -89,7 +88,7 @@ The `color` prop is an optional prop that defines a single color to be applied t
|
|
|
89
88
|
|
|
90
89
|
The `colorScale` prop is an optional prop that defines a color scale to be applied to the children of `VictoryGroup`. This prop should be given as an array of CSS colors, or as a string corresponding to one of the built in color scales: "grayscale", "qualitative", "heatmap", "warm", "cool", "red", "green", "blue". `VictoryGroup` will assign colors to its children by index, unless they are explicitly specified in styles. Colors will repeat when there are more children than colors in the provided `colorScale`.
|
|
91
90
|
|
|
92
|
-
|
|
91
|
+
_default (provided by default theme):_ See [grayscale theme][] for more detail
|
|
93
92
|
|
|
94
93
|
```playground
|
|
95
94
|
<VictoryGroup
|
|
@@ -108,7 +107,6 @@ The `colorScale` prop is an optional prop that defines a color scale to be appli
|
|
|
108
107
|
</VictoryGroup>
|
|
109
108
|
```
|
|
110
109
|
|
|
111
|
-
|
|
112
110
|
### containerComponent
|
|
113
111
|
|
|
114
112
|
`type: element`
|
|
@@ -170,7 +168,7 @@ domainPadding={{x: [10, -10], y: 5}}
|
|
|
170
168
|
`VictoryGroup` uses the standard `eventKey` prop to specify how event targets are addressed. **This prop is not commonly used.** [Read about the `eventKey` prop in more detail here](https://formidable.com/open-source/victory/docs/common-props#eventkey)
|
|
171
169
|
|
|
172
170
|
```jsx
|
|
173
|
-
eventKey="x"
|
|
171
|
+
eventKey = "x";
|
|
174
172
|
```
|
|
175
173
|
|
|
176
174
|
### events
|
|
@@ -224,6 +222,7 @@ See the [Events Guide][] for more information on defining events.
|
|
|
224
222
|
/>
|
|
225
223
|
</VictoryGroup>
|
|
226
224
|
```
|
|
225
|
+
|
|
227
226
|
### externalEventMutations
|
|
228
227
|
|
|
229
228
|
`type: array[object]`
|
|
@@ -236,7 +235,7 @@ See the [Events Guide][] for more information on defining events.
|
|
|
236
235
|
|
|
237
236
|
`VictoryGroup` uses the standard `groupComponent` prop. [Read about it in detail here](https://formidable.com/open-source/victory/docs/common-props#groupcomponent)
|
|
238
237
|
|
|
239
|
-
|
|
238
|
+
_default:_ `<g/>`
|
|
240
239
|
|
|
241
240
|
```jsx
|
|
242
241
|
groupComponent={<g transform="translate(10, 10)" />}
|
|
@@ -248,7 +247,7 @@ groupComponent={<g transform="translate(10, 10)" />}
|
|
|
248
247
|
|
|
249
248
|
`VictoryGroup` uses the standard `height` prop. [Read about it here](https://formidable.com/open-source/victory/docs/common-props#height)
|
|
250
249
|
|
|
251
|
-
|
|
250
|
+
_default (provided by default theme):_ `height={300}`
|
|
252
251
|
|
|
253
252
|
```jsx
|
|
254
253
|
height={400}
|
|
@@ -276,7 +275,7 @@ labels={["spring", "summer", "fall", "winter"]}`, `labels={(datum) => datum.titl
|
|
|
276
275
|
|
|
277
276
|
The `labelComponent` prop takes a component instance which will be used to render labels for each group. The new element created from the passed `labelComponent` will be supplied with the following props: `x`, `y`, `index`, `datum`, `verticalAnchor`, `textAnchor`, `angle`, `style`, `text`, and `events`. Any of these props may be overridden by passing in props to the supplied component, or modified or ignored within the custom component itself. If `labelComponent` is omitted, a new [VictoryLabel][] will be created with the props described above.
|
|
278
277
|
|
|
279
|
-
|
|
278
|
+
_default:_ `<VictoryLabel/>`
|
|
280
279
|
|
|
281
280
|
```jsx
|
|
282
281
|
labelComponent={<VictoryLabel dy={20}/>}
|
|
@@ -301,7 +300,7 @@ labelComponent={<VictoryLabel dy={20}/>}
|
|
|
301
300
|
The `name` prop is used to reference a component instance when defining shared events.
|
|
302
301
|
|
|
303
302
|
```jsx
|
|
304
|
-
name="series-1"
|
|
303
|
+
name = "series-1";
|
|
305
304
|
```
|
|
306
305
|
|
|
307
306
|
### offset
|
|
@@ -334,14 +333,13 @@ The `offset` prop determines the number of pixels each element in a group should
|
|
|
334
333
|
|
|
335
334
|
[Read about the `origin` prop in detail](https://formidable.com/open-source/victory/docs/common-props#origin)
|
|
336
335
|
|
|
337
|
-
|
|
338
336
|
### padding
|
|
339
337
|
|
|
340
338
|
`type: number || { top: number, bottom: number, left: number, right: number }`
|
|
341
339
|
|
|
342
340
|
`VictoryGroup` uses the standard `padding` prop. [Read about it here](https://formidable.com/open-source/victory/docs/common-props#padding)
|
|
343
341
|
|
|
344
|
-
|
|
342
|
+
_default (provided by default theme):_ `padding={50}`
|
|
345
343
|
|
|
346
344
|
```jsx
|
|
347
345
|
padding={{ top: 20, bottom: 60 }}
|
|
@@ -367,7 +365,7 @@ padding={{ top: 20, bottom: 60 }}
|
|
|
367
365
|
|
|
368
366
|
`VictoryGroup` uses the standard `samples` prop. [Read about it here](https://formidable.com/open-source/victory/docs/common-props#samples)
|
|
369
367
|
|
|
370
|
-
|
|
368
|
+
_default:_ `samples={50}`
|
|
371
369
|
|
|
372
370
|
```jsx
|
|
373
371
|
samples={100}
|
|
@@ -382,7 +380,7 @@ Options for scale include "linear", "time", "log", "sqrt" and the `d3-scale` fun
|
|
|
382
380
|
|
|
383
381
|
**note: `VictoryGroup` controls the `scale` prop of its children.**
|
|
384
382
|
|
|
385
|
-
|
|
383
|
+
_default:_ `scale="linear"`
|
|
386
384
|
|
|
387
385
|
```jsx
|
|
388
386
|
scale={{x: "linear", y: "log"}}
|
|
@@ -402,13 +400,12 @@ scale={{x: "linear", y: "log"}}
|
|
|
402
400
|
|
|
403
401
|
`type: string || integer || array[string] || function`
|
|
404
402
|
|
|
405
|
-
|
|
406
403
|
`VictoryGroup` uses the standard `sortKey` prop. [Read about it here](https://formidable.com/open-source/victory/docs/common-props#sortkey)
|
|
407
404
|
|
|
408
405
|
See the [Data Accessors Guide][] for more detail on formatting and processing data.
|
|
409
406
|
|
|
410
407
|
```jsx
|
|
411
|
-
sortKey="x"
|
|
408
|
+
sortKey = "x";
|
|
412
409
|
```
|
|
413
410
|
|
|
414
411
|
### sortOrder
|
|
@@ -417,7 +414,7 @@ sortKey="x"
|
|
|
417
414
|
|
|
418
415
|
The `sortOrder` prop specifies whether sorted data should be returned in ascending or descending order.
|
|
419
416
|
|
|
420
|
-
|
|
417
|
+
_default:_ `sortOrder="ascending"`
|
|
421
418
|
|
|
422
419
|
### standalone
|
|
423
420
|
|
|
@@ -427,8 +424,7 @@ The `sortOrder` prop specifies whether sorted data should be returned in ascendi
|
|
|
427
424
|
|
|
428
425
|
**note:** When `VictoryGroup` is nested within a component like `VictoryChart`, this prop will be set to `false`
|
|
429
426
|
|
|
430
|
-
|
|
431
|
-
|
|
427
|
+
_default:_ `standalone={true}`
|
|
432
428
|
|
|
433
429
|
### style
|
|
434
430
|
|
|
@@ -438,7 +434,7 @@ The `sortOrder` prop specifies whether sorted data should be returned in ascendi
|
|
|
438
434
|
|
|
439
435
|
Styles on children of `VictoryGroup` will override styles set on the `VictoryGroup` component.
|
|
440
436
|
|
|
441
|
-
|
|
437
|
+
_default (provided by default theme):_ See [grayscale theme][] for more detail
|
|
442
438
|
|
|
443
439
|
```playground
|
|
444
440
|
<VictoryGroup
|
|
@@ -470,7 +466,7 @@ Styles on children of `VictoryGroup` will override styles set on the `VictoryGro
|
|
|
470
466
|
|
|
471
467
|
See the [Themes Guide][] for information about creating custom themes.
|
|
472
468
|
|
|
473
|
-
|
|
469
|
+
_default:_ `theme={VictoryTheme.grayscale}`
|
|
474
470
|
|
|
475
471
|
```jsx
|
|
476
472
|
theme={VictoryTheme.material}
|
|
@@ -482,7 +478,7 @@ theme={VictoryTheme.material}
|
|
|
482
478
|
|
|
483
479
|
`VictoryGroup` uses the standard `width` prop. [Read about it here](https://formidable.com/open-source/victory/docs/common-props#width)
|
|
484
480
|
|
|
485
|
-
|
|
481
|
+
_default (provided by default theme):_ `width={450}`
|
|
486
482
|
|
|
487
483
|
```jsx
|
|
488
484
|
width={400}
|
|
@@ -497,7 +493,7 @@ width={400}
|
|
|
497
493
|
See the [Data Accessors Guide][] for more detail on formatting and processing data.
|
|
498
494
|
|
|
499
495
|
```jsx
|
|
500
|
-
x="employee.name"
|
|
496
|
+
x = "employee.name";
|
|
501
497
|
```
|
|
502
498
|
|
|
503
499
|
### y
|
|
@@ -524,19 +520,19 @@ See the [Data Accessors Guide][] for more detail on formatting and processing da
|
|
|
524
520
|
y0={() => 10}
|
|
525
521
|
```
|
|
526
522
|
|
|
527
|
-
[
|
|
528
|
-
[
|
|
529
|
-
[
|
|
530
|
-
[
|
|
523
|
+
[animations guide]: https://formidable.com/open-source/victory/guides/animations
|
|
524
|
+
[data accessors guide]: https://formidable.com/open-source/victory/guides/data-accessors
|
|
525
|
+
[events guide]: https://formidable.com/open-source/victory/guides/events
|
|
526
|
+
[themes guide]: https://formidable.com/open-source/victory/guides/themes
|
|
531
527
|
[grayscale theme]: https://github.com/FormidableLabs/victory-core/blob/master/src/victory-theme/grayscale.js
|
|
532
|
-
[
|
|
533
|
-
[
|
|
534
|
-
[
|
|
535
|
-
[
|
|
536
|
-
[
|
|
537
|
-
[
|
|
538
|
-
[
|
|
539
|
-
[
|
|
540
|
-
[
|
|
528
|
+
[victoryarea]: https://formidable.com/open-source/victory/docs/victory-area
|
|
529
|
+
[victorybar]: https://formidable.com/open-source/victory/docs/victory-bar
|
|
530
|
+
[victorycandlestick]: https://formidable.com/open-source/victory/docs/victory-candlestick
|
|
531
|
+
[victoryerrorbar]: https://formidable.com/open-source/victory/docs/victory-errorbar
|
|
532
|
+
[victoryline]: https://formidable.com/open-source/victory/docs/victory-line
|
|
533
|
+
[victoryscatter]: https://formidable.com/open-source/victory/docs/victory-scatter
|
|
534
|
+
[victorystack]: https://formidable.com/open-source/victory/docs/victory-stack
|
|
535
|
+
[victoryvoronoi]: https://formidable.com/open-source/victory/docs/victory-voronoi
|
|
536
|
+
[victorylabel]: https://formidable.com/open-source/victory/docs/victory-label
|
|
541
537
|
[x]: https://formidable.com/open-source/victory/docs/common-props#x
|
|
542
538
|
[y]: https://formidable.com/open-source/victory/docs/common-props#y
|