Appearance
Chart Types
Built-in ways to display price: candlesticks, OHLC bars, area, Heikin-Ashi, and Renko. Switch via the top bar or setCustomStyles.
Usage
- Click the chart type selector in the top bar (candle icon + Charts label).
- Pick a type from the dropdown.
- The chart updates immediately.
For Renko, right-click the chart and choose Brick Size Settings to change brick size.
Chart type is saved with layouts.
Configuration
| Option | Type | Default | Description |
|---|---|---|---|
candleTypeEnabled | boolean | true | Show/hide the top-bar chart type selector |
typescript
new ChartSpire({
candleTypeEnabled: true,
// ...
})See Widget API — Constructor for all options.
Available Chart Types
candle.type | Description |
|---|---|
candle_solid | Filled candlesticks (default) |
candle_stroke | Hollow candlesticks |
candle_up_stroke | Hollow up, filled down |
candle_down_stroke | Filled up, hollow down |
ohlc | OHLC bars |
area | Area chart (close price line with fill) |
heikin_ashi | Heikin-Ashi candles |
renko | Renko bricks (price-based, not time-based) |
Changing Chart Type via API
Use Widget API setCustomStyles:
typescript
import type { CandleType } from '@chartspire/ui'
chartspire.setCustomStyles({
global: {
candle: { type: 'area' as CandleType },
},
})Set on init via the constructor customStyles option:
typescript
new ChartSpire({
customStyles: {
global: {
candle: { type: 'candle_solid' },
},
},
// ...
})For colors, price marks, area line, and Renko brick size, see Custom Styles — Candles.
Renko
Renko builds bricks when price moves by a minimum amount (candle.renko.brick.size), not on a time schedule.
typescript
chartspire.setCustomStyles({
global: {
candle: {
type: 'renko',
renko: {
brick: { size: 10 },
},
},
},
})Behavior:
- Switching to or from Renko reloads historical data and converts it to bricks.
- Live updates use a Renko-specific subscription path.
- Replay is disabled while Renko is active.
Related
- Custom Styles — Candles — colors, area, Renko brick size
- Widget API —
setCustomStyles,candleTypeEnabled - Layouts — persist chart type
- Replay — not available on Renko charts
- Data Access — historical data for conversion