XAML or HTML

032. 데이터템플릿 & 트리거(DataTemplate & Trigger) #3

XAML 뽀개기

이전 포스트에서는 데이타템플릿, 스타일을 컨버터, 셀렉터를 활용해 하나의 컨트롤에서 다양한 형태를 보여줄 있었습니다. 이번 포스트에서는 트리거를 이용하는 방법을 살펴봅니다.

 

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
<!-- Style & Template Trigger -->
<DataTemplate x:Key="DataTemplate_Message" DataType="{x:Type local:ExchangeMessage}">
    <StackPanel>
        <TextBlock x:Name="PART_Name" Text="{Binding Name}"/>
        <Border x:Name="PART_Background" Background="White" CornerRadius="5" Margin="0,3">
            <TextBlock Text="{Binding Message}" TextWrapping="Wrap" Grid.Column="1" FontSize="11" Margin="5,3,5,7"/>
        </Border>
        <TextBlock x:Name="PART_Time" Text="{Binding ConfirmedTime, StringFormat=hh:mm:ss}" FontSize="8"/>
    </StackPanel>
    <DataTemplate.Triggers>
        <DataTrigger Binding="{Binding IsMine}" Value="True">
            <Setter Property="Background" Value="#FFFFEB33" TargetName="PART_Background"/>
            <Setter Property="HorizontalAlignment" Value="Right" TargetName="PART_Time"/>
            <Setter Property="Visibility" TargetName="PART_Name">
                <Setter.Value>Collapsed</Setter.Value>
            </Setter>
        </DataTrigger>
    </DataTemplate.Triggers>
</DataTemplate>
cs

 

이번에는 데이타템플릿이 하나만 필요합니다. 다른 사람의 메시지를 기본 템플릿으로 정의하고 데이타트리거를 이용해 메시지일 때에 달라져야하는 속성들을 정의합니다. 이전 예제와 동일한 형태로 정의하므로 자세한 프로퍼티 사항들은 생략합니다. 필요한 요소들을 TargetName 지정해야하므로 x:Name 선언하는 것에 주의합니다.

 

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
<Style x:Key="Style_Message" TargetType="{x:Type ListBoxItem}">
    <Setter Property="Template">
        <Setter.Value>
            <ControlTemplate TargetType="{x:Type ListBoxItem}">
                <ContentPresenter x:Name="PART_ListBoxItem" 
                                  HorizontalAlignment="Left" 
                                  Margin="5,0,20,5"/>
                <ControlTemplate.Triggers>
                    <DataTrigger Binding="{Binding IsMine}" Value="True">
                        <Setter Property="HorizontalAlignment" Value="Right" TargetName="PART_ListBoxItem"/>
                        <Setter Property="Margin" Value="20,0,5,5" TargetName="PART_ListBoxItem"/>
                    </DataTrigger>
                </ControlTemplate.Triggers>
            </ControlTemplate>
        <Setter.Value>
    </Setter>
</Style>
cs


스타일도 데이타템플릿과 동일한 방법으로 데이타프리거를 이용합니다. PART_ListBoxItem의 HorizontalAlignment 속성은 Left, Margin은 5,0,20,5로 선언합니다. 기본으로 선언한 스타일은 다른 사람의 메시지 스타일이 됩니다. 다음엔 데이터트리거를 이용해서 내 메시지일 떄에 달라져야하는 속성들의 값을 반대로 정의합니다.

 

1
2
3
4
5
6
7
8
9
10
11
12
<!-- Style & Template Trigger -->
<ListBox ItemTemplate="{StaticResource DataTemplate_Message}" 
         ItemContainerStyle="{StaticResource Style_Message}"
         Grid.Column="1">
    <ListBox.ItemsSource>
        <x:Array Type="{x:Type local:ExchangeMessage}">
            <local:ExchangeMessage Name="X Friend" Message="Charles~ R u there?" ConfirmedTime="2018-03-01 12:24:33" IsMine="False"/>
            <local:ExchangeMessage Name="Me" Message="Yeah~ i'm here. What's up?" ConfirmedTime="2018-03-01 12:25:44" IsMine="True"/>
            <local:ExchangeMessage Name="X Friend" Message="Do u have time tonight? Let's get it!" ConfirmedTime="2018-03-01 12:26:55" IsMine="False"/>
        </x:Array>
    </ListBox.ItemsSource>
