DevExtreme v23.2 is now available.

Explore our newest features/capabilities and share your thoughts with us.

Your search did not match any results.

Scroll View

Documentation

The ScrollView is a UI component that enables a user to scroll its content. This demo shows how to display the scrollbar within a container and how to update the ScrollView content.

Backend API
$(() => { $('#scrollview-content').html(longText); function updateContent(args, eventName) { setTimeout(() => { $(`<br /><div>Content has been updated on the ${eventName} event.</div><br />`)[eventName === 'PullDown' ? 'prependTo' : 'appendTo']('#scrollview-content'); args.component.release(); }, 500); } function updateBottomContent(e) { updateContent(e, 'ReachBottom'); } function updateTopContent(e) { updateContent(e, 'PullDown'); } const scrollViewWidget = $('#scrollview').dxScrollView({ scrollByContent: true, scrollByThumb: true, showScrollbar: 'onScroll', onReachBottom: updateBottomContent, reachBottomText: 'Updating...', }).dxScrollView('instance'); const showScrollbarModes = [{ text: 'On Scroll', value: 'onScroll', }, { text: 'On Hover', value: 'onHover', }, { text: 'Always', value: 'always', }, { text: 'Never', value: 'never', }]; $('#show-scrollbar-mode').dxSelectBox({ items: showScrollbarModes, value: showScrollbarModes[0].value, inputAttr: { 'aria-label': 'Show Scrollbar Mode' }, valueExpr: 'value', displayExpr: 'text', onValueChanged(data) { scrollViewWidget.option('showScrollbar', data.value); }, }); $('#use-reach-bottom').dxCheckBox({ value: true, text: 'Update content on the ReachBottom event', onValueChanged(data) { scrollViewWidget.option('onReachBottom', data.value ? updateBottomContent : null); }, }); $('#use-pull-down-bottom').dxCheckBox({ value: false, text: 'Update content on the PullDown event', onValueChanged(data) { scrollViewWidget.option('onPullDown', data.value ? updateTopContent : null); scrollViewWidget.option('bounceEnabled', data.value); }, }); $('#scroll-by-content').dxCheckBox({ value: true, text: 'Scroll by content', onValueChanged(data) { scrollViewWidget.option('scrollByContent', data.value); }, }); $('#scroll-by-thumb').dxCheckBox({ value: true, text: 'Scroll by thumb', onValueChanged(data) { scrollViewWidget.option('scrollByThumb', data.value); }, }); });
<!DOCTYPE html> <html xmlns="http://www.w3.org/1999/xhtml"> <head> <title>DevExtreme Demo</title> <meta http-equiv="X-UA-Compatible" content="IE=edge" /> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> <meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0" /> <script src="https://ajax.googleapis.com/ajax/libs/jquery/3.5.1/jquery.min.js"></script> <script>window.jQuery || document.write(decodeURIComponent('%3Cscript src="js/jquery.min.js"%3E%3C/script%3E'))</script> <link rel="stylesheet" type="text/css" href="https://cdn3.devexpress.com/jslib/23.2.5/css/dx.light.css" /> <script src="js/dx.all.js"></script> <script src="data.js"></script> <link rel="stylesheet" type="text/css" href="styles.css" /> <script src="index.js"></script> </head> <body class="dx-viewport"> <div class="demo-container"> <div id="scrollview-demo"> <div id="scrollview"> <div id="scrollview-content"></div> </div> <div class="options"> <div class="caption">Options</div> <div class="option"> <span>Show scrollbar:</span> <div id="show-scrollbar-mode"></div> </div> <div class="option"> <div id="use-reach-bottom"></div> </div> <div class="option"> <div id="use-pull-down-bottom"></div> </div> <div class="option"> <div id="scroll-by-content"></div> </div> <div class="option"> <div id="scroll-by-thumb"></div> </div> </div> </div> </div> </body> </html>
#scrollview-demo { min-height: 550px; } #scrollview { height: auto; position: absolute; top: 0; bottom: 300px; padding: 20px; } #scrollview-content { white-space: pre-wrap; } .options { padding: 20px; background-color: rgba(191, 191, 191, 0.15); position: absolute; bottom: 0; left: 0; right: 0; } .caption { font-size: 18px; font-weight: 500; } .option { margin-top: 10px; } .option > span { position: relative; top: 2px; margin-right: 10px; } .option > .dx-selectbox { display: inline-block; vertical-align: middle; max-width: 340px; width: 100%; }
let longText = ''; for (let i = 0; i < 10; i += 1) { longText += 'Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.\n\n'; } longText += '<br />';