Appboard/2.4/builder/widgets/scrolling text - Revision history

imported>Jason.nicholls at 08:22, 14 December 2013

2013-12-14T08:22:09Z

← Older revision		Revision as of 08:22, 14 December 2013
Line 1:		Line 1:
	{{DISPLAYTITLE:Scrolling Text Widget}}		{{DISPLAYTITLE:Scrolling Text Widget}}
			[[Category:AppBoard 2.4]]
	The Scrolling Text Widget provides a scrolling ticker for showing information in a dynamic and animated banner display. The concept of the Scrolling Text Widget is similar to the HTML "marquee" tag as demonstrated below:		The Scrolling Text Widget provides a scrolling ticker for showing information in a dynamic and animated banner display. The concept of the Scrolling Text Widget is similar to the HTML "marquee" tag as demonstrated below:

imported>Jason.nicholls: /* How To Configure a Scrolling Text Widget */

2013-09-04T15:37:59Z

How To Configure a Scrolling Text Widget

← Older revision		Revision as of 15:37, 4 September 2013
Line 36:		Line 36:
	#* <b>Font Size</b>: Controls the size of all of the scrolling text in the display. The font name is always AppBoard's default font (Arial)		#* <b>Font Size</b>: Controls the size of all of the scrolling text in the display. The font name is always AppBoard's default font (Arial)
	# Click <b>Next</b> to proceed to the <b>Options</b> tab.		# Click <b>Next</b> to proceed to the <b>Options</b> tab.
	# Provide additional configuration on the <b>Options</b> tab. For details on the available Options, see [[appboard/2.4/builder/~~Options~~\|Options]].		# Provide additional configuration on the <b>Options</b> tab. For details on the available Options, see [[appboard/2.4/builder/widgets/options\|Options]].
	# Click <b>Finish</b>.		# Click <b>Finish</b>.
	# In the <b>Builder Modes</b> panel, select <b>Builder</b> and navigate to the appropriate Board to observe the new Scrolling Text Widget.		# In the <b>Builder Modes</b> panel, select <b>Builder</b> and navigate to the appropriate Board to observe the new Scrolling Text Widget.
Line 45:		Line 45:

	{{Tip\|Users should be notified that they can pause the text from scrolling at any time by mouse-over (moving the pointer on to the Widget area). This can be helpful if there is critical information that they need to process before it scrolls out of the display.}}		{{Tip\|Users should be notified that they can pause the text from scrolling at any time by mouse-over (moving the pointer on to the Widget area). This can be helpful if there is critical information that they need to process before it scrolls out of the display.}}


	== Notes Regarding System Performance ==		== Notes Regarding System Performance ==

imported>Jason.nicholls at 15:37, 4 September 2013

2013-09-04T15:37:39Z

