Game interface logic: yourgamename.js - Historial de revisións

Een: /* Dialogs */

2019-03-11T16:03:37Z

Dialogs

← Revisión máis antiga		Revisión como estaba o 11 de marzo de 2019 ás 16:03
Liña 651:		Liña 651:

	// Now that the dialog has been displayed, you can connect your method to some dialog elements		// Now that the dialog has been displayed, you can connect your method to some dialog elements
	// Example, a "~~close~~" button:		// Example, if you have an "OK" button in the HTML of your dialog:
	dojo.connect( $('~~closeDlg~~'), 'onclick', this, function(evt){		dojo.connect( $('my_ok_button'), 'onclick', this, function(evt){
	evt.preventDefault();		evt.preventDefault();
	this.myDlg.destroy();		this.myDlg.destroy();

Een: /* Dialogs */

2019-03-11T16:01:58Z

Dialogs

← Revisión máis antiga		Revisión como estaba o 11 de marzo de 2019 ás 16:01
Liña 657:		Liña 657:
	} );		} );

	If necessary, you can remove the default 'close' icon, or replace the function called when it is clicked:		If necessary, you can remove the default top right corner 'close' icon, or replace the function called when it is clicked:
	// Removes the default close icon		// Removes the default close icon
	this.myDlg.hideCloseIcon();		this.myDlg.hideCloseIcon();

Een: /* Dialogs */ Close icon possibilities

2019-03-11T16:00:15Z

Dialogs: Close icon possibilities

← Revisión máis antiga		Revisión como estaba o 11 de marzo de 2019 ás 16:00
Liña 656:		Liña 656:
	this.myDlg.destroy();		this.myDlg.destroy();
	} );		} );

			If necessary, you can remove the default 'close' icon, or replace the function called when it is clicked:
			// Removes the default close icon
			this.myDlg.hideCloseIcon();

			// Replace the function call when it's clicked
			this.myDlg.replaceQuitCallback( function() { ... } );

	=== Scoring dialogs ===		=== Scoring dialogs ===

Een: /* Dialogs */

2019-03-11T15:48:55Z

Dialogs

← Revisión máis antiga		Revisión como estaba o 11 de marzo de 2019 ás 15:48
Liña 634:		Liña 634:
	// Create the new dialog over the play zone. You should store the handler in a member variable to access it later		// Create the new dialog over the play zone. You should store the handler in a member variable to access it later
	this.myDlg = new ebg.popindialog();		this.myDlg = new ebg.popindialog();
	this.myDlg.create( 'myDialogUniqueId~~, 'left-side~~' );		this.myDlg.create( 'myDialogUniqueId' );
	this.myDlg.setTitle( _("my dialog title to translate") );		this.myDlg.setTitle( _("my dialog title to translate") );
	this.myDlg.setMaxWidth( 500 ); // Optional		this.myDlg.setMaxWidth( 500 ); // Optional
Liña 645:		Liña 645:
	...		...
	} );		} );

	// Show the dialog		// Show the dialog
	this.myDlg.setContent( html );		this.myDlg.setContent( html ); // Must be set before calling show() so that the size of the content is defined before positioning the dialog
	this.myDlg.show();		this.myDlg.show();

Sourisdudesert: /* General tips */

2019-03-08T13:44:00Z

General tips

← Revisión máis antiga		Revisión como estaba o 8 de marzo de 2019 ás 13:44
Liña 44:		Liña 44:
	: Return an array with the IDs of players who are currently active (or an empty array if there are none).		: Return an array with the IDs of players who are currently active (or an empty array if there are none).

	: this.bRealtime		; this.bRealtime
	: Return true if the game is in realtime. Note that having a distinct behavior in realtime and turn-based should be exceptional.		: Return true if the game is in realtime. Note that having a distinct behavior in realtime and turn-based should be exceptional.

Sourisdudesert: /* General tips */

2019-03-08T13:43:50Z

General tips

← Revisión máis antiga		Revisión como estaba o 8 de marzo de 2019 ás 13:43
Liña 43:		Liña 43:
	; this.getActivePlayers()		; this.getActivePlayers()
	: Return an array with the IDs of players who are currently active (or an empty array if there are none).		: Return an array with the IDs of players who are currently active (or an empty array if there are none).

			: this.bRealtime
			: Return true if the game is in realtime. Note that having a distinct behavior in realtime and turn-based should be exceptional.

	== Dojo framework ==		== Dojo framework ==

Een: /* Dialogs */ Document new popin dialog

2019-03-07T10:29:11Z

Dialogs: Document new popin dialog

← Revisión máis antiga		Revisión como estaba o 7 de marzo de 2019 ás 10:29
Liña 621:		Liña 621:
	=== Dialogs ===		=== Dialogs ===

	~~At first~~, you shouldn't use dialogs windows.		As a general rule, you shouldn't use dialogs windows.

	BGA guidelines specify that all game elements should be displayed on the main screen. Players can eventually scroll down to see game elements they don't need to see anytime, and you may eventually create anchors to move between game area section. Of course dialogs windows are very practical, but the thing is: all players know how to scroll down, and not all players know how to show up your dialog window. In addition, when the dialog shows up, players can't access the other game components.		BGA guidelines specify that all game elements should be displayed on the main screen. Players can eventually scroll down to see game elements they don't need to see anytime, and you may eventually create anchors to move between game area section. Of course dialogs windows are very practical, but the thing is: all players know how to scroll down, and not all players know how to show up your dialog window. In addition, when the dialog shows up, players can't access the other game components.
