Wallpapers

From CCIL
Revision as of 09:16, 20 April 2017 by Atanas.ilchev (Talk | contribs) (Defining collections)

Jump to: navigation, search


The wallpapers component provide nice, changing wallpapers for your interface. It comes as two components:

  • Core - The component itself, includes the JavaScripts of the functionality, but not wallpaper images at all.
  • CCIL - Includes 4 sets of background images:
    • Nature
    • Aircraft
    • Cars
    • Yana

Defining collections

Upon load, the setRandom or load methods look at CCIL.ui.wallpaper.path for a file, named collections.json. Its purpose is to define the sets of images to use as a background:

{"version":"1.0",
 "date": "26-04-26",
 "images":
[
 {"name":"nature"},
 {"name":"yana"},
 {"name":"cars"},
 {"name":"aircraft"}
]
}

Defining image sets

Image sets are collections of image files, and a JSON descriptor which is parsed in order to generate the background statement.

{"version":"1.0",
 "date": "16-04-25",
 "images":
[
 {"name":"100_HD_Nature_Wallpapers_HQPixsBlog-97.jpg_HQ_Pixs_Blog_42.jpg"},
 {"name":"1080p-snow-wallpaper.jpg"},
 {"name":"183796-best-nature-wallpapers-hd.jpg"}
]
}

Include

Maven

<dependency>
	<groupId>net.ccil</groupId>
	<version>${ccil.version}</version>
	<artifactId>ccil-ui-wallpapers</artifactId>
	<scope>runtime</scope>
	<type>war</type>
</dependency>

HTML

<!-- JavaScript -->
<script type='text/javascript' src='ccil/js/ccil.js'></script>
<script type='text/javascript' src='ccil/js/ccil-wallpapers.js'></script>

Requires

API

path

Specifies the path to look for collections.json file.

CCIL.ui.wallpaper.path = 'dym/wallpapers/';

The default value is 'ccil/wallpapers/', if you include the ccil-ui-wallpapers-core component, you will have the following pre-defined set:

  • Nature
  • Aircraft
  • Cars
  • Yana

setRandom

Sets a random wallpaper as a background of the page.

CCIL.ui.wallpaper.setRandom();