Help us shape the 2021 DevExtreme Roadmap. Take our 5 minute survey.
Dismiss
Free Trial Buy

title

Configures the widget's title.

Type:

Object

|

String

The widget'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 option. Otherwise, set this option 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.

font

Specifies font options for the title.

Type:

Object

jQuery
index.js
$(function() {
    $("#barGaugeContainer").dxBarGauge({
        // ...
        title: {
            font: {
                color: "black"
            }
        }
    });
});
Angular
app.component.html
app.component.ts
app.module.ts
<dx-bar-gauge ... >
    <dxo-title ... >
        <dxo-font
            color="black">
        </dxo-font>
    </dxo-title>
</dx-bar-gauge>
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 { DxBarGaugeModule } from 'devextreme-angular';

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

<script>
import DxBarGauge, {
    DxTitle,
    DxFont
} from 'devextreme-vue/bar-gauge';

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

import BarGauge, {
    Title,
    Font
} from 'devextreme-react/bar-gauge';

class App extends React.Component {
    render() {
        return (
            <BarGauge ... >
                <Title ... >
                    <Font color="black" />
                </Title>
            </BarGauge>
        );
    }
}
export default App;
ASP.NET MVC Controls
Razor C#
@(Html.DevExtreme().BarGauge()
    // ...
    .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'

Use the HorizontalAlignment enum to specify this option when the widget is used as an ASP.NET MVC 5 Control or a DevExtreme-Based ASP.NET Core Control. This enum accepts the following values: Left, Center, and 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 widget's subtitle.

Type:

Object

|

String

If you need to specify the subtitle's text only, assign it directly to this option. Otherwise, set this option 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'

Use the VizTextOverflow enum to specify this option when the widget is used as an ASP.NET MVC 5 Control or a DevExtreme-Based ASP.NET Core Control. This enum accepts the following values: Ellipsis, Hide, and None.

verticalAlignment

Specifies the title's alignment in a vertical direction.

Type:

String

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

Use the VerticalEdge enum to specify this option when the widget is used as an ASP.NET MVC 5 Control or a DevExtreme-Based ASP.NET Core Control. This enum accepts the following values: Top and Bottom.

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 widget applies the textOverflow option.

Use the VizWordWrap enum to specify this option when the widget is used as an ASP.NET MVC 5 Control or a DevExtreme-Based ASP.NET Core Control. This enum accepts the following values: Normal, BreakWord, and None.