XAML or HTML

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