kyle-editor 1.0.7 → 1.0.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -4,18 +4,24 @@ import { KEditor as KEditor2 } from "kyle-editor";
4
4
  const KEditorVue = {
5
5
  name: "KEditor",
6
6
  props: {
7
- modelValue: { type: String, default: "" },
7
+ // 不给默认值:v-model 未绑定 / 被赋 undefined 时必须保持 undefined,
8
+ // 否则会被兜成 '' 进而把正文清空(区分「空字符串 = 清空」与「undefined = 没给值」)
9
+ modelValue: { type: String },
8
10
  options: { type: Object, default: () => ({}) },
9
11
  disabled: { type: Boolean, default: false },
10
- height: { type: Number, default: null }
12
+ // 内容区高度:不传 = 自适应内容;传 px 固定;'auto' 同不传
13
+ height: { type: [Number, String], default: null }
11
14
  },
12
15
  emits: ["update:modelValue", "ready", "change", "upload", "error", "save", "blur", "focus"],
13
16
  setup(props, { emit, expose }) {
14
17
  const host = ref(null);
15
18
  const instance = shallowRef(null);
19
+ let warnedModel = false;
16
20
  const buildOptions = () => {
17
- const opts = { ...defaults, ...props.options, value: props.modelValue || "" };
18
- if (props.height) opts.height = props.height;
21
+ const opts = { ...props.options };
22
+ const model = typeof props.modelValue === "string" ? props.modelValue : "";
23
+ opts.value = model || opts.value || "";
24
+ if (props.height !== null && props.height !== "" && props.height !== void 0) opts.height = props.height;
19
25
  opts.onChange = (html) => {
20
26
  emit("update:modelValue", html);
21
27
  emit("change", html);
@@ -29,26 +35,140 @@ const KEditorVue = {
29
35
  get editor() {
30
36
  return instance.value;
31
37
  },
32
- getHTML: () => {
38
+ get root() {
33
39
  var _a;
34
- return ((_a = instance.value) == null ? void 0 : _a.getHTML()) || "";
40
+ return ((_a = instance.value) == null ? void 0 : _a.root) || null;
41
+ },
42
+ /* 读取 */
43
+ getHTML: (options) => {
44
+ var _a;
45
+ return ((_a = instance.value) == null ? void 0 : _a.getHTML(options)) ?? "";
35
46
  },
36
47
  getText: () => {
37
48
  var _a;
38
- return ((_a = instance.value) == null ? void 0 : _a.getText()) || "";
49
+ return ((_a = instance.value) == null ? void 0 : _a.getText()) ?? "";
50
+ },
51
+ getJSON: () => {
52
+ var _a;
53
+ return ((_a = instance.value) == null ? void 0 : _a.getJSON()) ?? null;
39
54
  },
40
55
  counts: () => {
41
56
  var _a;
42
- return ((_a = instance.value) == null ? void 0 : _a.counts()) || null;
57
+ return ((_a = instance.value) == null ? void 0 : _a.counts()) ?? null;
58
+ },
59
+ markdownOptions: () => {
60
+ var _a;
61
+ return ((_a = instance.value) == null ? void 0 : _a.markdownOptions()) ?? null;
62
+ },
63
+ /* 内容 */
64
+ setContent: (html, options) => {
65
+ var _a;
66
+ return (_a = instance.value) == null ? void 0 : _a.setContent(html, options);
67
+ },
68
+ clear: () => {
69
+ var _a;
70
+ return (_a = instance.value) == null ? void 0 : _a.clear();
43
71
  },
44
72
  focus: () => {
45
73
  var _a;
46
74
  return (_a = instance.value) == null ? void 0 : _a.focus();
47
75
  },
48
- setContent: (html) => {
76
+ blur: () => {
77
+ var _a;
78
+ return (_a = instance.value) == null ? void 0 : _a.blur();
79
+ },
80
+ undo: () => {
81
+ var _a;
82
+ return (_a = instance.value) == null ? void 0 : _a.undo();
83
+ },
84
+ redo: () => {
85
+ var _a;
86
+ return (_a = instance.value) == null ? void 0 : _a.redo();
87
+ },
88
+ setReadOnly: (value) => {
49
89
  var _a;
50
- return (_a = instance.value) == null ? void 0 : _a.setContent(html);
90
+ return (_a = instance.value) == null ? void 0 : _a.setReadOnly(value);
91
+ },
92
+ /* Markdown 导入 */
93
+ importMarkdown: (source, options) => {
94
+ var _a;
95
+ return (_a = instance.value) == null ? void 0 : _a.importMarkdown(source, options);
96
+ },
97
+ setMarkdown: (source, options) => {
98
+ var _a;
99
+ return (_a = instance.value) == null ? void 0 : _a.setMarkdown(source, options);
100
+ },
101
+ insertMarkdown: (source, options) => {
102
+ var _a;
103
+ return (_a = instance.value) == null ? void 0 : _a.insertMarkdown(source, options);
104
+ },
105
+ appendMarkdown: (source, options) => {
106
+ var _a;
107
+ return (_a = instance.value) == null ? void 0 : _a.appendMarkdown(source, options);
108
+ },
109
+ moveCaretToEnd: () => {
110
+ var _a;
111
+ return (_a = instance.value) == null ? void 0 : _a.moveCaretToEnd();
112
+ },
113
+ /* 插入 */
114
+ appendHTML: (html) => {
115
+ var _a;
116
+ return (_a = instance.value) == null ? void 0 : _a.appendHTML(html);
117
+ },
118
+ insertImage: (url, alt) => {
119
+ var _a;
120
+ return (_a = instance.value) == null ? void 0 : _a.insertImage(url, alt);
51
121
  },
122
+ insertVideo: (url, label) => {
123
+ var _a;
124
+ return (_a = instance.value) == null ? void 0 : _a.insertVideo(url, label);
125
+ },
126
+ insertCode: (code, lang) => {
127
+ var _a;
128
+ return (_a = instance.value) == null ? void 0 : _a.insertCode(code, lang);
129
+ },
130
+ codeLanguages: () => {
131
+ var _a;
132
+ return ((_a = instance.value) == null ? void 0 : _a.codeLanguages()) ?? [];
133
+ },
134
+ highlightCode: () => {
135
+ var _a;
136
+ return (_a = instance.value) == null ? void 0 : _a.highlightCode();
137
+ },
138
+ upload: (file, kind) => {
139
+ var _a;
140
+ return (_a = instance.value) == null ? void 0 : _a.upload(file, kind);
141
+ },
142
+ cancelUploads: () => {
143
+ var _a;
144
+ return (_a = instance.value) == null ? void 0 : _a.cancelUploads();
145
+ },
146
+ /* 按钮 */
147
+ addButton: (button) => {
148
+ var _a;
149
+ return (_a = instance.value) == null ? void 0 : _a.addButton(button);
150
+ },
151
+ removeButton: (name) => {
152
+ var _a;
153
+ return (_a = instance.value) == null ? void 0 : _a.removeButton(name);
154
+ },
155
+ moveButton: (name, position) => {
156
+ var _a;
157
+ return (_a = instance.value) == null ? void 0 : _a.moveButton(name, position);
158
+ },
159
+ setButtonOptions: (name, items) => {
160
+ var _a;
161
+ return (_a = instance.value) == null ? void 0 : _a.setButtonOptions(name, items);
162
+ },
163
+ getButtonValue: (name) => {
164
+ var _a;
165
+ return (_a = instance.value) == null ? void 0 : _a.getButtonValue(name);
166
+ },
167
+ setButtonValue: (name, value) => {
168
+ var _a;
169
+ return (_a = instance.value) == null ? void 0 : _a.setButtonValue(name, value);
170
+ },
171
+ /* 视图 */
52
172
  enterSource: () => {
53
173
  var _a;
54
174
  return (_a = instance.value) == null ? void 0 : _a.enterSource();
@@ -56,6 +176,23 @@ const KEditorVue = {
56
176
  openPreview: () => {
57
177
  var _a;
58
178
  return (_a = instance.value) == null ? void 0 : _a.openPreview();
179
+ },
180
+ setHeight: (height) => {
181
+ var _a;
182
+ return (_a = instance.value) == null ? void 0 : _a.setHeight(height);
183
+ },
184
+ setPaper: (paper) => {
185
+ var _a;
186
+ return (_a = instance.value) == null ? void 0 : _a.setPaper(paper);
187
+ },
188
+ /* 事件 */
189
+ on: (name, handler) => {
190
+ var _a;
191
+ return (_a = instance.value) == null ? void 0 : _a.on(name, handler);
192
+ },
193
+ off: (name, handler) => {
194
+ var _a;
195
+ return (_a = instance.value) == null ? void 0 : _a.off(name, handler);
59
196
  }
60
197
  });
61
198
  onMounted(() => {
@@ -76,8 +213,15 @@ const KEditorVue = {
76
213
  (value) => {
77
214
  const editor = instance.value;
78
215
  if (!editor || editor.sourceMode) return;
216
+ if (typeof value !== "string") {
217
+ if (value != null && !warnedModel) {
218
+ warnedModel = true;
219
+ console.warn("[KEditor] v-model 只接受 HTML 字符串,本次非字符串赋值已忽略:", value);
220
+ }
221
+ return;
222
+ }
79
223
  if (value === editor.getHTML()) return;
80
- editor.setContent(value || "", { silent: true });
224
+ editor.setContent(value, { silent: true });
81
225
  }
82
226
  );
83
227
  watch(
@@ -5,18 +5,24 @@
5
5
  const KEditorVue = {
6
6
  name: "KEditor",
7
7
  props: {
8
- modelValue: { type: String, default: "" },
8
+ // 不给默认值:v-model 未绑定 / 被赋 undefined 时必须保持 undefined,
9
+ // 否则会被兜成 '' 进而把正文清空(区分「空字符串 = 清空」与「undefined = 没给值」)
10
+ modelValue: { type: String },
9
11
  options: { type: Object, default: () => ({}) },
10
12
  disabled: { type: Boolean, default: false },
11
- height: { type: Number, default: null }
13
+ // 内容区高度:不传 = 自适应内容;传 px 固定;'auto' 同不传
14
+ height: { type: [Number, String], default: null }
12
15
  },
13
16
  emits: ["update:modelValue", "ready", "change", "upload", "error", "save", "blur", "focus"],
14
17
  setup(props, { emit, expose }) {
15
18
  const host = vue.ref(null);
16
19
  const instance = vue.shallowRef(null);
20
+ let warnedModel = false;
17
21
  const buildOptions = () => {
18
- const opts = { ...kyleEditor.defaults, ...props.options, value: props.modelValue || "" };
19
- if (props.height) opts.height = props.height;
22
+ const opts = { ...props.options };
23
+ const model = typeof props.modelValue === "string" ? props.modelValue : "";
24
+ opts.value = model || opts.value || "";
25
+ if (props.height !== null && props.height !== "" && props.height !== void 0) opts.height = props.height;
20
26
  opts.onChange = (html) => {
21
27
  emit("update:modelValue", html);
22
28
  emit("change", html);
@@ -30,26 +36,140 @@
30
36
  get editor() {
31
37
  return instance.value;
32
38
  },
33
- getHTML: () => {
39
+ get root() {
34
40
  var _a;
35
- return ((_a = instance.value) == null ? void 0 : _a.getHTML()) || "";
41
+ return ((_a = instance.value) == null ? void 0 : _a.root) || null;
42
+ },
43
+ /* 读取 */
44
+ getHTML: (options) => {
45
+ var _a;
46
+ return ((_a = instance.value) == null ? void 0 : _a.getHTML(options)) ?? "";
36
47
  },
37
48
  getText: () => {
38
49
  var _a;
39
- return ((_a = instance.value) == null ? void 0 : _a.getText()) || "";
50
+ return ((_a = instance.value) == null ? void 0 : _a.getText()) ?? "";
51
+ },
52
+ getJSON: () => {
53
+ var _a;
54
+ return ((_a = instance.value) == null ? void 0 : _a.getJSON()) ?? null;
40
55
  },
41
56
  counts: () => {
42
57
  var _a;
43
- return ((_a = instance.value) == null ? void 0 : _a.counts()) || null;
58
+ return ((_a = instance.value) == null ? void 0 : _a.counts()) ?? null;
59
+ },
60
+ markdownOptions: () => {
61
+ var _a;
62
+ return ((_a = instance.value) == null ? void 0 : _a.markdownOptions()) ?? null;
63
+ },
64
+ /* 内容 */
65
+ setContent: (html, options) => {
66
+ var _a;
67
+ return (_a = instance.value) == null ? void 0 : _a.setContent(html, options);
68
+ },
69
+ clear: () => {
70
+ var _a;
71
+ return (_a = instance.value) == null ? void 0 : _a.clear();
44
72
  },
45
73
  focus: () => {
46
74
  var _a;
47
75
  return (_a = instance.value) == null ? void 0 : _a.focus();
48
76
  },
49
- setContent: (html) => {
77
+ blur: () => {
78
+ var _a;
79
+ return (_a = instance.value) == null ? void 0 : _a.blur();
80
+ },
81
+ undo: () => {
82
+ var _a;
83
+ return (_a = instance.value) == null ? void 0 : _a.undo();
84
+ },
85
+ redo: () => {
86
+ var _a;
87
+ return (_a = instance.value) == null ? void 0 : _a.redo();
88
+ },
89
+ setReadOnly: (value) => {
50
90
  var _a;
51
- return (_a = instance.value) == null ? void 0 : _a.setContent(html);
91
+ return (_a = instance.value) == null ? void 0 : _a.setReadOnly(value);
92
+ },
93
+ /* Markdown 导入 */
94
+ importMarkdown: (source, options) => {
95
+ var _a;
96
+ return (_a = instance.value) == null ? void 0 : _a.importMarkdown(source, options);
97
+ },
98
+ setMarkdown: (source, options) => {
99
+ var _a;
100
+ return (_a = instance.value) == null ? void 0 : _a.setMarkdown(source, options);
101
+ },
102
+ insertMarkdown: (source, options) => {
103
+ var _a;
104
+ return (_a = instance.value) == null ? void 0 : _a.insertMarkdown(source, options);
105
+ },
106
+ appendMarkdown: (source, options) => {
107
+ var _a;
108
+ return (_a = instance.value) == null ? void 0 : _a.appendMarkdown(source, options);
109
+ },
110
+ moveCaretToEnd: () => {
111
+ var _a;
112
+ return (_a = instance.value) == null ? void 0 : _a.moveCaretToEnd();
113
+ },
114
+ /* 插入 */
115
+ appendHTML: (html) => {
116
+ var _a;
117
+ return (_a = instance.value) == null ? void 0 : _a.appendHTML(html);
118
+ },
119
+ insertImage: (url, alt) => {
120
+ var _a;
121
+ return (_a = instance.value) == null ? void 0 : _a.insertImage(url, alt);
52
122
  },
123
+ insertVideo: (url, label) => {
124
+ var _a;
125
+ return (_a = instance.value) == null ? void 0 : _a.insertVideo(url, label);
126
+ },
127
+ insertCode: (code, lang) => {
128
+ var _a;
129
+ return (_a = instance.value) == null ? void 0 : _a.insertCode(code, lang);
130
+ },
131
+ codeLanguages: () => {
132
+ var _a;
133
+ return ((_a = instance.value) == null ? void 0 : _a.codeLanguages()) ?? [];
134
+ },
135
+ highlightCode: () => {
136
+ var _a;
137
+ return (_a = instance.value) == null ? void 0 : _a.highlightCode();
138
+ },
139
+ upload: (file, kind) => {
140
+ var _a;
141
+ return (_a = instance.value) == null ? void 0 : _a.upload(file, kind);
142
+ },
143
+ cancelUploads: () => {
144
+ var _a;
145
+ return (_a = instance.value) == null ? void 0 : _a.cancelUploads();
146
+ },
147
+ /* 按钮 */
148
+ addButton: (button) => {
149
+ var _a;
150
+ return (_a = instance.value) == null ? void 0 : _a.addButton(button);
151
+ },
152
+ removeButton: (name) => {
153
+ var _a;
154
+ return (_a = instance.value) == null ? void 0 : _a.removeButton(name);
155
+ },
156
+ moveButton: (name, position) => {
157
+ var _a;
158
+ return (_a = instance.value) == null ? void 0 : _a.moveButton(name, position);
159
+ },
160
+ setButtonOptions: (name, items) => {
161
+ var _a;
162
+ return (_a = instance.value) == null ? void 0 : _a.setButtonOptions(name, items);
163
+ },
164
+ getButtonValue: (name) => {
165
+ var _a;
166
+ return (_a = instance.value) == null ? void 0 : _a.getButtonValue(name);
167
+ },
168
+ setButtonValue: (name, value) => {
169
+ var _a;
170
+ return (_a = instance.value) == null ? void 0 : _a.setButtonValue(name, value);
171
+ },
172
+ /* 视图 */
53
173
  enterSource: () => {
54
174
  var _a;
55
175
  return (_a = instance.value) == null ? void 0 : _a.enterSource();
@@ -57,6 +177,23 @@
57
177
  openPreview: () => {
58
178
  var _a;
59
179
  return (_a = instance.value) == null ? void 0 : _a.openPreview();
180
+ },
181
+ setHeight: (height) => {
182
+ var _a;
183
+ return (_a = instance.value) == null ? void 0 : _a.setHeight(height);
184
+ },
185
+ setPaper: (paper) => {
186
+ var _a;
187
+ return (_a = instance.value) == null ? void 0 : _a.setPaper(paper);
188
+ },
189
+ /* 事件 */
190
+ on: (name, handler) => {
191
+ var _a;
192
+ return (_a = instance.value) == null ? void 0 : _a.on(name, handler);
193
+ },
194
+ off: (name, handler) => {
195
+ var _a;
196
+ return (_a = instance.value) == null ? void 0 : _a.off(name, handler);
60
197
  }
61
198
  });
62
199
  vue.onMounted(() => {
@@ -77,8 +214,15 @@
77
214
  (value) => {
78
215
  const editor = instance.value;
79
216
  if (!editor || editor.sourceMode) return;
217
+ if (typeof value !== "string") {
218
+ if (value != null && !warnedModel) {
219
+ warnedModel = true;
220
+ console.warn("[KEditor] v-model 只接受 HTML 字符串,本次非字符串赋值已忽略:", value);
221
+ }
222
+ return;
223
+ }
80
224
  if (value === editor.getHTML()) return;
81
- editor.setContent(value || "", { silent: true });
225
+ editor.setContent(value, { silent: true });
82
226
  }
83
227
  );
84
228
  vue.watch(