目次
PHP の Yii フレームワークに付属するフロントエンド リソース パッケージの使用方法の詳細な説明
興味があるかもしれない記事:
ホームページ バックエンド開発 PHPチュートリアル PHP の Yii フレームワークに付属するフロントエンド リソース パッケージの使用方法の詳細な説明、yii Framework_PHP チュートリアル

PHP の Yii フレームワークに付属するフロントエンド リソース パッケージの使用方法の詳細な説明、yii Framework_PHP チュートリアル

Jul 12, 2016 am 08:55 AM
php yii

PHP の Yii フレームワークに付属するフロントエンド リソース パッケージの使用方法の詳細な説明

Yii のリソースは、CSS ファイル、JavaScript ファイル、画像、または Web ページに関連するファイルです。リソースは Web アクセス可能なディレクトリに配置され、Web サーバーによって直接呼び出されます。

たとえば、ページで yiijuiDatePicker ウィジェットを使用すると、必要な CSS ファイルと JavaScript ファイルが自動的に組み込まれます。これらのファイルを手動で見つけて含める必要はありません。ウィジェットをアップグレードする ウィジェットをインストールすると、新しいバージョンのリソース ファイルが自動的に使用されます。このチュートリアルでは、Yii が提供する強力なリソース管理機能について詳しく説明します。

リソースパック

Yii はリソースをリソース パッケージで管理します。リソース パッケージは単にディレクトリに配置されたリソースのコレクションであり、リソース パッケージがビューに登録されると、Web ページのレンダリング時にパッケージ内の CSS ファイルと JavaScript ファイルが含まれます。

リソースパッケージを定義する

リソース パッケージは、yiiwebAssetBundle を継承する PHP クラスとして指定されます。パッケージ名は、リソース パッケージ クラスで、リソースの場所、CSS および JavaScript ファイルを指定する必要があります。が含まれており、他のパッケージとの依存関係も含まれています。

次のコードは、基本的なアプリケーション テンプレートで使用されるメイン リソース パッケージを定義します。 リーリー

上記のように、AppAsset クラスで指定されたリソース ファイルは @webroot ディレクトリに配置されており、リソース パッケージには CSS ファイル css/site.css が含まれています。他の 2 つのパッケージ yiiwebYiiAsset と yiibootstrapBootstrapAsset yiiwebAssetBundle について プロパティの詳細については以下で説明します。

yiiwebAssetBundle::sourcePath: リソース ファイルを含むバンドルのルート ディレクトリを指定します。Web からルート ディレクトリにアクセスできない場合は、このプロパティを設定する必要があります。それ以外の場合は、yiiwebAssetBundle::basePath プロパティと yiiwebAssetBundle::baseUrl を設定する必要があります。 ここでパスのエイリアスを使用できます
  • yiiwebAssetBundle::basePath: リソース バンドル内のリソース ファイルが含まれ、Web アクセス可能なディレクトリを指定します。 yiiwebAssetBundle::sourcePath 属性を指定すると、リソース マネージャーはパッケージのリソースを Web アクセス可能なディレクトリに公開します。ファイルが Web アクセス可能なディレクトリにある場合は、この属性を設定して、再度公開する必要がないようにする必要があります。 ここではパスのエイリアスを使用できます。
  • yiiwebAssetBundle::baseUrl: yiiwebAssetBundle::basePath ディレクトリに対応する URL を指定します。yiiwebAssetBundle::sourcePath 属性を指定すると、リソース マネージャーがこれらのリソースを公開し、この属性をオーバーライドします。ここではどこでも使用されています。
yiiwebAssetBundle::js: リソース バンドルの JavaScript ファイルを含む配列。各 JavaScript ファイルは次の 2 つの形式のいずれかで指定できます。


相対パスはローカル JavaScript ファイル (js/main.js など) として表され、ファイルの実際のパスの前に yiiwebAssetManager::basePath が付きます。ファイルの実際の URL の前に yiiwebAssetManager::baseUrl が付きます。

    絶対 URL アドレスは、http://ajax.googleapis.com/ajax/libs/jquery/2.1.1/jquery.min.js や //ajax.googleapis.com/ajax/libs などの外部 JavaScript ファイルとして表されます。 /jquery /2.1.1/jquery.min.js.
  • yiiwebAssetBundle::css: リソースバンドルの JavaScript ファイルを含む配列。配列形式は yiiwebAssetBundle::js と同じです。
  • yiiwebAssetBundle::depends: このリソース バンドルが依存する他のリソース バンドルのリスト (次の 2 つのセクションで詳しく説明します)。
  • yiiwebAssetBundle::jsOptions: yiiwebView::registerJsFile() を呼び出してバンドル内の各 JavaScript ファイルを登録するときに、このメソッドに渡されるオプションを指定します。
  • yiiwebAssetBundle::cssOptions: yiiwebView::registerCssFile() を呼び出してバンドル内の各 CSS ファイルを登録するときに、このメソッドに渡されるオプションを指定します。
  • yiiwebAssetBundle::publishOptions: yiiwebAssetManager::publish() を呼び出してパッケージ リソース ファイルを Web ディレクトリに公開するときに、このメソッドに渡されるオプションを指定します。これは、yiiwebAssetBundle::sourcePath 属性が指定されている場合にのみ使用されます。
  • リソースの場所

