ラベル & アイコン

このページでは、モバイルアプリ内でのテーブル、フィールドおよびリレーションの表示プロパティが定義できます。

初期状態では、デフォルトのプロパティが設定されています。 プロパティを変更するには、変更する要素を選択し、カラム内に新しい適切な値を入力します。

テーブル・フィールド・リレーションに対して同じプロパティが設定できます。 さらに、フィールドおよびリレーションに対してフォーマットが定義できます。

生成されたアプリ内のテンプレートによって、詳細フォームおよびリストフォーム内でこれらの要素は表示されます。

アイコン

モバイルアプリのテンプレートにおいてアイコン表示が必要なときに、フィールド/要素に関連して表示されるアイコンを設定します。

情報

リレーションフィールドについては、アイコンは リレーション ボタンの左に表示され、このボタンを押すとリレートテーブルを開くことができます。

4Dモバイルエディターでは、あらゆる用途に応えるため、大量のアイコンのライブラリーを提供しています。 このライブラリーには、ビジネス、金融、教育、行政、健康、産業、不動産、サービスなどの用途のアイコンが用意されています。 アイコンを選択するには、アイコン ボタンをクリックし、表示されたリストからアイコンを選びます:

情報

統一性を持たせるため、少なくとも 1つのフィールドに対してアイコンが定義されている場合、アイコン未定義のフィールドに対して デフォルトアイコン が生成されます。

アプリ内でアイコンを表示したくない場合には、アイコンエリアを空のままにします。

カスタムのアイコンを追加する

独自のアイコンをライブラリーに追加し、プロジェクト内で選択することができます。 使用するアイコンフォーマットおよびサイズに制約はありません (ただし透過性を保持するため、SVG または PNG が推奨されます)。 プロジェクトエディター上でカスタムアイコンが見分けられるように、色を付けておくと良いかもしれません。

カスタムアイコンとして使用できるアイコンセットの一例です:

カスタムアイコンをダウンロードする

カスタムのアイコンをプロジェクトに追加するには:

1. 以下の場所に icons フォルダーを作成します。

<my4DProjetFolder>/Resources/Mobile/medias

注

medias フォルダーがない場合は、それも作成します。

2. icons フォルダー内にカスタマイズしたアイコンをドラッグ＆ドロップします。

これで、追加アイコンがプロジェクトにおいて選択できるようになりました。 これらは、標準アイコンのあとに表示されます。

短いラベル/長いラベル

公開されているテーブル・フィールド・リレーションに対して、カスタムのラベルが定義できます。 これらのラベルは、表示の最適化やタブバーが混雑するのを避けるため、テンプレートの表示スペースに応じて自動的に使用されます。

情報

リレーションフィールドについては、ラベルは リレーション ボタンの左に表示され、このボタンを押すとリレートテーブルを開くことができます。

• 短いラベルは 10文字以下です。
• 長いラベルは 25文字以下です。
• ここでは、ストラクチャーの名前には使用できない、"/" や "@"、半角スペースなどの特殊文字も使用することができます。

デフォルトでは、モバイルエディターはストラクチャー内で定義されているテーブル名とフィールド名をアプリ内で使用し、短いラベルと長いラベルの両方において同じ文字列が使用されます。

フォーマット

このプロパティで、アプリにおけるデータ表示の フォーマッター を選択できます。

データフォーマッターを使って、データベースのデータ型に対応するモバイル側の表示を指定することができます。 たとえば、メール用、請求書番号用などを定義することが可能です。

また、フォーマッターはスマートなインターフェースを作成するコードを呼び出すこともできます。 たとえば、電話番号にデータフォーマッターを指定して、モバイルアプリ上でユーザーがその番号をタッチするとアクションメニューが開くようにできます (相手に電話をかけたり、連絡先に保存したりするためなど)。

フォーマッターを選択する

