¶ Управление аурой через UI
Разберём типичную задачу: нужно разместить на экране кнопку, которая будет включать и выключать определённую функциональность.
¶ Вариант через триггер HotkeyIsActive
Стандартный способ:
- создайте ауру
- добавьте триггер
HotkeyIsActive - назначьте горячую клавишу
Готово: при нажатии хоткея состояние ауры будет переключаться.
¶ Вариант через C# Overlay
Можно сделать и отдельную кнопку в интерфейсе. Для этого создадим ещё один overlay и нарисуем кнопку там.
¶ UserOverlay.cs
public partial class UserOverlay : BlazorReactiveComponent {
[Inject]
public IAuraTreeScriptingApi AuraTree { get; init; }
public IHotkeyIsActiveTrigger Trigger
{
get => AuraTree.GetTriggerByPath<IHotkeyIsActiveTrigger>("./TargetAura");
}
public bool TriggerIsActive
{
get => Trigger.TriggerValue ?? false;
set => Trigger.TriggerValue = value;
}
}
¶ UserOverlay.razor
@using PoeShared.Blazor.Controls
@inherits BlazorReactiveComponent
<h3 class="text-center shadow-1">Toggle Trigger</h3>
<div class="text-center mt-4">
<ToggleButton
@bind-IsChecked="@TriggerIsActive"
Class="btn btn-secondary">
Trigger is Active
</ToggleButton>
</div>
<p class="text-center mt-3 alert alert-info" style="font-size: 1.5rem;">
@if (TriggerIsActive){
<span class="shadow-1">Trigger is currently active</span>
} else {
<span class="text-warning shadow-1">Trigger is currently not active</span>
}
</p>
¶ Разбор
Теперь посмотрим, как это работает подробнее.
¶ UserOverlay.cs
[Inject]
public IAuraTreeScriptingApi AuraTree { get; init; }
EyeAuras активно использует Dependency Injection. Подробнее об этом можно прочитать здесь. Если коротко, этот механизм даёт доступ к разным частям программы. В данном случае мы запрашиваем доступ к дереву аур. EyeAuras сама гарантирует, что при запуске скрипта оно будет доступно. Поскольку мы собираемся менять состояние ауры, нам нужен именно доступ к дереву аур.
public IDefaultTrigger Trigger
{
get => AuraTree.GetTriggerByPath<IHotkeyIsActiveTrigger>("./TargetAura");
}
Это свойство ищет ауру с именем TargetAura, расположенную в той же папке (./), и получает из неё триггер типа IHotkeyIsActiveTrigger. Правила путей здесь такие же, как в файловой системе: ./ — текущая папка, .. — родительская и т. д. Поддерживаются и прямые, и обратные слэши. Если аура или триггер не найдены, EyeAuras выбросит исключение.
public bool TriggerIsActive
{
get => Trigger.TriggerValue ?? false;
set => Trigger.TriggerValue = value;
}
Здесь мы читаем и задаём состояние триггера.
getнаходит триггер и читает его текущее значениеsetзаписывает новое значение
Не у всех триггеров
TriggerValueдоступен для записи, но у всех триггеров естьIsActive, чтобы читать их состояние. Это полезно, например, для триггеров вроде ImageSearch/MLSearch, если нужно проверить, нашли ли они что-нибудь.
¶ UserOverlay.razor
@using PoeShared.Blazor.Controls
ToggleButton — это компонент, который отображает кнопку с двумя состояниями (ON/OFF). Он находится в пространстве имён PoeShared.Blazor.Controls, поэтому для доступа к нему мы добавляем @using PoeShared.Blazor.Controls.
<ToggleButton
@bind-IsChecked="@TriggerIsActive"
Class="btn btn-secondary">
Trigger is Active
</ToggleButton>
Здесь мы просим Blazor отрисовать ToggleButton. Ключевая часть — @bind-IsChecked="@TriggerIsActive", она связывает состояние кнопки с нашим свойством. Во время рендера берётся значение TriggerIsActive, а при нажатии новое значение записывается обратно.
@if (TriggerIsActive){
<span class="shadow-1">Trigger is currently active</span>
} else {
<span class="text-warning shadow-1">Trigger is currently not active</span>
}
Этот блок показывает разный текст в зависимости от того, активен триггер или нет. Обратите внимание: при нажатии на кнопку текст тоже обновляется.