diff --git a/docs/controls/desktop/data-entry/auto-complete/semantic-part.md b/docs/controls/desktop/data-entry/auto-complete/semantic-part.md index 8d2e2177b..e7d1b9fbe 100644 --- a/docs/controls/desktop/data-entry/auto-complete/semantic-part.md +++ b/docs/controls/desktop/data-entry/auto-complete/semantic-part.md @@ -5,11 +5,11 @@ [AutoComplete 桌面版实现原理](implementation.md),系统级规则见 [AtomUI Semantic Part 系统设计](../../../../architecture/systems/theming/semantic-parts.md)。 -## 1. Owner 与 Part 总览 +## 1. Semantic Parts 总览 AutoComplete 家族有三个 public owner:`AutoComplete`、`AutoCompleteSearchEdit` 与 `AutoCompleteTextArea`。三者 声明完全相同的 9 个语义键:`root`、`prefix`、`content`、`placeholder`、`input`、`clear`、`popup.root`、 -`popup.list`、`popup.listItem`(与上游 Ant Design AutoComplete 的语义 DOM 对齐,`popup.*` 对应上游 `popup` +`popup.list`、`popup.listItem`(与上游 AutoComplete 的语义 DOM 对齐,`popup.*` 对应上游 `popup` 分组的 `root` / `list` / `listItem`)。声明位于各 owner 同目录的 `*.SemanticParts.cs` partial 文件。 前 6 个宿主部件位于输入框模板内,且全部声明 `CrossNestedOwners=true`:`AutoCompleteSearchEdit` / diff --git a/docs/controls/desktop/data-entry/cascader/overview.md b/docs/controls/desktop/data-entry/cascader/overview.md index 6dce21609..e98d67832 100644 --- a/docs/controls/desktop/data-entry/cascader/overview.md +++ b/docs/controls/desktop/data-entry/cascader/overview.md @@ -4,7 +4,7 @@ 该控件的 Popup 钉住打开属于共享弹层契约,详见 [Popup 钉住打开设计](../../other/popup/popup-pinned-open-design.md)。`AbstractSelect` 提供 public `IsPopupPinnedOpen`:设置为 true 时保持 `IsDropDownOpen` 并 relay 到 `PART_Popup`;Cascader 在弹层打开前依据钉住状态抑制 light-dismiss 遮罩,取消钉住后恢复模板默认值,使 Gallery 语义预览等场景可以持续展示 `popup.*` 部件。控件卸载、锚点失效、TopLevel 改变和模板重建仍按共享生命周期规则清理。 -Cascader 公开 13 个 Semantic Part(`root`、`prefix`、`content`、`placeholder`、`input`、`suffix`、`clear`、`item`、`itemContent`、`itemRemove`、`popup.root`、`popup.list`、`popup.listItem`),与 Ant Design Cascader 的 Semantic Part 语义对齐;完整 Part 表、Selector 用法与定制边界见 [Cascader Semantic Part 契约](semantic-part.md)。 +Cascader 公开 13 个 Semantic Part(`root`、`prefix`、`content`、`placeholder`、`input`、`suffix`、`clear`、`item`、`itemContent`、`itemRemove`、`popup.root`、`popup.list`、`popup.listItem`),与上游 Cascader 的 Semantic Part 语义对齐;完整 Part 表、Selector 用法与定制边界见 [Cascader Semantic Part 契约](semantic-part.md)。 ## 1. 控件定位 diff --git a/docs/controls/desktop/data-entry/cascader/semantic-part.md b/docs/controls/desktop/data-entry/cascader/semantic-part.md index cf7850f87..93c6cff5c 100644 --- a/docs/controls/desktop/data-entry/cascader/semantic-part.md +++ b/docs/controls/desktop/data-entry/cascader/semantic-part.md @@ -7,7 +7,7 @@ ## 1. Semantic Parts -Cascader 是唯一 Semantic owner,公开 13 个 Semantic Part(与 Ant Design Cascader 的 Semantic Part +Cascader 是唯一 Semantic owner,公开 13 个 Semantic Part(与上游 Cascader 的 Semantic Part 语义对齐:`item` / `itemContent` / `itemRemove` 对应上游多选标签的 `item` 分组,`popup.*` 对应上游 `popup` 分组的 `root` / `list` / `listItem`)。声明位于 `Cascader.SemanticParts.cs` partial 文件。