Документация Engee

Textbox

Страница в процессе перевода.

Textbox поддерживает ввод простой однострочной строки с дополнительной логикой проверки.

using CairoMakie

f = Figure()
Textbox(f[1, 1], placeholder = "Enter a string...")
Textbox(f[2, 1], width = 300)

f
2e14261

Проверка

Атрибут validator используется вместе с validate_textbox(string, validator) для определения допустимости текущей строки. Это может быть регулярное выражение (Regex), которое должно соответствовать всей строке, или функция (Function), принимающая строку (String) в качестве входных данных и возвращающая логическое значение (Bool). Если средство проверки имеет тип T (например, Float64), проверка будет иметь вид tryparse(T, string). Textbox не позволит отправить введенное значение, если проверка не пройдена.

using CairoMakie

f = Figure()

tb = Textbox(f[2, 1], placeholder = "Enter a frequency",
    validator = Float64, tellwidth = false)

frequency = Observable(1.0)

on(tb.stored_string) do s
    frequency[] = parse(Float64, s)
end

xs = 0:0.01:10
sinecurve = @lift(sin.($frequency .* xs))

lines(f[1, 1], xs, sinecurve)

f
64bbf9f

Атрибуты

alignmode

Значение по умолчанию: Inside()

Выравнивание текстового поля по предлагаемому ограничивающему контуру.

bordercolor

Значение по умолчанию: RGBf(0.8, 0.8, 0.8)

Цвет границы коробки.

bordercolor_focused

Значение по умолчанию: COLOR_ACCENT[]

Цвет границы прямоугольника при наведении на него фокуса.

bordercolor_focused_invalid

Значение по умолчанию: RGBf(1, 0, 0)

Цвет границы поля при фокусировке и недопустимый.

bordercolor_hover

Значение по умолчанию: COLOR_ACCENT_DIMMED[]

Цвет границы поля при наведении курсора мыши.

borderwidth

Значение по умолчанию: 1.0

Ширина границы поля.

boxcolor

Значение по умолчанию: :transparent

Цвет коробки.

boxcolor_focused

Значение по умолчанию: :transparent

Цвет рамки при фокусировке.

boxcolor_focused_invalid

Значение по умолчанию: RGBAf(1, 0, 0, 0.3)

Цвет рамки при фокусировке.

boxcolor_hover

Значение по умолчанию: :transparent

Цвет поля при наведении курсора мыши.

cornerradius

Значение по умолчанию: 5

Радиус угла текстового поля.

cornersegments

Значение по умолчанию: 20

Угловые сегменты одного закругленного угла.

cursorcolor

Значение по умолчанию: :transparent

Цвет курсора.

defocus_on_submit

Значение по умолчанию: true

Определяет, будет ли текстовое поле расфокусировано при отправке строки.

displayed_string

Значение по умолчанию: nothing

Отображаемая в данный момент строка (для внутреннего использования).

focused

Значение по умолчанию: false

Если текстовое поле сфокусировано и принимает вводимый текст.

font

Значение по умолчанию: :regular

Семейство шрифтов.

fontsize

Значение по умолчанию: @inherit :fontsize 16.0f0

Размер текста.

halign

Значение по умолчанию: :center

Выравнивание текстового поля по горизонтали в соответствии с предложенной ограничивающей рамкой.

height

Значение по умолчанию: Auto()

Настройка высоты текстового поля.

placeholder

Значение по умолчанию: "Click to edit..."

Текст-заполнитель, который отображается, когда сохраненная строка представляет собой ничто.

reset_on_defocus

Значение по умолчанию: false

Определяет, будет ли отображаемый текст возвращен к сохраненному тексту при расфокусировке текстового поля без отправки.

restriction

Значение по умолчанию: nothing

Ограничивает допустимый ввод в юникоде с помощью is_allowed(символ, ограничение).

stored_string

Значение по умолчанию: nothing

Текущая сохраненная строка.

tellheight

Значение по умолчанию: true

Определяет, может ли родительский макет подстраиваться под высоту этого элемента.

tellwidth

Значение по умолчанию: true

Определяет, может ли родительский макет подстраиваться под ширину этого элемента.

textcolor

Значение по умолчанию: @inherit :textcolor :black

Цвет текста.

textcolor_placeholder

Значение по умолчанию: RGBf(0.5, 0.5, 0.5)

Цвет текста для заполнителя.

textpadding

Значение по умолчанию: (8, 8, 8, 8)

Заполнение текста в рамке.

validator

Значение по умолчанию: str->begin true end

Средство проверки, вызываемое с помощью validate_textbox(строка, средство проверки), чтобы определить, является ли текущая строка допустимой. По умолчанию это может быть регулярное выражение, которое должно соответствовать полной строке, или функция, принимающая строку в качестве входных данных и возвращающая значение Bool. Если средство проверки имеет тип T (например, Float64), проверка будет tryparse(T, string).

valign

Значение по умолчанию: :center

Выравнивание текстового поля по вертикали в предлагаемой ограничивающей рамке.

width

Значение по умолчанию: Auto()

Настройка ширины текстового поля.