jQuery Lookup - Customize the Drop-Down Menu
On desktops and iOS devices, the drop-down menu is the Popover UI component; on other devices, it is the Popup UI component. To use the Popup on all devices, assign false to the usePopover property.
To customize the Popup or Popover, use the dropDownOptions object. For example, the following code removes shading from beneath the Popup and disables full-screen mode:
jQuery
JavaScript
$(function() {
$("#lookupContainer").dxLookup({
dataSource: [
"HD Video Player",
"SuperHD Video Player",
"SuperPlasma 50",
// ...
],
usePopover: false,
dropDownOptions: {
shading: false,
fullScreen: false
}
});
});Angular
HTML
TypeScript
<dx-lookup
[dataSource]="lookupDataSource"
[usePopover]="false">
<dxo-drop-down-options
[shading]="false"
[fullScreen]="false">
</dxo-drop-down-options>
</dx-lookup>
import { DxLookupModule } from "devextreme-angular";
// ...
export class AppComponent {
lookupDataSource = [ "HD Video Player", "SuperHD Video Player", "SuperPlasma 50" ];
}
@NgModule({
imports: [
// ...
DxLookupModule
],
// ...
})Vue
<template>
<DxLookup
:data-source="dataSource"
:use-popover="false">
<DxDropDownOptions
:shading="false"
:full-screen="false"
/>
</DxLookup>
</template>
<script>
import 'devextreme/dist/css/dx.light.css';
import { DxLookup, DxDropDownOptions } from 'devextreme-vue/lookup';
export default {
components: {
DxLookup,
DxDropDownOptions
},
data() {
return {
dataSource: [
'HD Video Player',
'SuperHD Video Player',
'SuperPlasma 50',
// ...
]
};
}
}
</script>React
import React from 'react';
import 'devextreme/dist/css/dx.light.css';
import { Lookup, DropDownOptions } from 'devextreme-react/lookup';
const dataSource = [
'HD Video Player',
'SuperHD Video Player',
'SuperPlasma 50',
// ...
];
class App extends React.Component {
render() {
return (
<Lookup
dataSource={dataSource}
usePopover={false}>
<DropDownOptions
shading={false}
fullScreen={false}
/>
</Lookup>
);
}
}
export default App;To change the size of the drop-down menu and position it against a specific element on your page, specify the height, width and position properties in the dropDownOptions object. The following configuration of the position property reads as follows: "place my left side at the left side of the "#targetElement".
jQuery
JavaScript
$(function() {
$("#lookupContainer").dxLookup({
dataSource: [
"HD Video Player",
"SuperHD Video Player",
"SuperPlasma 50",
// ...
],
dropDownOptions: {
height: 300,
width: 300,
position: {
my: "left",
at: "left",
of: "#targetElement"
}
}
});
});Angular
HTML
TypeScript
<img id="targetElement" src="http://here/goes/my.jpg">
<dx-lookup [dataSource]="lookupDataSource">
<dxo-drop-down-options
[height]="300"
[width]="300">
<dxo-position
my="left"
at="left"
of="#targetElement">
</dxo-position>
</dxo-drop-down-options>
</dx-lookup>
import { DxLookupModule } from "devextreme-angular";
// ...
export class AppComponent {
lookupDataSource = [ "HD Video Player", "SuperHD Video Player", "SuperPlasma 50" ];
}
@NgModule({
imports: [
// ...
DxLookupModule
],
// ...
})Vue
<template>
<div>
<img id="targetElement" src="http://here/goes/my.jpg" />
<DxLookup
:data-source="dataSource">
<DxDropDownOptions
:width="300"
:height="300">
<DxPosition
my="left"
at="left"
of="#targetElement"
/>
</DxDropDownOptions>
</DxLookup>
</div>
</template>
<script>
import 'devextreme/dist/css/dx.light.css';
import { DxLookup, DxDropDownOptions, DxPosition } from 'devextreme-vue/lookup';
export default {
components: {
DxLookup,
DxDropDownOptions,
DxPosition
},
data() {
return {
dataSource: [
'HD Video Player',
'SuperHD Video Player',
'SuperPlasma 50',
// ...
]
};
}
}
</script>React
import React from 'react';
import 'devextreme/dist/css/dx.light.css';
import { Lookup, DropDownOptions, Position } from 'devextreme-react/lookup';
const dataSource = [
'HD Video Player',
'SuperHD Video Player',
'SuperPlasma 50',
// ...
];
class App extends React.Component {
render() {
return (
<div>
<img id="targetElement" src="http://here/goes/my.jpg" />
<Lookup
dataSource={dataSource}>
<DropDownOptions
width={300}
height={300}>
<Position
my="left"
at="left"
of="#targetElement"
/>
</DropDownOptions>
</Lookup>
</div>
);
}
}
export default App;The drop-down menu can have a title. Use the dropDownOptions.title property to specify its text, or the dropDownOptions.titleTemplate property to redesign it completely. For details on implementing templates, see the Customize Item Appearance topic.
jQuery
JavaScript
$(function() {
$("#lookupContainer").dxLookup({
dataSource: [
"HD Video Player",
"SuperHD Video Player",
"SuperPlasma 50",
// ...
],
dropDownOptions: {
title: "Products"
/*
titleTemplate: function () {
return $("<div style='color: blue'>Products</div>");
}
*/
}
});
});Angular
HTML
TypeScript
<dx-lookup [dataSource]="lookupDataSource">
<dxo-drop-down-options
title="Products">
<!-- titleTemplate="titleTemplate">
<div *dxTemplate="let title of 'titleTemplate'">
<div style='color: blue'>Products</div>
</div> -->
</dxo-drop-down-options>
</dx-lookup>
import { DxLookupModule } from "devextreme-angular";
// ...
export class AppComponent {
lookupDataSource = [ "HD Video Player", "SuperHD Video Player", "SuperPlasma 50" ];
}
@NgModule({
imports: [
// ...
DxLookupModule
],
// ...
})Vue
<template>
<DxLookup
:data-source="dataSource">
<DxDropDownOptions
title="Products" />
<!-- title-template="titleTemplate" />
<template #titleTemplate>
<div :style="{color: 'blue'}">Products</div>
</template> -->
</DxLookup>
</template>
<script>
import 'devextreme/dist/css/dx.light.css';
import { DxLookup, DxDropDownOptions } from 'devextreme-vue/lookup';
export default {
components: {
DxLookup,
DxDropDownOptions
},
data() {
return {
dataSource: [
'HD Video Player',
'SuperHD Video Player',
'SuperPlasma 50',
// ...
]
};
}
}
</script>React
import React from 'react';
import 'devextreme/dist/css/dx.light.css';
import { Lookup, DropDownOptions } from 'devextreme-react/lookup';
const dataSource = [
'HD Video Player',
'SuperHD Video Player',
'SuperPlasma 50',
// ...
];
const renderTitle = () => {
return (
<div style={{color: 'blue'}}>Products</div>
);
}
class App extends React.Component {
render() {
return (
<Lookup
dataSource={dataSource}>
<DropDownOptions
title="Products"
{/* titleRender={renderTitle} */}
/>
</Lookup>
);
}
}
export default App;If you have not specified anything to be displayed in the title, hide it by assigning false to the dropDownOptions.showTitle property.
See Also
Feedback