Fixed List Container - Revision history

Crystalp at 14:45, 27 June 2026

2026-06-27T14:45:50Z

← Older revision		Revision as of 14:45, 27 June 2026
Line 123:		Line 123:
	\|-		\|-
	\| '''movement'''		\| '''movement'''
	\| This will make the focused position scroll again at the beginning and end of the list and is used as the value of ~~<b>~~<startmovement~~></b~~> and ~~<b>~~<endmovement~~></b~~> when they are not specified (ie. ~~<b>~~<movement>6</movement~~></b~~> if there are only 6 items below the focus, the focus moves down to the bottom, and if there are only 6 items above the focus, the ~~focues~~ moves up to the top)		\| This will make the focused position scroll again at the beginning and end of the list and is used as the value of <startmovement> and <endmovement> when they are not specified (ie. <movement>6</movement> if there are only 6 items below the focus, the focus moves down to the bottom, and if there are only 6 items above the focus, the focus moves up to the top)
	\|-		\|-
	\| '''itemlayout'''		\| '''itemlayout'''

Crystalp at 14:44, 27 June 2026

2026-06-27T14:44:46Z

← Older revision		Revision as of 14:44, 27 June 2026
Line 123:		Line 123:
	\|-		\|-
	\| '''movement'''		\| '''movement'''
	\| This will make the focused position scroll again at the beginning and end of the list and is used as the value of <b><startmovement></b> and <b><endmovement></b> when they are not specified (ie. <b><movement>6</movement></b> if there are only 6 items below the focus, the focus moves down to the bottom)		\| This will make the focused position scroll again at the beginning and end of the list and is used as the value of <b><startmovement></b> and <b><endmovement></b> when they are not specified (ie. <b><movement>6</movement></b> if there are only 6 items below the focus, the focus moves down to the bottom, and if there are only 6 items above the focus, the focues moves up to the top)
	\|-		\|-
	\| '''itemlayout'''		\| '''itemlayout'''

Crystalp: edit for PR https://github.com/xbmc/xbmc/pull/28364

2026-06-27T14:43:36Z

edit for PR https://github.com/xbmc/xbmc/pull/28364

← Older revision		Revision as of 14:43, 27 June 2026
Line 115:		Line 115:
	\| '''focusposition'''		\| '''focusposition'''
	\| Specifies the focus position (from 0 -> number of displayable items - 1). The focused position doesn't change—instead, the items move up or down (or left and right) through the focus area.		\| Specifies the focus position (from 0 -> number of displayable items - 1). The focused position doesn't change—instead, the items move up or down (or left and right) through the focus area.
			\|-
			\| '''startmovement'''
			\| This will make the focused position scroll again at the beginning of the list. (ie. <movement>6</movement> if there are only 6 items above the focus, the focus moves up to the top)
			\|-
			\| '''endmovement'''
			\| This will make the focused position scroll again at the end of the list. (ie. <movement>6</movement> if there are only 6 items below the focus, the focus moves down to the bottom)
	\|-		\|-
	\| '''movement'''		\| '''movement'''
	\| This will make the focused position scroll again at the end of the list. (ie. <movement>6</movement> if there are only 6 items below the focus, the focus moves down to the bottom)		\| This will make the focused position scroll again at the beginning and end of the list and is used as the value of <b><startmovement></b> and <b><endmovement></b> when they are not specified (ie. <b><movement>6</movement></b> if there are only 6 items below the focus, the focus moves down to the bottom)
	\|-		\|-
	\| '''itemlayout'''		\| '''itemlayout'''
Line 133:		Line 139:
	\| '''autoscroll'''		\| '''autoscroll'''
	\| Used to make the container scroll automatically		\| Used to make the container scroll automatically
			\|-
			\| '''aligny'''
			\| Vertical alignment of the list items within the list area. Valid values: <code>top</code>, <code>center</code>, <code>bottom</code>. Default: <code>center</code><br />
			Note: Has no effect when items fill the list area.
	\|}		\|}

Gade: /* Available tags */

