@surf/tech

Вертикальный чарт

Вся необходимая информация про обычный вертикальный чарт

84+
63+
14+

Общая информация

Вертикальный чарт - один из самых простых чартов surf-charts, предназначенный для отображения небольшого количества простой по структуре информации в виде вертикальных столбцов с наименованиями полей под ними и значениями, выраженными в размере столбцов и надписях в тултипе, а также линией значений слева.

Пример вертикального чарта

Пример снизу отображает дефолтное поведение чарта только с необходимыми пропсами.

import { VerticalChart } from '@surf/charts';
 
const data = [
  { label: 'January', value: 1200 },
  { label: 'February', value: 800 },
  { label: 'March', value: 1500 },
  { label: 'April', value: 1100 },
  { label: 'May', value: 1400 }
];
 
function App() {
  return <VerticalChart label='Sales' data={data} />;
}

Результат

Sales
150011257503750
  • 1200
    January
  • 800
    February
  • 1500
    March
  • 1100
    April
  • 1400
    May

Работа с динамическими данными

Чарты часто нуждаются в обработке динамических данных, например, когда данные поступают с сервера. Компонент VerticalChart предназначен для гибкой обработки различных сценариев работы с данными:

  • Неполные данные: Если количество данных меньше, чем maxBars, будут отображаться только доступные данные, не оставляя пустых мест.
  • Избыток данных: Если количество данных превышает указанное значение maxBars, будут отображены только первые несколько пунктов данных в соответствии со значением maxBars.

Полную информацию об асинхронных данных можно прочесть здесь.

Кастомизация

Компонент VerticalChart предоставляет определённое количество пропсов для кастомизации. Свойства приведены в таблице ниже.

Уточнение

Стоит учесть, что ни один из пропсов не противоречит друг другу, вы можете передать все пропсы, или определить только обязательные.

Вертикальный график должен иметь определенную высоту. Убедитесь, что вы указали его высоту или высоту внешней обертки над ним.

Пропсы

PropTypeDefault
className
string
-
colorScheme
light | dark
dark
maxBars
NumericRange<3, 9>
5
label
string
-
tooltipPostfix
string
-
noDataContent
ReactNode
No data provided
noLabelContent
ReactNode
No label
styling
DerivedBarStyling
-
sort
'asc' | 'desc
-
data
DerivedBarChartData
-
props
ComponentProps<'div'>
-

Часто задаваемые вопросы

Обновлено

На странице