</ListBox>
cs

 

ItemTemplate ItemContainerStyle 선언하는 것은 이전과 다를 것이 없습니다.

 

 

실행해서 태스트해봅니다

 

컨버터를 사용할지 셀렉터를 사용할지 트리거를 사용할지는 여러분이 판단하시길 바랍니다. 여러 조건과 상황에 따른 옳은 판단이 중요할 같습니다.

 

참고 : JERRIE PELSER > 3 Techniques you can use to make your data templates dynamic

030. 데이타템플릿 & 컨버터(DataTemplate & Converter) #1

XAML 뽀개기

이번 포스트 제목은 데이타템플릿(DataTemplate)이긴 하지만 예전 포스트들에서 다뤘던 다양한 기능들과 함께 살펴봅니다.

 

목록형 컨트롤들에서는 하나의 값을 보여주기도 하지만 다양한 형태의 값들을 함께 보여주기도 합니다. 데이타템플릿은 이처럼 다양한 데이터를 어떻게 구성해서 보이게 할지 정의하는 역할을 합니다.

 


이번 시리즈 포스트의 최종 결과물입니다. 평소에 흔하게 사용하는 채팅앱을 예로 들어 이해를 돕고자 합니다. 2개의 목록형 예제는 시각적인 결과는 동일하지만 전혀 다른 방법으로 만들었습니다. 이번 시리즈 포스트에서는 데이터템플릿뿐만 아니라 스타일(Style), 컨버터(Converter), 셀렉터(Selector), 트리거(Trigger) 다양한 기능들을 함께 다루게 됩니다.

 

1
2
3
4
5
6
7
public class ExchangeMessage
{
    public bool IsMine { get; set; }            // 메시지 구분자
    public string Name { get; set; }            // 발신자 이름
    public string Message { get; set; }         // 발신 내용
    public DateTime ConfirmedTime { get; set; } // 확인 시간
}
cs

 

먼저 리스트박스(ListBox) 보이게 샘플 데이터의 모델 클래스 ExchangeMessage입니다. Name 메시지를 발신자의 이름입니다. Message 발신자의 메시지 내용입니다. ConfirmedTime은 메시지를 확인한 시간입니다. 마지막으로 IsMine은 메시지가 것인지 다른 사람의 것인지 구분하기 위한 bool 타입의 구분자입니다. 다른 요소들이 있을 있지만 예제 코드를 최소화하기 위해 제외했습니다.

 

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
<Grid.Resources>
    <Style TargetType="{x:Type ListBox}">
        <Setter Property="ScrollViewer.HorizontalScrollBarVisibility" Value="Disabled"/>
        <Setter Property="Background" Value="#FFB2C7D9"/>
    </Style>
</Grid.Resources>
 
<ListBox>
    <ListBox.ItemsSource>
        <x:Array Type="{x:Type local:ExchangeMessage}">
            <local:ExchangeMessage Name="X Friend" Message="Charles~ R u there?" ConfirmedTime="2018-03-01 12:24:33" IsMine="False"/>
            <local:ExchangeMessage Name="Me" Message="Yeah~ i'm here. What's up?" ConfirmedTime="2018-03-01 12:25:44" IsMine="True"/>
            <local:ExchangeMessage Name="X Friend" Message="Do u have time tonight? Let's get it!" ConfirmedTime="2018-03-01 12:26:55" IsMine="False"/>
        </x:Array>
    </ListBox.ItemsSource>
</ListBox>
cs

 

