jQuery Columnize ist ein Plugin für die Javascript-Bibliothek jQuery, mit der ein Spalten-Layout wie in einer Zeitung erzeugt werden kann. Der ursprüngliche HTML-Code muss dabei nur minimal verändert werden. In den meisten Fällen kommt er auch ganz ohne Änderung aus.
Dokumentation
Die Verwendung des Columnize-Plugins ist einfach:
$("#text").columnize()
setzt den Inhalt des DOM-Knotens mit der ID ›text‹ in ein zweispaltiges Layout mit ausgeglichenen Spaltenlängen.
Das Plugin versteht verschiedene Optionen, die in geschweiften Klammern angegeben werden können.
Optionen
- balance: ›true‹, wenn die Spalten automatisch ausgeglichen werden sollen. ›false‹, wenn die Spalten die Höhe des umgebenden Elements übernehmen sollen. Voreinstellung: ›true‹
- column: Die CSS-Klasse, welche Spalten zugewiesen wird. Voreinstellung: ›column‹
- columns: Die Anzahl der Spalten bei eingeschaltetem balance-Modus. Voreinstellung: ›2‹
- continued: Die CSS-Klasse, welche in der nächsten Spalte fortgesetzten DOM-Knoten zugewiesen wird. Voreinstellung: ›continued‹
Tipps
Wenn der balance-Modus abgeschaltet wird, muss für das Element, auf welches das Spalten-Layout angewendet wird, per CSS-Eigenschaft ›max-height‹ eine Maximalhöhe festlegt sein. Die Spalten werden dann höchstens lang, wie diese Maximalhöhe erlaubt.
Auch bei eingeschaltetem balance-Modus wird die Maximalhöhe berücksichtigt. Würde das Ausgleichen der Spaltenlängen die Maximalhöhe überschreiten, schaltet erzeugt das Plugin den balance-Modus automatisch ab. Das Plugin erzeugt dann mehr Spalten als durch columns angegeben.
Die Spaltenbreite bestimmt sicht aus den CSS-Eigenschaften für die Spalten. Sie können diese Breite durch die in der Option columns angegebene CSS-Klasse beeinflussen. Tpyische Werte dafür sind die folgenden:
float: left
width: 200px
margin-right: 1em
Für ein gleichmäßiges Layout sollten Sie außerdem die CSS-Eigenschaft ›line-height‹ verwenden. Wenn Sie eine Zeilenhöhe ausdrücklich setzen und alle vertikalen Abstände als Vielfache der Zeilenhöhe bestimmen, stellen Sie sicher, dass alle Grundlinien auf das gleiche Raster fallen.
Beispiele
- $("#text").columnize({columns: 3})
Dreispaltiger Satz mit ausgeglichenen Spaltenlängen. - $("#text").columnize({columns: 3, balanced: false})
Dreispaltiger Satz mit ausgeglichenen Spaltenlängen, sofern die Spaltenlänge die Maximalhöhe des Elements nicht überschreitet. Sonst gibt das Plugin den dreispaltige Satz auf und erzeugt so viele Spalten, wie für den Text notwendig sind. - $("#text").columnize({balanced: false})
Satz mit Spalten bis zur Maximalhöhe des Elements. Die Anzahl der Spalten wird durch die Menge an Text festgelegt.
Lizenz
jQuery Columnize ist ein Beitrag zur jQuery-Community und wird deshalb als Open Source-Software vertrieben. Das Plugin steht unter der GNU Lesser General Public License.
--> website