Skip to content
Telamon OSFramework API
Browse the docs

TelamonUrlValidator

A validator for a text field that accepts a URL with one of a set of schemes.

Since 1.4.0

TelamonUrlValidator is a QValidator for a field's validator. Acceptable text is a complete URL whose scheme is in schemes; http and https also need a host. Pair it with TelamonTextField.invalidText (TelamonTextField) so the field says what is wrong.

Since 1.5.0: a bare host such as example.com (or example.com:8080/a) is Intermediate when the first scheme is http or https, and fixup() puts that scheme in front of it ("https://example.com"), so the user can type it.

Like the other Telamon validators (TelamonEmailValidator, TelamonPathValidator, TelamonNumberValidator) it rejects text over a fixed length, uses no regular expressions and rejects NUL and other control characters. Intermediate means the user can still type a valid URL.

Example

TelamonTextField {
    validator: TelamonUrlValidator { schemes: ["https"] }
    invalidText: qsTr("Enter a web address starting with https://")
}

Properties

Name Type Default Description
schemes list<string> ["https"] The accepted URL schemes, without the colon, matched without regard to case. An empty list makes every non-empty text Invalid.

Note

Acceptable text is still not safe to splice into a URL or header unencoded. Text with spaces around it is Intermediate until fixup() trims it. Text over 2048 characters is Invalid.