![[オリジナル]プログレスバーブロックの機能](https://digipress.info/_wp/wp-content/uploads/2023/01/progress-bar-block.png)
ここで紹介する機能を利用するには、DigiPress 専用プラグイン「DigiPress Ex – Blocks Free」または「DigiPress Ex – Blocks」が必要です。
なお、「DigiPress Ex – Blocks Free」の場合は一部機能制限があります。
「DigiPress Ex – Blocks / Blocks Free」プラグインを利用することで、WordPress のブロックエディターにプラグインオリジナルの「プログレスバー」ブロックが追加されます。
このブロックでは、物事の進捗状況や能力レベルの割合などを示すアニメーションバー(グラフ)を表示できます。
その他のエディター機能については以下をご覧ください。
ブロックコンテンツ表示サンプル
ブロックの追加
「プログレスバー」ブロックは、ブロック追加ボタンで一覧を開き、「DigiPressブロック」グループから追加します。

ブロックを追加すると、エディター上で以下の初期状態のコンテンツが表示されます。

編集中のエディターでは、以下のように実際のブロックコンテンツの表示と同じ状態でカスタマイズができます。

ブロックオプション(右側サイドバー)
一般設定
右側の設定サイドバーにある「一般設定」では、プログレスバー全体の背景カラーや角丸、サイズ(幅、高さ)を調整するためのオプションがあります。

グラデーション、凹み効果はサブスクリプション版にて利用可能になります。
プログレスバー設定
右側の設定サイドバーにある「プログレスバー設定」では、進捗を示すバーの割合(パーセンテージ)やカラー、光沢エフェクト、バーの進捗アニメーションの有無などの設定を行います。


グラデーション、光沢エフェクト、パーセンテージの接頭辞・接尾辞はサブスクリプション版にて利用可能になります。
左ラベル
右側の設定サイドバーにある「左ラベル」では、プログレスバーの左端に表示されるテキストのタイポグラフィやカラー、アイコン、ラベル部分のハイライトに関する設定が行えます。


アイコンの表示はサブスクリプション版にて利用可能になります。
右ラベル
右側の設定サイドバーにある「右ラベル」では、プログレスバーの右端に表示されるテキストのタイポグラフィやカラー、アイコンに関する設定が行えます。

右ラベルの表示はサブスクリプション版にて利用可能になります。
スクロールアニメーション
右側の設定サイドバーにある「スクロールアニメーション」では、ページの垂直スクロールによって対象ブロックの表示位置まで移動された際に、アニメーションでフェードイン表示する場合、そのアニメーションパターンや各種アニメーション時間などをカスタマイズします。

設定したアニメーションは、「プレビュー」ボタンをクリックしてエディター上で事前にチェックが行なえます。
このオプションはサブスクリプション版にて利用可能になります。
間隔調整(インラインスタイル、プリセットclass)
「間隔調整」では、このブロックの前後(上下)に設けるマージン(余白)を設定できます。

間隔調整は、ブロックコンテンツのラッパー要素の style 属性に直接 CSS を挿入する「インラインスタイル」か、テーマのプリセット装飾 class を挿入することで余白を調整する「プリセット class」のいずれかの方法を選べます。
その他Tips
ブロックコンテンツを本文以外(ウィジェットエリア)で表示する方法
DigiPressのオリジナルブロックを含め、WordPressのブロックエディターによるコンテンツを記事本文以外のウィジェットエリアに表示するには、「DigiPress Ex – Blocks」プラグインの「再利用コンテンツ」機能を利用することで実現できます。
詳しくは以下をご覧ください。
注意事項・仕様
無料版での機能制限
無料版(DigiPress Ex – Blocks Free)では、以下のカスタマイズオプションの利用が制限されています。
- プログレスバー全体の背景のグラデーション指定
- プログレスバー全体の凹み効果
- プログレスバーのグラデーション指定
- プログレスバーに対する光沢エフェクト指定
- プログレスバー上に表示されるパーセンテージ前後の任意テキスト指定
- 左ラベルのアイコン表示
- 左ラベルのハイライト表示
- 右ラベルの表示
- スクロールアニメーション(フェードイン)
- 「このブロックには、想定されていないか無効なコンテンツが含まれています」と表示された場合
ブロックのリカバリーを試行(復元)を実行 本プラグインのアップデート後、エディター上のブロックで「このブロックには、想定されていないか無効なコンテンツが含まれています。」と表示された場合、旧バージョンから仕様が変更された可能性があります。
この場合は、HTML やクラシックブロックに変換せずに、必ず「ブロックのリカバリーを試行」を選択してアップデート後のバージョン仕様として更新してください。
「ブロックのリカバリーを試行」を実行しない限り、既存のブロックは従来のバージョンの状態のままで表示されます。
- WordPress 5.9〜 にてブロックエディターの動作が重たい(しばらくフリーズする)場合
-
WordPress 5.9 にアップデート後、「DigiPress Ex – Blocks/Blocks Free」を利用すると段落や見出しブロックなどを追加したり、ブロックの選択時にアクティブな状態になるまでしばらくフリーズする現象が確認されています。
段落や見出しブロックは、多くの「スタイル」(装飾)が用意されていますが、WordPress 5.9 でのブロックエディターでは、ブロック追加や選択時に全スタイルのプレビュー処理(レンダリング)がその都度行われ、恐らくこの処理の待ち時間が長いことが原因と思われます。
この場合は、将来のブロックエディター(ベータ版)を試せる「Gutenberg」プラグインに置き換えると、「スタイル」はテキストの項目のみとなり、スタイルごとにカーソルを合わせた際に、はじめて対象スタイルのプレビュー(レンダリング)を行う仕様のため、WordPress 5.9 のブロックエディターに比べてはるかにレスポンスが早くストレスなく編集作業ができます。
WordPress のエディターがこのスタイルプレビューの仕様にアップデートされるまでは、「Gutenberg」プラグインに置き換えてご利用ください。