Analyse der Verwendung des Front-End-Ressourcenpakets, das mit dem Yii-Framework in PHP geliefert wird

不言
Freigeben: 2023-04-01 13:42:01
Original
1107 Leute haben es durchsucht

Dieser Artikel stellt hauptsächlich die Verwendung von Front-End-Ressourcenpaketen im Yii-Framework von PHP vor und listet einige gängige JavaScript- und CSS-Ressourcen in Yii auf. Freunde in Not können darauf verweisen

Die Ressourcen in Yii sind und Dateien im Zusammenhang mit Webseiten können CSS-Dateien, JavaScript-Dateien, Bilder oder Videos usw. sein. Die Ressourcen werden in einem für das Web zugänglichen Verzeichnis abgelegt und direkt vom Webserver aufgerufen.

Es ist besser, Ressourcen automatisch über Programme zu verwalten. Wenn Sie beispielsweise das yiijuiDatePicker-Widget auf einer Seite verwenden, werden die erforderlichen CSS- und JavaScript-Dateien automatisch eingebunden, anstatt dass Sie diese Dateien manuell suchen und einbinden müssen Wenn Sie das Widget aktualisieren, wird es automatisch die neue Version der Ressourcendatei verwenden. In diesem Tutorial werden wir die leistungsstarken Ressourcenverwaltungsfunktionen von Yii detailliert beschreiben.

Ressourcenpaket

Ressourcenpakete sind einfach eine Sammlung von Ressourcen, die in einem Verzeichnis abgelegt werden CSS- und JavaScript-Dateien im Paket werden beim Rendern der Webseite einbezogen.

Definieren Sie das Ressourcenpaket

Das Ressourcenpaket wird als PHP-Klasse angegeben, die yiiwebAssetBundle erbt. Der Paketname ist der PHP-Klassenname, der automatisch geladen werden kann In der Ressourcenpaketklasse müssen Sie den Speicherort der Ressource angeben, welche CSS- und JavaScript-Dateien sie enthält und welche Abhängigkeiten sie von anderen Paketen hat.

Der folgende Code definiert das Hauptressourcenpaket, das von der Basisanwendungsvorlage verwendet wird:

<?php

namespace app\assets;

use yii\web\AssetBundle;

class AppAsset extends AssetBundle
{
 public $basePath = &#39;@webroot&#39;;
 public $baseUrl = &#39;@web&#39;;
 public $css = [
  &#39;css/site.css&#39;,
 ];
 public $js = [
 ];
 public $depends = [
  &#39;yii\web\YiiAsset&#39;,
  &#39;yii\bootstrap\BootstrapAsset&#39;,
 ];
}
Nach dem Login kopieren

Wie oben die vom AppAsset angegebenen Ressourcendateien Die entsprechende URL ist @web. Das Ressourcenpaket enthält keine JavaScript-Datei, yiiwebYiiAsset und yiibootstrapBootstrapAsset Die Eigenschaften von yiiwebAssetBundle lauten wie folgt:

  • yiiwebAssetBundle::sourcePath: Gibt das Stammverzeichnis des Bundles an, das Ressourcendateien enthält. Diese Eigenschaft sollte festgelegt werden, wenn das Web nicht auf das Stammverzeichnis zugreifen kann Andernfalls sollten die Eigenschaft yiiwebAssetBundle::basePath und yiiwebAssetBundle::baseUrl festgelegt werden. Hier können Pfadaliase verwendet werden.

  • yiiwebAssetBundle::basePath: gibt das Verzeichnis an, das die Ressourcendateien im Ressourcenpaket enthält und über das Internet zugänglich ist. Der Ressourcenmanager veröffentlicht die Ressourcen des Pakets in einem über das Internet zugänglichen Verzeichnis und überschreibt dieses Attribut. Wenn sich Ihre Ressourcendateien in einem über das Internet zugänglichen Verzeichnis befinden, sollten Sie dieses Attribut festlegen, damit sie nicht erneut veröffentlicht werden müssen. Hier können Pfadaliase verwendet werden.

