Huawei Hongmeng HarmonyOS JavaUIフレームワーク公式サイトドキュメント更新：コンポーネント開発ガイド、補足コンポーネント開発指示書

Huaweiは公式に、Java UIフレームワークはHarmonyOSアプリケーション開発において多くの開発者が注目すべき重要なコンテンツであると述べています。最近、公式サイトのドキュメントにあるJava UIフレームワークのコンテンツは、開発者からのフィードバックや改善提案により、主に新しい開発ガイドと追加開発指示という形で更新された。

I. 新コンポーネント開発ガイド

今回のアップデートでは、PopupDialogコンポーネントとCommonDialogコンポーネントの開発ガイドを追加しました。

PopupDialog と CommonDialog は、開発者にシンプルで便利なダイアログを提供する、より一般的に使用されている対話型コンポーネントで、以下に簡単に説明されています。

PopupDialogコンポーネント

PopupDialogは、コンポーネントを参照するか、画面に表示することによって、現在のインターフェースの上にポップアップ表示されるバブルダイアログです。開発者はPopupDialogのコンストラクタでバブルダイアログを作成し、setArrowOffset, setArrowSize, setBackColorなどの共通メソッドでバブルダイアログのサイズ、背景、矢印のスタイルを設定することができます。さらに、setCustomComponentを使って、いくつかのカスタム設定をすることもできます。カスタムバブルダイアログボックスのサンプル効果をFigure 1に示します。

図1 カスタムバブルダイアログボックスの効果例

PopupDialogコンポーネントの詳細な開発ガイドについては、以下の公式サイトをご覧ください。

https://developer.harmonyos.com/cn/docs/documentation/doc-guides/ui-java-component-popupdialog-0000001150714408# section1520718454241

CommonDialogコンポーネント

CommonDialogは、ポップアップ・ボックスが消えるまで、ユーザーが他のインターフェイスのコンテンツを操作できないようにするダイアログボックスです。通常、ユーザーが現在必要としている、あるいはユーザーが注目しなければならない情報やアクションを表示するために使用されます。

開発者は、CommonDialogコンストラクタを使用してダイアログボックスを作成し、setSize、setOffset、setCornerRadiusなどの通常のメソッドでサイズ、オフセット、角丸を設定し、setDurationメソッドで自動的に閉じるまでの時間を設定することが可能です。開発者は、setCustomComponentを使用して、いくつかのカスタム設定を行うこともできます。CommonDialogのカスタムダイアログボックスのサンプルをFigure 2に示します。

図 2 カスタム CommonDialog ダイアログボックスのレンダリング例

CommonDialogコンポーネントの開発に関する詳細なガイドは、以下の公式サイトをご覧ください。

https://developer.harmonyos.com/cn/docs/documentation/doc-guides/ui-java-component-commondialog-0000001150874228

II. 追加コンポーネント開発指示

今回のアップデートでは、開発者がドキュメントを読みながら開発プロセスを理解・習得しやすいように、オリジナルのコンポーネント開発ガイドに、ToastDialogコンポーネント、Pickerコンポーネント、TableLayoutレイアウト、カスタムコンポーネントを追加しました。以下は、この補足ガイドの内容です。

ToastDialogコンポーネント

ToastDialogコンポーネントは、通知アクションの簡単なフィードバックとしてウィンドウの上にポップアップ表示されるダイアログボックスです。ToastDialog コンポーネントには、Figure 3 に示すような新しいインタフェース記述があり、開発者に ToastDialog を作成、使用、カスタマイズするための対応するコンストラクタと共通メソッドへのアクセスを提供しています。

図 3 ToastDialog がインターフェース記述内容を追加する例

ToastDialogコンポーネントの公式サイトガイドです。

https://developer.harmonyos.com/cn/docs/documentation/doc-guides/ui-java-component-toastdialog-0000001060125963# section166052377612

ピッカー部品

Picker コンポーネントは、スライド式セレクタを提供します。今回の更新では、Picker コンポーネントに複数レベルのアソシエーションの使用例を追加し、開発者が複数レベルの Picker アソシエーションの実装に関連するシナリオの要件をより良く開発できるようにしました。 図 4 に示すように、Picker コンポーネントに複数レベルのアソシエーションを使用することができます。

図4 ピッカーによる多段階関連付けの模式図

Pickerコンポーネント公式サイトのご案内です。

https://developer.harmonyos.com/cn/docs/documentation/doc-guides/ui-java-component-picker-0000001059807909

TableLayout レイアウト

TableLayoutは、サブコンポーネントを分割するためにテーブルを使用します。今回の更新では、TableLayout サブコンポーネントの行と列のプロパティを使用する例が追加され、開発者は TableLayout サブコンポーネントの行と列のプロパティを設定して、セルの結合の効果を実現できるようになりました。図 5 に示すように、TableLayout を使用してセルマージを実装します。

図 5 TableLayout を用いたセル結合のイメージ図

TableLayoutレイアウトの公式サイトガイドです。

https://developer.harmonyos.com/cn/docs/documentation/doc-guides/ui-java-layout-tablelayout-0000001060379893

カスタムコンポーネント

カスタムコンポーネントとは、開発者が設計要件に基づき作成するコンポーネントのことです。今回のアップデートでは、カスタムコンポーネントの完全なサンプルコードを追加し、ドキュメントにあるカスタムサークルコンポーネントの機能を微調整して、クリック/リフトするたびに円の色を変更できるようにしました。図6に示すように、カスタムサークルコンポーネントの効果は、以下のとおりです。

図6 カスタムサークルコンポーネントの効果説明図

カスタムコンポーネント公式サイトのご案内です。

https://developer.harmonyos.com/cn/docs/documentation/doc-guides/ui-java-custom-components-0000001139369661

III. 提案とフィードバック

ファーウェイは、開発者の声に耳を傾け、ドキュメント体験を継続的に最適化することにこだわっていると言います。開発者は、開発プロセスにおけるドキュメントの問題点や提案について、2つの方法でフィードバックを提供することができます。

開発ドキュメントの直下にある「フィードバック」ボタンをクリックすると、フィードバックが行えます。

Huawei Developer Forumの「HarmonyOS」セクションで、「Post Topic」をクリックすると、フィードバックが行えます。 

これは、公式Huawei HarmonyOS JavaUIフレームワークの文書更新のすべてのコンテンツです：コンポーネント開発ガイド、補足のコンポーネント開発手順、私はそれがあなたを助けることを願って、より多くのコンテンツは、スクリプトホームに焦点を当て続けてください。