リソースはその場所に応じて分類できます:

ソース リソース: リソース ファイルと PHP ソース コードはまとめられており、Web から直接アクセスすることはできません。これらのソース リソースを使用するには、Web からアクセスできる Web ディレクトリにコピーしてリソースを公開する必要があります。公開リソースと呼ばれます。詳細は後述します。

リソースの公開: リソース ファイルは、Web 経由で直接アクセスできる Web ディレクトリに配置されます。 外部リソース: リソース ファイルは Web アプリケーションとは別の Web サーバーに配置されます。 リソース バンドル クラスを定義するときに、 yiiwebAssetBundle::sourcePath 属性を指定すると、相対パスを使用するすべてのリソースがソース リソースとして使用されます。この属性を指定しない場合は、これらのリソースが公開リソースであることを意味します。 yiiwebAssetBundle ::basePath と yiiwebAssetBundle::baseUrl を指定して Yii に位置を知らせる必要があります)。

不要なリソース公開プロセスを避けるために、リソース ファイルを Web ディレクトリに配置することをお勧めします。これが、前の例で yiiwebAssetBundle::sourcePath の代わりに yiiwebAssetBundle::basePath を指定している理由です。

对于 扩展来说,由于它们的资源和源代码都在不能Web访问的目录下, 在定义资源包类时必须指定yii\web\AssetBundle::sourcePath属性。

注意: yii\web\AssetBundle::sourcePath 属性不要用@webroot/assets,该路径默认为 yii\web\AssetManager资源管理器将源资源发布后存储资源的路径,该路径的所有内容会认为是临时文件, 可能会被删除。
资源依赖

当Web页面包含多个CSS或JavaScript文件时,它们有一定的先后顺序以避免属性覆盖, 例如,Web页面在使用jQuery UI小部件前必须确保jQuery JavaScript文件已经被包含了, 我们称这种资源先后次序称为资源依赖。

资源依赖主要通过yii\web\AssetBundle::depends 属性来指定, 在AppAsset 示例中,资源包依赖其他两个资源包: yii\web\YiiAsset 和 yii\bootstrap\BootstrapAsset 也就是该资源包的CSS和JavaScript文件要在这两个依赖包的文件包含 之后 才包含。

资源依赖关系是可传递,也就是人说A依赖B,B依赖C,那么A也依赖C。

资源选项

可指定yii\web\AssetBundle::cssOptions 和 yii\web\AssetBundle::jsOptions 属性来自定义页面包含CSS和JavaScript文件的方式, 这些属性值会分别传递给 yii\web\View::registerCssFile() 和 yii\web\View::registerJsFile() 方法, 在视图 调用这些方法包含CSS和JavaScript文件时。

注意: 在资源包类中设置的选项会应用到该包中 每个 CSS/JavaScript 文件,如果想对每个文件使用不同的选项, 应创建不同的资源包并在每个包中使用一个选项集。
例如,只想IE9或更高的浏览器包含一个CSS文件,可以使用如下选项:

public $cssOptions = ['condition' => 'lte IE9'];
ログイン後にコピー

这会是包中的CSS文件使用以下HTML标签包含进来:

<!--[if lte IE9]>
<link rel="stylesheet" href="path/to/foo.css">
<![endif]-->
ログイン後にコピー

为链接标签包含

public $cssOptions = ['noscript' => true];
ログイン後にコピー

为使JavaScript文件包含在页面head区域(JavaScript文件默认包含在body的结束处)使用以下选项:

public $jsOptions = ['position' => \yii\web\View::POS_HEAD];
ログイン後にコピー

Bower 和 NPM 资源

大多数 JavaScript/CSS 包通过Bower 和/或 NPM管理, 如果你的应用或扩展使用这些包,推荐你遵循以下步骤来管理库中的资源:

