DOM structure and Rime update

fcitx-contrib · Oct 1, 2024 · 48f7126 · 48f7126
1 parent a265dcf
commit 48f7126
Show file tree

Hide file tree

Showing 2 changed files with 27 additions and 23 deletions.
diff --git a/docs/im/rime.md b/docs/im/rime.md
@@ -29,10 +29,10 @@ patch:
 ### 预编辑模式
 控制应用程序内的预编辑显示什么。
 
-示例：当您输入 `y` `u`时，
-* 不显示：`yu`位于候选窗内，占据一行；
-* 编辑中文本：`yu`位于应用程序中；
-* 提交预览：假设首选为`与`，则`与`也出现在应用程序中。
+示例：当您输入 `y` `u` 时，
+* 不显示：`yu` 位于候选窗内，占据一行；
+* 编辑中文本：`yu` 位于应用程序中；
+* 提交预览：假设首选为 `与` ，则 `与` 也出现在应用程序中。
 
 ### 共享输入状态
 是否将当前程序的输入状态带到下一个程序。
@@ -44,10 +44,16 @@ patch:
 ### 将嵌入式预编辑文本的光标固定在开头
 当您在 `主题编辑器` 中启用 `跟随光标` 时，您可能需要启用此选项避免候选窗频繁移动。
 
-### 取消激活输入法时提交当前文本
-当您通过 `Ctrl+Shift_L` 从 Rime 切换到英文键盘时，是否将当前的高亮候选词上屏。
+### 切换输入法时的行为
+当您通过 `Ctrl+Shift_L` 或 `Shift_L` 从 Rime 切换到英文键盘时，如何处理当前输入。
 
-默认情况下，`Shift_L` 也会将 Rime 切换到英文键盘。如果这与您的习惯不符（例如您想将当前的输入码而非高亮词上屏，并切换到 Rime 内部的 ASCII 模式），请在 `全局配置` -> `快捷键` -> `临时在当前和第一个输入法之间切换` 中删除 `Shift_L`。
+示例：当您输入 `c` `d` 后按 `Shift_L`，
+* `清空`：不上屏任何字符；
+* `提交原始字符串`：上屏 `cd`；
+* `提交编辑中文本`：上屏 `c d`；
+* `提交预览`：假设首选为 `程度`，则上屏 `程度`。
+
+如果您在 `全局配置` -> `快捷键` -> `临时在当前和第一个输入法之间切换` 中删除了 `Shift_L`，则该按键将由 Rime 处理，默认行为是切换至 Rime 内部的英文模式。
 
 ### 用户数据目录
 点击将使用 Finder 打开 Rime 用户目录。

diff --git a/docs/theme/css.md b/docs/theme/css.md
@@ -62,29 +62,27 @@
 ## 面板结构
 ```html
 <div class="fcitx-panel fcitx-horizontal-tb">
-  <div class="fcitx-panel-blur-outer fcitx-blur">
-    <div class="fcitx-panel-blur-inner">
-      <div class="fcitx-header">
-        <div class="fcitx-aux-up fcitx-hidden">拼</div>
-        <div class="fcitx-preedit fcitx-hidden"></div>
-      </div>
-      <div class="fcitx-aux-down fcitx-hidden"></div>
-      <div class="fcitx-hoverables fcitx-horizontal fcitx-horizontal-scroll fcitx-mousemoved">
-        <div class="fcitx-candidate fcitx-hoverable"></div>
-        <div class="fcitx-divider"></div>
-        <div class="fcitx-candidate fcitx-hoverable"></div>
-        <div class="fcitx-divider fcitx-divider-paging"></div>
-        <div class="fcitx-paging"></div>
-      </div>
+  <div class="fcitx-panel-blur fcitx-blur">
+    <div class="fcitx-header">
+      <div class="fcitx-aux-up fcitx-hidden">拼</div>
+      <div class="fcitx-preedit fcitx-hidden"></div>
+    </div>
+    <div class="fcitx-aux-down fcitx-hidden"></div>
+    <div class="fcitx-hoverables fcitx-horizontal fcitx-horizontal-scroll fcitx-mousemoved">
+      <div class="fcitx-candidate fcitx-hoverable"></div>
+      <div class="fcitx-divider"></div>
+      <div class="fcitx-candidate fcitx-hoverable"></div>
+      <div class="fcitx-divider fcitx-divider-paging"></div>
+      <div class="fcitx-paging"></div>
     </div>
   </div>
 </div>
 ```
 `fcitx-horizontal-tb`* 表示候选窗的书写模式是按行从上到下，其他可能的值有 `fcitx-vertical-rl` 和 `fcitx-vertical-lr`。
 
-`fcitx-panel-blur-outer` 和 `fcitx-panel-blur-inner` 的作用是为面板提供（可选的）毛玻璃效果。您不应该更改它们的属性，否则可能造成候选窗闪烁。
+`fcitx-panel-blur` 的作用是为面板提供（可选的）毛玻璃效果。仅适用于小企鹅在线版（小企鹅 macOS 版的背景模糊不由 CSS 控制）。
 
-`fcitx-blur`* 拥有 `backdrop-filter: blur(16px)`（半径可在 `主题编辑器` -> `背景` 调节）。该 class 每 40ms 在 `fcitx-panel-blur-outer` 和 `fcitx-panel-blur-inner` 交替出现，原因是当 DOM 结构保持不变时，背景模糊不会重新计算，导致拖动候选窗时毛玻璃失效。
+`fcitx-blur`* 拥有 `backdrop-filter: blur(16px)`（半径可在 `主题编辑器` -> `背景` 调节）。仅适用于小企鹅在线版。
 
 `fcitx-header` 是面板头部，它的子元素 `fcitx-aux-up` 和 `fcitx-preedit` 同一时刻至多一个处于显示状态。