バージョン

igTileManager の追加

トピックの概要

目的

このトピックではコード例を使用して、JavaScript または ASP.NET MVC のいずれかで igTileManager コントロールを HTML ページに追加する方法を説明します。このトピックは、HTML マークアップでの igTileManager の初期化について説明します。データ ソースからコントロールのインスタンスを作成する場合は、igTileManager とデータのバインドのトピックを参照してください。

前提条件

このトピックを理解するためには、以下のトピックを理解しておく必要があります:

  • igTileManager の概要: このトピックでは、主要機能、最小要件およびユーザー機能性など、igTileManager コントロールについて概念的な情報を提供します。

このトピックの内容

このトピックは、以下のセクションで構成されます。

igTileManager の追加 - 概要

igTileManager の追加の概要

igTileManager は、DIV 要素で初期化するコントロールです。DIV に追加されたマークアップやデータ ソースから、igTileManager を作成できます (igTileManager とデータのバインドを参照してください)。このトピックは、マークアップでの初期化を説明します。

igTileManager コントロールによって必要とされるすべての Ignite UI for jQuery リソースを読み込むために、Infragistics Loader (igLoader) コンポーネントを使用します。マークアップについても、HTML ページに定義されています。

要件

以下の表で、igTileManager コントロールの要件を簡単に説明します。

要件 / 必要なリソース 説明 必要な作業
jQuery および jQuery UI JavaScript リソース Ignite UI for jQuery は、これらのフレームワークの最上位にビルドされます。 ページの <head> セクションで両方のライブラリにスクリプト参照を追加します。
JavaScript リソース Ignite UI for jQuery ライブラリの igTileManager 機能は、いくつかのファイルにて配布されます。必要なリソースは以下の方法で読み込むことができます。 以下の表は、igTileManager コントロール関連の Ignite UI for jQuery ライブラリの依存関係を示します。これらのリソースは、リソースを手動で取り込むことを選択する場合は明示的に参照される必要があります (igLoader は使用しない)。
JS リソース 説明
infragistics.util.js
infragistics.util.jquery.js
Ignite UI for jQuery ユーティリティ
infragistics.datasource.js igDataSource™ コンポーネント
infragistics.templating.js テンプレート エンジン (igTemplate™)
infragistics.ui.layoutmanger.js igLayoutManager™ コンポーネント
infragistics.ui.splitter.js igSplitter™ コンポーネント
infragistics.ui.tilemanager.js igTileManager コントロール

以下のいずれかを追加します。
  • igLoader への参照
  • すべての必要な JavaScript ファイルへの参照 (左側の表に一覧表示)
IG テーマ (オプション) このテーマには、Ignite UI for jQuery ライブラリ用のビジュアル スタイルが含まれます。テーマ ファイル: {IG CSS root}/themes/Infragistics/infragistics.theme.css ページのファイルに style 参照を追加します。
スタイル リファレンス コントロールを正しく描画するには、以下の CSS ファイルが必要です。{IG CSS root}/structure/modules/infragistics.ui.layout.css``{IG CSS root}/structure/modules/infragistics.ui.splitter.css ページのこれらのファイルに スタイル リファレンスを追加します。
igTileManager structure 以下の CSS ファイルからのスタイルは、コントロールの各種要素のレンダリングに使用されます。 {IG CSS root}/structure/modules/infragistics.ui.tilemanager.css ページのファイルに style 参照を追加します。

注: JavaScript と CSS リソースを読み込むためには igLoader コンポーネントを使うことを推奨します。この方法の詳細は、Infragistics Loader による必要なリソースの自動追加のトピックを参照してください。さらに、オンラインの Ignite UI for jQuery サンプル ブラウザー には、igTileManager コンポーネントで igLoader を使用する方法の具体的な例が記載されています。

手順

igTileManager を HTML ページへ追加するための一般的な手順をおおまかに示すと、次のようになります。

  1. igTileManager コントロールをホストするための HTML 要素の追加

  2. igTileManager のインスタンス作成

igTileManager の HTML マークアップへの追加 - 手順

概要

この手順は、実際の HTML/JavaScript 実装を使用して、基本機能を持つ igTileManager コントロールを HTML ページへ追加するステップを説明します。igTileManager コントロールによって必要とされるすべての Ignite UI for jQuery リソースを読み込むために、Infragistics Loader コンポーネント (igLoader) を使用します。マークアップについても、HTML ページに定義されています。

プレビュー

以下のスクリーンショットは最終結果のプレビューです。

前提条件

