初始化
This commit is contained in:
@@ -438,6 +438,13 @@ interface IBimComponent {
|
||||
- `button-group.md` - ButtonGroup 组件详细文档
|
||||
- `engine.md` - Engine 组件详细文档
|
||||
- `tab.md` - Tab 组件详细文档
|
||||
- `tree.md` - Tree 组件详细文档
|
||||
- `menu.md` - Menu 组件详细文档
|
||||
- `right-key.md` - RightKey 组件详细文档
|
||||
- `collapse.md` - Collapse 组件详细文档
|
||||
- `description.md` - Description 组件详细文档
|
||||
- `measure-panel.md` - MeasurePanel 组件详细文档
|
||||
- `walk-control-panel.md` - WalkControlPanel 组件详细文档
|
||||
|
||||
#### 文档内容结构
|
||||
每个组件文档包含以下部分:
|
||||
@@ -537,9 +544,10 @@ const dialog = engine.dialog.create({
|
||||
| `BimMenu` | `src/components/menu/index.ts` | 通用菜单列表 | `IBimComponent` |
|
||||
| `BimTree` | `src/components/tree/index.ts` | 通用树形组件 | `IBimComponent` |
|
||||
| `BimTab` | `src/components/tab/index.ts` | 固定标签页组件 | `IBimComponent` |
|
||||
| `BimCollapse` | `src/components/collapse/index.ts` | 折叠面板组件 | `IBimComponent` |
|
||||
| `BimDescription` | `src/components/description/index.ts` | 描述列表组件 (Key-Value) | `IBimComponent` |
|
||||
| `MeasurePanel` | `src/components/measure-panel/index.ts` | 测量面板组件(仅 UI) | `IBimComponent` |
|
||||
| `BimCollapse` | `src/components/collapse/index.ts` | 折叠面板组件 | `IBimComponent` |
|
||||
| `BimDescription` | `src/components/description/index.ts` | 描述列表组件 (Key-Value) | `IBimComponent` |
|
||||
| `MeasurePanel` | `src/components/measure-panel/index.ts` | 测量面板组件(仅 UI) | `IBimComponent` |
|
||||
| `WalkControlPanel` | `src/components/walk-control-panel/index.ts` | 漫游控制面板组件 | `IBimComponent` |
|
||||
|
||||
### 4.3 服务类清单
|
||||
|
||||
@@ -548,7 +556,20 @@ const dialog = engine.dialog.create({
|
||||
| `ThemeManager` | `src/services/theme.ts` | 主题管理 | 单例 |
|
||||
| `LocaleManager` | `src/services/locale.ts` | 语言管理 | 单例 |
|
||||
|
||||
### 4.4 事件总线定义
|
||||
### 4.4 工具类清单
|
||||
|
||||
| 工具名称 | 文件路径 | 功能 | 文档路径 |
|
||||
| -------------- | ---------------------------- | ------------------------------ | ----------------------------- |
|
||||
| `IconManager` | `src/utils/icon-manager.ts` | 统一管理所有 SVG 图标资源 | `docs/utils/icon-manager.md` |
|
||||
|
||||
**IconManager 说明**:
|
||||
- 提供 `getIcon(name: string): string` 函数
|
||||
- 所有组件通过该函数获取 SVG 图标字符串
|
||||
- 支持默认图标回退机制
|
||||
- 图标使用 `currentColor` 以支持主题颜色
|
||||
- 详细说明见 `docs/utils/icon-manager.md`
|
||||
|
||||
### 4.5 事件总线定义
|
||||
|
||||
#### 事件类型 (`EngineEvents`)
|
||||
|
||||
@@ -643,7 +664,7 @@ this.on('ui:open-dialog', (payload) => {
|
||||
});
|
||||
```
|
||||
|
||||
### 4.5 核心基类
|
||||
### 4.6 核心基类
|
||||
|
||||
| 类名 | 文件路径 | 功能 | 继承/实现 |
|
||||
| -------------- | --------------------------- | -------------- | ------------------- |
|
||||
@@ -653,9 +674,9 @@ this.on('ui:open-dialog', (payload) => {
|
||||
|
||||
---
|
||||
|
||||
## 4.6 国际化实现指南
|
||||
## 4.7 国际化实现指南
|
||||
|
||||
### 4.6.1 国际化的重要性
|
||||
### 4.7.1 国际化的重要性
|
||||
|
||||
**所有用户可见的文本都必须支持国际化,这是强制要求。**
|
||||
|
||||
@@ -663,7 +684,7 @@ this.on('ui:open-dialog', (payload) => {
|
||||
- 所有 UI 文本必须通过翻译函数获取
|
||||
- 严禁在代码中硬编码任何语言的文本
|
||||
|
||||
### 4.6.2 国际化实现方式
|
||||
### 4.7.2 国际化实现方式
|
||||
|
||||
#### 步骤 1: 在翻译字典中添加键值
|
||||
|
||||
@@ -758,7 +779,7 @@ export class MyComponent implements IBimComponent {
|
||||
}
|
||||
```
|
||||
|
||||
### 4.6.3 国际化注意事项
|
||||
### 4.7.3 国际化注意事项
|
||||
|
||||
#### ✅ 必须做的
|
||||
|
||||
@@ -831,7 +852,7 @@ export class MyComponent implements IBimComponent {
|
||||
- 组件必须响应语言切换
|
||||
- 不能只在初始化时设置文本
|
||||
|
||||
### 4.6.4 国际化最佳实践
|
||||
### 4.7.4 国际化最佳实践
|
||||
|
||||
#### 翻译键的组织结构
|
||||
|
||||
@@ -939,7 +960,7 @@ export class MyDialog implements IBimComponent {
|
||||
};
|
||||
```
|
||||
|
||||
### 4.6.5 国际化检查清单
|
||||
### 4.7.5 国际化检查清单
|
||||
|
||||
在开发新功能时,确保:
|
||||
|
||||
|
||||
Reference in New Issue
Block a user