Resource Histogram
Visualize resource utilization over time. See at a glance which resources are over- or under-allocated, displayed as bar or area charts with capacity threshold lines.
App.tsx
import { useRef, useCallback } from 'react';
import { ResourceHistogram, ResourceHistogramRef,
HistogramResource, HistogramAllocation } from '@timelinekit/react';
import '@timelinekit/core/styles';
function day(offset: number) {
const d = new Date();
d.setDate(d.getDate() + offset);
d.setHours(0, 0, 0, 0);
return d;
}
export default function App() {
const ref = useRef<ResourceHistogramRef>(null);
const handleReady = useCallback(() => {
const histogram = ref.current;
if (!histogram) return;
histogram.data.addResource(new HistogramResource('r1', 'Alice'));
histogram.data.addResource(new HistogramResource('r2', 'Bob'));
histogram.data.addResource(new HistogramResource('r3', 'Charlie'));
histogram.data.addAllocation(new HistogramAllocation(
null, 'r1', 'Backend API', day(0), day(10), 100));
histogram.data.addAllocation(new HistogramAllocation(
null, 'r1', 'Code Review', day(5), day(12), 50));
histogram.data.addAllocation(new HistogramAllocation(
null, 'r2', 'UI Design', day(2), day(8), 80));
histogram.data.addAllocation(new HistogramAllocation(
null, 'r3', 'Testing', day(4), day(14), 100));
histogram.data.addAllocation(new HistogramAllocation(
null, 'r3', 'Documentation', day(6), day(11), 60));
histogram.zoomToFit();
}, []);
return (
<div style={{ height: '100vh' }}>
<ResourceHistogram ref={ref} onReady={handleReady} />
</div>
);
}All API examples use histogram as shorthand for the component instance — i.e. ref.current in React or this.histogram in Angular.
Data→
Resources, allocations, utilization computation, and Gantt binding.
Configuration→
Columns, time scale & zoom, markers, threshold line, and custom tooltips.
Interaction→
Click events, context menus, hover, filtering, and undo & redo.
Features→
Display modes, view modes, export, and serialization.
Theming & Localization→
Built-in themes, histogram bar styling, and multi-language support.
API Reference→
Properties, methods, events, and types.