2009-08-11 10 views
9

jQuery Plugins haben oft Abhängigkeiten zu externen Dateien: jQuery-Bibliothek, Stylesheets (CSS), Bilder, andere Plugins, usw. Was sind die Richtlinien für die Verwendung (und Schreiben) von jQuery-Plugins die Platzierung der Abhängigkeiten adressieren? Mit anderen Worten, wo sollen die benötigten Dateien hingelangen? Unter den Haupt-App-Ordnern (Img, Css, JS oder welche Ordner auch immer), unter Plugin-Ordner (zB Plugins/MyPlugin/Img, Plugins/MyPlugin/Css, etc) oder etwas anderes?Richtlinien für die Verwendung von jQuery Plugins und deren Abhängigkeiten

Nachdem ich mehrere Plugins in das Projekt aufgenommen habe, mache ich mir Sorgen, dass andere Projektmitglieder es schwer haben herauszufinden, welche Abhängigkeiten benötigt werden und welche Dateien wohin gehen sollen.

Was funktioniert und hat nicht für Sie funktioniert?

+0

Es gibt keine Richtlinie! Es ist nur eine Frage der Präferenz, wie Sie Ihre Dateien organisieren. –

Antwort

6

Persönlich, wenn ich ein Plugin erstelle, versuche ich es so wenig wie möglich von anderen Ressourcen abhängig zu machen, um dieses Problem zu vermeiden. Manchmal kann man nicht vermeiden, externe Stylesheets zu verwenden. In diesem Fall habe ich sie immer in meine anderen CSS-Dateien eingefügt, selbst wenn sie ursprünglich in demselben Ordner wie die Plugins enthalten sind. Dies vermeidet jede Mehrdeutigkeit bei dem Versuch, zu entscheiden, welche Stylesheets wohin gehen sollen usw. Sie müssen sie trotzdem manuell einfügen. Wenn das Plugin irgendwelche Abhängigkeiten hat, gehen sie in den JS-Ordner, der ähnlich wie die anderen Plugins organisiert ist. Bilder würden in diesem Fall dann mit allen anderen Bildern gehen.

Wenn Sie ein Plugin erstellen, können Sie es flexibler gestalten, indem Sie dem Benutzer erlauben, die Klassen zu definieren, die auf bestimmte Objekte angewendet werden, oder den Benutzer die Struktur dessen definieren lassen, was das Plugin manipuliert. All dies kann getan werden, während man ihm eine Reihe von guten Vorgaben gibt, denen man folgt, während man sich so wenig wie möglich auf externe Ressourcen verlässt.

Ob Best Practices für diese Situationen definiert wurden, habe ich noch nicht gefunden. Ich habe nur die Authoring-Richtlinien für das Plugin auf der jQuery-Site gefunden: http://docs.jquery.com/Plugins/Authoring.

EDIT:

Wie über Plugin Abhängigkeits Organisation zu klären:

Wenn Sie sagen, jquery.x.js und jquery.y.js haben. Beide hängen von jquery.z.js ab. Ich habe jquery.z.js immer in den gleichen Ordner wie jquery.x.js und jquery.y.js gestellt. Dies vermeidet Doppelarbeit und jegliche Verwirrung im Zusammenhang mit der Verletzung der organisatorischen Konvention. Also:

  • ./jquery.x.js
  • ./jquery.y.js
  • ./jquery.z.js

ich normalerweise meine Ordner als solche organisieren:

  • ./js/jquery-xxxjs
  • ./js/plugins/jquery.x.js
  • ./js/plugins/jquery.y.js
  • ./js/plugins/jquery.z.js
+1

Gute Vorschläge. Eine Frage: Angenommen, Sie haben die Plugins X und Y, die vom Plugin Z abhängig sind. Wenn Sie Z in den JS-Ordnern unter X und Y platzieren, wie vermeiden Sie Doppelungen und mögliche Konflikte, wenn Sie X und Y in einem Projekt verwenden?Nimmst du es nur einmal aus dem Ordner von X oder Y? Schließen Sie Z als eigenständiges Plugin ein und behalten Sie Kopien für Referenzen bei? Etwas anderes? –

+0

@Alek, Ich habe meinen Beitrag aktualisiert, um Ihren Kommentar zu beantworten. – Tres

+0

Cool, danke Tres. Das ist gut. –