CookBook

IMBox に投稿種別を追加する方法(textile)

投稿日:

このCookBookでは、IMBoxに投稿種別を追加する方法について紹介しています。
以下のドキュメントを参照することで、IMBox に投稿種別を追加することができます。
IMBox プログラミングガイド - メッセージ種別追加プログラム

この CookBook では、投稿したメッセージを textile として解釈し HTML に変換し表示する投稿種別を追加します。
textile の解析には以下のライブラリを用います。
borgar/textile-js
textile の解析結果から script タグ等をサニタイズ際には以下のライブラリを用います。
cure53/DOMPurify

完成イメージ


1. 投稿種別に「メッセージ(textile)」を選択します。
2. メッセージを入力します。
3. 投稿します。

完成サンプル

以下の完成サンプルをダウンロードしてご活用ください。

e builder プロジェクト : im_cookbook_128115.zip
imm ファイル : im_cookbook_128115-1.0.0.imm

ローカル環境で表示させる場合は、以下のURLにアクセスしてください。
http://localhost:8080/imart/imbox
なおベースURLである以下の部分は、環境に合わせて適宜変更してください。
http://localhost:8080/imart

レシピ

  1. imbox-message-config を作成します。
  2. 投稿処理を作成します。
  3. タイムライン表示画面を作成します。
  4. textile-js を配置します。
  5. DOMPurify を配置します。

1. imbox-message-config を作成します。

src/main/conf/imbox-message-config/imbox-message-config_im_cookbook_128115.xml

行数 説明
12 メッセージ種別名称を設定します。
13 投稿欄表示用のファイルパスを設定します。
14 タイムライン表示用のファイルパスを設定します。

2. 投稿処理を作成します。

src/main/jssp/src/im_cookbook_128115/message_type/views/type_textile.js

src/main/jssp/src/im_cookbook_128115/message_type/views/type_textile.html

行数 説明
32 メッセージを取得します。
55 メッセージをアトリビュートで受け取るため本属性は使用しません。そのためダミーのデータを設定します。
60 アトリビュートを JSON に変換します。

3. タイムライン表示画面を作成します。

src/im_cookbook_128115/message_type/views/textile_timeline.js

行数 説明
11 送信されたメッセージを取得します。
src/im_cookbook_128115/message_type/views/textile_timeline.html

行数 説明
19 メッセージを取得します。
20~29 メッセージをパースし html に変換します。その際、いくつかのクラスにスタイルを追加するために文字列の置換を行います。
30 変換後の html をサニタイズします。
32 変換後の html を表示します。

4. textile-js を配置します。

以下から textile-js をダウンロードし、textile-js-master/lib/textile.min.js を Web サーバの %CONTEXT_PATH%/csjs/libs/textile-js/lib/textile.min.js に配置します。
borgar/textile-js

5. DOMPurify を配置します。

以下から DOMPurify をダウンロードし、DOMPurify-master/dist/purify.min.js を Web サーバの %CONTEXT_PATH%/csjs/libs/DOMPurify/dist/purify.min.js に配置します。
cure53/DOMPurify

まとめ

この CookBook では、textile を入力できるメッセージ種別を追加する方法を紹介しました。

使用するライブラリを変更するだけで Markdown に対応することも可能です。
お客様の用途にあわせて是非ご活用ください。

-CookBook

執筆者:


  1. […] Markdown ではなく textile の投稿種別については以下を参照してください。 IMBox に投稿種別を追加する方法(textile) […]

comment

メールアドレスが公開されることはありません。 が付いている欄は必須項目です

関連記事

no image

BloomMaker で3桁区切りの数値フォーマットを自動で行うテキストボックスを作成する方法

この CookBook では、IM-BloomMaker を使用して、3桁区切りの数値フォーマットを自動で行うテキストボックスを作成する方法を紹介します。 ※この CookBook は 2021 Su …

no image

変数のkey, valueを取り出して配列にするアクション、式表現の利用方法

このCookBookでは、2022 Spring で新しく追加された以下のアクションと式表現について紹介します。 アクション変数○に○の各キー名を配列にして代入する変数○に○の各要素の値を配列にして代 …

no image

IM-BloomMaker と IM-LogicDesigner を組み合わせて、請求書を Excel でダウンロードする方法

この CookBook では intra-mart Accel Platform 2021 Spring から追加された、「IM-LogicDesigner フロールーティングにリクエストを送信する」 …

no image

IM-BloomMaker サイドメニューの使い方

このCookBookでは、2020 Summer から利用可能になったサイドメニューエレメントの使い方について紹介しています。 エレメントの概要 サイドメニューエレメントは、「intra-mart A …

no image

ViewCreatorでカレントの組織コードや会社コードを取得する動的パラメータの作り方

このCookBookでは、カレントの組織コードや会社コードを取得するViewCreatorの動的パラメータの作成方法についてご紹介します。 動的パラメータについての詳細は下記のドキュメントを参照してく …