Box
Map
A newer version of this page is available. Switch to the current version.

jQuery Chart - title

Configures the UI component's title.

Type:

Object

|

String

The UI component's title is a short text that usually indicates what is visualized. If you need to specify the title's text only, assign it directly to the title property. Otherwise, set this property to an object with the text and other fields specified.

The title can be accompanied by a subtitle elaborating on the visualized subject using the title.subtitle object.

View Demo

font

Specifies font properties for the title.

Type:

Object

The following code sample illustrates how to set this property:

jQuery
index.js
$(function() {
    $("#chartContainer").dxChart({
        // ...
        title: {
            font: {
                color: "black"
            }
        }
    });
});
Angular
app.component.html
app.component.ts
app.module.ts
<dx-chart ... >
    <dxo-title ... >
        <dxo-font
            color="black">
        </dxo-font>
    </dxo-title>
</dx-chart>
import { Component } from '@angular/core';

@Component({
    selector: 'app-root',
    templateUrl: './app.component.html',
    styleUrls: ['./app.component.css']
})
export class AppComponent {
    // ...
}
import { BrowserModule } from '@angular/platform-browser';
import { NgModule } from '@angular/core';
import { AppComponent } from './app.component';

import { DxChartModule } from 'devextreme-angular';

@NgModule({
    declarations: [
        AppComponent
    ],
    imports: [
        BrowserModule,
        DxChartModule
    ],
    providers: [ ],
    bootstrap: [AppComponent]
})
export class AppModule { }
Vue
App.vue
<template>
    <DxChart ... >
        <DxTitle ... >
            <DxFont
                color="black"
            />
        </DxTitle>
    </DxChart>
</template>

<script>
import DxChart, {
    DxTitle,
    DxFont
} from 'devextreme-vue/chart';

export default {
    components: {
        DxChart,
        DxTitle,
        DxFont
    },
    // ...
}
</script>
React
App.js
import React from 'react';

import Chart, {
    Title,
    Font
} from 'devextreme-react/chart';

class App extends React.Component {
    render() {
        return (
            <Chart ... >
                <Title ... >
                    <Font color="black" />
                </Title>
            </Chart>
        );
    }
}
export default App;
ASP.NET MVC Controls
Razor C#
@(Html.DevExtreme().Chart()
    // ...
    .Title(t => t
        .Font(f => f.Color("black"))
    )
)

horizontalAlignment

Specifies the title's alignment in a horizontal direction.

Type:

String

Default Value: 'center'
Accepted Values: 'center' | 'left' | 'right'

See Also

margin

Generates space around the title.

Type:

Number

|

Object

Default Value: 10

Use the fields of this object to set the required values for the left, right, top and bottom title margins separately. If title margins suppose to be equal, assign a numeric value directly to the margin property.

placeholderSize

Reserves a pixel-measured space for the title.

Type:

Number

Default Value: undefined

subtitle

Configures the UI component's subtitle.

Type:

Object

|

String

If you need to specify the subtitle's text only, assign it directly to this property. Otherwise, set this property to an object with the text and other fields specified.

text

Specifies the title's text.

Type:

String

Default Value: null

textOverflow

Specifies what to do with the title when it overflows the allocated space after applying wordWrap: hide, truncate it and display an ellipsis, or do nothing.

Type:

String

Default Value: 'ellipsis'
Accepted Values: 'ellipsis' | 'hide' | 'none'

verticalAlignment

Specifies the title's alignment in a vertical direction.

Type:

String

Default Value: 'top'
Accepted Values: 'bottom' | 'top'

See Also

wordWrap

Specifies how to wrap the title if it does not fit into a single line.

Type:

String

Default Value: 'normal'
Accepted Values: 'normal' | 'breakWord' | 'none'

The following modes are available:

  • "normal"
    Text breaks only at allowed breakpoints (for example, a space between two words).

  • "breakWord"
    Words can be broken if there are no available breakpoints in the line.

  • "none"
    Word wrap is disabled.

If the text overflows the container even after word wrap, the UI component applies the textOverflow property.