XMBML Folder Trees

From PS3 Developer wiki
Jump to: navigation, search

An XMB item tree[edit]

This is an example of an XMBML file composed by a main XMB item which will act as a folder opening up into 3 other XMB folder items.

First create the root XMB item which acts as a folder

Codecode
	<View id="root">
		<Attributes>
			<Table key="folder_tree_main">
				<Pair key="icon_rsc"><String>tex_album_icon</String></Pair>
				<Pair key="title"><String>Main folder, contains 3 subfolders</String></Pair>
				<Pair key="child"><String>segment</String></Pair>
			</Table>
		</Attributes>
		<Items>
			<Query class="type:x-xmb/folder-pixmap"  key="folder_tree_main" attr="folder_tree_main" src="#seg_folder_tree_main_container" />
		</Items>
	</View>

Important Notes:

  • I've used "<Query class="type:x-xmb/folder-pixmap"" for <Items> sub-entry type as it is good for displaying menus.
  • The 'attr' in the <Items> sub-entry is the same as the table key in Attributes, so those attributes are asociated
  • the 'src' is using the character # that works as a link to load another "view id" segment in the current .xml
  • the 'icon_rsc' is the "default folder" icon loaded from a .rco (and available for all XMB columns)
  • 'title' is in plain text
  • 'child' is set as 'segment' so the XMB knows this item will subdivide into other XMB items

In order to create a working XMB sub menu the root xmb item must have its 'src' linking to a "container" (its the best way to think about it) and not directly linking to XMB items in the sub menu.( If you do not do this when you select your root XMB item to display a sub menu, the 'output' or 'action' of the XMB items of the sub menu will be shown rather than the actual XMB items):

Codecode
	<View id="seg_folder_tree_main_container">
		<Items>
			<Query class="type:x-xmb/folder-pixmap"  key="whatever" src="#seg_folder_tree_main_contents" />
		</Items>
	</View>

Important Notes:

  • This has no attributes as it simply acts as a contents container/linker
  • The key is just an identifyer, you can use any name

Now to create the segment which holds the sub menu items:

Codecode
	<View id="seg_folder_tree_main_contents">
		<Attributes>
			<Table key="folder_tree_subfolder_1">
				<Pair key="icon_rsc"><String>tex_album_icon</String></Pair>
				<Pair key="title"><String>Subfolder 1</String></Pair>
				<Pair key="str_noitem"><String>msg_error_no_file</String></Pair>
			</Table>
			<Table key="folder_tree_subfolder_2">
				<Pair key="icon_rsc"><String>tex_album_icon</String></Pair>
				<Pair key="title"><String>Subfolder 2</String></Pair>
				<Pair key="str_noitem"><String>msg_error_no_file</String></Pair>
			</Table>
			<Table key="folder_tree_subfolder_3">
				<Pair key="icon_rsc"><String>tex_album_icon</String></Pair>
				<Pair key="title"><String>Subfolder 3</String></Pair>
				<Pair key="str_noitem"><String>msg_error_no_file</String></Pair>
			</Table>
		</Attributes>
		<Items>
			<Query class="type:x-xmb/folder-pixmap"  key="folder_tree_subfolder_1" attr="folder_tree_subfolder_1" />
			<Query class="type:x-xmb/folder-pixmap"  key="folder_tree_subfolder_2" attr="folder_tree_subfolder_2" />
			<Query class="type:x-xmb/folder-pixmap"  key="folder_tree_subfolder_3" attr="folder_tree_subfolder_3" />
		</Items>
	</View>

Important Notes:

  • These are dummy items, they do not 'go anywhere' or perform any function. They will just print the str_noitem message when clicked because they have no function
  • notice how the <attr> from the <Items> sub entries matches the <Table keys> from the <Attributes> sub entries