2022-04-14T00:52:01Z

Available tags

← Older revision		Revision as of 00:52, 14 April 2022
Line 102:		Line 102:
	\|-		\|-
	\| '''viewtype'''		\| '''viewtype'''
	\| The type of view, valid values are: <code>list</code>, <code>icon</code>, <code>wide</code>, <code>wrap</code>, <code>biglist</code>, <code>bigicon</code>, <code>bigwide</code>, <code>bigwrap</code>, <code>info</code> and <code>biginfo</code>. The label attribute indicates the label that will be used in the "View As" control within the GUI. It is localizable via strings.~~xml~~. ''viewtype'' has no effect on the view itself. It is used by Kodi when switching skins to automatically select a view with a similar layout. Skinners should try to set ''viewtype'' to describe the layout as best as possible.		\| The type of view, valid values are: <code>list</code>, <code>icon</code>, <code>wide</code>, <code>wrap</code>, <code>biglist</code>, <code>bigicon</code>, <code>bigwide</code>, <code>bigwrap</code>, <code>info</code> and <code>biginfo</code>. The label attribute indicates the label that will be used in the "View As" control within the GUI. It is localizable via strings.po. ''viewtype'' has no effect on the view itself. It is used by Kodi when switching skins to automatically select a view with a similar layout. Skinners should try to set ''viewtype'' to describe the layout as best as possible.
	\|-		\|-
	\| '''orientation'''		\| '''orientation'''

RogueScholar: Fix broken Wikilink created by the Great Archive-a-thon of 2020

2021-11-11T00:50:19Z

Fix broken Wikilink created by the Great Archive-a-thon of 2020

← Older revision		Revision as of 00:50, 11 November 2021
Line 1:		Line 1:
	~~<section begin="main content" />~~		The '''Fixed List Container''' is one of several containers used to display items from file lists in a certain way. It is identical to the [[List Container]] with one exception: the focus area has a fixed position, while the list appears to move beneath it in response to directional input. Thus, moving up or down scrolls the items, not the focused position. As with all container controls, the [[Container Item Layout\|layout]] of the items within the control is very flexible.
	The ~~fixed list container~~ is one of several containers used to display items from file lists in ~~various ways~~. ~~The fixed list container~~ is ~~the same as~~ the [[List Container]], with one exception: the ~~focused item is~~ fixed. Thus, moving up or down scrolls the items, not the focused position. As with all container controls, the layout of the items within the control is very flexible.

	<syntaxhighlight lang="~~XML" enclose="div~~">		<syntaxhighlight lang="xml">
	<control type="fixedlist" id="50">		<control type="fixedlist" id="50">
	<description>My first fixed list container</description>		<description>My first fixed list container</description>
