TimeField

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

TimeField – это поле для отображения и ввода времени. Это часть компонента DateField, но его также можно использовать отдельно.

time field

XML-имя компонента: timeField.

Основы

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

@JmixEntity
@Table(name = "UIEX1_ORDER")
@Entity(name = "uiex1_Order")
public class Order {
    @JmixGeneratedValue
    @Column(name = "ID", nullable = false)
    @Id
    private UUID id;

    @Column(name = "DELIVERY_TIME")
    @Temporal(TemporalType.TIME)
    private Date deliveryTime;
}
<data>
    <instance id="orderDc"
              class="ui.ex1.entity.Order">
        <fetchPlan extends="_base"/>
        <loader/>
    </instance>
</data>
<layout>
    <timeField dataContainer="orderDc"
               property="deliveryTime"
               caption="Delivery time"/>
</layout>

В приведенном выше примере у экрана есть контейнер данных orderDc для сущности Order, у которой есть свойство deliveryTime. Ссылка на контейнер данных указывается в атрибуте dataContainer. Имя атрибута сущности, значение которого должно отображаться в поле, задается в атрибуте property.

Атрибут связанной сущности должен иметь тип java.util.Date, java.time.LocalTime или java.time.OffsetTime.

Формат времени

  • Вы можете определить формат времени по его datatype и указать в локализованном пакете сообщений в ключе timeFormat.

  • Также можно установить формат времени в атрибуте timeFormat.

    <timeField timeFormat="mm/HH"/>

Атрибуты

resolution

Атрибут resolution позволяет определить точность времени. Принимает следующие значения:

  • SEC

  • MIN - значение по умолчанию, с точностью до минуты.

  • HOUR

<timeField resolution="SEC"/>

timeMode

Атрибут timeMode позволяет выбрать формат отображения времени, 12-часовой или 24-часовой, с соответствующими значениями:

  • H_12

  • H_24 - по умолчанию.

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

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

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

ContextHelpIconClickHandler

См. ContextHelpIconClickHandler.

Validator

См. Validator.

ValueChangeEvent

См. ValueChangeEvent.

XML-атрибуты TimeField

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

align - box.expandRatio - buffered - caption - captionAsHtml - colspan - contextHelpText - contextHelpTextHtmlEnabled - css - dataContainer - datatype - description - descriptionAsHtml - editable - enable - height - htmlSanitizerEnabled - icon - id - property - required - requiredMessage - resolution - responsive - rowspan - stylename - tabIndex - timeFormat - timeMode - visible - width

XML-элемент TimeField

validators