リッチテキストエディタ(GcRichTextEditor)の特徴的な機能である書式設定について解説します。
書式の設定
リッチテキストエディタは、フォント色や背景色、フォントサイズなどの書式を設定することができます。
applyFormat メソッドを使用して書式を適用し、removeFormat メソッドを使用して設定済みの書式をクリアすることができます。
そして、書式設定機能はメニューバーとツールバーに組み込まれるため、メニューバーの書式設定にある項目とツールバーのボタンを用いて書式設定を行うこともできます。
また、ビルドイン書式をカスタマイズすることができます。
例えば、太字の書式を設定すると、リッチテキストエディタは選択内容を strong タグで囲むようになりますが、CSS クラスを追加することで、書式の適用を変更することができます。
以下の内容を custom-content.css に追加します。
上記 CSS ファイルの読み込みの代わりに、直接 contentStyle プロパティを利用して CSS クラスを追記することもできます。
カスタム書式
リッチテキストエディタはカスタム書式を設定することができます。
次のサンプルコードは、リッチテキストエディタにカスタム書式を設定する方法を示します。
まず、カスタム書式を定義します。
次に、定義したカスタム書式をリッチテキストエディタに適用します。
removeFormat メソッドを使用して設定済みのカスタム書式をクリアすることができます。
import "@grapecity/inputman.richtexteditor/CSS/gc.inputman.richtexteditor.css";
import "@grapecity/inputman/CSS/gc.inputman-js.css";
import { InputMan } from "@grapecity/inputman.richtexteditor";
import * as GcCommon from "@grapecity/inputman";
InputMan.appearanceStyle = InputMan.AppearanceStyle.Modern;
var lastFormats = [];
const patterns = [
{ value: "Bold", pattern: "太字" },
{ value: "Italic", pattern: "斜体" },
{ value: "Underline", pattern: "下線" },
{ value: "StrikeThrough", pattern: "取り消し線" },
{ value: "BlockQuote", pattern: "引用" },
{ value: "Subscript", pattern: "上付き" },
{ value: "Superscript", pattern: "下付き" },
{ value: "Code", pattern: "コード" },
{ value: "H1", pattern: "見出し1" },
{ value: "H2", pattern: "見出し2" },
{ value: "H3", pattern: "見出し3" },
{ value: "H4", pattern: "見出し4" },
{ value: "H5", pattern: "見出し5" },
{ value: "H6", pattern: "見出し6" },
{ value: "AlignLeft", pattern: "左揃え" },
{ value: "AlignCenter", pattern: "中央揃え" },
{ value: "AlignRight", pattern: "右揃え" },
{ value: "AlignJustify", pattern: "両端揃え" },
];
const formats = {};
formats[InputMan.GcRichTextEditorFormatItem.Bold] = {
inline: "span",
classes: "bold",
};
formats["customformat"] = {
inline: "span",
styles: { color: "#ff0000" },
};
const gcRichTextEditor = new InputMan.GcRichTextEditor(
document.getElementById("gcRichTextEditor"),
{
watermarkText: "ここに入力してください...",
formats: formats,
toolbar: [
InputMan.GcRichTextEditorToolbarItem.Bold,
InputMan.GcRichTextEditorToolbarItem.Italic,
InputMan.GcRichTextEditorToolbarItem.Underline,
InputMan.GcRichTextEditorToolbarItem.Strikethrough,
InputMan.GcRichTextEditorToolbarItem.BlockQuote,
InputMan.GcRichTextEditorToolbarItem.Subscript,
InputMan.GcRichTextEditorToolbarItem.Superscript,
InputMan.GcRichTextEditorToolbarItem.HTMLCode,
InputMan.GcRichTextEditorToolbarItem.SeparateLine,
InputMan.GcRichTextEditorToolbarItem.H1,
InputMan.GcRichTextEditorToolbarItem.H2,
InputMan.GcRichTextEditorToolbarItem.H3,
InputMan.GcRichTextEditorToolbarItem.H4,
InputMan.GcRichTextEditorToolbarItem.H5,
InputMan.GcRichTextEditorToolbarItem.H6,
InputMan.GcRichTextEditorToolbarItem.SeparateLine,
InputMan.GcRichTextEditorToolbarItem.AlignLeft,
InputMan.GcRichTextEditorToolbarItem.AlignRight,
InputMan.GcRichTextEditorToolbarItem.AlignCenter,
InputMan.GcRichTextEditorToolbarItem.AlignJustify,
InputMan.GcRichTextEditorToolbarItem.SeparateLine,
InputMan.GcRichTextEditorToolbarItem.RemoveFormat,
],
plugins: [InputMan.GcRichTextEditorPluginItem.HTMLCode],
contentStyle: `.bold { background-color: aqua; }`,
baseUrl:
window.location.origin +
"/inputmanjs/demos/lib/purejs/node_modules/@grapecity/inputman.richtexteditor/JS",
}
);
const formatPattern = new GcCommon.InputMan.GcComboBox(
document.getElementById("formatPattern"),
{
items: patterns,
columns: [
{ name: "value", label: "値", width: 120 },
{ name: "pattern", label: "書式", width: 150 },
],
dropDownWidth: "auto",
isMultiSelect: true,
displayMemberPath: "pattern",
valueMemberPath: "value",
multipleItemSeparator: ";",
showClearButton: true,
}
);
formatPattern.addEventListener(
GcCommon.InputMan.GcComboBoxEvent.CheckedChanged,
(sender) => {
let checkedItems = formatPattern.getCheckedValues();
if (lastFormats != null && lastFormats.length > 0) {
const increased = checkedItems.filter((el) => !lastFormats.includes(el));
const decreased = lastFormats.filter((el) => !checkedItems.includes(el));
for (let i = 0; i < increased.length; i++) {
gcRichTextEditor.applyFormat(
InputMan.GcRichTextEditorFormatItem[increased[i]]
);
}
for (let i = 0; i < decreased.length; i++) {
gcRichTextEditor.removeFormat(
InputMan.GcRichTextEditorFormatItem[decreased[i]]
);
}
} else {
for (let i = 0; i < checkedItems.length; i++) {
gcRichTextEditor.applyFormat(
InputMan.GcRichTextEditorFormatItem[checkedItems[i]]
);
}
}
lastFormats = checkedItems;
}
);
document
.getElementById("addCustomFormat")
.addEventListener("change", function (e) {
if (e.target.checked) {
gcRichTextEditor.applyFormat("customformat");
} else {
gcRichTextEditor.removeFormat("customformat");
}
});
<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta http-equiv="X-UA-Compatible" content="ie=edge">
<title>リッチテキストエディタコントロール - 書式の設定</title>
<!-- SystemJS -->
<script src="node_modules/systemjs/dist/system.src.js"></script>
<script src="systemjs.config.js"></script>
<script>
System.import('./src/app');
</script>
</head>
<body>
<textarea id="gcRichTextEditor"></textarea>
<table class="sample">
<tr>
<th>書式の設定</th>
<td>
<select id="formatPattern"></select>
</td>
</tr>
<tr>
<th>カスタム書式</th>
<td>
<label><input type="checkbox" id="addCustomFormat" />カスタム書式を設定する</label>
</td>
</tr>
</table>
</body>
</html>
System.config({
transpiler: 'plugin-babel',
babelOptions: {
es2015: true
},
meta: {
'*.css': { loader: 'css' }
},
paths: {
// paths serve as alias
'npm:': 'node_modules/'
},
// map tells the System loader where to look for things
map: {
'@grapecity/inputman': 'npm:@grapecity/inputman/index.js',
'@grapecity/inputman/CSS': 'npm:@grapecity/inputman/CSS',
'@grapecity/inputman.richtexteditor': 'npm:@grapecity/inputman.richtexteditor/index.js',
'@grapecity/inputman.richtexteditor/CSS': 'npm:@grapecity/inputman.richtexteditor/CSS',
'css': 'npm:systemjs-plugin-css/css.js',
'plugin-babel': 'npm:systemjs-plugin-babel/plugin-babel.js',
'systemjs-babel-build': 'npm:systemjs-plugin-babel/systemjs-babel-browser.js'
},
// packages tells the System loader how to load when no filename and/or no extension
packages: {
src: {
defaultExtension: 'js'
},
"node_modules": {
defaultExtension: 'js'
},
}
});