Line 97:		Line 96:

	=== Available tags ===		=== Available tags ===
	In addition to the [[~~Default Control Tags~~]] the following tags are available. Note that each tag is '''lower case''' only. This is important, ~~as xml tags~~ are case-sensitive.		In addition to the [[default control tags]] the following tags are available. Note that each tag is '''lower case''' only. This is important as this file is written in XML, a language where tag names are case-sensitive.

	{\| class="prettytable"		{\| class="prettytable"
	! Tag !! Description		! Tag !! Description
	\|-		\|-
	\| '''viewtype'''		\| '''viewtype'''
	\| The type of view~~. Choices~~ are list, icon, wide, wrap, biglist, bigicon, bigwide, bigwrap, info and biginfo. The label attribute indicates the label that will be used in the "View As" control within the GUI. It is localizable via strings.xml. ''viewtype'' has no effect on the view itself. It is used by ~~kodi~~ when switching ~~skin~~ to automatically select a view with a similar layout. Skinners should try to set ''viewtype'' to describe the layout as best as possible.		\| The type of view, valid values are: <code>list</code>, <code>icon</code>, <code>wide</code>, <code>wrap</code>, <code>biglist</code>, <code>bigicon</code>, <code>bigwide</code>, <code>bigwrap</code>, <code>info</code> and <code>biginfo</code>. The label attribute indicates the label that will be used in the "View As" control within the GUI. It is localizable via strings.xml. ''viewtype'' has no effect on the view itself. It is used by Kodi when switching skins to automatically select a view with a similar layout. Skinners should try to set ''viewtype'' to describe the layout as best as possible.
	\|-		\|-
	\| '''orientation'''		\| '''orientation'''
	\| The orientation of the list~~. Defaults~~ to vertical.		\| The orientation of the list, defaults to vertical.
	\|-		\|-
	\| '''pagecontrol'''		\| '''pagecontrol'''
	\| Used to set the <id> of the page control used to control this list.		\| Used to set the <id> of the page control used to control this list.
	\|-		\|-
	\| '''scrolltime'''		\| '''scrolltime'''
	\| The time (in ms) to scroll from one item to another~~. By default~~, ~~this is~~ 200ms. The list will scroll smoothly from one item to another as needed~~. Set~~ it to zero to ~~disable~~ the smooth scrolling. The scroll movement can be further adjusted by selecting one of the available [[Tweeners\|tween]] methods.		\| The time (in milliseconds) to scroll from one item to another, defaults to 200ms. The list will scroll smoothly from one item to another as needed, or setting it to zero to disables the smooth scrolling effect. The scroll movement can be further adjusted by selecting one of the available [[Tweeners\|tween]] methods.
	\|-		\|-
	\| '''focusposition'''		\| '''focusposition'''
	\| Specifies the focus position (from 0 -> number of displayable items - 1). The focused position doesn't ~~change - instead~~, the items move up or down (or left and right) as focus ~~changes~~.		\| Specifies the focus position (from 0 -> number of displayable items - 1). The focused position doesn't change—instead, the items move up or down (or left and right) through the focus area.
	\|-		\|-
	\| '''movement'''		\| '''movement'''
	\| This will make the focused position scroll again at the end of the list. (ie. <movement>6</movement> if there are only 6 items below the focus, the focus moves down to the bottom)		\| This will make the focused position scroll again at the end of the list. (ie. <movement>6</movement> if there are only 6 items below the focus, the focus moves down to the bottom)
	\|-		\|-
	\| '''itemlayout'''		\| '''itemlayout'''
	\| Specifies the layout of items in the list~~. Requires~~ the height attribute set in a vertical list, ~~and~~ the width attribute set for a horizontal ~~list~~. The <itemlayout> then contains as many label and image controls as required. [[Container Item Layout~~\|See here for more information.~~]]		\| Specifies the layout of items in the list and requires the height attribute to be set in a vertical list, or the width attribute set for a horizontal one. The <itemlayout> then contains as many label and image controls as required.<br />''See: '''[[Container Item Layout]]'''''
	\|-		\|-
	\| '''focusedlayout'''		\| '''focusedlayout'''
	\| Specifies the layout of items in the list that have focus~~. Requires~~ the height attribute set in a vertical list, ~~and~~ the width attribute set for a horizontal ~~list~~. The <focusedlayout> then contains as many label and image controls as required. [[Container Item Layout~~\|See here for more information.~~]]		\| Specifies the layout of items in the list that have focus and requires the height attribute to be set in a vertical list, or the width attribute set for a horizontal one. The <focusedlayout> then contains as many label and image controls as required.<br />''See: '''[[Container Item Layout]]'''''
	\|-		\|-
	\| '''content'''		\| '''content'''
	\| Used to set the item content that this list will contain~~. Allows~~ the skinner to setup a list anywhere they want with a static set of content, as a useful alternative to the grouplist control. [[Static List Content~~\|See here for more information~~]]		\| Used to set the item content that this list will contain, allowing the skinner to setup a list anywhere they want with a static set of content, as a useful alternative to the <code>grouplist</code> control.<br />''See: '''[[Static List Content]]'''''
	\|-		\|-
	\| '''preloaditems'''		\| '''preloaditems'''
	\| Used in association with the ~~background image loader.~~ [[Background Image Loader\|~~See here for more information~~]]		\| Used in association with the [[Archive:Background Image Loader\|Background Image Loader]].
	\|-		\|-
	\| '''autoscroll'''		\| '''autoscroll'''
	\| Used to make the container scroll automatically		\| Used to make the container scroll automatically
	\|}		\|}

	~~<section end="main content" />~~

	== See also ==		== See also ==
