Yiiウィジェットを構(gòu)成するには、プロパティとオプションを設(shè)定する構(gòu)成配列でそれを呼び出します。 1。Syntax\\ yii \\ widgets \\ classname :: widget（$ config）を使用してください。 2。ウィジェットのパブリックプロパティに一致するキーを使用して、$ config配列を定義します。 3.一部のウィジェットは、クラスやスタイルなどのHTMLオプションのネストされた配列をサポートしています。 4.屬性、値、およびルールのフォーマットを設(shè)定して、設(shè)定に直接設(shè)定して、外観と動(dòng)作をカスタマイズします。 5.公式のドキュメント、クラスの定義、またはコミュニティの例を參照して、各ウィジェットの利用可能なオプションを見つけます。

Yiiウィジェットを構(gòu)成することは、それほど悪くはありません。基本的なアイデアは、ウィジェットが複雑なUI要素を生成する再利用可能なコンポーネントであり、通常、ビューで呼び出すときにオプションの配列を渡すことでそれらを構(gòu)成することです。

つまずくことなく正しく行う方法は次のとおりです。

基本構(gòu)造を理解する

Yii（特にYii 2）では、ウィジェットは通常<?php \yii\some\widgets\ClassName::widget($config) ?>を使用して呼び出されます。 $configそのウィジェットのプロパティと設(shè)定を定義する配列です。

例えば：

 <？= \ yii \ widgets \ menu :: widget（[[
    「アイテム」=> [
        [&#39;label&#39; => &#39;home&#39;、 &#39;url&#39; => [&#39;/site/index&#39;]]、
        [&#39;label&#39; => &#39;about&#39;、 &#39;url&#39; => [&#39;/site/about&#39;]]、
    ]、、
]）？>

これにより、2つのアイテムが付いたシンプルなメニューが表示されます。各ウィジェットには、獨(dú)自の設(shè)定可能なオプションのセットがあります。公式ドキュメントまたはクラスの定義を確認(rèn)して、利用可能なものを確認(rèn)してください。

一般的なウィジェット構(gòu)成のヒント

ほとんどのウィジェットは、いくつかの一般的な構(gòu)成パターンを共有しています。

• 連想配列を使用して、プロパティ名と値を設(shè)定します。
• キーがウィジェットの予想されるパブリックプロパティと一致することを確認(rèn)してください。
• サポートされている場(chǎng)合は、ネストされたアレイを使用して、 class 、 styleなどなどのHTMLオプションを渡すこともできます。

一般的に構(gòu)成されているウィジェットには次のものがあります。

• Menu
• LinkPager
• DetailView
• GridView

それぞれに異なるオプションがありますが、構(gòu)造はほとんど一貫しています。

外観と動(dòng)作をカスタマイズする方法

ウィジェットでは、構(gòu)成オプションを使用して、外観と動(dòng)作の両方を調(diào)整できることがよくあります。

たとえば、 DetailViewを使用している場(chǎng)合は、特定のフィールドを異なる形式でフォーマットすることをお?jiǎng)幛幛筏蓼埂?/p>

 <？= \ yii \ widgets \ detailview :: widget（[[
    「モデル」=> $モデル、
    「屬性」=> [
        &#39;id&#39;、
        &#39;名前&#39;、
        &#39;created_at：datetime&#39;、//日付/時(shí)刻として形式
        [
            「屬性」=> &#39;ステータス&#39;、
            &#39;value&#39; => $ model-> status === 1？ 「アクティブ」：「非アクティブ」、
            &#39;contentoptions&#39; => [&#39;class&#39; => &#39;text-success&#39;]、
        ]、、
    ]、、
]）？>

ここでは、 attributes配列に単純な屬性名と完全なカスタム屬性定義を組み合わせることができることに気付くでしょう。これにより、各フィールドの表示方法を細(xì)かく制御できます。

また、多くのウィジェットがoptionsまたはhtmlOptionsパラメーターをサポートして、レンダリングされた要素にクラス、ID、またはインラインスタイルを直接追加します。

利用可能なオプションを見つける場(chǎng)所

ウィジェットがサポートするオプションがわからない場(chǎng)合：

• ウィジェットのPHPクラスファイルを見てください。
• 公式のYIIウィジェットドキュメントを確認(rèn)してください。
• または、 YII 2ガイドでウィジェット名を検索します。

最も有用な情報(bào)は、他の人がウィジェットをどのように使用したかを見ることから來ることがあります。そのため、コミュニティの例やGitHubリポジトリのチェックをスキップしないでください。

それは基本的にそれです。ウィジェットはYIIの強(qiáng)力なツールであり、構(gòu)成オプションを読み取る方法を知ったら、効果的に使用しやすくなります。作業(yè)中の特定のウィジェットで利用可能なオプションを常に調(diào)べることを忘れないでください。時(shí)間を節(jié)約し、推測(cè)を避けてください。

以上がYiiウィジェットを構(gòu)成するにはどうすればよいですか？の詳細(xì)內(nèi)容です。詳細(xì)については、PHP 中國(guó)語 Web サイトの他の関連記事を參照してください。