File: break_appeal.h

package info (click to toggle)
chromium 138.0.7204.183-1
  • links: PTS, VCS
  • area: main
  • in suites: trixie
  • size: 6,071,908 kB
  • sloc: cpp: 34,937,088; ansic: 7,176,967; javascript: 4,110,704; python: 1,419,953; asm: 946,768; xml: 739,971; pascal: 187,324; sh: 89,623; perl: 88,663; objc: 79,944; sql: 50,304; cs: 41,786; fortran: 24,137; makefile: 21,806; php: 13,980; tcl: 13,166; yacc: 8,925; ruby: 7,485; awk: 3,720; lisp: 3,096; lex: 1,327; ada: 727; jsp: 228; sed: 36
file content (41 lines) | stat: -rw-r--r-- 1,653 bytes parent folder | download | duplicates (7)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
// Copyright 2019 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

#ifndef THIRD_PARTY_BLINK_RENDERER_CORE_LAYOUT_BREAK_APPEAL_H_
#define THIRD_PARTY_BLINK_RENDERER_CORE_LAYOUT_BREAK_APPEAL_H_

namespace blink {

// The "appeal" of a breakpoint. Higher is better. The perfect appeal is when
// we're not violating any rules. As we violate rule after rule, appeal will
// decrease. When figuring out where to break, a layout algorithm will use the
// breakpoint with the highest appeal (first priority) that has progressed the
// furthest through the content (second priority). The list here is sorted by
// rule violation severity, i.e. reverse appeal.
enum BreakAppeal {
  // We're attempting to break at a really undesirable place. This is not a
  // valid class A, B or C breakpoint [1]. The only requirement we're satisfying
  // is to not slice monolithic content.
  //
  // [1] https://www.w3.org/TR/css-break-3/#possible-breaks
  kBreakAppealLastResort,

  // The worst thing we're violating is an avoid* value of break-before,
  // break-after, or break-inside.
  kBreakAppealViolatingBreakAvoid,

  // The only thing we're violating is orphans and/or widows requirements.
  kBreakAppealViolatingOrphansAndWidows,

  // We're not violating anything. This is a perfect break location. Note that
  // forced breaks are always perfect, since they trump everything else.
  kBreakAppealPerfect,
};

// Keep this one in sync with the above enum.
const int kBreakAppealBitsNeeded = 2;

}  // namespace blink

#endif  // THIRD_PARTY_BLINK_RENDERER_CORE_LAYOUT_BREAK_APPEAL_H_