u

code/g3soft-libs/docs/content/ui/usage/rtl.md

@@ -68,6 +68,13 @@ transform: translateX(calc(#{v('dir-sign', 1)} * 12px));
 | `G3Drawer` / `G3Modal` / `G3Tabs` 的 `placement="left \| right"` | 字面 API，指定的是物理边 |
 | 浮层（Popover / Tooltip / Dropdown / Select / DatePicker）的主方向 `left` / `right` | 与 floating-ui 一致：只镜像 `*-start` / `*-end` 的**对齐轴** |
 | 浮层箭头、`left: 50%` 居中、`G3Notification` 的停靠边 | 物理锚定，没有行内语义 |
+| `G3ColorPicker` 的取色区与色相条 | 横轴是**颜色空间**（饱和度 / 色相），不是行内方向；见下 |
+
+`G3ColorPicker` 值得单独说明：它的取色区与色相条底下是 `linear-gradient(to right, …)`，
+这是**物理**方向，`[dir='rtl']` 不会翻转。若只把 JS 的取值方向反向、却不管渐变，
+光标位置就会和它底下的颜色对不上 —— 所以取值与渲染**必须同向**，二者都保持物理左到右。
+颜色空间没有「语言方向」，Photoshop / Figma / 浏览器 DevTools 的取色器在 RTL 下同样不镜像。
+面板其余部分没有左右不对称的物理属性，RTL 下无需额外处理。
 
 另外 `G3Grid` 的 `push` / `pull` 已改为**沿行内方向位移**（跟随方向），
 与 Bootstrap 的物理语义**不同**，迁移时留意。