ColorPicker

ДЕМОНСТРАЦИЯ

ColorPicker представляет собой поле для предпросмотра и выбора цвета. Данный компонент представляет собой кнопку, при нажатии на которую открывается окно палитры. Кнопка окрашена в выбранный пользователем цвет. ColorPicker возвращает шестнадцатеричный (HEX) код цвета в виде строки.

ColorPicker, связанный с данными

Для создания ColorPicker, связанного с данными, используйте атрибуты dataContainer и property.

@JmixEntity
@Table(name = "UIEX1_CAR")
@Entity(name = "uiex1_Car")
public class Car {
    @JmixGeneratedValue
    @Column(name = "ID", nullable = false)
    @Id
    private UUID id;

    @Column(name = "BRAND")
    private String brand;

    @Column(name = "MODEL")
    private String model;

    @Column(name = "COLOR_HEX")
    private String colorHex;
}

<data>
    <instance id="carDc"
              class="ui.ex1.entity.Car">
        <fetchPlan extends="_base"/>
        <loader/>
    </instance>
</data>
<layout>
    <colorPicker caption="Color of the car"
                 dataContainer="carDc"
                 property="colorHex"/>
</layout>

Атрибуты

Видимость вкладок

По умолчанию включена только вкладка селектора RGB. В дополнение можно определить видимость вкладок селектора HSV и палитры.

<colorPicker caption="Choose a color"
             hsvVisible="true"
             rgbVisible="true"
             swatchesVisible="true"/>

Одновременно можно открыть только одну вкладку.

Надписи

Следующие атрибуты определяют соответствующие надписи:

blueSliderCaption
buttonCaption
cancelButtonCaption
confirmButtonCaption
greenSliderCaption
hueSliderCaption
lookupAllCaption
lookupBlueCaption
lookupGreenCaption
lookupRedCaption
popupCaption
redSliderCaption
saturationSliderCaption
swatchesTabCaption
valueSliderCaption

defaultCaptionEnabled

Данный атрибут позволяет использовать HEX-код текущего цвета в качестве надписи кнопки. Для этого установите для этого атрибута значение true и не указывайте значение для атрибута buttonCaption.

<colorPicker id="colorPicker"
             defaultCaptionEnabled="true"/>

historyVisible

Данный атрибут определяет видимость истории последних выбранных пользователем цветов внизу окна палитры.

<colorPicker caption="Choose a color"
             historyVisible="true"/>

События и слушатели

Чтобы сгенерировать заглушку слушателя в Jmix Studio, выберите компонент в XML-дескрипторе экрана или на панели иерархии Jmix UI и используйте вкладку Handlers на панели инспектора Jmix UI.

В качестве альтернативы вы можете воспользоваться кнопкой Generate Handler на верхней панели контроллера экрана.

ContextHelpIconClickEvent

См. ContextHelpIconClickEvent.

ValueChangeEvent

См. ValueChangeEvent.

Validator

Добавляет экземпляр валидатора в компонент. validator должен выбросить ValidationException, если значение недопустимо.

Все XML-атрибуты

Просматривать и редактировать атрибуты, применимые к компоненту, можно с помощью панели инспектора Jmix UI в конструкторе экранов Studio.