README.md

jQuery Cute Element

Ce plugin jQuery vous permettra de donner du style à vos élements select, radio et checkbox.
Démo ici

Utilisation

CSS

Importer le fichier dans votre page HTML

<link href='jquery.cute-element.css' rel='stylesheet' type='text/css'>

JS

Importer le fichier dans votre page HTML après le script jQuery

<script type="text/javascript" src="http://code.jquery.com/jquery-latest.min.js"></script>
<script type="text/javascript" src="jquery.cute-element.min.js"></script>

Exemples

<script type="text/javascript">
    $('input[type="radio"], input[type="checkbox"]').cuteElement({
        'theme': 'check-heavy'
    });
    $('select').cuteElement({
        'selectWidth': '100px'
    });
</script>

Paramètres du plugin jQuery

labelPosition

Position du label rapport à l'élément, avant (prev), après (next) ou aucun (none)
Défaut: next

theme

Thèmes pour les éléments radio et checkbox, thèmes disponibles : checkbox, radio, check-heavy, bullet-outline, smiley-happy-face, sprites. Vous pouvez créer de nouveaux thèmes grâce aux mixins Sass décrites ci-après ou en personnalisant le css
Défaut: checkbox

selectWidth

Largeur de l'élément select
Défaut: auto

inputContainer

Ajouter un élement pour contenir les checkbox ou radio : <div/>, <li/>, ...
Défaut: null

showElement

Rendre visible l'élément original
Défaut: false

Utilisation avancée avec Sass

Plutôt que d'importer le fichier CSS vous pouvez inclure le fichier jquery.cute-element.scss dans votre projet, ainsi vous aurez accès à deux mixins : une première pour créer des thèmes pour vos élements radio et checkbox à partir de pseudo-éléments ou de caractères HTML et une deuxième à partir d'images situées dans le dossier "sprites".

.my-custom-theme {
    @include cute-element-input (
        $border-radius: 20px,
        $character: "\25E6",
        $character-size: 50px,
        $character-vertical-align: 0.17,
        $character-horizontal-align: -4px,
        $checked-color: #89B11C
    );
}

Paramètres de la mixin

$dimension

Largeur et hauteur de l'élement en pixels
Défaut: 20px

$color

Couleur de fond de de l'élément
Défaut: #eee

$border-radius

Taille des bordures arrondies de l'élément
Défaut: 0

$checked-dimension

Largeur et hauteur du check
Défaut: 10px

$checked-color

Couleur du check
Défaut: #1290cc

$checked-border-radius

Taille des bordures arrondies du check
Défaut: 0

$shadow

Ombre de l'élément
Défaut: 0px 0px -3px -1px rgba(#000, 0.25)

$shadow-hover

Ombre au survol
Défaut: 0px 0px -3px -1px rgba(#1290cc, 1)

$border

Bordure de l'élément
Défaut: 1px solid #ddd

$character

Si vous spécifiez ce paramètre vous utiliserez à la place du simple carré/rond un caractère HTML de votre choix
Défaut: none

$character-size

Taille du caractère
Défaut: 0

$character-vertical-align

Ajustement vertical de la position du caractère en pixels ou en valeur décimal (line-height)
Défaut: 0

$character-horizontal-align

Ajustement horizontal de la position du caractère en pixels (text-indent)
Défaut: 0

.my-custom-theme-with-sprites {
    @include cute-element-input-with-sprites($sprite: sprite-map("sprites/*.png", $layout: "horizontal"));
}

Paramètres de la mixin

$sprite

Appel à la fonction sprite-map() avec votre dossier qui contient les images à regrouper, le plus simple étant de modifier les images existantes et de regénérer la sprite avec votre compilateur sass.

Méthode

toggleCheck

En appelant la méthode toggleCheck sur vos checkbox préalablement modifiées vous pourrez les cocher/décocher par programmation.

<script type="text/javascript">
    $('input[type="checkbox"]').cuteElement();
    $('#check-all').click(function(event){
        event.preventDefault();
        $('input[type="checkbox"]').cuteElement('toggleCheck');
    });  
</script>