我的XAML编码规范
作者:chszs,转载需注明。博客主页:http://blog.csdn.net/chszs去年,我们建立了自己的C#编码规范,我说服同事遵循我写的编码规范。或许我是一个偏执狂吧,如果我看到有人不遵守我写的编码规范,而是去修改它,我可能通宵都睡不着。
借助Visual Studio的优秀插件ReSharper,可以很轻松地按照规则对代码进行格式化。你只需按下Ctrl-E / Ctrl-C,就可以对代码文档进行格式化。ReSharper是Visual Studio必备的工具。(图1)
自Windows Phone平台发布的两年以来,我一直使用XAML语言设计用户界面。查看C#的编码习惯是很容易的,但是对于XAML,就很困难了。
下面是Windows存储网格应用项目的例子:
<ListView.GroupStyle>
<GroupStyle>
<GroupStyle.HeaderTemplate>
<DataTemplate>
<Grid Margin="7,7,0,0">
<Button
AutomationProperties.Name="Group Title"
Click="Header_Click"
Style="{StaticResource TextPrimaryButtonStyle}">
<StackPanel Orientation="Horizontal">
<TextBlock Text="{Binding Title}" Margin="3,-7,10,10" Style="{StaticResource GroupHeaderTextStyle}" />
<TextBlock Text="{StaticResource ChevronGlyph}" FontFamily="Segoe UI Symbol" Margin="0,-7,0,10" Style="{StaticResource GroupHeaderTextStyle}"/>
</StackPanel>
</Button>
</Grid>
</DataTemplate>
</GroupStyle.HeaderTemplate>
</GroupStyle>
</ListView.GroupStyle>
首先,没有空行。其次,按钮的属性在不同的行。而对于TextBlock元素,属性却在同一行,且没有任何顺序。
在过了很长一段时间后,我编写了自己的XAML编码规范。其中一个原因是,我不喜欢使用"属性"窗口,因为它很难有一个全面的属性设置,而不是设置为默认。(图2)
我的编码规范可简述为以下5点:
1 元素之间放入空行。
不要担心空行太多,它会使代码更易读。
<Grid Height="250"
VerticalAlignment="Top">
<Image Source="{Binding FeatureArticle1.Thumbnail}"
Style="{StaticResource ImageThumbnailStyle}" />
<StackPanel Style="{StaticResource StackPanelSummaryStyle}">
<TextBlock FontSize="22"
Style="{StaticResource TextBlockAuthorStyle}"
Text="{Binding FeatureArticle1.Author}" />
<TextBlock FontSize="26"
Height="70"
Style="{StaticResource TextBlockSummaryStyle}"
Text="{Binding FeatureArticle1.Title}" />
</StackPanel>
</Grid>
但是只有Grid.ColumnDefinition和Grid.RowDefinitions例外,因为它们只有一行属性。
<Grid.ColumnDefinitions>
<ColumnDefinition Width="200" />
<ColumnDefinition Width="200" />
</Grid.ColumnDefinitions>
<Grid.RowDefinitions>
<RowDefinition Height="200" />
<RowDefinition Height="140" />
</Grid.RowDefinitions>
2 每个属性放一行。
<TextBlock FontWeight="Bold"
Foreground="White"
HorizontalAlignment="Right"
Margin="0,0,12,0"
Text="{Binding ArticlesCountText}"
TextWrapping="Wrap" />
3 属性按字母表排序。
<Image Source="/Assets/Shares/NeutralImage.png"
Height="125"
HorizontalAlignment="Center"
Width="125"
Stretch="UniformToFill"
VerticalAlignment="Center" />
有人说,高度Height和宽度Width应该放在一起,但作者还是喜欢按字母表顺序对属性排序。作者认为这更容易检查是否有属性设置漏了。
4 把附加属性放在起始位置并以字母表顺序放置。
<Button Grid.Column="1"
Grid.Row="2"
Command="{Binding ShowWriterCommand}"
CommandParameter="{Binding WriterAshley}"
Style="{StaticResource HubTileButtonStyle}" />
5 样式的定义可以不用那么严格。
当使用Expression Blend创建样式时,作者倾向于留下更大的空间,减少限制。这样的话,会节省很多时间。
<Style x:Key="GridFeatureStyle"
TargetType="Grid">
<Setter Property="Height"
Value="194" />
<Setter Property="VerticalAlignment"
Value="Top" />
<Setter Property="Width"
Value="194" />
</Style>
结论
这可能并非完美的解决方案,但如果你遵循它的话,这是一个良好的开端,特别是在团队协作的时候。
分享到:
相关推荐
wpf 项目从2010 升级为2012 常碰到的问题,自己写段小代码比埋怨实在多
xaml转换成html/xaml转换成html/xaml转换成html/xaml转换成html/xaml转换成html/xaml转换成html
XAML语法,具有Silverlight, WPF, Windows Phone以及Windows 8开发经验的程序员,可以将开发技能再利用,加快学习速度,提高开发效率 语言性能强大,学习曲线平缓, 有强大的开发工具支持 XAML是Windows 8 Style风格...
这个x就是XAML的字头了 这个名称空间的本意就是告诉我们 这个名称空间里所装的元素都与XAML解析有关 比如 我在代码里还使用了x:Code 把本来应该呆在C#代码里的内容请到XAML里来了 5 <Window x:Class < 只...
Xamarin XAML语言教程
XAML入门,doc文档很适合xaml初学者学习
适合初步接触xaml的新手入门,作为一部字典使用xaml中的细节
The cornerstone for building these new user interfaces is XAML ("Zammel"), the XML-based markup language that works with Windows Presentation Foundation (WPF), Vista's new graphics subsystem. <br>...
主要描述XAML是什么,怎么用及对XAML进行剖析
将Adobe Illustrator设计图转换为XAML的插件(拷贝至Plug-ins目录下即可)
SWF转换为XAML的好工具
.Net反编译工具,可以查看XAML。.Net反编译工具,可以查看XAML。
XAML-基础教程 pdf格式, 好东西,就不介绍了
wpf xaml 数据binding 简单例子
.xaml设置显示行号
示例描述:本章介绍了XAML的语法,包括原理、使用方法以及事件处理等等。 AttachedProperty 使用XAML中的附加属性。 CodebehindDemo 使用XAML中的后置代码文件编写程序代码。 LooseXaml 松散XAML示例。 ...
xaml 介绍xaml的好书
XML&XAML基础教程,帮你理解 XML XAML 概念 概述 语法
ILSpy中baml转化为xaml的改进 ILSpy虽然能反编译WPF baml文件,但当我们另存为时,得到的baml文件。很不方便。加了一段代码解决了,这个可执行程序。代码见相关资源.文章见: ILSpy中baml转化为xaml的改进 ...
演示了Wpf动态加载Xaml的3D模型文件,并实现3D模型的旋转、移动、放大等,适合Wpf进行3D开发的人学习和参考