Line 142:		Line 139:
	* [[Add-on development]]		* [[Add-on development]]
	* [[Skinning]]		* [[Skinning]]


	[[Category:Skin development]]		[[Category:Skin development]]

Ronie at 18:22, 5 March 2019

2019-03-05T18:22:11Z

← Older revision		Revision as of 18:22, 5 March 2019
Line 21:		Line 21:
	<focusposition>4</focusposition>		<focusposition>4</focusposition>
	<movement>6</movement>		<movement>6</movement>
	<itemlayout width="~~250~~" height="29">		<itemlayout width="650" height="29">
	<control type="image">		<control type="image">
	<left>5</left>		<left>5</left>
Line 53:		Line 53:
	</control>		</control>
	</itemlayout>		</itemlayout>
	<focusedlayout height="29" width="~~250~~">		<focusedlayout height="29" width="650">
	<control type="image">		<control type="image">
	<width>485</width>		<width>485</width>

Ronie at 20:54, 22 February 2019

2019-02-22T20:54:55Z

← Older revision		Revision as of 20:54, 22 February 2019
Line 27:		Line 27:
	<width>22</width>		<width>22</width>
	<height>22</height>		<height>22</height>
	<~~info~~>ListItem.Icon</~~info~~>		<texture>$INFO[ListItem.Icon]</texture>
	</control>		</control>
	<control type="label">		<control type="label">
Line 38:		Line 38:
	<selectedcolor>green</selectedcolor>		<selectedcolor>green</selectedcolor>
	<align>left</align>		<align>left</align>
	<~~info~~>ListItem.Label</~~info~~>		<label>$INFO[ListItem.Label]</label>
	</control>		</control>
	<control type="label">		<control type="label">
Line 50:		Line 50:
	<textcolor>grey</textcolor>		<textcolor>grey</textcolor>
	<align>right</align>		<align>right</align>
	<~~info~~>ListItem.Label2</~~info~~>		<label>$INFO[ListItem.Label2]</label>
	</control>		</control>
	</itemlayout>		</itemlayout>
Line 67:		Line 67:
	<width>22</width>		<width>22</width>
	<height>22</height>		<height>22</height>
	<~~info~~>ListItem.Icon</~~info~~>		<texture>$INFO[ListItem.Icon]</texture>
	</control>		</control>
	<control type="label">		<control type="label">
Line 78:		Line 78:
	<selectedcolor>green</selectedcolor>		<selectedcolor>green</selectedcolor>
	<align>left</align>		<align>left</align>
	<~~info~~>ListItem.Label</~~info~~>		<label>$INFO[ListItem.Label]</label>
	</control>		</control>
	<control type="label">		<control type="label">
Line 90:		Line 90:
	<textcolor>grey</textcolor>		<textcolor>grey</textcolor>
	<align>right</align>		<align>right</align>
	<~~info~~>ListItem.Label2</~~info~~>		<label>$INFO[ListItem.Label2]</label>
	</control>		</control>
	</focusedlayout>		</focusedlayout>

Ronie at 12:11, 9 April 2016

2016-04-09T12:11:04Z

← Older revision		Revision as of 12:11, 9 April 2016
Line 5:		Line 5:
	<control type="fixedlist" id="50">		<control type="fixedlist" id="50">
	<description>My first fixed list container</description>		<description>My first fixed list container</description>
	<~~posx~~>80</~~posx~~>		<left>80</left>
	<~~posy~~>60</~~posy~~>		<top>60</top>
	<width>250</width>		<width>250</width>
	<height>200</height>		<height>200</height>
