victory-shared-events 30.6.1 → 31.2.0

package/README.md

@@ -20,7 +20,7 @@ The `VictorySharedEvents` wrapper coordinates events between its child component
 
 The `events` prop takes an array of event objects. Event objects are composed of a `target`, an `eventKey`, a `childName` and `eventHandlers`. Targets may be any valid style namespace for a given component, so "data" and "labels" are valid targets for this components like `VictoryBar`. `eventKey` may be given as a single value, or as an array of values to specify individual targets. If `eventKey` is not specified, the given `eventHandlers` will be attached to all elements of the specified `target` type. The `childName` property may be given as a string or an array of strings to target multiple children. The `eventHandlers` object should be given as an object whose keys are standard event names (i.e. `onClick`) and whose values are event callbacks. The return value of an event handler is used to modify elements. The return value should be given as an object or an array of objects with optional `target`, `childName` and `eventKey` keys for specifying the element(s) to be modified, and a `mutation` key whose value is a function. The `target` and `eventKey` keys will default to those corresponding to the element the event handler was attached to. The `mutation` function will be called with the calculated props for each element that should be modified (i.e. a bar label), and the object returned from the mutation function will override the props of that element via object assignment.
 
-*examples:*
+_examples:_
 
 ```playground
 <svg viewBox="0 0 450 350">
@@ -92,23 +92,19 @@ The `eventKey` prop is used to assign eventKeys to data. This prop operates iden
 Occasionally is it necessary to trigger events in Victory's event system from some external element such as a button or a form field. Use the `externalEventMutation` prop to specify a set of mutations to apply to a given chart. The `externalEventMutations` should be given in the following form:
 
 ```jsx
-externalEventMutations: PropTypes.arrayOf(PropTypes.shape({
-  callback: PropTypes.function,
-  childName: PropTypes.oneOfType([
-    PropTypes.string,
-    PropTypes.array
-  ]),
-  eventKey: PropTypes.oneOfType([
-    PropTypes.array,
-    CustomPropTypes.allOfType([CustomPropTypes.integer, CustomPropTypes.nonNegative]),
-    PropTypes.string
-  ]),
-  mutation: PropTypes.function,
-  target: PropTypes.oneOfType([
-    PropTypes.string,
-    PropTypes.array
-  ])
-}))
+externalEventMutations: PropTypes.arrayOf(
+  PropTypes.shape({
+    callback: PropTypes.function,
+    childName: PropTypes.oneOfType([PropTypes.string, PropTypes.array]),
+    eventKey: PropTypes.oneOfType([
+      PropTypes.array,
+      CustomPropTypes.allOfType([CustomPropTypes.integer, CustomPropTypes.nonNegative]),
+      PropTypes.string
+    ]),
+    mutation: PropTypes.function,
+    target: PropTypes.oneOfType([PropTypes.string, PropTypes.array])
+  })
+);
 ```
 
 The `target`, `eventKey`, and `childName` (when applicable) must always be specified. The `mutation` function will be called with the current props of the element specified by the `target`, `eventKey` and `childName` provided. The mutation function should return a mutation object for that element. The `callback` prop should be used to clear the `externalEventMutations` prop once the mutation has been applied. Clearing `externalEventMutations` is crucial for charts that animate.
@@ -212,8 +208,8 @@ class App extends React.Component {
 ReactDOM.render(<App/>, mountNode)
 ```
 
-*Note* External mutations are applied to the same state object that is used to control events in Victory, so depending on the order in which they are triggered, external event mutations may override mutations caused by internal Victory events or vice versa.
+_Note_ External mutations are applied to the same state object that is used to control events in Victory, so depending on the order in which they are triggered, external event mutations may override mutations caused by internal Victory events or vice versa.
 
-[VictoryChart]: https://formidable.com/open-source/victory/docs/victory-chart
-[VictoryGroup]: https://formidable.com/open-source/victory/docs/victory-group
-[VictoryStack]: https://formidable.com/open-source/victory/docs/victory-stack
+[victorychart]: https://formidable.com/open-source/victory/docs/victory-chart
+[victorygroup]: https://formidable.com/open-source/victory/docs/victory-group
+[victorystack]: https://formidable.com/open-source/victory/docs/victory-stack