功能插件
约 517 字大约 2 分钟
...
2026-09-28
分类介绍
功能插件不新增元素,用于增强属性面板、占位符与设计器体验(数据格式化、多语言、控件改写、新手引导等)。
主要使用这些 hook:
getOptionItem:增强属性面板选项getPlaceholderValue:处理占位符取值ready:文档就绪后挂载能力onDesigned:设计器创建完成后挂载能力
| 插件 | 功能 |
|---|---|
| plugin-formatter | 数据格式化(元素级/表格列级/占位符) |
| plugin-text-auto | 文本字号自适应 |
| plugin-i18n | 界面多语言 |
| plugin-options-modify | 改写属性控件(select→number/弹窗多选) |
| plugin-scale | 元素缩放选项 |
| plugin-driver | 新手引导 |
示例代码
注册统一为 await hiprint.register({ plugins: [pluginX(config)] })(hiprint.init 不收插件数组):
import pluginScale from '@sv-print/plugin-scale';
await hiprint.register({ plugins: [pluginScale({ name: '缩放' })] }); // hiprint.init 不收插件数组以 formatter(数据格式化)为例:
import pluginFormatter from '@sv-print/plugin-formatter';
await hiprint.register({
plugins: [
pluginFormatter({
funList: [
// 格式化函数清单(必填)
{ name: '转大写', key: 'toUpperCase', fun: (v) => (v || '').toUpperCase() },
{ name: '金额', key: 'money', fun: (v) => `¥ ${Number(v).toFixed(2)}` },
],
regexList: [
// 占位符字段名按规则匹配后套用同 key 的 fun
{ regex: /(.*)\.upper$/, key: 'toUpperCase' },
{ regex: 'money:?', key: 'money' },
],
}),
],
});各插件文档
版权所有
版权归属:sv-print