예제를 위한 기본 리스트박스 XAML 코드입니다. X라는 친구와 대화를 나누는 시나리오입니다. 디자인 스타일은 여러분이 생각하는 그 채팅앱에서 가져왔습니다. 그리고 가로 스크롤은 불필요하기 때문에 HorizontalScrollBarVisibility 속성을 Disabled을 선언하였고 바탕색(Background) 속성에 #FFB2C7D9 브러쉬를 선언했습니다.

 

 

리스트박스에 ItemsSource 속성만 정의한 디자인뷰에서 모든 값이 제대로 보이지 않습니다.


1
2
3
4
5
6
7
8
9
<ListBox DisplayMemberPath="Message">
    <ListBox.ItemsSource>
        <x:Array Type="{x:Type local:ExchangeMessage}">
            <local:ExchangeMessage Name="X Friend" Message="Charles~ R u there?" ConfirmedTime="2018-03-01 12:24:33" IsMine="False"/>
            <local:ExchangeMessage Name="Me" Message="Yeah~ i'm here. What's up?" ConfirmedTime="2018-03-01 12:25:44" IsMine="True"/>
            <local:ExchangeMessage Name="X Friend" Message="Do u have time tonight? Let's get it!" ConfirmedTime="2018-03-01 12:26:55" IsMine="False"/>
        </x:Array>
    </ListBox.ItemsSource>
</ListBox>
cs

 

 

DisplayMemberPath 속성을 이용하면 위처럼 모델 데이터의 일부만 표현이 가능합니다. 하지만 표출하고자 하는 것은 위처럼 Message만이 아닙니다.

 

1
2
3
4
5
6
7
8
9
10
11
12
<!-- DataTemplate-->
<DataTemplate x:Key="DataTemplate_Message_Basic">
    <StackPanel>
        <TextBlock Text="{Binding Name}" 
                   Visibility="{Binding IsMine}"/>
        <Border Background="{Binding IsMine}" 
                CornerRadius="5" Margin="0,3">
            <TextBlock Text="{Binding Message}" TextWrapping="Wrap" Grid.Column="1" FontSize="11" Margin="5,3,5,7"/>
        </Border>
        <TextBlock x:Name="PART_Time" Text="{Binding ConfirmedTime, StringFormat=hh:mm:ss}" FontSize="8"/>
    </StackPanel>
</DataTemplate>
cs

 

드디어 데이타템플릿을 정의합니다. Blend for VS [추가 템플릿 편집 > 생성된 항목(ItemTemplate) 편집 > 현재 항목/복사본 편집] 기능을 이용하면 위지위스(WYSIWYG) 방식으로 작성할 수도 있습니다. 각각의 모델 데이터를 바인딩 문법을 이용해 정의합니다. 추가로 확인한 시간은 StringFormat 속성을 이용해 시간만 간략히 보이도록 합니다.

 

1
2
3
4
5
6
7
8
9
10
<!-- DataTemplate -->
<ListBox ItemTemplate="{StaticResource DataTemplate_Message_Basic}">
    <ListBox.ItemsSource>
        <x:Array Type="{x:Type local:ExchangeMessage}">
            <local:ExchangeMessage Name="X Friend" Message="Charles~ R u there?" ConfirmedTime="2018-03-01 12:24:33" IsMine="False"/>
            <local:ExchangeMessage Name="Me" Message="Yeah~ i'm here. What's up?" ConfirmedTime="2018-03-01 12:25:44" IsMine="True"/>
            <local:ExchangeMessage Name="X Friend" Message="Do u have time tonight? Let's get it!" ConfirmedTime="2018-03-01 12:26:55" IsMine="False"/>
        </x:Array>
    </ListBox.ItemsSource>
</ListBox>
cs


(x:Key) 이용해 정의한 DataTemplate을 리스트박스의 ItemTemplate 속성에 StaticResource 문법을 이용해 선언합니다.

 

 

