React ResponsiveBox - items
An array of items displayed by the UI component.
Array<String | dxResponsiveBoxItem | any>
The items array can contain:
- Strings
- Objects with fields described in this section
- Objects with any other fields. In this case, specify the itemTemplate.
If you need to update the UI component items, reassign the entire items array as shown in the following example:
responsiveBoxInstance.option('items', newItems);As an alternative to items, you can use the dataSource property. It accepts the DataSource object, whose underlying stores provide an API that allows you to update individual items without reassigning the entire item collection.
component
An alias for the template property specified in React. Accepts a custom component. Refer to Using a Custom Component for more information.
disabled
Specifies whether the UI component item responds to user interaction.
html
Specifies the HTML markup to be inserted into the item element.
The ResponsiveBox component evaluates the html property's value. This evaluation, however, makes the ResponsiveBox potentially vulnerable to XSS attacks. To guard against these attacks, encode the HTML markup before you assign it to the html property. Refer to the following help topic for more information: Potentially Vulnerable API - html.
You can use the text property as a safe alternative.
location
Specifies the item location and size against the UI component grid.
If you need to specify different locations for different screens, pass an array of objects with the same structure to the location field.
<div data-options="dxItem: {
location: [
{ row: 0, col: 0, colspan: 3, screen: "lg"},
{ row: 0, col: 0, colspan: 2, screen: "xs sm md"}
]
}"> <p>Header</p> </div>See Also
render
An alias for the template property specified in React. Accepts a rendering function. Refer to Using a Rendering Function for more information.
template
Specifies a template that should be used to render this item only.
jQuery
This property supports the following values:
- A template container as a jQuery object or DOM Node
- A function that returns a template container (as a jQuery object or DOM node)
For more information about templates, refer to the following help topic: DevExtreme React - Custom Templates.
$(function() {
$("#responsiveBoxContainer").dxResponsiveBox({
// ...
items: [
{
// ...
template: '<div>Custom Item</div>'
}
]
});
});Angular
For more information about templates, refer to the following help topic: DevExtreme React - Custom Templates.
<dx-responsive-box ... >
<dxi-responsive-box-item ... >
<div *dxTemplate>
<div>Custom Item</div>
</div>
</dxi-responsive-box-item>
</dx-responsive-box>
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 { DxResponsiveBoxModule } from 'devextreme-angular';
@NgModule({
declarations: [
AppComponent
],
imports: [
BrowserModule,
DxResponsiveBoxModule
],
providers: [ ],
bootstrap: [AppComponent]
})
export class AppModule { }Vue
For more information about templates, refer to the following help topic: DevExtreme React - Custom Templates.
<template>
<DxResponsiveBox ... >
<DxItem ... >
<div>Custom Item</div>
</DxItem>
</DxResponsiveBox>
</template>
<script>
import DxResponsiveBox, {
DxItem
} from 'devextreme-vue/responsive-box';
export default {
components: {
DxResponsiveBox,
DxItem
},
// ...
}
</script>React
For more information about templates, refer to the following help topic: DevExtreme React - Custom Templates.
import React from 'react';
import ResponsiveBox, {
Item
} from 'devextreme-react/responsive-box';
const renderCustomItem = () => {
return <div>Custom Item</div>;
}
const App() = () => {
return (
<ResponsiveBox ... >
<Item ...
render={renderCustomItem}
>
</Item>
</ResponsiveBox>
);
}
export default App;See Also
text
Specifies text displayed for the UI component item.
If you use both this property and a template, the template overrides the text.