必要なリソースが追加され、適切に参照されていること。(リソースの概要については、要件を参照してください。)以下が含まれます。

  • 適切な場所に追加された必要なファイル:

    • Web ページと同じディレクトリにある Scripts という名前のフォルダーに追加された必要な jQuery および jQueryUI JavaScript リソース
    • Content/ig という名前のフォルダーに追加された Ignite UI for jQuery CSS ファイル (詳細は、Ignite UI for jQuery のスタイル設定とテーマ設定のトピックを参照してください。)
  • Web サイトまたはアプリケーションにある Scripts/ig という名前のフォルダーに追加された Ignite UI for jQuery JavaScript ファイル (詳細は、Ignite UI for jQuery での JavaScript リソースの使用のトピックを参照してください。)

  • ページの <head> セクションで参照される、必要な JavaScript リソース。

HTML の場合:

<script  type="text/javascript" src="Scripts/jquery.js"></script>
<script  type="text/javascript" src="Scripts/jquery-ui.js"></script>
  • ページで参照される igLoader コンポーネント。

HTML の場合:

<script  type="text/javascript" src="Scripts/ig/infragistics.loader.js"></script>
  • インスタンスが作成された igLoader コンポーネント:

HTML の場合:

<script type="text/javascript">
    $.ig.loader({
        scriptPath: "Scripts/ig/",
        cssPath: "Content/ig/",
        resources: “igTileManager"
    });
<script>

手順

以下の手順は、基本的な igTileManager コントロールを Web ページに追加する方法を示します。その他のシナリオについては、igTileManager の構成を参照してください。

  1. ターゲット要素を igTileManager をホストするために追加します。

    Web ページで、igTileManager コントロールの基本オブジェクトとして提供するためにターゲットの HTML DIV 要素を定義し、その ID を設定します。HTML ページの 3 つのタイルを表す見出しと合わせて 3 つの DIV を追加します。

    HTML の場合:

     <style type="text/css">
             #dashboard {
                 position: relative;
                 width: 100%;
                 height: 800px;
             }
     </style> 
     <div id="dashboard">
             <div>
               <figure class=”minimized”>
                  <figcaption>Miami Heat</figcaption>
                  <img src="miami-logo.jpg" alt="error">
                  </figure>
              <div class="maximized">
                 <img src="miami-maximized.jpg" alt="error">
                  <ul>
                    <li>Top scorer: LeBron James - 25,9 PPG</li>
                    <li>Most rebounds per game: LeBron James - 8.40 TOT</li>
                    <li>Highest three point percentage: James Jones - 0.750</li>
                  </ul>
              </div>
             </div>
             <div>
                <figure class=”minimized”>
                  <figcaption>San Antonio Spurs</figcaption>
                  <img src="San-Antonio-logo.jpg" alt="error">
                 </figure>
                <div class="maximized">
                   <img src="San-Antonio-maximized.jpg" alt="error">
                    <ul>
                      <li>Top scorer: Tony Parker - 20,3 PPG</li>
                      <li>Most rebounds per game: Tim Duncan - 9.90 TOT</li>
                      <li>Highest three point percentage: Matt Bonner - 0.442</li>
                    </ul>
                </div>
              </div>
              <div>
                  <figure class=”minimized”>
                    <figcaption>New York Knicks</figcaption>
                    <img src="NY-logo.jpg" alt="error">
                  </figure>
                 <div class="maximized">
                  <img src="ny-maximized.jpg" alt="error">
                     <ul>
                        <li>Top scorer: Carmelo Anthony - 28,7 PPG</li>
                        <li>Most rebounds per game: Tyson Chandler - 10.70 TOT</li>
                        <li>Highest three point percentage: Steve Novak - 0.425</li>
                     </ul>
             </div>
     </div>
    
  2. igTileManager のインスタンスを作成し、任意のレイアウトを指定します。

    HTML ページのスクリプト要素に初期化コードを追加します。初期化コードが、以前に追加された DIV 要素で igTileManager インスタンスを作成します。

    以下のコードは、各辺が 250 ピクセルの四角形のタイルで igTileManager コントロールのインスタンスを作成します。

    JavaScript の場合:

     $.ig.loader(function () {
         //  Create a basic igTileManager control
         $("#dashboard").igTileManager({
                 columnWidth: 250,
                 columnHeight: 250,
                 minimizedState: “.minimized”,
                 maximizedState: “.maximized”
         });
     });
    

ASP.NET MVC ビューへの igTileManager の追加 - 手順

概要

この手順は、基本的な機能を備えた igTileManager を ASP.NET MVC View に追加する方法を示します。この例では、必要なローダーの構成とともに ASP.NET MVC 構文を使用します。

プレビュー

以下のスクリーンショットは、最終結果のプレビューです。

前提条件

