ui-devsimple-viewtheme

# DevSimple 布局 XML 默认 ViewTheme 样式 ## 模块路径（本地优先） | 符号 | 当前值 | |------|--------| | `DEVSIMPLE_ROOT` | `lib/DevSimple` | | `DEVSIMPLE_VALUES` | `{DEVSIMPLE_ROOT}/src/main/res/values` | 存在 `{DEVSIMPLE_ROOT}` 时 **Read 本地 XML**，勿用 WebFetch 代替。根样式全表、继承链、资源文件索引与 grep 维护步骤 → [references/reference.md](references/reference.md)。 ## 何时应用 - 新建或编辑 `res/layout/**/*.xml` 中的控件，需要统一默认宽高与主题习惯时。 - 用户要求为 View 补上 DevSimple / `ViewTheme` 的 `style` 时。 ## 前置假设 - 模块已依赖 DevSimple，R 中可解析 `@style/ViewTheme.*`。 - 样式名是否存在：以 [references/reference.md §根样式表](references/reference.md#根样式表控件向可直接作默认-style) 为准；若存疑或久未同步，在 `{DEVSIMPLE_VALUES}` **grep** `name="ViewTheme.` 后更新 reference（见 reference §扫描与更新）。 ## 核心规则（按顺序执行） 1. **已有 `style`/`android:theme`**：不要覆盖用户显式配置；除非用户明确要求替换。 2. **解析控件「语义类名」**： - XML 为完整类名时取**简单类名**（如 `RecyclerView`）。 - AppCompat / Material：沿继承向平台 Widget 回退，取**第一个在 reference 根样式表中出现的简单类名**。 例：`AppCompatEditText` → `EditText`；`MaterialButton` → `Button`。 3. **ImageView 特例**：`ImageView` / `AppCompatImageView` 一律 `style="@style/ViewTheme.ImageView.FIT_XY"`（不用 `ViewTheme.ImageView` 作默认）。 4. **匹配根样式**：若 reference 根样式表存在 `ViewTheme.<语义类名>`，则 `style="@style/ViewTheme.<语义类名>"`（ImageView 已按上一步处理）。 5. **ViewPager2**：无 `ViewTheme.ViewPager2`；使用 `style="@style/ViewTheme.ViewPager"`。 6. **无匹配**：`style="@style/ViewTheme.View"`。 7. **写法**：`style` 放在标签属性前列（与项目现有 XML 风格一致）。 继承链与常见标签对照 → [references/reference.md §继承链速查](references/reference.md#继承链速查xml-标签--语义类名)。需要 Match / Gravity / 子样式时 → [references/reference.md §子样式命名规律](references/reference.md#子样式命名规律按需拼接)。 ## 示例 ```xml <androidx.core.widget.NestedScrollView style="@style/ViewTheme.NestedScrollView"> <androidx.recyclerview.widget.RecyclerView style="@style/ViewTheme.RecyclerView" /> <androidx.appcompat.widget.AppCompatImageView style="@style/ViewTheme.ImageView.FIT_XY" android:layout_width="match_parent" android:layout_height="120dp" /> <androidx.appcompat.widget.AppCompatEditText style="@style/ViewTheme.EditText" /> </androidx.core.widget.NestedScrollView> ``` 无库内主题的控件： ```xml <androidx.appcompat.widget.SwitchCompat style="@style/ViewTheme.View" android:layout_width="wrap_content" android:layout_height="wrap_content" /> ``` ## 执行清单 - [ ] 已 Read [references/reference.md](references/reference.md) 根样式表（或已 grep `{DEVSIMPLE_VALUES}` 核对）。 - [ ] 未覆盖用户已有 `style`（除非明确要求）。 - [ ] ImageView / ViewPager2 特例已套用。 - [ ] DevSimple 有新增 `ViewTheme` 时，按 reference §扫描与更新 同步 reference，勿只改 SKILL。