提交用户部分代码
This commit is contained in:
1 parent
9b9e4cbd82
commit
127fc22de5
26 files changed
+1110
-206
No files matched your search
@@ -6,6 +6,8 @@ globs: "**/*.xaml"
|
||||
|
||||
# XAML 视图编写约定
|
||||
|
||||
项目 XAML 默认不添加 `AutomationProperties.Name`。
|
||||
|
||||
## View XAML 头部模板
|
||||
|
||||
```XML
|
||||
@@ -13,6 +15,8 @@ globs: "**/*.xaml"
|
||||
x:Class="xxxxx.(xxxx)?.Views.XxxView"
|
||||
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
|
||||
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
|
||||
xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
|
||||
xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
|
||||
xmlns:local="clr-namespace:xxxx.(xxxx)?.Views"
|
||||
xmlns:core="MAX.Core"
|
||||
xmlns:hc="https://handyorg.github.io/handycontrol"
|
||||
@@ -23,20 +27,26 @@ globs: "**/*.xaml"
|
||||
d:DataContext="{d:DesignInstance Type=local:XxxViewModel}"
|
||||
d:Background="White"
|
||||
d:DesignHeight="450"
|
||||
d:DesignWidth="800">
|
||||
d:DesignWidth="800"
|
||||
mc:Ignorable="d"
|
||||
>
|
||||
```
|
||||
|
||||
## Dialog View XAML
|
||||
|
||||
```XML
|
||||
<UserControl
|
||||
xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
|
||||
xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
|
||||
xmlns:core="MAX.Core"
|
||||
xmlns:hc="https://handyorg.github.io/handycontrol"
|
||||
xmlns:wpf="MAX.WPF"
|
||||
d:Background="White"
|
||||
d:DataContext="{d:DesignInstance Type=local:DialogViewModel}"
|
||||
Style="{StaticResource DialogStyle.Base}"
|
||||
DataContext="{core:DISource Type=local:DialogViewModel}">
|
||||
DataContext="{core:DISource Type=local:DialogViewModel}"
|
||||
mc:Ignorable="d"
|
||||
>
|
||||
```
|
||||
|
||||
- `{core:DISource Type=local:XxxViewModel}` 绑定 ViewModel
|
||||
@@ -47,9 +57,12 @@ DataContext="{core:DISource Type=local:DialogViewModel}">
|
||||
|
||||
### 控件必须有设计数据
|
||||
|
||||
例如
|
||||
TextBlock > d:Text="TextBlock"
|
||||
ComboBox > d:ItemsSource="{d:SampleData ItemCount=5}"
|
||||
页面、弹窗和 `DataTemplate` 应能在 XAML 设计器中直接看出字段内容、排列方向、对齐和间距。设计值使用 `d:` 命名空间,根元素声明 `xmlns:d`、`xmlns:mc` 和 `mc:Ignorable="d"`,保留运行时绑定。
|
||||
|
||||
- `TextBox`、`TextBlock` 的文本来自绑定或默认为空时,必须设置有业务含义的非空示例,如 `d:Text="示例商贸有限公司"`。静态文案已可见时无需重复填写。
|
||||
- 绑定集合的 `ItemsControl`、`ListBox`、`ComboBox`、`DataGridEx` 等必须提供设计时数据,默认使用 `d:ItemsSource="{d:SampleData ItemCount=5}"`。行数可按实际布局调整。下拉框要预览选中项时可加 `d:SelectedIndex="0"`。
|
||||
- 其他控件按实际显示属性提供设计值,例如绑定标题的 `wpf:TitleContent` 用 `d:Title="中转仓快递费(元/单)"`,金额输入框用 `d:Value="2.20"`,绑定按钮文案用 `d:Content="保存"`。运行时按状态显示的区域,可用 `d:Visibility="Visible"` 预览。
|
||||
- 集合模板既要能看到多行,也要能看清每行内容。若样本数据未填充自定义控件的显示属性,在模板内补相应的 `d:` 值。
|
||||
|
||||
## BindingProxy + CommandProxy(DataTemplate/ContextMenu 绑定)
|
||||
|
||||
@@ -284,12 +297,27 @@ C# 侧:`"#FF5733".toColor()`、`"#80000000".toColor()`。
|
||||
- 需要行列划分、跨行跨列、重叠或虚拟化时,使用满足这些要求的布局容器,不强行替换为 `SpacingStackPanel`。
|
||||
- 属性及用法见 [max-common-wpf SpacingStackPanel 参考](../skills/max-common-wpf/references/api.md#controlsspacingstackpanelcs)。
|
||||
|
||||
### ItemsControl 的顺序排版
|
||||
|
||||
少量集合项按行或列顺序排列时,必须在 `ItemsControl.ItemsPanel` 的 `ItemsPanelTemplate` 中使用 `wpf:SpacingStackPanel`。项与项之间的间距由这个面板控制;`ItemTemplate` 负责单项内部布局。优先复用已有间距样式,例如计费弹窗的 `VerticalSpacingPanel4`。需要虚拟化的长列表保留虚拟化面板。
|
||||
|
||||
```xml
|
||||
<ItemsControl ItemsSource="{Binding Fields, Mode=OneWay}"
|
||||
d:ItemsSource="{d:SampleData ItemCount=5}">
|
||||
<ItemsControl.ItemsPanel>
|
||||
<ItemsPanelTemplate>
|
||||
<wpf:SpacingStackPanel Style="{StaticResource VerticalSpacingPanel4}" />
|
||||
</ItemsPanelTemplate>
|
||||
</ItemsControl.ItemsPanel>
|
||||
</ItemsControl>
|
||||
```
|
||||
|
||||
## 文字与简单内容布局
|
||||
|
||||
**页面排版遇到“说明文字 + 简单内容”(如输入框、选择器、按钮等输入或点击控件)时,优先使用 `wpf:TitleContent`。** 将说明文字放在 `Title`,交互控件作为内容,避免为同一组合另用 `TextBlock` 配合 `Grid` / `StackPanel` 手工拼接。
|
||||
|
||||
- 按布局设置 `Placement`;左侧标题表单优先使用 `Placement="Left"`,并按需设置 `TitleWidth`、`TitleVerticalAlignment="Center"` 和 `LeftTitlePadding`,保持同组字段对齐。
|
||||
- 内容控件仍自行配置绑定、命令、输入长度和可访问名称;`TitleContent` 只负责标题与内容的布局。
|
||||
- 内容控件仍自行配置绑定、命令和输入长度;`TitleContent` 只负责标题与内容的布局。
|
||||
- 属性及用法见 [max-common-wpf TitleContent 参考](../skills/max-common-wpf/references/api.md#controlstitlecontentcs)。
|
||||
|
||||
## 布局注释
|
||||
|
||||
Reference in new issue
Block a user