Liña 629:		Liña 629:


	// Create the new dialog. You should store the handler in a member variable to access it later		// Create the new dialog over the play zone. You should store the handler in a member variable to access it later
	this.myDlg = new ~~dijit~~.~~Dialog~~(~~{ title:~~ _("my dialog title to translate") });		this.myDlg = new ebg.popindialog();
			this.myDlg.create( 'myDialogUniqueId, 'left-side' );
			this.myDlg.setTitle( _("my dialog title to translate") );
			this.myDlg.setMaxWidth( 500 ); // Optional

	// Create the HTML of my dialog.		// Create the HTML of my dialog.
Liña 639:		Liña 642:
	...		...
	} );		} );

	// Show the dialog		// Show the dialog
	this.myDlg.~~attr~~(~~"content",~~ html );		this.myDlg.setContent( html );
	this.myDlg.show();		this.myDlg.show();

	// Now that the dialog has been displayed, you can connect your method to some dialog elements		// Now that the dialog has been displayed, you can connect your method to some dialog elements
Liña 648:		Liña 651:
	dojo.connect( $('closeDlg'), 'onclick', this, function(evt){		dojo.connect( $('closeDlg'), 'onclick', this, function(evt){
	evt.preventDefault();		evt.preventDefault();
	this.myDlg.~~hide~~();		this.myDlg.destroy();
	} );		} );



	Tip: be careful with "hide()" method to close your dialog: the dialog and its content is not completely removed from the DOM. It can cause you problems if you try to display the same dialog several times. A good practice is to wrap all the content of your dialog in a <nowiki><div id='myDlgContent'></nowiki> div element, and to call "dojo.destroy('myDlgContent')" before displaying your dialog.

	=== Scoring dialogs ===		=== Scoring dialogs ===

Amadannabriona: /* Other useful stuff */

2018-10-06T21:27:14Z

Other useful stuff

← Revisión máis antiga		Revisión como estaba o 6 de outubro de 2018 ás 21:27
Liña 874:		Liña 874:
	</pre>		</pre>

	In the example above, using dojo.hitch, we ~~are sure~~ that the "this" object will be set when the callback is called.		In the example above, using dojo.hitch, we ensure that the "this" object will be set when the callback is called.

Amadannabriona: /* Tooltips */

2018-10-06T20:15:00Z

Tooltips

← Revisión máis antiga		Revisión como estaba o 6 de outubro de 2018 ás 20:15
Liña 537:		Liña 537:
	Specify 'actionString' to display some information about "what happens when I click on this element?".		Specify 'actionString' to display some information about "what happens when I click on this element?".

	You must specify both helpString and actionString. Most of the time, you use only one and specify a void string ("") for the other one.		You must specify both helpString and actionString. Most of the time, you should use only one and specify a void string ("") for the other one.

	Usually, _() must be used for the text to be marked for translation.		Usually, _() must be used for the text to be marked for translation.

	"Delay" is an optional parameter. Usually, it is primarily used to specify a zero delay for some game element when the tooltip gives really important information for the game - but remember: no essential information must be placed in tooltips as they won't be displayed in some ~~browser~~ (see Guidelines).		"Delay" is an optional parameter. Usually, it is primarily used to specify a zero delay for some game element when the tooltip gives really important information for the game - but remember: no essential information must be placed in tooltips as they won't be displayed in some browsers (see [[BGA_Studio_Guidelines\|Guidelines]]).

	Example:		Example:

Amadannabriona: /* Accessing and manipulating the DOM */

2018-09-16T21:27:05Z

Accessing and manipulating the DOM

← Revisión máis antiga		Revisión como estaba o 16 de setembro de 2018 ás 21:27
Liña 132:		Liña 132:
	</pre>		</pre>

	Conclusion: we encourage you to use '''dojo.addClass''', '''dojo.removeClass''' and '''dojo.hasClass''' to make your life easier :)		Conclusion: We encourage you to use '''dojo.addClass''', '''dojo.removeClass''' and '''dojo.hasClass''' to make your life easier :)

	'''dojo.query'''		'''dojo.query'''
Liña 160:		Liña 160:
	'''dojo.place'''		'''dojo.place'''

	dojo.place is the best function to insert ~~some~~ HTML code somewhere in your game interface without breaking something. It is much better to use ~~that "~~innerHTML=''" method ~~as soon as~~ you must insert HTML tags and not only values.		dojo.place is the best function to insert HTML code somewhere in your game interface without breaking something. It is much better to use than the '''innerHTML=''' method if you must insert HTML tags and not only values.

	<pre>		<pre>