diff --git a/i18n/zh-Hans/docusaurus-plugin-content-docs/current/basics/user-interface/styling/container-queries.md b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/basics/user-interface/styling/container-queries.md
new file mode 100644
index 000000000..84d2c81a3
--- /dev/null
+++ b/i18n/zh-Hans/docusaurus-plugin-content-docs/current/basics/user-interface/styling/container-queries.md
@@ -0,0 +1,160 @@
+---
+id: container-queries
+title: 容器查询
+---
+
+# 容器查询
+
+容器查询允许根据作为容器的祖先元素的大小来激活控件的样式。
+
+:::tip
+Avalonia 的容器查询类似于 CSS 的容器查询，但功能更有限，以适应 Avalonia 支持的平台和外形样式。如果将 Toplevel 设置为容器，它们也可以像媒体查询一样工作。
+:::
+
+## 工作原理
+
+容器查询依赖于将祖先控件设置成容器。容器大小的更改会根据查询激活样式。这些查询可以检查容器的宽度或高度，或两者兼而有之。任何控件都可以是容器，但设置为容器的控件不能受链接到它的容器查询所托管的样式的影响。当查询被激活时，查询中托管的所有样式也将根据其选择器被激活。
+
+## 如何使用查询
+
+### 声明容器查询
+容器查询可以在 XAML 中定义为控件 `Styles` 属性的直接子元素，如下所示：
+
+```xml
+
+
+
+
+
+
+```
+
+它们也可以是 `ControlTheme` 样式的一部分：
+
+```xml
+
+ ...
+
+
+
+
+ ...
+
+
+
+
+
+
+
+
+
+
+```
+`Name` 属性定义了它将附加到的容器的名称。这不是一个唯一的标识符，多个容器查询可以使用相同的名称。
+`Query` 定义了激活包含大小的规则。请参阅下面的[查询](#查询)。
+
+这使得它们在针对不同屏幕尺寸的主题，或根据其父元素中可用空间而具有不同形式的主题中非常易于使用。这带来了一些限制。
+1. 容器查询不能托管在 `Style` 元素中。
+ 以下是无效的。
+```xml
+
+
+
+
+
+
+```
+2. 在查询中声明的样式不能影响容器或其祖先。这与能够影响其父控件的普通 `Styles` 不同。因为容器查询依赖于容器的实际大小，让容器受到其查询激活的样式的影响可能会导致循环行为，即容器的大小被两个或多个查询连续更新。
+
+### 声明容器
+只有当作为 `ContainerQuery` 主机后代的控件被声明为容器时，容器查询才起作用。设置任何控件的 `Container.Name` 和 `Container.Sizing` 附加属性将声明该控件为容器，如下所示：
+
+```xml
+