Динамичный интерфейс
Как упоминалось в уроках ранее, объект описания интерфейса можно изменять, пока интерфейс открыт и изменения тут же будут отображаться в интерфейсе. Больше всего это подходит для элементов, которые должны появляться/изменяться/исчезать только в каких-то определенных условиях (например кнопка, которая появляется, только если в слоте есть предмет)
Получение объекта описания[править]
По скольку интерфейс всегда открывается для контейнера, то контейнер имеет метод получения объекта описания интерфейса для динамичного изменения. Этот метод - getGuiContent() - упоминался в прошлой главе и теперь будет разобран подробнее.
Формат объекта описания можно посмотреть в предыущих главах, там же говорится, что динамичными (т.е. изменения которых тут же отобразятся в интерфейсе), являются только части, отвечающие за фон и за элементы - drawing и elements, но не параметры самого интерфейса (заголовок, размер и т.п)
И так, предположим мы получили объект описания:
var content = container.getGuiContent();
Теперь, чтобы изменить в нем фон, мы можем просто присвоить drawing новое значение:
content.drawing = [
{type: "background", color: android.graphics.Color.RED}
] // мы удалили все прошлые команды и теперь рисуем просто красный фон
С элементами все несколько иначе, чтобы что-то сделать с элементом, нужно обратиться к нему по его имени: content.elements["имя элемента"], после чего с ним можно сделать 3 разных действия:
1. Приравнять новому элементу - если элемент с данным именем уже существовал, то старый будет полностью заменен на новый, если элемента не было, то будет просто создан новый элемент
2. Изменить какое-то значение - элемент с данным именем будет изменен потому что какой то его параметр был изменен.
3. Приравнять null - элемент с данным именем будет удален
ПРИМЕР #1: (изменение параметров)
// код ниже при старте откроет интерфейс с 1 кнопкой, при нажатии на которую она будет перемещаться вниз
var testUIScreen = new UI.StandartWindow({
standart: {
header: {
text: {
text: "TEST UI"
}
},
inventory: {
standart: true
},
background: {
standart: true
}
},
drawing: [],
elements: {
"test_button": {type: "button", bitmap: "close_button_up", x: 400, y: 100, scale: 8, clicker: { // самая обычная кнопка с именем test_button
onClick: function(container){ // функция короткого нажатия, все параметры кроме первого опущены за ненадобностью
var content = container.getGuiContent(); // получаем объект описания, по скольку кнопку можно нажать только с открытым интерфейсом, то он точно определен
content.elements["test_button"].y += 10; // немного сдвигаем кнопку вниз, добавляя 10 к координате y
}
}
}
}
});
// открыть интерфейс
UI.testUI(testUIScreen);
ПРИМЕР #2: (удаление и создание)
// после нажатия на кнопку, удаляет ее и создает текст о том, что она удалена
var testUIScreen = new UI.StandartWindow({
standart: {
header: {
text: {
text: "TEST UI"
}
},
inventory: {
standart: true
},
background: {
standart: true
}
},
drawing: [],
elements: {
"test_button": {type: "button", bitmap: "close_button_up", x: 400, y: 100, scale: 8, clicker: { // самая обычная кнопка с именем test_button
onClick: function(container){ // функция короткого нажатия, все параметры кроме первого опущены за ненадобностью
var content = container.getGuiContent(); // получаем объект описания, по скольку кнопку можно нажать только с открытым интерфейсом, то он точно определен
content.elements["test_button"] = null; // удаляем кнопку
content.elements["new_element"] = {type: "text", text: "button removed", x: 400, y: 50, width: 200, height: 50}; // создаем текст о том, что она удалена
}
}
}
}
});
// открыть интерфейс
UI.testUI(testUIScreen);
ПРИМЕР #3: (полная замена + изменение фона)
// после нажатия на кнопку, удаляет ее и создает текст о том, что она удалена, а так же делает фон красным
var testUIScreen = new UI.StandartWindow({
standart: {
header: {
text: {
text: "TEST UI"
}
},
inventory: {
standart: true
},
background: {
standart: true
}
},
drawing: [],
elements: {
"test_button": {type: "button", bitmap: "close_button_up", x: 400, y: 100, scale: 8, clicker: { // самая обычная кнопка с именем test_button
onClick: function(container){ // функция короткого нажатия, все параметры кроме первого опущены за ненадобностью
var content = container.getGuiContent(); // получаем объект описания, по скольку кнопку можно нажать только с открытым интерфейсом, то он точно определен
content.elements["test_button"] = {type: "text", text: "button removed", x: 400, y: 50, width: 200, height: 50}; // заменяем элемент кнопки на текст о том, что она удалена
content.drawing = [
{type: "background", color: android.graphics.Color.RED}
]; // мы удалили все прошлые команды и теперь рисуем просто красный фон
}
}
}
}
});
// открыть интерфейс
UI.testUI(testUIScreen);
ПРИМЕР #4: (tile entity):
// добавляет tile entity интерфейс с кнопкой, которая медленно опускается, пока интерфейс открыт
var testUIScreen = new UI.StandartWindow({
standart: {
header: {
text: {
text: "TEST UI"
}
},
inventory: {
standart: true
},
background: {
standart: true
}
},
drawing: [],
elements: {
"test_button": {type: "button", bitmap: "close_button_up", x: 400, y: 100, scale: 8, clicker: { // самая обычная кнопка с именем test_button
onClick: function(container){/* ничего не делаем при клике */}
}
}
}
});
// Прототип tile entity:
{
// ...
getGuiScreen: function(){ // функция получения интерфейса - отдаем наш интерфейс
return testUIScreen;
},
tick: function(){
var content = this.container.getGuiContent(); // пытаемся получить объект описания
if (content){ // если получить удалось
content.elements["test_button"].y += .3; // медленно сдвигаем кнопку вниз
}
}
// ...
}