フィールドのフォーマット列をクリックするとフォーマッターメニューが表示されます。 4Dモバイルエディターはデフォルトで、いくつかのビルトインフォーマッターを提供します:

選択可能なビルトインフォーマッターは、フィールドタイプによります:

フィールドの型	フォーマット
テキスト	テキスト
日付	日付、短い日付、長い日付、完全な日付
時間	時間、短い時間、経過時間、整数
画像	画像
ブール	"いいえ" または "はい"、 "False" または "True"
整数	整数、小数、実数、パーセント、助数詞、通貨 $、通貨 €、通貨 ¥、漢数字

ビルトインフォーマッターの使用例については、このチュートリアル を参照ください。

追加のフォーマッター (後述参照) をダウンロードまたは作成した場合にも、このメニューに表示されます。

カスタムフォーマッターを追加する

モバイルプロジェクトにカスタムフォーマッターを追加して、インターフェースを高度にカスタマイズすることができます。 既存のフォーマッターを go-mobile フォーマッターリポジトリ から ダウンロード するか、独自のフォーマッターを 作成 することができます。

その後、それらは プロジェクトにインストール する必要があります。

注

追加フォーマッターには 2タイプあります:

• コード付きの 動的フォーマッター (go-mobile フォーマッター Github リポジトリでは OSロゴ () で識別されます)。
• コードのない 静的フォーマッター。

フォーマッターをダウンロードする

go-mobile フォーマッター github リポジトリ からフォーマッターをダウンロードできます。 4Dモバイルエディターで フォーマットをもっとダウンロードする リンクをクリックすると、このレポジトリにアクセスできます。

フォーマッターを作成する

カスタムフォーマッターは常に、次の要素を含む manifest.json ファイルと関連付けられています:

• name: フォーマッターの名前 (文字列)。 例：phone, objectFormatter, など。
• type: 使用したい 4Dフォーマット型。 例: Text, Integer, など。
• binding:
  • 静的フォーマッターの場合: 文字列の場合は localizedText 、画像の場合は imageNamed。
  • 動的フォーマッターの場合: コードをアプリにリンクさせる文字列
• choiceList: 選択された型に対応する値 (静的フォーマッタのみ)。
• assets: ダークモードサポート、tintable (彩色可能)、整数から画像へ、テキストから画像へ、など、静的フォーマッターのみに使える追加のフォーマットデータ。
• target: フォーマッターがサポートするプラットフォーム (動的フォーマッタのみ)。

静的フォーマッターの manifest ファイルの例:

{
   "name": "integerToImage",

   "type": ["integer"],

   "binding": "imageNamed",

   "choiceList": {"0":"todo.png","1":"inprogress.png","2":"pending.png","3":"done.png"},

}

フォーマッターの作成については、チュートリアルで詳しく説明しています:

• 静的フォーマッターを作成する
• Swift の動的フォーマッターを作成する
• Kotlin の動的フォーマッターを作成する

for Android

特定のパーミッションをアプリに追加するには、以下のように capabilities ブロックを使用します:

 "capabilities" : {
        "android" : [ "android.permission.WRITE_EXTERNAL_STORAGE" ]

カスタムフォーマッターをインストールする

カスタムのフォーマッターをインストールするには、カスタムフォーマッターのフォルダーを 4Dプロジェクトフォルダーの/Resources/Mobile/formatters フォルダーにドロップします。 インストールされたフォーマッターはビルトインフォーマットと同じように、フォーマット メニューから選択することが可能です。

タイトル

このプロパティは、リレーションフィールドにおいてのみ利用可能です。 ここで定義されたタイトルは、リレーションを使用したときに遷移先のビューのトップに表示されます。

リレートフィールドの値をタイトル内に含めるには、% 文字を使用して指定します。 たとえば、Employee.employer リレートフィールドのタイトルに、リレート元である Employee の Name フィールドを表示するには、以下のように書きます:

%Name%の雇用主

tutorial

タイトルの定義方法については、それを説明した チュートリアル を参照ください。