Adw-1 ▶ Adw ▶ BreakpointConditionSince 1.4

constructor

• new BreakpointCondition(
      condition_1: BreakpointCondition,
      condition_2: BreakpointCondition,
  ): BreakpointCondition

  Parameters

  • condition_1: BreakpointCondition
  • condition_2: BreakpointCondition

  Returns BreakpointCondition

Static$gtype

copy

• copy(): BreakpointCondition

  Copies self.

  Returns BreakpointCondition

  a copy of self

free

• free(): void

  Frees self.

  Returns void

to_string

• to_string(): string

  Returns a textual representation of self.

  The returned string can be parsed by BreakpointCondition.parse.

  Returns string

  A newly allocated text string

Staticnew_and

• new_and(
      condition_1: BreakpointCondition,
      condition_2: BreakpointCondition,
  ): BreakpointCondition

  Parameters

  • condition_1: BreakpointCondition
  • condition_2: BreakpointCondition

  Returns BreakpointCondition

Staticnew_length

• new_length(
      type: Adw.BreakpointConditionLengthType,
      value: number,
      unit: Adw.LengthUnit,
  ): BreakpointCondition

  Parameters

  • type: Adw.BreakpointConditionLengthType
  • value: number
  • unit: Adw.LengthUnit

  Returns BreakpointCondition

Staticnew_or

• new_or(
      condition_1: BreakpointCondition,
      condition_2: BreakpointCondition,
  ): BreakpointCondition

  Parameters

  • condition_1: BreakpointCondition
  • condition_2: BreakpointCondition

  Returns BreakpointCondition

Staticnew_ratio

• new_ratio(
      type: Adw.BreakpointConditionRatioType,
      width: number,
      height: number,
  ): BreakpointCondition

  Parameters

  • type: Adw.BreakpointConditionRatioType
  • width: number
  • height: number

  Returns BreakpointCondition

Staticparse

• parse(str: string): BreakpointCondition

  Parses a condition from a string.

  Length conditions are specified as <type>: <value>[<unit>], where:

  • <type> can be min-width, max-width, min-height or max-height
  • <value> is a fractional number
  • <unit> can be px, pt or sp

  If the unit is omitted, px is assumed.

  See BreakpointCondition.new_length.

  Examples:

  • min-width: 500px
  • min-height: 400pt
  • max-width: 100sp
  • max-height: 500

  Ratio conditions are specified as <type>: <width>[/<height>], where:

  • <type> can be min-aspect-ratio or max-aspect-ratio
  • <width> and <height> are integer numbers

  See BreakpointCondition.new_ratio.

  The ratio is represented as <width> divided by <height>.

  If <height> is omitted, it's assumed to be 1.

  Examples:

  • min-aspect-ratio: 4/3
  • max-aspect-ratio: 1

  The logical operators and, or can be used to compose a complex condition as follows:

  • <condition> and <condition>: the condition is true when both <condition>s are true, same as when using BreakpointCondition.new_and
  • <condition> or <condition>: the condition is true when either of the <condition>s is true, same as when using BreakpointCondition.new_or

  Examples:

  • min-width: 400px and max-aspect-ratio: 4/3
  • max-width: 360sp or max-width: 360px

  Conditions can be further nested using parentheses, for example:

  • min-width: 400px and (max-aspect-ratio: 4/3 or max-height: 400px)

  If parentheses are omitted, the first operator takes priority.

  Parameters

  • str: string

    the string specifying the condition

  Returns BreakpointCondition