yiiwebAssetBundle::baseUrl: Gibt die URL an, die dem Verzeichnis yiiwebAssetBundle::basePath entspricht. Wenn Sie das Attribut yiiwebAssetBundle::sourcePath angeben, wird der Ressourcenmanager dies tun Veröffentlichen Sie diese Ressource und überschreiben Sie diese Eigenschaft. Hier können Pfadaliase verwendet werden.
yiiwebAssetBundle::js: Ein Array, das die JavaScript-Dateien des Ressourcenpakets enthält. Beachten Sie, dass der Schrägstrich „/“ als Verzeichnistrennzeichen verwendet werden sollte. Jede JavaScript-Datei kann in einem der folgenden zwei Formate angegeben werden 🎜>

  • Der relative Pfad wird als lokale JavaScript-Datei ausgedrückt (z. B. js/main.js). Dem tatsächlichen Pfad der Datei ist yiiwebAssetManager::basePath vorangestellt Vor der Datei steht yiiwebAssetManager::baseUrl.

  • Die absolute URL-Adresse wird als externe JavaScript-Datei dargestellt, z. B. http://ajax.googleapis.com/ajax/libs/jquery/2.1.1/jquery.min. js oder // ajax.googleapis.com/ajax/libs/jquery/2.1.1/jquery.min.js.

  • yiiwebAssetBundle::css: Ein Array, das die JavaScript-Dateien von enthält Dieses Ressourcenpaket ist das gleiche wie yiiwebAssetBundle::js.

  • yiiwebAssetBundle::depends: Eine Liste anderer Ressourcenpakete, von denen dieses Ressourcenpaket abhängt (ausführliche Einführung in den nächsten beiden Abschnitten).

  • yiiwebAssetBundle::jsOptions: Gibt die Optionen an, die an diese Methode übergeben werden, wenn yiiwebView::registerJsFile() aufgerufen wird, um jede JavaScript-Datei im Bundle zu registrieren.

  • yiiwebAssetBundle::cssOptions: Gibt die Optionen an, die an diese Methode übergeben werden, wenn yiiwebView::registerCssFile() aufgerufen wird, um jede CSS-Datei im Bundle zu registrieren.

  • yiiwebAssetBundle::publishOptions: Gibt die Optionen an, die an diese Methode übergeben werden, wenn yiiwebAssetManager::publish() aufgerufen wird, um die Paketressourcendatei im Webverzeichnis zu veröffentlichen. Nur wenn yiiwebAssetBundle::sourcePath vorhanden ist angegebenen Eigenschaften verwendet.

Ressourcenstandort

Ressourcen können nach ihrem Standort unterteilt werden:

Quellressourcen: Ressourcendateien und PHP-Quellcode Zusammengenommen kann das Web nicht direkt auf sie zugreifen. Um diese Quellressourcen nutzen zu können, müssen sie in ein Webverzeichnis kopiert werden, auf das das Web zugreifen kann, und zu veröffentlichten Ressourcen werden später ausführlich vorgestellt.

Ressourcen veröffentlichen: Ressourcendateien werden in einem Webverzeichnis abgelegt, auf das direkt über das Web zugegriffen werden kann.
Externe Ressourcen: Ressourcendateien werden auf einem anderen Webserver für Ihre Webanwendung abgelegt Paketklasse: Wenn Sie das Attribut yiiwebAssetBundle::sourcePath angeben, bedeutet dies, dass alle Ressourcen, die relative Pfade verwenden, als Quellressourcen behandelt werden. Wenn Sie dieses Attribut nicht angeben, bedeutet dies, dass diese Ressourcen veröffentlichte Ressourcen sind (daher sollten Sie yiiwebAssetBundle angeben). ::basePath und yiiwebAssetBundle::baseUrl teilen Yii ihren Standort mit.

推荐将资源文件放到Web目录以避免不必要的发布资源过程,这就是之前的例子指定 yii\web\AssetBundle::basePath 而不是 yii\web\AssetBundle::sourcePath.

对于 扩展来说,由于它们的资源和源代码都在不能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 = [&#39;condition&#39; => &#39;lte IE9&#39;];
Nach dem Login kopieren

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

<!--[if lte IE9]>
<link rel="stylesheet" href="path/to/foo.css">
<![endif]-->
Nach dem Login kopieren

为链接标签包含

public $cssOptions = [&#39;noscript&#39; => true];
Nach dem Login kopieren

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

public $jsOptions = [&#39;position&#39; => \yii\web\View::POS_HEAD];
Nach dem Login kopieren

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 代表视图对象
Nach dem Login kopieren

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

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

Beliebte Tutorials
Mehr>
Neueste Downloads
Mehr>
Web-Effekte
Quellcode der Website
Website-Materialien
Frontend-Vorlage
Über uns Haftungsausschluss Sitemap
Chinesische PHP-Website:Online-PHP-Schulung für das Gemeinwohl,Helfen Sie PHP-Lernenden, sich schnell weiterzuentwickeln!