Vertical alignment of rotator items where items are of different heights.
Follows CSS spec for Flex containers in the row direction.
- `arrowVariant`
string
Arrow Variant
Style navigation arrows
- `autoRotateTime`
int
Auto Rotate Time (Seconds)
The time the rotator spends on each item before automatically moving to the next in seconds. If set to 0, the rotator will not rotate automatically.
- `continuousSpeed`
int
Continuous Scroll Speed
The speed of continuous scrolling in pixels per second.
Only applies when Transition is set to "continuous".
- `direction`
string
Auto Rotate Direction
When Auto Rotation is enabled (or the Transition is "continuous"), this attribute determines the direction of rotation.
Possible values are forward and backward.
- `easing`
string
Transition Easing
The easing algorithm to apply to the rotation transition
Default = "fade", other possible values: "slide".
- `height`
string
Height
Sets the height of the element. The default units are pixels. include the percentage symbol % to user percentage values.
- `id`
string
(Required) Give this control a unique id. Can be accessed in the client DOM (eg, document.getElementById('myid') or in the server DOM using [? $myid ?] or [? $('myid') ?]).
- `minimapVariant`
string
Minimap Variant
Style variant of the Minimap below the rotator.
- `moveNextId`
string
MoveNextId
The ID of an element to use as a next button, which when clicked will advance the rotator by one position. Ensure the element exists and the id attribute is set.
- `movePreviousId`
string
MovePreviousId
The ID of an element to use as a previous button, which when clicked will move the rotator backwards by one position. Ensure the element exists and the id attribute is set.
- `pauseOnHover`
bool
Pause On Hover
If true, continuous scrolling will pause when the user hovers over the rotator.
Only applies when Transition is set to "continuous".
Defaults to false - the typical continuous rotator is an image strip, not text the visitor needs to hold still to read.
- `positionStep`
string
Position Step
The number of positions to move each time next or previous is clicked.
- `showAtOnce`
int
Group Size
The number of elements to show at once. Default = 1.
- `showAtOnceMobile`
int
Mobile Group Size
The number of elements to show at once on mobile. Default = 1.
- `spaceBetweenItems`
int
Space Between Items (px)
The amount of space between slide items. Only applicable for a ShowAtOnce value greater than 1.
- `speed`
string
Transition Speed
The speed of the transition between slides.
Default = "normal", other possible values: "fast", "slow".
- `startAtRandom`
bool
Start At Random
If true the rotator will initialize showing a randomly selected item. If false, the first item in the rotator will always be initially visible.
- `transition`
string
Transition Animation
The animation effect when moving between two items in the rotator.
Default = "fade", other possible values: "slide", "instant", "continuous".
- `width`
string
Width
Sets the width of the element. The default units are pixels. include the percentage symbol % to user percentage values.
Tutorials
Oncord's UI Controls API includes a pre-built rotator, which helps reduce development time, while providing users with an
improved experience updating content via the visual editor.
Some notable features of the Oncord rotator:
May be placed and configured via the visual page editor.
Supports html content and other Oncord UI controls such as sections, not just images.
Supports YouTube videos, where videos are stopped between slides.
Customize the rotator controls with your own images or icons.
Supports responsive content.
Customize the transition time and effect to be used between slides (slide or fade).
Show multiple content items per slide (eg. 4 testimonials per slide).
Introducing The Rotator UI Control
You can add a rotator to a website page or design through use of the <layout:rotator> UI Control.
Alternatively, a rotator can be added to the page via the visual editor. Click "Insert" on the left-hand side of the screen while
editing a website page, and drag-and-drop a "Rotator" element into position on the page.
In order to take advantage of all the features and possibilities of the rotator UI control, take note of all the "Attributes"
available in the API reference here.
The <layout:rotator> control can handle any standard content. Each direct child of the rotator will be turned into its own slide.
The rotator includes standard next / previous controls, however you can alternatively add custom links instead.
Place your custom navigation elements within links that are assigned with unique IDs.
Add the attributes moveNextId and movePreviousId to the <layout:rotator> control, where the IDs that you provide correlate
to the IDs used by your next / previous buttons.
Set the attributes arrowVariant="none" minimapVariant="none", to remove Oncord's default rotator navigation elements.
The 'ShowAtOnce' attribute can be used to view multiple slides. 'PositionStep' determines whether the rotator rotates one slide at a time, or transitions the whole group.