必要なリソースが追加され、適切に参照されていること。 (リソースの概要については、要件を参照してください。)以下が含まれます。

  • 適切な場所に追加された必要なファイル:
    • Web ページと同じディレクトリにある Scripts という名前のフォルダーに追加された必要な jQuery および jQueryUI JavaScript リソース
    • Content/ig という名前のフォルダーに追加された Ignite UI for jQuery CSS ファイル (詳細は、Ignite UI for jQuery のスタイル設定とテーマ設定のトピックを参照してください。)
    • Web サイトまたはアプリケーションにある Scripts/ig という名前のフォルダーに追加された Ignite UI for jQuery JavaScript ファイル (詳細は、Ignite UI for jQuery での JavaScript リソースの使用のトピックを参照してください。)
  • ページの <head> セクションで参照される、必要な JavaScript リソース。

    HTML の場合:

    <script  type="text/javascript" src="Scripts/jquery.js"></script>
    <script  type="text/javascript" src="Scripts/jquery-ui.js"></script>
    

    ページで参照される igLoader コンポーネント。

    HTML の場合:

    <script  type="text/javascript" src="Scripts/ig/infragistics.loader.js"></script>
    

    igTileManager 用に構成された Ignite UI for MVC Loader:

    ASPX の場合:

    @(Html.Infragistics()
        .Loader()
        .ScriptPath("http://localhost/ig_ui/js/")
        .CssPath("http://localhost/ig_ui/css/")
        .Render()
    )
    

手順

以下の手順は、基本的な igTileManager コントロールを ASP.NET MVC アプリケーションに追加する方法を示します。その他のシナリオについては、igTileManager の構成を参照してください。

  1. ターゲット要素を igTileManager をホストするために追加します。

    Web ページで、igTileManager コントロールの基本オブジェクトとして提供するためにターゲットの HTML DIV 要素を定義し、その ID を設定します。HTML ページの 3 つのタイルを表す見出しと合わせて 3 つの DIV を追加します。

    HTML の場合:

     <style type="text/css">
             #dashboard {
                 position: relative;
                 width: 100%;
                 height: 800px;
             }
     </style> 
     <div id="dashboard">
             <div>
               <figure class=”minimized”>
                  <figcaption>Miami Heat</figcaption>
                  <img src="miami-logo.jpg" alt="error">
                  </figure>
              <div class="maximized">
                 <img src="miami-maximized.jpg" alt="error">
                  <ul>
                    <li>Top scorer: LeBron James - 25,9 PPG</li>
                    <li>Most rebounds per game: LeBron James - 8.40 TOT</li>
                    <li>Highest three point percentage: James Jones - 0.750</li>
                  </ul>
              </div>
             </div>
             <div>
                <figure class=”minimized”>
                  <figcaption>San Antonio Spurs</figcaption>
                  <img src="San-Antonio-logo.jpg" alt="error">
                 </figure>
                <div class="maximized">
                   <img src="San-Antonio-maximized.jpg" alt="error">
                    <ul>
                      <li>Top scorer: Tony Parker - 20,3 PPG</li>
                      <li>Most rebounds per game: Tim Duncan - 9.90 TOT</li>
                      <li>Highest three point percentage: Matt Bonner - 0.442</li>
                    </ul>
                </div>
              </div>
              <div>
                  <figure class=”minimized”>
                    <figcaption>New York Knicks</figcaption>
                    <img src="NY-logo.jpg" alt="error">
                  </figure>
                 <div class="maximized">
                  <img src="ny-maximized.jpg" alt="error">
                     <ul>
                        <li>Top scorer: Carmelo Anthony - 28,7 PPG</li>
                        <li>Most rebounds per game: Tyson Chandler - 10.70 TOT</li>
                        <li>Highest three point percentage: Steve Novak - 0.425</li>
                     </ul>
             </div>
     </div>
    
  2. igTileManager のインスタンス作成

    以下のコードは、各辺が 250 ピクセルの四角形のタイルで igTileManager コントロールのインスタンスを作成します。

    ASPX の場合:

     @(Html.
       Infragistics().
       ID("dashboard").
       minimizedState(“.minimized”).
       maximizedState(“.maximized”).
       Render()
     )
    

関連コンテンツ

トピック

このトピックの追加情報については、以下のトピックも合わせてご参照ください。

  • igTileManager とデータのバインド: このトピックでは、igTileManager コントロールをJavaScript 配列、XML データ、厳密に型指定された MVC ビュー、およびリモート サービスからの JSON レスポンスにバインドする方法を説明します。

  • igTileManager の構成: このトピックでは、igTileManager コントロールの機能およびビヘイビアーを構成する方法を説明します。

  • イベントの処理 (igTileManager): このトピックではコード例を使用して、イベント ハンドラーを igTileManager に添付する方法を説明します。

  • アクセシビリティの遵守 (igTileManager): このトピックでは、igTileManager コントロールのアクセシビリティ機能を説明し、このコントロールを含むページのアクセシビリティ遵守を実現する方法を説明します。

  • 既知の問題と制限 (igTileManager): このトピックでは、igTileManager コントロールの既知の問題と制限、その回避策に関する情報を提供します。

  • jQuery および MVC API リファレンス リンク (igTileManager): このトピックは、igTileManager コントロールの API 参照ドキュメントのリンクの一覧です。

サンプル

このトピックについては、以下のサンプルも参照してください。

オンラインで表示: GitHub