MediaQuery.cpp 17 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505
  1. /*
  2. * Copyright (c) 2021, Sam Atkins <atkinssj@serenityos.org>
  3. *
  4. * SPDX-License-Identifier: BSD-2-Clause
  5. */
  6. #include <LibWeb/CSS/MediaQuery.h>
  7. #include <LibWeb/CSS/Serialize.h>
  8. #include <LibWeb/DOM/Document.h>
  9. #include <LibWeb/HTML/Window.h>
  10. namespace Web::CSS {
  11. NonnullRefPtr<MediaQuery> MediaQuery::create_not_all()
  12. {
  13. auto media_query = new MediaQuery;
  14. media_query->m_negated = true;
  15. media_query->m_media_type = MediaType::All;
  16. return adopt_ref(*media_query);
  17. }
  18. ErrorOr<String> MediaFeatureValue::to_string() const
  19. {
  20. return m_value.visit(
  21. [](ValueID const& ident) { return String::from_utf8(string_from_value_id(ident)); },
  22. [](Length const& length) { return length.to_string(); },
  23. [](Ratio const& ratio) { return ratio.to_string(); },
  24. [](Resolution const& resolution) { return resolution.to_string(); },
  25. [](float number) { return String::number(number); });
  26. }
  27. bool MediaFeatureValue::is_same_type(MediaFeatureValue const& other) const
  28. {
  29. return m_value.visit(
  30. [&](ValueID const&) { return other.is_ident(); },
  31. [&](Length const&) { return other.is_length(); },
  32. [&](Ratio const&) { return other.is_ratio(); },
  33. [&](Resolution const&) { return other.is_resolution(); },
  34. [&](float) { return other.is_number(); });
  35. }
  36. ErrorOr<String> MediaFeature::to_string() const
  37. {
  38. auto comparison_string = [](Comparison comparison) -> StringView {
  39. switch (comparison) {
  40. case Comparison::Equal:
  41. return "="sv;
  42. case Comparison::LessThan:
  43. return "<"sv;
  44. case Comparison::LessThanOrEqual:
  45. return "<="sv;
  46. case Comparison::GreaterThan:
  47. return ">"sv;
  48. case Comparison::GreaterThanOrEqual:
  49. return ">="sv;
  50. }
  51. VERIFY_NOT_REACHED();
  52. };
  53. switch (m_type) {
  54. case Type::IsTrue:
  55. return String::from_utf8(string_from_media_feature_id(m_id));
  56. case Type::ExactValue:
  57. return String::formatted("{}:{}", string_from_media_feature_id(m_id), TRY(m_value->to_string()));
  58. case Type::MinValue:
  59. return String::formatted("min-{}:{}", string_from_media_feature_id(m_id), TRY(m_value->to_string()));
  60. case Type::MaxValue:
  61. return String::formatted("max-{}:{}", string_from_media_feature_id(m_id), TRY(m_value->to_string()));
  62. case Type::Range:
  63. if (!m_range->right_comparison.has_value())
  64. return String::formatted("{} {} {}", TRY(m_range->left_value.to_string()), comparison_string(m_range->left_comparison), string_from_media_feature_id(m_id));
  65. return String::formatted("{} {} {} {} {}", TRY(m_range->left_value.to_string()), comparison_string(m_range->left_comparison), string_from_media_feature_id(m_id), comparison_string(*m_range->right_comparison), TRY(m_range->right_value->to_string()));
  66. }
  67. VERIFY_NOT_REACHED();
  68. }
  69. bool MediaFeature::evaluate(HTML::Window const& window) const
  70. {
  71. auto maybe_queried_value = window.query_media_feature(m_id);
  72. if (!maybe_queried_value.has_value())
  73. return false;
  74. auto queried_value = maybe_queried_value.release_value();
  75. switch (m_type) {
  76. case Type::IsTrue:
  77. if (queried_value.is_number())
  78. return queried_value.number() != 0;
  79. if (queried_value.is_length())
  80. return queried_value.length().raw_value() != 0;
  81. // FIXME: I couldn't figure out from the spec how ratios should be evaluated in a boolean context.
  82. if (queried_value.is_ratio())
  83. return !queried_value.ratio().is_degenerate();
  84. if (queried_value.is_resolution())
  85. return queried_value.resolution().to_dots_per_pixel() != 0;
  86. if (queried_value.is_ident()) {
  87. // NOTE: It is not technically correct to always treat `no-preference` as false, but every
  88. // media-feature that accepts it as a value treats it as false, so good enough. :^)
  89. // If other features gain this property for other identifiers in the future, we can
  90. // add more robust handling for them then.
  91. return queried_value.ident() != ValueID::None
  92. && queried_value.ident() != ValueID::NoPreference;
  93. }
  94. return false;
  95. case Type::ExactValue:
  96. return compare(window, *m_value, Comparison::Equal, queried_value);
  97. case Type::MinValue:
  98. return compare(window, queried_value, Comparison::GreaterThanOrEqual, *m_value);
  99. case Type::MaxValue:
  100. return compare(window, queried_value, Comparison::LessThanOrEqual, *m_value);
  101. case Type::Range:
  102. if (!compare(window, m_range->left_value, m_range->left_comparison, queried_value))
  103. return false;
  104. if (m_range->right_comparison.has_value())
  105. if (!compare(window, queried_value, *m_range->right_comparison, *m_range->right_value))
  106. return false;
  107. return true;
  108. }
  109. VERIFY_NOT_REACHED();
  110. }
  111. bool MediaFeature::compare(HTML::Window const& window, MediaFeatureValue left, Comparison comparison, MediaFeatureValue right)
  112. {
  113. if (!left.is_same_type(right))
  114. return false;
  115. if (left.is_ident()) {
  116. if (comparison == Comparison::Equal)
  117. return left.ident() == right.ident();
  118. return false;
  119. }
  120. if (left.is_number()) {
  121. switch (comparison) {
  122. case Comparison::Equal:
  123. return left.number() == right.number();
  124. case Comparison::LessThan:
  125. return left.number() < right.number();
  126. case Comparison::LessThanOrEqual:
  127. return left.number() <= right.number();
  128. case Comparison::GreaterThan:
  129. return left.number() > right.number();
  130. case Comparison::GreaterThanOrEqual:
  131. return left.number() >= right.number();
  132. }
  133. VERIFY_NOT_REACHED();
  134. }
  135. if (left.is_length()) {
  136. CSSPixels left_px;
  137. CSSPixels right_px;
  138. // Save ourselves some work if neither side is a relative length.
  139. if (left.length().is_absolute() && right.length().is_absolute()) {
  140. left_px = left.length().absolute_length_to_px();
  141. right_px = right.length().absolute_length_to_px();
  142. } else {
  143. auto viewport_rect = window.page()->web_exposed_screen_area();
  144. auto const& initial_font = window.associated_document().style_computer().initial_font();
  145. Gfx::FontPixelMetrics const& initial_font_metrics = initial_font.pixel_metrics();
  146. float initial_font_size = initial_font.presentation_size();
  147. left_px = left.length().to_px(viewport_rect, initial_font_metrics, initial_font_size, initial_font_size);
  148. right_px = right.length().to_px(viewport_rect, initial_font_metrics, initial_font_size, initial_font_size);
  149. }
  150. switch (comparison) {
  151. case Comparison::Equal:
  152. return left_px == right_px;
  153. case Comparison::LessThan:
  154. return left_px < right_px;
  155. case Comparison::LessThanOrEqual:
  156. return left_px <= right_px;
  157. case Comparison::GreaterThan:
  158. return left_px > right_px;
  159. case Comparison::GreaterThanOrEqual:
  160. return left_px >= right_px;
  161. }
  162. VERIFY_NOT_REACHED();
  163. }
  164. if (left.is_ratio()) {
  165. auto left_decimal = left.ratio().value();
  166. auto right_decimal = right.ratio().value();
  167. switch (comparison) {
  168. case Comparison::Equal:
  169. return left_decimal == right_decimal;
  170. case Comparison::LessThan:
  171. return left_decimal < right_decimal;
  172. case Comparison::LessThanOrEqual:
  173. return left_decimal <= right_decimal;
  174. case Comparison::GreaterThan:
  175. return left_decimal > right_decimal;
  176. case Comparison::GreaterThanOrEqual:
  177. return left_decimal >= right_decimal;
  178. }
  179. VERIFY_NOT_REACHED();
  180. }
  181. if (left.is_resolution()) {
  182. auto left_dppx = left.resolution().to_dots_per_pixel();
  183. auto right_dppx = right.resolution().to_dots_per_pixel();
  184. switch (comparison) {
  185. case Comparison::Equal:
  186. return left_dppx == right_dppx;
  187. case Comparison::LessThan:
  188. return left_dppx < right_dppx;
  189. case Comparison::LessThanOrEqual:
  190. return left_dppx <= right_dppx;
  191. case Comparison::GreaterThan:
  192. return left_dppx > right_dppx;
  193. case Comparison::GreaterThanOrEqual:
  194. return left_dppx >= right_dppx;
  195. }
  196. VERIFY_NOT_REACHED();
  197. }
  198. VERIFY_NOT_REACHED();
  199. }
  200. NonnullOwnPtr<MediaCondition> MediaCondition::from_general_enclosed(GeneralEnclosed&& general_enclosed)
  201. {
  202. auto result = new MediaCondition;
  203. result->type = Type::GeneralEnclosed;
  204. result->general_enclosed = move(general_enclosed);
  205. return adopt_own(*result);
  206. }
  207. NonnullOwnPtr<MediaCondition> MediaCondition::from_feature(MediaFeature&& feature)
  208. {
  209. auto result = new MediaCondition;
  210. result->type = Type::Single;
  211. result->feature = move(feature);
  212. return adopt_own(*result);
  213. }
  214. NonnullOwnPtr<MediaCondition> MediaCondition::from_not(NonnullOwnPtr<MediaCondition>&& condition)
  215. {
  216. auto result = new MediaCondition;
  217. result->type = Type::Not;
  218. result->conditions.append(move(condition));
  219. return adopt_own(*result);
  220. }
  221. NonnullOwnPtr<MediaCondition> MediaCondition::from_and_list(Vector<NonnullOwnPtr<MediaCondition>>&& conditions)
  222. {
  223. auto result = new MediaCondition;
  224. result->type = Type::And;
  225. result->conditions = move(conditions);
  226. return adopt_own(*result);
  227. }
  228. NonnullOwnPtr<MediaCondition> MediaCondition::from_or_list(Vector<NonnullOwnPtr<MediaCondition>>&& conditions)
  229. {
  230. auto result = new MediaCondition;
  231. result->type = Type::Or;
  232. result->conditions = move(conditions);
  233. return adopt_own(*result);
  234. }
  235. ErrorOr<String> MediaCondition::to_string() const
  236. {
  237. StringBuilder builder;
  238. builder.append('(');
  239. switch (type) {
  240. case Type::Single:
  241. builder.append(TRY(feature->to_string()));
  242. break;
  243. case Type::Not:
  244. builder.append("not "sv);
  245. builder.append(TRY(conditions.first()->to_string()));
  246. break;
  247. case Type::And:
  248. builder.join(" and "sv, conditions);
  249. break;
  250. case Type::Or:
  251. builder.join(" or "sv, conditions);
  252. break;
  253. case Type::GeneralEnclosed:
  254. builder.append(general_enclosed->to_string());
  255. break;
  256. }
  257. builder.append(')');
  258. return builder.to_string();
  259. }
  260. MatchResult MediaCondition::evaluate(HTML::Window const& window) const
  261. {
  262. switch (type) {
  263. case Type::Single:
  264. return as_match_result(feature->evaluate(window));
  265. case Type::Not:
  266. return negate(conditions.first()->evaluate(window));
  267. case Type::And:
  268. return evaluate_and(conditions, [&](auto& child) { return child->evaluate(window); });
  269. case Type::Or:
  270. return evaluate_or(conditions, [&](auto& child) { return child->evaluate(window); });
  271. case Type::GeneralEnclosed:
  272. return general_enclosed->evaluate();
  273. }
  274. VERIFY_NOT_REACHED();
  275. }
  276. ErrorOr<String> MediaQuery::to_string() const
  277. {
  278. StringBuilder builder;
  279. if (m_negated)
  280. builder.append("not "sv);
  281. if (m_negated || m_media_type != MediaType::All || !m_media_condition) {
  282. builder.append(CSS::to_string(m_media_type));
  283. if (m_media_condition)
  284. builder.append(" and "sv);
  285. }
  286. if (m_media_condition) {
  287. builder.append(TRY(m_media_condition->to_string()));
  288. }
  289. return builder.to_string();
  290. }
  291. bool MediaQuery::evaluate(HTML::Window const& window)
  292. {
  293. auto matches_media = [](MediaType media) -> MatchResult {
  294. switch (media) {
  295. case MediaType::All:
  296. return MatchResult::True;
  297. case MediaType::Print:
  298. // FIXME: Enable for printing, when we have printing!
  299. return MatchResult::False;
  300. case MediaType::Screen:
  301. // FIXME: Disable for printing, when we have printing!
  302. return MatchResult::True;
  303. case MediaType::Unknown:
  304. return MatchResult::False;
  305. // Deprecated, must never match:
  306. case MediaType::TTY:
  307. case MediaType::TV:
  308. case MediaType::Projection:
  309. case MediaType::Handheld:
  310. case MediaType::Braille:
  311. case MediaType::Embossed:
  312. case MediaType::Aural:
  313. case MediaType::Speech:
  314. return MatchResult::False;
  315. }
  316. VERIFY_NOT_REACHED();
  317. };
  318. MatchResult result = matches_media(m_media_type);
  319. if ((result == MatchResult::True) && m_media_condition)
  320. result = m_media_condition->evaluate(window);
  321. if (m_negated)
  322. result = negate(result);
  323. m_matches = result == MatchResult::True;
  324. return m_matches;
  325. }
  326. // https://www.w3.org/TR/cssom-1/#serialize-a-media-query-list
  327. ErrorOr<String> serialize_a_media_query_list(Vector<NonnullRefPtr<MediaQuery>> const& media_queries)
  328. {
  329. // 1. If the media query list is empty, then return the empty string.
  330. if (media_queries.is_empty())
  331. return String {};
  332. // 2. Serialize each media query in the list of media queries, in the same order as they
  333. // appear in the media query list, and then serialize the list.
  334. return String::join(", "sv, media_queries);
  335. }
  336. bool is_media_feature_name(StringView name)
  337. {
  338. // MEDIAQUERIES-4 - https://www.w3.org/TR/mediaqueries-4/#media-descriptor-table
  339. if (name.equals_ignoring_case("any-hover"sv))
  340. return true;
  341. if (name.equals_ignoring_case("any-pointer"sv))
  342. return true;
  343. if (name.equals_ignoring_case("aspect-ratio"sv))
  344. return true;
  345. if (name.equals_ignoring_case("color"sv))
  346. return true;
  347. if (name.equals_ignoring_case("color-gamut"sv))
  348. return true;
  349. if (name.equals_ignoring_case("color-index"sv))
  350. return true;
  351. if (name.equals_ignoring_case("device-aspect-ratio"sv))
  352. return true;
  353. if (name.equals_ignoring_case("device-height"sv))
  354. return true;
  355. if (name.equals_ignoring_case("device-width"sv))
  356. return true;
  357. if (name.equals_ignoring_case("grid"sv))
  358. return true;
  359. if (name.equals_ignoring_case("height"sv))
  360. return true;
  361. if (name.equals_ignoring_case("hover"sv))
  362. return true;
  363. if (name.equals_ignoring_case("monochrome"sv))
  364. return true;
  365. if (name.equals_ignoring_case("orientation"sv))
  366. return true;
  367. if (name.equals_ignoring_case("overflow-block"sv))
  368. return true;
  369. if (name.equals_ignoring_case("overflow-inline"sv))
  370. return true;
  371. if (name.equals_ignoring_case("pointer"sv))
  372. return true;
  373. if (name.equals_ignoring_case("resolution"sv))
  374. return true;
  375. if (name.equals_ignoring_case("scan"sv))
  376. return true;
  377. if (name.equals_ignoring_case("update"sv))
  378. return true;
  379. if (name.equals_ignoring_case("width"sv))
  380. return true;
  381. // MEDIAQUERIES-5 - https://www.w3.org/TR/mediaqueries-5/#media-descriptor-table
  382. if (name.equals_ignoring_case("prefers-color-scheme"sv))
  383. return true;
  384. // FIXME: Add other level 5 feature names
  385. return false;
  386. }
  387. MediaQuery::MediaType media_type_from_string(StringView name)
  388. {
  389. if (name.equals_ignoring_case("all"sv))
  390. return MediaQuery::MediaType::All;
  391. if (name.equals_ignoring_case("aural"sv))
  392. return MediaQuery::MediaType::Aural;
  393. if (name.equals_ignoring_case("braille"sv))
  394. return MediaQuery::MediaType::Braille;
  395. if (name.equals_ignoring_case("embossed"sv))
  396. return MediaQuery::MediaType::Embossed;
  397. if (name.equals_ignoring_case("handheld"sv))
  398. return MediaQuery::MediaType::Handheld;
  399. if (name.equals_ignoring_case("print"sv))
  400. return MediaQuery::MediaType::Print;
  401. if (name.equals_ignoring_case("projection"sv))
  402. return MediaQuery::MediaType::Projection;
  403. if (name.equals_ignoring_case("screen"sv))
  404. return MediaQuery::MediaType::Screen;
  405. if (name.equals_ignoring_case("speech"sv))
  406. return MediaQuery::MediaType::Speech;
  407. if (name.equals_ignoring_case("tty"sv))
  408. return MediaQuery::MediaType::TTY;
  409. if (name.equals_ignoring_case("tv"sv))
  410. return MediaQuery::MediaType::TV;
  411. return MediaQuery::MediaType::Unknown;
  412. }
  413. StringView to_string(MediaQuery::MediaType media_type)
  414. {
  415. switch (media_type) {
  416. case MediaQuery::MediaType::All:
  417. return "all"sv;
  418. case MediaQuery::MediaType::Aural:
  419. return "aural"sv;
  420. case MediaQuery::MediaType::Braille:
  421. return "braille"sv;
  422. case MediaQuery::MediaType::Embossed:
  423. return "embossed"sv;
  424. case MediaQuery::MediaType::Handheld:
  425. return "handheld"sv;
  426. case MediaQuery::MediaType::Print:
  427. return "print"sv;
  428. case MediaQuery::MediaType::Projection:
  429. return "projection"sv;
  430. case MediaQuery::MediaType::Screen:
  431. return "screen"sv;
  432. case MediaQuery::MediaType::Speech:
  433. return "speech"sv;
  434. case MediaQuery::MediaType::TTY:
  435. return "tty"sv;
  436. case MediaQuery::MediaType::TV:
  437. return "tv"sv;
  438. case MediaQuery::MediaType::Unknown:
  439. return "unknown"sv;
  440. }
  441. VERIFY_NOT_REACHED();
  442. }
  443. }