← Older revision		Revision as of 15:37, 4 September 2013
Line 10:		Line 10:


	For instructions on creating a Widget, see the general instructions in [[appboard/2.4/builder/~~Widgets~~#Adding_Widgets\|Adding Widgets]]. The <b>Scrolling Text</b> Widget type is located under the <b>Communications</b> category on the Widget selection screen.		For instructions on creating a Widget, see the general instructions in [[appboard/2.4/builder/widgets#Adding_Widgets\|Adding Widgets]]. The <b>Scrolling Text</b> Widget type is located under the <b>Communications</b> category on the Widget selection screen.


Line 59:		Line 59:


	# Follow the instruction on the [[~~appboard/2.4/builder/~~Sample_Chart_Data\|Sample Chart Data]] page to create sample Data Collections.		# Follow the instruction on the [[Sample_Chart_Data\|Sample Chart Data]] page to create sample Data Collections.
	# Select any of the Data Collections to use as the Data Collection for the Scrolling Text Widget.		# Select any of the Data Collections to use as the Data Collection for the Scrolling Text Widget.
	# Select any field in the Data Collection to use as the Text Field for the Scrolling Text Widget.		# Select any field in the Data Collection to use as the Text Field for the Scrolling Text Widget.

imported>Jason.nicholls: moved appboard/2.4/builder/scrolling text widget to appboard/2.4/builder/widgets/scrolling text

2013-09-04T15:35:25Z

moved appboard/2.4/builder/scrolling text widget to appboard/2.4/builder/widgets/scrolling text

← Older revision	Revision as of 15:35, 4 September 2013
(No difference)

imported>Mike.berman at 00:48, 9 July 2013

2013-07-09T00:48:08Z

← Older revision		Revision as of 00:48, 9 July 2013
Line 27:		Line 27:
	#* <b>Color</b>: Select the default font color to be used for the text in the Ticker. This setting applies to both the Label and Value items. The Alpha number can be adjusted to determine the color's opacity.		#* <b>Color</b>: Select the default font color to be used for the text in the Ticker. This setting applies to both the Label and Value items. The Alpha number can be adjusted to determine the color's opacity.
	#* <b>Background Color</b>: Select the text background color to be used in the Ticker. The Alpha number can be adjusted to determine the color's opacity.		#* <b>Background Color</b>: Select the text background color to be used in the Ticker. The Alpha number can be adjusted to determine the color's opacity.
	#* <b>Value Color Filter</b>: Click <b>Add</b> to create a Color Filter Rule that will determine the coloration of each scrolling text item based on application of a filter rule.		#* <b>Value Color Filter</b>: Click <b>Add</b> to create a Color Filter Rule that will determine the coloration of each scrolling text Value Field item based on application of a filter rule. The text color of the Label Field will always be the default Color selection for the Widget.
	#* <b>Speed</b>: Use the slider to indicate how quickly to scroll the text in the display.		#* <b>Speed</b>: Use the slider to indicate how quickly to scroll the text in the display.
	#* <b>Items Shown</b>:		#* <b>Items Shown</b>:
Line 45:		Line 45:

	{{Tip\|Users should be notified that they can pause the text from scrolling at any time by mouse-over (moving the pointer on to the Widget area). This can be helpful if there is critical information that they need to process before it scrolls out of the display.}}		{{Tip\|Users should be notified that they can pause the text from scrolling at any time by mouse-over (moving the pointer on to the Widget area). This can be helpful if there is critical information that they need to process before it scrolls out of the display.}}


			== Notes Regarding System Performance ==

			*The Scrolling Text Widget will use additional CPU resources on the client due to the animation.
			*The "Show All Items" mode uses more CPU than the "Show Single Items" mode.
			*The "Show All Items" mode should be limited to Data Collections of 50 rows or less. More than this may lead to unacceptable CPU usage and poor UI response in the Builder.

imported>Mike.berman at 00:24, 9 July 2013

2013-07-09T00:24:20Z

← Older revision		Revision as of 00:24, 9 July 2013
Line 27:		Line 27:
	#* <b>Color</b>: Select the default font color to be used for the text in the Ticker. This setting applies to both the Label and Value items. The Alpha number can be adjusted to determine the color's opacity.		#* <b>Color</b>: Select the default font color to be used for the text in the Ticker. This setting applies to both the Label and Value items. The Alpha number can be adjusted to determine the color's opacity.
	#* <b>Background Color</b>: Select the text background color to be used in the Ticker. The Alpha number can be adjusted to determine the color's opacity.		#* <b>Background Color</b>: Select the text background color to be used in the Ticker. The Alpha number can be adjusted to determine the color's opacity.
			#* <b>Value Color Filter</b>: Click <b>Add</b> to create a Color Filter Rule that will determine the coloration of each scrolling text item based on application of a filter rule.
	#* <b>Speed</b>: Use the slider to indicate how quickly to scroll the text in the display.		#* <b>Speed</b>: Use the slider to indicate how quickly to scroll the text in the display.
	#* <b>Items Shown</b>:		#* <b>Items Shown</b>:

imported>Mike.berman: created page

2013-07-09T00:18:46Z

created page

New page

{{DISPLAYTITLE:Scrolling Text Widget}}
The Scrolling Text Widget provides a scrolling ticker for showing information in a dynamic and animated banner display. The concept of the Scrolling Text Widget is similar to the HTML "marquee" tag as demonstrated below:

<marquee behavior="scroll" direction="left">Here is an example of text presented in a scrolling Marquee</marquee>

== How To Create a Scrolling Text Widget ==

For instructions on creating a Widget, see the general instructions in [[appboard/2.4/builder/Widgets#Adding_Widgets|Adding Widgets]]. The Scrolling Text Widget type is located under the Communications category on the Widget selection screen.

== How To Configure a Scrolling Text Widget ==

# Follow the instructions above to create the basic "Scrolling Text" Widget.
# Enter the following information on the Data tab:
#* Widget Type: Scrolling Text
#* Data collection: Select the name of the Data Collection that will provide the data to be displayed in the Ticker.
#: Note: For convenience, buttons are provided for Adding or Editing a Data Collection.
#* Widget Name: Enter a name to display for the Widget when it is shown on a Board.
# Enter the following information on the Visualization tab:
#* Label Field: Check the box to include this optional field. This will display a label prior to each value in the ticker display. Select the name of the field from the Data Collection that is providing these labels.
#* Value Field: Select the name of the field from the Data Collection that is providing the text to be displayed in the Ticker.
#* Color: Select the default font color to be used for the text in the Ticker. This setting applies to both the Label and Value items. The Alpha number can be adjusted to determine the color's opacity.
#* Background Color: Select the text background color to be used in the Ticker. The Alpha number can be adjusted to determine the color's opacity.
#* Speed: Use the slider to indicate how quickly to scroll the text in the display.
#* Items Shown:
#** Show Single Items: Select this option to only show one Label and Value on the screen at a time. When one Value scrolls off the Ticker, the next Value will scroll on to the Ticker.
#** Show All Items: Select this option to scroll all of the items immediately after one another. Multiple Values and Labels could potentially be displayed at the same time.
#*** Separator Character: When "Show All Items" is selected, this character will be inserted after each item to distinguish it from the following item.
#*** Padding: When "Show All Items" is selected, this value will control how much space is inserted between each item and the separator character.
#* Font Size: Controls the size of all of the scrolling text in the display. The font name is always AppBoard's default font (Arial)
# Click Next to proceed to the Options tab.
# Provide additional configuration on the Options tab. For details on the available Options, see [[appboard/2.4/builder/Options|Options]].
# Click Finish.
# In the Builder Modes panel, select Builder and navigate to the appropriate Board to observe the new Scrolling Text Widget.

[[Image:scrolling_text_sample.png|thumb|center|700px|A Sample Scrolling Text Widget]]

{{Tip|Users should be notified that they can pause the text from scrolling at any time by mouse-over (moving the pointer on to the Widget area). This can be helpful if there is critical information that they need to process before it scrolls out of the display.}}

== Sample Data ==

Perform the following steps to create a Scrolling Text Widget using sample data provided with Appboard:

# Follow the instruction on the [[appboard/2.4/builder/Sample_Chart_Data|Sample Chart Data]] page to create sample Data Collections.
# Select any of the Data Collections to use as the Data Collection for the Scrolling Text Widget.
# Select any field in the Data Collection to use as the Text Field for the Scrolling Text Widget.