Boutons

Introduction

Il y a deux catégories de bouton: sort et swap.

Les boutons swap sont inclus depuis l'origine, alors que les boutons sort sont inclus seulement depuis la version 0.5.0.

Avec les boutons swap, vous pouvez faire votre sélection facilement. Choisissez une occurence (ou plus), dans une des deux listes puis cliquer sur le bouton add ou remove pour transférer ce choix dans l'autre liste.

	Astuce
	Vous pouvez aussi double-cliquer sur une occurence d'une liste pour la transférer immédiatement dans l'autre liste, sans avoir à utiliser les boutons add ou remove.

A partir de la version 1.1.0 vous avez la possibilité de sélectionner ou désélectionner toutes les options en une seule fois. Vous pouvez aussi inverser une sélection existante. Cette nouvelle caractéristique est disponible grâce aux boutons all, none et toggle.

A partir de la version 1.2.0 la possibilité d'inverser la sélection est disponible pour les deux versions, simple et double liste.

	Note
	avec une seule liste à sélection, les boutons disponibles sont : all, none and toggle. avec deux listes à sélection, les boutons disponibles sont : add, remove, moveup, movedown, all, none et toggle.

Un exemple complet est fourni dans les annexes. Voir la sélection avancée.

Avec les boutons sort, vous avez la possibilité de ré-ordonner votre sélection facilement. Choisissez une occurence, puis cliquer sur le bouton up ou down pour déplacer celle-ci vers le haut ou le bas de votre sélection.

	Note
	L'ordre est conservé dans le tableau de super globales $_POST, quand le formulaire est transmis; Et cela même si vous avez activé la fonctionnalité auto-arrange (voir le paramètre `$sort` du constructeur de la classe HTML_QuickForm_advmultiselect )

Apparence

Il y a deux sortes de bouton: text et image. Ce sont les boutons standard que nous pouvons trouver dans un formulaire. L'apparence par défaut est text mais vous pouvez utiliser aussi facilement la couche de présentation avec image. Voici comment faire :

<?php
$ams->setButtonAttributes('add', array('type' => 'image', 'src' => '/img/add.png'));
$ams->setButtonAttributes('remove', array('type' => 'image', 'src' => '/img/remove.png'));
?>

Bien évidemment, tous les formats d'image sont supportés: PNG, GIF, etc ...

	Attention
	Si l'image n'existe pas, vous obtiendrez seulement en sortie (rendu) la valeur interne de la zone texte. Souvenez vous que les défauts sont : « `>>` » pour le bouton add, et « `<<` » pour le bouton remove.

Attributs

Dans la version 0.4.0, il y avait seulement les boutons add et remove. Dans la version 0.5.0, deux nouveaux boutons ont été ajoutés: moveup et movedown. Dans la version 1.1.0, trois nouveaux boutons ont été ajoutés: all, none, and toggle.

	Attention
	Tout autre identificateur différent de add, remove, all, none, toggle, moveup, movedown retournera une instance PEAR_Error.

Seulement cinq attributs peuvent être utilisés, avec ces quatre boutons; les voici :

name

Le nom du bouton au sein du formulaire. Les défauts sont: 'add', ou 'remove', ou 'all, ou 'none', ou 'toggle', ou 'up', ou 'down'.

	Avertissement
	Les valeurs par défaut de l'attribut name ne sont pas équivalent aux identificateurs de bouton.

value: Le libellé du bouton. Les défauts sont: ' >> ', ou ' << ', ou ' Select All ', ou ' Select None ', ou ' Toggle Selection ', ou ' Up ', ou ' Down '.

type: Le type de bouton au sein du formulaire. Le défaut est 'button' (peut être soit 'button' ou 'image').

class: Un identificateur de classe CSS dans une de vos feuilles de style.

src: URL de l'image utilisée.

Précédent	Niveau supérieur	Suivant
Entêtes	Sommaire	Options de tri

HTML_QuickForm_advmultiselect : La Référence

Boutons

Introduction

Apparence

Attributs