This is a documentation for Board Game Arena: play board games online !

الفرق بين المراجعتين لصفحة: «Counter»

من Board Game Arena
اذهب إلى التنقل اذهب إلى البحث
لا ملخص تعديل
 
(٤ مراجعات متوسطة بواسطة مستخدمين اثنين آخرين غير معروضة)
سطر ١١: سطر ١١:
     "ebg/counter"    /// <==== HERE],
     "ebg/counter"    /// <==== HERE],


== updateCounters(counters) ==
== Setup a counter ==


: Useful for updating game counters in the player panel (such as resources).
: The 'counters' arg is an associative array [counter_name_value => [ 'counter_name' => counter_name_value, 'counter_value' => counter_value_value], ... ]
: All counters must be referenced in '''this.gamedatas.counters''' and will be updated. Therefore if you add a counter during the game, you need to update the counters like that (through a notification management for example):
<pre>
<pre>
        this.gamedatas.counters['hammercount_p' + notif.args.player_id] = {'counter_name': 'hammercount_p' + notif.args.player_id, 'counter_value' : '0'};
player.handSizeCounter = new ebg.counter();
</pre?
player.handSizeCounter.create('hand_size_player_' + player_id);
: DOM objects referenced by 'counter_name' will have their innerHTML updated with 'counter_value'.
</pre>
 
== Update counter ==
 
<pre>
player.handSizeCounter.setValue(player.handSize);
</pre>


== Players panels ==
== Players panels ==
سطر ٢٥: سطر ٢٨:
=== Adding stuff to player's panel ===
=== Adding stuff to player's panel ===


At first, create a new "JS template" string in your template (tpl) file:
First, create a new JS template string in your template (tpl) file.
 
From the ''Gomoku'' example:


(from Gomoku example)
<pre>
<pre>
var jstpl_player_board = '\<div class="cp_board">\
var jstpl_player_board = '\<div class="cp_board">\
سطر ٣٤: سطر ٣٨:
</pre>
</pre>


Then, you add this piece of code in your JS file to add this template to each player panel:
Then, add this piece of code in the '''setup''' function of your JS file to add this template to each player panel:


<pre>
<pre>
سطر ٤٨: سطر ٥٢:
</pre>
</pre>


(Note: the code above is of course from your "setup" function in your Javascript).
Often, you have to distinguish between the current player and other players. In this case, create another JS template (ex: jstpl_otherplayer_board) and use it where "player_id" is different than "this.player_id".
 
Very often, you have to distinguish current player and others players. In this case, you just have to create another JS template (ex: jstpl_otherplayer_board) and use it when "player_id" is different than "this.player_id".

المراجعة الحالية بتاريخ ١٧:٤٦، ١ فبراير ٢٠١٩


Dependency

Don't forget to add "ebg/counter" as a dependency:

   // in you game js
   define([
   "dojo","dojo/_base/declare",
   "ebg/core/gamegui",
   "ebg/counter"    /// <==== HERE],

Setup a counter

player.handSizeCounter = new ebg.counter();
player.handSizeCounter.create('hand_size_player_' + player_id);

Update counter

player.handSizeCounter.setValue(player.handSize);

Players panels

Adding stuff to player's panel

First, create a new JS template string in your template (tpl) file.

From the Gomoku example:

var jstpl_player_board = '\<div class="cp_board">\
    <div id="stoneicon_p${id}" class="gmk_stoneicon gmk_stoneicon_${color}"></div><span id="stonecount_p${id}">0</span>\
</div>';

Then, add this piece of code in the setup function of your JS file to add this template to each player panel:

            // Setting up player boards
            for( var player_id in gamedatas.players )
            {
                var player = gamedatas.players[player_id];
                         
                // Setting up players boards if needed
                var player_board_div = $('player_board_'+player_id);
                dojo.place( this.format_block('jstpl_player_board', player ), player_board_div );
            }

Often, you have to distinguish between the current player and other players. In this case, create another JS template (ex: jstpl_otherplayer_board) and use it where "player_id" is different than "this.player_id".