ColorPicker

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

color picker basic

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"/>

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

color picker tabs

Надписи

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

  • blueSliderCaption

  • buttonCaption

  • cancelButtonCaption

  • confirmButtonCaption

  • greenSliderCaption

  • hueSliderCaption

  • lookupAllCaption

  • lookupBlueCaption

  • lookupGreenCaption

  • lookupRedCaption

  • popupCaption

  • redSliderCaption

  • saturationSliderCaption

  • swatchesTabCaption

  • valueSliderCaption

defaultCaptionEnabled

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

<colorPicker id="colorPicker"
             defaultCaptionEnabled="true"/>
color picker hex caption

historyVisible

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

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

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

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

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

ContextHelpIconClickEvent

ValueChangeEvent

Validator

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

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