修改应用或扩展的 composer.json 文件将包列入require 中, 应使用bower-asset/PackageName (Bower包) 或 npm-asset/PackageName (NPM包)来对应库。
创建一个资源包类并将你的应用或扩展要使用的JavaScript/CSS 文件列入到类中, 应设置 yii\web\AssetBundle::sourcePath 属性为@bower/PackageName 或 @npm/PackageName, 因为根据别名Composer会安装Bower或NPM包到对应的目录下。
注意: 一些包会将它们分布式文件放到一个子目录中,对于这种情况,应指定子目录作为 yii\web\AssetBundle::sourcePath属性值,例如,yii\web\JqueryAsset使用 @bower/jquery/dist 而不是 @bower/jquery。
使用资源包

为使用资源包,在视图中调用yii\web\AssetBundle::register()方法先注册资源, 例如,在视图模板可使用如下代码注册资源包:

use app\assets\AppAsset;
AppAsset::register($this); // $this 代表视图对象
ログイン後にコピー

如果在其他地方注册资源包,应提供视图对象,如在 小部件 类中注册资源包, 可以通过 $this->view 获取视图对象。

当在视图中注册一个资源包时,在背后Yii会注册它所依赖的资源包,如果资源包是放在Web不可访问的目录下,会被发布到可访问的目录, 后续当视图渲染页面时,会生成这些注册包包含的CSS和JavaScript文件对应的

ホットAIツール

Undresser.AI Undress

Undresser.AI Undress

リアルなヌード写真を作成する AI 搭載アプリ

AI Clothes Remover

AI Clothes Remover

写真から衣服を削除するオンライン AI ツール。

Undress AI Tool

Undress AI Tool

脱衣画像を無料で

Clothoff.io

Clothoff.io

AI衣類リムーバー

AI Hentai Generator

AI Hentai Generator

AIヘンタイを無料で生成します。

ホットツール

メモ帳++7.3.1

メモ帳++7.3.1

使いやすく無料のコードエディター

SublimeText3 中国語版

SublimeText3 中国語版

中国語版、とても使いやすい

ゼンドスタジオ 13.0.1

ゼンドスタジオ 13.0.1

強力な PHP 統合開発環境

ドリームウィーバー CS6

ドリームウィーバー CS6

ビジュアル Web 開発ツール

SublimeText3 Mac版

SublimeText3 Mac版

神レベルのコード編集ソフト(SublimeText3)

CakePHP プロジェクトの構成 CakePHP プロジェクトの構成 Sep 10, 2024 pm 05:25 PM

この章では、CakePHP の環境変数、一般設定、データベース設定、電子メール設定について理解します。

Ubuntu および Debian 用の PHP 8.4 インストールおよびアップグレード ガイド Ubuntu および Debian 用の PHP 8.4 インストールおよびアップグレード ガイド Dec 24, 2024 pm 04:42 PM

PHP 8.4 では、いくつかの新機能、セキュリティの改善、パフォーマンスの改善が行われ、かなりの量の機能の非推奨と削除が行われています。 このガイドでは、Ubuntu、Debian、またはその派生版に PHP 8.4 をインストールする方法、または PHP 8.4 にアップグレードする方法について説明します。

CakePHP の日付と時刻 CakePHP の日付と時刻 Sep 10, 2024 pm 05:27 PM

Cakephp4 で日付と時刻を操作するには、利用可能な FrozenTime クラスを利用します。

CakePHP ファイルのアップロード CakePHP ファイルのアップロード Sep 10, 2024 pm 05:27 PM

ファイルのアップロードを行うには、フォーム ヘルパーを使用します。ここではファイルアップロードの例を示します。

CakePHP ルーティング CakePHP ルーティング Sep 10, 2024 pm 05:25 PM

この章では、ルーティングに関連する次のトピックを学習します。

CakePHP について話し合う CakePHP について話し合う Sep 10, 2024 pm 05:28 PM

CakePHP は、PHP 用のオープンソース フレームワークです。これは、アプリケーションの開発、展開、保守をより簡単にすることを目的としています。 CakePHP は、強力かつ理解しやすい MVC のようなアーキテクチャに基づいています。モデル、ビュー、コントローラー

PHP 開発用に Visual Studio Code (VS Code) をセットアップする方法 PHP 開発用に Visual Studio Code (VS Code) をセットアップする方法 Dec 20, 2024 am 11:31 AM

Visual Studio Code (VS Code とも呼ばれる) は、すべての主要なオペレーティング システムで利用できる無料のソース コード エディター (統合開発環境 (IDE)) です。 多くのプログラミング言語の拡張機能の大規模なコレクションを備えた VS Code は、

CakePHP バリデータの作成 CakePHP バリデータの作成 Sep 10, 2024 pm 05:26 PM

Validator は、コントローラーに次の 2 行を追加することで作成できます。

See all articles