Skip to content

Conductors

dragonfavors edited this page Nov 10, 2026 · 5 revisions

화면 전환과 탭

문서 홈

Conductor는 자식 화면을 소유하고 전환·종료·폐기 완료를 기다립니다. ActiveItem과 Items는 읽기 전용입니다.

종류 선택

종류 전환할 때
Conductor<T> 이전 화면의 종료 허용 여부 확인 → 종료·폐기 → 새 화면 활성화
Conductor<T>.Collection.OneActive 이전 화면을 비활성화해 보관 → 새 화면 활성화
Conductor<T>.Collection.AllActive 등록한 화면들을 함께 활성화
Conductor<T>.StackNavigation 이전 화면을 이력에 보관, GoBackAsync로 복귀

부모가 비활성이면 등록·선택만 준비합니다. 부모를 활성화하거나 닫으면 자식의 작업 완료도 기다립니다.

단일 화면 예제

using CommunityToolkit.Mvvm.Input;
using Gyedo;
using System.Threading;
using System.Threading.Tasks;

public class HomeViewModel : Screen { }
public class SettingsViewModel : Screen { }

public partial class ShellViewModel : Conductor<IScreen>
{
    protected override Task OnInitialActivatedAsync(CancellationToken token) =>
        this.ActivateItemAsync(new HomeViewModel());

    [RelayCommand]
    private async Task OpenSettingsAsync()
    {
        bool changed = await this.ActivateItemAsync(new SettingsViewModel());
        // false이면 이전 화면이 종료를 거절했습니다.
    }
}

자식 View는 보통 UserControl로 만들고 <ContentControl g:View.Model="{Binding ActiveItem}" />로 표시합니다. View 연결

탭 예제

위 using과 HomeViewModel·SettingsViewModel을 사용하는 예입니다.

public class TabsViewModel : Conductor<IScreen>.Collection.OneActive
{
    protected override async Task OnInitialActivatedAsync(CancellationToken token)
    {
        var home = new HomeViewModel();
        await this.AddItemAsync(home);
        await this.AddItemAsync(new SettingsViewModel());
        await this.ActivateItemAsync(home);
    }
}
<TabControl Style="{StaticResource GyedoConductorTabControl}" />

기본 스타일은 탭 선택을 비동기 탐색에 연결합니다. 전환 중 선택 UI를 비활성화하고, 실패하면 이전 선택을 복구합니다. ActiveItem에 직접 대입하거나 양방향 바인딩하지 않습니다.

자식 관리

작업 API
OneActive에 선택 없이 추가 await AddItemAsync(item)
추가하고 선택 / AllActive에 추가 await ActivateItemAsync(item)
비활성화 await DeactivateItemAsync(item)
종료 확인 후 닫기 await CloseItemAsync(item) 또는 자식의 RequestCloseAsync()
OneActive·AllActive 전체 닫기 await ClearAsync()
StackNavigation 뒤로 이동 await GoBackAsync()
StackNavigation 이전 이력만 닫기 await ClearAsync()

종료가 거절되면 false를 반환합니다. DisposeChildren은 기본 true이며 종료 완료 후 부모 연결을 해제하고 폐기합니다. DI 소유 VM에는 폐기 책임을 맞추세요.

한 화면은 한 부모가 소유합니다. 다른 부모의 화면을 가져오거나 자식 활성화 훅에서 부모 탐색을 다시 기다리면 예외가 발생합니다.

새 화면 활성화 실패 시 이미 닫은 이전 화면은 복원하지 않습니다. 이전 화면을 보관하는 종류는 가능한 경우 다시 활성화합니다. 실패한 자식도 소유 목록에 남으므로 재시도하거나 닫을 수 있습니다.

Clone this wiki locally