Secure your code as it's written. Use Snyk Code to scan source code in minutes - no build needed - and fix issues immediately.
export var doc = function doc(Meter) {
var DocumentedMeter = describe(Meter).availableAt(getAvailableAtBadge('Meter')).description('A graphical meter.').usage("import { Meter } from 'grommet';\n<meter>"); // We don't include svg due to a collision on the values property
// .intrinsicElement('svg');
DocumentedMeter.propTypes = _extends({}, genericProps, {
background: backgroundPropType.defaultValue({
color: 'light-2',
opacity: 'medium'
}),
max: PropTypes.oneOfType([PropTypes.number, PropTypes.string]).description('The maximum value for the Meter.'),
round: PropTypes.bool.description('Whether to round the line ends').defaultValue(false),
size: PropTypes.oneOfType([PropTypes.oneOf(['xsmall', 'small', 'medium', 'large', 'xlarge', 'full']), PropTypes.string]).description('The size of the Meter.').defaultValue('medium'),
thickness: PropTypes.oneOfType([PropTypes.oneOf(['xsmall', 'small', 'medium', 'large', 'xlarge']), PropTypes.string]).description('The size of the Meter.').defaultValue('medium'),
type: PropTypes.oneOf(['bar', 'circle']).description('The visual type of meter.').defaultValue('bar'),
values: PropTypes.arrayOf(PropTypes.shape({
color: PropTypes.string,
highlight: PropTypes.bool,
label: PropTypes.string.isRequired,
// for accessibility
onClick: PropTypes.func,
onHover: PropTypes.func,
value: PropTypes.number.isRequired
})).description("Array of value objects describing the data.\n 'value' is the actual numeric value.\n 'label' is a text string describing it.\n 'color' indicates the color name to use. If not specified a default one\n will be chosen.\n 'onClick' will be called when the user clicks on it.\n Set 'highlight' to call attention to it.\n 'onHover' will be called with a boolean argument indicating when the\n user hovers onto or away from it.")
});
return DocumentedMeter;
};</meter>
getProps: PropTypes.func,
// Pivot only
aggregate: PropTypes.func,
// Headers only
getHeaderProps: PropTypes.func,
// Footers only
getFooterProps: PropTypes.object,
filterMethod: PropTypes.func,
filterAll: PropTypes.bool,
sortMethod: PropTypes.func,
})).isRequired.description('Array of column descriptors.'),
data: PropTypes.array.description('Array of data objects.').isRequired,
defaultPageSize: PropTypes.number.description('Default page size (default 20).'),
filterable: PropTypes.bool.description('Wheter it should display a filtering row.'),
pageSizeOptions: PropTypes.arrayOf(PropTypes.number.description('Page size')).description('Array of available page size options ([5, 10, 20, 25, 50, 100]).'),
sortable: PropTypes.bool.description('Wheter the table headers will allow sorting of the of the data.'),
};
return DocumentedElement;
};
children callback in order to render anything based on the current item.`,
).isRequired,
open: PropTypes.bool.description(`Initial state of the select component`),
placeholder: PropTypes.oneOfType([
PropTypes.string,
PropTypes.node,
]).description('Placeholder text to use when no value is provided.'),
plain: PropTypes.bool.description(
'Whether this is a plain Select input with no border or padding.',
),
searchPlaceholder: PropTypes.string.description(
'Placeholder text to use in the search box when the search input is empty.',
),
selected: PropTypes.oneOfType([
PropTypes.number,
PropTypes.arrayOf(PropTypes.number),
]).description(
`Index of the currently selected option. When multiple, the set of
options selected. NOTE: This is deprecated in favor of indicating
the selected values via the 'value' property.`,
),
size: PropTypes.oneOfType([
PropTypes.oneOf(['small', 'medium', 'large', 'xlarge']),
PropTypes.string,
]).description('The size of the select.'),
value: PropTypes.oneOfType([
PropTypes.string,
PropTypes.element, // deprecated, use valueLabel
PropTypes.object,
PropTypes.arrayOf(
PropTypes.oneOfType([PropTypes.string, PropTypes.object]),
),
bounds: PropTypes.arrayOf(PropTypes.arrayOf(PropTypes.number)).description('The limits for the values, specified as a two dimensional array.\n If not specified, the bounds will automatically be set to fit\n the provided values.'),
color: PropTypes.oneOfType([PropTypes.string, PropTypes.shape({
color: PropTypes.string,
opacity: PropTypes.oneOfType([PropTypes.oneOf(['weak', 'medium', 'strong']), PropTypes.bool])
})]).description('A color identifier to use for the graphic color.').defaultValue('accent-1'),
onClick: PropTypes.func.description('Called when the user clicks on it.\n This is only available when the type is line or area.'),
onHover: PropTypes.func.description('Called with a boolean argument\n indicating when the user hovers onto or away from it.\n This is only available when the type is line or area.'),
overflow: PropTypes.bool.description('Whether the chart strokes should overflow the component. Set this\n to true for precise positioning when stacking charts or including\n precise axes. Set this to false to have the graphical elements\n align with the component boundaries.').defaultValue(false),
round: PropTypes.bool.description('Whether to round the line ends.'),
size: PropTypes.oneOfType([PropTypes.oneOf(['xxsmall', 'xsmall', 'small', 'medium', 'large', 'xlarge', 'full']), PropTypes.shape({
height: PropTypes.oneOf(['xxsmall', 'xsmall', 'small', 'medium', 'large', 'xlarge', 'full']),
width: PropTypes.oneOf(['xxsmall', 'xsmall', 'small', 'medium', 'large', 'xlarge', 'full'])
})]).description('The size of the Chart.').defaultValue({ width: 'medium', height: 'small' }),
thickness: PropTypes.oneOf(['hair', 'xsmall', 'small', 'medium', 'large', 'xlarge', 'none']).description('The width of the stroke.').defaultValue('medium'),
type: PropTypes.oneOf(['bar', 'line', 'area']).description('The visual type of meter.').defaultValue('bar'),
values: PropTypes.arrayOf(PropTypes.oneOfType([PropTypes.number, PropTypes.arrayOf(PropTypes.number), PropTypes.shape({
label: PropTypes.string, // for accessibility of bars
onClick: PropTypes.func,
onHover: PropTypes.func,
value: PropTypes.oneOfType([PropTypes.number.isRequired, PropTypes.arrayOf(PropTypes.number).isRequired]).isRequired
})])).description('Array of value objects describing the data.\n \'value\' is a tuple indicating the coordinate of the value or a triple\n indicating the x coordinate and a range of two y coordinates.\n \'label\' is a text string describing it.\n \'onHover\' and \'onClick\' only work when type=\'bar\'.').isRequired
};
return DocumentedChart;
});
export var doc = function doc(Grid) {
var DocumentedGrid = describe(Grid).availableAt(getAvailableAtBadge('Grid')).description("A grid system for laying out content. To use, define the\nrows and columns, create area names for adjacent cells, and then\nplace Box components inside those areas using the gridArea property.\nSee https://css-tricks.com/snippets/css/complete-guide-grid/.\nThe availability of Grid can be tested via `Grid.available`. Use this\nto create fallback rendering for older browsers, like ie11.").usage("import { Grid } from 'grommet';\n").intrinsicElement('div');
DocumentedGrid.propTypes = _extends({}, genericProps, {
align: PropTypes.oneOf(['start', 'center', 'end', 'stretch']).description("How to align the individual items inside the grid when there is extra\nspace in the column axis.").defaultValue('stretch'),
alignContent: PropTypes.oneOf(['start', 'center', 'end', 'between', 'around', 'stretch']).description('How to align the contents along the column axis.'),
areas: PropTypes.oneOfType([PropTypes.arrayOf(PropTypes.shape({
name: PropTypes.string,
start: PropTypes.arrayOf(PropTypes.number),
end: PropTypes.arrayOf(PropTypes.number)
})), PropTypes.arrayOf(PropTypes.arrayOf(PropTypes.string))]).description("Grid areas.\n Either area names and column,row coordinates.\n Or, an array of string arrays that specify named grid areas."),
columns: PropTypes.oneOfType([PropTypes.arrayOf(PropTypes.oneOfType([PropTypes.arrayOf(PropTypes.oneOfType([PropTypes.oneOf(sizes), PropTypes.string])), PropTypes.oneOf(sizes), PropTypes.string])), PropTypes.oneOf(fixedSizes), PropTypes.shape({
count: PropTypes.oneOfType([PropTypes.oneOf(['fit', 'fill']), PropTypes.number]),
size: PropTypes.oneOfType([PropTypes.oneOf(fixedSizes), PropTypes.arrayOf(PropTypes.oneOf(sizes)), PropTypes.string])
}), PropTypes.string]).description("Column sizes.\n If an array value is an array, the inner array indicates the\n minimum and maximum sizes for the column.\n Specifying a single string will repeat multiple columns\n of that size, as long as there is room for more.\n Specifying an object allows indicating how the columns\n stretch to fit the available space."),
fill: PropTypes.oneOfType([PropTypes.oneOf(['horizontal', 'vertical']), PropTypes.bool]).description('Whether the width and/or height should fill the container.'),
gap: PropTypes.oneOfType([PropTypes.oneOf(edgeSizes), PropTypes.shape({
row: PropTypes.oneOfType([PropTypes.oneOf(edgeSizes), PropTypes.string]),
column: PropTypes.oneOfType([PropTypes.oneOf(edgeSizes), PropTypes.string])
}), PropTypes.string]).description('Gap sizes between rows and/or columns.'),
justify: PropTypes.oneOf(['start', 'center', 'end', 'stretch']).description("How to align the individual items inside the grid when there is extra\nspace in the row axis.").defaultValue('stretch'),
justifyContent: PropTypes.oneOf(['start', 'center', 'end', 'between', 'around', 'stretch']).description('How to align the contents along the row axis.'),
rows: PropTypes.oneOfType([PropTypes.arrayOf(PropTypes.oneOfType([PropTypes.arrayOf(PropTypes.oneOfType([PropTypes.oneOf(sizes), PropTypes.string])), PropTypes.oneOf(sizes), PropTypes.string])), PropTypes.oneOf(fixedSizes), PropTypes.string]).description("Row sizes.\n If an array value is an array, the inner array indicates the\n minimum and maximum sizes for the row.\n Specifying a single string will cause automatically added rows to be\n the specified size."),
tag: PropTypes.oneOfType([PropTypes.string, PropTypes.func]).description("The DOM tag to use for the element. NOTE: This is deprecated\n in favor of indicating the DOM tag via the 'as' property."),
as: PropTypes.oneOfType([PropTypes.string, PropTypes.func]).description('The DOM tag or react component to use for the element.').defaultValue('div')
});
return DocumentedGrid;
};
export var themeDoc = _extends({
export default (function (Grid) {
var DocumentedGrid = describe(Grid).availableAt(getAvailableAtBadge('Grid')).description('A grid system for laying out content. To use, define the\nrows and columns, create area names for adjacent cells, and then\nplace Box components inside those areas using the Box.gridArea property.\nSee https://css-tricks.com/snippets/css/complete-guide-grid/.\nThe availability of Grid can be tested via \'Grid.available\'. Use this\nto create fallback rendering for older browsers, like ie11.').usage('import { Grid } from \'grommet\';\n');
DocumentedGrid.propTypes = {
align: PropTypes.oneOf(['start', 'center', 'end', 'stretch']).description('How to align the individual items inside the grid when there is extra\nspace in the column axis.').defaultValue('stretch'),
alignContent: PropTypes.oneOf(['start', 'center', 'end', 'between', 'around', 'stretch']).description('How to align the contents along the column axis.'),
areas: PropTypes.arrayOf(PropTypes.shape({
name: PropTypes.string,
start: PropTypes.arrayOf(PropTypes.number),
end: PropTypes.arrayOf(PropTypes.number)
})).description('Area names and column,row coordinates.'),
columns: PropTypes.oneOfType([PropTypes.arrayOf(PropTypes.oneOfType([PropTypes.oneOf(sizes), PropTypes.arrayOf(PropTypes.oneOf(sizes))])), PropTypes.oneOf(fixedSizes), PropTypes.shape({
count: PropTypes.oneOf(['fit', 'fill']),
size: PropTypes.oneOfType([PropTypes.oneOf(fixedSizes), PropTypes.arrayOf(PropTypes.oneOf(sizes))])
})]).description('Column sizes.\n If an array value is an array, the inner array indicates the\n minimum and maximum sizes for the column.\n Specifying a single string will repeat multiple columns\n of that size, as long as there is room for more.\n Specifying an object allows indicating how the columns\n stretch to fit the available space.'),
fill: PropTypes.oneOf(['horizontal', 'vertical', true, false]).description('Whether the width and/or height should fill the container.'),
gap: PropTypes.oneOfType([PropTypes.oneOf(edgeSizes), PropTypes.shape({
row: PropTypes.oneOf(edgeSizes),
column: PropTypes.oneOf(edgeSizes)
})]).description('Gap sizes between rows and/or columns.'),
justify: PropTypes.oneOf(['start', 'center', 'end', 'stretch']).description('How to align the individual items inside the grid when there is extra\nspace in the row axis.').defaultValue('stretch'),
justifyContent: PropTypes.oneOf(['start', 'center', 'end', 'between', 'around', 'stretch']).description('How to align the contents along the row axis.'),
rows: PropTypes.oneOfType([PropTypes.arrayOf(PropTypes.oneOfType([PropTypes.oneOf(sizes), PropTypes.arrayOf(PropTypes.oneOf(sizes))])), PropTypes.oneOf(fixedSizes)]).description('Row sizes.\n If an array value is an array, the inner array indicates the\n minimum and maximum sizes for the row.\n Specifying a single string will cause automatically added rows to be\n the specified size.'),
tag: PropTypes.string.description('The DOM tag to use for the element.').defaultValue('div')
};
`import { RangeSelector } from 'grommet';
`,
)
.intrinsicElement('div');
DocumentedRangeSelector.propTypes = {
color: colorPropType.description(
'What color to use to indicate the selection.',
),
direction: PropTypes.oneOf(['horizontal', 'vertical'])
.description('')
.defaultValue('horizontal'),
invert: PropTypes.bool.description(
'Whether to indicate what has not been selected.',
),
max: PropTypes.number
.description('The maximum value permitted.')
.defaultValue(100),
messages: PropTypes.shape({
lower: PropTypes.string,
upper: PropTypes.string,
}).description(
'Custom messages. Used for accessibility by screen readers.',
),
min: PropTypes.number
.description('The minimum value permitted.')
.defaultValue(0),
onChange: PropTypes.func.description(
`Function that will be called when the user changes one of the
values. It will be passed an array of two numbers indicating
the new values selected.`,
),
suggestionsExist: 'This input has suggestions use arrow keys to navigate',
suggestionIsOpen: 'Suggestions drop is open, continue to use arrow keys to navigate'
}),
name: PropTypes.string.description('The name attribute of the input.'),
onChange: PropTypes.func.description('Function that will be called when the user types in the input.'),
onSelect: PropTypes.func.description("Function that will be called when the user selects a suggestion.\nThe suggestion contains the object chosen from the supplied suggestions."),
onSuggestionsOpen: PropTypes.func.description('Function that will be called when the suggestions drop is opened.'),
onSuggestionsClose: PropTypes.func.description('Function that will be called when the suggestions drop is closed.'),
placeholder: PropTypes.node.description('Placeholder to use when no value is provided.'),
plain: PropTypes.bool.description("Whether this is a plain input with no border or padding.\nOnly use this when the containing context provides sufficient affordance"),
size: PropTypes.oneOfType([PropTypes.oneOf(['small', 'medium', 'large', 'xlarge']), PropTypes.string]).description('The size of the TextInput.'),
suggestions: PropTypes.arrayOf(PropTypes.oneOfType([PropTypes.shape({
label: PropTypes.node,
value: PropTypes.any
}), PropTypes.string])).description("Suggestions to show. It is recommended to avoid showing too many\nsuggestions and instead rely on the user to type more."),
value: PropTypes.oneOfType([PropTypes.string, PropTypes.number]).description('What text to put in the input.')
};
return DocumentedTextInput;
};
export var themeDoc = _extends({
export default (function (InfiniteScroll) {
var DocumentedInfiniteScroll = describe(InfiniteScroll).availableAt(getAvailableAtBadge('InfiniteScroll')).description('A container that lazily renders items.').usage('import { InfiniteScroll } from \'grommet\';\n');
DocumentedInfiniteScroll.propTypes = {
children: PropTypes.func.description('Function that will be called when each item is rendered.'),
items: PropTypes.arrayOf(PropTypes.any).description('The children callback will be called to render each item.'),
onMore: PropTypes.func.description('Use this to indicate that \'items\' doesn\'t contain all that it could.\n It will be called when the entire list of items has been rendered.\n This might be used when the total number of items that could be retrieved\n is more than you\'d want to load into the browser. \'onMore\' allows you\n to lazily fetch more from the server only when needed.'),
renderMarker: PropTypes.func.description('Function that will be called to render the marker element that\n is inserted into the DOM to track when scrolling nears the end of the\n rendered items. It will be called with a single element that should\n be wrapped appropriately. This is needed when the default\n element, a <span>, isn\'t sufficient, such as a row of a table body.'),
scrollableAncestor: PropTypes.oneOfType([PropTypes.node, PropTypes.oneOf(['window'])]).description('A custom ancestor to determine if the marker is visible in it.\n This is useful in cases where you do not want the immediate\n scrollable ancestor to be the container. For example, when your\n marker is in a div that has overflow auto but you are detecting\n visibility based on the window.\n This should typically be a reference to a DOM node, but it will\n also work to pass it the string "window" if you are using server\n rendering.'),
show: PropTypes.number.description('Ensure that the item at this index is visible initially.'),
step: PropTypes.number.description('How many items to render at a time.').defaultValue(50)
};
return DocumentedInfiniteScroll;
});</span>
export var doc = function doc(Box) {
var DocumentedBox = describe(Box).availableAt(getAvailableAtBadge('Box')).description("A container that lays out its contents in one direction. Box\n provides CSS flexbox capabilities for layout, as well as general\n styling of things like background color, border, and animation.").usage("import { Box } from 'grommet';\n").intrinsicElement('div');
DocumentedBox.propTypes = _extends({}, genericProps, {
align: PropTypes.oneOf(['start', 'center', 'end', 'baseline', 'stretch']).description('How to align the contents along the cross axis.'),
alignContent: PropTypes.oneOf(['start', 'center', 'end', 'between', 'around', 'stretch']).description("How to align the contents when there is extra space in\n the cross axis.").defaultValue('stretch'),
animation: PropTypes.oneOfType([ANIMATION_TYPE, ANIMATION_SHAPE, PropTypes.arrayOf(PropTypes.oneOfType([ANIMATION_TYPE, ANIMATION_SHAPE]))]).description("Animation effect(s) to use. 'duration' and 'delay' should\n be in milliseconds. 'jiggle' and 'pulse' types are intended for\n small elements, like icons."),
background: PropTypes.oneOfType([PropTypes.string, PropTypes.shape({
color: PropTypes.string,
dark: PropTypes.oneOfType([PropTypes.bool, PropTypes.string]),
image: PropTypes.string,
position: PropTypes.string,
opacity: PropTypes.oneOfType([PropTypes.string, PropTypes.bool, PropTypes.number, PropTypes.oneOf(['weak', 'medium', 'strong'])]),
repeat: PropTypes.oneOfType([PropTypes.oneOf(['no-repeat', 'repeat']), PropTypes.string]),
size: PropTypes.oneOfType([PropTypes.oneOf(['cover', 'contain']), PropTypes.string]),
light: PropTypes.string
})]).description("Either a color identifier to use for the background\n color. For example: 'neutral-1'. Or, a 'url()' for an image. Dark\n is not needed if color is provided."),
basis: PropTypes.oneOfType([PropTypes.oneOf(['xxsmall', 'xsmall', 'small', 'medium', 'large', 'xlarge', 'xxlarge', 'full', '1/2', '1/3', '2/3', '1/4', '2/4', '3/4', 'auto']), PropTypes.string]).description("A fixed or relative size along its container's main axis."),
border: PropTypes.oneOfType([PropTypes.bool, PropTypes.oneOf(['top', 'left', 'bottom', 'right', 'horizontal', 'vertical', 'all']), BORDER_SHAPE, PropTypes.arrayOf(BORDER_SHAPE)]).description('Include a border.'),
direction: PropTypes.oneOf(['row', 'column', 'row-responsive', 'row-reverse', 'column-reverse']).description('The orientation to layout the child components in.').defaultValue('column'),
elevation: PropTypes.oneOfType([PropTypes.oneOf(['none', 'xsmall', 'small', 'medium', 'large', 'xlarge']), PropTypes.string]).description("Elevated height above the underlying context, indicated\n via a drop shadow.").defaultValue('none'),
flex: PropTypes.oneOfType([PropTypes.oneOf(['grow', 'shrink']), PropTypes.bool, PropTypes.shape({
grow: PropTypes.number,
shrink: PropTypes.number
})]).description('Whether flex-grow and/or flex-shrink is true and at a desired factor.'),
fill: PropTypes.oneOfType([PropTypes.oneOf(['horizontal', 'vertical']), PropTypes.bool]).description('Whether the width and/or height should fill the container.'),
focusIndicator: PropTypes.bool.description("When interactive via 'onClick', whether it should receive a focus\n outline.").defaultValue(true),
gap: PropTypes.oneOfType([PropTypes.oneOf(['none', 'xxsmall', 'xsmall', 'small', 'medium', 'large', 'xlarge']), PropTypes.string]).description("The amount of spacing between child elements. This\n should not be used in conjunction with 'wrap' as the gap elements\n will not wrap gracefully."),
height: PropTypes.oneOfType([PropTypes.oneOf(['xxsmall', 'xsmall', 'small', 'medium', 'large', 'xlarge', 'xxlarge']), PropTypes.string, PropTypes.shape({