Skip to content

MongocampCollectionCharts ​

How the values of one field are distributed, drawn with Nuxt UI's UChart through MongocampChart. The chart kind follows the field's type; the numbers come from one aggregation on the server. MongocampCollectionInfos shows it in its Distribution card.

Usage ​

vue
<template>
  <MongocampCollectionCharts collection-name="orders" field="status" />
</template>

Props ​

PropTypeDefaultDescription
collectionNamestring—Required
fieldstring—Required. A top-level field or a nested path (address.city). No $, no empty segments
kind'values' | 'dates' | 'numbers'detectedForce a chart kind instead of detecting it from the server's field analysis (fields/detail: the $type names of the field in a sample of 1000 documents — numeric types add up, objectId counts as text)
topnumber10Values: how many of the most common values are shown
bucketsnumber10Numbers: how many ranges
filterstring—A Lucene filter (what a table shows): only the matching documents are charted, applied by the server as the first $match (aggregate?filter=, server 1.7.0). The kind is still detected from the whole collection. A filter over ~1 800 encoded characters is refused (The filter is too long to chart) because it travels in the URL

The three charts ​

Field typeChartAggregation
text, true/falseMost common values — bars$group by the field, $sort by the count; one page of top rows. The page total is the number of distinct values, so the note says The 10 most common of 214 values. Documents without a value are the bar (none)
dateDocuments over time — bars (up to 36 periods) or an area chart; a Per year / month / day selector$match on $type: 'date', $group by $dateToString, $sort by period; at most 100 periods (the note says if more were cut)
numberDistribution of numbers — bars$match on $type: 'number', then $bucketAuto: ranges that each hold about the same number of documents; the labels are min–max, a number beyond 2^53 keeps every digit

Arrays, objects and fields that are only ever empty get a message instead of a chart. The $type matches matter: a text value in a number field would otherwise end up as a range bound, and $dateToString fails on a non-date.

Accessibility ​

  • The chart has an aria-label (Most common values: status) and an aria-description with the number of bars and the highest one.
  • Show the data as a table opens the same numbers as a table, so nothing depends on seeing the bars.
  • The colour carries no meaning on its own: every bar is labelled on the axis.

Requirements and styling ​

  • UChart needs the package @tanstack/charts — this module depends on it, so it is installed with the module.
  • The series colours, the UnoCSS visibility fix and the text/table alternative come from MongocampChart.
  • Loading, an error with Try again, and a request that is cancelled when the field changes or the component goes away are handled for you.

Released under the MIT License.