DataTemplate을 선언한 리스트박스가 이전과 다르게 다양한 여러 데이터가 함께 보이게 됩니다. 여기서 끝이 아니겠죠?

 

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
[ValueConversion(typeof(bool), typeof(Visibility))]
public class BooleanToVisibilityConverter : IValueConverter
{
    enum Parameters
    {
        NORMAL, INVERTED
    }
 
    public object Convert(object value, Type targetType, object parameter, CultureInfo culture)
    {
        var boolValue = (bool)value;
        var strParam = parameter.ToString().ToUpper();
        var direction = (Parameters)Enum.Parse(typeof(Parameters), strParam);
 
        if (direction == Parameters.INVERTED)
        {
            return !boolValue ? Visibility.Visible : Visibility.Collapsed;
        }
        else
        {
            return boolValue ? Visibility.Visible : Visibility.Collapsed;
        }
    }
    
    public object ConvertBack(object value, Type targetType, object parameter, CultureInfo culture)
    {
        return null;
    }
}
 
cs

 

BooleanToVisibilityConverter 컨버터를 추가합니다. 내가 보낸 메시지의 발신자 이름은 보이지않고고 X라는 친구의 이름은 보여야 합니다. 기능을 컨버터를 이용해 표현합니다. 파라미터(ConverterParameter) 이용해 정반대로 컨버팅하는 기능도 추가했습니다.

 

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
[ValueConversion(typeof(bool), typeof(Brush))]
public class BooleanToBrushConverter : IValueConverter
{
    public Brush FalseBrush { get; set; }
    public Brush TrueBrush { get; set; }
 
    public object Convert(object value, Type targetType, object parameter, CultureInfo culture)
    {
        return (bool)value ? TrueBrush : FalseBrush;
    }
 
    public object ConvertBack(object value, Type targetType, object parameter, CultureInfo culture)
    {
        return value;
    }
}
cs

 

컨버터를 하나 추가합니다. 이번 컨버터는 내가 보낸 메시지와 친구가 보낸 메시지의 바탕색(Background) 다르게 하기 위한 것입니다. Brush 타입의 프로퍼티를 추가해서 고정된 브러쉬가 아닌 사용자가 컨버터를 리소스에 선언할 때마다 다른 브러쉬를 정의할 있도록 합니다.

 

1
2
3
4
<!-- Converter -->
<cvt:BooleanToVisibilityConverter x:Key="BooleanToVisibilityConverter"/>
<cvt:BooleanToBrushConverter x:Key="BooleanToBrushConverter" 
                             TrueBrush="#FFFFEB33" FalseBrush="White"/>
cs

 

준비된 컨버터를 XAML 코드에서 사용하기 위해서는 리소스로 선언해야 합니다. 컨버터에 추가한 Brush 타입의 2개의 프로퍼티에는 원하는 브러쉬를 선언합니다.

 

1
2
3
4
5
6
7
8
9
10
11
12
13
<!-- DataTemplate-->
<DataTemplate x:Key="DataTemplate_Message_Basic">
    <StackPanel>
        <TextBlock Text="{Binding Name}" 
                   Visibility="{Binding IsMine, Converter={StaticResource BooleanToVisibilityConverter}, 
                                                ConverterParameter=inverted}"/>
        <Border Background="{Binding IsMine, Converter={StaticResource BooleanToBrushConverter}}" 
                CornerRadius="5" Margin="0,3">
            <TextBlock Text="{Binding Message}" TextWrapping="Wrap" Grid.Column="1" FontSize="11" Margin="5,3,5,7"/>
        </Border>
        <TextBlock x:Name="PART_Time" Text="{Binding ConfirmedTime, StringFormat=hh:mm:ss}" FontSize="8"/>
    </StackPanel>
</DataTemplate>
cs

 

리소스에 선언한 컨버터를 비인딩 문법에 Converter 속성을 이용해 데이타템플릿에 추가로 정의합니다.

 

 