Line 23:		Line 23:
	<itemlayout width="250" height="29">		<itemlayout width="250" height="29">
	<control type="image">		<control type="image">
	<~~posx~~>5</~~posx~~>		<left>5</left>
	<~~posy~~>3</~~posy~~>		<top>3</top>
	<width>22</width>		<width>22</width>
	<height>22</height>		<height>22</height>
Line 30:		Line 30:
	</control>		</control>
	<control type="label">		<control type="label">
	<~~posx~~>30</~~posx~~>		<left>30</left>
	<~~posy~~>3</~~posy~~>		<top>3</top>
	<width>430</width>		<width>430</width>
	<height>22</height>		<height>22</height>
Line 41:		Line 41:
	</control>		</control>
	<control type="label">		<control type="label">
	<~~posx~~>475</~~posx~~>		<left>475</left>
	<~~posy~~>3</~~posy~~>		<top>3</top>
	<width>300</width>		<width>300</width>
	<height>22</height>		<height>22</height>
Line 57:		Line 57:
	<width>485</width>		<width>485</width>
	<height>29</height>		<height>29</height>
	<~~posx~~>0</~~posx~~>		<left>0</left>
	<~~posy~~>0</~~posy~~>		<top>0</top>
	<visible>Control.HasFocus(50)</visible>		<visible>Control.HasFocus(50)</visible>
	<texture>list-focus.png</texture>		<texture>list-focus.png</texture>
	</control>		</control>
	<control type="image">		<control type="image">
	<~~posx~~>5</~~posx~~>		<left>5</left>
	<~~posy~~>3</~~posy~~>		<top>3</top>
	<width>22</width>		<width>22</width>
	<height>22</height>		<height>22</height>
Line 70:		Line 70:
	</control>		</control>
	<control type="label">		<control type="label">
	<~~posx~~>30</~~posx~~>		<left>30</left>
	<~~posy~~>3</~~posy~~>		<top>3</top>
	<width>430</width>		<width>430</width>
	<height>22</height>		<height>22</height>
Line 81:		Line 81:
	</control>		</control>
	<control type="label">		<control type="label">
	<~~posx~~>475</~~posx~~>		<left>475</left>
	<~~posy~~>3</~~posy~~>		<top>3</top>
	<width>300</width>		<width>300</width>
	<height>22</height>		<height>22</height>

Pbureau: /* Available tags */

2015-04-06T07:25:33Z

Available tags

← Older revision		Revision as of 07:25, 6 April 2015
Line 103:		Line 103:
	\|-		\|-
	\| '''viewtype'''		\| '''viewtype'''
	\| The type of view. Choices are list, icon, wide, wrap, biglist, bigicon, bigwide, bigwrap, info and biginfo. The label attribute indicates the label that will be used in the "View As" control within the GUI. It is localizable via strings.xml.		\| The type of view. Choices are list, icon, wide, wrap, biglist, bigicon, bigwide, bigwrap, info and biginfo. The label attribute indicates the label that will be used in the "View As" control within the GUI. It is localizable via strings.xml. ''viewtype'' has no effect on the view itself. It is used by kodi when switching skin to automatically select a view with a similar layout. Skinners should try to set ''viewtype'' to describe the layout as best as possible.
	\|-		\|-
	\| '''orientation'''		\| '''orientation'''

Ronie: /* Available tags */

2015-03-30T19:55:16Z

Available tags

← Older revision		Revision as of 19:55, 30 March 2015
Line 118:		Line 118:
	\|-		\|-
	\| '''movement'''		\| '''movement'''
	\| This will make the focused position scroll again at the end of the list. (ie. <movement>6</movement> if are only 6 items below the focus, the focus moves down to the bottom)		\| This will make the focused position scroll again at the end of the list. (ie. <movement>6</movement> if there are only 6 items below the focus, the focus moves down to the bottom)
	\|-		\|-
	\| '''itemlayout'''		\| '''itemlayout'''
Line 137:		Line 137:

	<section end="main content" />		<section end="main content" />

	== See also ==		== See also ==
	'''Development:'''		'''Development:'''