Documentation

Ticker

Using the ticker display

The ticker display is used to scroll Ditty items directionally across the screen. For general information on using displays see: https://www.metaphorcreations.com/article/ditty/general/display-panel/

General settings

The general settings panel is where you’ll set the main functionality for your ticker display.

  • Direction – Set the direction of the ticker.
  • Item Max Width – Set a maximum width for items.
  • Wrap Item Elements – Allow item elements to wrap, or force them to not wrap.
  • Min. Height (vertical scrolling tickers only) – Set the minimum height of the Ditty for vertical scrolling tickers.
  • Max. Height (vertical scrolling tickers only) – Set the maximum height of the Ditty for vertical scrolling tickers.
  • Spacing – Set the amount of space between items (in pixels).
  • Speed – Set the speed of the ticker.
  • Height Ease – Set the easing of the ticker height.
  • Height Speed – Set the speed of the ticker height.
  • Initial Display – Choose how the ticker should initialize.
  • Clone Items? – Should items continually clone to fill the ticker?
  • Wrap Items? – Should items restart before all items have finished scrolling?
  • Hover Pause – Pause the ticker on mouse over.
  • Play/Pause Button – Add a play/pause button to the container.

Style settings

Display styles allow you to customize the look of your ticker as well as setting base styling for all items that will be rendered with the ticker.

Item styles

Set base styles for your items. Be aware that css added to you item’s layout may override the style added with the settings here.

  • Item typography – Set the base typography for all items of the display. This is applied to the .ditty-item__elements container element of each item.
  • Item Text Color – Set the base text color for all items of the display.
  • Item Link Color – Set a color for all links contained in each item.
  • Item Background Color – Add a background color for all items.
  • Item Padding – Add padding around each item.
  • Item Border Color – Set the border color for all items.
  • Item Border Style – Set the border style for all items.
  • Item Border Width – Set the border width for all items.
  • Item Border Radius – Add rounded corners to each item.

Content styles

Add styles to the display content container.

  • Content Background Color – Add a background color to the content.
  • Content Padding – Add padding around the content.
  • Content Border Color – Set the border color for the content.
  • Content Border Style – Set the border style for the content.
  • Content Border Width – Set the border width for the content.
  • Content Border Radius – Add rounded corners to the content.

Container styles

Add styles for the outermost display container, which includes the content and Ditty title (if enabled).

  • Container Max. Width – Set a maximum width for the container.
  • Container Background Color – Add a background color for the container.
  • Container Padding – Add padding to the container.
  • Container Margin – Add margin around the container.
  • Container Border Color – Set the border color for the container.
  • Container Border Style – Set the border style for the container.
  • Container Border Width – Set the border width for the container.
  • Container Border Radius – Add rounded corners to the container.

Title settings

Display and style the title of your ticker.

Display

General display settings for the title

  • Display – Select how to display the title.
  • Contents size – Set the size of the contents within the title area.
  • Element horizontal position – Set the horizontal position of the element within the title area.
  • Element vertical position – Set the vertical position of the element within the title area.

Font settings

Customize font settings for the title.

  • Element – Select the HTML element to use for the title.
  • Typography – Set the title typography.
  • Text color – Set a custom font color.
  • Link color – Set a custom link color.

Title dimensions

Customize dimensions for the title.

  • Min width – Set a minimum width for the title area.
  • Max width – Set a max width for the title area.
  • Min height – Set a minimum height for the title area.
  • Max height – Set a max height for the title area.

Title styles

Customize styles for the title.

  • Background color – Add a background title to the title area.
  • Margin – Add custom margins around the title area.
  • Padding – Add custom padding around the title area.
  • Border color – Choose a color for the border.
  • Border style – A border style must be set for a border to render.
  • Border width – Set custom border widths.
  • Border radius – Choose a custom border radius.