2개의 컨버터를 이용해 발신자 이름의 표시 유무와 바탕색을 다르게 표현했습니다.

 

내가 보낸 메시지와 다른 사람이 보낸 메시지를 더욱 명확하게 구분해 보기 위해선 추가 작업이 필요합니다. 다른 사람이 보낸 메시지는 좌측으로 정렬하고 내가 보낸 메시지는 우측으로 정렬하면 나은 표현 방법이 같습니다.

 

추가할 방법들은 다음 포스트에서 살펴봅시다.

 

이번 포스트에서 추가로 사용된 Convertert StringFormat 예전 포스트를 참고하기 바랍니다.

 

참고 : JERRIE PELSER > 3 Techniques you can use to make your data templates dynamic

006. 클래스와 데이타템플릿(Class & DataTemplate)

XAML 뽀개기

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
public class Person
{
    public string RealName { get; set; }
    public int Age { get; set; }
}
 
public class Family : List<Person>
{
    public Family()
    {
        Add(new Person() { RealName = "길동", Age = 40 });
        Add(new Person() { RealName = "철수", Age = 30 });
        Add(new Person() { RealName = "영희", Age = 20 });
    }
}
cs

 

목록형의 아이템 구성은 예제처럼 간단하지 않고 복잡할 있습니다. 하지만 복잡한 구성일지라도 Class 이용해 표현 가능합니다.

 

1
2
3
4
5
6
<DataTemplate x:Key="DataTemplate_ListBoxItem">
    <StackPanel Orientation="Horizontal">
        <TextBlock Text="{Binding RealName}" Margin="0,0,10,0"/>
        <TextBlock Text="{Binding Age}"/>
    </StackPanel>
</DataTemplate>
cs

 

XAML에서 목록형의 아이템 템플릿은 Class 구성에 맞추어 DataTemplate에서 정의합니다.

 

 

결과는 위와 같습니다.

 

1
2
3
4
5
6
7
8
9
10
<Grid.Resources>
    <x:Array x:Key="Peoples" Type="{x:Type local:Person}">
        <local:Person RealName="홍길동" Age="40"/>
        <local:Person RealName="박철수" Age="30"/>
        <local:Person RealName="김영희" Age="20"/>
    </x:Array>
 
    <local:Family x:Key="Family"/>
</Grid.Resources>
 
cs

 

Class에서 정의한 모델은 리소스에 정의한 XAML 안에서 사용할 있습니다.

 

1
2
3
4
5
6
<ListBox ItemsSource="{Binding Source={StaticResource Peoples}}" 
         ItemTemplate="{DynamicResource DataTemplate_ListBoxItem}"/>
 
<ListBox ItemsSource="{Binding Source={StaticResource Family}}" 
         ItemTemplate="{DynamicResource DataTemplate_ListBoxItem}" 
         Grid.Column="1"/>
cs

 

이전에 정의한 Class DataTemplate 위와 같이 정의합니다.

 

1
2
3
4
5
6
7
8
9
10
<ListBox ItemTemplate="{DynamicResource DataTemplate_ListBoxItem}" 
         Grid.Column="2">
    <ListBox.ItemsSource>
        <x:Array Type="{x:Type local:Person}">
            <local:Person RealName="홍길동" Age="40"/>
            <local:Person RealName="박철수" Age="30"/>
            <local:Person RealName="김영희" Age="20"/>
        </x:Array>
    </ListBox.ItemsSource>
</ListBox>
cs

 

이전 포스트에서도 다루었지만 목록형의 ItemsSource는 위와 같이 정의할 있습니다.


 

 

1
2
3
<ListBox ItemsSource="{Binding Source={StaticResource Family}}" 
         DisplayMemberPath="RealName"
         Grid.Column="3"/>
cs

 

DataTemplate 정의할 필요가 없을 때에는 DisplayMemberPath 속성을 이용해 간단히 목록을 표현할 있습니다.



샘플 코드 : https://github.com/CharlesKwon/XamlSimplified