146 lines
9.2 KiB
HTML
146 lines
9.2 KiB
HTML
|
<!DOCTYPE html>
|
||
|
|
<html lang="zh-CN">
|
||
|
|
<head>
|
||
|
|
<meta charset="UTF-8">
|
||
|
|
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||
|
|
<title>可选步骤详解 - 自定义设置项与移动端适配</title>
|
||
|
|
<style>
|
||
|
|
:root {
|
||
|
|
--bg-primary: #0a0e1a; --bg-secondary: #111827; --bg-card: #1a2035;
|
||
|
|
--bg-card-hover: #1f2a45; --border-color: #2d3a5c; --text-primary: #e2e8f0;
|
||
|
|
--text-secondary: #94a3b8; --text-muted: #64748b;
|
||
|
|
--accent-purple: #8b5cf6; --accent-purple-light: #a78bfa;
|
||
|
|
--accent-pink: #ec4899; --accent-cyan: #06b6d4;
|
||
|
|
--shadow-lg: 0 10px 40px rgba(0, 0, 0, 0.4);
|
||
|
|
}
|
||
|
|
* { margin: 0; padding: 0; box-sizing: border-box; }
|
||
|
|
body { font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif; background: var(--bg-primary); color: var(--text-primary); line-height: 1.7; padding: 2rem; }
|
||
|
|
.container { max-width: 1000px; margin: 0 auto; }
|
||
|
|
.back-link { display: inline-flex; align-items: center; gap: 0.5rem; color: var(--accent-purple-light); text-decoration: none; margin-bottom: 2rem; padding: 0.5rem 1rem; background: var(--bg-card); border-radius: 8px; border: 1px solid var(--border-color); transition: all 0.2s ease; }
|
||
|
|
.back-link:hover { background: var(--bg-card-hover); transform: translateX(-4px); }
|
||
|
|
.header { background: var(--bg-card); border-radius: 16px; padding: 2rem; margin-bottom: 2rem; border: 1px solid var(--border-color); box-shadow: var(--shadow-lg); border-left: 4px solid var(--accent-purple); }
|
||
|
|
.header h1 { font-size: 2rem; margin-bottom: 0.5rem; }
|
||
|
|
.header .desc { color: var(--text-secondary); font-size: 1rem; }
|
||
|
|
.section { background: var(--bg-card); border-radius: 12px; padding: 1.5rem; margin-bottom: 1.5rem; border: 1px solid var(--border-color); }
|
||
|
|
.section h2 { font-size: 1.3rem; margin-bottom: 1rem; color: var(--accent-purple-light); display: flex; align-items: center; gap: 0.5rem; }
|
||
|
|
.section p { color: var(--text-secondary); margin-bottom: 1rem; }
|
||
|
|
.code-block { background: var(--bg-secondary); padding: 1.25rem; border-radius: 8px; font-family: 'Fira Code', 'Cascadia Code', monospace; font-size: 0.85rem; color: var(--accent-cyan); overflow-x: auto; line-height: 1.6; margin-bottom: 1rem; }
|
||
|
|
.code-block .comment { color: var(--text-muted); }
|
||
|
|
.code-block .keyword { color: var(--accent-purple); }
|
||
|
|
.code-block .string { color: #10b981; }
|
||
|
|
.info-grid { display: grid; grid-template-columns: repeat(auto-fit, minmax(280px, 1fr)); gap: 1rem; margin-top: 1rem; }
|
||
|
|
.info-card { background: var(--bg-secondary); padding: 1rem; border-radius: 8px; border: 1px solid var(--border-color); }
|
||
|
|
.info-card h4 { font-size: 0.9rem; margin-bottom: 0.5rem; color: var(--accent-purple-light); }
|
||
|
|
.info-card p { font-size: 0.85rem; color: var(--text-secondary); margin: 0; }
|
||
|
|
.file-path { font-family: 'Fira Code', monospace; font-size: 0.8rem; color: var(--accent-cyan); background: rgba(6, 182, 212, 0.1); padding: 0.25rem 0.5rem; border-radius: 4px; }
|
||
|
|
ul { list-style: none; padding: 0; }
|
||
|
|
ul li { padding: 0.4rem 0; color: var(--text-secondary); display: flex; align-items: flex-start; gap: 0.5rem; }
|
||
|
|
ul li::before { content: "▸"; color: var(--accent-purple); flex-shrink: 0; }
|
||
|
|
.optional-badge { display: inline-block; background: linear-gradient(135deg, #8b5cf6 0%, #7c3aed 100%); color: white; padding: 0.2rem 0.8rem; border-radius: 20px; font-size: 0.75rem; font-weight: 600; }
|
||
|
|
</style>
|
||
|
|
</head>
|
||
|
|
<body>
|
||
|
|
<div class="container">
|
||
|
|
<a href="../../物料组件添加流程.html" class="back-link">← 返回主文档</a>
|
||
|
|
<div class="header">
|
||
|
|
<span class="optional-badge">可选步骤</span>
|
||
|
|
<h1 style="margin-top: 0.75rem;">自定义设置项与移动端适配</h1>
|
||
|
|
<p class="desc">纯物料组件通常不需要这些步骤，仅在特定需求下才需要</p>
|
||
|
|
</div>
|
||
|
|
|
||
|
|
<!-- 自定义设置项 -->
|
||
|
|
<div class="section">
|
||
|
|
<h2>🎨 自定义右侧设置项组件</h2>
|
||
|
|
<p>如果物料组件需要自定义的右侧属性面板设置项（非 form-create 内置组件），需要额外完成以下步骤：</p>
|
||
|
|
|
||
|
|
<h3 style="margin-top: 1.5rem; margin-bottom: 0.75rem; color: var(--accent-cyan);">涉及文件</h3>
|
||
|
|
<div class="info-grid">
|
||
|
|
<div class="info-card">
|
||
|
|
<h4>1. 定义 SettingType</h4>
|
||
|
|
<p><span class="file-path">packages/types/form-designer/SettingType.ts</span><br>添加 SettingTypeEnum 新值</p>
|
||
|
|
</div>
|
||
|
|
<div class="info-card">
|
||
|
|
<h4>2. 注册设置项组件</h4>
|
||
|
|
<p><span class="file-path">packages/form-designer/src/config/RegisterSettings.ts</span><br>映射 SettingType → Vue 组件</p>
|
||
|
|
</div>
|
||
|
|
<div class="info-card">
|
||
|
|
<h4>3. 创建 settings-helper</h4>
|
||
|
|
<p><span class="file-path">packages/form-designer/src/config/settings-helper/<组件名>.ts</span><br>定义设置项 schema 和逻辑</p>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
|
||
|
|
<h3 style="margin-top: 1.5rem; margin-bottom: 0.75rem; color: var(--accent-cyan);">何时需要</h3>
|
||
|
|
<ul>
|
||
|
|
<li>需要使用自定义 Vue 组件作为属性编辑器（非 input/select 等内置控件）</li>
|
||
|
|
<li>属性面板需要复杂交互（如弹窗选择、级联选择、自定义表格等）</li>
|
||
|
|
<li>普通物料组件使用 form-create 内置控件即可，不需要此步骤</li>
|
||
|
|
</ul>
|
||
|
|
</div>
|
||
|
|
|
||
|
|
<!-- 移动端适配 -->
|
||
|
|
<div class="section">
|
||
|
|
<h2>📱 移动端适配</h2>
|
||
|
|
<p>如果页面 clientType 需要移动端，需在 widget-mobile 目录下创建镜像配置：</p>
|
||
|
|
|
||
|
|
<h3 style="margin-top: 1.5rem; margin-bottom: 0.75rem; color: var(--accent-cyan);">涉及文件</h3>
|
||
|
|
<div class="info-grid">
|
||
|
|
<div class="info-card">
|
||
|
|
<h4>1. 移动端 Vue 组件</h4>
|
||
|
|
<p><span class="file-path">packages/form-designer/src/widget-mobile/config/widget/<组件名>.vue</span></p>
|
||
|
|
</div>
|
||
|
|
<div class="info-card">
|
||
|
|
<h4>2. 移动端 Helper</h4>
|
||
|
|
<p><span class="file-path">packages/form-designer/src/widget-mobile/config/widget-helper/<组件名>Helper.ts</span></p>
|
||
|
|
</div>
|
||
|
|
<div class="info-card">
|
||
|
|
<h4>3. 移动端注册（必要时）</h4>
|
||
|
|
<p><span class="file-path">packages/form-designer/src/widget-mobile/config/RegisterWidget.ts</span><br><span class="file-path">RegisterWidgetHelper.ts</span><br><span class="file-path">Material.ts</span></p>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
|
||
|
|
<h3 style="margin-top: 1.5rem; margin-bottom: 0.75rem; color: var(--accent-cyan);">何时需要</h3>
|
||
|
|
<ul>
|
||
|
|
<li>页面 clientType 包含移动端</li>
|
||
|
|
<li>该物料明确要在移动端表单/列表/卡片视图里使用</li>
|
||
|
|
<li>该组件在移动端运行时必须能编辑/回显</li>
|
||
|
|
</ul>
|
||
|
|
</div>
|
||
|
|
|
||
|
|
<!-- 过滤器/列表支持 -->
|
||
|
|
<div class="section">
|
||
|
|
<h2>🔍 过滤器 / 列表 / 单据体支持</h2>
|
||
|
|
<p>如果物料组件需要进入过滤器、列表或单据体体系：</p>
|
||
|
|
|
||
|
|
<h3 style="margin-top: 1.5rem; margin-bottom: 0.75rem; color: var(--accent-cyan);">涉及文件</h3>
|
||
|
|
<div class="info-grid">
|
||
|
|
<div class="info-card">
|
||
|
|
<h4>1. 过滤器类型</h4>
|
||
|
|
<p><span class="file-path">packages/types/form-designer/components/filter/constants.ts</span><br>添加 FilterTypeEnum</p>
|
||
|
|
</div>
|
||
|
|
<div class="info-card">
|
||
|
|
<h4>2. 过滤器组件映射</h4>
|
||
|
|
<p><span class="file-path">packages/form-designer/src/components/filter/constants.ts</span><br>添加过滤器组件映射</p>
|
||
|
|
</div>
|
||
|
|
<div class="info-card">
|
||
|
|
<h4>3. 列表只读渲染</h4>
|
||
|
|
<p><span class="file-path">packages/form-designer/src/config/widget/table/FieldViewMap.ts</span><br>添加列表/单据体详情只读映射</p>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
|
||
|
|
<h3 style="margin-top: 1.5rem; margin-bottom: 0.75rem; color: var(--accent-cyan);">何时需要</h3>
|
||
|
|
<ul>
|
||
|
|
<li>组件需要作为过滤器条件输入</li>
|
||
|
|
<li>组件需要在列表单元格中只读展示</li>
|
||
|
|
<li>组件需要在单据体详情中展示</li>
|
||
|
|
</ul>
|
||
|
|
</div>
|
||
|
|
|
||
|
|
<div class="section" style="border-left: 4px solid var(--accent-pink);">
|
||
|
|
<h2>💡 总结</h2>
|
||
|
|
<p>对于<strong>普通纯物料组件</strong>（如 CommonBtn、CommonTxt、GroupPanel），以上步骤<strong>都可以跳过</strong>。</p>
|
||
|
|
<p style="margin-top: 0.5rem;">只有在组件有特定复杂需求时，才需要按需补充这些可选步骤。</p>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
</body>
|
||
|
|
</html>
|