メインコンテンツまでスキップ

setLayoutProperty

ウィジェットのレイアウト関連プロパティを設定します。対象は2つに分かれます: (1)ウィジェット自体のレイアウトメタプロパティ、(2)親コンテナ内での配置プロパティです。

備考

すべてのウィジェットが共通で使用するWidget Controlです。以下の例のwidgetIDは、キャンバスでウィジェットに指定した名前(ID)であり、スクリプトではwidgetID.memberの形式でアクセスします。

  • Parameters
    • name (string): 設定するレイアウトプロパティの名前
    • value (any): 設定する値
  • Returns: ウィジェット自身を返します(設定を続けて呼び出すチェーンが可能)。通常は戻り値を使わず、設定のために呼び出します。

使用できる名前:

  • 常に使用可能(ウィジェットメタ): visible, tag, responsive, id, description, analytics
  • 親がRow/Columnの場合: flex, fit
  • 親がStackの場合: top, left, right, bottom, width, height

Example

imgID.setLayoutProperty("visible", false);
imgID.setLayoutProperty("flex", 2);
imgID.setLayoutProperty("top", 20);
警告

flextopwidthのような配置プロパティは、ウィジェットの親コンテナの種類によって異なります。topはStackの子の場合のみ、flexはRow/Columnの子の場合のみ適用され、条件が合わない場合はエラーなく無視されます。マージン(margin)・パディング(padding)や無効化(disable)は、このコントロールの対象ではありません(余白はスタイルパーツ、無効化はdisableプロパティを使用してください)。