[{"data":1,"prerenderedAt":1385},["ShallowReactive",2],{"docs:\u002Fdocs\u002Ffoundations\u002Fmobile":3},{"id":4,"title":5,"body":6,"component":1375,"dependsOn":1376,"description":1377,"emitDescriptions":1378,"extension":1313,"meta":1379,"navigation":217,"order":127,"path":1380,"seo":1381,"status":1382,"stem":1383,"__hash__":1384},"docs\u002Fdocs\u002Ffoundations\u002Fmobile.md","Мобільні пристрої",{"type":7,"value":8,"toc":1359},"minimark",[9,18,23,41,85,92,131,137,142,145,339,365,394,398,412,447,450,454,469,522,526,537,591,610,637,641,644,690,697,797,801,836,840,859,865,927,934,938,1077,1081,1094,1246,1277,1281,1337,1341,1355],[10,11,12,13,17],"p",{},"Компоненти розраховані на телефон так само, як на десктоп: мобільні розміри\nпишуться першими, а ",[14,15,16],"code",{},"md:"," повертає десктопну щільність. Нижче — контракт,\nна який можна покладатися, і одна річ, яку мусить зробити сам проєкт.",[19,20,22],"h2",{"id":21},"що-має-зробити-проєкт","Що має зробити проєкт",[10,24,25,32,33,36,37,40],{},[26,27,28,31],"strong",{},[14,29,30],{},"viewport-fit=cover"," у meta viewport."," Без нього iOS тримає сторінку\nпоза вирізом камери й заокругленими кутами, і ",[14,34,35],{},"env(safe-area-inset-*)","\nзавжди дорівнює нулю — тобто всі безпечні зони бібліотеки (футер модалки,\nнижній sheet, тостер, ",[14,38,39],{},"UiActionBar",", бічні панелі) просто не діють.",[42,43,48],"pre",{"className":44,"code":45,"language":46,"meta":47,"style":47},"language-html shiki shiki-themes github-light github-dark","\u003Cmeta name=\"viewport\" content=\"width=device-width, initial-scale=1, viewport-fit=cover\">\n","html","",[14,49,50],{"__ignoreMap":47},[51,52,55,59,63,67,70,74,77,79,82],"span",{"class":53,"line":54},"line",1,[51,56,58],{"class":57},"sVt8B","\u003C",[51,60,62],{"class":61},"s9eBZ","meta",[51,64,66],{"class":65},"sScJk"," name",[51,68,69],{"class":57},"=",[51,71,73],{"class":72},"sZZnC","\"viewport\"",[51,75,76],{"class":65}," content",[51,78,69],{"class":57},[51,80,81],{"class":72},"\"width=device-width, initial-scale=1, viewport-fit=cover\"",[51,83,84],{"class":57},">\n",[10,86,87,88,91],{},"Разом із цим сторінка заходить під виріз, тож власний хром проєкту має\nтримати бічні зони сам. Найпростіше — на ",[14,89,90],{},"body",":",[42,93,97],{"className":94,"code":95,"language":96,"meta":47,"style":47},"language-css shiki shiki-themes github-light github-dark","body {\n  padding-left: env(safe-area-inset-left);\n  padding-right: env(safe-area-inset-right);\n}\n","css",[14,98,99,106,116,125],{"__ignoreMap":47},[51,100,101,103],{"class":53,"line":54},[51,102,90],{"class":61},[51,104,105],{"class":57}," {\n",[51,107,109,113],{"class":53,"line":108},2,[51,110,112],{"class":111},"sj4cs","  padding-left",[51,114,115],{"class":57},": env(safe-area-inset-left);\n",[51,117,119,122],{"class":53,"line":118},3,[51,120,121],{"class":111},"  padding-right",[51,123,124],{"class":57},": env(safe-area-inset-right);\n",[51,126,128],{"class":53,"line":127},4,[51,129,130],{"class":57},"}\n",[10,132,133,134,136],{},"Фіксовані оверлеї бібліотеки рахують зони самостійно і від ",[14,135,90],{}," не\nзалежать.",[138,139,141],"h3",{"id":140},"нативне-відчуття-на-дотику","Нативне відчуття на дотику",[10,143,144],{},"Кілька рядків базового CSS проєкту прибирають ознаки «сайту» на телефоні:\nсірий спалах під пальцем, зум сторінки подвійним тапом і виділення тексту\nінтерфейсу довгим натисканням (воно конфліктує з контекстним меню).",[42,146,148],{"className":94,"code":147,"language":96,"meta":47,"style":47},"html {\n  -webkit-text-size-adjust: 100%;   \u002F* iOS у ландшафті не роздуває текст *\u002F\n  -webkit-tap-highlight-color: transparent;\n  touch-action: manipulation;       \u002F* без double-tap-zoom; щипок лишається *\u002F\n}\n\n@media (hover: none) and (pointer: coarse) {\n  body { -webkit-user-select: none; user-select: none; }\n  \u002F* iOS не дає друкувати в contenteditable під user-select: none *\u002F\n  input, textarea, [contenteditable='true'], .ui-selectable {\n    -webkit-user-select: text; user-select: text;\n  }\n}\n",[14,149,150,156,178,191,207,212,219,240,270,276,307,328,334],{"__ignoreMap":47},[51,151,152,154],{"class":53,"line":54},[51,153,46],{"class":61},[51,155,105],{"class":57},[51,157,158,161,164,167,171,174],{"class":53,"line":108},[51,159,160],{"class":111},"  -webkit-text-size-adjust",[51,162,163],{"class":57},": ",[51,165,166],{"class":111},"100",[51,168,170],{"class":169},"szBVR","%",[51,172,173],{"class":57},";   ",[51,175,177],{"class":176},"sJ8bj","\u002F* iOS у ландшафті не роздуває текст *\u002F\n",[51,179,180,183,185,188],{"class":53,"line":118},[51,181,182],{"class":111},"  -webkit-tap-highlight-color",[51,184,163],{"class":57},[51,186,187],{"class":111},"transparent",[51,189,190],{"class":57},";\n",[51,192,193,196,198,201,204],{"class":53,"line":127},[51,194,195],{"class":111},"  touch-action",[51,197,163],{"class":57},[51,199,200],{"class":111},"manipulation",[51,202,203],{"class":57},";       ",[51,205,206],{"class":176},"\u002F* без double-tap-zoom; щипок лишається *\u002F\n",[51,208,210],{"class":53,"line":209},5,[51,211,130],{"class":57},[51,213,215],{"class":53,"line":214},6,[51,216,218],{"emptyLinePlaceholder":217},true,"\n",[51,220,222,225,228,231,234,237],{"class":53,"line":221},7,[51,223,224],{"class":169},"@media",[51,226,227],{"class":57}," (",[51,229,230],{"class":111},"hover",[51,232,233],{"class":57},": none) ",[51,235,236],{"class":169},"and",[51,238,239],{"class":57}," (pointer: coarse) {\n",[51,241,243,246,249,252,254,257,260,263,265,267],{"class":53,"line":242},8,[51,244,245],{"class":61},"  body",[51,247,248],{"class":57}," { ",[51,250,251],{"class":111},"-webkit-user-select",[51,253,163],{"class":57},[51,255,256],{"class":111},"none",[51,258,259],{"class":57},"; ",[51,261,262],{"class":111},"user-select",[51,264,163],{"class":57},[51,266,256],{"class":111},[51,268,269],{"class":57},"; }\n",[51,271,273],{"class":53,"line":272},9,[51,274,275],{"class":176},"  \u002F* iOS не дає друкувати в contenteditable під user-select: none *\u002F\n",[51,277,279,282,285,288,291,294,296,299,302,305],{"class":53,"line":278},10,[51,280,281],{"class":61},"  input",[51,283,284],{"class":57},", ",[51,286,287],{"class":61},"textarea",[51,289,290],{"class":57},", [",[51,292,293],{"class":65},"contenteditable",[51,295,69],{"class":169},[51,297,298],{"class":72},"'true'",[51,300,301],{"class":57},"], ",[51,303,304],{"class":65},".ui-selectable",[51,306,105],{"class":57},[51,308,310,313,315,318,320,322,324,326],{"class":53,"line":309},11,[51,311,312],{"class":111},"    -webkit-user-select",[51,314,163],{"class":57},[51,316,317],{"class":111},"text",[51,319,259],{"class":57},[51,321,262],{"class":111},[51,323,163],{"class":57},[51,325,317],{"class":111},[51,327,190],{"class":57},[51,329,331],{"class":53,"line":330},12,[51,332,333],{"class":57},"  }\n",[51,335,337],{"class":53,"line":336},13,[51,338,130],{"class":57},[10,340,341,344,345,348,349,352,353,356,357,360,361,364],{},[14,342,343],{},"touch-action: manipulation"," на ",[14,346,347],{},"\u003Chtml>"," діє на всю сторінку: частина\n",[14,350,351],{},"touch-action",", що відповідає за зум, областями прокрутки не скидається.\nВідгук на дотик тоді дають власні ",[14,354,355],{},"active:","-стани — а iOS Safari вмикає\n",[14,358,359],{},":active"," лише за наявності обробника ",[14,362,363],{},"touchstart",", тож один раз на\nзастосунок:",[42,366,370],{"className":367,"code":368,"language":369,"meta":47,"style":47},"language-ts shiki shiki-themes github-light github-dark","import { enableTouchActiveStates } from '~\u002Futils\u002Ftouch'\nenableTouchActiveStates()\n","ts",[14,371,372,386],{"__ignoreMap":47},[51,373,374,377,380,383],{"class":53,"line":54},[51,375,376],{"class":169},"import",[51,378,379],{"class":57}," { enableTouchActiveStates } ",[51,381,382],{"class":169},"from",[51,384,385],{"class":72}," '~\u002Futils\u002Ftouch'\n",[51,387,388,391],{"class":53,"line":108},[51,389,390],{"class":65},"enableTouchActiveStates",[51,392,393],{"class":57},"()\n",[138,395,397],{"id":396},"масштаб-на-дотику","Масштаб на дотику",[10,399,400,401,404,405,407,408,411],{},"Корінь 15px — щільність для миші. На дотиковому пристрої застосунок\nприродніше виглядає з коренем 16px: усі ",[14,402,403],{},"rem"," (кегль, відступи, висоти\nшапок і кнопок) ростуть на ~7%, ближче до нативних 16–17pt. Межі ",[14,406,16],{},"\u002F",[14,409,410],{},"xl:","\nвід цього не зсуваються — rem у медіазапиті рахується від шрифту браузера.",[42,413,415],{"className":94,"code":414,"language":96,"meta":47,"style":47},"@media (pointer: coarse) {\n  html { font-size: 16px; }\n}\n",[14,416,417,423,443],{"__ignoreMap":47},[51,418,419,421],{"class":53,"line":54},[51,420,224],{"class":169},[51,422,239],{"class":57},[51,424,425,428,430,433,435,438,441],{"class":53,"line":108},[51,426,427],{"class":61},"  html",[51,429,248],{"class":57},[51,431,432],{"class":111},"font-size",[51,434,163],{"class":57},[51,436,437],{"class":111},"16",[51,439,440],{"class":169},"px",[51,442,269],{"class":57},[51,444,445],{"class":53,"line":118},[51,446,130],{"class":57},[10,448,449],{},"Перевірте тоді власні числа в px, що залежать від кегля (оцінки висот\nрядків у віртуальних списках): їх треба множити на корінь документа.",[138,451,453],{"id":452},"колір-рядка-стану","Колір рядка стану",[10,455,456,457,460,461,464,465,468],{},"Статичні ",[14,458,459],{},"\u003Cmeta name=\"theme-color\" media=\"…\">"," знають лише тему ОС, а тему\nперемикають і вручну. ",[14,462,463],{},"startThemeColor"," тримає рядок стану телефона й панель\nбраузера в кольорі шапки поточної теми застосунку (",[14,466,467],{},"--bg-card"," або свій\nтокен); поверхня на весь екран — відеодзвінок, перегляд — кладе свій колір\nповерх і знімає, коли закривається.",[42,470,472],{"className":367,"code":471,"language":369,"meta":47,"style":47},"import { pushThemeColorSurface, startThemeColor } from '~\u002Futils\u002FthemeColor'\nstartThemeColor()                                   \u002F\u002F один раз на застосунок\nconst restore = pushThemeColorSurface('--stage')    \u002F\u002F дзвінок на весь екран\n",[14,473,474,486,496],{"__ignoreMap":47},[51,475,476,478,481,483],{"class":53,"line":54},[51,477,376],{"class":169},[51,479,480],{"class":57}," { pushThemeColorSurface, startThemeColor } ",[51,482,382],{"class":169},[51,484,485],{"class":72}," '~\u002Futils\u002FthemeColor'\n",[51,487,488,490,493],{"class":53,"line":108},[51,489,463],{"class":65},[51,491,492],{"class":57},"()                                   ",[51,494,495],{"class":176},"\u002F\u002F один раз на застосунок\n",[51,497,498,501,504,507,510,513,516,519],{"class":53,"line":118},[51,499,500],{"class":169},"const",[51,502,503],{"class":111}," restore",[51,505,506],{"class":169}," =",[51,508,509],{"class":65}," pushThemeColorSurface",[51,511,512],{"class":57},"(",[51,514,515],{"class":72},"'--stage'",[51,517,518],{"class":57},")    ",[51,520,521],{"class":176},"\u002F\u002F дзвінок на весь екран\n",[138,523,525],{"id":524},"системне-назад","Системне «назад»",[10,527,528,529,532,533,536],{},"Кнопка чи жест «назад» Android і «назад» браузера на телефоні мають\nспершу закривати верхню шторку, меню чи вікно — так само, як Escape, — і\nлише потім іти з екрана. ",[14,530,531],{},"useSystemBack"," робить це для всіх оверлеїв\nбібліотеки (і для шарів застосунку з ",[14,534,535],{},"layers","): поки шар відкритий, поверх\nзапису історії лежить запис-охоронець з тією самою адресою.",[42,538,540],{"className":367,"code":539,"language":369,"meta":47,"style":47},"\u002F\u002F main.ts — ПЕРШИМ рядком, до імпорту роутера\nimport '~\u002Futils\u002FpopstateFirst'\n\u002F\u002F …\nuseSystemBack({ router, layers: [{ open: () => callFull.value, close: () => minimize() }] })\n",[14,541,542,547,554,559],{"__ignoreMap":47},[51,543,544],{"class":53,"line":54},[51,545,546],{"class":176},"\u002F\u002F main.ts — ПЕРШИМ рядком, до імпорту роутера\n",[51,548,549,551],{"class":53,"line":108},[51,550,376],{"class":169},[51,552,553],{"class":72}," '~\u002Futils\u002FpopstateFirst'\n",[51,555,556],{"class":53,"line":118},[51,557,558],{"class":176},"\u002F\u002F …\n",[51,560,561,563,566,569,572,575,578,581,583,585,588],{"class":53,"line":127},[51,562,531],{"class":65},[51,564,565],{"class":57},"({ router, layers: [{ ",[51,567,568],{"class":65},"open",[51,570,571],{"class":57},": () ",[51,573,574],{"class":169},"=>",[51,576,577],{"class":57}," callFull.value, ",[51,579,580],{"class":65},"close",[51,582,571],{"class":57},[51,584,574],{"class":169},[51,586,587],{"class":65}," minimize",[51,589,590],{"class":57},"() }] })\n",[10,592,593,595,596,599,600,603,604,609],{},[14,594,535],{}," — для шарів, що лежать нижче за оверлеї бібліотеки. Шар,\nпоставлений у сам стек (",[14,597,598],{},"useOverlayLayer","), закривається звичайним шляхом\nEscape, а якщо на Escape він не реагує, але на «назад» має (дзвінок на весь\nекран згортається), передає ",[14,601,602],{},"useOverlayLayer(id, { onBack })"," — див.\n",[605,606,608],"a",{"href":607},"\u002Fdocs\u002Fpatterns\u002Foverlays#%D0%B2%D0%BB%D0%B0%D1%81%D0%BD%D0%B8%D0%B9-%D1%88%D0%B0%D1%80-%D0%B7%D0%B0%D1%81%D1%82%D0%BE%D1%81%D1%83%D0%BD%D0%BA%D1%83-%D0%B2-%D1%81%D1%82%D0%B5%D0%BA%D1%83","«Власний шар застосунку в стеку»",".",[10,611,612,613,616,617,620,621,624,625,628,629,632,633,636],{},"Слухач ",[14,614,615],{},"popstate"," має стати раніше за роутер: тоді крок назад, що зняв\nохоронця, роутер не бачить узагалі. У Nuxt роутер створює плагін\nфреймворку раніше за будь-який імпорт, тож той самий слухач ставить\nінлайн-скрипт ",[14,618,619],{},"POPSTATE_FIRST_SCRIPT"," в ",[14,622,623],{},"app.head.script",". Програмний крок\nназад (",[14,626,627],{},"router.back()"," з кнопки «Назад») — після ",[14,630,631],{},"await releaseSystemBack()",":\nінакше він зняв би охоронця щойно закритого вікна, а не екран. З мишею\n«назад» браузера лишається навігацією (",[14,634,635],{},"touchOnly",").",[19,638,640],{"id":639},"ціль-дотику-44px-зони-а-не-заливки","Ціль дотику — 44px зони, а не заливки",[10,642,643],{},"Точність дотику вимірюється цільовою зоною (W3C 2.5.8), а не видимою\nвисотою. Тому ієрархія розмірів на телефоні лишається, а дотик тримають\nтри прийоми:",[645,646,647,662,680],"ul",{},[648,649,650,653,654,657,658,661],"li",{},[26,651,652],{},"Фізична висота 45px"," там, де елемент і є рядком: поля вводу (",[14,655,656],{},"h-12","),\nпункти випадайок і меню, картки вибору в ",[14,659,660],{},"UiRadioGroup",", рядки\nналаштувань колонок таблиці.",[648,663,664,667,668,671,672,675,676,679],{},[26,665,666],{},"Невидима зона 45×45"," через ",[14,669,670],{},"pointer-coarse:after:"," навколо дрібних\nелементів: кнопки, хрестики очищення, квадратик ",[14,673,674],{},"UiCheckbox",", кнопки\nтулбара редактора, посилання ",[14,677,678],{},"UiBreadcrumb",", заголовки колонок, що\nсортуються. На пристрої з мишею зони немає.",[648,681,682,685,686,689],{},[26,683,684],{},"Гнучка сітка",", де елементи стоять впритул і зона накрила б сусіда:\nклітинка дня в ",[14,687,688],{},"UiCalendar"," росте до 45px, але не ширша за сьому частину\nекрана — на 320px вона стискається, а сітка лишається в екрані.",[10,691,692,693,696],{},"Для власних пунктів меню в слоті ",[14,694,695],{},"content"," є спільний клас — висота 45px на\nтелефоні, щільно на десктопі. Колір тексту додається окремо:",[42,698,702],{"className":699,"code":700,"language":701,"meta":47,"style":47},"language-vue shiki shiki-themes github-light github-dark","\u003Cscript setup lang=\"ts\">\nimport { menuItemClass } from '~\u002Futils\u002FuiFieldStyles'\n\u003C\u002Fscript>\n\n\u003Ctemplate>\n  \u003Cbutton role=\"menuitem\" :class=\"[menuItemClass, 'text-danger']\">Видалити\u003C\u002Fbutton>\n\u003C\u002Ftemplate>\n","vue",[14,703,704,724,736,745,749,758,789],{"__ignoreMap":47},[51,705,706,708,711,714,717,719,722],{"class":53,"line":54},[51,707,58],{"class":57},[51,709,710],{"class":61},"script",[51,712,713],{"class":65}," setup",[51,715,716],{"class":65}," lang",[51,718,69],{"class":57},[51,720,721],{"class":72},"\"ts\"",[51,723,84],{"class":57},[51,725,726,728,731,733],{"class":53,"line":108},[51,727,376],{"class":169},[51,729,730],{"class":57}," { menuItemClass } ",[51,732,382],{"class":169},[51,734,735],{"class":72}," '~\u002Futils\u002FuiFieldStyles'\n",[51,737,738,741,743],{"class":53,"line":118},[51,739,740],{"class":57},"\u003C\u002F",[51,742,710],{"class":61},[51,744,84],{"class":57},[51,746,747],{"class":53,"line":127},[51,748,218],{"emptyLinePlaceholder":217},[51,750,751,753,756],{"class":53,"line":209},[51,752,58],{"class":57},[51,754,755],{"class":61},"template",[51,757,84],{"class":57},[51,759,760,763,766,769,771,774,777,779,782,785,787],{"class":53,"line":214},[51,761,762],{"class":57},"  \u003C",[51,764,765],{"class":61},"button",[51,767,768],{"class":65}," role",[51,770,69],{"class":57},[51,772,773],{"class":72},"\"menuitem\"",[51,775,776],{"class":65}," :class",[51,778,69],{"class":57},[51,780,781],{"class":72},"\"[menuItemClass, 'text-danger']\"",[51,783,784],{"class":57},">Видалити\u003C\u002F",[51,786,765],{"class":61},[51,788,84],{"class":57},[51,790,791,793,795],{"class":53,"line":221},[51,792,740],{"class":57},[51,794,755],{"class":61},[51,796,84],{"class":57},[19,798,800],{"id":799},"текст-полів-16px","Текст полів — 16px",[10,802,803,804,806,807,810,811,814,815,620,818,821,822,825,826,829,830,832,833,609],{},"iOS Safari при фокусі на поле з ",[14,805,432],{}," менше 16px автоматично зумує\nсторінку. Корінь документа — 15px, тож ",[14,808,809],{},"text-base"," (1rem) дає 15px і\nтеж зумує (з коренем 16px на дотику — див. вище — вже ні, але піксельне\nзначення лишається надійнішим). Тому текст полів на мобільному — ",[14,812,813],{},"text-[16px]"," у пікселях\n(",[14,816,817],{},"fieldTextSizes",[14,819,820],{},"uiFieldStyles.ts","). Те саме стосується пошуку\nвсередині випадайок, прихованого поля ",[14,823,824],{},"UiInputOtp"," і самого редактора\n",[14,827,828],{},"UiRichTextEditor"," — ",[14,831,293],{}," зумує так само, як ",[14,834,835],{},"\u003Cinput>",[19,837,839],{"id":838},"клавіатура-і-видима-область","Клавіатура і видима область",[10,841,842,843,846,847,850,851,854,855,858],{},"Екранна клавіатура на iOS і на Android (з Chrome 108) ",[26,844,845],{},"не"," зменшує\n",[14,848,849],{},"innerHeight",": випадайка під полем, яка за цим числом «влазить», фізично\nлежить під клавіатурою. Усі плаваючі панелі бібліотеки рахують позицію від\n",[14,852,853],{},"visualViewport"," і переміщуються, коли клавіатура виїжджає чи ховається:\nпанель перевертається догори або отримує ",[14,856,857],{},"max-height"," і прокрутку.",[10,860,861,862,91],{},"Для власного оверлея — ті самі функції з ",[14,863,864],{},"utils\u002FoverlayPosition.ts",[42,866,868],{"className":367,"code":867,"language":369,"meta":47,"style":47},"const viewport = getVisibleViewport()          \u002F\u002F видима область, а не innerHeight\nconst point = placeAnchoredPanel(anchor.getBoundingClientRect(), panel, viewport)\nconst stop = listenViewportChanges(updatePosition) \u002F\u002F scroll, resize, клавіатура\n",[14,869,870,888,909],{"__ignoreMap":47},[51,871,872,874,877,879,882,885],{"class":53,"line":54},[51,873,500],{"class":169},[51,875,876],{"class":111}," viewport",[51,878,506],{"class":169},[51,880,881],{"class":65}," getVisibleViewport",[51,883,884],{"class":57},"()          ",[51,886,887],{"class":176},"\u002F\u002F видима область, а не innerHeight\n",[51,889,890,892,895,897,900,903,906],{"class":53,"line":108},[51,891,500],{"class":169},[51,893,894],{"class":111}," point",[51,896,506],{"class":169},[51,898,899],{"class":65}," placeAnchoredPanel",[51,901,902],{"class":57},"(anchor.",[51,904,905],{"class":65},"getBoundingClientRect",[51,907,908],{"class":57},"(), panel, viewport)\n",[51,910,911,913,916,918,921,924],{"class":53,"line":118},[51,912,500],{"class":169},[51,914,915],{"class":111}," stop",[51,917,506],{"class":169},[51,919,920],{"class":65}," listenViewportChanges",[51,922,923],{"class":57},"(updatePosition) ",[51,925,926],{"class":176},"\u002F\u002F scroll, resize, клавіатура\n",[10,928,929,930,933],{},"Прокручувані панелі мають ",[14,931,932],{},"overscroll-contain",": докрутивши список до кінця,\nпалець не тягне за собою сторінку під оверлеєм.",[19,935,937],{"id":936},"жести","Жести",[939,940,941,954],"table",{},[942,943,944],"thead",{},[945,946,947,951],"tr",{},[948,949,950],"th",{},"Компонент",[948,952,953],{},"На дотику",[955,956,957,968,978,996,1006,1020,1038,1048,1058,1068],"tbody",{},[945,958,959,965],{},[960,961,962],"td",{},[14,963,964],{},"UiTooltip",[960,966,967],{},"Довге натискання (0,5 с) показує підказку, відпускання ховає її через 1,5 с. Клік після довгого натискання гаситься — людина хотіла прочитати, а не натиснути.",[945,969,970,975],{},[960,971,972],{},[14,973,974],{},"UiHoverCard",[960,976,977],{},"Не відкривається. Наведення немає, а картка, що відкривалася від тапу по посиланню, блимала перед переходом.",[945,979,980,985],{},[960,981,982],{},[14,983,984],{},"UiContextMenu",[960,986,987,988,991,992,995],{},"Довге натискання — на Android через ",[14,989,990],{},"contextmenu",", на iOS власним таймером. З ",[14,993,994],{},"haptic"," — короткий відгук вібрацією (Android).",[945,997,998,1003],{},[960,999,1000],{},[14,1001,1002],{},"UiCarousel",[960,1004,1005],{},"Свайп із фліком і блокуванням осі; стрілок на дотику немає.",[945,1007,1008,1013],{},[960,1009,1010],{},[14,1011,1012],{},"UiDrawer",[960,1014,1015,1016,1019],{},"Ручка свайпу закриває нижню панель. З ",[14,1017,1018],{},"swipe-to-close-side"," бічну закриває свайп до її краю з будь-якого місця панелі.",[945,1021,1022,1027],{},[960,1023,1024],{},[14,1025,1026],{},"UiModal",[960,1028,1029,1030,1033,1034,1037],{},"З ",[14,1031,1032],{},"swipe-to-close"," шторка (до ",[14,1035,1036],{},"sm",") має ручку й закривається свайпом униз за ручку чи шапку.",[945,1039,1040,1045],{},[960,1041,1042],{},[14,1043,1044],{},"UiSwipeActions",[960,1046,1047],{},"Свайп рядка ліворуч відкриває дії під ним; дотик повз, прокрутка чи свайп праворуч закривають.",[945,1049,1050,1055],{},[960,1051,1052],{},[14,1053,1054],{},"UiSwipeStack",[960,1056,1057],{},"Свайп праворуч з будь-якого місця верхнього екрана тягне його за пальцем і повертає назад.",[945,1059,1060,1065],{},[960,1061,1062],{},[14,1063,1064],{},"UiToaster",[960,1066,1067],{},"Картку можна змахнути вбік.",[945,1069,1070,1072],{},[960,1071,525],{},[960,1073,1029,1074,1076],{},[14,1075,531],{}," закриває верхній оверлей, а не екран під ним.",[138,1078,1080],{"id":1079},"власні-жести","Власні жести",[10,1082,1083,1084,1087,1088,1090,1091,1093],{},"Ядро горизонтальних свайпів — ",[14,1085,1086],{},"utils\u002Fswipe.ts",", спільне для ",[14,1089,1044],{},"\nі ",[14,1092,1054],{},": блокування осі (вертикаль лишається прокрутці), поріг і\nкидок, опір після межі, гасіння кліку, що прийшов слідом за свайпом.",[42,1095,1097],{"className":367,"code":1096,"language":369,"meta":47,"style":47},"import { bindSwipe, rubberBand } from '~\u002Futils\u002Fswipe'\n\nconst stop = bindSwipe(listEl, {\n  direction: 'left',\n  onMove: (dx) => (row.style.transform = `translateX(${rubberBand(dx, 84)}px)`),\n  onEnd: ({ dx, cancelled }) => { if (!cancelled && dx \u003C -56) reply() },\n})\n",[14,1098,1099,1111,1115,1129,1140,1186,1241],{"__ignoreMap":47},[51,1100,1101,1103,1106,1108],{"class":53,"line":54},[51,1102,376],{"class":169},[51,1104,1105],{"class":57}," { bindSwipe, rubberBand } ",[51,1107,382],{"class":169},[51,1109,1110],{"class":72}," '~\u002Futils\u002Fswipe'\n",[51,1112,1113],{"class":53,"line":108},[51,1114,218],{"emptyLinePlaceholder":217},[51,1116,1117,1119,1121,1123,1126],{"class":53,"line":118},[51,1118,500],{"class":169},[51,1120,915],{"class":111},[51,1122,506],{"class":169},[51,1124,1125],{"class":65}," bindSwipe",[51,1127,1128],{"class":57},"(listEl, {\n",[51,1130,1131,1134,1137],{"class":53,"line":127},[51,1132,1133],{"class":57},"  direction: ",[51,1135,1136],{"class":72},"'left'",[51,1138,1139],{"class":57},",\n",[51,1141,1142,1145,1148,1152,1155,1157,1160,1162,1165,1168,1170,1172,1174,1177,1180,1183],{"class":53,"line":209},[51,1143,1144],{"class":65},"  onMove",[51,1146,1147],{"class":57},": (",[51,1149,1151],{"class":1150},"s4XuR","dx",[51,1153,1154],{"class":57},") ",[51,1156,574],{"class":169},[51,1158,1159],{"class":57}," (row.style.transform ",[51,1161,69],{"class":169},[51,1163,1164],{"class":72}," `translateX(${",[51,1166,1167],{"class":65},"rubberBand",[51,1169,512],{"class":72},[51,1171,1151],{"class":57},[51,1173,284],{"class":72},[51,1175,1176],{"class":111},"84",[51,1178,1179],{"class":72},")",[51,1181,1182],{"class":72},"}px)`",[51,1184,1185],{"class":57},"),\n",[51,1187,1188,1191,1194,1196,1198,1201,1204,1206,1208,1211,1213,1216,1219,1222,1225,1227,1230,1233,1235,1238],{"class":53,"line":214},[51,1189,1190],{"class":65},"  onEnd",[51,1192,1193],{"class":57},": ({ ",[51,1195,1151],{"class":1150},[51,1197,284],{"class":57},[51,1199,1200],{"class":1150},"cancelled",[51,1202,1203],{"class":57}," }) ",[51,1205,574],{"class":169},[51,1207,248],{"class":57},[51,1209,1210],{"class":169},"if",[51,1212,227],{"class":57},[51,1214,1215],{"class":169},"!",[51,1217,1218],{"class":57},"cancelled ",[51,1220,1221],{"class":169},"&&",[51,1223,1224],{"class":57}," dx ",[51,1226,58],{"class":169},[51,1228,1229],{"class":169}," -",[51,1231,1232],{"class":111},"56",[51,1234,1154],{"class":57},[51,1236,1237],{"class":65},"reply",[51,1239,1240],{"class":57},"() },\n",[51,1242,1243],{"class":53,"line":221},[51,1244,1245],{"class":57},"})\n",[10,1247,1248,1249,1252,1253,1256,1257,1260,1261,1264,1265,1268,1269,1272,1273,1276],{},"Область жесту й кожна область прокрутки в ній мають ",[14,1250,1251],{},"touch-action: pan-y pinch-zoom"," (класи ",[14,1254,1255],{},"touch-pan-y touch-pinch-zoom","): інакше браузер забирає\nгоризонтальний рух собі й шле ",[14,1258,1259],{},"pointercancel",". Жест не починається з полів,\nповзунків, полотна й будь-чого з ",[14,1262,1263],{},"touch-action: none"," (навіть інлайн-\nстилем); решту виключає атрибут ",[14,1266,1267],{},"data-no-swipe",". Миша свайпом не\nкористується. Область, що сама прокручується вбік, перевіряє\n",[14,1270,1271],{},"inHorizontalScroll(event.target, el)"," у ",[14,1274,1275],{},"canStart",": без цього жест встигав\nби зсунути екран на кілька пікселів, перш ніж браузер забере дотик собі.",[19,1278,1280],{"id":1279},"розкладка-на-вузьких-екранах","Розкладка на вузьких екранах",[645,1282,1283,1291,1297,1306,1319,1328],{},[648,1284,1285,1287,1288,1290],{},[14,1286,1026],{}," нижче ",[14,1289,1036],{}," — нижній sheet, а не вікно посередині.",[648,1292,1293,1296],{},[14,1294,1295],{},"UiDateRangePicker"," на телефоні показує один місяць, а пресети — смугою\nпігулок над сіткою, що прокручується вбік.",[648,1298,1299,1302,1303,1305],{},[14,1300,1301],{},"UiStepper"," у горизонтальному ряду нижче ",[14,1304,1036],{}," показує підпис лише\nактивного кроку; решта — кружечки й лінії, підписи лишаються для\nскрінрідера.",[648,1307,1308,1287,1311,1314,1315,1318],{},[14,1309,1310],{},"UiTable",[14,1312,1313],{},"md"," — картки. Шапки там немає, тож сортування живе в\nокремому рядку над картками: нативний ",[14,1316,1317],{},"\u003Cselect>"," і кнопка напрямку.",[648,1320,1321,1324,1325,636],{},[14,1322,1323],{},"UiButton"," не переносить підпис: висота кнопки фіксована, і другий рядок\nвиходив би за заливку. Ряд кнопок, що не влазить, має переноситися сам\n(",[14,1326,1327],{},"flex-wrap",[648,1329,1330,1332,1333,1336],{},[14,1331,1002],{}," і ",[14,1334,1335],{},"UiVirtualList"," займають усю ширину батька.",[19,1338,1340],{"id":1339},"як-перевіряти","Як перевіряти",[10,1342,1343,1344,1347,1348,1351,1352,1354],{},"Режим пристрою в DevTools з увімкненим дотиком: без нього ",[14,1345,1346],{},"pointer: coarse","\nне спрацьовує, і невидимих зон просто не видно. Свайпи в автотестах —\nсправжніми дотиками (у Chromium — CDP ",[14,1349,1350],{},"Input.dispatchTouchEvent","): на відміну\nвід синтетичних PointerEvent вони поважають ",[14,1353,351],{},", тож видно, коли\nбраузер забирає жест собі. Перевіряти на 320px і\n375px — у 320px першими виходять за край ряди кнопок і сітки. На справжньому\niPhone окремо варто перевірити фокус у полі (зум) і відкриту клавіатуру\nпід випадайкою.",[1356,1357,1358],"style",{},"html pre.shiki code .sVt8B, html code.shiki .sVt8B{--shiki-default:#24292E;--shiki-dark:#E1E4E8}html pre.shiki code .s9eBZ, html code.shiki .s9eBZ{--shiki-default:#22863A;--shiki-dark:#85E89D}html pre.shiki code .sScJk, html code.shiki .sScJk{--shiki-default:#6F42C1;--shiki-dark:#B392F0}html pre.shiki code .sZZnC, html code.shiki .sZZnC{--shiki-default:#032F62;--shiki-dark:#9ECBFF}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sj4cs, html code.shiki .sj4cs{--shiki-default:#005CC5;--shiki-dark:#79B8FF}html pre.shiki code .szBVR, html code.shiki .szBVR{--shiki-default:#D73A49;--shiki-dark:#F97583}html pre.shiki code .sJ8bj, html code.shiki .sJ8bj{--shiki-default:#6A737D;--shiki-dark:#6A737D}html pre.shiki code .s4XuR, html code.shiki .s4XuR{--shiki-default:#E36209;--shiki-dark:#FFAB70}",{"title":47,"searchDepth":108,"depth":108,"links":1360},[1361,1367,1368,1369,1370,1373,1374],{"id":21,"depth":108,"text":22,"children":1362},[1363,1364,1365,1366],{"id":140,"depth":118,"text":141},{"id":396,"depth":118,"text":397},{"id":452,"depth":118,"text":453},{"id":524,"depth":118,"text":525},{"id":639,"depth":108,"text":640},{"id":799,"depth":108,"text":800},{"id":838,"depth":108,"text":839},{"id":936,"depth":108,"text":937,"children":1371},[1372],{"id":1079,"depth":118,"text":1080},{"id":1279,"depth":108,"text":1280},{"id":1339,"depth":108,"text":1340},null,[],"Цілі дотику, 16px у полях, видима область із клавіатурою, безпечні зони, жести, системне «назад» і нативне відчуття — що робить бібліотека і що має зробити проєкт.",{},{},"\u002Fdocs\u002Ffoundations\u002Fmobile",{"title":5,"description":1377},"stable","docs\u002Ffoundations\u002Fmobile","LZI5sJNcLYVeGLwn16Q5kVthrr-uRGbRgY-6j63FW98",1793290887678]