Hidden Element (Data) - Revision history

Rob: /* The "hidden" Element */

2008-12-04T09:40:27Z

The "hidden" Element

← Older revision		Revision as of 09:40, 4 December 2008
Line 7:		Line 7:
	:{\| class="infotable"		:{\| class="infotable"
	\|class="leftnormal"\|type		\|class="leftnormal"\|type
	\|(Optional) Set – Designates the type of object to be hidden. Must be one of these values:<br>		\|(Optional) Set – Designates the type of object to be hidden. Must be one of these values:
	thing – The object must be defined via a "thing" element.<br>		<ul class="sets">
	Default: "thing".<br>		<li>thing – The object must be defined via a "thing" element.</li>
			<li>Default: "thing".</li>
			</ul>
	{{note}}At the present time, only things can be hidden. The design of this mechanism allows it to be extended in the future if there is a need to hide other objects.		{{note}}At the present time, only things can be hidden. The design of this mechanism allows it to be extended in the future if there is a need to hide other objects.
	\|-		\|-

Rob at 23:35, 3 December 2008

2008-12-03T23:35:44Z

← Older revision		Revision as of 23:35, 3 December 2008
Line 9:		Line 9:
	\|(Optional) Set – Designates the type of object to be hidden. Must be one of these values:<br>		\|(Optional) Set – Designates the type of object to be hidden. Must be one of these values:<br>
	thing – The object must be defined via a "thing" element.<br>		thing – The object must be defined via a "thing" element.<br>
	Default: "thing".		Default: "thing".<br>
	{{note}}At the present time, only things can be hidden. The design of this mechanism allows it to be extended in the future if there is a need to hide other objects.		{{note}}At the present time, only things can be hidden. The design of this mechanism allows it to be extended in the future if there is a need to hide other objects.
	\|-		\|-

Rob at 23:35, 3 December 2008

2008-12-03T23:35:29Z

← Older revision		Revision as of 23:35, 3 December 2008
Line 17:		Line 17:
	\|}		\|}

	{{~~ntoe~~}}Since hidden objects are treated as if they don't exist, any references to hidden objects will fail to resolve successfully. This may have nasty implications, because it means that a hidden thing that is bootstrapped by another thing will cause the second thing to fail to compile. Normally, this will simply create a cascading list of a few things that must all be marked as hidden, but sometimes it can cause circular dependency issues. When that occurs, use the "replace" mechanism on things to substitute a thing that is innocuous.		{{note}}Since hidden objects are treated as if they don't exist, any references to hidden objects will fail to resolve successfully. This may have nasty implications, because it means that a hidden thing that is bootstrapped by another thing will cause the second thing to fail to compile. Normally, this will simply create a cascading list of a few things that must all be marked as hidden, but sometimes it can cause circular dependency issues. When that occurs, use the "replace" mechanism on things to substitute a thing that is innocuous.

	==Example==		==Example==

Rob: New page: {{context|Kit Reference|Data File Reference}} ==The "hidden" Element== The "hidden" mechanism comes into play when users want to modify existing data files while keeping their changes se...

2008-12-03T23:35:12Z

New page: {{context|Kit Reference|Data File Reference}} ==The "hidden" Element== The "hidden" mechanism comes into play when users want to modify existing data files while keeping their changes se...

New page

{{context|Kit Reference|Data File Reference}}

==The "hidden" Element==

The "hidden" mechanism comes into play when users want to modify existing data files while keeping their changes separate. This comes in extremely handy if there are certain standard things (e.g. skills, feats, etc.) in your campaign that are forbidden by the GM. The "hidden" mechanism flags an object so that HL treats the thing as if it does not exist, even though it remains technically present. This means a hidden object will never be shown to the user for selection. Each hidden thing is defined through the use of a "hidden" element. The complete list of attributes for this element is below.

:{| class="infotable"
|class="leftnormal"|type
|(Optional) Set – Designates the type of object to be hidden. Must be one of these values:<br>
thing – The object must be defined via a "thing" element.<br>
Default: "thing".
{{note}}At the present time, only things can be hidden. The design of this mechanism allows it to be extended in the future if there is a need to hide other objects.
|-
|id
|Id – Specifies the unique id of the object to be hidden. An object of the specified type must exist within this unique id.
|-
|}

{{ntoe}}Since hidden objects are treated as if they don't exist, any references to hidden objects will fail to resolve successfully. This may have nasty implications, because it means that a hidden thing that is bootstrapped by another thing will cause the second thing to fail to compile. Normally, this will simply create a cascading list of a few things that must all be marked as hidden, but sometimes it can cause circular dependency issues. When that occurs, use the "replace" mechanism on things to substitute a thing that is innocuous.

==Example==

The following example demonstrates what a "hidden" element might look like. All default values are assumed for optional attributes.

<pre>
<hidden type="thing" id="thingid"/>
</pre>