diff options
| author | Peter Bengtsson <mail@peterbe.com> | 2021-07-11 13:02:49 -0400 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2021-07-11 20:02:49 +0300 |
| commit | 74f1c3c85cf4f0ff1cc631d1320ed90c404c6ed7 (patch) | |
| tree | 2c73208a3ac6cea42c0aeedbf7d52d599688ea4c | |
| parent | ddda8bbbee128ba54ff6d3dd6a20a7d43debfb36 (diff) | |
| download | translated-content-74f1c3c85cf4f0ff1cc631d1320ed90c404c6ed7.tar.gz translated-content-74f1c3c85cf4f0ff1cc631d1320ed90c404c6ed7.tar.bz2 translated-content-74f1c3c85cf4f0ff1cc631d1320ed90c404c6ed7.zip | |
delete conflicting/orphaned docs in ru (#1426)
206 files changed, 0 insertions, 25480 deletions
diff --git a/files/ru/_redirects.txt b/files/ru/_redirects.txt index 69900553de..6f9d002c93 100644 --- a/files/ru/_redirects.txt +++ b/files/ru/_redirects.txt @@ -6,15 +6,10 @@ # FROM-URL TO-URL /ru/docs/AJAX /ru/docs/Web/Guide/AJAX /ru/docs/AJAX/С_чего_начать /ru/docs/Web/Guide/AJAX/Getting_Started -/ru/docs/AJAX/С_чего_начать? /ru/docs/orphaned/Web/Guide/AJAX/С_чего_начать? /ru/docs/AJAX:С_чего_начать /ru/docs/Web/Guide/AJAX/Getting_Started -/ru/docs/AJAX:С_чего_начать? /ru/docs/orphaned/Web/Guide/AJAX/С_чего_начать? -/ru/docs/A_Basic_RayCaster /ru/docs/conflicting/Web/API/Canvas_API/A_basic_ray-caster /ru/docs/Accessibility /ru/docs/Web/Accessibility /ru/docs/Accessibility/Keyboard-navigable_JavaScript_widgets /ru/docs/Web/Accessibility/Keyboard-navigable_JavaScript_widgets /ru/docs/Apps/Progressive /ru/docs/Web/Progressive_web_apps -/ru/docs/Apps/Progressive/Заметный /ru/docs/conflicting/Web/Progressive_web_apps_628955cdadd77b10ec99de034fc76374 -/ru/docs/Building_an_Extension /ru/docs/conflicting/Mozilla/Add-ons /ru/docs/CSS /ru/docs/Web/CSS /ru/docs/CSS/:active /ru/docs/Web/CSS/:active /ru/docs/CSS/@namespace /ru/docs/Web/CSS/@namespace @@ -25,7 +20,6 @@ /ru/docs/CSS/display /ru/docs/Web/CSS/display /ru/docs/CSS/float /ru/docs/Web/CSS/float /ru/docs/CSS/Синтаксис /ru/docs/Web/CSS/Syntax -/ru/docs/Chrome /ru/docs/conflicting/Glossary/Chrome /ru/docs/Core_JavaScript_1.5_Reference /ru/docs/Web/JavaScript/Reference /ru/docs/Core_JavaScript_1.5_Reference/Functions /ru/docs/Web/JavaScript/Guide/Functions /ru/docs/Core_JavaScript_1.5_Reference/Global_Functions /ru/docs/Web/JavaScript/Reference/Global_Objects @@ -44,10 +38,7 @@ /ru/docs/Core_JavaScript_1.5_Reference:Global_Objects /ru/docs/Web/JavaScript/Reference/Global_Objects /ru/docs/Core_JavaScript_1.5_Reference:Global_Objects:Array /ru/docs/Web/JavaScript/Reference/Global_Objects/Array /ru/docs/Core_JavaScript_1.5_Reference:Global_Objects:Boolean /ru/docs/Web/JavaScript/Reference/Global_Objects/Boolean -/ru/docs/Creating_Custom_Firefox_Extensions_with_the_Mozilla_Build_System /ru/docs/orphaned/Создание_расширения_для_Firefox_с_использованием_Mozilla_Build_System -/ru/docs/DOM /ru/docs/conflicting/Web/API/Document_Object_Model /ru/docs/DOM/DOM_Reference /ru/docs/Web/API/Document_Object_Model -/ru/docs/DOM/DOM_Reference/Events /ru/docs/orphaned/Web/API/Document_Object_Model/Events /ru/docs/DOM/DOM_Reference/Examples /ru/docs/Web/API/Document_Object_Model/Examples /ru/docs/DOM/DOM_Reference/Locating_DOM_elements_using_selectors /ru/docs/Web/API/Document_object_model/Locating_DOM_elements_using_selectors /ru/docs/DOM/DOM_Reference/Введение /ru/docs/Web/API/Document_Object_Model/Introduction @@ -107,21 +98,14 @@ /ru/docs/HTML/Element/acronym /ru/docs/Web/HTML/Element/acronym /ru/docs/HTML/Element/form /ru/docs/Web/HTML/Element/form /ru/docs/HTML/Element/стиль /ru/docs/Web/HTML/Element/style -/ru/docs/HTML/HTML5 /ru/docs/orphaned/Web/Guide/HTML/HTML5 -/ru/docs/HTML/HTML5/Constraint_validation /ru/docs/orphaned/Web/Guide/HTML/HTML5/Constraint_validation -/ru/docs/HTML/HTML5/Введение_в_HTML5 /ru/docs/orphaned/Web/Guide/HTML/HTML5/Introduction_to_HTML5 /ru/docs/HTML/Optimizing_Your_Pages_for_Speculative_Parsing /ru/docs/Glossary/speculative_parsing /ru/docs/IndexedDB /ru/docs/Web/API/IndexedDB_API -/ru/docs/IndexedDB/Basic_Concepts_Behind_IndexedDB /ru/docs/orphaned/Web/API/IndexedDB_API/Basic_Concepts_Behind_IndexedDB /ru/docs/IndexedDB/Using_IndexedDB /ru/docs/Web/API/IndexedDB_API/Using_IndexedDB /ru/docs/JavaScript /ru/docs/Web/JavaScript /ru/docs/JavaScript/A_re-introduction_to_JavaScript /ru/docs/Web/JavaScript/A_re-introduction_to_JavaScript /ru/docs/JavaScript/Data_structures /ru/docs/Web/JavaScript/Data_structures /ru/docs/JavaScript/ECMAScript_5_support_in_Mozilla /ru/docs/Web/JavaScript/New_in_JavaScript/ECMAScript_5_support_in_Mozilla /ru/docs/JavaScript/Guide /ru/docs/Web/JavaScript/Guide -/ru/docs/JavaScript/Guide/About /ru/docs/conflicting/Web/JavaScript/Guide/Introduction -/ru/docs/JavaScript/Guide/About_ru /ru/docs/conflicting/Web/JavaScript/Guide/Introduction -/ru/docs/JavaScript/Guide/About_ru-redirect-1 /ru/docs/conflicting/Web/JavaScript/Guide/Introduction /ru/docs/JavaScript/Guide/Functions /ru/docs/Web/JavaScript/Guide/Functions /ru/docs/JavaScript/Guide/Functions-redirect-1 /ru/docs/Web/JavaScript/Guide/Functions /ru/docs/JavaScript/Guide/LiveConnect_Overview /ru/docs/Web/JavaScript/Guide/LiveConnect_Overview @@ -133,8 +117,6 @@ /ru/docs/JavaScript/Guide/Values,_variables,_and_literals-redirect-1 /ru/docs/Web/JavaScript/Guide/Grammar_and_types /ru/docs/JavaScript/Guide/Working_with_Objects /ru/docs/Web/JavaScript/Guide/Working_with_Objects /ru/docs/JavaScript/Guide/Working_with_Objects-redirect-1 /ru/docs/Web/JavaScript/Guide/Working_with_Objects -/ru/docs/JavaScript/Guide/ru_JavaScript_Overview /ru/docs/conflicting/Web/JavaScript/Guide/Introduction_6f341ba6db4b060ccbd8dce4a0d5214b -/ru/docs/JavaScript/Guide/Об_этом_руководстве /ru/docs/orphaned/Web/JavaScript/Guide/Об_этом_руководстве /ru/docs/JavaScript/Guide/Регулярные выражения /ru/docs/Web/JavaScript/Guide/Regular_Expressions /ru/docs/JavaScript/Guide_ru /ru/docs/Web/JavaScript/Guide /ru/docs/JavaScript/Guide_ru/Inheritance_and_the_prototype_chain_ru /ru/docs/Web/JavaScript/Inheritance_and_the_prototype_chain @@ -151,7 +133,6 @@ /ru/docs/JavaScript/Reference/Global_Objects/Array/every /ru/docs/Web/JavaScript/Reference/Global_Objects/Array/every /ru/docs/JavaScript/Reference/Global_Objects/Array/forEach /ru/docs/Web/JavaScript/Reference/Global_Objects/Array/forEach /ru/docs/JavaScript/Reference/Global_Objects/Array/map /ru/docs/Web/JavaScript/Reference/Global_Objects/Array/map -/ru/docs/JavaScript/Reference/Global_Objects/Array/prototype /ru/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Array/prototype /ru/docs/JavaScript/Reference/Global_Objects/Array/some /ru/docs/Web/JavaScript/Reference/Global_Objects/Array/some /ru/docs/JavaScript/Reference/Global_Objects/Date /ru/docs/Web/JavaScript/Reference/Global_Objects/Date /ru/docs/JavaScript/Reference/Global_Objects/Date/toLocaleDateString /ru/docs/Web/JavaScript/Reference/Global_Objects/Date/toLocaleDateString @@ -175,7 +156,6 @@ /ru/docs/JavaScript/Reference/Global_Objects/Object/getOwnPropertyDescriptor /ru/docs/Web/JavaScript/Reference/Global_Objects/Object/getOwnPropertyDescriptor /ru/docs/JavaScript/Reference/Global_Objects/Object/hasOwnProperty /ru/docs/Web/JavaScript/Reference/Global_Objects/Object/hasOwnProperty /ru/docs/JavaScript/Reference/Global_Objects/Object/is /ru/docs/Web/JavaScript/Reference/Global_Objects/Object/is -/ru/docs/JavaScript/Reference/Global_Objects/Object/prototype /ru/docs/conflicting/Web/JavaScript/Reference/Global_Objects/Object /ru/docs/JavaScript/Reference/Global_Objects/Object/valueOf /ru/docs/Web/JavaScript/Reference/Global_Objects/Object/valueOf /ru/docs/JavaScript/Reference/Global_Objects/String /ru/docs/Web/JavaScript/Reference/Global_Objects/String /ru/docs/JavaScript/Reference/Global_Objects/String/replace /ru/docs/Web/JavaScript/Reference/Global_Objects/String/replace @@ -200,7 +180,6 @@ /ru/docs/Learn/CSS/CSS_layout/Навыки_позиционирования /ru/docs/Learn/CSS/CSS_layout/Position_skills /ru/docs/Learn/CSS/CSS_layout/Нормальный_поток /ru/docs/Learn/CSS/CSS_layout/Normal_Flow /ru/docs/Learn/CSS/CSS_layout/Отзывчивый_дизайн /ru/docs/Learn/CSS/CSS_layout/Responsive_Design -/ru/docs/Learn/CSS/CSS_properties /ru/docs/conflicting/Learn/CSS/Building_blocks/Selectors /ru/docs/Learn/CSS/First_steps/Как_структурирован_CSS /ru/docs/Learn/CSS/First_steps/How_CSS_is_structured /ru/docs/Learn/CSS/First_steps/Что_такое_CSS /ru/docs/Learn/CSS/First_steps/What_is_CSS /ru/docs/Learn/CSS/Introduction_to_CSS /en-US/docs/Learn/CSS/First_steps @@ -296,68 +275,29 @@ /ru/docs/Learn/Фронтенд_разработчик /ru/docs/Learn/Front-end_web_developer /ru/docs/Learn/Что_такое_веб_сервер /ru/docs/Learn/Common_questions/What_is_a_web_server /ru/docs/MDN/Contribute/Creating_and_editing_pages /ru/docs/MDN/Contribute/Howto/Create_and_edit_pages -/ru/docs/MDN/Contribute/Editor /ru/docs/orphaned/MDN/Editor -/ru/docs/MDN/Contribute/Editor/Basics /ru/docs/orphaned/MDN/Editor/Basics -/ru/docs/MDN/Contribute/Editor/Basics/Page_controls /ru/docs/orphaned/MDN/Editor/Basics/Page_controls -/ru/docs/MDN/Contribute/Editor/Basics/Toolbar /ru/docs/orphaned/MDN/Editor/Basics/Toolbar -/ru/docs/MDN/Contribute/Editor/Source_mode /ru/docs/orphaned/MDN/Editor/Source_mode -/ru/docs/MDN/Contribute/Editor/Tables /ru/docs/orphaned/MDN/Editor/Tables -/ru/docs/MDN/Contribute/Editor/Горячие_клавиши /ru/docs/orphaned/MDN/Editor/Keyboard_shortcuts -/ru/docs/MDN/Contribute/Editor/Картинки /ru/docs/orphaned/MDN/Editor/Images -/ru/docs/MDN/Contribute/Editor/Перенаправление /ru/docs/orphaned/MDN/Editor/Redirects -/ru/docs/MDN/Contribute/Editor/Синтаксические_выделения /ru/docs/orphaned/MDN/Editor/Syntax_highlighting -/ru/docs/MDN/Contribute/Editor/Ссылки /ru/docs/orphaned/MDN/Editor/Links /ru/docs/MDN/Contribute/Howto/Добавить_или_обновить_данные_о_браузерной_совместимости /ru/docs/MDN/Contribute/Howto/Add_or_update_browser_compatibility_data /ru/docs/MDN/Contribute/Howto/Создай_интерактивное_упражнение_для_помощи_в_изучении_веба /ru/docs/MDN/Contribute/Howto/Create_an_interactive_exercise_to_help_learning_the_web /ru/docs/MDN/Contribute/Tools /ru/docs/MDN/Tools -/ru/docs/MDN/Contribute/Tools/Page_watching /ru/docs/orphaned/MDN/Tools/Page_watching /ru/docs/MDN/Contribute/Процессы /ru/docs/MDN/Contribute/Processes -/ru/docs/MDN/Editor /ru/docs/orphaned/MDN/Editor -/ru/docs/MDN/Editor/Basics /ru/docs/orphaned/MDN/Editor/Basics -/ru/docs/MDN/Editor/Basics/Page_controls /ru/docs/orphaned/MDN/Editor/Basics/Page_controls -/ru/docs/MDN/Editor/Basics/Toolbar /ru/docs/orphaned/MDN/Editor/Basics/Toolbar -/ru/docs/MDN/Editor/Source_mode /ru/docs/orphaned/MDN/Editor/Source_mode -/ru/docs/MDN/Editor/Tables /ru/docs/orphaned/MDN/Editor/Tables -/ru/docs/MDN/Editor/Горячие_клавиши /ru/docs/orphaned/MDN/Editor/Keyboard_shortcuts -/ru/docs/MDN/Editor/Картинки /ru/docs/orphaned/MDN/Editor/Images -/ru/docs/MDN/Editor/Перенаправление /ru/docs/orphaned/MDN/Editor/Redirects -/ru/docs/MDN/Editor/Синтаксические_выделения /ru/docs/orphaned/MDN/Editor/Syntax_highlighting -/ru/docs/MDN/Editor/Ссылки /ru/docs/orphaned/MDN/Editor/Links /ru/docs/MDN/Feedback /ru/docs/MDN/Contribute/Feedback /ru/docs/MDN/Getting_started /ru/docs/MDN/Contribute/Getting_started /ru/docs/MDN/Kuma /ru/docs/MDN/Yari /ru/docs/MDN/Kuma/Troubleshooting_KumaScript_errors /ru/docs/MDN/Tools/KumaScript/Troubleshooting -/ru/docs/MDN/Tools/Page_watching /ru/docs/orphaned/MDN/Tools/Page_watching -/ru/docs/MDN/Tools/Search /ru/docs/orphaned/MDN/Tools/Search /ru/docs/MDN/Tools/URL-suffix /ru/docs/MDN/Tools/Unsupported_GET_API -/ru/docs/MDN/User_guide /ru/docs/conflicting/MDN/Tools -/ru/docs/MDN/User_guide/Advanced_search /ru/docs/orphaned/MDN/Tools/Search -/ru/docs/MDN/User_guide/Deleting_pages /ru/docs/orphaned/MDN/Tools/Page_deletion -/ru/docs/MDN/User_guide/Feeds /ru/docs/orphaned/MDN/Tools/Feeds /ru/docs/MDN_at_ten /ru/docs/MDN/At_ten -/ru/docs/MDN_at_ten/Contributing_to_MDN /ru/docs/conflicting/MDN/Contribute /ru/docs/Mozilla/Add-ons/WebExtensions/Интернационализация /ru/docs/Mozilla/Add-ons/WebExtensions/Internationalization -/ru/docs/Mozilla/Add-ons/WebExtensions/Перевод /ru/docs/orphaned/Mozilla/Add-ons/WebExtensions/Debugging /ru/docs/Mozilla/Add-ons/WebExtensions/модификация_веб_страницы /ru/docs/Mozilla/Add-ons/WebExtensions/Modify_a_web_page /ru/docs/Plugins/План /ru/docs/Plugins/Roadmap /ru/docs/QA/Kak_pomoch_testirovat /ru/docs/QA/Как_помочь_тестировать /ru/docs/Quirks_Mode_and_Standards_Mode /ru/docs/Web/HTML/Quirks_Mode_and_Standards_Mode /ru/docs/SVG_In_HTML_Introduction /ru/docs/Web/SVG/Tutorial/SVG_In_HTML_Introduction /ru/docs/Sample_.htaccess_file /ru/docs/Learn/Server-side/Apache_Configuration_htaccess -/ru/docs/Toolkit_API /ru/docs/orphaned/Toolkit_API -/ru/docs/Tools/Add-ons /ru/docs/orphaned/Tools/Add-ons -/ru/docs/Tools/Add-ons/DOM_Inspector /ru/docs/orphaned/Tools/Add-ons/DOM_Inspector /ru/docs/Tools/Debugger/How_to/Отладка_кода_внутри_eval /ru/docs/Tools/Debugger/How_to/Debug_eval_sources /ru/docs/Tools/Debugger/How_to/Работа_с_минифицированным_кодом /ru/docs/Tools/Debugger/How_to/Pretty-print_a_minified_file -/ru/docs/Tools/Debugger/Keyboard_shortcuts /ru/docs/orphaned/Tools/Debugger/Keyboard_shortcuts /ru/docs/Tools/Page_Inspector/How_to/Otkrytie_Inspektora /ru/docs/Tools/Page_Inspector/How_to/Open_the_Inspector /ru/docs/Tools/Page_Inspector/How_to/Vybor_elementa /ru/docs/Tools/Page_Inspector/How_to/Select_an_element /ru/docs/Tools/Page_Inspector/How_to/Исследовать_event_listeners /ru/docs/Tools/Page_Inspector/How_to/Examine_event_listeners /ru/docs/Tools/Page_Inspector/How_to/Просмотр_шрифтов /ru/docs/Tools/Page_Inspector/How_to/Edit_fonts -/ru/docs/Tools/Page_Inspector/Keyboard_shortcuts /ru/docs/orphaned/Tools/Page_Inspector/Keyboard_shortcuts -/ru/docs/Tools/Page_Inspector/Сочетания_клавиш /ru/docs/orphaned/Tools/Page_Inspector/Keyboard_shortcuts -/ru/docs/Tools/Profiler /ru/docs/conflicting/Tools/Performance -/ru/docs/Tools/Release_notes /ru/docs/conflicting/Mozilla/Firefox/Releases /ru/docs/Tools/Responsive_Design_View /ru/docs/Tools/Responsive_Design_Mode /ru/docs/Tools/Web_Console/Opening_the_Web_Console /ru/docs/Tools/Web_Console/UI_Tour /ru/docs/Tools/Инспектор_доступности /ru/docs/Tools/Accessibility_inspector @@ -367,16 +307,10 @@ /ru/docs/Tools/Производительность/Waterfall /ru/docs/Tools/Performance/Waterfall /ru/docs/Using_Firefox_1.5_caching /ru/docs/Mozilla/Firefox/Releases/1.5/Using_Firefox_1.5_caching /ru/docs/Using_files_from_web_applications /ru/docs/Web/API/File/Using_files_from_web_applications -/ru/docs/Web/API/AbstractWorker /ru/docs/orphaned/Web/API/AbstractWorker -/ru/docs/Web/API/Ambient_Light_Events /ru/docs/orphaned/Web/API/Ambient_Light_Events /ru/docs/Web/API/AudioContext.currentTime /ru/docs/Web/API/BaseAudioContext/currentTime /ru/docs/Web/API/AudioContext/createPanner /ru/docs/Web/API/BaseAudioContext/createPanner /ru/docs/Web/API/AudioContext/currentTime /ru/docs/Web/API/BaseAudioContext/currentTime /ru/docs/Web/API/AudioContext/decodeAudioData /ru/docs/Web/API/BaseAudioContext/decodeAudioData -/ru/docs/Web/API/Body /ru/docs/orphaned/Web/API/Body -/ru/docs/Web/API/Body/arrayBuffer /ru/docs/orphaned/Web/API/Body/arrayBuffer -/ru/docs/Web/API/Body/formData /ru/docs/orphaned/Web/API/Body/formData -/ru/docs/Web/API/Body/json /ru/docs/orphaned/Web/API/Body/json /ru/docs/Web/API/CSS_Object_Model/ориентация_экрана /ru/docs/Web/API/CSS_Object_Model/Managing_screen_orientation /ru/docs/Web/API/Canvas_API/Tutorial/Использование_изображений /ru/docs/Web/API/Canvas_API/Tutorial/Using_images /ru/docs/Web/API/Canvas_API/Tutorial/Композиции /ru/docs/Web/API/Canvas_API/Tutorial/Compositing @@ -385,9 +319,6 @@ /ru/docs/Web/API/Canvas_API/Tutorial/Рисование_текста /ru/docs/Web/API/Canvas_API/Tutorial/Drawing_text /ru/docs/Web/API/Canvas_API/Tutorial/Рисование_фигур /ru/docs/Web/API/Canvas_API/Tutorial/Drawing_shapes /ru/docs/Web/API/Canvas_API/Рисование_графики_с_помощью_Canvas /ru/docs/Web/API/Canvas_API/Tutorial -/ru/docs/Web/API/ChildNode /ru/docs/orphaned/Web/API/ChildNode -/ru/docs/Web/API/ChildNode/remove /ru/docs/orphaned/Web/API/ChildNode/remove -/ru/docs/Web/API/ChildNode/replaceWith /ru/docs/orphaned/Web/API/ChildNode/replaceWith /ru/docs/Web/API/Coordinates /ru/docs/Web/API/GeolocationCoordinates /ru/docs/Web/API/Document.querySelectorAll /ru/docs/Web/API/Document/querySelectorAll /ru/docs/Web/API/Document/async /ru/docs/Web/API/XMLDocument/async @@ -397,25 +328,15 @@ /ru/docs/Web/API/Document/domConfig /ru/docs/Web/API/Document /ru/docs/Web/API/DocumentOrShadowRoot/activeElement /ru/docs/Web/API/Document/activeElement /ru/docs/Web/API/DocumentOrShadowRoot/getSelection /ru/docs/Web/API/Document/getSelection -/ru/docs/Web/API/Document_Object_Model/Events /ru/docs/orphaned/Web/API/Document_Object_Model/Events /ru/docs/Web/API/Element.getBoundingClientRect /ru/docs/Web/API/Element/getBoundingClientRect /ru/docs/Web/API/Element.insertAdjacentHTML /ru/docs/Web/API/Element/insertAdjacentHTML /ru/docs/Web/API/Element/accessKey /ru/docs/Web/API/HTMLElement/accessKey -/ru/docs/Web/API/Element/currentStyle /ru/docs/orphaned/Web/API/Element/currentStyle -/ru/docs/Web/API/ElementCSSInlineStyle/style /ru/docs/orphaned/Web/API/ElementCSSInlineStyle/style /ru/docs/Web/API/EventTarget.addEventListener /ru/docs/Web/API/EventTarget/addEventListener -/ru/docs/Web/API/EventTarget/attachEvent /ru/docs/conflicting/Web/API/EventTarget/addEventListener -/ru/docs/Web/API/EventTarget/detachEvent /ru/docs/conflicting/Web/API/EventTarget/removeEventListener /ru/docs/Web/API/File_and_Directory_Entries_API/Введение /ru/docs/Web/API/File_and_Directory_Entries_API/Introduction /ru/docs/Web/API/Geolocation/Using_geolocation /ru/docs/Web/API/Geolocation_API /ru/docs/Web/API/Geolocation/Using_geolocation/Using_the_Geolocation_API /ru/docs/Web/API/Geolocation_API/Using_the_Geolocation_API /ru/docs/Web/API/HTMLAudioElement/Audio() /ru/docs/Web/API/HTMLAudioElement/Audio -/ru/docs/Web/API/HTMLElement/dataset /ru/docs/orphaned/Web/API/HTMLOrForeignElement/dataset /ru/docs/Web/API/HTMLElement/invalid /ru/docs/Web/API/HTMLInputElement/invalid_event -/ru/docs/Web/API/HTMLElement/nonce /ru/docs/orphaned/Web/API/HTMLOrForeignElement/nonce -/ru/docs/Web/API/HTMLElement/style /ru/docs/orphaned/Web/API/ElementCSSInlineStyle/style -/ru/docs/Web/API/HTMLElement/tabIndex /ru/docs/orphaned/Web/API/HTMLOrForeignElement/tabIndex -/ru/docs/Web/API/HTMLHyperlinkElementUtils /ru/docs/orphaned/Web/API/HTMLHyperlinkElementUtils /ru/docs/Web/API/HTMLHyperlinkElementUtils/hash /ru/docs/Web/API/HTMLAnchorElement/hash /ru/docs/Web/API/HTMLHyperlinkElementUtils/host /ru/docs/Web/API/HTMLAnchorElement/host /ru/docs/Web/API/HTMLHyperlinkElementUtils/hostname /ru/docs/Web/API/HTMLAnchorElement/hostname @@ -429,30 +350,6 @@ /ru/docs/Web/API/HTMLHyperlinkElementUtils/toString /ru/docs/Web/API/HTMLAnchorElement/toString /ru/docs/Web/API/HTMLHyperlinkElementUtils/username /ru/docs/Web/API/HTMLAnchorElement/username /ru/docs/Web/API/HTMLImageElement.Image /ru/docs/Web/API/HTMLImageElement/Image -/ru/docs/Web/API/HTMLOrForeignElement/dataset /ru/docs/orphaned/Web/API/HTMLOrForeignElement/dataset -/ru/docs/Web/API/HTMLOrForeignElement/nonce /ru/docs/orphaned/Web/API/HTMLOrForeignElement/nonce -/ru/docs/Web/API/HTMLOrForeignElement/tabIndex /ru/docs/orphaned/Web/API/HTMLOrForeignElement/tabIndex -/ru/docs/Web/API/IndexedDB_API/Basic_Concepts_Behind_IndexedDB /ru/docs/orphaned/Web/API/IndexedDB_API/Basic_Concepts_Behind_IndexedDB -/ru/docs/Web/API/LocalMediaStream /ru/docs/orphaned/Web/API/LocalMediaStream -/ru/docs/Web/API/MediaTrackConstraints/Эхоподавление /ru/docs/Web/API/MediaTrackConstraints/echoCancellation -/ru/docs/Web/API/NavigatorGeolocation /ru/docs/conflicting/Web/API/Geolocation -/ru/docs/Web/API/NavigatorID /ru/docs/orphaned/Web/API/NavigatorID -/ru/docs/Web/API/NavigatorID/appCodeName /ru/docs/orphaned/Web/API/NavigatorID/appCodeName -/ru/docs/Web/API/NavigatorID/appName /ru/docs/orphaned/Web/API/NavigatorID/appName -/ru/docs/Web/API/NavigatorID/appVersion /ru/docs/orphaned/Web/API/NavigatorID/appVersion -/ru/docs/Web/API/NavigatorID/platform /ru/docs/orphaned/Web/API/NavigatorID/platform -/ru/docs/Web/API/NavigatorID/product /ru/docs/orphaned/Web/API/NavigatorID/product -/ru/docs/Web/API/NavigatorID/taintEnabled /ru/docs/orphaned/Web/API/NavigatorID/taintEnabled -/ru/docs/Web/API/NavigatorID/userAgent /ru/docs/orphaned/Web/API/NavigatorID/userAgent -/ru/docs/Web/API/NavigatorLanguage /ru/docs/orphaned/Web/API/NavigatorLanguage -/ru/docs/Web/API/NavigatorLanguage/language /ru/docs/orphaned/Web/API/NavigatorLanguage/language -/ru/docs/Web/API/NavigatorLanguage/languages /ru/docs/orphaned/Web/API/NavigatorLanguage/languages -/ru/docs/Web/API/NavigatorOnLine /ru/docs/orphaned/Web/API/NavigatorOnLine -/ru/docs/Web/API/NavigatorOnLine/onLine /ru/docs/orphaned/Web/API/NavigatorOnLine/onLine -/ru/docs/Web/API/NavigatorPlugins /ru/docs/orphaned/Web/API/NavigatorPlugins -/ru/docs/Web/API/NavigatorPlugins/javaEnabled /ru/docs/orphaned/Web/API/NavigatorPlugins/javaEnabled -/ru/docs/Web/API/NavigatorPlugins/mimeTypes /ru/docs/orphaned/Web/API/NavigatorPlugins/mimeTypes -/ru/docs/Web/API/NavigatorPlugins/plugins /ru/docs/orphaned/Web/API/NavigatorPlugins/plugins /ru/docs/Web/API/NetworkInformation/connection /ru/docs/Web/API/Navigator/connection /ru/docs/Web/API/Node.appendChild /ru/docs/Web/API/Node/appendChild /ru/docs/Web/API/Node.contains /ru/docs/Web/API/Node/contains @@ -460,48 +357,25 @@ /ru/docs/Web/API/Node.removeChild /ru/docs/Web/API/Node/removeChild /ru/docs/Web/API/Node.replaceChild /ru/docs/Web/API/Node/replaceChild /ru/docs/Web/API/Node.textContent /ru/docs/Web/API/Node/textContent -/ru/docs/Web/API/Node/baseURIObject /ru/docs/conflicting/Web/API/Node -/ru/docs/Web/API/Node/getUserData /ru/docs/orphaned/Web/API/Node/getUserData /ru/docs/Web/API/Node/innerText /ru/docs/Web/API/HTMLElement/innerText /ru/docs/Web/API/Node/localName /ru/docs/Web/API/Element/localName /ru/docs/Web/API/Node/namespaceURI /ru/docs/Web/API/Element/namespaceURI -/ru/docs/Web/API/Node/nodePrincipal /ru/docs/conflicting/Web/API/Node_378aed5ed6869e50853edbc988cf9556 /ru/docs/Web/API/Node/prefix /ru/docs/Web/API/Element/prefix -/ru/docs/Web/API/NonDocumentTypeChildNode /ru/docs/conflicting/Web/API/Element_861159909c20acebf8e506c3bb0e2f7e /ru/docs/Web/API/NonDocumentTypeChildNode/NonDocumentTypeChildNode.nextElementSibling /ru/docs/Web/API/Element/nextElementSibling /ru/docs/Web/API/NonDocumentTypeChildNode/nextElementSibling /ru/docs/Web/API/Element/nextElementSibling /ru/docs/Web/API/NonDocumentTypeChildNode/previousElementSibling /ru/docs/Web/API/Element/previousElementSibling -/ru/docs/Web/API/Notation /ru/docs/orphaned/Web/API/Notation -/ru/docs/Web/API/ParentNode /ru/docs/orphaned/Web/API/ParentNode -/ru/docs/Web/API/ParentNode/append /ru/docs/orphaned/Web/API/ParentNode/append /ru/docs/Web/API/ParentNode/childElementCount /ru/docs/Web/API/Element/childElementCount -/ru/docs/Web/API/ParentNode/children /ru/docs/orphaned/Web/API/ParentNode/children -/ru/docs/Web/API/ParentNode/firstElementChild /ru/docs/orphaned/Web/API/ParentNode/firstElementChild -/ru/docs/Web/API/ParentNode/lastElementChild /ru/docs/orphaned/Web/API/ParentNode/lastElementChild -/ru/docs/Web/API/ParentNode/prepend /ru/docs/orphaned/Web/API/ParentNode/prepend /ru/docs/Web/API/PositionError /ru/docs/Web/API/GeolocationPositionError -/ru/docs/Web/API/Push_API/Using_the_Push_API /ru/docs/conflicting/Web/API/Push_API -/ru/docs/Web/API/RTCPeerConnection/getDefaultIceServers /ru/docs/orphaned/Web/API/RTCPeerConnection/getDefaultIceServers -/ru/docs/Web/API/RandomSource /ru/docs/conflicting/Web/API/Crypto/getRandomValues /ru/docs/Web/API/RandomSource/getRandomValues /ru/docs/Web/API/Crypto/getRandomValues -/ru/docs/Web/API/RenderingContext /ru/docs/orphaned/Web/API/RenderingContext -/ru/docs/Web/API/SVGAElement/SVGAlement.target /ru/docs/conflicting/Web/API/SVGAElement/target -/ru/docs/Web/API/ServiceWorkerState /ru/docs/orphaned/Web/API/ServiceWorkerState -/ru/docs/Web/API/Slotable /ru/docs/conflicting/Web/API/Element -/ru/docs/Web/API/Storage/LocalStorage /ru/docs/conflicting/Web/API/Window/localStorage /ru/docs/Web/API/WebGL_API/Adding_2D_content_to_a_WebGL_context /ru/docs/Web/API/WebGL_API/Tutorial/Adding_2D_content_to_a_WebGL_context /ru/docs/Web/API/WebGL_API/Animating_objects_with_WebGL /ru/docs/Web/API/WebGL_API/Tutorial/Animating_objects_with_WebGL /ru/docs/Web/API/WebGL_API/Getting_started_with_WebGL /ru/docs/Web/API/WebGL_API/Tutorial/Getting_started_with_WebGL /ru/docs/Web/API/WebGL_API/Tutorial/Создание_3D_объектов_с_помощью_WebGL /ru/docs/Web/API/WebGL_API/Tutorial/Creating_3D_objects_using_WebGL /ru/docs/Web/API/WebGL_API/Using_shaders_to_apply_color_in_WebGL /ru/docs/Web/API/WebGL_API/Tutorial/Using_shaders_to_apply_color_in_WebGL -/ru/docs/Web/API/WebRTC_API/WebRTC_basics /ru/docs/conflicting/Web/API/WebRTC_API/Signaling_and_video_calling /ru/docs/Web/API/WebRTC_API/протоколы /ru/docs/Web/API/WebRTC_API/Protocols /ru/docs/Web/API/WebRTC_API/связь /ru/docs/Web/API/WebRTC_API/Connectivity -/ru/docs/Web/API/Web_Crypto_API/Checking_authenticity_with_password /ru/docs/orphaned/Web/API/Web_Crypto_API/Checking_authenticity_with_password -/ru/docs/Web/API/WindowBase64 /ru/docs/conflicting/Web/API/WindowOrWorkerGlobalScope /ru/docs/Web/API/WindowBase64/Base64_encoding_and_decoding /ru/docs/Glossary/Base64 /ru/docs/Web/API/WindowBase64/btoa /ru/docs/Web/API/WindowOrWorkerGlobalScope/btoa -/ru/docs/Web/API/WindowTimers /ru/docs/conflicting/Web/API/WindowOrWorkerGlobalScope_e2691f7ad05781a30c5fc5bb3b3f633a /ru/docs/Web/API/WindowTimers.setTimeout /ru/docs/Web/API/WindowOrWorkerGlobalScope/setTimeout /ru/docs/Web/API/WindowTimers/setTimeout /ru/docs/Web/API/WindowOrWorkerGlobalScope/setTimeout /ru/docs/Web/API/console.timeEnd /ru/docs/Web/API/Console/timeEnd @@ -514,14 +388,10 @@ /ru/docs/Web/API/navigator.id.request /ru/docs/Web/API/IdentityManager/request /ru/docs/Web/API/range.getBoundingClientRect /ru/docs/Web/API/Range/getBoundingClientRect /ru/docs/Web/API/Видимость_страницы_API /ru/docs/Web/API/Page_Visibility_API -/ru/docs/Web/API/Нотация /ru/docs/orphaned/Web/API/Notation -/ru/docs/Web/Accessibility/Веб-разработка /ru/docs/conflicting/Web/Accessibility /ru/docs/Web/Apps/Fundamentals/Audio_and_video_delivery /ru/docs/Web/Guide/Audio_and_video_delivery /ru/docs/Web/Apps/Fundamentals/Audio_and_video_delivery/Adding_captions_and_subtitles_to_HTML5_video /ru/docs/Web/Guide/Audio_and_video_delivery/Adding_captions_and_subtitles_to_HTML5_video /ru/docs/Web/Apps/Fundamentals/Audio_and_video_delivery/buffering_seeking_time_ranges /ru/docs/Web/Guide/Audio_and_video_delivery/buffering_seeking_time_ranges -/ru/docs/Web/CSS/:any /ru/docs/conflicting/Web/CSS/:is /ru/docs/Web/CSS/:blank /ru/docs/Web/CSS/:-moz-only-whitespace -/ru/docs/Web/CSS/@viewport/user-zoom /ru/docs/conflicting/Web/CSS/@viewport /ru/docs/Web/CSS/Adjacent_sibling_selectors /ru/docs/Web/CSS/Adjacent_sibling_combinator /ru/docs/Web/CSS/CSS_Animations/Ispolzovanie_CSS_animatciy /ru/docs/Web/CSS/CSS_Animations/Using_CSS_animations /ru/docs/Web/CSS/CSS_Background_and_Borders /ru/docs/Web/CSS/CSS_Backgrounds_and_Borders @@ -530,7 +400,6 @@ /ru/docs/Web/CSS/CSS_Basic_User_Interface/Использование_URL_значений_для_свойства_cursor /ru/docs/Web/CSS/CSS_Basic_User_Interface/Using_URL_values_for_the_cursor_property /ru/docs/Web/CSS/CSS_Box_Model/Box-shadow_generator /ru/docs/Web/CSS/CSS_Background_and_Borders/Box-shadow_generator /ru/docs/Web/CSS/CSS_Colors /ru/docs/Web/CSS/CSS_Color -/ru/docs/Web/CSS/CSS_Flexible_Box_Layout/Using_CSS_flexible_boxes /ru/docs/conflicting/Web/CSS/CSS_Flexible_Box_Layout/Basic_Concepts_of_Flexbox /ru/docs/Web/CSS/CSS_Flexible_Box_Layout/Выравнивание_элементов_в_Flex_контейнере /ru/docs/Web/CSS/CSS_Flexible_Box_Layout/Aligning_Items_in_a_Flex_Container /ru/docs/Web/CSS/CSS_Flexible_Box_Layout/Контролирование_соотношения_элементов_вдоль_главной_оси /ru/docs/Web/CSS/CSS_Flexible_Box_Layout/Controlling_Ratios_of_Flex_Items_Along_the_Main_Ax /ru/docs/Web/CSS/CSS_Flow_Layout/Блочное_и_строчное_размещение_в_нормальном_потоке /ru/docs/Web/CSS/CSS_Flow_Layout/Block_and_Inline_Layout_in_Normal_Flow @@ -538,7 +407,6 @@ /ru/docs/Web/CSS/CSS_Grid_Layout/CSS_Grid,_Logical_Values_and_Writing_Modes /ru/docs/Web/CSS/CSS_Grid_Layout/CSS_Grid_Logical_Values_and_Writing_Modes /ru/docs/Web/CSS/CSS_Grid_Layout/Грид-области /ru/docs/Web/CSS/CSS_Grid_Layout/Grid_Template_Areas /ru/docs/Web/CSS/CSS_Grid_Layout/Расположение_элементов_по_грид-линиям_с_помощью_CSS_Grid /ru/docs/Web/CSS/CSS_Grid_Layout/Line-based_Placement_with_CSS_Grid -/ru/docs/Web/CSS/CSS_User_Interface /ru/docs/conflicting/Web/CSS/CSS_Basic_User_Interface /ru/docs/Web/CSS/CSS_User_Interface/Использование_URL_значений_для_свойства_cursor /ru/docs/Web/CSS/CSS_Basic_User_Interface/Using_URL_values_for_the_cursor_property /ru/docs/Web/CSS/CSS_animated_properties /ru/docs/Web/CSS /ru/docs/Web/CSS/CSS_Селекторы /ru/docs/Web/CSS/CSS_Selectors @@ -555,22 +423,11 @@ /ru/docs/Web/CSS/calc /ru/docs/Web/CSS/calc() /ru/docs/Web/CSS/clamp /ru/docs/Web/CSS/clamp() /ru/docs/Web/CSS/filter-function/blur /ru/docs/Web/CSS/filter-function/blur() -/ru/docs/Web/CSS/filter-function/url /ru/docs/conflicting/Web/CSS/url() -/ru/docs/Web/CSS/grid-gap /ru/docs/conflicting/Web/CSS/gap -/ru/docs/Web/CSS/image-set /ru/docs/orphaned/Web/CSS/image-set() -/ru/docs/Web/CSS/image-set() /ru/docs/orphaned/Web/CSS/image-set() -/ru/docs/Web/CSS/linear-gradient /ru/docs/orphaned/Web/CSS/linear-gradient() -/ru/docs/Web/CSS/linear-gradient() /ru/docs/orphaned/Web/CSS/linear-gradient() /ru/docs/Web/CSS/minmax /ru/docs/Web/CSS/minmax() -/ru/docs/Web/CSS/radial-gradient /ru/docs/orphaned/Web/CSS/radial-gradient() -/ru/docs/Web/CSS/radial-gradient() /ru/docs/orphaned/Web/CSS/radial-gradient() -/ru/docs/Web/CSS/repeating-linear-gradient /ru/docs/orphaned/Web/CSS/repeating-linear-gradient() -/ru/docs/Web/CSS/repeating-linear-gradient() /ru/docs/orphaned/Web/CSS/repeating-linear-gradient() /ru/docs/Web/CSS/transform-function/rotate /ru/docs/Web/CSS/transform-function/rotate() /ru/docs/Web/CSS/transform-function/rotate3d /ru/docs/Web/CSS/transform-function/rotate3d() /ru/docs/Web/CSS/transform-function/scale3d /ru/docs/Web/CSS/transform-function/scale3d() /ru/docs/Web/CSS/transform-function/skew /ru/docs/Web/CSS/transform-function/skew() -/ru/docs/Web/CSS/url /ru/docs/conflicting/Web/CSS/url()_168028c4e5edd9e19c061adb4b604d4f /ru/docs/Web/CSS/Действительное_значение /ru/docs/Web/CSS/actual_value /ru/docs/Web/CSS/Замещаемый_элемент /ru/docs/Web/CSS/Replaced_element /ru/docs/Web/CSS/Псевдо-классы /ru/docs/Web/CSS/Pseudo-classes @@ -580,7 +437,6 @@ /ru/docs/Web/CSS/Указанное_значение /ru/docs/Web/CSS/specified_value /ru/docs/Web/CSS/размер /ru/docs/Web/CSS/length /ru/docs/Web/Events/DOMContentLoaded /ru/docs/Web/API/Window/DOMContentLoaded_event -/ru/docs/Web/Events/abort /ru/docs/conflicting/Web/API/HTMLMediaElement/abort_event /ru/docs/Web/Events/abort_(dom_abort_api) /ru/docs/Web/API/AbortSignal/abort_event /ru/docs/Web/Events/blur /ru/docs/Web/API/Element/blur_event /ru/docs/Web/Events/deviceorientation /ru/docs/Web/API/Window/deviceorientation_event @@ -605,33 +461,13 @@ /ru/docs/Web/Events/unhandledrejection /ru/docs/Web/API/Window/unhandledrejection_event /ru/docs/Web/Events/стримится /ru/docs/Web/API/HTMLMediaElement/seeking_event /ru/docs/Web/Guide/AJAX/С_чего_начать /ru/docs/Web/Guide/AJAX/Getting_Started -/ru/docs/Web/Guide/AJAX/С_чего_начать? /ru/docs/orphaned/Web/Guide/AJAX/С_чего_начать? -/ru/docs/Web/Guide/API/DOM /ru/docs/conflicting/Web/API/Document_Object_Model_dd00a71ceceac547ab464128db6bd8ef -/ru/docs/Web/Guide/API/DOM/Storage /ru/docs/conflicting/Web/API/Web_Storage_API -/ru/docs/Web/Guide/API/WebRTC /ru/docs/conflicting/Web/API/WebRTC_API -/ru/docs/Web/Guide/CSS /ru/docs/conflicting/Learn/CSS -/ru/docs/Web/Guide/CSS/Getting_started /ru/docs/conflicting/Learn/CSS/First_steps -/ru/docs/Web/Guide/CSS/Getting_started/Cascading_and_inheritance /ru/docs/conflicting/Learn/CSS/Building_blocks/Cascade_and_inheritance -/ru/docs/Web/Guide/CSS/Getting_started/Color /ru/docs/conflicting/Learn/CSS/Building_blocks/Values_and_units -/ru/docs/Web/Guide/CSS/Getting_started/How_CSS_works /ru/docs/conflicting/Learn/CSS/First_steps/How_CSS_works -/ru/docs/Web/Guide/CSS/Getting_started/Readable_CSS /ru/docs/conflicting/Learn/CSS/First_steps/How_CSS_is_structured /ru/docs/Web/Guide/CSS/Getting_started/SVG_и_CSS /ru/docs/Web/SVG/Tutorial/SVG_and_CSS -/ru/docs/Web/Guide/CSS/Getting_started/Text_styles /ru/docs/conflicting/Learn/CSS/Styling_text/Fundamentals -/ru/docs/Web/Guide/CSS/Getting_started/What_is_CSS /ru/docs/conflicting/Learn/CSS/First_steps/How_CSS_works_b66915031fb62b5fee1201086144e209 -/ru/docs/Web/Guide/CSS/Getting_started/Why_use_CSS /ru/docs/conflicting/Learn/CSS/First_steps/How_CSS_works_64ba4331a7a5f4319c6e06b06ccdd521 -/ru/docs/Web/Guide/CSS/Getting_started/Таблицы /ru/docs/conflicting/Learn/CSS/Building_blocks/Styling_tables /ru/docs/Web/Guide/CSS/Understanding_z_index /ru/docs/Web/CSS/CSS_Positioning/Understanding_z_index /ru/docs/Web/Guide/CSS/Understanding_z_index/Adding_z-index /ru/docs/Web/CSS/CSS_Positioning/Understanding_z_index/Adding_z-index /ru/docs/Web/Guide/CSS/Understanding_z_index/Stacking_without_z-index /ru/docs/Web/CSS/CSS_Positioning/Understanding_z_index/Stacking_without_z-index /ru/docs/Web/Guide/CSS/Using_multi-column_layouts /ru/docs/Web/CSS/CSS_Columns/Using_multi-column_layouts /ru/docs/Web/Guide/CSS/Visual_formatting_model /ru/docs/Web/CSS/Visual_formatting_model /ru/docs/Web/Guide/CSS/ispolzovanie_css_animatciy /ru/docs/Web/CSS/CSS_Animations/Using_CSS_animations -/ru/docs/Web/Guide/Events /ru/docs/orphaned/Web/Guide/Events -/ru/docs/Web/Guide/Events/Creating_and_triggering_events /ru/docs/orphaned/Web/Guide/Events/Creating_and_triggering_events -/ru/docs/Web/Guide/Events/Event_handlers /ru/docs/orphaned/Web/Guide/Events/Event_handlers -/ru/docs/Web/Guide/Events/Media_events /ru/docs/orphaned/Web/Guide/Events/Media_events -/ru/docs/Web/Guide/Events/Overview_of_Events_and_Handlers /ru/docs/orphaned/Web/Guide/Events/Overview_of_Events_and_Handlers -/ru/docs/Web/Guide/Events/Создание_и_вызов_событий /ru/docs/orphaned/Web/Guide/Events/Creating_and_triggering_events /ru/docs/Web/Guide/HTML /ru/docs/Learn/HTML /ru/docs/Web/Guide/HTML/Canvas_tutorial /ru/docs/Web/API/Canvas_API/Tutorial /ru/docs/Web/Guide/HTML/Canvas_tutorial/Basic_usage /ru/docs/Web/API/Canvas_API/Tutorial/Basic_usage @@ -641,35 +477,25 @@ /ru/docs/Web/Guide/HTML/Drag_and_drop /ru/docs/Web/API/HTML_Drag_and_Drop_API /ru/docs/Web/Guide/HTML/Drag_and_drop/Drag_operations /ru/docs/Web/API/HTML_Drag_and_Drop_API/Drag_operations /ru/docs/Web/Guide/HTML/Forms /ru/docs/Learn/Forms -/ru/docs/Web/Guide/HTML/HTML5 /ru/docs/orphaned/Web/Guide/HTML/HTML5 -/ru/docs/Web/Guide/HTML/HTML5/Constraint_validation /ru/docs/orphaned/Web/Guide/HTML/HTML5/Constraint_validation -/ru/docs/Web/Guide/HTML/HTML5/Introduction_to_HTML5 /ru/docs/orphaned/Web/Guide/HTML/HTML5/Introduction_to_HTML5 /ru/docs/Web/Guide/HTML/Introduction /ru/docs/Learn/HTML/Introduction_to_HTML -/ru/docs/Web/Guide/HTML/Sections_and_Outlines_of_an_HTML5_document /ru/docs/orphaned/Web/Guide/HTML/Using_HTML_sections_and_outlines /ru/docs/Web/Guide/HTML/Tips_for_authoring_fast-loading_HTML_pages /ru/docs/Learn/HTML/Howto/Author_fast-loading_HTML_pages -/ru/docs/Web/Guide/HTML/Using_HTML_sections_and_outlines /ru/docs/orphaned/Web/Guide/HTML/Using_HTML_sections_and_outlines /ru/docs/Web/Guide/HTML/Using_data_attributes /ru/docs/Learn/HTML/Howto/Use_data_attributes -/ru/docs/Web/Guide/Localizations_and_character_encodings /ru/docs/orphaned/Web/Guide/Localizations_and_character_encodings /ru/docs/Web/Guide/Графика /ru/docs/Web/Guide/Graphics /ru/docs/Web/Guide/Производительность /ru/docs/Web/Guide/Performance /ru/docs/Web/HTML/CORS_settings_attributes /ru/docs/Web/HTML/Attributes/crossorigin /ru/docs/Web/HTML/Canvas /ru/docs/Web/API/Canvas_API /ru/docs/Web/HTML/Canvas/Рисование_графики_с_помощью_Canvas /ru/docs/Web/API/Canvas_API/Tutorial -/ru/docs/Web/HTML/Element/element /ru/docs/orphaned/Web/HTML/Element/element /ru/docs/Web/HTML/Element/video/seeking_event /ru/docs/Web/API/HTMLMediaElement/seeking_event /ru/docs/Web/HTML/Element/кнопка /ru/docs/Web/HTML/Element/button /ru/docs/Web/HTML/Element/ссылка /ru/docs/Web/HTML/Element/link /ru/docs/Web/HTML/Element/стиль /ru/docs/Web/HTML/Element/style -/ru/docs/Web/HTML/Global_attributes/dropzone /ru/docs/orphaned/Web/HTML/Global_attributes/dropzone /ru/docs/Web/HTML/Optimizing_Your_Pages_for_Speculative_Parsing /ru/docs/Glossary/speculative_parsing -/ru/docs/Web/HTML/Preloading_content /ru/docs/orphaned/Web/HTML/Preloading_content /ru/docs/Web/HTML/Использование_HTML5_audio_и_video /ru/docs/Learn/HTML/Multimedia_and_embedding/Video_and_audio_content /ru/docs/Web/HTML/Общие_атрибуты /ru/docs/Web/HTML/Global_attributes /ru/docs/Web/HTML/Общие_атрибуты/accesskey /ru/docs/Web/HTML/Global_attributes/accesskey /ru/docs/Web/HTML/Общие_атрибуты/class /ru/docs/Web/HTML/Global_attributes/class /ru/docs/Web/HTML/Общие_атрибуты/contenteditable /ru/docs/Web/HTML/Global_attributes/contenteditable /ru/docs/Web/HTML/Общие_атрибуты/data-* /ru/docs/Web/HTML/Global_attributes/data-* -/ru/docs/Web/HTML/Общие_атрибуты/dropzone /ru/docs/orphaned/Web/HTML/Global_attributes/dropzone /ru/docs/Web/HTML/Общие_атрибуты/id /ru/docs/Web/HTML/Global_attributes/id /ru/docs/Web/HTML/Общие_атрибуты/inputmode /ru/docs/Web/HTML/Global_attributes/inputmode /ru/docs/Web/HTML/Общие_атрибуты/is /ru/docs/Web/HTML/Global_attributes/is @@ -677,14 +503,12 @@ /ru/docs/Web/HTML/Общие_атрибуты/lang /ru/docs/Web/HTML/Global_attributes/lang /ru/docs/Web/HTML/Общие_атрибуты/style /ru/docs/Web/HTML/Global_attributes/style /ru/docs/Web/HTML/Общие_атрибуты/tabindex /ru/docs/Web/HTML/Global_attributes/tabindex -/ru/docs/Web/HTML/Поддерживаемые_медиа_форматы /ru/docs/conflicting/Web/Media/Formats /ru/docs/Web/HTML/Ссылки /ru/docs/Web/HTML/Reference /ru/docs/Web/HTML/Строчные_Элементы /ru/docs/Web/HTML/Inline_elements /ru/docs/Web/HTML/Типы_ссылок /ru/docs/Web/HTML/Link_types /ru/docs/Web/HTTP/Basics_of_HTTP/Identifying_resources_on_the_Web_RU /ru/docs/Web/HTTP/Basics_of_HTTP/Identifying_resources_on_the_Web /ru/docs/Web/HTTP/Basics_of_HTTP/MIME_types/Полный_список_типов_MIME /ru/docs/Web/HTTP/Basics_of_HTTP/MIME_types/Common_types /ru/docs/Web/HTTP/Response_codes /ru/docs/Web/HTTP/Status -/ru/docs/Web/HTTP/Server-Side_Access_Control /ru/docs/conflicting/Web/HTTP/CORS /ru/docs/Web/HTTP/Авторизация /ru/docs/Web/HTTP/Authentication /ru/docs/Web/HTTP/Заголовки /ru/docs/Web/HTTP/Headers /ru/docs/Web/HTTP/Заголовки/Accept /ru/docs/Web/HTTP/Headers/Accept @@ -728,21 +552,16 @@ /ru/docs/Web/HTTP/Куки /ru/docs/Web/HTTP/Cookies /ru/docs/Web/HTTP/Кэширование /ru/docs/Web/HTTP/Caching /ru/docs/Web/JavaScript/ECMAScript_5_support_in_Mozilla /ru/docs/Web/JavaScript/New_in_JavaScript/ECMAScript_5_support_in_Mozilla -/ru/docs/Web/JavaScript/Guide/About /ru/docs/conflicting/Web/JavaScript/Guide/Introduction /ru/docs/Web/JavaScript/Guide/Closures /ru/docs/Web/JavaScript/Closures /ru/docs/Web/JavaScript/Guide/EventLoop /ru/docs/Web/JavaScript/EventLoop /ru/docs/Web/JavaScript/Guide/Inheritance_and_the_prototype_chain /ru/docs/Web/JavaScript/Inheritance_and_the_prototype_chain /ru/docs/Web/JavaScript/Guide/Ispolzovanie_promisov /ru/docs/Web/JavaScript/Guide/Using_promises -/ru/docs/Web/JavaScript/Guide/JavaScript_Overview /ru/docs/conflicting/Web/JavaScript/Guide/Introduction_6f341ba6db4b060ccbd8dce4a0d5214b -/ru/docs/Web/JavaScript/Guide/Predefined_Core_Objects /ru/docs/conflicting/Web/JavaScript/Guide /ru/docs/Web/JavaScript/Guide/Statements /ru/docs/Web/JavaScript/Guide/Control_flow_and_error_handling /ru/docs/Web/JavaScript/Guide/The_Iterator_protocol /ru/docs/Web/JavaScript/Reference/Iteration_protocols /ru/docs/Web/JavaScript/Guide/Values,_variables,_and_literals /ru/docs/Web/JavaScript/Guide/Grammar_and_types /ru/docs/Web/JavaScript/Guide/Введение_в_JavaScript /ru/docs/Web/JavaScript/Guide/Introduction -/ru/docs/Web/JavaScript/Guide/Об_этом_руководстве /ru/docs/orphaned/Web/JavaScript/Guide/Об_этом_руководстве /ru/docs/Web/JavaScript/Guide/Циклы_и_итерации /ru/docs/Web/JavaScript/Guide/Loops_and_iteration /ru/docs/Web/JavaScript/Guide_ru /ru/docs/Web/JavaScript/Guide -/ru/docs/Web/JavaScript/Guide_ru/About /ru/docs/conflicting/Web/JavaScript/Guide/Introduction /ru/docs/Web/JavaScript/Guide_ru/Expressions_and_Operators /ru/docs/Web/JavaScript/Guide/Expressions_and_Operators /ru/docs/Web/JavaScript/Guide_ru/Functions /ru/docs/Web/JavaScript/Guide/Functions /ru/docs/Web/JavaScript/Guide_ru/Inheritance_and_the_prototype_chain_ru /ru/docs/Web/JavaScript/Inheritance_and_the_prototype_chain @@ -752,98 +571,42 @@ /ru/docs/Web/JavaScript/Guide_ru/Values,_variables,_and_literals /ru/docs/Web/JavaScript/Guide/Grammar_and_types /ru/docs/Web/JavaScript/Guide_ru/Working_with_Objects /ru/docs/Web/JavaScript/Guide/Working_with_Objects /ru/docs/Web/JavaScript/Guide_ru/Замыкания /ru/docs/Web/JavaScript/Closures -/ru/docs/Web/JavaScript/Introduction_to_Object-Oriented_JavaScript /ru/docs/conflicting/Learn/JavaScript/Objects /ru/docs/Web/JavaScript/JavaScript_шеллы /ru/docs/Web/JavaScript/Shells /ru/docs/Web/JavaScript/New_in_JavaScript/Новое_в_JavaScript_1.6 /ru/docs/Web/JavaScript/New_in_JavaScript/1.6 /ru/docs/Web/JavaScript/Reference/Classes/Class_fields /ru/docs/Web/JavaScript/Reference/Classes/Public_class_fields /ru/docs/Web/JavaScript/Reference/Classes/Приватные_поля_класса /ru/docs/Web/JavaScript/Reference/Classes/Private_class_fields -/ru/docs/Web/JavaScript/Reference/Errors/Typed_array_invalid_arguments /ru/docs/orphaned/Web/JavaScript/Reference/Errors/Typed_array_invalid_arguments /ru/docs/Web/JavaScript/Reference/Errors/Переменные_скрывают_аргумент /ru/docs/Web/JavaScript/Reference/Errors/Var_hides_argument /ru/docs/Web/JavaScript/Reference/Functions/Определиние_методов /ru/docs/Web/JavaScript/Reference/Functions/Method_definitions /ru/docs/Web/JavaScript/Reference/Global_Objects/Array/contains /ru/docs/Web/JavaScript/Reference/Global_Objects/Array/includes -/ru/docs/Web/JavaScript/Reference/Global_Objects/Array/prototype /ru/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Array/prototype -/ru/docs/Web/JavaScript/Reference/Global_Objects/AsyncFunction/prototype /ru/docs/orphaned/Web/JavaScript/Reference/Global_Objects/AsyncFunction/prototype -/ru/docs/Web/JavaScript/Reference/Global_Objects/Boolean/prototype /ru/docs/conflicting/Web/JavaScript/Reference/Global_Objects/Boolean /ru/docs/Web/JavaScript/Reference/Global_Objects/Collator /ru/docs/Web/JavaScript/Reference/Global_Objects/Intl/Collator /ru/docs/Web/JavaScript/Reference/Global_Objects/Collator/compare /ru/docs/Web/JavaScript/Reference/Global_Objects/Intl/Collator/compare -/ru/docs/Web/JavaScript/Reference/Global_Objects/Collator/prototype /ru/docs/conflicting/Web/JavaScript/Reference/Global_Objects/Intl/Collator /ru/docs/Web/JavaScript/Reference/Global_Objects/Collator/resolvedOptions /ru/docs/Web/JavaScript/Reference/Global_Objects/Intl/Collator/resolvedOptions /ru/docs/Web/JavaScript/Reference/Global_Objects/Collator/supportedLocalesOf /ru/docs/Web/JavaScript/Reference/Global_Objects/Intl/Collator/supportedLocalesOf -/ru/docs/Web/JavaScript/Reference/Global_Objects/Date/prototype /ru/docs/conflicting/Web/JavaScript/Reference/Global_Objects/Date /ru/docs/Web/JavaScript/Reference/Global_Objects/DateTimeFormat /ru/docs/Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat /ru/docs/Web/JavaScript/Reference/Global_Objects/DateTimeFormat/format /ru/docs/Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat/format /ru/docs/Web/JavaScript/Reference/Global_Objects/DateTimeFormat/formatToParts /ru/docs/Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat/formatToParts -/ru/docs/Web/JavaScript/Reference/Global_Objects/DateTimeFormat/prototype /ru/docs/conflicting/Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat /ru/docs/Web/JavaScript/Reference/Global_Objects/DateTimeFormat/resolvedOptions /ru/docs/Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat/resolvedOptions /ru/docs/Web/JavaScript/Reference/Global_Objects/DateTimeFormat/supportedLocalesOf /ru/docs/Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat/supportedLocalesOf -/ru/docs/Web/JavaScript/Reference/Global_Objects/Error/prototype /ru/docs/conflicting/Web/JavaScript/Reference/Global_Objects/Error -/ru/docs/Web/JavaScript/Reference/Global_Objects/EvalError/prototype /ru/docs/conflicting/Web/JavaScript/Reference/Global_Objects/EvalError -/ru/docs/Web/JavaScript/Reference/Global_Objects/Function/prototype /ru/docs/conflicting/Web/JavaScript/Reference/Global_Objects/Function -/ru/docs/Web/JavaScript/Reference/Global_Objects/GeneratorFunction/prototype /ru/docs/conflicting/Web/JavaScript/Reference/Global_Objects/GeneratorFunction -/ru/docs/Web/JavaScript/Reference/Global_Objects/InternalError/prototype /ru/docs/conflicting/Web/JavaScript/Reference/Global_Objects/InternalError -/ru/docs/Web/JavaScript/Reference/Global_Objects/Intl/Collator/prototype /ru/docs/conflicting/Web/JavaScript/Reference/Global_Objects/Intl/Collator -/ru/docs/Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat/prototype /ru/docs/conflicting/Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat -/ru/docs/Web/JavaScript/Reference/Global_Objects/Intl/NumberFormat/prototype /ru/docs/conflicting/Web/JavaScript/Reference/Global_Objects/Intl/NumberFormat /ru/docs/Web/JavaScript/Reference/Global_Objects/ListFormat /ru/docs/Web/JavaScript/Reference/Global_Objects/Intl/ListFormat -/ru/docs/Web/JavaScript/Reference/Global_Objects/Map /ru/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map -/ru/docs/Web/JavaScript/Reference/Global_Objects/Map/@@species /ru/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/@@species -/ru/docs/Web/JavaScript/Reference/Global_Objects/Map/clear /ru/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/clear -/ru/docs/Web/JavaScript/Reference/Global_Objects/Map/delete /ru/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/delete -/ru/docs/Web/JavaScript/Reference/Global_Objects/Map/entries /ru/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/entries -/ru/docs/Web/JavaScript/Reference/Global_Objects/Map/forEach /ru/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/forEach -/ru/docs/Web/JavaScript/Reference/Global_Objects/Map/get /ru/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/get -/ru/docs/Web/JavaScript/Reference/Global_Objects/Map/has /ru/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/has -/ru/docs/Web/JavaScript/Reference/Global_Objects/Map/keys /ru/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/keys -/ru/docs/Web/JavaScript/Reference/Global_Objects/Map/prototype /ru/docs/conflicting/Web/JavaScript/Reference/Global_Objects/Map -/ru/docs/Web/JavaScript/Reference/Global_Objects/Map/set /ru/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/set -/ru/docs/Web/JavaScript/Reference/Global_Objects/Map/size /ru/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/size -/ru/docs/Web/JavaScript/Reference/Global_Objects/Map/values /ru/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Map/values -/ru/docs/Web/JavaScript/Reference/Global_Objects/Math/Метод_Math.max()_ /ru/docs/orphaned/Web/JavaScript/Reference/Global_Objects/Math/Метод_Math.max()_ -/ru/docs/Web/JavaScript/Reference/Global_Objects/Number/prototype /ru/docs/conflicting/Web/JavaScript/Reference/Global_Objects/Number /ru/docs/Web/JavaScript/Reference/Global_Objects/NumberFormat /ru/docs/Web/JavaScript/Reference/Global_Objects/Intl/NumberFormat /ru/docs/Web/JavaScript/Reference/Global_Objects/NumberFormat/format /ru/docs/Web/JavaScript/Reference/Global_Objects/Intl/NumberFormat/format -/ru/docs/Web/JavaScript/Reference/Global_Objects/NumberFormat/prototype /ru/docs/conflicting/Web/JavaScript/Reference/Global_Objects/Intl/NumberFormat /ru/docs/Web/JavaScript/Reference/Global_Objects/NumberFormat/resolvedOptions /ru/docs/Web/JavaScript/Reference/Global_Objects/Intl/NumberFormat/resolvedOptions /ru/docs/Web/JavaScript/Reference/Global_Objects/NumberFormat/supportedLocalesOf /ru/docs/Web/JavaScript/Reference/Global_Objects/Intl/NumberFormat/supportedLocalesOf -/ru/docs/Web/JavaScript/Reference/Global_Objects/Object/prototype /ru/docs/conflicting/Web/JavaScript/Reference/Global_Objects/Object -/ru/docs/Web/JavaScript/Reference/Global_Objects/Promise/prototype /ru/docs/conflicting/Web/JavaScript/Reference/Global_Objects/Promise -/ru/docs/Web/JavaScript/Reference/Global_Objects/Proxy/handler /ru/docs/conflicting/Web/JavaScript/Reference/Global_Objects/Proxy/Proxy /ru/docs/Web/JavaScript/Reference/Global_Objects/Proxy/handler/deleteProperty /ru/docs/Web/JavaScript/Reference/Global_Objects/Proxy/Proxy/deleteProperty /ru/docs/Web/JavaScript/Reference/Global_Objects/Proxy/handler/set /ru/docs/Web/JavaScript/Reference/Global_Objects/Proxy/Proxy/set -/ru/docs/Web/JavaScript/Reference/Global_Objects/RangeError/prototype /ru/docs/conflicting/Web/JavaScript/Reference/Global_Objects/RangeError -/ru/docs/Web/JavaScript/Reference/Global_Objects/ReferenceError/prototype /ru/docs/conflicting/Web/JavaScript/Reference/Global_Objects/ReferenceError -/ru/docs/Web/JavaScript/Reference/Global_Objects/RegExp/prototype /ru/docs/conflicting/Web/JavaScript/Reference/Global_Objects/RegExp -/ru/docs/Web/JavaScript/Reference/Global_Objects/Set/prototype /ru/docs/conflicting/Web/JavaScript/Reference/Global_Objects/Set /ru/docs/Web/JavaScript/Reference/Global_Objects/String/TrimLeft /ru/docs/Web/JavaScript/Reference/Global_Objects/String/trimStart /ru/docs/Web/JavaScript/Reference/Global_Objects/String/TrimRight /ru/docs/Web/JavaScript/Reference/Global_Objects/String/trimEnd /ru/docs/Web/JavaScript/Reference/Global_Objects/String/contains /ru/docs/Web/JavaScript/Reference/Global_Objects/String/includes -/ru/docs/Web/JavaScript/Reference/Global_Objects/String/prototype /ru/docs/conflicting/Web/JavaScript/Reference/Global_Objects/String -/ru/docs/Web/JavaScript/Reference/Global_Objects/Symbol/prototype /ru/docs/conflicting/Web/JavaScript/Reference/Global_Objects/Symbol -/ru/docs/Web/JavaScript/Reference/Global_Objects/SyntaxError/prototype /ru/docs/conflicting/Web/JavaScript/Reference/Global_Objects/SyntaxError -/ru/docs/Web/JavaScript/Reference/Global_Objects/TypeError/prototype /ru/docs/conflicting/Web/JavaScript/Reference/Global_Objects/TypeError -/ru/docs/Web/JavaScript/Reference/Global_Objects/TypedArray/prototype /ru/docs/conflicting/Web/JavaScript/Reference/Global_Objects/TypedArray -/ru/docs/Web/JavaScript/Reference/Global_Objects/URIError/prototype /ru/docs/conflicting/Web/JavaScript/Reference/Global_Objects/URIError -/ru/docs/Web/JavaScript/Reference/Global_Objects/WeakMap/prototype /ru/docs/conflicting/Web/JavaScript/Reference/Global_Objects/WeakMap -/ru/docs/Web/JavaScript/Reference/Global_Objects/WeakSet/prototype /ru/docs/conflicting/Web/JavaScript/Reference/Global_Objects/WeakSet /ru/docs/Web/JavaScript/Reference/Methods_Index /ru/docs/Web/JavaScript/Reference -/ru/docs/Web/JavaScript/Reference/Operators/Arithmetic_Operators /ru/docs/conflicting/Web/JavaScript/Reference/Operators -/ru/docs/Web/JavaScript/Reference/Operators/Assignment_Operators /ru/docs/conflicting/Web/JavaScript/Reference/Operators_8d54701de06af40a7c984517cbe87b3e -/ru/docs/Web/JavaScript/Reference/Operators/Bitwise_Operators /ru/docs/conflicting/Web/JavaScript/Reference/Operators_7c8eb9475d97a4a734c5991857698560 -/ru/docs/Web/JavaScript/Reference/Operators/Pipeline_operator /ru/docs/orphaned/Web/JavaScript/Reference/Operators/Pipeline_operator /ru/docs/Web/JavaScript/Reference/Operators/Spread_operator /ru/docs/Web/JavaScript/Reference/Operators/Spread_syntax /ru/docs/Web/JavaScript/Reference/Operators/Группировка /ru/docs/Web/JavaScript/Reference/Operators/Grouping -/ru/docs/Web/JavaScript/Reference/Operators/Конвейерный_оператор /ru/docs/orphaned/Web/JavaScript/Reference/Operators/Pipeline_operator -/ru/docs/Web/JavaScript/Reference/Operators/Логические_операторы /ru/docs/conflicting/Web/JavaScript/Reference/Operators_843c998343f0cdaa5699874c806d4cea /ru/docs/Web/JavaScript/Reference/Operators/Оператор_Запятая /ru/docs/Web/JavaScript/Reference/Operators/Comma_Operator -/ru/docs/Web/JavaScript/Reference/Operators/Операторы_сравнения /ru/docs/conflicting/Web/JavaScript/Reference/Operators_69135a8d5772f8b6e45265523df05d89 /ru/docs/Web/JavaScript/Reference/Operators/Присваивание /ru/docs/Web/JavaScript/Reference/Operators/Assignment /ru/docs/Web/JavaScript/Reference/Operators/Условный_оператор /ru/docs/Web/JavaScript/Reference/Operators/Conditional_Operator /ru/docs/Web/JavaScript/Reference/Properties_Index /ru/docs/Web/JavaScript/Reference -/ru/docs/Web/JavaScript/Reference/Statements/default /ru/docs/conflicting/Web/JavaScript/Reference/Statements/switch /ru/docs/Web/JavaScript/Reference/Statements/Блок /ru/docs/Web/JavaScript/Reference/Statements/block /ru/docs/Web/JavaScript/Reference/template_strings /ru/docs/Web/JavaScript/Reference/Template_literals /ru/docs/Web/JavaScript/Reference/Об /ru/docs/Web/JavaScript/Reference/About -/ru/docs/Web/JavaScript/ru_JavaScript_Overview /ru/docs/conflicting/Web/JavaScript/Guide/Introduction_6f341ba6db4b060ccbd8dce4a0d5214b /ru/docs/Web/JavaScript/О_JavaScript /ru/docs/Web/JavaScript/About_JavaScript /ru/docs/Web/JavaScript/Справочник_по_JavaScript_1.5 /ru/docs/Web/JavaScript/Reference /ru/docs/Web/JavaScript/Справочник_по_JavaScript_1.5/Methods_Index /ru/docs/Web/JavaScript/Reference @@ -867,7 +630,6 @@ /ru/docs/Web/JavaScript/Справочник_по_JavaScript_1.5/Глобальные_объекты/Function/call /ru/docs/Web/JavaScript/Reference/Global_Objects/Function/call /ru/docs/Web/JavaScript/Справочник_по_JavaScript_1.5/Глобальные_объекты/Function/length /ru/docs/Web/JavaScript/Reference/Global_Objects/Function/length /ru/docs/Web/JavaScript/Справочник_по_JavaScript_1.5/Глобальные_объекты/Function/name /ru/docs/Web/JavaScript/Reference/Global_Objects/Function/name -/ru/docs/Web/JavaScript/Справочник_по_JavaScript_1.5/Глобальные_объекты/Function/prototype /ru/docs/conflicting/Web/JavaScript/Reference/Global_Objects/Function /ru/docs/Web/JavaScript/Справочник_по_JavaScript_1.5/Глобальные_объекты/Math /ru/docs/Web/JavaScript/Reference/Global_Objects/Math /ru/docs/Web/JavaScript/Справочник_по_JavaScript_1.5/Глобальные_объекты/Object /ru/docs/Web/JavaScript/Reference/Global_Objects/Object /ru/docs/Web/JavaScript/Справочник_по_JavaScript_1.5/Глобальные_объекты/RegExp /ru/docs/Web/JavaScript/Reference/Global_Objects/RegExp @@ -877,11 +639,6 @@ /ru/docs/Web/JavaScript/Справочник_по_JavaScript_1.5/Операторы /ru/docs/Web/JavaScript/Reference/Operators /ru/docs/Web/JavaScript/Справочник_по_JavaScript_1.5/Операции /ru/docs/Web/JavaScript/Reference/Operators /ru/docs/Web/JavaScript/Справочник_по_JavaScript_1.5/Операции/Assignment_Operators /ru/docs/Web/JavaScript/Reference/Operators -/ru/docs/Web/JavaScript/Справочник_по_JavaScript_1.5/Операции/Арифметические_Операции /ru/docs/conflicting/Web/JavaScript/Reference/Operators -/ru/docs/Web/JavaScript/Справочник_по_JavaScript_1.5/Операции/Битовые_Операции /ru/docs/conflicting/Web/JavaScript/Reference/Operators_7c8eb9475d97a4a734c5991857698560 -/ru/docs/Web/JavaScript/Справочник_по_JavaScript_1.5/Операции/Операции_Присваивания /ru/docs/conflicting/Web/JavaScript/Reference/Operators_8d54701de06af40a7c984517cbe87b3e -/ru/docs/Web/Manifest/serviceworker /ru/docs/orphaned/Web/Manifest/serviceworker -/ru/docs/Web/MathML/Element/mglyph /ru/docs/orphaned/Web/MathML/Element/mglyph /ru/docs/Web/MathML/Атрибут /ru/docs/Web/MathML/Attribute /ru/docs/Web/MathML/Примеры /ru/docs/Web/MathML/Examples /ru/docs/Web/MathML/Примеры/Deriving_the_Quadratic_Formula /ru/docs/Web/MathML/Examples/Deriving_the_Quadratic_Formula @@ -889,10 +646,6 @@ /ru/docs/Web/Media/Formats/WebRTC_кодеки /ru/docs/Web/Media/Formats/WebRTC_codecs /ru/docs/Web/Performance/Основы /ru/docs/Web/Performance/Fundamentals /ru/docs/Web/Performance/Производительность_анимации /ru/docs/Web/Performance/Animation_performance_and_frame_rate -/ru/docs/Web/Progressive_web_apps/Заметный /ru/docs/conflicting/Web/Progressive_web_apps_628955cdadd77b10ec99de034fc76374 -/ru/docs/Web/Reference /ru/docs/orphaned/Web/Reference -/ru/docs/Web/Reference/API /ru/docs/orphaned/Web/Reference/API -/ru/docs/Web/SVG/Attribute/onload /ru/docs/orphaned/Web/SVG/Attribute/onload /ru/docs/Web/SVG/Tutorial/Базовые_Преобразования /ru/docs/Web/SVG/Tutorial/Basic_Transformations /ru/docs/Web/SVG/Tutorial/Введение /ru/docs/Web/SVG/Tutorial/Introduction /ru/docs/Web/SVG/Tutorial/Основные_Фигуры /ru/docs/Web/SVG/Tutorial/Basic_Shapes @@ -918,9 +671,6 @@ /ru/docs/Web/SVG/Элемент/rect /ru/docs/Web/SVG/Element/rect /ru/docs/Web/SVG/Элемент/svg /ru/docs/Web/SVG/Element/svg /ru/docs/Web/SVG/Элемент/use /ru/docs/Web/SVG/Element/use -/ru/docs/Web/Security/CSP /ru/docs/conflicting/Web/HTTP/CSP -/ru/docs/Web/Security/Information_Security_Basics /ru/docs/orphaned/Web/Security/Information_Security_Basics -/ru/docs/Web/WebAPI /ru/docs/conflicting/Web/API /ru/docs/Web/WebGL /ru/docs/Web/API/WebGL_API /ru/docs/Web/WebGL/Adding_2D_content_to_a_WebGL_context /ru/docs/Web/API/WebGL_API/Tutorial/Adding_2D_content_to_a_WebGL_context /ru/docs/Web/WebGL/Animating_objects_with_WebGL /ru/docs/Web/API/WebGL_API/Tutorial/Animating_objects_with_WebGL @@ -944,7 +694,6 @@ /ru/docs/Web/Манифест/related_applications /ru/docs/Web/Manifest/related_applications /ru/docs/Web/Манифест/scope /ru/docs/Web/Manifest/scope /ru/docs/Web/Манифест/screenshots /ru/docs/Web/Manifest/screenshots -/ru/docs/Web/Манифест/serviceworker /ru/docs/orphaned/Web/Manifest/serviceworker /ru/docs/Web/Манифест/short_name /ru/docs/Web/Manifest/short_name /ru/docs/Web/Манифест/start_url /ru/docs/Web/Manifest/start_url /ru/docs/Web/Манифест/theme_color /ru/docs/Web/Manifest/theme_color @@ -952,13 +701,7 @@ /ru/docs/WebGL/Using_shaders_to_apply_color_in_WebGL /ru/docs/Web/API/WebGL_API/Tutorial/Using_shaders_to_apply_color_in_WebGL /ru/docs/WebSockets /ru/docs/Web/API/WebSockets_API /ru/docs/WebSockets/Writing_WebSocket_client_applications /ru/docs/Web/API/WebSockets_API/Writing_WebSocket_client_applications -/ru/docs/Web_Development/Mobile /ru/docs/conflicting/Web/Guide/Mobile -/ru/docs/Web_Development/Mobile/Responsive_design /ru/docs/conflicting/Web/Progressive_web_apps /ru/docs/XHTML /ru/docs/Glossary/XHTML -/ru/docs/XMLHttpRequest /ru/docs/conflicting/Web/API/XMLHttpRequest -/ru/docs/XML_in_Mozilla /ru/docs/orphaned/XML_in_Mozilla -/ru/docs/XPCNativeWrapper /ru/docs/orphaned/XPCNativeWrapper -/ru/docs/XPCOM /ru/docs/orphaned/XPCOM /ru/docs/XPath /ru/docs/Web/XPath /ru/docs/XPath/Funkcje /ru/docs/Web/XPath/Functions /ru/docs/XPath/Funkcje/floor /ru/docs/Web/XPath/Functions/floor @@ -966,18 +709,8 @@ /ru/docs/en /en-US/ /ru/docs/kak_soobschit_o_zavisshem_Firefox /ru/docs/Как_сообщить_о_зависшем_Firefox /ru/docs/nsIOutputStream:writeFrom /ru/docs/nsIOutputStream/writeFrom -/ru/docs/Веб-разработка /ru/docs/conflicting/Web/Guide -/ru/docs/Веб-стандарты /ru/docs/orphaned/Веб-стандарты -/ru/docs/Вопросы_без_ответов /ru/docs/orphaned/Вопросы_без_ответов -/ru/docs/Динамически_изменяемый_пользовательский_интерфейс_на_XUL /ru/docs/orphaned/Динамически_изменяемый_пользовательский_интерфейс_на_XUL -/ru/docs/Доступность /ru/docs/orphaned/Доступность /ru/docs/Заглавная_страница /ru/docs/Web -/ru/docs/Контроль_качества /ru/docs/orphaned/Контроль_качества -/ru/docs/Локализация /ru/docs/orphaned/Локализация -/ru/docs/Настройка_среды_разработки_расширений /ru/docs/orphaned/Настройка_среды_разработки_расширений /ru/docs/Новое_в_JavaScript_1.6 /ru/docs/Web/JavaScript/New_in_JavaScript/1.6 -/ru/docs/Об_объектной_модели_документа /ru/docs/conflicting/Web/API/Document_Object_Model_5521049528397035462607d58539e0cc -/ru/docs/Переход_с_Internet_Explorer_на_Mozilla /ru/docs/orphaned/Переход_с_Internet_Explorer_на_Mozilla /ru/docs/Повторное_введение_в_JavaScript /ru/docs/Web/JavaScript/A_re-introduction_to_JavaScript /ru/docs/Руководство_по_JavaScript_1.5 /ru/docs/Web/JavaScript/Guide /ru/docs/Руководство_по_JavaScript_1.5/Операторы /ru/docs/Web/JavaScript/Reference/Operators @@ -986,7 +719,6 @@ /ru/docs/Руководство_по_JavaScript_1.5/Функции /ru/docs/Web/JavaScript/Guide/Functions /ru/docs/Руководство_по_JavaScript_1.5:Функции /ru/docs/Web/JavaScript/Guide/Functions /ru/docs/Руководство_разработчика_дополнений_Firefox /ru/docs/Firefox_addons_developer_guide -/ru/docs/Сборка_и_установка /ru/docs/orphaned/Сборка_и_установка /ru/docs/Словарь /ru/docs/Glossary /ru/docs/Словарь/404 /ru/docs/Glossary/404 /ru/docs/Словарь/502 /ru/docs/Glossary/502 @@ -1199,15 +931,6 @@ /ru/docs/Словарь/пустой_элемент /ru/docs/Glossary/Empty_element /ru/docs/Словарь/функция_обратного_вызова /ru/docs/Glossary/Callback_function /ru/docs/Словарь/хеш /ru/docs/Glossary/hash -/ru/docs/Создание_расширения /ru/docs/orphaned/Создание_расширения -/ru/docs/Создание_расширения/Настройка_Firefox_для_разработки /ru/docs/orphaned/Создание_расширения/Настройка_Firefox_для_разработки -/ru/docs/Создание_расширения/Настройка_Firefox_для_разработки_расширений /ru/docs/orphaned/Создание_расширения/Настройка_Firefox_для_разработки_расширений -/ru/docs/Создание_расширения_для_Firefox_с_использованием_Mozilla_Build_System /ru/docs/orphaned/Создание_расширения_для_Firefox_с_использованием_Mozilla_Build_System -/ru/docs/Справочная_информация_по_Gecko_DOM /ru/docs/orphaned/Справочная_информация_по_Gecko_DOM -/ru/docs/Справочная_информация_по_Gecko_DOM/Введение /ru/docs/orphaned/Справочная_информация_по_Gecko_DOM/Введение -/ru/docs/Справочная_информация_по_Gecko_DOM/Предисловие /ru/docs/orphaned/Справочная_информация_по_Gecko_DOM/Предисловие -/ru/docs/Справочная_информация_по_Gecko_DOM/Примеры /ru/docs/orphaned/Справочная_информация_по_Gecko_DOM/Примеры -/ru/docs/Справочная_информация_по_Gecko_DOM:Предисловие /ru/docs/orphaned/Справочная_информация_по_Gecko_DOM/Предисловие /ru/docs/Справочник_по_JavaScript_1.5 /ru/docs/Web/JavaScript/Reference /ru/docs/Справочник_по_JavaScript_1.5/Глобальные_объекты /ru/docs/Web/JavaScript/Reference/Global_Objects /ru/docs/Справочник_по_JavaScript_1.5/Глобальные_объекты/Array /ru/docs/Web/JavaScript/Reference/Global_Objects/Array @@ -1217,7 +940,6 @@ /ru/docs/Справочник_по_JavaScript_1.5/Глобальные_объекты/Boolean /ru/docs/Web/JavaScript/Reference/Global_Objects/Boolean /ru/docs/Справочник_по_JavaScript_1.5/Глобальные_объекты/Function /ru/docs/Web/JavaScript/Reference/Global_Objects/Function /ru/docs/Справочник_по_JavaScript_1.5/Глобальные_объекты/Function/length /ru/docs/Web/JavaScript/Reference/Global_Objects/Function/length -/ru/docs/Справочник_по_JavaScript_1.5/Глобальные_объекты/Function/prototype /ru/docs/conflicting/Web/JavaScript/Reference/Global_Objects/Function /ru/docs/Справочник_по_JavaScript_1.5/Глобальные_объекты/Math /ru/docs/Web/JavaScript/Reference/Global_Objects/Math /ru/docs/Справочник_по_JavaScript_1.5/Глобальные_объекты/Object /ru/docs/Web/JavaScript/Reference/Global_Objects/Object /ru/docs/Справочник_по_JavaScript_1.5/Глобальные_объекты/RegExp /ru/docs/Web/JavaScript/Reference/Global_Objects/RegExp @@ -1227,13 +949,9 @@ /ru/docs/Справочник_по_JavaScript_1.5/Операторы /ru/docs/Web/JavaScript/Reference/Operators /ru/docs/Справочник_по_JavaScript_1.5/Операции /ru/docs/Web/JavaScript/Reference/Operators /ru/docs/Справочник_по_JavaScript_1.5/Операции/Assignment_Operators /ru/docs/Web/JavaScript/Reference/Operators -/ru/docs/Справочник_по_JavaScript_1.5/Операции/Арифметические_Операции /ru/docs/conflicting/Web/JavaScript/Reference/Operators -/ru/docs/Справочник_по_JavaScript_1.5/Операции/Битовые_Операции /ru/docs/conflicting/Web/JavaScript/Reference/Operators_7c8eb9475d97a4a734c5991857698560 -/ru/docs/Справочник_по_JavaScript_1.5/Операции/Операции_Присваивания /ru/docs/conflicting/Web/JavaScript/Reference/Operators_8d54701de06af40a7c984517cbe87b3e /ru/docs/Справочник_по_JavaScript_1.5:Глобальные_объекты /ru/docs/Web/JavaScript/Reference/Global_Objects /ru/docs/Справочник_по_JavaScript_1.5:Глобальные_функции:String /ru/docs/Web/JavaScript/Reference/Global_Objects/String /ru/docs/Справочник_по_JavaScript_1.5:Глобальные_функции:isNaN /ru/docs/Web/JavaScript/Reference/Global_Objects/isNaN -/ru/docs/Темы /ru/docs/orphaned/Темы /ru/docs/Ядро_JavaScript_1.5_Спровчник /ru/docs/Web/JavaScript/Reference /ru/docs/Ядро_JavaScript_1.5_Спровчник/Functions /ru/docs/Web/JavaScript/Reference/Functions /ru/docs/Ядро_JavaScript_1.5_Спровчник/Functions/Arrow_functions /ru/docs/Web/JavaScript/Reference/Functions/Arrow_functions diff --git a/files/ru/conflicting/glossary/chrome/index.html b/files/ru/conflicting/glossary/chrome/index.html deleted file mode 100644 index 9fd3be89b4..0000000000 --- a/files/ru/conflicting/glossary/chrome/index.html +++ /dev/null @@ -1,81 +0,0 @@ ---- -title: Chrome -slug: conflicting/Glossary/Chrome -tags: - - Toolkit API -translation_of: Glossary/Chrome -translation_of_original: Chrome -original_slug: Chrome ---- -<p><b>Chrome</b> применительно к Mozilla имеет несколько разных значений.</p> -<h3 id="Браузерный_chrome_Chrome">Браузерный chrome / Chrome</h3> -<dl> - <dd> - «Браузерный chrome» — это пользовательский интерфейс (UI) самого браузера вокруг отображаемой web-страницы. Иными словами, это всё, что не имеет отношения к контенту страницы.</dd> - <dd> - В общем, chrome — это совокупность элементов, формирующих пользовательский интерфейс приложений или <a href="en/Extension">дополнений</a>.</dd> -</dl> -<h3 id="URL">URL</h3> -<dl> - <dd> - Chrome как протокол вида <code><span class="external">chrome://</span></code>, используемый в URL.</dd> - <dd> - Код, загруженный таким образом, имеет расширенные, или - <i> - chrome-</i> - привилегии.</dd> - <dd> - Приложения, основанные на XUL, загружают код своего интерфейса с использованием URL <code><a class="external" rel="freelink">chrome://</a></code>.</dd> -</dl> -<h3 id="Привилегии">Привилегии</h3> -<dl> - <dd> - Коду, запущенному с привилегиями <em>chrome</em>, разрешено делать всё, в отличие от веб-контента, который ограничен в своих возможностях.</dd> -</dl> -<h3 id="Аргумент_в_window.open">Аргумент в <code>window.open</code></h3> -<dl> - <dd> - Передача аргумента <code>chrome </code>в функцию <a href="en/DOM/window.open#Features_requiring_privileges"><code>window.open</code></a> откроет новое окно браузера без элементов интерфейса.</dd> -</dl> -<h3 id="Каталог">Каталог</h3> -<dl> - <dd> - Эта директория, как правило, является частью устанавливаемого приложения, основанного на XUL. Приложения обычно загружают свои UI-файлы из этого каталога.</dd> -</dl> -<h3 id="Аргумент_командной_строки">Аргумент командной строки</h3> -<dl> - <dd> - Запускает приложение и открывает указанный XUL файл в окне верхнего уровня. Например, команда</dd> - <dd> - <code>mozilla -chrome <span class="external">chrome://inspector/content</span></code></dd> - <dd> - запустит DOM Инспектор.</dd> -</dl> -<h3 id="Пакет">Пакет</h3> -<dl> - <dd> - <em>Пакет chrome</em> состоит из набора - <i> - <a href="/ru/Chrome_Registration">провайдеров chrome (providers)</a></i> - . Существует три базовых типа провайдеров chrome:</dd> - <dd> - <ul> - <li><b><span id="cke_bm_101S" class="hidden"> </span>Content</b>. Контент может состоять из файлов любого вида, видимых для Mozilla. В частности, ресурс <strong>content</strong>, как правило, состоит из набора <a href="en/XUL">XUL</a>, <a href="en/JavaScript">JavaScript</a> и сборочных файлов <a href="en/XBL">XBL</a>.</li> - <li><b>Locale</b>. Переводы для поддержки нескольких языков. Здесь два основных типа файлов: <a href="en/XUL_Tutorial/Localization">DTD</a> файлы и java-подобные <a href="en/XUL_Tutorial/Property_Files">файлы свойств</a>.</li> - <li><b>Skin</b>. Ресурс <em>skin</em> предоставляет полные данные о внешнем виде UI. Состоит из <a href="en/CSS">CSS</a> файлов и изображений.<span id="cke_bm_101E" class="hidden"> </span></li> - </ul> - </dd> -</dl> -<h4 id="sect1"> </h4> -<h3 id="chrome.rdf">chrome.rdf</h3> -<dl> - <dd> - Реестр chrome, хранит список зарегистрированных chrome пакетов и другую информацию. Он был расположен в установочной директории и в профиле. <strong>Больше не используется</strong> начиная с Gecko 1.8 (Firefox 1.5).</dd> -</dl> -<h2 id="See_also" name="See_also">Смотрите также</h2> -<p>(Примечание. Хотя оба документа ниже содержат упоминание файлов <code>contents.rdf</code>, более простой способ регистрации ваших chrome ресурсов — это использование <a href="en/Chrome_Registration">Chrome Manifests</a>, поддерживаемых с <a href="en/Firefox_1.5">Firefox 1.5</a> / Toolkit 1.8)</p> -<ul> - <li><a href="en/XUL_Tutorial/XUL_Structure">XUL Tutorial:XUL Structure</a></li> - <li><a href="en/XUL_Tutorial/The_Chrome_URL">XUL_Tutorial:The Chrome URL</a></li> -</ul> -<p>{{ languages( { "fr": "fr/Chrome", "ja": "ja/Chrome", "pl": "pl/Chrome" ,"ru": "ru/Chrome"} ) }}</p> diff --git a/files/ru/conflicting/learn/css/building_blocks/cascade_and_inheritance/index.html b/files/ru/conflicting/learn/css/building_blocks/cascade_and_inheritance/index.html deleted file mode 100644 index 599069cfb2..0000000000 --- a/files/ru/conflicting/learn/css/building_blocks/cascade_and_inheritance/index.html +++ /dev/null @@ -1,153 +0,0 @@ ---- -title: Каскадность и наследование -slug: conflicting/Learn/CSS/Building_blocks/Cascade_and_inheritance -tags: - - Beginner - - CSS - - CSS:Getting_Started - - Guide - - Web - - Веб - - Новичку -translation_of: Learn/CSS/Building_blocks/Cascade_and_inheritance -translation_of_original: Web/Guide/CSS/Getting_started/Cascading_and_inheritance -original_slug: Web/Guide/CSS/Getting_started/Cascading_and_inheritance ---- -<p>{{ CSSTutorialTOC() }}</p> - -<p>{{ previousPage("/ru/docs/Web/Guide/CSS/Getting_Started/How_CSS_works", "Как работает CSS")}} Это четвёртый раздел руководства <a href="/ru/docs/Web/Guide/CSS/Getting_Started" title="ru/CSS/Getting Started">CSS для начинающих</a>. Он описывает, как таблицы стилей взаимодействуют в каскаде, и как дочерние элементы наследуют стиль от родительских. Используя наследование, в приведённой ниже задаче вы измените стиль некоторых элементов за один шаг.</p> - -<h2 id="Информация_Каскадность_и_наследование">Информация: Каскадность и наследование</h2> - -<p>Окончательный стиль элемента можно указать во многих местах, которые комплексно взаимодействуют между собой. Эти комплексные взаимодействия делают CSS мощным, но в то же время, иногда сбивают с толку и порождают сложности при отладке. </p> - -<p>Три основных источника информации о стилях образовывают <em>каскад</em>. К ним относятся следующие:</p> - -<ul> - <li>Стили разметки браузера по умолчанию.</li> - <li>Стили, указанные пользователем при чтении документа.</li> - <li>Стили, связанные с документом их автором. Их можно указывать в трёх местах:</li> -</ul> - -<ol> - <li>Во внешнем файле: в этом учебном руководстве обсуждается преимущественно этот метод указания стилей.</li> - <li>В начале документа (раздел заголовок документа): используйте этот метод только для стилей в пределах этой страницы.</li> - <li>Для конкретного элемента в теле документа: это наименее поддерживаемый метод, но может быть использован для тестирования.</li> -</ol> - -<p>Стиль пользователя модифицирует стиль браузера по умолчанию. Стиль документа, указанный его автором, изменяет стиль ещё в некоторой мере. В этом обучающем руководстве, вы являетесь автором шаблонного документа, и только вы работаете с авторскими таблицами стилей.</p> - -<div class="tuto_example"> -<div class="tuto_type">Пример</div> - -<p>Когда вы читаете этот документ в браузере, часть стилей происходит от стилей для HTML по умолчанию вашего браузера.</p> - -<p>Часть стиля может происходить от изменённых настроек браузера или изменённого файла определения стиля. В Firefox настройки можно изменить в диалоге Предпочтения или же указать стили в файле <code>userContent.css</code> в профиле браузера.</p> - -<p>Часть стиля приходит из таблиц стилей, связываемых с документом вики-сервером.</p> -</div> - -<p>Когда вы открываете шаблон документа в браузере, элементы {{ HTMLElement("strong") }} имеют более жирный шрифт по сравнению с остальным текстом. Это следует из настроек HTML стилей браузера по умолчанию.</p> - -<p>Элемент {{ HTMLElement("strong") }} красного цвета. Это следует из настроек вашего шаблона таблиц стилей.</p> - -<p>Элементы {{ HTMLElement("strong") }} также наследуют большую часть стилей элемента {{ HTMLElement("p") }} поскольку они являются дочерними. Таким же образом элемент {{ HTMLElement("p") }} наследует большую часть стиля элемента {{ HTMLElement("body") }}.</p> - -<p>Для стилей в каскаде, авторские таблицы стилей имеют приоритет перед стилями для режимов чтения браузера. Последние, в свою очередь, имеют приоритет перед настройками браузера по умолчанию.</p> - -<p>Для наследуемых стилей, собственный стиль дочернего узла имеет приоритет над стилем, унаследованным от родительского узла.</p> - -<p>These are not the only priorities that apply. A later page in this tutorial will explain more.</p> - -<div class="tuto_details"> -<div class="tuto_type">Подробнее</div> - -<p>CSS также предоставляет способ переопределения стиля в авторском документе для читателя с помощью ключевого слова <code>!important</code>.</p> - -<p>Это означает, что как автор документа, вы не всегда можете точно предсказать, что ваши читатели будут видеть в своём браузере.</p> - -<p>Если вы хотите знать все детали каскадирования и наследования, ознакомьтесь с документом <a class="external" href="http://www.w3.org/TR/CSS21/cascade.html">Assigning property values, Cascading, and Inheritance</a> в спецификации CSS.</p> -</div> - -<h2 id="К_действию_Использование_наследования">К действию: Использование наследования</h2> - -<ol> - <li>Откройте CSS-файл примера.</li> - <li>Добавьте в файл строку кода, представленную ниже. Не имеет особого значения, в какой части CSS-документа вы расположите эту строку. Тем не менее, добавить его в самом верху будет логично, поскольку в документе элемент {{ HTMLElement("p") }} является родительским по отношению к элементу {{ HTMLElement("strong") }} : - <pre>p {color: blue; text-decoration: underline;} -</pre> - </li> - <li>Теперь сохраните документ и обновите страницу в браузере, чтобы увидеть изменения. Весь текст в абзаце будет подчеркнут, в том числе и начальные буквы. Элемент {{ HTMLElement("strong") }} унаследовал подчёркнутый стиль от родительского элемента {{ HTMLElement("p") }} .<br> - - <p>Обратите внимание, что элементы {{ HTMLElement("strong") }} всё ещё красные. Красный цвет является их собственным стилем, поэтому имеет приоритет перед синим цветом, заданным для родительского элемента {{ HTMLElement("p") }} . </p> - </li> -</ol> - -<h2 id="Before" name="Before">До</h2> - -<h3 id="HTML">HTML</h3> - -<pre class="brush: html"><p> -<strong>C</strong>ascading -<strong>S</strong>tyle -<strong>S</strong>heets -</p> -</pre> - -<h3 id="CSS">CSS</h3> - -<pre class="brush: css">strong {color:red} -</pre> - -<p>{{ EmbedLiveSample('Before') }}</p> - -<h2 id="After" name="After">После</h2> - -<h3 id="HTML_2">HTML</h3> - -<pre class="brush: html"><p> -<strong>C</strong>ascading -<strong>S</strong>tyle -<strong>S</strong>heets -</p> -</pre> - -<h3 id="CSS_2">CSS</h3> - -<pre class="brush:css">p {color:blue; text-decoration:underline} -strong {color:red}</pre> - -<p>{{ EmbedLiveSample('After') }}</p> - -<p> </p> - -<div class="tuto_example"> -<div class="tuto_type">Задание</div> -Измените таблицу стилей таким образом, чтобы были подчёркнуты только красные буквы: - -<table style="border: 2px outset #3366bb; padding: 1em;"> - <tbody> - <tr> - <td style="color: blue;"><strong style="color: red; text-decoration: underline;">C</strong>ascading <strong style="color: red; text-decoration: underline;">S</strong>tyle <strong style="color: red; text-decoration: underline;">S</strong>heets</td> - </tr> - </tbody> -</table> - -<div class="tuto_details" id="tutochallenge"> -<div class="tuto_type">Возможное решение</div> - -<p>Переместите объявление подчёркивания из правила для {{ HTMLElement("p") }} в правило для {{ HTMLElement("strong") }}. В результате файл будет выглядеть следующим образом:</p> - -<pre class="brush: css">p {color: blue; } -strong {color: red; text-decoration: underline;} -</pre> - -<p> </p> -<a class="hideAnswer" href="#challenge">Hide solution</a></div> -<a href="#tutochallenge" title="Display a possible solution for the challenge">Посмотреть вариант решения.</a></div> - -<p> </p> - -<h2 id="Что_дальше">Что дальше?</h2> - -<p>{{ nextPage("/ru/docs/Web/Guide/CSS/Getting_Started/Selectors", "Селекторы")}}Ваш пример таблицы стилей определяет стили для тегов <p> и <STRONG>, изменяя стиль соответствующих элементов по всему документу. В следующем разделе описывается, как задать стиль более <a href="/ru/docs/Web/Guide/CSS/Getting_Started/Selectors" title="/ru/docs/Web/Guide/CSS/Getting_Started/Selectors">избирательными методами</a>.</p> diff --git a/files/ru/conflicting/learn/css/building_blocks/selectors/index.html b/files/ru/conflicting/learn/css/building_blocks/selectors/index.html deleted file mode 100644 index 795cc38b8c..0000000000 --- a/files/ru/conflicting/learn/css/building_blocks/selectors/index.html +++ /dev/null @@ -1,134 +0,0 @@ ---- -title: 'CSS properties: what they are and how to use them' -slug: conflicting/Learn/CSS/Building_blocks/Selectors -translation_of: Learn/CSS/Building_blocks/Selectors -translation_of_original: Learn/CSS/CSS_properties -original_slug: Learn/CSS/CSS_properties ---- -<div class="summary"> -<p>{{Glossary("CSS")}} определяет как должна выглядеть веб-страница. Он использует предопределённые правила вместе с селекторами и свойствами для применения стилей к элементам HTML или группам элементов.</p> -</div> - -<table class="learn-box standard-table"> - <tbody> - <tr> - <th scope="row">Prerequisites:</th> - <td>Basics of {{Glossary("HTML")}}, <a href="https://developer.mozilla.org/en-US/Learn/HTML/HTML_tags">HTML elements</a>, and <a href="https://developer.mozilla.org/en-US/Learn/CSS/Using_CSS_in_a_web_page#The_link_tag">how to link HTML documents to CSS stylesheets</a>.</td> - </tr> - <tr> - <th scope="row">Objective:</th> - <td>Learn about different CSS selectors and properties enough to style a simple webpage.</td> - </tr> - </tbody> -</table> - -<h2 id="Summary">Summary</h2> - -<p>Разделение содержимого и стиля делает Веб разработку намного быстрее и проще. Когда вы определяете только структуру документа в вашем HTML файле и храните всю информацию о стиле в отдельном файле (называемом stylesheet), вы можете обновлять стили нескольких документов одновременно (а так же экономить ресурсы компьютера).</p> - -<p>CSS syntax consists of easy-to-use, intuitive keywords.</p> - -<pre class="brush: css">p { - font-family: "Times New Roman", georgia, sans-serif; - font-size: 24px; -}</pre> - -<p>In the example above, <code>p</code> is a selector that applies styles to all the <code>{{HTMLElement("p")}}</code> elements at once. The CSS properties <code>font-family</code> and <code>font-size</code> are enclosed within curly braces and the corresponding values, right after the colon, determine the styles.</p> - -<p>There are more than <a href="/en-US/docs/Web/CSS/Reference">250 properties</a> you can apply to your document. From text to layout, (almost) anything is possible.</p> - -<h2 id="Active_Learning">Active Learning</h2> - -<p><em>There is no active learning available yet. <a href="/en-US/docs/MDN/Getting_started">Please, consider contributing</a>.</em></p> - -<h2 id="Deeper_dive">Deeper dive</h2> - -<p>If properties are fairly simple to use, selectors are another story. Okay, they aren't that hard, and mastering them unleashes the full potential of CSS. In the next examples, we will introduce the most common selectors.</p> - -<p>A CSS rule consists of selectors associated with properties. Selectors specify which elements will receive the properties laid down in the rule. Multiple rules can apply to the same element; the CSS cascade (which we'll discuss later on) determines which rule ends up taking effect in the case of conflicts. For now, just remember that the rule with the most <a href="/en-US/docs/Web/CSS/Specificity">specific selector</a> overrides the rules with more generic selectors.</p> - -<h3 id="The_element_selector">The element selector</h3> - -<p>Element selectors select HTML elements by element names only. Moreover, like all CSS selectors, you can apply a common set of properties to several elements at once.</p> - -<p>For our first example, let's assume the following HTML code fragment:</p> - -<pre class="brush: html"><h1>I'm an example</h1> -<p>In this example, I'm a paragraph</p> -<p>And I'm another paragraph</p> -</pre> - -<p>In the following CSS rule, the element selector <code>p</code> applies the given styles simultaneously to all the <code>{{HTMLElement("p")}}</code> elements of our HTML document, preventing extensive rewriting. We are using the {{cssxref("font-family")}} property (which defines the font in which text appears) and the {{cssxref("font-size")}} (which defines text size).</p> - -<pre class="brush: css">p { - font-family: "Helvetica", Arial, sans-serif; - font-size : 12px; -}</pre> - -<p>The next CSS rule only applies to <code>{{HTMLElement("h1")}}</code> elements. We are using the {{cssxref("font-size")}} property to make our title twice the size of the body text, and the {{cssxref("font-weight")}} property to make the title bold.</p> - -<pre class="brush: css">h1 { - font-size : 24px; - font-weight: bold; -}</pre> - -<p>The following CSS rule applies the requisite styles to both <code>{{HTMLElement("h1")}}</code> and <code>{{HTMLElement("p")}}</code> elements, potentially removing even more duplication. (This use is called "group selector" or "chain selector". Notice the comma separating the selectors). Here we are using the {{cssxref("color")}} property to specify the same text color for both headings and paragraphs.</p> - -<pre class="brush: css">h1, p { - color: darkmagenta; -}</pre> - -<p>Here is the result of all this code:</p> - -<p>{{ EmbedLiveSample('The_element_selector') }}</p> - -<h3 id="The_id_selector">The id selector</h3> - -<p>The <code>id</code><strong> </strong>attribute of a particular HTML element uniquely identifies that element. Hence, an id selector is used only when a set of style rules applies to a single element.</p> - -<p>For our next example, let's assume the following HTML code fragment:</p> - -<pre class="brush: html"><p id="hello">Hello world!</p> </pre> - -<p>The following CSS rule applies only to that unique identified element. To make a selector into an id selector, you must put a hash character (#) in front of the id name. We are using three properties: {{cssxref("text-align")}} to center the text within the paragraph {{cssxref("border")}} to add a thin line around the paragraph, and {{cssxref("padding")}} to add some extra inner-margin between the text and the border.</p> - -<pre class="brush: css">#hello { - text-align: center; - border : 1px solid black; - padding : 8px; -}</pre> - -<p>And the result is the following:</p> - -<p>{{ EmbedLiveSample('The_id_selector') }}</p> - -<h3 id="The_class_selector">The class selector</h3> - -<p>Within HTML, the <code>class</code><strong> </strong>attribute lets you apply multiple identifiers to HTML elements. Those identifiers can be used with CSS to match groups of elements regardless of element name.</p> - -<p>For our next example, let's assume the following HTML code fragment:</p> - -<pre class="brush: html"><h1 class="hello">Hey there!</h1> -<p class="hello bye">Let's hang out together!</p> -<p class="bye">And walk over the mountain</p> -</pre> - -<p>Let's apply a CSS rule for all elements with the class <code>hello</code>. To make the selector into a class selector, put a period/full stop before the class name. We use the {{cssxref("font-style")}} property to italicize the text.</p> - -<pre class="brush: css">.hello { - font-style: italic; -}</pre> - -<p>And another one for all elements with the class <code>bye</code>. Here we are using the {{cssxref("text-decoration")}} property to draw a line through the text.</p> - -<pre class="brush: css">.bye { - text-decoration: line-through; -}</pre> - -<p>Here's what happened:</p> - -<p>{{ EmbedLiveSample('The_class_selector') }}</p> - -<h2 id="Next_step">Next step</h2> - -<p>So we've gone over the basics to get started with CSS. You can <a href="/en-US/docs/Learn/CSS/Basic_text_styling_in_CSS">learn more about text styling</a> or start exploring<a href="/en-US/docs/Web/CSS/Tutorials"> our CSS Tutorials</a> right away.</p> diff --git a/files/ru/conflicting/learn/css/building_blocks/styling_tables/index.html b/files/ru/conflicting/learn/css/building_blocks/styling_tables/index.html deleted file mode 100644 index 1203f44fc9..0000000000 --- a/files/ru/conflicting/learn/css/building_blocks/styling_tables/index.html +++ /dev/null @@ -1,526 +0,0 @@ ---- -title: Таблицы -slug: conflicting/Learn/CSS/Building_blocks/Styling_tables -tags: - - CSS - - Веб - - Руководство -translation_of: Learn/CSS/Building_blocks/Styling_tables -translation_of_original: Web/Guide/CSS/Getting_started/Tables -original_slug: Web/Guide/CSS/Getting_started/Таблицы ---- -<p>{{CSSTutorialTOC}}{{previousPage("/ru/docs/Web/Guide/CSS/Getting_Started/Layout", "Layout")}}</p> - -<p>Это 13-я секция руководства <a href="/en-US/docs/Web/Guide/CSS/Getting_Started" title="en-US/docs/Web/Guide/CSS/Getting Started">CSS Начало работы</a>; оно описывает более продвинутые селекторы и некоторые специфичные способы, которыми вы можете стилизовать таблицу. Вы создаёте новый пример документа, содержащий таблицу и таблицу стилей для неё.</p> - -<h2 class="clearLeft" id="Информация_Таблицы">Информация: Таблицы</h2> - -<p>Таблица располагает информацию в прямоугольной сетке. Некоторые таблицы могут быть сложными, и для сложных таблиц разные браузеры выдают разный результат.</p> - -<p>Когда вы проектируете ваш документ, используйте таблицы для выражения <a href="/ru/docs/Web/Guide/CSS/Getting_Started/Selectors#relselectors" title="en-US/docs/Web/Guide/CSS/Getting_Started/Selectors#relselectors">отношений</a> между кусочками информации. Поэтому это не важно, если различные браузеры отображают информацию слегка различными способами, потому что значение остаётся ясным.</p> - -<p>Не используйте таблицы необычным способом для создания особенной визуальной разметки. Техники на предыдущей странице руководства (<strong><a href="/ru/docs/Web/Guide/CSS/Getting_Started/Layout" title="en-US/docs/Web/Guide/CSS/Getting_Started/Layout">Разметка</a></strong>) предпочтительнее для этой цели.</p> - -<h3 id="Структура_таблицы">Структура таблицы</h3> - -<p>В таблице, каждый кусок информации отображается в ячейке (<em>cell)</em>.</p> - -<p>Ячейки, лежащие на одной линии, составляют строку (<em>row</em>).</p> - -<p>В некоторых таблицах, строки могут быть сгруппированы. Специальная группа строк в начале таблицы - заголовок (<em>header)</em>, в конце - нижний колонтитул (<em>footer)</em>. Главные строки таблицы - тело (<em>body)</em>, и они могут быть также сгруппированы.</p> - -<p>Ячейки в линии сверху вниз, составляют столбец (<em>column)</em>, но столбцы имеют ограниченное применение в таблицах CSS.</p> - -<div class="tuto_example"> -<div class="tuto_type">Пример</div> - -<p>Таблица <a href="/ru/docs/Web/Guide/CSS/Getting_Started/Selectors#relselectors" title="en-US/docs/Web/Guide/CSS/Getting_Started/Selectors#relselectors">Селекторов, основанных на отношении</a> в <a href="/ru/docs/Web/Guide/CSS/Getting_Started/Selectors" title="en-US/docs/Web/Guide/CSS/Getting_Started/Selectors">Селекторы</a> имеет десять ячеек в пяти строках.</p> - -<p>Первая строка - заголовок. Остальные четыре строки - тело таблицы. Нижнего колонтитула нет.</p> - -<p>У неё два столбца.</p> -</div> - -<p>Это руководство охватывает только простые таблицы, где результат довольно предсказуемый. В простой таблице, каждая ячейка занимает только одну ячейку в строке и в столбце. Вы можете использовать CSS для сложных таблиц, где ячейки занимают диапазон ячеек более чем одна в строке или столбце, но таблицы, подобно этим находятся вне пределов этого руководства.</p> - -<h3 id="Рамки">Рамки</h3> - -<p>Ячейки не имеют границ.</p> - -<p>У ячеек нет рамок и наполнений. По умолчанию, рамки разделены значениями таблицы, свойство {{cssxref("border-spacing")}}. Вы можете также полностью удалить пространство, установив свойство таблицы {{cssxref("border-collapse")}} в <code>collapse</code>.</p> - -<div class="tuto_example"> -<div class="tuto_type">Пример</div> - -<p>Здесь три таблицы.</p> - -<p>У таблицы слева интервал рамки 0.5 em. У таблицы по центру он составляет ноль. Таблица справа имеет сжатые границы:</p> - -<table style="background-color: white; border: 2px outset #36b; padding: 1em;"> - <tbody> - <tr> - <td style="padding-right: 2em;"> - <table style=""> - <tbody> - <tr> - <td style="border: 1px solid #c00; text-align: center;">Clubs</td> - <td style="border: 1px solid #c00; text-align: center;">Hearts</td> - </tr> - <tr> - <td style="border: 1px solid #c00; text-align: center;">Diamonds</td> - <td style="border: 1px solid #c00; text-align: center;">Spades</td> - </tr> - </tbody> - </table> - </td> - <td style="padding-right: 2em;"> - <table style=""> - <tbody> - <tr> - <td style="border: 1px solid #c00; text-align: center;">Clubs</td> - <td style="border: 1px solid #c00; text-align: center;">Hearts</td> - </tr> - <tr> - <td style="border: 1px solid #c00; text-align: center;">Diamonds</td> - <td style="border: 1px solid #c00; text-align: center;">Spades</td> - </tr> - </tbody> - </table> - </td> - <td style="padding-right: 6em;"> - <table style="border-collapse: collapse;"> - <tbody> - <tr> - <td style="border: 1px solid #c00; text-align: center;">Clubs</td> - <td style="border: 1px solid #c00; text-align: center;">Hearts</td> - </tr> - <tr> - <td style="border: 1px solid #c00; text-align: center;">Diamonds</td> - <td style="border: 1px solid #c00; text-align: center;">Spades</td> - </tr> - </tbody> - </table> - </td> - </tr> - </tbody> -</table> -</div> - -<h3 id="Заголовок">Заголовок</h3> - -<p>{{HTMLElement("caption")}} элемент - это метка, которая применяется ко всей таблице. По умолчанию, она отображается вверху таблицы.</p> - -<p>Чтобы переместить её вниз, установите её свойство {{cssxref("caption-side")}} в <code>bottom</code>. Это свойство наследуется, поэтому, в качестве альтернативы вы можете установить это свойство у таблицы или у другого элемента предка.</p> - -<p>Чтобы стилизовать заголовок текста, используйте любое из обычных свойств для текста.</p> - -<div class="tuto_example"> -<div class="tuto_type">Пример</div> - -<p>У этой таблицы заголовок внизу</p> - -<pre class="brush: css">#demo-table > caption { - caption-side: bottom; - font-style: italic; - text-align: right; -} -</pre> - -<table style="background-color: white; border: 2px outset #36b; padding: 1em 6em 1em 1em;"> - <tbody> - <tr> - <td> - <table> - <caption>Подходит</caption> - <tbody> - <tr> - <td> - <table style="border-collapse: collapse;"> - <tbody> - <tr> - <td style="border: 1px solid gray; text-align: center;">Клубы</td> - <td style="border: 1px solid gray; text-align: center;">Сердца</td> - </tr> - <tr> - <td style="border: 1px solid gray; text-align: center;">Алмазы</td> - <td style="border: 1px solid gray; text-align: center;">Лопаты</td> - </tr> - </tbody> - </table> - </td> - </tr> - </tbody> - </table> - </td> - </tr> - </tbody> -</table> -</div> - -<h3 id="Пустые_ячейки">Пустые ячейки</h3> - -<p>Вы можете отобразить пустые ячейки (т.е. их рамки и фон) указывав {{cssxref("empty-cells")}}: show; для элемента таблицы.</p> - -<p>Вы можете скрыть их, указав <code>empty-cells: hide;</code>. Тогда, если у элемента родителя ячейки есть фон, он будет отображён через пустую ячейку.</p> - -<div class="tuto_example"> -<div class="tuto_type">Пример</div> - -<p>Эти таблицы имеют бледно-зелёный фон. Их ячейки имеют бледно-серый фон и тёмно-серые рамки.</p> - -<p>В таблице слева пустая таблица отображается. В таблице справа, она скрыта:</p> - -<table style="background-color: white; border: 2px outset #36b; padding: 1em;"> - <tbody> - <tr> - <td style="padding-right: 2em;"> - <table style="background-color: #dfd;"> - <tbody> - <tr> - <td style="border: 1px solid #555; background-color: #eee;"> </td> - <td style="border: 1px solid #555; background-color: #eee; text-align: center;">Сердца</td> - </tr> - <tr> - <td style="border: 1px solid #555; background-color: #eee; text-align: center;">Алмазы</td> - <td style="border: 1px solid #555; background-color: #eee; text-align: center;">Лопаты</td> - </tr> - </tbody> - </table> - </td> - <td style="padding-right: 6em;"> - <table style="background-color: #dfd;"> - <tbody> - <tr> - <td> </td> - <td style="border: 1px solid #555; background-color: #eee; text-align: center;">Сердца</td> - </tr> - <tr> - <td style="border: 1px solid #555; background-color: #eee; text-align: center;">Алмазы</td> - <td style="border: 1px solid #555; background-color: #eee; text-align: center;">Лопаты</td> - </tr> - </tbody> - </table> - </td> - </tr> - </tbody> -</table> -</div> - -<div class="tuto_details"> -<div class="tuto_type">Детали</div> - -<p>Для подробной информации о таблицах, смотрите <a href="http://www.w3.org/TR/CSS21/tables.html">Таблицы</a> в Спецификации CSS.</p> - -<p>Информации там больше, чем в этом руководстве, но она не покрывает различия между браузерами, которые могут влиять на сложные таблицы.</p> -</div> - -<h2 id="Действие_Стилизация_таблицы">Действие: Стилизация таблицы</h2> - -<ol> - <li>Создайте новый HTML документ, <code>doc3.html</code>. Скопируйте и вставьте содержимое отсюда: - - <div style="height: 36em; overflow: auto;"> - <pre class="brush: html"><!DOCTYPE html> -<html> - <head> - <title>Документ примера 3</title> - <link rel="stylesheet" href="style3.css"> - </head> - <body> - <table id="demo-table"> - <caption>Океаны</caption> - <thead> - <tr> - <th></th> - <th>Площадь</th> - <th>Средняя глубина</th> - </tr> - <tr> - <th></th> - <th>млн. км<sup>2</sup></th> - <th>м</th> - </tr> - </thead> - <tbody> - <tr> - <th>Северный Ледовитый</th> - <td>13,000</td> - <td>1,200</td> - </tr> - <tr> - <th>Атлантический</th> - <td>87,000</td> - <td>3,900</td> - </tr> - <tr> - <th>Тихий</th> - <td>180,000</td> - <td>4,000</td> - </tr> - <tr> - <th>Индийский</th> - <td>75,000</td> - <td>3,900</td> - </tr> - <tr> - <th>Южный</th> - <td>20,000</td> - <td>4,500</td> - </tr> - </tbody> - <tfoot> - <tr> - <th>Общая</th> - <td>361,000</td> - <td></td> - </tr> - <tr> - <th>Средняя</th> - <td>72,000</td> - <td>3,800</td> - </tr> - </tfoot> - </table> - </body> -</html> -</pre> - </div> - </li> - <li>Создайте новую таблицу стилей, <code>style3.css</code>. Скопируйте и вставьте содержимое отсюда: - <pre class="brush: css">/*** Style for doc3.html (Tables) ***/ - -#demo-table { - font: 100% sans-serif; - background-color: #efe; - border-collapse: collapse; - empty-cells: show; - border: 1px solid #7a7; -} - -#demo-table > caption { - text-align: left; - font-weight: bold; - font-size: 200%; - border-bottom: .2em solid #4ca; - margin-bottom: .5em; -} - - -/* basic shared rules */ -#demo-table th, -#demo-table td { - text-align: right; - padding-right: .5em; -} - -#demo-table th { - font-weight: bold; - padding-left: .5em; -} - - -/* header */ -#demo-table > thead > tr:first-child > th { - text-align: center; - color: blue; -} - -#demo-table > thead > tr + tr > th { - font-style: italic; - color: gray; -} - -/* fix size of superscript */ -#demo-table sup { - font-size: 75%; -} - -/* body */ -#demo-table td { - background-color: #cef; - padding:.5em .5em .5em 3em; -} - -#demo-table tbody th:after { - content: ":"; -} - - -/* footer */ -#demo-table tfoot { - font-weight: bold; -} - -#demo-table tfoot th { - color: blue; -} - -#demo-table tfoot th:after { - content: ":"; -} - -#demo-table > tfoot td { - background-color: #cee; -} - -#demo-table > tfoot > tr:first-child td { - border-top: .2em solid #7a7; -} -</pre> - </li> - <li>Откройте документ в вашем браузере. Он должен выглядеть наподобие этого: - <table style="background-color: white; border: 2px outset #36b; padding: 1em 6em 1em 1em;"> - <tbody> - <tr> - <td> - <p style="font: bold 200% sans-serif; text-align: left; border-bottom: .2em solid #4ca; margin: 0px 0px .5em 0px;">Океаны</p> - - <div style="border: 1px solid #7a7; background-color: #efe;"> - <table style="background-color: #efe; border-collapse: collapse; font: 100% sens-serif; padding-right: .5em; text-align: right;"> - <tbody> - <tr style="text-align: center; color: blue;"> - <th> </th> - <th>Площадь</th> - <th style="padding-left: .5em; padding-right: .5em;">Средняя глубина</th> - </tr> - <tr style="font-style: italic; color: gray;"> - <th> </th> - <th style="padding-left: .5em; padding-right: .5em;"><sup>млн. км</sup><sup>2</sup></th> - <th style="padding-left: .5em; padding-right: .5em;">м</th> - </tr> - <tr> - <th style="padding-right: .5em;">Северный Ледовитый:</th> - <td style="background-color: #cef; padding: .5em .5em .5em 3em;">13,000</td> - <td style="background-color: #cef; padding: .5em .5em .5em 3em;">1,200</td> - </tr> - <tr> - <th style="padding-right: .5em;">Атлантический:</th> - <td style="background-color: #cef; padding: .5em .5em .5em 3em;">87,000</td> - <td style="background-color: #cef; padding: .5em .5em .5em 3em;">3,900</td> - </tr> - <tr> - <th style="padding-right: .5em;">Тихий:</th> - <td style="background-color: #cef; padding: .5em .5em .5em 3em;">180,000</td> - <td style="background-color: #cef; padding: .5em .5em .5em 3em;">4,000</td> - </tr> - <tr> - <th style="padding-right: .5em;">Индийский:</th> - <td style="background-color: #cef; padding: .5em .5em .5em 3em;">75,000</td> - <td style="background-color: #cef; padding: .5em .5em .5em 3em;">3,900</td> - </tr> - <tr> - <th style="padding-left: .5em; padding-right: .5em;">Южный:</th> - <td style="background-color: #cef; padding: .5em .5em .5em 3em;">20,000</td> - <td style="background-color: #cef; padding: .5em .5em .5em 3em;">4,500</td> - </tr> - <tr> - <th style="padding-right: .5em; color: blue;">Общая:</th> - <td style="background-color: #cee; padding: .5em .5em .5em 3em; border-top: .2em solid #7a7;">361,000</td> - <td style="background-color: #cee; padding: .5em .5em .5em 3em; border-top: .2em solid #7a7;"> </td> - </tr> - <tr> - <th style="padding-right: .5em; color: blue;">Средняя:</th> - <td style="background-color: #cee; padding: .5em .5em .5em 3em;">72,000</td> - <td style="background-color: #cee; padding: .5em .5em .5em 3em;">3,800</td> - </tr> - </tbody> - </table> - </div> - </td> - </tr> - </tbody> - </table> - </li> - <li>Сравните правила в таблице стилей с отображённой таблицей, чтобы гарантировать, что вы понимаете действие для каждого правила. Если вы найдёте правило, значение которого вы не понимаете, то закомментируйте его и обновите страницу, чтобы посмотреть, что изменилось. Вот несколько заметок об этой таблице: - <ul> - <li>Заголовок находится снаружи рамки таблицы.</li> - <li>Если у вас установлен минимальный размер точки в Опциях, это может повлиять на верхний индекс в km<sup>2</sup>.</li> - <li>Три пустые ячейки. Через две из них позволено показывать фон таблицы. У третьей есть фон и верхняя рамка.</li> - <li>Двоеточия добавлены с помощью таблицы стилей.</li> - </ul> - </li> -</ol> - -<div class="tuto_example"> -<div class="tuto_type">Вызов</div> - -<p>Измените таблицу стилей, чтобы она выглядела, как эта:</p> - -<table style="background-color: white; border: 2px outset #36b; padding: 1em 6em 1em 1em;"> - <tbody> - <tr> - <td> - <div style="border: 1px solid #7a7; background-color: #efe;"> - <table style="background-color: #efe; border-collapse: collapse; font: 100% sens-serif; padding-right: .5em; text-align: right;"> - <tbody> - <tr style="text-align: center; color: blue;"> - <th> - <table style="background-color: #efe; border-collapse: collapse; font: 100% sens-serif; padding-right: .5em; text-align: right;"> - <tbody> - <tr style="text-align: center; color: blue;"> - <th> </th> - <th>Площадь</th> - <th style="padding-left: .5em; padding-right: .5em;">Средняя глубина</th> - </tr> - <tr style="font-style: italic; color: gray;"> - <th> </th> - <th style="padding-left: .5em; padding-right: .5em;"><sup>млн. км</sup><sup>2</sup></th> - <th style="padding-left: .5em; padding-right: .5em;">м</th> - </tr> - <tr> - <th style="padding-right: .5em;">Северный Ледовитый:</th> - <td style="background-color: #cef; padding: .5em .5em .5em 3em;">13,000</td> - <td style="background-color: #cef; padding: .5em .5em .5em 3em;">1,200</td> - </tr> - <tr> - <th style="padding-right: .5em;">Атлантический:</th> - <td style="background-color: #cef; padding: .5em .5em .5em 3em;">87,000</td> - <td style="background-color: #cef; padding: .5em .5em .5em 3em;">3,900</td> - </tr> - <tr> - <th style="padding-right: .5em;">Тихий:</th> - <td style="background-color: #cef; padding: .5em .5em .5em 3em;">180,000</td> - <td style="background-color: #cef; padding: .5em .5em .5em 3em;">4,000</td> - </tr> - <tr> - <th style="padding-right: .5em;">Индийский:</th> - <td style="background-color: #cef; padding: .5em .5em .5em 3em;">75,000</td> - <td style="background-color: #cef; padding: .5em .5em .5em 3em;">3,900</td> - </tr> - <tr> - <th style="padding-left: .5em; padding-right: .5em;">Южный:</th> - <td style="background-color: #cef; padding: .5em .5em .5em 3em;">20,000</td> - <td style="background-color: #cef; padding: .5em .5em .5em 3em;">4,500</td> - </tr> - <tr> - <th style="padding-right: .5em; color: blue;">Общая:</th> - <td style="background-color: #cee; padding: .5em .5em .5em 3em; border-top: .2em solid #7a7;">361,000</td> - <td style="background-color: #cee; padding: .5em .5em .5em 3em; border-top: .2em solid #7a7;"> </td> - </tr> - <tr> - <th style="padding-right: .5em; color: blue;">Средняя:</th> - <td style="background-color: #cee; padding: .5em .5em .5em 3em;">72,000</td> - <td style="background-color: #cee; padding: .5em .5em .5em 3em;">3,800</td> - </tr> - </tbody> - </table> - </th> - </tr> - </tbody> - </table> - </div> - - <p style="font: italic 100% sans-serif; text-align: right; border-top: .4em solid #4ca; margin: 1em 0px 0px 0px;">Океаны</p> - </td> - </tr> - </tbody> -</table> -</div> - -<p><a href="/ru/docs/Web/Guide/CSS/Getting_Started/Challenge_solutions#Tables" title="en-US/docs/Web/Guide/CSS/Getting_Started/Challenge_solutions#Tables">Посмотреть решение для этой задачи.</a></p> - -<h2 id="Что_дальше">Что дальше?</h2> - -<p>{{nextPage("/ru/docs/Web/Guide/CSS/Getting_Started/Media", "Media")}}Это последняя страница в этом руководстве, которая фокусируется на CSS свойствах и значениях. Для полного обзора свойств и значений, смотрите <a href="http://www.w3.org/TR/CSS21/propidx.html">все свойства таблиц</a> в CSS Спецификациях.</p> - -<p>Следующая страница <a href="/ru/docs/Web/Guide/CSS/Getting_Started/Media" title="en-US/docs/Web/Guide/CSS/Getting_Started/Media">тоже рассматривает</a> цель и структуру CSS таблиц.</p> diff --git a/files/ru/conflicting/learn/css/building_blocks/values_and_units/index.html b/files/ru/conflicting/learn/css/building_blocks/values_and_units/index.html deleted file mode 100644 index 504ee90832..0000000000 --- a/files/ru/conflicting/learn/css/building_blocks/values_and_units/index.html +++ /dev/null @@ -1,346 +0,0 @@ ---- -title: Color -slug: conflicting/Learn/CSS/Building_blocks/Values_and_units -translation_of: Learn/CSS/Introduction_to_CSS/Values_and_units#Colors -translation_of_original: Web/Guide/CSS/Getting_started/Color -original_slug: Web/Guide/CSS/Getting_started/Color ---- -<p>{{ CSSTutorialTOC() }}</p> - -<p>{{previousPage("/en-US/docs/Web/Guide/CSS/Getting_Started/Text_styles", "Text styles")}}<span class="seoSummary">This is the 8th section of the <a href="/en-US/docs/Web/Guide/CSS/Getting_Started" title="en-US/docs/Web/Guide/CSS/Getting Started">CSS Getting Started</a> tutorial; it explains how you can specify color in CSS. In your sample stylesheet, you introduce background colors.</span></p> - -<h2 class="clearLeft" id="Information_Color">Information: Color</h2> - -<p>In this tutorial so far, you have used a limited number of named colors. CSS2 supports 17 named colors in all. Some of the names might not be what you expect:</p> - -<table style="border: 0px; margin-left: 2em; text-align: right;"> - <tbody> - <tr> - <td> </td> - <td>black</td> - <td style="width: 2em; height: 2em; background-color: black;"> </td> - <td>gray</td> - <td style="width: 2em; height: 2em; background-color: gray;"> </td> - <td>silver</td> - <td style="width: 2em; height: 2em; background-color: silver;"> </td> - <td>white</td> - <td style="width: 2em; height: 2em; background-color: white; border: 1px dotted gray;"> </td> - </tr> - <tr> - <td>primaries</td> - <td>red</td> - <td style="width: 2em; height: 2em; background-color: red;"> </td> - <td>lime</td> - <td style="width: 2em; height: 2em; background-color: lime;"> </td> - <td>blue</td> - <td style="width: 2em; height: 2em; background-color: blue;"> </td> - </tr> - <tr> - <td>secondaries</td> - <td>yellow</td> - <td style="width: 2em; height: 2em; background-color: yellow;"> </td> - <td>aqua</td> - <td style="width: 2em; height: 2em; background-color: aqua;"> </td> - <td>fuchsia</td> - <td style="width: 2em; height: 2em; background-color: fuchsia;"> </td> - </tr> - <tr> - <td> </td> - <td>maroon</td> - <td style="width: 2em; height: 2em; background-color: maroon;"> </td> - <td>orange</td> - <td style="width: 2em; height: 2em; background-color: orange;"> </td> - <td>olive</td> - <td style="width: 2em; height: 2em; background-color: olive;"> </td> - <td>purple</td> - <td style="width: 2em; height: 2em; background-color: purple;"> </td> - <td>green</td> - <td style="width: 2em; height: 2em; background-color: green;"> </td> - <td>navy</td> - <td style="width: 2em; height: 2em; background-color: navy;"> </td> - <td>teal</td> - <td style="width: 2em; height: 2em; background-color: teal;"> </td> - </tr> - </tbody> -</table> - -<p> </p> - -<div class="tuto_details"> -<div class="tuto_type">Details</div> - -<p>Your browser might support many more named colors, like:</p> - -<table style="background-color: inherit; border: 0px; margin: .5em 0px .5em 2em; text-align: right;"> - <tbody> - <tr> - <td>dodgerblue</td> - <td style="width: 2em; height: 2em; background-color: dodgerblue;"> </td> - <td>peachpuff</td> - <td style="width: 2em; height: 2em; background-color: peachpuff;"> </td> - <td>tan</td> - <td style="width: 2em; height: 2em; background-color: tan;"> </td> - <td>firebrick</td> - <td style="width: 2em; height: 2em; background-color: firebrick;"> </td> - <td>aquamarine</td> - <td style="width: 2em; height: 2em; background-color: aquamarine;"> </td> - </tr> - </tbody> -</table> - -<p>For details of this extended list, see: <a class="external" href="http://www.w3.org/TR/2003/CR-css3-color-20030514/#svg-color">SVG color keywords</a> in the CSS 3 Color Module. Beware of using color names that your reader's browsers might not support.</p> -</div> - -<p>For a larger palette, specify the red, green and blue components of the color you want by using a number sign (hash) and three <em>hexadecimal</em> digits in the range 0 – 9, a – f. The letters a – f represent the values 10 – 15:</p> - -<table style="border: 0px; margin-left: 2em;"> - <tbody> - <tr> - <td>black</td> - <td style="width: 2em; height: 2em; background-color: #000;"> </td> - <td><code>#000</code></td> - </tr> - <tr> - <td>pure red</td> - <td style="width: 2em; height: 2em; background-color: #f00;"> </td> - <td><code>#f00</code></td> - </tr> - <tr> - <td>pure green</td> - <td style="width: 2em; height: 2em; background-color: #0f0;"> </td> - <td><code>#0f0</code></td> - </tr> - <tr> - <td>pure blue</td> - <td style="width: 2em; height: 2em; background-color: #00f;"> </td> - <td><code>#00f</code></td> - </tr> - <tr> - <td>white</td> - <td style="width: 2em; height: 2em; background-color: #fff; border: 1px dotted gray;"> </td> - <td><code>#fff</code></td> - </tr> - </tbody> -</table> - -<p><br> - For the full palette, specify two hexadecimal digits for each component:</p> - -<table style="border: 0px; margin-left: 2em;"> - <tbody> - <tr> - <td>black</td> - <td style="width: 2em; height: 2em; background-color: #000;"> </td> - <td><code>#000000</code></td> - </tr> - <tr> - <td>pure red</td> - <td style="width: 2em; height: 2em; background-color: #f00;"> </td> - <td><code>#ff0000</code></td> - </tr> - <tr> - <td>pure green</td> - <td style="width: 2em; height: 2em; background-color: #0f0;"> </td> - <td><code>#00ff00</code></td> - </tr> - <tr> - <td>pure blue</td> - <td style="width: 2em; height: 2em; background-color: #00f;"> </td> - <td><code>#0000ff</code></td> - </tr> - <tr> - <td>white</td> - <td style="width: 2em; height: 2em; background-color: #fff; border: 1px dotted gray;"> </td> - <td><code>#ffffff</code></td> - </tr> - </tbody> -</table> - -<p>You can usually get these six-digit hexadecimal codes from your graphics program or some other tool.</p> - -<div class="tuto_example"> -<div class="tuto_type">Example</div> - -<p>With a little practice, you can adjust the three-digit colors manually for most purposes:</p> - -<table style="background-color: #fffff4; border: 0px; margin-left: 2em;"> - <tbody> - <tr> - <td>Start with pure red:</td> - <td style="width: 2em; height: 2em; background-color: #f00;"> </td> - <td><code>#f00</code></td> - </tr> - <tr> - <td>To make it paler, add some green and blue:</td> - <td style="width: 2em; height: 2em; background-color: #f77;"> </td> - <td><code>#f77</code></td> - </tr> - <tr> - <td>To make it more orange, add a little extra green:</td> - <td style="width: 2em; height: 2em; background-color: #fa7;"> </td> - <td><code>#fa7</code></td> - </tr> - <tr> - <td>To darken it, reduce all its components:</td> - <td style="width: 2em; height: 2em; background-color: #c74;"> </td> - <td><code>#c74</code></td> - </tr> - <tr> - <td>To reduce its saturation, make its components more equal:</td> - <td style="width: 2em; height: 2em; background-color: #c98;"> </td> - <td><code>#c98</code></td> - </tr> - <tr> - <td>If you make them exactly equal, you get gray:</td> - <td style="width: 2em; height: 2em; background-color: #ccc;"> </td> - <td><code>#ccc</code></td> - </tr> - </tbody> -</table> - -<p>For a pastel shade like pale blue:</p> - -<table style="background-color: #fffff4; border: 0px; margin-left: 2em;"> - <tbody> - <tr> - <td>Start with pure white:</td> - <td style="width: 2em; height: 2em; background-color: #fff; border: 1px dotted gray;"> </td> - <td><code>#fff</code></td> - </tr> - <tr> - <td>Reduce the other components a little:</td> - <td style="width: 2em; height: 2em; background-color: #eef; border: 1px dotted gray;"> </td> - <td><code>#eef</code></td> - </tr> - </tbody> -</table> -</div> - -<div class="tuto_details"> -<div class="tuto_type">More details</div> - -<p>You can also specify a color using decimal RGB values in the range 0 – 255, or percentages.</p> - -<p>For example, this is maroon (dark red):</p> - -<pre class="brush:css">rgb(128, 0, 0) -</pre> - -<p>For full details of how to specify colors, see: <a class="external" href="http://www.w3.org/TR/CSS21/syndata.html#color-units">Colors</a> in the CSS Specification.</p> - -<p>For information on matching system colors like Menu and ThreeDFace, see: <a class="external" href="http://www.w3.org/TR/CSS21/ui.html#system-colors">CSS2 System Colors</a> in the CSS Specification.</p> -</div> - -<h3 id="Color_properties">Color properties</h3> - -<p>You have already used the {{ cssxref("color") }} property on text.</p> - -<p>You can also use the {{ cssxref("background-color") }} property to change elements' backgrounds.</p> - -<p>Backgrounds can be set to <code>transparent</code> to explicitly remove any color, revealing the parent element's background.</p> - -<div class="tuto_example"> -<div class="tuto_type">Example</div> - -<p>The <strong>Example</strong> boxes in this tutorial use this pale yellow background:</p> - -<pre class="brush:css">background-color: #fffff4; -</pre> - -<p>The <strong>More details</strong> boxes use this pale gray:</p> - -<pre class="brush:css">background-color: #f4f4f4; -</pre> -</div> - -<p> </p> - -<h2 id="Action_Using_color_codes">Action: Using color codes</h2> - -<h2 id="Color_page" name="Color_page">Color page</h2> - -<ol> - <li>Edit your CSS file.</li> - <li>Make the change shown down here, to give the initial letters a pale blue background. (The layout and comments in your file probably differ from the file shown here. Keep the layout and comments the way you prefer them.)</li> - <li> - <h3 id="HTML_Content">HTML Content</h3> - - <pre class="brush: html"><p id = "first"> <strong>C</strong>ascading <strong class="spinach">S</strong>tyle <strong class="spinach">S</strong>heets</p> -<p> <strong>C</strong>ascading <strong>S</strong>tyle <strong>S</strong>heets</p> -</pre> - - <h3 id="CSS_Content">CSS Content</h3> - - <pre class="brush: css">/*** CSS Tutorial: Color page ***/ - -/* page font */ -body { - font: 16px "Comic Sans MS", cursive; -} - -/* paragraphs */ -p { - color: blue; -} -#first { - font-style: italic; -} - -/* initial letters */ -strong { - background-color: #ddf; - color: red; - font: 200% serif; -} - -.spinach { - color: green; - background-color: #ddf; -} - -</pre> - </li> - <li>Save the file and refresh your browser to see the result.</li> - <li>The result should be like this:</li> -</ol> - -<p>{{ EmbedLiveSample('Color_page', '', '', '', 'Web/Guide/CSS/Getting_started/Color') }}</p> - -<div class="tuto_example"> -<div class="tuto_type">Challenge</div> - -<p>In your CSS file, change all the color names to 3-digit color codes without affecting the result.</p> - -<p>(This cannot be done exactly, but you can get close. To do it exactly you need 6-digit codes, and you need to look up the CSS Specification or use a graphics tool to match the colors.)</p> - -<div class="tuto_details" id="tutochallenge"> -<div class="tuto_type">Possible solution</div> - -<p>The following values are reasonable approximations of the named colors:</p> - -<pre class="brush: css">strong { - color: #f00; /* red */ - background-color: #ddf; /* pale blue */ - font: 200% serif; -} - -.carrot { - color: #fa0; /* orange */ -} - -.spinach { - color: #080; /* dark green */ -} - -p { - color: #00f; /* blue */ -} -</pre> - -<p> </p> -<a class="hideAnswer" href="#challenge">Hide solution</a></div> -<a href="#tutochallenge" title="Display a possible solution for the challenge">See a solution for the challenge.</a></div> - -<h2 id="What_next">What next?</h2> - -<p>{{nextPage("/en-US/docs/Web/Guide/CSS/Getting_Started/Content", "Content")}}Your sample document and your sample stylesheet strictly separate content from style. The <a href="/en-US/docs/Web/Guide/CSS/Getting_Started/Content" title="/en-US/docs/Web/Guide/CSS/Getting_Started/Content">next section</a> explains how you can make exceptions to this strict separation.</p> diff --git a/files/ru/conflicting/learn/css/first_steps/how_css_is_structured/index.html b/files/ru/conflicting/learn/css/first_steps/how_css_is_structured/index.html deleted file mode 100644 index cb90e2d8c7..0000000000 --- a/files/ru/conflicting/learn/css/first_steps/how_css_is_structured/index.html +++ /dev/null @@ -1,167 +0,0 @@ ---- -title: Чистый CSS код -slug: conflicting/Learn/CSS/First_steps/How_CSS_is_structured -translation_of: Learn/CSS/Introduction_to_CSS/Syntax#Beyond_syntax_make_CSS_readable -translation_of_original: Web/Guide/CSS/Getting_started/Readable_CSS -original_slug: Web/Guide/CSS/Getting_started/Readable_CSS ---- -<p>{{ CSSTutorialTOC() }}</p> - -<p>{{ previousPage("/en-US/docs/Web/Guide/CSS/Getting_Started/Selectors", "Selectors")}}<span class="seoSummary">Это 6-я статья руководства <a href="/en-US/docs/Web/Guide/CSS/Getting_Started" title="en-US/docs/Web/Guide/CSS/Getting Started">CSS для начинающих</a>; здесь </span>обсуждается стиль и грамматика самого языка CSS. Вы можете изменить пусть к вашему файлу CSS на более удобный для чтения.</p> - -<h2 class="clearLeft" id="Информация_Чистый_код_CSS">Информация: Чистый код CSS</h2> - -<p>Вы можете добавлять пустое пространство и комментарии к вашим стилям, чтобы сделать их более читабельными. Также вы можете группировать селекторы вместе, в случае если те же самые правила стиля применяются к разным элементам.</p> - -<h3 id="Пустое_пространство">Пустое пространство</h3> - -<p>Пустое пространство означает фактические пробелы, табуляцию, а также новые строки. Вы можете использовать их, чтобы сделать ваш код более читабельным.</p> - -<p>В макете страницы, данное пространство — это та часть, которая остаётся без опознавательных знаков: отступы от других элементов (margin) и пространство между колонками и строками.</p> - -<p>Ваш пример файла CSS в настоящее время имеет правила в одной строке, и почти минимум пробелов. В комплексе стилей эта схема будет усложнять читаемость, а значит в неё будет трудно вносить изменения.</p> - -<p>Стиль написания который вы выбираете, как правило, зависит от личных предпочтений, но если ваши css являются частью общих проектов, могут возникнуть трудности с понимаем вашего написания кода.</p> - -<div class="tuto_example"> -<div class="tuto_type">Примеры</div> - -<p>Некоторые люди пытаются написать код максимально компактно и пишут код в одну строку, даже если он достаточно долгий:</p> - -<pre class="brush: css">.carrot {color: orange; text-decoration: underline; font-style: italic;} -</pre> - -<p>Некоторые люди предпочитают писать каждое свойство-значение в отдельной строке:</p> - -<pre class="brush: css">.carrot -{ -color: orange; -text-decoration: underline; -font-style: italic; -} -</pre> - -<p>Некоторые используют отступы — 2 или 4 пробела или табы:</p> - -<pre class="brush: css">.carrot { - color: orange; - text-decoration: underline; - font-style: italic; -} -</pre> - -<p>Некоторые люди все выстраивают вертикально (но такое расположение не лучший вариант для поддержки):</p> - -<pre class="brush: css">.carrot - { - color : orange; - text-decoration : underline; - font-style : italic; - } -</pre> - -<p>Некоторые люди используют смешанный пробелы для повышения читаемости.</p> - -<pre class="brush: css">.vegetable { color: green; min-height: 5px; min-width: 5px } -.vegetable.carrot { color: orange; height: 90px; width: 10px } -.vegetable.spinach { color: darkgreen; height: 30px; width: 30px } -</pre> -</div> - -<p>Некоторые используют вкладки для компоновки элементов, а другие только пробелы.</p> - -<h3 id="Комментарии">Комментарии</h3> - -<p>Комментарии в CSS имеют следующий вид: <code>/*</code> комментарий <code>*/</code>.</p> - -<p>Вы можете использовать комментарии, чтобы сделать фактические комментарии в css, а также чтобы закомментировать временно часть кода с целью тестирования.</p> - -<p>Часть стилей, которая будет закомментирована, не будет отображаться браузером. Будьте осторожны при комментировании кода, поскольку важно сохранить правильный синтаксис остального кода.</p> - -<div class="tuto_example"> -<div class="tuto_type">Пример</div> - -<pre class="brush: css">/* стиль для начальной буквой C в первом пункте*/ -.carrot { - color: orange; - text-decoration: underline; - font-style: italic; - } -</pre> -</div> - -<h3 id="Группировка_селекторов">Группировка селекторов</h3> - -<p>Когда многие элементы имеют один и тот же стиль, вы можете указывать группу селекторов, разделяя их запятыми. Декларация применится для всех выбранных элементов.</p> - -<p>В другом месте в таблице стилей можно указать те же селекторы уже индивидуально, чтобы применить индивидуальные правила стилей для них.</p> - -<div class="tuto_example"> -<div class="tuto_type">Пример</div> - -<p>Это правило делает элементы {{HTMLElement ("h1")}}, {{HTMLElement ("h2")}}, и {{HTMLElement ("h3")}} одного цвета.</p> - -<p>Удобно определить цвет только в одном месте, в случае, если возможны изменения.</p> - -<pre class="brush: css">/* цвет для заголовков */ -h1, h2, h3 {color: navy;} -</pre> -</div> - -<h2 id="Действуем_добавление_комментариев_и_улучшения_формата">Действуем: добавление комментариев и улучшения формата</h2> - -<ol> - <li>Редактируя ваш CSS-файл убедитесь, что он применяет эти правила (в любом порядке): - <pre class="brush: css">strong {color: red;} -.carrot {color: orange;} -.spinach {color: green;} -#first {font-style: italic;} -p {color: blue;} -</pre> - </li> - <li>Сделайте его более читабельным, перестраивая его таким образом, какой будете считать более логичным и применяя пробелы и комментарии на своё усмотрение.</li> - <li>Сохраните файл и обновите экран браузера, чтобы убедиться, что ваши изменения не повлияли на роботу стилей: - <table style="border: 2px outset #36b; padding: 1em;"> - <tbody> - <tr> - <td style="font-style: italic; color: blue;"><strong style="color: orange;">C</strong>ascading <strong style="color: green;">S</strong>tyle <strong style="color: green;">S</strong>heets</td> - </tr> - <tr> - <td style="color: blue;"><strong style="color: red;">C</strong>ascading <strong style="color: red;">S</strong>tyle <strong style="color: red;">S</strong>heets</td> - </tr> - </tbody> - </table> - </li> -</ol> - -<div class="tuto_details"> -<div class="tuto_type">Задание</div> - -<p>Закомментируйте часть стиля не меняя остальное, чтобы сделать первую букву вашего документа красной:</p> - -<table style="background-color: white; border: 2px outset #36b; padding: 1em;"> - <tbody> - <tr> - <td style="font-style: italic; color: blue;"><strong style="color: red;">C</strong>ascading <strong style="color: green;">S</strong>tyle <strong style="color: green;">S</strong>heets</td> - </tr> - <tr> - <td style="color: blue;"><strong style="color: red;">C</strong>ascading <strong style="color: red;">S</strong>tyle <strong style="color: red;">S</strong>heets</td> - </tr> - </tbody> -</table> - -<p>(Существует более чем один способ сделать это).</p> - -<div class="tuto_details" id="tutochallenge"> -<div class="tuto_type">Possible solution</div> -One way to do this is to put comment delimiters around the rule for <code>.carrot</code>: - -<pre class="brush: css">/*.carrot { - color: orange; -}*/</pre> -<a class="hideAnswer" href="#challenge">Hide solution</a></div> -<a href="#tutochallenge" title="Display a possible solution for the challenge">Посмотреть решение задания.</a></div> - -<h2 id="Что_дальше">Что дальше?</h2> - -<p>{{ nextPage("/en-US/docs/Web/Guide/CSS/Getting_Started/Text_styles", "Text styles") }}Ваш образец таблицы стилей использовал курсивный текст и подчёркнутый текст. На следующей странице описаны несколько способов, чтобы <a href="/en-US/docs/Web/Guide/CSS/Getting_Started/Text_styles" title="/en-US/docs/Web/Guide/CSS/Getting_Started/Text_styles">указать внешний вид текста</a> в вашем документе<strong>.</strong></p> diff --git a/files/ru/conflicting/learn/css/first_steps/how_css_works/index.html b/files/ru/conflicting/learn/css/first_steps/how_css_works/index.html deleted file mode 100644 index 7a2fc09c29..0000000000 --- a/files/ru/conflicting/learn/css/first_steps/how_css_works/index.html +++ /dev/null @@ -1,123 +0,0 @@ ---- -title: Как работает CSS -slug: conflicting/Learn/CSS/First_steps/How_CSS_works -translation_of: Learn/CSS/First_steps/How_CSS_works -translation_of_original: Web/Guide/CSS/Getting_started/How_CSS_works -original_slug: Web/Guide/CSS/Getting_started/How_CSS_works ---- -<p>{{ CSSTutorialTOC() }}</p> - -<p>{{ previousPage("/ru/docs/Web/Guide/CSS/Getting_Started/Why_use_CSS", "Зачем нужен CSS?") }} Это третья статья руководства по <span class="seoSummary"><a href="/ru/docs/Web/Guide/CSS/Getting_started" title="ru/docs/Web/Guide/CSS/Getting_started">CSS для начинающих</a>, объясняет, как работает CSS в вашем браузере, а также назначение Объектной Модели Документа (</span>Document Object Model или DOM). Вы также узнаете, как сделать анализ документа.</p> - -<h2 class="clearLeft" id="Информация_Как_работает_CSS">Информация: Как работает CSS</h2> - -<p>Когда браузер отображает документ, он должен совместить содержимое документа с информацией о стилях для него. Браузер обрабатывает документ в два этапа:</p> - -<ol> - <li>Браузер преобразует язык разметки и CSS в DOM (Document Object Model). DOM представляет собой документ в памяти компьютера. Он сочетает в себе содержание документа с его стилем.</li> - <li>Браузер отображает содержимое DOM.</li> -</ol> - -<p>Язык разметки использует <em>элементы</em> для определения структуры документа. Элемент обозначается с использованием тегов, которые представляют собой строки, начинающиеся с символа '<' и заканчивающиеся '>'. Большинство элементов имеет парные теги: открывающий тег и закрывающий тег. Для открывающего тега, поместите имя элемента между '<' и '>'. Для закрывающего тега, поместите '<code>/</code>' между '<code><</code>', и именем элемента.</p> - -<p>В зависимости от языка разметки, некоторые элементы имеют только начальный тег, или тег, где '/' располагается после имени элемента. Элемент так же может быть контейнером, включающим в себя другие элементы. В этом случае они располагаются между открывающим и закрывающим тегами. Не забывайте всегда закрывать теги внутри контейнера.</p> - -<p>DOM имеет древовидную структуру. Каждый элемент, атрибут и запуск текста на языке разметки становится <em>узлом</em> в древовидной структуре. Узлы определяются их взаимодействием с другими узлами DOM. Некоторые элементы становятся родительскими по отношению к другим, дочерним узлам (или узлам-потомкам). В свою очередь, дочерние узлы имеют "братьев" (siblings).</p> - -<p>Понимание DOM поможет вам при разработке, отладке и поддержке CSS, поскольку DOM это место, где встречаются CSS и содержимое документа.</p> - -<div class="tuto_example"> -<div class="tuto_type">Пример</div> - -<div class="tuto_type"> </div> -В данном примере, тег <code><p></code> и его закрывающий тег <code></p></code> создают контейнер: - -<pre class="brush:html"><p> - <strong>C</strong>ascading - <strong>S</strong>tyle - <strong>S</strong>heets -</p> -</pre> - -<p><strong>Живой пример</strong></p> - -<p>{{ EmbedLiveSample('Информация_Как_работает_CSS', '', '', '', 'Web/Guide/CSS/Getting_started/How_CSS_works') }}</p> - -<p>В DOM соответствующий узел P является родительским. Его дочерние узлы - это теги <small>STRONG</small> и узлы текста. Теги <small>STRONG, </small> в свою очередь, являются родительскими по отношению к текстовым узлам, которые являются их дочерними узлами:</p> - -<pre><span style="color: black;">P</span> -├─<span style="color: black;">STRONG</span> -│ └─"<span style="color: black;">C</span>" -├─"<span style="color: black;">ascading</span>" -├─<span style="color: black;">STRONG</span> -│ └─"<span style="color: black;">S</span>" -├─"<span style="color: black;">tyle</span>" -├─<span style="color: black;">STRONG</span> -│ └─"<span style="color: black;">S</span>" -└─"<span style="color: black;">heets</span>"</pre> -</div> - -<h2 id="К_действию_Анализ_DOM">К действию: Анализ DOM</h2> - -<h3 id="Использование_DOM_Inspector">Использование DOM Inspector</h3> - -<p>Для анализа DOM, вам потребуется специальная программа. Вы можете использовать расширение <a href="/en/DOM_Inspector" title="en/DOM_Inspector">DOM Inspector</a> (DOMi) от Mozilla для анализа DOM. Вам просто нужно установить это расширение в браузере (подробнее см. ниже).</p> - -<ol> - <li>Используйте браузер Mozilla, чтобы открыть свой HTML-документ.</li> - <li>Из строки меню браузера выберите <strong>Инструменты > DOM инспектор</strong>, или <strong>Инструменты > Веб-разработка > Инспектор</strong>. - <div class="tuto_details"> - <div class="tuto_type">Подробнее</div> - - <p>Если в вашем браузере Mozilla не установлен DOMi, вы можете <a class="link-https" href="https://addons.mozilla.org/ru/firefox/addon/6622/" title="https://addons.mozilla.org/ru/firefox/addon/6622/">установить его с сайта дополнений</a> и перезапустить браузер. Затем возвращайтесь к этому руководству.</p> - - <p>Если вы не хотите устанавливать DOMi (или вы используете браузер не от Mozilla), то можете воспользоваться Рентген-очками, как описано в секции ниже. Или вы можете пропустить эту секцию и перейти к прямо к следующей странице. Если вы пропустите данный раздел, это не помешает вам в дальнейшем освоении руководства.</p> - </div> - </li> - <li>В DOMi разверните узлы вашего документа, нажав на их стрелки. - <p><strong>Замечание: </strong> Пустые места в вашем HTML файле DOMi может отображать как пустые текстовые узлы, которые можно игнорировать.</p> - - <p>Часть результата может выглядеть следующим образом, в зависимости от того, какие узлы вы развернули:</p> - - <pre>│ ▼╴<span style="color: black;">P</span> -│ │ │ ▼╴<span style="color: black;">STRONG</span> -│ │ └<span style="color: darkblue;">#text</span> -│ ├╴<span style="color: darkblue;">#text</span> -│ ►╴<span style="color: black;">STRONG</span> -│ │</pre> - - <p>При выборе любого узла, вы можете использовать правую панель DOMi's для поиска информации об узле. Например, когда вы выбираете текстовый узел, DOMi показывает вам текст в соответствующей панели.</p> - - <p>При выборе узла элемента, DOMi анализирует его и предоставляет огромное количество информации, которая содержится в правой панели. Информация о стилях - лишь часть информации, которую там можно просмотреть.</p> - </li> -</ol> - -<div class="tuto_example"> -<div class="tuto_type">Задача</div> - -<p>В DOMi, кликните на узле <small>STRONG</small>.</p> - -<p>Используйте правую панель DOMi, чтобы выяснить, где цвет для этого узла установлен на красный, и где его внешний вид сделан толще, чем обычный текст.</p> - -<div class="tuto_details" id="tutochallenge"> -<div class="tuto_type">Possible solution</div> - -<p>In the menu above the right-hand pane, choose <strong>CSS Rules</strong>. You see two items listed, one that references an internal resource and one that references your stylesheet file. The internal resource defines the <strong>font-weight</strong> property as <code>bolder</code>; your stylesheet defines the <strong>color</strong> property as <code>red</code>.</p> -<a class="hideAnswer" href="#challenge">Hide solution</a></div> -<a href="#tutochallenge" title="Display a possible solution for the challenge">Посмотреть решение задачи.</a></div> - -<h3 id="Использование_Рентген-очков">Использование Рентген-очков</h3> - -<p><a class="link-https" href="https://goggles.webmaker.org/" title="https://secure.toolness.com/webxray/">Рентген-очки </a>показывают меньше информации, чем DOM Инспектор, но проще в установке и использовании.</p> - -<ol> - <li>Перейдите на домашнюю страницу <a class="link-https" href="https://goggles.webmaker.org/" title="https://secure.toolness.com/webxray/">X-Ray Goggles</a>.</li> - <li>Перетащите ссылку X-Ray Googles с этой страницы на панель закладок.</li> - <li>Откройте HTML-документ.</li> - <li>Запустите Рентген-очки, кликнув по появившейся закладке.</li> - <li>Передвигайте курсор мыши по документу для просмотра элементов в документе.</li> -</ol> - -<h2 id="Что_дальше">Что дальше?</h2> - -<p>{{ nextPage("/ru/docs/Web/Guide/CSS/Getting_Started/Cascading_and_inheritance", "Каскадность и наследование") }}Если вы решили задачу, то увидели, что информация о стиле из более чем одного места взаимодействует для создания окончательного стиля для элемента. На <a href="/ru/docs/Web/Guide/CSS/Getting_Started/Cascading_and_inheritance" title="/ru/docs/Web/Guide/CSS/Getting_Started/Cascading_and_inheritance">следующей странице</a> объясняется больше об этих взаимодействиях.</p> diff --git a/files/ru/conflicting/learn/css/first_steps/how_css_works_64ba4331a7a5f4319c6e06b06ccdd521/index.html b/files/ru/conflicting/learn/css/first_steps/how_css_works_64ba4331a7a5f4319c6e06b06ccdd521/index.html deleted file mode 100644 index 218c8bc90d..0000000000 --- a/files/ru/conflicting/learn/css/first_steps/how_css_works_64ba4331a7a5f4319c6e06b06ccdd521/index.html +++ /dev/null @@ -1,112 +0,0 @@ ---- -title: Зачем нужен CSS? -slug: >- - conflicting/Learn/CSS/First_steps/How_CSS_works_64ba4331a7a5f4319c6e06b06ccdd521 -tags: - - Beginner - - CSS - - CSS:Getting_Started - - Example - - Guide - - Web - - Веб - - Новичку - - Руководство -translation_of: Learn/CSS/First_steps/How_CSS_works -translation_of_original: Web/Guide/CSS/Getting_started/Why_use_CSS -original_slug: Web/Guide/CSS/Getting_started/Why_use_CSS ---- -<p><span style="line-height: 1.5;">{{ CSSTutorialTOC() }}</span></p> - -<p>{{ previousPage("/ru/docs/Web/Guide/CSS/Getting_Started/What_is_CSS", "Что такое CSS?") }}<span class="seoSummary">Это вторая статья руководства по <a href="/ru/docs/Web/Guide/CSS/Getting_started" title="ru/docs/Web/Guide/CSS/Getting_started">CSS для начинающих</a>, объясняющая взаимосвязь между CSS и документами. В ней вы узнаете, как добавить CSS стили для документа, который вы создали в процессе изучения первой статьи.</span></p> - -<h2 class="clearLeft" id="Информация_Зачем_нужен_CSS">Информация: Зачем нужен CSS?</h2> - -<p>CSS используется для определения стилей ваших документов, в том числе дизайна, вёрстки и вариаций макета для различных устройств и размеров экрана. Вы можете разместить стили CSS внутри тега <HEAD> документа с встроенной таблицей стилей, или приложить отдельный CSS-файл, который будет определять ваши стили извне. Чтобы привязать внешнюю таблицу стилей к документу, просто добавьте ссылку на таблицу стилей в заголовке <HEAD> документа.</p> - -<p>У внешней таблицы стилей есть множество преимуществ. Сохранение стилей отдельно от содержания HTML:</p> - -<ul> - <li>Помогает избежать дублирования</li> - <li>Облегчает обслуживание</li> - <li>Позволяет делать изменения для всего сайта в одном месте</li> -</ul> - -<div class="tuto_example"> -<div class="tuto_type">Пример</div> - -<p>Используя CSS, вы храните информацию о стилях в общих файлах, которые доступны всем страницам. Например, когда документы ссылаются на те таблицы стилей, которые определяют цвет заголовков h2, вы можете применить стиль для тегов заголовков h2 на глобальном уровне путём изменения одного атрибута CSS.</p> - -<p>Когда пользователь открывает веб-страницу, браузер загружает информацию стиля вместе с содержанием страницы.</p> - -<p>Когда пользователь открывает веб-страницу в режиме печати, вы можете предоставить различную информацию о стилях которая сделает страницу более лёгкой для чтения.</p> -</div> - -<p>Как заставить HTML и CSS работать вместе? В целом, HTML используется для описания содержимого документа, а не его стиля. CSS же используется, чтобы указать стиль документа, но не содержание. Позже в руководстве вы увидите некоторые исключения из этого правила.</p> - -<div class="tuto_details"> -<div class="tuto_type">Подробнее</div> - -<p>Язык разметки, типа HTML также обеспечивает некоторые способы задания стилей.</p> - -<p>Например, в HTML вы можете использовать тег <B>, чтобы сделать текст жирным, либо указать цвет фона страницы в теге <BODY>.</p> - -<p>При использовании CSS, задание стилей средствами языка разметки обычно не используется, поскольку вся информация о стилях легко доступна для чтения и изменения в CSS-файле.</p> -</div> - -<h2 id="Действие_Создание_таблицы_стилей">Действие: Создание таблицы стилей</h2> - -<ol> - <li>Создайте новый текстовый файл в том же каталоге, что и <code>doc1.html</code>, созданный в первой статье.</li> - <li>Сохраните его как <code>style1.css</code>. Этот файл будет вашей таблицей стилей.</li> - <li>Скопируйте и вставьте в CSS-файл приведённую ниже строку, после чего сохраните файл: - <pre class="brush: css">strong {color: red;} -</pre> - </li> -</ol> - -<h3 id="Привязка_таблицы_стилей_к_документу">Привязка таблицы стилей к документу</h3> - -<ol> - <li>Для привязки вашего документа к таблице стилей, необходимо внести в HTML-файл некоторые исправления. Добавьте строки, приведённые ниже: - <pre class="brush: html; highlight:[6];"><!DOCTYPE html> -<html> - <head> - <meta charset="UTF-8"> - <title>Sample document</title> - <link rel="stylesheet" href="style1.css"> - </head> - <body> - <p> - <strong>C</strong>ascading - <strong>S</strong>tyle - <strong>S</strong>heets - </p> - </body> -</html> -</pre> - </li> - <li>Сохраните файл, и откройте его в браузере. Таблица стилей сделает заглавные буквы красными:</li> -</ol> - -<p>{{ EmbedLiveSample('Действие_Создание_таблицы_стилей', '', '', '', 'Web/Guide/CSS/Getting_started/Why_use_CSS') }}</p> - -<p>{{ LiveSampleLink('Action.3A_Creating_a_stylesheet', 'Просмотреть демо') }}</p> - -<div class="tuto_example" id="challenge"> -<div class="tuto_type">Задание</div> - -<p>В дополнение к красному, в CSS имеются и другие названия цветов.</p> - -<p>Не открывая подсказку, подберите ещё пять цветовых имён, которые будут работать в CSS.</p> - -<div class="tuto_details" id="tutochallenge"> -<div class="tuto_type">Возможное решение</div> - -<p>CSS поддерживает общие названия цветов, например <code>orange</code>, <code>yellow</code>, <code>blue</code>, <code>green</code>, или <code>black</code>. Он также поддерживает некоторые более экзотические названия типа <code>chartreuse</code>, <code>fuschia</code>, или <code>burlywood</code>. Посмотрите <a href="/ru/docs/CSS/color_value" title="Цвет в CSS">значения цвета CSS</a>, чтобы ознакомится с полным списком поддерживаемых цветов, а так же методов их задания.</p> -<a class="hideAnswer" href="#challenge">Скрыть решение</a></div> -<a href="#tutochallenge" title="Display a possible solution for the challenge">Посмотреть решение задания.</a></div> - -<h2 id="Что_дальше">Что дальше?</h2> - -<p>{{nextPage("/ru/docs/Web/Guide/CSS/Getting_started/How_CSS_works", "Как работает CSS.")}} Теперь, когда у вас есть образец документа, связанный с отдельной таблицей стилей, вы готовы <a href="/ru/docs/Web/Guide/CSS/Getting_started/How_CSS_works" title="/ru/docs/Web/Guide/CSS/Getting_started/How_CSS_works">узнать больше</a> о том, как ваш браузер объединяет их при отображении документа.</p> diff --git a/files/ru/conflicting/learn/css/first_steps/how_css_works_b66915031fb62b5fee1201086144e209/index.html b/files/ru/conflicting/learn/css/first_steps/how_css_works_b66915031fb62b5fee1201086144e209/index.html deleted file mode 100644 index 39d6ffe3a1..0000000000 --- a/files/ru/conflicting/learn/css/first_steps/how_css_works_b66915031fb62b5fee1201086144e209/index.html +++ /dev/null @@ -1,122 +0,0 @@ ---- -title: Что такое CSS? -slug: >- - conflicting/Learn/CSS/First_steps/How_CSS_works_b66915031fb62b5fee1201086144e209 -tags: - - Beginner - - CSS - - CSS:Getting_Started - - Example - - Guide - - Веб - - Новичку -translation_of: Learn/CSS/First_steps/How_CSS_works -translation_of_original: Web/Guide/CSS/Getting_started/What_is_CSS -original_slug: Web/Guide/CSS/Getting_started/What_is_CSS ---- -<div>{{ CSSTutorialTOC() }}</div> - -<p>{{previousPage("/ru/docs/Web/Guide/CSS/Getting_Started", "CSS для начинающих")}} <span class="seoSummary">Эта первая статья руководства по <a href="/ru/docs/Web/Guide/CSS/Getting_Started" title="ru/CSS/Getting Started">CSS для начинающих</a> кратко объясняет, что такое Cascading Style Sheets (CSS). С её помощью вы сможете создать простой документ, который будете использовать в дальнейших разделах.</span></p> - -<h2 class="clearLeft" id="Информация_Что_такое_CSS">Информация: Что такое CSS</h2> - -<p>Каскадные таблицы стилей (Cascading Style Sheets = <dfn><abbr title="Cascading Style Sheets">CSS</abbr></dfn>) — это язык, который отвечает за визуальное представление документов пользователю.</p> - -<p>Под <em>документом</em> мы будем понимать набор информации о структуре страницы, описываемый <em>языком разметки</em>.</p> - -<p>А <em>представление</em> документа пользователю, в свою очередь, означает его преобразование в удобную для восприятия форму. Браузеры, такие как Firefox, Chrome или Internet Explorer, были созданы для визуального отображения документов, например, на экране компьютера, проекторе или вывода через принтер.</p> - -<div class="tuto_example"> -<p><strong>Примеры</strong></p> - -<ul> - <li>Страница сайта, которую вы сейчас читаете — это документ. Структура информации, которую вы видите на странице, обычно описывается при помощи языка разметки HTML (<span lang="en">HyperText Markup Language</span> — Язык ГиперТекстовой Разметки)</li> - <li>Диалоговые окна в компьютерных программах, также называемые модальными окнами, как правило, также являются документами. Такие окна могут также быть описаны с помощью языка разметки, такого как XUL (<span lang="en">XML User Interface Language</span> — XML-совместимый язык пользовательских интерфейсов), которые можно найти, например, в некоторых приложениях от Mozilla.</li> -</ul> -</div> - -<p>В этом руководстве блоки с заголовком <strong>Подробнее</strong>, как нижеследующий, содержат дополнительную информацию и ссылки на ресурсы, позволяющие более глубоко изучить вопрос, которому посвящён тот или иной раздел. Вы можете сразу же воспользоваться этими материалами или же пропустить эти блоки и вернуться к ним позже.</p> - -<div class="tuto_details"> -<div class="tuto_type">Подробнее</div> - -<p>Документ это не то же самое, что файл. Но, тем не менее, документ может храниться в одном файле.</p> - -<p>Со страницей, которую вы сейчас читаете, дела обстоят немного сложнее. Когда ваш браузер запрашивает данную страницу, сервер обращается к базе данных и генерирует документ, собирая его по частям из нескольких документов, каждый из которых, в свою очередь, может располагаться в нескольких файлах. Однако в этом руководстве вы также сможете работать с документами, каждый из которых представлен одним файлом.</p> - -<p>Больше информации о документах и языках разметки вы найдёте в других разделах этого сайта:</p> - -<table style="background-color: inherit; margin-left: 2em;"> - <tbody> - <tr> - <td><a href="/ru/docs/Web/HTML" title="/ru/docs/Web/HTML">HTML</a></td> - <td>о веб-страницах</td> - </tr> - <tr> - <td><a href="/ru/docs/XML" title="/ru/docs/XML">XML</a></td> - <td>о структуре документов в общем</td> - </tr> - <tr> - <td><a href="/ru/docs/Web/SVG" title="/ru/docs/Web/SVG">SVG</a></td> - <td>о графике</td> - </tr> - <tr> - <td><a href="/ru/docs/XUL" title="/ru/docs/XUL">XUL</a></td> - <td>о пользовательских интерфейсах в Mozilla</td> - </tr> - </tbody> -</table> - -<p>Во второй части данного руководства вы встретите примеры этих языков разметки.</p> -</div> - -<div class="tuto_details"> -<div class="tuto_type">Подробнее</div> - -<p>В терминах CSS программа, которая выводит документ пользователю, так называемому <em lang="en">user agent</em> (<span lang="en">UA</span>). Браузер — один из видов UA. CSS, таким образом, не предназначен только для браузеров или визуального представления, но в первой части данного руководства вы будете работать с CSS только в браузере.</p> - -<p>Прочие определения и термины, имеющие отношение к CSS, вы можете найти в <a class="external" href="http://www.w3.org/TR/CSS21/conform.html#q1">Определениях</a> спецификации CSS, созданной World Wide Web Consortium (W3C), международным сообществом которое установило открытые стандарты web.</p> -</div> - -<h2 id="К_действию_Создание_документа">К действию: Создание документа</h2> - -<ol> - <li>Создайте новую папку на вашем компьютере для упражнений.</li> - <li>Откройте текстовый редактор и создайте новый текстовый файл. Этот файл будет содержать документ для нескольких следующих упражнений.</li> - <li>Скопируйте и вставьте HTML, приведённый ниже, а затем сохраните ваш файл под именем <code>doc1.html.</code> - <pre class="brush: html"><!DOCTYPE html> -<html> - <head> - <meta charset="UTF-8"> - <title>Sample document</title> - </head> - - <body> - <p> - <strong>C</strong>ascading - <strong>S</strong>tyle - <strong>S</strong>heets - </p> - </body> -</html></pre> - - <p>{{ LiveSampleLink('Action.3A_Creating_a_document', 'Посмотреть демо') }}</p> - </li> - <li>Откройте новую вкладку или новое окно в вашем браузере и откройте только что созданный файл. - <p>Вы должны увидеть строку, в которой заглавные буквы выделены полужирным начертанием:</p> - - <table style="border: 2px outset #36b; padding: 1em;"> - <tbody> - <tr> - <td><strong>C</strong>ascading <strong>S</strong>tyle <strong>S</strong>heets</td> - </tr> - </tbody> - </table> - - <p>То, что вы увидите на самом деле, может немного отличаться потому, что настройки по умолчанию вашего браузера и данной энциклопедии наверняка будут отличаться: небольшие различия в шрифте, пробелах и цветах не очень-то и важны.</p> - </li> -</ol> - -<h2 id="Что_дальше">Что дальше?</h2> - -<p>{{nextPage("/ru/docs/Web/Guide/CSS/Getting_Started/Why_use_CSS", "Зачем нужен CSS?")}}В документе, который вы создали, CSS пока что не использовался. В <a href="/ru/docs/Web/Guide/CSS/Getting_Started/Why_use_CSS" title="/ru/docs/Web/Guide/CSS/Getting_Started/Why_use_CSS">следующем разделе</a> вы научитесь использовать CSS для стилизации документа.</p> diff --git a/files/ru/conflicting/learn/css/first_steps/index.html b/files/ru/conflicting/learn/css/first_steps/index.html deleted file mode 100644 index 2cfb1cb428..0000000000 --- a/files/ru/conflicting/learn/css/first_steps/index.html +++ /dev/null @@ -1,61 +0,0 @@ ---- -title: CSS для начинающих -slug: conflicting/Learn/CSS/First_steps -tags: - - Beginner - - CSS - - CSS:Getting_Started - - Guide - - Needs - - NeedsBeginnerUpdate - - NeedsTranslation - - NeedsUpdate - - TopicStub - - Web - - Новичку - - Руководство -translation_of: Learn/CSS/First_steps -translation_of_original: Web/Guide/CSS/Getting_started -original_slug: Web/Guide/CSS/Getting_started ---- -<p><span class="seoSummary">Это руководство (самоучитель) познакомит вас с базовыми возможностями и языком (синтаксисом) <a href="/ru/docs/Web/Guide/CSS" title="/ru/docs/Web/Guide/CSS"><strong>Каскадных таблиц стилей</strong></a> (CSS). CSS используется для изменения внешнего вида структурированного документа, такого как веб-страница. Руководство также включает простые упражнения, которые вы сможете выполнить на своём компьютере и увидеть, как работает CSS, а также его возможности в современных браузерах. </span></p> - -<p>Данное руководство создано для новичков и всех, кто хотел бы освежить свои знания основ CSS. Если у вас уже есть опыт работы с CSS, на главной странице вы можете найти <a href="/ru/docs/Web/Guide/CSS" title="/ru/docs/Web/Guide/CSS">список</a> обучающих ресурсов, подходящих для вашего уровня.</p> - -<nav class="fancyTOC"><a class="button" href="/ru/docs/Web/Guide/CSS/Getting_Started/What_is_CSS" rel="next" title="Глава «Что такое CSS» руководства по CSS">Что такое CSS</a> <a class="button" href="/ru/docs/Web/Guide/CSS/Getting_Started/Why_use_CSS" title="Глава «Зачем нужен CSS» руководства по CSS">Зачем нужен CSS</a> <a class="button" href="/ru/docs/Web/Guide/CSS/Getting_Started/How_CSS_works" title="Глава «Как работает CSS» руководства по CSS">Как работает CSS</a> <a class="button" href="/ru/docs/Web/Guide/CSS/Getting_Started/Cascading_and_inheritance" title="Глава «Каскадирование и наследование» руководства по CSS">Каскадность и наследование</a> <a class="button" href="/ru/docs/Web/Guide/CSS/Getting_Started/Selectors" title="Глава «Селекторы» руководства по CSS">Селекторы</a> <a class="button" href="/ru/docs/Web/Guide/CSS/Getting_Started/Readable_CSS" title="Глава «Читаемость CSS» руководства по CSS">Читаемость CSS</a> <a class="button" href="/ru/docs/Web/Guide/CSS/Getting_Started/Text_styles" title="Chapter 'Text_styles' of the CSS tutorial">стили текста</a> <a class="button" href="/ru/docs/Web/Guide/CSS/Getting_Started/Color" title="Глава «Цвета» руководства по CSS">Цвета</a> <a class="button" href="/ru/docs/Web/Guide/CSS/Getting_Started/Content" title="Chapter 'Content' of the CSS tutorial">контент</a> <a class="button" href="/ru/docs/Web/Guide/CSS/Getting_Started/Lists" title="Глава «Списки» руководства по CSS">Списки</a> <a class="button" href="/ru/docs/Web/Guide/CSS/Getting_Started/Boxes" title="Chapter 'Boxes' of the CSS tutorial">блок</a> <a class="button" href="/ru/docs/Web/Guide/CSS/Getting_Started/Layout" title="Chapter 'Layout' of the CSS tutorial">макет</a> <a class="button" href="/ru/docs/Web/Guide/CSS/Getting_Started/Tables" title="Глава «Таблицы» руководства по CSS">Таблицы</a> <a class="button" href="/ru/docs/Web/Guide/CSS/Getting_Started/Media" title="Chapter 'Media' of the CSS tutorial">медиа</a></nav> - -<h2 id="Что_вам_нужно_для_того_чтобы_начать">Что вам нужно для того, чтобы начать</h2> - -<ul> - <li>Текстовый редактор</li> - <li>Современный браузер</li> - <li>Опыт работы с текстовым редактором и браузером</li> -</ul> - -<p>В данном руководстве вам будут встречаться упражнения, которые вам предлагается выполнить для лучшего понимания материала. Их выполнение не является обязательным: вы можете просто читать материал и смотреть на иллюстрации.</p> - -<p><strong>Важно:</strong> Руководство включает в себя материалы по работе с цветом в CSS. Эти материалы будет легче пройти, если у вас цветной монитор и нормальное цветовое зрение.</p> - -<h2 id="Как_пользоваться_руководством">Как пользоваться руководством</h2> - -<p>Наилучшим вариантом будет внимательное и постепенное чтение разделов в строгой последовательности. Если вы пропустите какой-то раздел, вам может оказаться что-то непонятно в следующих главах.</p> - -<h3 id="Часть_I_Основы_CSS">Часть I: Основы CSS</h3> - -<p>На каждой странице, используйте секцию <em>Информация</em>, чтобы понять, как работает CSS. Используйте секцию <em>К действию</em>, чтобы попробовать использовать CSS на вашем компьютере.</p> - -<p>Чтобы проверить усвоенные знания, вам будет полезно решить задачу в конце каждой страницы. Верные решения задач вы всегда можете найти под их описанием в виде ссылки - таким образом, вы не сможете увидеть их случайно.</p> - -<p>Чтобы добиться более глубокого понимания CSS, читайте информацию в блоках с заголовком <em>Подробнее</em>. А также не забудьте посетить приведённые там ссылки.</p> - -<h3 id="Часть_II_Возможности_CSS">Часть II: Возможности CSS</h3> - -<p>Вторая часть руководства содержит примеры, которые продемонстрируют вам возможности CSS применительно к другим web-технологиям и технологиям Mozilla. </p> - -<ol> - <li><a href="/ru/docs/Web/Guide/CSS/Getting_Started/JavaScript" title="ru/CSS/Getting_Started/JavaScript">JavaScript</a></li> - <li><a href="/ru/docs/Web/Guide/CSS/Getting_Started/SVG_and_CSS" title="ru/CSS/Getting_Started/SVG_graphics">SVG графика</a></li> - <li><a href="/ru/docs/Web/Guide/CSS/Getting_Started/XML_data" title="ru/CSS/Getting_Started/XML_data">XML данные</a></li> - <li><a href="/ru/docs/Web/Guide/CSS/Getting_Started/XBL_bindings" title="ru/CSS/Getting_Started/XBL_bindings">XBL байдинг bindings</a></li> - <li><a href="/ru/docs/Web/Guide/CSS/Getting_Started/XUL_user_interfaces" title="en/CSS/Getting_Started/XUL_user_interfaces">Пользовательские интерфейсы XUL</a></li> -</ol> diff --git a/files/ru/conflicting/learn/css/index.html b/files/ru/conflicting/learn/css/index.html deleted file mode 100644 index 2a639c4b61..0000000000 --- a/files/ru/conflicting/learn/css/index.html +++ /dev/null @@ -1,13 +0,0 @@ ---- -title: Руководство разработчика CSS -slug: conflicting/Learn/CSS -tags: - - CSS - - Landing - - NeedsTranslation - - TopicStub -translation_of: Learn/CSS -translation_of_original: Web/Guide/CSS -original_slug: Web/Guide/CSS ---- -prepare for redirect diff --git a/files/ru/conflicting/learn/css/styling_text/fundamentals/index.html b/files/ru/conflicting/learn/css/styling_text/fundamentals/index.html deleted file mode 100644 index f61ad3b65e..0000000000 --- a/files/ru/conflicting/learn/css/styling_text/fundamentals/index.html +++ /dev/null @@ -1,153 +0,0 @@ ---- -title: Text styles -slug: conflicting/Learn/CSS/Styling_text/Fundamentals -translation_of: Learn/CSS/Styling_text/Fundamentals -translation_of_original: Web/Guide/CSS/Getting_started/Text_styles -original_slug: Web/Guide/CSS/Getting_started/Text_styles ---- -<p>{{ CSSTutorialTOC() }}</p> - -<p>{{previousPage("/en-US/docs/Web/Guide/CSS/Getting_Started/Readable_CSS", "Readable CSS")}}<span class="seoSummary">This is the 7th section of the <a href="/en-US/docs/Web/Guide/CSS/Getting_Started" title="en-US/docs/Web/Guide/CSS/Getting Started">CSS Getting Started</a> tutorial; it gives more examples of text styles. You modify your sample stylesheet to use different fonts.</span></p> - -<h2 class="clearLeft" id="Information_Text_styles">Information: Text styles</h2> - -<p>CSS имеет несколько свойств для стилизации текста.</p> - -<p>There is a convenient shorthand property, {{ cssxref("font") }}, which you can use to specify several aspects at once—for example:</p> - -<ul> - <li>Bold, italic, and small-caps (small capitals)</li> - <li>Size</li> - <li>Line height</li> - <li>Font typeface</li> -</ul> - -<div class="tuto_example"> -<div class="tuto_type">Example</div> - -<pre class="brush:css">p { -font: italic 75%/125% "Comic Sans MS", cursive; -} -</pre> - -<p>This rule sets various font properties, making all paragraphs italic.</p> - -<p>The font size is set to three-quarters of the size in each paragraph's parent element, and the line height is set to 125% (a little more spaced than normal).</p> - -<p>The font typeface is set to Comic Sans MS, but if this typeface is not available then the browser will use its default cursive (hand-written) typeface.</p> - -<p>The rule has the side-effect of turning off bold and small-caps (setting them to <code>normal</code>).</p> -</div> - -<h3 id="Font_faces">Font faces</h3> - -<p>You cannot predict what typefaces the readers of your document will have. When you specify font typefaces, it is a good idea to give a list of alternatives in order of preference.</p> - -<p>End the list with one of the built-in default typefaces: <code>serif</code>, <code>sans-serif</code>, <code>cursive</code>, <code>fantasy</code> or <code>monospace</code>.</p> - -<p>If the typeface does not support some features in the document, then the browser can substitute a different typeface. For example, the document might contain special characters that the typeface does not support. If the browser can find another typeface that has those characters, then it will use the other typeface.</p> - -<p>To specify a typeface on its own, use the {{ cssxref("font-family") }} property.</p> - -<h3 id="Font_sizes">Font sizes</h3> - -<p>Browser users can override the default font sizes or change the text size while they read a page, so it makes good sense for you to use relative sizes wherever you can.</p> - -<p>You can use some built-in values for font sizes, like <code>small</code>, <code>medium</code> and <code>large</code>. You can also use values relative to the font size of the parent element like: <code>smaller</code>, <code>larger</code>, <code>150%</code> or <code>1.5em</code>. An "em" is equivalent to the width of the letter "m" (for the font size of the parent element); thus 1.5em is one-and-a-half times the size of the font of the parent element.</p> - -<p>If necessary you can specify an actual size like: <code>14px</code> (14 pixels) for a display device or 14pt (14 points) for a printer. This is not accessible for visually impaired users because it does not allow them to change the size. A more accessible strategy is to set a built-in value like medium on a top-level element of the document, and then set relative sizes for all its descendent elements.</p> - -<p>To specify a font size on its own, use the {{ cssxref("font-size") }} property.</p> - -<h3 id="Line_height">Line height</h3> - -<p>The line height specifies the spacing between lines. If your document has long paragraphs with many lines, a larger-than-normal spacing makes it easier to read, especially if the font size is small.</p> - -<p>To specify a line height on its own, use the {{ cssxref("line-height") }} property.</p> - -<h3 id="Decoration">Decoration</h3> - -<p>The separate {{ cssxref("text-decoration") }} property can specify other styles, like <code>underline</code> or <code>line-through</code>. You can set it to <code>none</code> to explicitly remove any decoration.</p> - -<h3 id="Other_properties">Other properties</h3> - -<p>To specify italic on its own, use {{ cssxref("font-style") }}<code>: italic;</code><br> - To specify bold on its own, use <code>{{ cssxref("font-weight") }}: bold;</code><br> - To specify small capitals on its own, use <code>{{ cssxref("font-variant") }}: small-caps;</code></p> - -<p>To turn any of these off individually, you can specify the value <code>normal</code> or <code>inherit</code>.</p> - -<div class="tuto_details"> -<div class="tuto_type">More details</div> - -<p>You can specify text styles in a variety of other ways.</p> - -<p>For example, some of the properties mentioned here have other values that you can use.</p> - -<p>In a complex stylesheet, avoid using the shorthand <code>font</code> property because of its side-effects (resetting other individual properties).</p> - -<p>For full details of the properties that relate to fonts, see <a class="external" href="http://www.w3.org/TR/CSS21/fonts.html">Fonts</a> in the CSS Specification. For full details of text decoration, see <a class="external" href="http://www.w3.org/TR/CSS21/text.html">Text</a>.</p> - -<p>If you don't want to depend on the typefaces installed on users' systems, you can use {{ cssxref("@font-face") }} to specify an online font. However, this requires that the users have a browser that supports this rule.</p> -</div> - -<h2 id="Action_Specifying_fonts">Action: Specifying fonts</h2> - -<p>For a simple document, you can set the font of the {{ HTMLElement("body") }} element and the rest of the document inherits the settings.</p> - -<ol> - <li>Edit your CSS file.</li> - <li>Add the following rule to change the font throughout the document. The top of the CSS file is a logical place for it, but it has the same effect wherever you put it: - <pre class="eval">body { -font: 16px "Comic Sans MS", cursive; -} -</pre> - </li> - <li>Add a comment explaining the rule, and add white space to make it match your preferred layout.</li> - <li>Save the file and refresh your browser to see the effect. If your system has Comic Sans MS, or another cursive font that does not support italic, then your browser chooses a different font face for the italic text in the first line: - <table style="border: 2px outset #36b; padding: 1em;"> - <tbody> - <tr> - <td style="font: italic 16px 'Comic Sans MS', cursive; color: blue;"><strong style="color: red;">C</strong>ascading <strong style="color: green;">S</strong>tyle <strong style="color: green;">S</strong>heets</td> - </tr> - <tr> - <td style="font: 16px 'Comic Sans MS', cursive; color: blue;"><strong style="color: red;">C</strong>ascading <strong style="color: red;">S</strong>tyle <strong style="color: red;">S</strong>heets</td> - </tr> - </tbody> - </table> - </li> - <li>From your browser's menu bar, choose <strong>View > Text Size > Increase</strong> (or <strong>View > Zoom > Zoom In</strong>). Even though you specified 16 pixels in the style, a user reading the document can change the size.</li> -</ol> - -<div class="tuto_example"> -<div class="tuto_type">Challenge</div> - -<p>Without changing anything else, make all six initial letters twice the size in the browser's default serif font:</p> - -<table> - <tbody> - <tr> - <td style="font: italic 16px 'Comic Sans MS', cursive; color: blue;"><strong style="color: red; font: 200% serif;">C</strong>ascading <strong style="color: green; font: 200% serif;">S</strong>tyle <strong style="color: green; font: 200% serif;">S</strong>heets</td> - </tr> - <tr> - <td style="font: 16px 'Comic Sans MS', cursive; color: blue;"><strong style="color: red; font: 200% serif;">C</strong>ascading <strong style="color: red; font: 200% serif;">S</strong>tyle <strong style="color: red; font: 200% serif;">S</strong>heets</td> - </tr> - </tbody> -</table> - -<div class="tuto_details" id="tutochallenge"> -<div class="tuto_type">Possible solution</div> - -<p>Add the following style declaration to the <code>strong</code> rule:</p> - -<pre class="brush: css"> font: 200% serif; -</pre> -If you use separate declarations for <code>font-size</code> and <code>font-family</code>, then the <code>font-style</code> setting on the first paragraph is <em>not</em> overridden. - -<p> </p> -<a class="hideAnswer" href="#challenge">Hide solution</a></div> -<a href="#tutochallenge" title="Display a possible solution for the challenge">See a solution for the challenge.</a></div> - -<h2 id="What_next">What next?</h2> - -<p>{{nextPage("/en-US/docs/Web/Guide/CSS/Getting_Started/Color", "Color")}}Your sample document already uses several named colors. The <a href="/en-US/docs/Web/Guide/CSS/Getting_Started/Color" title="/en-US/docs/Web/Guide/CSS/Getting_Started/Color">next section</a> lists the names of standard colors and explains how you can specify others<strong>.</strong></p> diff --git a/files/ru/conflicting/learn/javascript/objects/index.html b/files/ru/conflicting/learn/javascript/objects/index.html deleted file mode 100644 index c1a92d8c1d..0000000000 --- a/files/ru/conflicting/learn/javascript/objects/index.html +++ /dev/null @@ -1,357 +0,0 @@ ---- -title: Вступление в Объектно-ориентированный JavaScript -slug: conflicting/Learn/JavaScript/Objects -translation_of: Learn/JavaScript/Objects -translation_of_original: Web/JavaScript/Introduction_to_Object-Oriented_JavaScript -original_slug: Web/JavaScript/Introduction_to_Object-Oriented_JavaScript ---- -<p>Объектно-ориентированный до основания, JavaScript предоставляет мощные и гибкие {{Glossary("OOP")}} возможности. Эта статья начинается с введения в объектно-ориентированное программирование, затем рассматривает модель объекта JavaScript и, наконец, демонстрирует концепции объектно-ориентированного программирования в JavaScript.</p> - -<h2 id="JavaScript_Review" name="JavaScript_Review">Обзор JavaScript</h2> - -<p>Если вы неуверенно владеете такими концепциями JavaScript, как переменные, типы, функции и области видимости, вы можете прочитать об этих темах в <a href="/ru/docs/Web/JavaScript/A_re-introduction_to_JavaScript">Повторное вступление в JavaScript</a>. Вы также можете обратиться к <a href="/ru/docs/Web/JavaScript/Guide">JavaScript Guide</a>.</p> - -<h2 id="Object-oriented_programming" name="Object-oriented_programming">Объектно-ориентированное программирование</h2> - -<p>Объектно-ориентированное программирование (ООП) — это парадигма программирования, которая использует {{glossary("абстракции")}}, чтобы создавать модели, основанные на объектах реального мира. ООП использует несколько техник из ранее признанных парадигм, включая {{glossary("модульность")}}, {{glossary("полиморфизм")}} и {{glossary("инкапсуляция")}}. На сегодняшний день многие популярные языки программирования (такие как Java, JavaScript, C#, C++, Python, PHP, Ruby и Objective-C) поддерживают ООП.</p> - -<p>ООП представляет программное обеспечение как совокупность взаимодействующих объектов, а не набор функций или просто список команд (как в традиционном представлении). В ООП, каждый объект может получать сообщения, обрабатывать данные, и отправлять сообщения другим объектам. Каждый объект может быть представлен как маленькая независимая машина с отдельной ролью или ответственностью.</p> - -<p>ООП способствует большей гибкости и поддерживаемости в программировании, и широко распространена в крупномасштабном программном инжиниринге. Так как ООП настоятельно подчёркивает модульность, объектно-ориентированный код проще в разработке и проще для понимания впоследствии. Объектно-ориентированный код способствует более точному анализу, кодированию и пониманию сложных ситуаций и процедур, чем методы программирования с меньшей модульностью.<a href="#cite-1"><sup>1</sup></a></p> - -<h2 id="Terminology" name="Terminology">Терминология</h2> - -<dl> - <dt>{{Glossary("Пространство имён")}}</dt> - <dd>Контейнер, который позволяет разработчикам связать всю функциональность под уникальным, специфичным для приложения именем.</dd> - <dt>{{Glossary("Класс")}}</dt> - <dd>Определяет характеристики объекта. Класс является описанием шаблона свойств и методов объекта.</dd> - <dt>{{Glossary("Объект")}}</dt> - <dd>Экземпляр класса.</dd> - <dt>{{Glossary("Свойство")}}</dt> - <dd>Характеристика объекта, например, цвет.</dd> - <dt>{{Glossary("Метод")}}</dt> - <dd>Возможности объекта, такие как ходьба. Это подпрограммы или функции, связанные с классом.</dd> - <dt>{{Glossary("Конструктор")}}</dt> - <dd>Метод, вызываемый в момент создания экземпляра объекта. Он, как правило, имеет то же имя, что и класс, содержащий его.</dd> - <dt>{{Glossary("Наследование")}}</dt> - <dd>Класс может наследовать характеристики от другого класса.</dd> - <dt>{{Glossary("Инкапсуляция")}}</dt> - <dd>Способ комплектации данных и методов, которые используют данные.</dd> - <dt>{{Glossary("Абстракция")}}</dt> - <dd>Совокупность комплексных наследований, методов и свойств объекта должны адекватно отражать модель реальности.</dd> - <dt>{{Glossary("Полиморфизм")}}</dt> - <dd>Поли означает "<em>много</em>", а морфизм "<em>формы</em>". Различные классы могут объявить один и тот же метод или свойство.</dd> -</dl> - -<p>Для более обширного описания объектно-ориентированного программирования, см {{interwiki("wikipedia", "Объектно-ориентированное_программирование")}} в Wikipedia.</p> - -<h2 id="Прототипное_программирование">Прототипное программирование</h2> - -<p>Прототипное программирование — это модель ООП которая не использует классы, а вместо этого сначала выполняет поведение класса и затем использует его повторно (эквивалент наследования в языках на базе классов), декорируя (или расширяя) существующие<em> </em>объекты <em>прототипы</em>. (Также называемое бесклассовое, прототипно-ориентированное, или экземпляра-ориентированное программирование.)</p> - -<p>Оригинальный (и наиболее каноничный) пример прототипно-ориентированного языка это {{interwiki("wikipedia", "Self (programming language)", "Self")}} разработанный Дэвидом Ангаром и Ренделлом Смитом. Однако бесклассовый стиль программирования стал набирать популярность позднее, и был принят для таких языков программирования, как JavaScript, Cecil, NewtonScript, Io, MOO, REBOL, Kevo, Squeak (при использовании фреймворка Viewer для манипуляции компонентами Morphic) и некоторых других.<a href="#cite-1"><sup>1</sup></a></p> - -<h2 id="JavaScript_Object_Oriented_Programming" name="JavaScript_Object_Oriented_Programming">Объектно-ориентированное программирование в JavaScript</h2> - -<h3 id="Пространство_имён">Пространство имён</h3> - -<p>Пространство имён — это контейнер, который позволяет разработчикам собрать функциональность под уникальным именем приложения. <strong>Пространство имён в JavaScript — это объект, содержащий методы, свойства и другие объекты.</strong></p> - -<div class="note"> -<p>Важно отметить, что на уровне языка в JavaScript нет разницы между пространством имён и любым другим объектом. Это отличает JS от множества других объектно-ориентированных языков и может стать причиной путаницы у начинающих JS программистов.</p> -</div> - -<p>Принцип работы пространства имён в JS прост: создать один глобальный объект и все переменные, методы и функции объявлять как свойства этого объекта. Также использование пространств имён снижает вероятность возникновения конфликтов имён в приложении так как каждый объект приложения является свойством глобального объекта.</p> - -<p>Давайте создадим глобальный объект MYAPP:</p> - -<pre class="brush: js">// Глобальное пространство имён -var MYAPP = MYAPP || {};</pre> - -<p>Во фрагменте кода выше мы сначала проверяем определён ли объект MYAPP (в текущем файле или другом файле). Если да, то используем существующий глобальный объект MYAPP, иначе создаём пустой объект MYAPP, в котором мы инкапсулируем все методы, функции, переменные и объекты.</p> - -<p>Также мы можем создать подпространство имён (учтите, что сначала нужно объявить глобальный объект):</p> - -<pre class="brush: js">// Подпространство имён -MYAPP.event = {};</pre> - -<p>Далее следует пример синтаксиса создания пространства имён и добавления переменных, функций и методов:</p> - -<pre class="brush: js">// Создаём контейнер MYAPP.commonMethod для общих методов и свойств -MYAPP.commonMethod = { - regExForName: "", // определяет регулярное выражение для валидации имени - regExForPhone: "", // определяет регулярное выражение для валидации телефона - validateName: function(name){ - // Сделать что-то с name, вы можете получить доступ к переменной regExForName - // используя "this.regExForName" - }, - - validatePhoneNo: function(phoneNo){ - // Сделать что-то с номером телефона - } -} - -// Объект вместе с объявлением методов -MYAPP.event = { - addListener: function(el, type, fn) { - // код - }, - removeListener: function(el, type, fn) { - // код - }, - getEvent: function(e) { - // код - } - - // Можно добавить другие свойства и методы -} - -// Синтаксис использования метода addListener: -MYAPP.event.addListener("yourel", "type", callback);</pre> - -<h3 id="Core_Objects" name="Core_Objects">Стандартные встроенные объекты</h3> - -<p>В JavaScript есть несколько объектов, встроенных в ядро, например {{jsxref("Math")}}, {{jsxref("Object")}}, {{jsxref("Array")}} и {{jsxref("String")}}. Пример ниже показывает как использовать объект Math, чтобы получить случайное число, используя его метод random().</p> - -<pre class="brush: js">console.log(Math.random()); -</pre> - -<div class="note"><strong>Примечание:</strong> В данном примере и далее мы будем использовать глобальную функцию {{domxref("console.log()")}}. Если точнее, то функция <code>console.log()</code> не является частью JavaScript, но она поддерживается многими браузерами для облегчения отладки.</div> - -<p>Смотрите <a href="/ru/docs/Web/JavaScript/Reference/Global_Objects" title="en-US/docs/Web/JavaScript/Reference/Global_Objects">JavaScript Reference: Standard built-in objects</a>, чтобы ознакомиться со списком всех встроенных объектов JavaScript.</p> - -<p>Каждый объект в JavaScript является экземпляром объекта <code><a href="/ru/docs/Web/JavaScript/Reference/Global_Objects/Object">Object</a></code>, следовательно наследует все его свойства и методы.</p> - -<h3 id="Custom_Objects" name="Custom_Objects">Объекты, создаваемые пользователем</h3> - -<h4 id="The_Class" name="The_Class">Класс</h4> - -<p>JavaScript — это прототипно-ориентированный язык, и в нём нет оператора <code>class</code>, который имеет место в C++ или Java. Иногда это сбивает с толку программистов, привыкших к языкам с оператором <code>class</code>. Вместо этого JavaScript использует функции как конструкторы классов. Объявить класс так же просто как объявить функцию. В примере ниже мы объявляем новый класс Person с пустым конструктором:</p> - -<pre class="brush: js">var Person = function () {}; -</pre> - -<h4 id="The_Object_.28Class_Instance.29" name="The_Object_.28Class_Instance.29">Объект (экземпляр класса)</h4> - -<p>Для создания нового экземпляра объекта <code>obj</code> мы используем оператор <code>new obj</code>, присваивая результат (который имеет тип <code>obj</code>) в переменную.</p> - -<p>В примере выше мы определили класс <code>Person</code>. В примере ниже мы создаём два его экземпляра (<code>person1</code> и <code>person2</code>).</p> - -<pre class="brush: js">var person1 = new Person(); -var person2 = new Person(); -</pre> - -<div class="note">Ознакомьтесь с {{jsxref("Object.create()")}}, новым, дополнительным методом инстанцирования, который создаёт неинициализированный экземпляр.</div> - -<h4 id="The_Constructor" name="The_Constructor">Конструктор</h4> - -<p>Конструктор вызывается в момент создания экземпляра класса (в тот самый момент, когда создаётся объект). Конструктор является методом класса. В JavaScript функция служит конструктором объекта, поэтому нет необходимости явно определять метод конструктор. Любое действие определённое в конструкторе будет выполнено в момент создания экземпляра класса.</p> - -<p>Конструктор используется для задания свойств объекта или для вызова методов, которые подготовят объект к использованию. Добавление методов и их описаний производится с использованием другого синтаксиса, описанного далее в этой статье.</p> - -<p>В примере ниже, конструктор класса <code>Person</code> выводит в консоль сообщение в момент создания нового экземпляра <code>Person</code>.</p> - -<pre class="brush: js">var Person = function () { - console.log('instance created'); -}; - -var person1 = new Person(); -var person2 = new Person(); -</pre> - -<h4 id="The_Property_.28object_attribute.29" name="The_Property_.28object_attribute.29">Свойство (атрибут объекта)</h4> - -<p>Свойства — это переменные, содержащиеся в классе; каждый экземпляр объекта имеет эти свойства. Свойства устанавливаются в конструкторе (функции) класса, таким образом они создаются для каждого экземпляра.</p> - -<p>Ключевое слово <code>this</code>, которое ссылается на текущий объект, позволяет вам работать со свойствами класса. Доступ (чтение и запись) к свойствам снаружи класса осуществляется синтаксисом <code>InstanceName.Property,</code> так же как в C++, Java и некоторых других языках. (Внутри класса для получения и изменения значений свойств используется синтаксис <code>this.Property</code>)</p> - -<p>В примере ниже, мы определяем свойство <code>firstName</code> для класса <code>Person</code> при создании экземпляра:</p> - -<pre class="brush: js">var Person = function (firstName) { - this.firstName = firstName; - console.log('Person instantiated'); -}; - -var person1 = new Person('Alice'); -var person2 = new Person('Bob'); - -// Выводит свойство firstName в консоль -console.log('person1 is ' + person1.firstName); // выведет "person1 is Alice" -console.log('person2 is ' + person2.firstName); // выведет "person2 is Bob" -</pre> - -<h4 id="The_methods" name="The_methods">Методы</h4> - -<p>Методы — это функции (и определяются как функции), но с другой стороны следуют той же логике, что и свойства. Вызов метода похож на доступ к свойству, но вы добавляете () на конце имени метода, возможно, с аргументами. Чтобы объявить метод, присвойте функцию в именованное свойство свойства <code>prototype</code> класса. Потом вы сможете вызвать метод объекта под тем именем, которое вы присвоили функции.</p> - -<p>В примере ниже мы определяем и используем метод <code>sayHello()</code> для класса <code>Person</code>.</p> - -<pre class="brush: js">var Person = function (firstName) { - this.firstName = firstName; -}; - -Person.prototype.sayHello = function() { - console.log("Hello, I'm " + this.firstName); -}; - -var person1 = new Person("Alice"); -var person2 = new Person("Bob"); - -// вызываем метод sayHello() класса Person -person1.sayHello(); // выведет "Hello, I'm Alice" -person2.sayHello(); // выведет "Hello, I'm Bob" -</pre> - -<p>В JavaScript методы это — обычные объекты функций, связанные с объектом как свойства: это означает, что вы можете вызывать методы "вне контекста". Рассмотрим следующий пример:</p> - -<pre class="brush: js">var Person = function (firstName) { - this.firstName = firstName; -}; - -Person.prototype.sayHello = function() { - console.log("Hello, I'm " + this.firstName); -}; - -var person1 = new Person("Alice"); -var person2 = new Person("Bob"); -var helloFunction = person1.sayHello; - -// выведет "Hello, I'm Alice" -person1.sayHello(); - -// выведет "Hello, I'm Bob" -person2.sayHello(); - -// выведет "Hello, I'm undefined" (or fails -// with a TypeError in strict mode) -helloFunction(); - -// выведет true -console.log(helloFunction === person1.sayHello); - -// выведет true -console.log(helloFunction === Person.prototype.sayHello); - -// выведет "Hello, I'm Alice" -helloFunction.call(person1);</pre> - -<p>Как показывает пример, все ссылки, которые мы имеем на функцию <code>sayHello</code> — <code>person1</code>, <code>Person.prototype</code>, переменная <code>helloFunction</code> и т.д. — ссылаются на одну и ту же функцию. Значение <code>this</code> в момент вызова функции зависит от того, как мы её вызываем. Наиболее часто мы обращаемся к <code>this</code> в выражениях, где мы получаем функцию из свойства объекта — <code>person1.sayHello()</code> — <code>this</code> устанавливается на объект, из которого мы получили функцию (<code>person1</code>), вот почему <code>person1.sayHello()</code> использует имя "Alice", а <code>person2.sayHello()</code> использует имя "Bob". Но если вызов будет совершён иначе, то <code>this</code> будет иным: вызов <code>this</code> из переменной — <code>helloFunction()</code> — установит <code>this</code> на глобальный объект (<code>window</code> в браузерах). Так как этот объект (вероятно) не имеет свойства <code>firstName</code>, функция выведет "Hello, I'm undefined" (так произойдёт в нестрогом режиме; в <a href="https://developer.mozilla.org/ru/docs/Web/JavaScript/Reference/Strict_mode">strict mode</a> всё будет иначе (ошибка), не будем сейчас вдаваться в подробности, чтобы избежать путаницы). Или мы можем указать <code>this</code> явно с помощью <code>Function#call</code> (или <code>Function#apply</code>) как показано в конце примера.</p> - -<div class="note"><strong>Примечание:</strong> Смотрите подробнее о <code>this</code> в <a href="/ru/docs/Web/JavaScript/Reference/Global_Objects/Function/call" title="https://developer.mozilla.org/en/JavaScript/Reference/Global_Objects/Function/call">Function#call</a> и <a href="/ru/docs/Web/JavaScript/Reference/Global_Objects/Function/apply" title="https://developer.mozilla.org/en/JavaScript/Reference/Global_Objects/Function/apply">Function#apply</a></div> - -<h4 id="Inheritance" name="Inheritance">Наследование</h4> - -<p>Наследование — это способ создать класс как специализированную версию одного или нескольких классов (JavaScript поддерживает только одиночное наследование). Специализированный класс, как правило, называют потомком, а другой класс родителем. В JavaScript наследование осуществляется присвоением экземпляра класса родителя классу потомку. В современных браузерах вы можете реализовать наследование с помощью <a href="/ru/docs/Web/JavaScript/Reference/Global_Objects/Object/create#Classical_inheritance_with_Object.create" title="/en-US/docs/JavaScript/Reference/Global_Objects/Object/create#Classical_inheritance_with_Object.create">Object.create</a>.</p> - -<div class="note"><strong>Примечание:</strong> JavaScript не обнаружит <code>prototype.constructor</code> класса потомка (смотрите <a href="/ru/docs/Web/JavaScript/Reference/Global_Objects/Object/prototype">Object.prototype</a>) так что мы должны указать его вручную. Смотрите вопрос "<a href="http://stackoverflow.com/questions/8453887/why-is-it-necessary-to-set-the-prototype-constructor">Why is it necessary to set the prototype constructor?</a>" на Stackoverflow.</div> - -<p>В примере ниже мы определяем класс <code>Student</code> как потомка класса <code>Person</code>. Потом мы переопределяем метод <code>sayHello()</code> и добавляем метод <code>addGoodBye()</code>.</p> - -<pre class="brush: js">// Определяем конструктор Person -var Person = function(firstName) { - this.firstName = firstName; -}; - -// Добавляем пару методов в Person.prototype -Person.prototype.walk = function(){ - console.log("I am walking!"); -}; - -Person.prototype.sayHello = function(){ - console.log("Hello, I'm " + this.firstName); -}; - -// Определяем конструктор Student -function Student(firstName, subject) { - // Вызываем конструктор родителя, убедившись (используя Function#call) - // что "this" в момент вызова установлен корректно - Person.call(this, firstName); - - // Инициируем свойства класса Student - this.subject = subject; -}; - -// Создаём объект Student.prototype, который наследуется от Person.prototype. -// Примечание: Распространённая ошибка здесь, это использование "new Person()", чтобы создать -// Student.prototype. Это неверно по нескольким причинам, не в последнюю очередь -// потому, что нам нечего передать в Person в качестве аргумента "firstName" -// Правильное место для вызова Person показано выше, где мы вызываем -// его в конструкторе Student. -Student.prototype = Object.create(Person.prototype); // Смотрите примечание выше - -// Устанавливаем свойство "constructor" для ссылки на класс Student -Student.prototype.constructor = Student; - -// Заменяем метод "sayHello" -Student.prototype.sayHello = function(){ - console.log("Hello, I'm " + this.firstName + ". I'm studying " - + this.subject + "."); -}; - -// Добавляем метод "sayGoodBye" -Student.prototype.sayGoodBye = function(){ - console.log("Goodbye!"); -}; - -// Пример использования: -var student1 = new Student("Janet", "Applied Physics"); -student1.sayHello(); // "Hello, I'm Janet. I'm studying Applied Physics." -student1.walk(); // "I am walking!" -student1.sayGoodBye(); // "Goodbye!" - -// Проверяем, что instanceof работает корректно -console.log(student1 instanceof Person); // true -console.log(student1 instanceof Student); // true -</pre> - -<p>Относительно строки <code>Student.prototype = Object.create(Person.prototype);</code>: В старых движках JavaScript, в которых нет <code><a href="/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object/create" title="Object.create">Object.create</a></code> можно использовать полифил (ещё известный как "shim") или функцию которая достигает тех же результатов, такую как:</p> - -<pre class="brush: js">function createObject(proto) { - function ctor() { } - ctor.prototype = proto; - return new ctor(); -} - -// Пример использования: -Student.prototype = createObject(Person.prototype); -</pre> - -<div class="note"><strong>Примечание:</strong> Смотрите <a href="/ru/docs/Web/JavaScript/Reference/Global_Objects/Object/create" title="Object.create">Object.create</a> для более подробной информации, и shim для реализации на старых движках.</div> - -<h4 id="Encapsulation" name="Encapsulation">Инкапсуляция</h4> - -<p>В примере выше классу <code>Student</code> нет необходимости знать о реализации метода <code>walk()</code> класса <code>Person</code>, но он может его использовать; Класс <code>Student</code> не должен явно определять этот метод, пока мы не хотим его изменить. Это называется <strong>инкапсуляция</strong>, благодаря чему каждый класс собирает данные и методы в одном блоке.</p> - -<p>Сокрытие информации распространённая особенность, часто реализуемая в других языках программирования как приватные и защищённые методы/свойства. Однако в JavaScript можно лишь имитировать нечто подобное, это не является необходимым требованием объектно-ориентированного программирования.<a href="#cite-2"><sup>2</sup></a></p> - -<h4 id="Abstraction" name="Abstraction">Абстракция</h4> - -<p>Абстракция это механизм который позволяет смоделировать текущий фрагмент рабочей проблемы, с помощью наследования (специализации) или композиции. JavaScript достигает специализации наследованием, а композиции возможностью экземплярам класса быть значениями атрибутов других объектов.</p> - -<p>В JavaScript класс <code>Function</code> наследуется от класса <code>Object</code> (это демонстрирует специализацию), а свойство <code>Function.prototype</code> это экземпляр класса <code>Object</code> (это демонстрирует композицию).</p> - -<pre class="brush: js">var foo = function () {}; - -// выведет "foo is a Function: true" -console.log('foo is a Function: ' + (foo instanceof Function)); - -// выведет "foo.prototype is an Object: true" -console.log('foo.prototype is an Object: ' + (foo.prototype instanceof Object));</pre> - -<h4 id="Polymorphism" name="Polymorphism">Полиморфизм</h4> - -<p>Так как все методы и свойства определяются внутри свойства <code>prototype</code>, различные классы могут определять методы с одинаковыми именами; методы находятся в области видимости класса в котором они определены, пока два класса не имеют связи родитель-потомок (например, один наследуется от другого в цепочке наследований).</p> - -<h2 id="Notes" name="Notes">Примечания</h2> - -<p>Это не все способы которыми можно реализовать объектно-ориентированное программирование в JavaScript, который очень гибок в этом отношении. Также способы рассмотренные здесь не отражают всех возможностей JavaScript и не подражают реализации теории объектов в других языках.</p> - -<p>Существуют другие способы, которые реализуют ещё более продвинутое объектно-ориентированное программирование на JavaScript, но они выходят за рамки этой вводной статьи.</p> - -<h2 id="References" name="References">Ссылки</h2> - -<ol> - <li><a name="cite-1"></a>Wikipedia. "<a href="http://en.wikipedia.org/wiki/Object-oriented_programming">Object-oriented programming</a>"</li> - <li><a name="cite-2"></a>Wikipedia. "<a href="http://en.wikipedia.org/wiki/Encapsulation_%28object-oriented_programming%29">Encapsulation (object-oriented programming)</a>"</li> -</ol> diff --git a/files/ru/conflicting/mdn/contribute/index.html b/files/ru/conflicting/mdn/contribute/index.html deleted file mode 100644 index 781b4d80ae..0000000000 --- a/files/ru/conflicting/mdn/contribute/index.html +++ /dev/null @@ -1,95 +0,0 @@ ---- -title: Участие в MDN -slug: conflicting/MDN/Contribute -tags: - - MDN Мета - - Mozilla - - Участие -translation_of: MDN_at_ten/Contributing_to_MDN -original_slug: MDN_at_ten/Contributing_to_MDN ---- -<div class="column-container"> -<div class="column-8"> -<h2 id="Как_принять_участие">Как принять участие</h2> - -<p>Внести свой вклад в MDN очень просто, и есть два способа начать работу. Вы видите страницу, которую можно улучшить (исправив опечатку, добавив новую информацию или исправив технические ошибки)? Просто нажмите большую синюю кнопку "Редактировать" в верхней части страницы. <span class="tlid-translation translation" lang="ru"><span title="">Вы знаете что-то, чего мы ещё не освещаем?</span></span> Просто <a href="/ru/docs/MDN/Contribute/Creating_and_editing_pages#Создание_новой_страницы">создайте новую страницу</a>; <span class="tlid-translation translation" lang="ru"><span title="">наше сообщество замечательных обозревателей и редакторов позаботится о том, чтобы ваша страница соответствовала нашему <a href="/ru/docs/Project:Writer's_guide">руководству по оформлению</a> и находилась в нужном месте на сайте.</span> <span title="">Не переживайте из-за того, чтобы получилось «полностью правильно».</span> <span title="">Каждый может помочь сделать Интернет лучше.</span></span></p> -</div> - -<div class="column-4"> -<div class="promo10 promo10-globe"> -<div class="promo10-text"> -<h3 id="Присоединяйтесь!">Присоединяйтесь!</h3> - -<p><span class="tlid-translation translation" lang="ru"><span title="">Присоединяйтесь к нам в обучении мира разработке открытой сети!</span></span></p> - -<p><a class="learnmore" href="/ru/docs/MDN/Contribute/Getting_started">Быстрый старт</a></p> -</div> -</div> -</div> -</div> - -<div class="column-container"> -<div class="column-8"> -<h2 id="Выборка_профилей_участников">Выборка профилей участников</h2> - -<p>MDN состоит из огромного сообщества участников. <span class="tlid-translation translation" lang="ru"><span title="">Хотя мы не можем предложить профили всех из них (это было бы очень долго!), Мы можем рассказать кое-что о некоторых из тех, кто внёс существенный или важный вклад, а также о тех, кто</span> <span title="">скорее всего, будет доступен в <a href="https://chat.mozilla.org/#/room/#mdn:mozilla.org">чате MDN Web Docs</a>, чтобы помочь вам, если вам понадобится помощь в вашем участии.</span></span></p> - -<div class="column-container"> -<div class="column-half"> -<h3 id="Chris_Blizzard_Former_Director_of_Evangelism_Mozilla">Chris Blizzard<br> - <small>Former Director of Evangelism, Mozilla</small></h3> - -<p><a href="/profiles/Blizzard">Blizzard</a> oversaw and drove Mozilla Developer Center's transition from focusing on Mozilla-specific material to a community-maintained resource useful to a variety of Web developers.</p> - -<h3 id="Николай_Пономарёв_Доброволец">Николай Пономарёв<br> - <small>Доброволец</small></h3> - -<p><a href="/profiles/Nickolay">Nickolay</a> был одним из самых ранних участников, помогая с первоначальными усилиями по очистке<span class="author-p-1669"> DevEdge. </span>С тех пор он продолжает вносить свой вклад во многих областях, как для веб-стандартов, так и для продуктов Mozilla.</p> - -<h3 id="Andrew_Overholt_Engineering_Manager">Andrew Overholt<br> - <small>Engineering Manager</small></h3> - -<p><a href="/profiles/Overholt">Andrew</a><span class="author-g-l0xhvihafq5iyoyt"> </span> <span class="tlid-translation translation" lang="ru"><span title="">возглавляет команду разработчиков веб-API.</span> <span title="">В рамках своей работы он побуждает всех разработчиков DOM и API помочь убедиться, что документация отличная, предоставляет информацию, которая нужна команде разработчиков, просматривает документацию и помогает с примерами кода.</span> <span title="">Этот пример очень и очень радует команду MDN.</span></span></p> - -<h3 id="Jérémie_Patonnier_Project_Manager">Jérémie Patonnier<br> - <small>Project Manager</small></h3> - -<p><a href="/profiles/Jeremie">Jérémie</a> <span class="tlid-translation translation" lang="ru"><span title="">начал вносить свой вклад в MDN в 2011 году, документируя свойства SVG, поскольку эта информация была ему нужна для его собственной работы.</span> </span> Jérémie <span class="tlid-translation translation" lang="ru"><span title=""> стал лидером французского сообщества MDN, проводя регулярные сессии "Mercredi Docs" (документ среды) в офисе Mozilla Париж.</span> <span title="">В настоящее время он возглавляет усилия по созданию <a href="/ru/docs/Learn">области обучения</a>, а также по улучшению и упорядочиванию данных о совместимости браузеров в MDN.</span></span></p> - -<h3 id="Julien_Sphinx_Доброволец"><span id="Julien_Sphinx_Volunteer">Julien (Sphinx)<br> - <small>Доброволец</small></span></h3> - -<p><a href="/en-US/profiles/SphinxKnight">Julien</a> <span class="tlid-translation translation" lang="ru"><span title="">внёс «львиную долю» усилий на перевод всего раздела JavaScript в MDN на французский язык.</span> <span title="">Многие другие участники также помогли в этой работе, но </span></span> Julien <span class="tlid-translation translation" lang="ru"><span title=""> провёл много ночей и выходных в течение нескольких месяцев, переводя статьи на JavaScript.</span></span></p> - -<h3 id="Jeff_Walden_Software_Engineer_JavaScript_Engine">Jeff Walden<br> - <small>Software Engineer, JavaScript Engine</small></h3> - -<p><a href="/profiles/Waldo">Jeff Walden</a> <span class="tlid-translation translation" lang="ru"><span title="">сейчас входит в команду</span></span> <span class="author-g-jkiyvakmsbole3bz122z"> SpiderMonkey, </span> <span class="tlid-translation translation" lang="ru"><span title="">которая внесла свой вклад в MDN с самого его начала и во многих областях, включая <a href="/ru/docs/Mozilla/Tech/XPCOM">XPCOM</a>, сборку и тестирование Mozilla, <a href="/ru/docs/Web/JavaScript">JavaScript</a>, <a href="/ru/docs/Web/CSS">CSS</a> и многое другое.</span></span></p> -</div> - -<div class="column-half"> -<h3 id="Priyanka_Nag_Доброволец">Priyanka Nag<br> - <small>Доброволец</small></h3> - -<p><a href="/profiles/Priyanka13">Priyanka Nag</a> присоединилась к MDN в 2012 году, но стала активно работать с сообществом MDN только после саммита Mozilla в 2013 году, где она встретилась и работала с Luke Crouch и David Walsh из команды разработчиков MDN; <span class="tlid-translation translation" lang="ru"><span title="">это послужило её главным вдохновением, чтобы начать вносить свой вклад в MDN.</span></span> Priyanka <span class="tlid-translation translation" lang="ru"><span title="">в основном любит проповедовать MDN, проводить мероприятия MDN и знакомить с MDN больше людей, а также время от времени вносить некоторые правки в вики.</span></span> В настоящее время она работает техническим писателем в Red Hat и с гордостью утверждает, что её интерес к техническому писательству начался с её вклада в MDN, который в конечном итоге оказал большое влияние на её решение о карьере.</p> - -<h3 id="Saurabh_Nair_Доброволец">Saurabh Nair<br> - <small>Доброволец</small></h3> - -<p><a href="/profiles/jsx">Saurabh</a> он вносит свой вклад в MDN с 2011 года и стал более активным в прошлом году. Он входит в команду “spam watch”, которая следит за спам-страницами, удаляя их и запрещая спамеров, как только они появляются. Поскольку он живёт в Индии, он может делать это, пока сотрудники MDN в Европе и Северной Америке спят.</p> - -<h3 id="Eric_Shepherd_Sheppy_Senior_Technical_Writer">Eric Shepherd (Sheppy)<br> - <small>Senior Technical Writer</small></h3> - -<p>{{UserLink("Sheppy")}} <span class="tlid-translation translation" lang="ru"><span title="">был первым штатным писателем, нанятым Mozilla для работы исключительно над документацией для разработчиков, начиная с 3 апреля 2006 года. Он пишет обо всем, что требует освещения, в том числе о вещах, с которыми никто другой не хочет иметь ничего общего.</span> <span title="">На протяжении многих лет он много писал обо всем, от дополнений до XUL.</span></span></p> - -<h3 id="Sebastian_Zartner_Доброволец">Sebastian Zartner<br> - <small>Доброволец</small></h3> - -<p><a href="/en-US/profiles/sebastianz">Sebastian </a> <span class="tlid-translation translation" lang="ru"><span title="">внёс первый вклад в MDN в 2007 году, когда он работал над немецкими переводами, но вскоре он начал работать над английскими.</span> <span title="">Он внёс большой вклад как в содержание, так и в структуру <a href="/ru/docs/Web/CSS/Reference">справочника CSS</a>, включая создание JSON API для страниц CSS и макросов, использующих это API.</span></span></p> -</div> -</div> -</div> - -<div class="column-4">{{TenthCampaignQuote(7)}} {{TenthCampaignQuote(5)}}</div> -</div> diff --git a/files/ru/conflicting/mdn/tools/index.html b/files/ru/conflicting/mdn/tools/index.html deleted file mode 100644 index ba40675886..0000000000 --- a/files/ru/conflicting/mdn/tools/index.html +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: Руководство пользователя MDN -slug: conflicting/MDN/Tools -tags: - - Documentation - - Landing - - MDN -translation_of: MDN/Tools -translation_of_original: MDN/User_guide -original_slug: MDN/User_guide ---- -<div>{{MDNSidebar}}</div><p>Сайт сети разработчиков Mozilla является продвинутой системой для поиска, чтения и внесения документации и примеров исходного кода для веб-разработчиков (а также для разработчиков под браузер Firefox и ОС Firefox). Руководство пользователя MDN предоставляет статьи, в подробностях описывающие, как использовать MDN для поиска нужной вам документации и, если вы желаете, как помочь сделать материалы лучше: более полными и обширными.</p> -<div> - {{LandingPageListSubpages}}</div> diff --git a/files/ru/conflicting/mozilla/add-ons/index.html b/files/ru/conflicting/mozilla/add-ons/index.html deleted file mode 100644 index 71d884c890..0000000000 --- a/files/ru/conflicting/mozilla/add-ons/index.html +++ /dev/null @@ -1,249 +0,0 @@ ---- -title: Создание расширения -slug: conflicting/Mozilla/Add-ons -tags: - - Расширение - - Создание -original_slug: Building_an_Extension ---- -<h2 id="Introduction" name="Introduction">Введение</h2> -<p>Этот урок по шагам покажет вам как создать простое <a href="/en/Extensions" title="en/Extensions">Расширение</a> – сутью которого является добавление в панель статуса Firefox блока со строкой "Hello, World!"</p> -<div class="note"> - <p><strong>Отметьте</strong> Данный урок о создании Расширений для Firefox 1.5 и более поздних версий. Другие существующие уроки для создания Расширений, предназначены для более ранних версий.</p> - <p>Если вас интересует урок по созданию Расширения для Thunderbird, смотрите <a href="/en/Building_a_Thunderbird_extension" title="en/Building_a_Thunderbird_extension">Создание Расширения для Thunderbird</a></p> -</div> -<h2 id="Setting_up_the_Development_Environment" name="Setting_up_the_Development_Environment">Настройка окружения</h2> -<p>Начнём с того, что Расширение распространяется в виде zip архива или <a href="/en/Bundles" title="en/Bundles">Пакетов</a>, с расширением <code>XPI</code> (<em>произносится как “зиппи”</em>).</p> -<p>Вот пример типичного XPI файла:</p> -<pre class="eval">exampleExt.xpi: - /<a href="/en/Install_Manifests" title="en/Install_Manifests">install.rdf</a> - <a href="#XPCOM_Components">/components/*</a> - <a href="#Application_Command_Line">/components/cmdline.js</a> - <a href="#Defaults_Files">/defaults/</a> - <a href="#Defaults_Files">/defaults/preferences/*.js</a> - /plugins/* - /<a href="/en/Chrome_Registration" title="en/Chrome_Registration">chrome.manifest</a> - /<a href="/en/Window_icons" title="en/Window_icons">chrome/icons/default/*</a> - /chrome/ - /chrome/content/ - -</pre> -<p>Давайте создадим файловою структуру для нашего урока, подобную той что была описана выше, для чего создайте где-нибудь на жёстком диске директорию(например <code>C:\extensions\my_extension\</code> или <code>~/extensions/my_extension/</code>). Создайте в этой директории новую директорию c именем <code>chrome</code>, и создайте в директории <code>chrome</code> директорию с именем <code>content</code>.</p> -<p>В <strong>корне</strong> директории вашего Расширения создайте два пустых файла, один назовите <code>chrome.manifest</code>, а другой <code>install.rdf</code>.</p> -<p>В итоге у вас должна получиться вот такая структура:</p> -<pre><ext path>\ - install.rdf - chrome.manifest - chrome\ - content\ -</pre> -<p><span class="comment"><pre> #!/bin/sh h=$HOME/moExt mkdir -p $h/my_extension/chrome/content touch $h/my_extension/chrome.manifest $h/my_extension/install.rdf </pre></span> Более подробную информацию по настройке окружения читайте в статье <a href="/en/Setting_up_extension_development_environment" title="en/Setting_up_extension_development_environment">Setting up extension development environment</a>.</p> -<h2 id="Create_the_Install_Manifest" name="Create_the_Install_Manifest">Создание файла инсталляции</h2> -<p>Откройте файл <code><a href="/en/Install_Manifests" title="en/Install_Manifests">install.rdf</a></code> который вы создали на предыдущем этапе и вставьте эти строки:</p> -<pre class="eval"><?xml version="1.0"?> - -<RDF xmlns="<span class="nowiki">http://www.w3.org/1999/02/22-rdf-syntax-ns#</span>" - xmlns:em="<span class="nowiki">http://www.mozilla.org/2004/em-rdf#</span>"> - - <Description about="urn:mozilla:install-manifest"> - <em:id><strong><a class="link-mailto" href="mailto:sample@example.net" rel="freelink">sample@example.net</a></strong></em:id> - <em:version><strong>1.0</strong></em:version> - <em:type>2</em:type> - - <!-- Указывается приложение для которого может - быть установлено Расширение, его максимальная - и минимальная поддерживаемая версия. --> - <em:targetApplication> - <Description> - <em:id><strong>{ec8030f7-c20a-464f-9b0e-13a3a9e97384}</strong></em:id> - <em:minVersion><strong>1.5</strong></em:minVersion> - <em:maxVersion><strong>3.0.*</strong></em:maxVersion> - </Description> - </em:targetApplication> - - <!-- Front End MetaData --> - <em:name><strong>sample</strong></em:name> - <em:description><strong>A test extension</strong></em:description> - <em:creator><strong>Your Name Here</strong></em:creator> - <em:homepageURL><strong><span class="nowiki">http://www.example.com/</span></strong></em:homepageURL> - </Description> -</RDF> -</pre> -<ul> - <li><strong><a class="link-mailto" href="mailto:sample@example.net" rel="freelink">sample@example.net</a></strong> - идентификатор вашего Расширения. Это - значение, которое вы должны придумать сами, чтобы идентифицировать ваше Расширение, в данном случае оно в формате адреса электронной почты (это не обязательно должна быть <em>Ваша</em> электронная почта). Этот идентификатор должен быть уникальным. Вы можете также использовать GUID. ПРИМЕЧАНИЕ: Хотя этот параметр и ДОЛЖЕН быть в формате адреса электронной почты, но не обязательно должен быть действительным адресом электронной почты. (example.example.example)</li> - <li>Определение <code><em:type>2</em:type></code> -- объявляет, что устанавливается именно расширение. Если бы вы устанавливали тему, то это было бы 4 ( <a href="/en/Install_Manifests#type" title="en/Install_Manifests#type">Install Manifests#type</a> for other type codes).</li> - <li><strong>{ec8030f7-c20a-464f-9b0e-13a3a9e97384}</strong> - Идентификатор приложения Firefox.</li> - <li><strong>1.5</strong> - минимальная версия Firefox, с которой будет работать ваше Расширение. Укажите здесь минимальную версию, для которой будет выполняться все необходимые тесты.</li> - <li><strong>3.0.*</strong> - - максимальная версия Firefox, с которой будет работать ваше Расширение. Укажите здесь, самую свежую, доступную в данный момент версию. В этом случае, "3.0.*" указывает на то, что расширение работает с Firefox 3.0 и любыми последующими 3.0.x версиями.</li> -</ul> -<p>(В Firefox версии 3.0.1, вы не сможете установить для em:minVersion и em:maxVersion значение "<strong>3.0.*</strong>". Если вы попытаетесь установить Расширение, то получите ошибку "Not compatible with Firefox 3.0.1". Мне не ясны причины этого, так что я оставлю объяснение тому, кто имеет больше информации по этому поводу. Установка em:minVersion равным "<strong>3</strong>" и em:maxVersion равным "<strong>3.0.*</strong>" решило проблему для меня.)</p> -<p>Расширения разработанные для работы только с последними версиями Firefox 2.0.0.x, должны иметь установленным максимальную версию в "2.0.0. *". Расширения, разработанные для работы с только с последними версиями Firefox 1.5.0.x, должны иметь установленным максимальную версию "1.5.0. *".</p> -<p>Более подробно См. <a href="/en/Install_Manifests" title="en/Install_Manifests">Install Manifests</a> с полным перечнем основных и дополнительных свойств.</p> -<p>Сохраните файл.</p> -<h2 id="Extending_the_Browser_with_XUL" name="Extending_the_Browser_with_XUL">Расширение браузера с помощью XUL</h2> -<p>Пользовательский интерфейс Firefox написан c использованием XUL и JavaScript. <a href="/en/XUL" title="en/XUL">XUL</a> является языком разметки на основе грамматики XML, которая позволяет описывать такие фрагменты пользовательского интерфейса, как кнопки, меню, панели инструментов, деревья и т.д. Вся функциональность и обработка действий пользователя осуществляется с помощью JavaScript.</p> -<p>Чтобы расширить браузер, мы изменяем различные части интерфейса браузера путём добавления или изменения ”виджетов”. Мы добавляем “виджеты”, вставляя новые элементы, DOM XUL в окно браузера и изменяем их, используя сценарий (скрипт) и присоединяя, обработчики событий.</p> -<p>Интерфейс браузера описан в XUL файле, который называется <code>browser.xul</code> (<code>$FIREFOX_INSTALL_DIR/chrome/browser.jar</code> contains <code>content/browser/browser.xul</code>). В browser.xul, мы можем найти фрагмент описывающий строку состояния, который выглядит вот так:</p> -<pre class="eval"><statusbar id="status-bar"> - ... <statusbarpanel>s ... -</statusbar> -</pre> -<p><code><statusbar id="status-bar"></code> это “точка слияния" для XUL Оверлея.</p> -<h5 id="XUL_Overlays" name="XUL_Overlays">XUL Оверлеи</h5> -<p><a href="/en/XUL_Overlays" title="en/XUL_Overlays">XUL Оверлей</a> - это способ внедрить другие “виджеты” пользовательского интерфейса в основной документ XUL. XUL Оверлей – это .xul файл, в котором определены фрагменты XUL для вставки в определённых “точках слияния” в основном документе. Эти фрагменты, могут определять “виджеты” которые должны быть вставлены, удалены, или изменены.</p> -<p><strong>Пример документа XUL Оверлея:</strong></p> -<pre class="eval"><?xml version="1.0"?> -<overlay id="sample" - xmlns="<span class="nowiki">http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul</span>"> - <statusbar id="<strong>status-bar</strong>"> - <statusbarpanel id="my-panel" label="Hello, World"/> - </statusbar> -</overlay> -</pre> -<p><code><statusbar></code> название <code><strong>status-bar</strong></code> определяет "точку слияния" в пределах окна браузера, к которой мы хотим присоединить.</p> -<p><code><statusbarpanel></code> новый “виджет” который мы хотели бы вставить в пределах точки слияния.</p> -<p>Возьмите этот простой код и сохраните в новом файле с именем <code><strong>sample.xul</strong></code> и поместите его в директорию <code>chrome/content</code>.</p> -<p>Для получения дополнительной информации о присоединении “виджетов” и изменении пользовательского интерфейса, используя Оверлеи, см. далее.</p> -<h2 id="Chrome_URIs" name="Chrome_URIs">Chrome URIs</h2> -<p>XUL Файлы - это часть пакета <a href="/en/Chrome_Registration" title="en/Chrome_Registration">Chrome Packages</a> - пакета компонентов пользовательского интерфейса, которые загружаются через <code><a class="external" rel="freelink">chrome://</a></code>URIs. Вместо того, чтобы загружать их диска, используя <code><a class="external" rel="freelink">file://</a></code>URI (так как местоположение Firefox в системе может меняться от платформы к платформе и от системы к системе), разработчики Mozilla придумали решение, которое позволяет создать URIs к информационному наполнению XUL, о котором знает установленное приложение.</p> -<p>В окне браузера: <code><a class="external" rel="freelink">chrome://browser/content/browser.xul</a></code>. Напечатайте этот URL в адресной строке Firefox!</p> -<p>Chrome URIs состоит из нескольких составляющих:</p> -<ul> - <li>Во-первых, <strong>URI scheme</strong> схема (<code>chrome</code>), которая говорит сетевой библиотеке Firefox, что это Chrome URI. Указывает, что информационное наполнение URI, должно быть обработано как (<code>chrome</code>). В отличии от (<code>chrome</code>), (<code>http</code>) говорит Firefox обрабатывать URI как web-страницу.</li> - <li>Во-вторых, название пакета (<code><strong>browser</strong></code>, в примере выше), который идентифицирует пакет компонентов пользовательского интерфейса. Оно должно быть уникальным , чтобы избежать конфликтов между расширениями.</li> - <li>В-третьих, тип запрошенных данных. Есть три типа: <code>content</code> (XUL, JavaScript, связывания XBL, и т.д. которые формируют структуру и поведение приложения UI), <code>locale</code> (DTD.properties файлы и т.д, которые содержат строки для <a href="/en/Localization" title="en/Localization">локализации UI</a>), и <code>skin</code> (CSS и изображения, которые формируют <a href="/en/Themes" title="en/Themes">тему</a> UI)</li> - <li>Путь файла, для загрузки.</li> -</ul> -<p>Так, <code><a class="external" rel="freelink">chrome://foo/skin/bar.png</a></code> загружает файл <code>bar.png</code> из темы foo раздела <code>skin</code>.</p> -<p>Когда вы загружаете содержимое, используя Chrome URI, Firefox использует системный реестр Chrome, чтобы транслировать URIs в фактические исходные файлы на диске (или в пакетах JAR).</p> -<h2 id="Create_a_Chrome_Manifest" name="Create_a_Chrome_Manifest">Создание установок Chrome</h2> -<p>Для получения дополнительной информации об установках Chrome и о поддерживаемых свойствах руководство по <a href="/en/Chrome_Registration" title="en/Chrome_Registration">Chrome Manifest</a>.</p> -<p>Откройте файл с названием <strong>chrome.manifest</strong> который вы создали рядом с каталогом <code>chrome</code> в корне исходной иерархии директории вашего Расширения.</p> -<p>Добавьте в него код:</p> -<pre class="eval">content sample chrome/content/ -</pre> -<p>(<strong>Не забывайте, косую черту "<code>/</code>"!</strong> Без этого пакет не будет зарегистрирован.)</p> -<p>Здесь определяется:</p> -<ol> - <li>тип материала в пределах chrome пакета</li> - <li>название chrome пакета (удостоверьтесь, что вы используете все символы в нижнем регистре для имени пакета ("sample"), так как во 2-й версии не поддерживается смешанные регистры и вы получите ошибку {{ Bug(132183) }}</li> - <li>местоположение файлов chrome пакета</li> -</ol> -<p>Эта строка говорит, что для chrome пакета с именем <strong>sample</strong>, файлы информационного наполнения находятся в <code>chrome/content</code>, который является путём относительно местоположения <code>chrome.manifest</code>.</p> -<p>Заметьте, что content, locale и skin должны быть сохранены как каталоги, с соответствующими именами content, locale и skin в подкаталоге <code>chrome</code>.</p> -<p>Сохраните файл. Когда вы запустите Firefox со своим расширением, (это будет позже в данном уроке), chrome пакет будет зарегистрирован.</p> -<h2 id="Register_an_Overlay" name="Register_an_Overlay">Регистрация Оверлея</h2> -<p>Вам нужно присоединить ваш оверлей к окну браузера Firefox, при его отображении. Для этого добавьте следующую строку файл <code>chrome.manifest</code>:</p> -<pre class="eval">overlay <a class="external" rel="freelink">chrome://browser/content/browser.xul</a> <a class="external" rel="freelink">chrome://sample/content/sample.xul</a> -</pre> -<p>Эта строка говорит браузеру, присоединить sample.xul к browser.xul во время загрузки <code>browser.xul</code>.</p> -<h2 id="Test" name="Test">Тестирование</h2> -<p>Во-первых, мы должны рассказать о своём расширении Firefox. На стадии разработки для Firefox версии 2.0 и выше, вы можете указать Firefox папку, где вы разрабатываете Расширение, и оно будет загружать его каждый раз после перезапуска Firefox.</p> -<ol> - <li>Перейдите в <a class="external" href="http://kb.mozillazine.org/Profile_folder">папку вашего профиля</a> по умолчанию. Папка вашего профиля по умолчанию, должна, находится где-то в папке профилей, например в <code>Firefox/Profiles/<profile_id>.default/</code>.</li> - <li>Откройте папку <strong>extensions</strong>. Если ранее вы уже устанавливали, какие либо расширения, то она должна уже существовать.</li> - <li>Создайте там, новый текстовый файл и запишите в него путь к папке с вашим расширением, например <code>C:\extensions\my_extension\</code> или <code>~/extensions/my_extension/</code>. Сохраните файл, указав в качестве имени идентификатор вашего Расширения, в нашем примере это<code><a class="link-mailto" href="mailto:sample@example.net" rel="freelink">sample@example.net</a></code>.</li> -</ol> -<p>(<strong>Не забывайте, косую черту, "<code>/</code>"!</strong> Без этого ваше расширение не будет зарегистрировано.)</p> -<p>(<strong>my_extension может не работать!</strong> Если имя папки содержит символы подчеркивания.)</p> -<p>Теперь всё готово для испытания вашего расширения!</p> -<p>Запустите Firefox. Firefox обнаружит ссылку на каталог вашего расширения и установит его. Когда появится окно браузера вы должны увидеть текст "Hello, World!" на правой стороне в панели статуса.</p> -<p>Вы можете вернуться и внести необходимые изменения в .xul файл, после чего закрыть и перезапустить Firefox и изменения немедленно вступят в силу.</p> -<h2 id="Package" name="Package">Упаковка</h2> -<p>Теперь, когда ваше расширение работает, вы можете его <a href="/en/Extension_Packaging" title="en/Extension_Packaging">упаковать</a> для последующего развёртывания и установки.</p> -<p>За "зипуйте" папку <strong>contents</strong> вашего Расширения (не саму папку расширения), и переименуйте получившийся zip файл, так чтобы он имел расширение .xpi. В Windows XP, вы можете сделать это очень просто, выбрав все файлы и вложенные папки в папке вашего расширения, и щёлкнув правой кнопкой мыши и выбрав "Send To -> Compressed (Zipped) Folder". Zip файл будет создан. Просто переименуйте его, и готово!</p> -<p>В Mac OS X, вы можете нажать правой кнопкой мыши на папке <strong>contents</strong> вашего Расширения и выбрать "Создать архив ..." для создания архива. Однако, Mac OS X добавляет скрытые файлы в папку. Поэтому следует использовать Terminal, для удаления скрытых файлов (чьи имена начинаются с периода), а затем ввести в командной строке zip команду для создания архива.</p> -<p>В Linux, вы аналогичным образом можете использовать в командной строке Zip инструменты.</p> -<p>Если у вас установлено Extension Builder вы можете использовать его для сборки .xpi файла (Tools -> Extension Developer -> Extension Builder). Просто выберите каталог, где находится ваше расширение (install.rdf т.д.), и нажмите кнопку Build Extension (Построить расширение). Это расширение имеет множество инструментов для облегчения процесса создания расширений.</p> -<p>Теперь загрузите ваш .XPI файл на сервер, и сделайте, так чтобы он определялся как <code>application/x-xpinstall</code>. Вы можете давать ссылку на него и позволить людям скачивать и установить его. Для тестирования нашего. XPI файла можно просто перетащить его в окно менеджера расширений, открыв его через меню Tools -> Extensions в Firefox 1.5.0.x, или Tools -> Add-ons в более поздних версиях.</p> -<h5 id="Installing_from_a_web_page" name="Installing_from_a_web_page">Установка с web-страниц</h5> -<p>Существует множество путей, которыми вы можете устанавливать ваши расширения прямо с web-страниц, в том числе использование прямых ссылок на файлы XPI и использование <a href="/en/Installing_Extensions_and_Themes_From_Web_Pages" title="en/Installing_Extensions_and_Themes_From_Web_Pages"> InstallTrigger method</a> объекта. Разработчикам расширений и веб разработчикам, рекомендуется использовать для установки XPI методы InstallTrigger, которые дают больше возможностей их пользователям.</p> -<h5 id="Using_addons.mozilla.org" name="Using_addons.mozilla.org">Использование addons.mozilla.org</h5> -<p>С помощью сайта Mozilla Add-ons вы может распространять ваше Расширение для бесплатного пользования. Вше расширение будет иметь зеркала на Mozilla, что обеспечит доступность вашего расширения, если оно станет очень популярным. Сайт Mozilla также упрощает установку расширений для пользователей , и автоматически сделает доступными ваши новые версии для пользователей вашей текущей версии, после того как вы загрузите их. Кроме того Mozilla Add-ons позволяет пользователям оставлять комментарии и тем самым обеспечивает обратную связь с вашим Расширением. Настоятельно рекомендуется использовать Mozilla Add-ons для распространения ваших расширений!</p> -<p>Зайдите на <a class="external" href="http://addons.mozilla.org/developers/" rel="freelink">http://addons.mozilla.org/developers/</a> создайте учётную запись и начинайте распространение ваших расширений!</p> -<p><em>Примечание:</em>Ваше Расширение будет скачиваться быстрее и чаще, если у вас будет хорошее описание и скриншоты с вашим расширением в действии.</p> -<h5 id="Registering_Extensions_in_the_Windows_Registry" name="Registering_Extensions_in_the_Windows_Registry">Регистрация расширений в реестре Windows</h5> -<p>В Windows, информация о расширениях может быть добавлена в реестр, откуда Расширение автоматически будет извлекаться в следующий раз, при загрузке приложения. This allows application installers to easily add integration hooks as extensions. Для получения более подробной информации смотри <a href="/en/Adding_Extensions_using_the_Windows_Registry" title="en/Adding_Extensions_using_the_Windows_Registry">Adding Extensions using the Windows Registry</a>.</p> -<h2 id="More_on_XUL_Overlays" name="More_on_XUL_Overlays">Подробнее о XUL Оверлеях</h2> -<p>Помимо добавления UI виджетов, вы также можете использовать XUL фрагменты для:</p> -<ul> - <li>Изменить атрибуты для "точки слияния", например <code><statusbar id="status-bar" hidden="true" /></code> (скрывается строка состояния)</li> - <li>Удалить "точку слияния" из главного документа, например, <code><statusbar id="status-bar" removeelement="true" /></code></li> - <li>Контроль позиции вставки “виджета”:</li> -</ul> -<pre class="eval"><statusbarpanel position="1" .../> - -<statusbarpanel insertbefore="other-id" .../> - -<statusbarpanel insertafter="other-id" .../> -</pre> -<h2 id="Creating_New_User_Interface_Components" name="Creating_New_User_Interface_Components">Создание новых компонентов UI</h2> -<p>Вы можете создавать ваши собственные окна и диалоговые окошки в отдельных .xul файлах, обеспечивая их функциональность с помощью описания действий пользователя в .js файлах, используя DOM для манипуляции UI “виджетами”. Вы можете использовать стили из .css файлов для присоединения изображений, установки цвета и т.д.</p> -<p>Смотрите документацию по XUL на крупных ресурсах для разработчиков <a href="/en/XUL" title="en/XUL">XUL</a>.</p> -<h2 id="Defaults_Files" name="Defaults_Files">Файлы По умолчанию</h2> -<p>Файлы по умолчанию, которые вы используете для профиля пользователя, должны быть помещены в <code>defaults/</code> в корень в иерархии папок вашего Расширения. По умолчанию .js файлы с настройками должны храниться в <code>defaults/preferences/</code> - после того как вы поместите их туда они будут автоматически загружаться в системные настройки Firefox при запуске, так что вы сможете получить к ним доступ использую <a href="/en/Preferences_API" title="en/Preferences_API">Preferences API</a>.</p> -<p>Пример файла настроек по умолчанию:</p> -<pre class="eval">pref("extensions.sample.username", "Joe"); //строка -pref("extensions.sample.sort", 2); //число -pref("extensions.sample.showAdvanced", true); //булево -</pre> -<h2 id="XPCOM_Components" name="XPCOM_Components">XPCOM Components</h2> -<p>Firefox поддерживает <a href="/en/XPCOM" title="en/XPCOM">XPCOM</a> компоненты в расширениях. Вы можете легко создавать свои собственные компоненты на JavaScript или C + + (с использованием <a href="/en/Gecko_SDK" title="en/Gecko_SDK">Gecko SDK</a>).</p> -<p>Поместите все ваши. JS или. DLL файлы каталог <code>components/</code> - после установки расширения , они автоматически будут зарегистрированы при первом запуске Firefox.</p> -<p>Для получения дополнительной информации см. <a href="/en/How_to_Build_an_XPCOM_Component_in_Javascript" title="en/How_to_Build_an_XPCOM_Component_in_Javascript">Как создать XPCOM компонент на JavaScript</a>, <a href="/en/How_to_build_a_binary_XPCOM_component_using_Visual_Studio" title="en/How_to_build_a_binary_XPCOM_component_using_Visual_Studio">Как создать XPCOM компонент с использованием Visual Studio</a> и <a href="/en/Creating_XPCOM_Components" title="en/Creating_XPCOM_Components">Книги по созданию XPCOM Компонентов</a>.</p> -<h5 id="Application_Command_Line" name="Application_Command_Line">Командная строка приложения</h5> -<p>Один из возможных вариантов использования пользовательских XPCOM компонентов добавить в командную строку указатель для Firefox или Thunderbird. Вы можете использовать этот метод для запуска ваших расширений, как приложений:</p> -<pre class="eval"> firefox.exe -myapp -</pre> -<p><span class="comment">I should move the useful parts of this to the Command Line page. -Nickolay This is done by adding a component containing the function... function NSGetModule(comMgr, fileSpec) { return myAppHandlerModule; } This function is run by firefox each time firefox is started. Firefox registers the myAppHandlerModule's by calling its 'registerSelf()'. Then it obtains the myAppHandlerModule's handler factory via 'getClassObject()'. The handler factory is then used to create the handle using its 'createInstance(). Finally, the handle's 'handle(cmdline)' processes the command line cmdline's handleFlagWithParam() and handleFlag().</span> Смотрите <a href="/en/Chrome/Command_Line" title="en/Chrome/Command_Line">Chrome: Command Line</a> , а также обсуждения <a class="external" href="http://forums.mozillazine.org/viewtopic.php?t=365297">на форуме</a>.</p> -<h2 id="Localization" name="Localization">Локализация</h2> -<p>Для поддержки более чем одного языка, вы должны вместо отдельных строк из вашего содержимого использовать <a href="/en/XUL_Tutorial/Localization" title="en/XUL_Tutorial/Localization">"сущности"</a> или a href="<a class="external" rel="freelink">mks://localhost/en/XUL_Tutorial/Property_Files</a>" title="en/XUL_Tutorial/Property_Files">"связки строк". Это лучше делать в самом начале разработки вашего Расширения, а не возвращаться, к этому позже!</p> -<p>Информация о локализации хранится в каталоге локализации расширения. Например, чтобы добавить локализацию для нашего расширения, создайте директорию с именем "locale" в каталоге chrome (где находится каталог "content" ) и добавьте следующую строчку в файл chrome.manifest:</p> -<pre class="eval">locale sample en-US chrome/locale/en-US/ -</pre> -<p>Для создания локализации , значения атрибута в XUL, вы вставляете его значение в <code>.ent</code> (или <code>.dtd</code>) файле который, затем помещаете каталог локализации и который выглядит так:</p> -<pre class="eval"><!ENTITY button.label "Click Me!"> -<!ENTITY button.accesskey "C"> -</pre> -<p>Затем, подключаете его в верхней части вашего XUL документа ( сразу под строкой ), вот так::</p> -<pre class="eval"><!DOCTYPE <strong>window</strong> SYSTEM "<a class="external" rel="freelink">chrome://packagename/locale/filename.ent</a>"> -</pre> -<p>где <code><strong>window</strong></code> это <code><a href="/en/DOM/element.localName" title="en/DOM/element.localName">localName</a></code> значение, которое является корневым элементом вашего XUL документа, и свойство <code>SYSTEM</code> значение которого chorm URI к файлу с сущностями. Для примера нашего расширения, мы используем корневой элемент <code><strong>overlay</strong></code>.</p> -<p>Для использования сущностей измените ваш XUL, что бы он выглядел так:</p> -<pre class="eval"><button label="&button.label;" accesskey="&button.accesskey;"/> -</pre> -<p>Chrome реестр всегда будет загружать тот файл с сущностями, который соответствует текущей выбранной локализации.</p> -<p>Для строк которые вы используете в сценарии (скрипте), создайте файл .properties, текстовый файл который будет содержать строки в таком формате:</p> -<pre class="eval">key=value -</pre> -<p>а, затем используйте <code><a href="/en/NsIStringBundleService" title="en/NsIStringBundleService">nsIStringBundleService</a></code>/<code><a href="/en/nsIStringBundle" title="en/nsIStringBundle">nsIStringBundle</a></code> или тег <code><a class="external" href="http://xulplanet.com/references/elemref/ref_stringbundle.html"><stringbundle></a></code>, чтобы получить значения в сценарии (скрипте).</p> -<h2 id="Understanding_the_Browser" name="Understanding_the_Browser">Understanding the Browser</h2> -<p>Use the <a href="/en/DOM_Inspector" title="en/DOM_Inspector">DOM Inspector</a> to inspect the browser window or any other XUL window you want to extend.</p> -<p><strong>Примечание:</strong> <strong>DOM Inspector</strong> не устанавливается в режиме <strong>стандартной</strong> установки Firefox. Начиная с версии Firefox 3 Beta 4, DOM Inspector доступен с сайта <a class="link-https" href="https://addons.mozilla.org/en-US/firefox/addon/6622">Firefox Add-ons</a>, как автономное расширение. Для более ранних версий, вам необходимо переустановить FireFox в режиме Пользовательской установки и выбрать путь к DOM Inspector(или <strong>Developer Tools</strong> в Firefox 1.5), если DOM Inspector'a нет в меню Инструменты (Tools) в вашего браузера.</p> -<p>Используйте кнопку <img alt="Point-and-click icon" src="https://mdn.mozillademos.org/files/8571/point-and-click.png" style="width: 17px; height: 17px;"> в верхнем правом углу панели инструментов DOM Inspector для визуального выбора интересующего элемента в окне XUL. После выбора элемента, в окне DOM inspector появится DOM иерархия интересующего вас элемента.</p> -<p><span style="line-height: 1.5;">Use the DOM Inspector's right side panel to discover merge points with ids that you can use to insert your elements from overlays. If you cannot discover an element with an id that you can merge into, you may need to attach a script in your overlay and insert your elements when the </span><code style="font-style: normal; line-height: 1.5;">load</code><span style="line-height: 1.5;"> event fires on the master XUL window.</span></p> -<h2 id="Debugging_Extensions" name="Debugging_Extensions">Debugging Extensions</h2> -<p><strong>Analytical Tools for Debugging</strong></p> -<ul> - <li>The <a href="/en/DOM_Inspector" title="en/DOM_Inspector">DOM Inspector</a> - inspect attributes, DOM structure, CSS style rules that are in effect (e.g. find out why your style rules don't seem to be working for an element - an invaluable tool!)</li> - <li><a href="/en/Venkman" title="en/Venkman">Venkman</a> - set breakpoints in JavaScript and inspect call stacks</li> - <li><code><a href="/En/Core_JavaScript_1.5_Reference/Functions_and_function_scope/arguments/callee" title="en/Core_JavaScript_1.5_Reference/Functions/arguments/callee">arguments.callee</a>.<a href="/en/Core_JavaScript_1.5_Reference/Global_Objects/Function/caller" title="en/Core_JavaScript_1.5_Reference/Global_Objects/Function/caller">caller</a></code> in JavaScript - access a function's call stack</li> -</ul> -<p><strong>printf debugging</strong></p> -<ul> - <li>Use <code><a href="/en/DOM/window.dump" title="en/DOM/window.dump">dump</a>("string")</code> (see the link for details; this requires a bit of configuration to work properly)</li> - <li>Use <code><a href="/en/Components.utils.reportError" title="en/Components.utils.reportError">Components.utils.reportError()</a></code> or <code><a href="/en/nsIConsoleService" title="en/nsIConsoleService">nsIConsoleService</a></code> to log to the JavaScript console</li> -</ul> -<p><strong>Advanced debugging</strong></p> -<ul> - <li>Run a debug Firefox build and set breakpoints in Firefox itself, or your C++ components. For the experienced developer, this is often the fastest way to diagnose a problem. See <a href="/en/Build_Documentation" title="en/Build_Documentation">Build Documentation</a> and <a href="/en/Developing_Mozilla" title="en/Developing_Mozilla">Developing Mozilla</a> for more information.</li> - <li>See <a href="/en/Debugging_a_XULRunner_Application" title="en/Debugging_a_XULRunner_Application">Debugging a XULRunner Application</a> for more helpful tips.</li> -</ul> -<h3 id="Quick_Start" name="Quick_Start">Быстрый старт</h3> -<p>Вы можете использовать <a class="external" href="http://ted.mielczarek.org/code/mozilla/extensionwiz/">Extension Wizard</a>, инструмент для создания простых Расширений.</p> -<p>A <a class="external" href="http://mozilla.doslash.org/stuff/helloworld.zip">Hello World extension</a> similar to what you can generate with the Extension Wizard is explained line-by-line in <a class="external" href="http://kb.mozillazine.org/Getting_started_with_extension_development">another tutorial from MozillaZine Knowledge Base</a>.</p> -<h3 id="Further_information" name="Further_information">Further information</h3> -<ul> - <li><a href="/en/Extension_Frequently_Asked_Questions" title="en/Extension_Frequently_Asked_Questions">Extension FAQ</a></li> - <li><a href="/en/Extensions" title="en/Extensions">Extensions</a></li> -</ul> diff --git a/files/ru/conflicting/mozilla/firefox/releases/index.html b/files/ru/conflicting/mozilla/firefox/releases/index.html deleted file mode 100644 index 13789bf239..0000000000 --- a/files/ru/conflicting/mozilla/firefox/releases/index.html +++ /dev/null @@ -1,129 +0,0 @@ ---- -title: Замечания к релизу -slug: conflicting/Mozilla/Firefox/Releases -translation_of: Mozilla/Firefox/Releases -translation_of_original: Tools/Release_notes -original_slug: Tools/Release_notes ---- -<div>{{ToolsSidebar}}</div><h2 id="Firefox_48">Firefox 48</h2> - -<p>Главное:</p> - -<ul> - <li><a href="/en-US/docs/Tools/Storage_Inspector#Editing_storage_items">Редактирование сохранённых вещей в инспекторе хранилища</a></li> - <li><a href="/en-US/docs/Tools/Memory/Tree_Map_view">Утилита для просмотра дерева памяти</a></li> - <li><a href="/en-US/docs/Tools/Page_Inspector/How_to/Reposition_elements_in_the_page">Перемещение элементов по странице путём перетаскивания</a></li> - <li><a href="/en-US/docs/Tools/Web_Console/Console_messages#Viewing_network_request_details">Просмотр деталей HTTP запросов в консоли веб</a></li> - <li><a href="/en-US/docs/Tools/Page_Inspector/How_to/Work_with_animations#Animation_inspector">Инспектор анимации для Web Animations API</a></li> - <li><a href="/en-US/docs/Tools/Settings#Choose_DevTools_theme">Тема Firebug</a></li> - <li><a href="/en-US/docs/Tools/DOM_Property_Viewer">Утилита для просмотра свойств DOM</a></li> -</ul> - -<p><a href="https://bugzilla.mozilla.org/buglist.cgi?resolution=FIXED&classification=Client%20Software&chfieldto=2016-04-25&query_format=advanced&chfield=resolution&chfieldfrom=2016-03-07&chfieldvalue=FIXED&bug_status=RESOLVED&bug_status=VERIFIED&component=Developer%20Tools&component=Developer%20Tools%3A%203D%20View&component=Developer%20Tools%3A%20about%3Adebugging&component=Developer%20Tools%3A%20Animation%20Inspector&component=Developer%20Tools%3A%20Canvas%20Debugger&component=Developer%20Tools%3A%20Computed%20Styles%20Inspector&component=Developer%20Tools%3A%20Console&component=Developer%20Tools%3A%20CSS%20Rules%20Inspector&component=Developer%20Tools%3A%20Debugger&component=Developer%20Tools%3A%20Font%20Inspector&component=Developer%20Tools%3A%20Framework&component=Developer%20Tools%3A%20Graphic%20Commandline%20and%20Toolbar&component=Developer%20Tools%3A%20Inspector&component=Developer%20Tools%3A%20JSON%20Viewer&component=Developer%20Tools%3A%20Memory&component=Developer%20Tools%3A%20Netmonitor&component=Developer%20Tools%3A%20Object%20Inspector&component=Developer%20Tools%3A%20Performance%20Tools%20%28Profiler%2FTimeline%29&component=Developer%20Tools%3A%20Responsive%20Mode&component=Developer%20Tools%3A%20Scratchpad&component=Developer%20Tools%3A%20Source%20Editor&component=Developer%20Tools%3A%20Storage%20Inspector&component=Developer%20Tools%3A%20Style%20Editor&component=Developer%20Tools%3A%20User%20Stories&component=Developer%20Tools%3A%20Web%20Audio%20Editor&component=Developer%20Tools%3A%20WebGL%20Shader%20Editor&component=Developer%20Tools%3A%20WebIDE&product=Firefox&list_id=12832440">Другие исправления багов</a></p> - -<h2 id="Firefox_32">Firefox 32</h2> - -<p>Highlights:</p> - -<ul> - <li><a href="/ru/docs/Tools/Web_Audio_Editor">Web Audio Editor</a></li> - <li><a href="/ru/docs/Tools/Scratchpad#Code_completion_and_inline_documentation">Code completion and inline documentation in Scratchpad</a></li> - <li><a href="/ru/docs/Tools/Page_Inspector#Rules_view">User agent styles in the Inspector's Rules view</a></li> - <li><a href="/ru/docs/Tools/Page_Inspector#Firefox_32_onwards_2">Element picker button has moved</a></li> - <li><a href="/ru/docs/Tools/Page_Inspector#Firefox_32_onwards">Node dimensions added to the Inspector's infobar</a></li> - <li><a href="/ru/docs/Tools/Tools_Toolbox#Extra_tools">Full page screenshot button added</a></li> -</ul> - -<p>More details:</p> - -<ul> - <li>HiDPI images added to the tools</li> - <li>Nodes that have <code>display:none</code> are shown differently in the Inspector</li> -</ul> - -<p><a href="https://bugzilla.mozilla.org/buglist.cgi?resolution=FIXED&classification=Client%20Software&chfieldto=2014-06-09&chfield=resolution&query_format=advanced&chfieldfrom=2014-04-28&chfieldvalue=FIXED&bug_status=RESOLVED&bug_status=VERIFIED&component=Developer%20Tools&component=Developer%20Tools%3A%203D%20View&component=Developer%20Tools%3A%20App%20Manager&component=Developer%20Tools%3A%20Canvas%20Debugger&component=Developer%20Tools%3A%20Console&component=Developer%20Tools%3A%20Debugger&component=Developer%20Tools%3A%20Framework&component=Developer%20Tools%3A%20Graphic%20Commandline%20and%20Toolbar&component=Developer%20Tools%3A%20Inspector&component=Developer%20Tools%3A%20Memory&component=Developer%20Tools%3A%20Netmonitor&component=Developer%20Tools%3A%20Object%20Inspector&component=Developer%20Tools%3A%20Profiler&component=Developer%20Tools%3A%20Responsive%20Mode&component=Developer%20Tools%3A%20Scratchpad&component=Developer%20Tools%3A%20Source%20Editor&component=Developer%20Tools%3A%20Style%20Editor&component=Developer%20Tools%3A%20User%20Stories&component=Developer%20Tools%3A%20WebGL%20Shader%20Editor&product=Firefox">All devtools bugs fixed between Firefox 31 and Firefox 32</a>.</p> - -<h2 id="Firefox_31">Firefox 31</h2> - -<p>Highlights:</p> - -<ul> - <li><a href="https://developer.mozilla.org/ru/docs/Tools/Eyedropper">Eyedropper tool to select colors in web pages</a></li> - <li><a href="https://developer.mozilla.org/ru/docs/Tools/Web_Console#Error_messages">full stack traces for console error messages</a></li> - <li><a href="https://developer.mozilla.org/ru/docs/Tools/Page_Inspector#Box_model_view">editable Box Model View</a></li> - <li><a href="https://developer.mozilla.org/ru/docs/Tools/Web_Console#Styling_messages">%c formatting to style console messages</a></li> - <li><a href="https://developer.mozilla.org/ru/docs/Tools/Network_Monitor#Copy_as_cURL">"copy as cURL" command in Network Monitor</a></li> - <li><a href="https://developer.mozilla.org/ru/docs/tools/Keyboard_shortcuts#Source_editor">Sublime Text keybindings in the source editor</a></li> -</ul> - -<p>More details:</p> - -<ul> - <li><a href="/ru/docs/Tools/Network_Monitor#Network_request_list">Option to make Network Monitor logs persistent</a></li> - <li><a href="/ru/docs/Tools/Web_Console#JavaScript_errors_and_warnings">JavaScript warnings on by default in the Web Console</a></li> - <li><a href="/ru/docs/Tools/Page_Inspector#HTML_pane_2">Alt+click to expand all descendants of a node</a></li> -</ul> - -<p><a href="https://bugzilla.mozilla.org/buglist.cgi?resolution=FIXED&classification=Client%20Software&chfieldto=2014-04-28&chfield=resolution&query_format=advanced&chfieldfrom=2014-03-17&chfieldvalue=FIXED&bug_status=RESOLVED&bug_status=VERIFIED&component=Developer%20Tools&component=Developer%20Tools%3A%203D%20View&component=Developer%20Tools%3A%20App%20Manager&component=Developer%20Tools%3A%20Canvas%20Debugger&component=Developer%20Tools%3A%20Console&component=Developer%20Tools%3A%20Debugger&component=Developer%20Tools%3A%20Framework&component=Developer%20Tools%3A%20Graphic%20Commandline%20and%20Toolbar&component=Developer%20Tools%3A%20Inspector&component=Developer%20Tools%3A%20Memory&component=Developer%20Tools%3A%20Netmonitor&component=Developer%20Tools%3A%20Object%20Inspector&component=Developer%20Tools%3A%20Profiler&component=Developer%20Tools%3A%20Responsive%20Mode&component=Developer%20Tools%3A%20Scratchpad&component=Developer%20Tools%3A%20Source%20Editor&component=Developer%20Tools%3A%20Style%20Editor&component=Developer%20Tools%3A%20User%20Stories&component=Developer%20Tools%3A%20WebGL%20Shader%20Editor&product=Firefox&list_id=10022921">All devtools bugs fixed between Firefox 30 and Firefox 31</a>.</p> - -<h2 id="Firefox_30">Firefox 30</h2> - -<p>Highlights:</p> - -<ul> - <li><a href="https://www.youtube.com/watch?v=y2LcsxE2pR0">Box model highlighting in the Page Inspector</a></li> - <li><a href="/ru/docs/Tools/Web_Console#Working_with_iframes">Web Console support for executing JS in frames</a></li> - <li>Web Console display improvements: code highlighting, <a href="/ru/docs/Tools/Web_Console#Highlighting_and_inspecting_nodes">node highlighting and inspection</a></li> - <li>Network Monitor theme improvements, <a href="/ru/docs/Tools/Network_Monitor#Network_request_fields">image thumbnails, image preview</a>, <a href="/ru/docs/Tools/Network_Monitor#Preview">HTML preview</a></li> - <li><a href="/ru/docs/Tools/Browser_Console#Browser_Console_command_line">Browser Console input must now be enabled in Settings</a></li> - <li><a href="/ru/docs/Tools_Toolbox#Available_Toolbox_Buttons">Icons for Scratchpad and other tools now hidden by default</a></li> -</ul> - -<p>More details:</p> - -<ul> - <li>Support for <a href="/ru/docs/Web/API/console.count">console.count()</a></li> - <li><a href="/ru/docs/Tools/Web_Console#Keyboard_shortcuts">New shortcut key to focus on web console command line</a></li> - <li><a href="/ru/docs/Tools/Page_Inspector#font-family_tooltip">Font family tooltip in the Inspector</a></li> - <li><a href="/ru/Firefox_OS/Debugging/Developer_settings#Developer_HUD">Firefox OS HUD</a> features: memory tracking and jank monitor</li> -</ul> - -<p><a href="https://bugzilla.mozilla.org/buglist.cgi?resolution=FIXED&classification=Client%20Software&chfieldto=2014-03-17&chfield=resolution&query_format=advanced&chfieldfrom=2014-02-03&chfieldvalue=FIXED&bug_status=RESOLVED&bug_status=VERIFIED&component=Developer%20Tools&component=Developer%20Tools%3A%203D%20View&component=Developer%20Tools%3A%20App%20Manager&component=Developer%20Tools%3A%20Canvas%20Debugger&component=Developer%20Tools%3A%20Console&component=Developer%20Tools%3A%20Debugger&component=Developer%20Tools%3A%20Framework&component=Developer%20Tools%3A%20Graphic%20Commandline%20and%20Toolbar&component=Developer%20Tools%3A%20Inspector&component=Developer%20Tools%3A%20Memory&component=Developer%20Tools%3A%20Netmonitor&component=Developer%20Tools%3A%20Object%20Inspector&component=Developer%20Tools%3A%20Profiler&component=Developer%20Tools%3A%20Responsive%20Mode&component=Developer%20Tools%3A%20Scratchpad&component=Developer%20Tools%3A%20Source%20Editor&component=Developer%20Tools%3A%20Style%20Editor&component=Developer%20Tools%3A%20User%20Stories&component=Developer%20Tools%3A%20WebGL%20Shader%20Editor&product=Firefox&list_id=9755315">All devtools bugs fixed between Firefox 29 and Firefox 30</a>.</p> - -<h2 id="Firefox_29">Firefox 29</h2> - -<p><a href="https://hacks.mozilla.org/2014/02/css-source-map-support-network-performance-analysis-more-firefox-developer-tools-episode-29/" title="http://www.mozilla.org/ru/firefox/aurora/">Firefox 29 Hacks post</a>. Highlights:</p> - -<ul> - <li><a href="/ru/docs/Tools_Toolbox#Choose_DevTools_theme">Theme improvements</a>, including major updates to the light theme</li> - <li><a href="/ru/docs/Tools/Network_Monitor#Performance_analysis">Network Monitor performance analysis tool</a></li> - <li><a href="/ru/docs/Tools/Style_Editor#Source_map_support">CSS source maps</a></li> - <li><a href="/ru/docs/Tools/Page_Inspector#Selecting_elements">Changes in the way node selection works in the Inspector</a></li> - <li><a href="/ru/docs/Tools/Debugger#Call_stack_pane">Classic call stack</a> for the Debugger, and added the ability to <a href="/ru/docs/Tools/Debugger#Highlight_and_inspect_DOM_nodes">highlight and inspect nodes</a></li> - <li><a href="/ru/docs/Tools/Using_the_Source_Editor#See_also">Emacs and Vim keybindings in the source editor</a></li> -</ul> - -<h2 id="Firefox_28">Firefox 28</h2> - -<p><a href="https://hacks.mozilla.org/2013/12/split-console-pretty-print-minified-js-and-more-firefox-developer-tools-episode-28/" title="Aurora Hacks post">Firefox 28 Hacks post</a>. Highlights:</p> - -<ul> - <li>The App Manager has an integrated <a href="/ru/Firefox_OS/Using_the_App_Manager#Manifest_editor">manifest editor</a></li> - <li>The <a href="/ru/docs/Tools/Web_Console#The_split_console">Split Console</a> feature enables you to use the Web Console and another developer tool side by side</li> - <li><a href="/ru/docs/Tools/Debugger#Pretty-print_a_minified_file">Pretty-print minified JavaScript</a> in the Debugger</li> - <li><a href="/ru/docs/Tools/Page_Inspector#Rules_view">Color picker tooltip</a> in the Inspector</li> - <li><a href="/ru/docs/Tools/Browser_Toolbox">Browser Toolbox</a> for debugging platform or add-on code</li> -</ul> - -<h2 id="Firefox_27">Firefox 27</h2> - -<p><a href="https://hacks.mozilla.org/2013/11/firefox-developer-tools-episode-27-edit-as-html-codemirror-more/">Firefox 27 Hacks post</a>. Highlights:</p> - -<ul> - <li><a href="/ru/docs/Tools/Shader_Editor">Редактор шейдеров</a> позволяет просматривать и редактировать шейдеры WebGL</li> - <li>Возможность поставить точку остановки в дебаггере на определённое <a href="/ru/docs/Tools/Debugger#Break_on_a_DOM_event">DOM событие</a> которое вам нужно отловить</li> - <li><a href="/ru/docs/Tools/Page_Inspector#Editing_HTML">Редактирование HTML в Инспекторе</a></li> - <li>See color swatches and background images in the Inspector's <a href="/ru/docs/Tools/Page_Inspector#Rules_view">Rules view</a></li> - <li>The Web Веб консольConsole now <a href="/ru/docs/Tools/Web_Console#Reflow_events">logs reflow events</a></li> - <li>CodeMirror is now used as the source editor in many tools</li> -</ul> diff --git a/files/ru/conflicting/tools/performance/index.html b/files/ru/conflicting/tools/performance/index.html deleted file mode 100644 index 6b578829f1..0000000000 --- a/files/ru/conflicting/tools/performance/index.html +++ /dev/null @@ -1,170 +0,0 @@ ---- -title: Профилирование JavaScript -slug: conflicting/Tools/Performance -tags: - - Firefox - - Отладка - - Профайлер - - Профилирование - - Руководство - - инструменты -translation_of: Tools/Performance -translation_of_original: Tools/Profiler -original_slug: Tools/Profiler ---- -<div>{{ToolsSidebar}}</div><p>Используйте средства профилирования, чтобы находить узкие места в своём JavaScript коде. Профайлер периодически проверяет состояние стека вызовов JavaScript и составляет статистику на основе полученных в результате измерения величин.</p> - -<p>Вы можете запустить профайлер выбрав «Profiler» из меню «Web Develeper». Для операционных систем Linux и OS X данное меню находится в меню «Tools», в Windows его можно вызвать из меню «Firefox».</p> - -<p>В открывшемся меню уже будет выбран профайлер.</p> - -<p> </p> - -<h2 id="Семплирующие_профайлеры"><a name="sampling-profilers">Семплирующие профайлеры</a></h2> - -<p> </p> - -<p>Профайлер JavaScript — сэмплирующий профайлер. Это означает, что он периодически собирает информацию о состоянии интерпретатора JavaScript, сохраняет стек выполняющегося на момент сэмплирования кода. Статистически, число образцов полученных во время выполнения какой-либо функции, соответствует количеству времени, которое браузер проводит выполняя её, таким образом вы можете находить узкие места в своём коде.</p> - -<p><a name="profiling-example">Рассмотрим следующую программу в качестве примера:</a></p> - -<pre class="brush: js">function doSomething() { - var x = getTheValue(); - x = x + 1; // -> sample A - logTheValue(x); -} - -function getTheValue() { - return 5; -} - -function logTheValue(x) { - console.log(x); // -> sample B, sample C -} - -doSomething();</pre> - -<p>Допустим мы запустили данную программу с активным профайлером, и во время её выполнения, профайлер взял три сэмпла, в местах указанных комментариями.</p> - -<p>Они все взяты внутри doSomething(), но вторые два внутри функции logTheValue() вызванной doSomething(). В результате получим профиль состоящий из трёх записей:</p> - -<pre>Sample A: doSomething() -Sample B: doSomething() > logTheValue() -Sample C: doSomething() > logTheValue()</pre> - -<p>Конечно этих данных недостаточно, чтобы сделать какие-то выводы, но с гораздо большим количеством сэмплов, мы поймём, что узким местом в нашей программе является logTheValue().</p> - -<p> </p> - -<h2 id="Создание_профиля">Создание профиля</h2> - -<p>Нажмите кнопку <em>stopwatch</em> в профайлере, чтобы начать сбор сэмплов. Кнопка <em>stopwatch</em> подсвечена, если профайлер активен. Кликните на ней ещё раз и сохраните новый профиль:</p> - -<p> </p> - -<p style="text-align: center;"><img alt="" src="https://mdn.mozillademos.org/files/5977/Screen%20Shot%202013-08-26%20at%2010.35.47%20AM.png"></p> - -<p>Новый профиль будет открыт автоматически при нажатии "Stop".</p> - -<p><img alt="" src="https://mdn.mozillademos.org/files/5981/Screen%20Shot%202013-08-26%20at%2011.07.18%20AM.png" style="display: block; margin-left: auto; margin-right: auto;"></p> - -<p>Панель разделена на две части:</p> - -<ul> - <li>Левая сторона содержит список всех записанных профилей и позволяет загрузить любой из них. Ниже находятся две кнопки: <em>stopwatch</em> позволяет записать новый профиль, в то время как<em> import... </em>позволяет импортировать ранее сохранённые данные. Когда профиль выбран, вы можете сохранить его данные как файл в формате JSON нажав на кнопке <em>Save</em>.</li> - <li>Правая сторона показывает текущий загруженный профиль.</li> -</ul> - -<p> </p> - -<h2 id="Анализируем_профиль">Анализируем профиль</h2> - -<p> </p> - -<p>Профиль разделён на две части:</p> - -<ul> - <li><a href="#profile-timeline" title="#profile-timeline">График профилирования (profile timeline</a>)</li> - <li><a href="#profile-details" title="#profile-details">Детали профилирования (profile details</a>)</li> -</ul> - -<h3 id="График_профилирования"><a id="profile-timeline" name="profile-timeline">График профилирования</a></h3> - -<p>График профилирования располагается в верхней части экрана профиля.</p> - -<p><img alt="" src="https://mdn.mozillademos.org/files/5987/timeline" style="display: block; margin-left: auto; margin-right: auto;"></p> - -<p>Горизонтальная ось это время, а вертикальная — размер стека вызовов на текущий сэмпл. Стек вызовов представляет количество активных функций на момент сэмплирования.<br> - Красные сэмплы на графике говорят о том, что браузер был недоступен на тот момент и пользователь мог наблюдать паузы в анимации и отклике браузера. Если профиль содержит красные образцы, их следует разбить на несколько событий и рассмотреть используя <a href="/en-US/docs/Web/API/window.requestAnimationFrame" title="/en-US/docs/Web/API/window.requestAnimationFrame">requestAnimationFrame</a> и <a href="/en-US/docs/Web/Guide/Performance/Using_web_workers" title="/en-US/docs/Web/Guide/Performance/Using_web_workers">Workers</a>.</p> - -<p>Подсветив определённый участок в профиле рамкой, можно исследовать его более детально:</p> - -<p><img alt="" src="https://mdn.mozillademos.org/files/5989/Screen%20Shot%202013-08-26%20at%2011.17.59%20AM.png" style="display: block; margin-left: auto; margin-right: auto;"></p> - -<p>В таком случае, над графиком появится новая кнопка с надписью вида: "Sample Range [AAA, BBB]". Нажав на неё, можно приблизить рассматриваемый участок и детально его рассмотреть.</p> - -<p><img alt="" src="https://mdn.mozillademos.org/files/5991/Screen%20Shot%202013-08-26%20at%2011.18.03%20AM.png" style="display: block; margin-left: auto; margin-right: auto;"></p> - -<h3 id="Детали_профилирования"><a name="profile-details">Детали профилирования</a></h3> - -<p>Детали профилирования расположены в нижней части экрана профиля:</p> - -<p><img alt="" src="https://mdn.mozillademos.org/files/5993/profiler-details-highligted.png" style="display: block; margin-left: auto; margin-right: auto;"></p> - -<p>Когда вы впервые открываете новый сэмпл, панель сэмплов содержит единственную строку «(total)», как на скриншоте ниже. Если кликнуть на стрелке следующей за надписью «(total)», вы увидите список всех функций верхнего уровня которые находятся в сэмпле.</p> - -<p><br> - <img alt="" src="https://mdn.mozillademos.org/files/5995/Screen%20Shot%202013-08-26%20at%2011.22.10%20AM.png"></p> - -<p>Время выполнения (<strong>Running time</strong>) показывает число сэмплов в которых присутствует данная функция<a href="#footnote-1"><sup>1</sup></a> , далее следует процент появления функции в остальных сэмплах профиля. Первая сверху строка показывает, что в профиле 2021 сэмпл, вторая строка показывает, что 1914 или 94.7% из них содержат в себе функцию detectImage().</p> - -<p><strong>Self</strong> показывает количество сэмплов полученное во время выполнения самой функции, а не функции её вызвавшей. В <a href="#profiling-example" title="#profiling-example">примере</a> выше doSomething() имеет время выполнения (<strong>Running time</strong>) равное 3 (сэмпл A, B и C), но значение <strong>Self</strong> равно единице (sample A).</p> - -<p>Третий столбец содержит имена функций, а также имена файлов и номера строк (для локальных функций) или полное/доменное имя (для внешних). Функции серого цвета — встроенные функции браузера, чёрные — JavaScript загруженный страницей. Если вы переместите курсор мыши вдоль строк, то обнаружите справа от имён функций стрелочку: кликните по ней и увидите исходный код функции.</p> - -<p> </p> - -<h3 id="Раскрываем_древо_вызовов">Раскрываем древо вызовов</h3> - -<p> </p> - -<p>В строке, если какие-либо сэмплы были взяты в функции вызванной другой функцией (т. е. Если время выполнения (<strong>Running time</strong>) больше чем <strong>Self</strong> для заданной строки) — появляется стрелочка слева от имени функции, дающая возможность раскрыть древо вызовов.</p> - -<p>Для <a href="#profiling-example" title="#profiling-example">примера</a> приведённого выше, полностью раскрытое древо вызовов будет выглядеть следующим образом:</p> - -<table class="standard-table"> - <tbody> - <tr> - <td style="text-align: center;"><strong>Running Time</strong></td> - <td style="text-align: center;"><strong>Self</strong></td> - <td style="text-align: center;"> </td> - </tr> - <tr> - <td style="text-align: center;">3 100%</td> - <td style="text-align: center;">1</td> - <td style="text-align: center;">doSomething()</td> - </tr> - <tr> - <td style="text-align: center;">2 67%</td> - <td style="text-align: center;">2</td> - <td style="text-align: center;">logTheValue()</td> - </tr> - </tbody> -</table> - -<p>Более реалистичный пример: на скриншоте ниже, на второй строке видно 1914 сэмпла взятых внутри функции detectImage(). Но все сэмплы были получены внутри функции названной detectImage() (<strong>Self</strong> равно нулю). Мы можем развернуть древо вызовов чтобы определить какая из функций на самом деле выполнялась когда было взято большинство сэмплов:</p> - -<p><img alt="" src="https://mdn.mozillademos.org/files/5999/bla.png" style="display: block; margin-left: auto; margin-right: auto;"></p> - -<p>Далее можно сделать вывод, что 6 сэмплов было взято во время выполнения detectAtScale(), 12 во время getRect() и так далее.</p> - -<p>Примечания</p> - -<ol> - <li><a name="footnote-1"> </a>Если функция вызывается несколько раз из различных источников, в выводе профайлера представлена она будет так же несколько раз. Так структуры вроде forEach будут появляться несколько раз в древе вызовов. - - <p> </p> - </li> -</ol> - -<p> </p> diff --git a/files/ru/conflicting/web/accessibility/index.html b/files/ru/conflicting/web/accessibility/index.html deleted file mode 100644 index 93cd4b80cb..0000000000 --- a/files/ru/conflicting/web/accessibility/index.html +++ /dev/null @@ -1,52 +0,0 @@ ---- -title: Веб-разработка -slug: conflicting/Web/Accessibility -tags: - - ARIA - - Web Development - - XUL - - доступность -translation_of: Web/Accessibility -translation_of_original: Web/Accessibility/Web_Development -original_slug: Web/Accessibility/Веб-разработка ---- -<p class="summary"><span class="seoSummary">Здесь ссылки на более подробную информацию для разработчиков о доступности (<span lang="en">accessibility</span>) в Веб и в XUL.</span></p> - -<table> - <tbody> - <tr> - <td style="vertical-align: top;"> - <h2 id="Доступность_в_Вебе">Доступность в Вебе</h2> - - <dl> - <dt><a href="/ru/docs/Accessibility/ARIA" title="http://developer.mozilla.org/ru/docs/Accessibility/ARIA">ARIA для разработчиков</a></dt> - <dd style="">ARIA позволяет делать доступным динамический HTML-контент. Examples are live content regions and JavaScript widgets.</dd> - <dt><a href="/ru/Accessibility/Keyboard-navigable_JavaScript_widgets" title="en/Accessibility/Keyboard-navigable JavaScript widgets">Keyboard-navigable JavaScript widgets</a></dt> - <dd>До недавнего времени у веб-разработчиков, желавших сделать свои виджеты на основе <div>, <span> и стилей доступными с клавиатуры, не было the proper techniques. Управляемость с клавиатуры — одно из минимальных требований accessibility, о которых должен знать каждый разработчик.</dd> - </dl> - - <h2 id="Доступность_XUL">Доступность XUL</h2> - - <dl> - <dt> </dt> - <dt><a href="/ru/Building_accessible_custom_components_in_XUL" title="en/Building_accessible_custom_components_in_XUL">Building accessible custom components in XUL</a></dt> - <dd>How to use DHTML Accessibility techniques to add accessibility to your custom XUL components.</dd> - <dt><a href="/ru/XUL_accessibility_guidelines" title="ru/XUL_accessibility_guidelines">Accessible XUL authoring guidelines</a></dt> - <dd>When authored according to these guidelines, XUL is capable of generating accessible user interfaces. Coders, reviewers, designers and QA engineers should be familiar with these guidelines.</dd> - </dl> - </td> - <td style="vertical-align: top;"> - <h2 id="Внешние_ресурсы">Внешние ресурсы</h2> - - <dl> - <dt><a class="external" href="http://diveintoaccessibility.info/">Dive into Accessibility</a></dt> - <dd><small>Эта книга отвечает на два вопроса. Первый — «Зачем мне делать мой сайт более доступным?» Второй — «Как мне сделать мой сайт более доступным?»</small></dd> - <dt><a class="external" href="http://www-306.ibm.com/able/guidelines/web/accessweb.html">Accessible Web Page Authoring</a></dt> - <dd>A handy web accessibility checklist, from IBM.</dd> - </dl> - </td> - </tr> - </tbody> -</table> - -<p> </p> diff --git a/files/ru/conflicting/web/api/canvas_api/a_basic_ray-caster/index.html b/files/ru/conflicting/web/api/canvas_api/a_basic_ray-caster/index.html deleted file mode 100644 index b96f0a95a3..0000000000 --- a/files/ru/conflicting/web/api/canvas_api/a_basic_ray-caster/index.html +++ /dev/null @@ -1,51 +0,0 @@ ---- -title: A Basic RayCaster -slug: conflicting/Web/API/Canvas_API/A_basic_ray-caster -tags: - - Canvas_examples -original_slug: A_Basic_RayCaster ---- -<p> </p> - -<p><img alt="The raycaster in action"></p> - -<p><strong><a class="external" href="http://developer.mozilla.org/samples/raycaster/RayCaster.html">View the live demo.</a></strong></p> - -<h3 id="Why.3F" name="Why.3F">Why?</h3> - -<p>After realizing, to my delight, that the nifty <code><canvas></code> element I'd been <a class="external" href="http://www.whatwg.org/specs/web-apps/current-work/#dynamic">reading about</a> was not only soon to be supported in Firefox, but was<em>already</em> supported in the current version of Safari, I had to try a little experiment.</p> - -<p>The canvas <a href="ru/Drawing_Graphics_with_Canvas">overview</a> and <a href="ru/Canvas_tutorial">tutorial</a> I found here at MDC are great, but nobody had written about animation yet, so I thought I'd try a port of a basic raycaster I'd worked on a while ago, and see what sort of performance we can expect from a javascript controlled pixel buffer.</p> - -<h3 id="How.3F" name="How.3F">How?</h3> - -<p>The basic idea is to use <code><a href="ru/DOM/window.setInterval">setInterval</a></code> at some arbitrary delay that corresponds to a desired frame rate. After every interval an update function will repaint the canvas showing the current view. I know I could have started with a simpler example, but I'm sure the canvas tutorial will <a href="ru/Canvas_tutorial/Basic_animations">get to that</a>, and I wanted to see if I could do this.</p> - -<p>So every update, the raycaster looks to see if you've pressed any keys lately, to conserve calculations by not casting if you're idle. If you have, then the canvas is cleared, the ground and sky are drawn, the camera position and / or orientation are updated and the rays are cast out. As the rays intersect walls, then they render a vertical sliver of canvas in the color of the wall they've hit, blended with a darker version of the color according to the distance to the wall. The height of the sliver is also modulated by the distance from the camera to the wall, and is drawn centered over the horizon line.</p> - -<p>The code I ended up with is a regurgitated amalgam of the raycaster chapters from an old André LaMothe<em>Tricks of the Game Programming Gurus</em> book (<small>ISBN: 0672305070</small>), and a <a class="external" href="http://www.shinelife.co.uk/java-maze/">java raycaster</a> I found online, filtered through my compulsion to rename everything so it makes sense to me, and all the tinkering that had to be done to make things work well.</p> - -<h3 id="Results" name="Results">Results</h3> - -<p>The canvas in Safari 2.0.1 performed suprisingly well. With the blockiness factor cranked up to render slivers 8 pixels wide, I can run a 320 x 240 window at 24 fps on my Apple mini. Firefox 1.5 Beta 1 is even faster; I can run 320 x 240 at 24 fps with 4 pixel slivers. Not exactly a new member of the ID software family, but pretty decent considering it's a fully interpreted environment, and I didn't have to worry about memory allocation or video modes or coding inner routines in assembler or anything. The code does attempt to be very efficient, using array look-ups of pre-computed values, but I'm no optimization guru, so things could probably be written faster.</p> - -<p>Also, it leaves a lot to be desired in terms of trying to be any sort of game engine—there are no wall textures, no sprites, no doors, not even any teleporters to get to another level. But I'm pretty confident all those things could be added given enough time. The canvas API supports pixel copying of images, so textures seem feasible. I'll leave that for another article, probably from another person. =)</p> - -<h3 id="The_RayCaster" name="The_RayCaster">The RayCaster</h3> - -<p>The nice people here have manually copied my files up so you can take a <a class="external" href="http://developer.mozilla.org/samples/raycaster/RayCaster.html">look</a>, and for your hacking enjoyment I've posted the individual file contents as code listings (see below).</p> - -<p>So there you are, fire up Safari 1.3+ or Firefox 1.5+ or some other browser that supports the <code><canvas></code> element and enjoy!<br> - <br> - <small><a href="ru/A_Basic_RayCaster/input.js">input.js</a> | <a href="ru/A_Basic_RayCaster/Level.js">Level.js</a> | <a href="ru/A_Basic_RayCaster/Player.js">Player.js</a> | <a href="ru/A_Basic_RayCaster/RayCaster.html">RayCaster.html</a> | <a href="ru/A_Basic_RayCaster/RayCaster.js">RayCaster.js</a> | <a href="ru/A_Basic_RayCaster/trace.css">trace.css</a> | <a href="ru/A_Basic_RayCaster/trace.js">trace.js</a> </small></p> - -<h3 id="See_Also" name="See_Also">See Also</h3> - -<ul> - <li><a href="ru/Drawing_Graphics_with_Canvas">Drawing Graphics with Canvas</a></li> - <li><a href="ru/Canvas_tutorial">Canvas tutorial</a></li> - <li><a class="external" href="http://developer.apple.com/documentation/AppleApplications/Reference/SafariJSRef/Classes/Canvas.html">Apple Canvas Documentation</a></li> - <li><a class="external" href="http://www.whatwg.org/specs/web-apps/current-work/#dynamic">WhatWG Canvas Specification</a></li> -</ul> - -<p>{{ languages( { "fr": "fr/Un_raycaster_basique", "ja": "ja/A_Basic_RayCaster", "pl": "pl/Prosty_RayCaster" } ) }}</p> diff --git a/files/ru/conflicting/web/api/crypto/getrandomvalues/index.html b/files/ru/conflicting/web/api/crypto/getrandomvalues/index.html deleted file mode 100644 index 0193cc0447..0000000000 --- a/files/ru/conflicting/web/api/crypto/getrandomvalues/index.html +++ /dev/null @@ -1,112 +0,0 @@ ---- -title: RandomSource -slug: conflicting/Web/API/Crypto/getRandomValues -tags: - - API - - Interface - - NeedsTranslation - - RandomSource - - Reference - - TopicStub - - Web Crypto API -translation_of: Web/API/Crypto/getRandomValues -translation_of_original: Web/API/RandomSource -original_slug: Web/API/RandomSource ---- -<p>{{APIRef("Web Crypto API")}}</p> - -<p><strong><code>RandomSource</code></strong> представляет собой источник криптографически безопасных случайных чисел. Он доступен через {{domxref("Crypto")}} объект глобального объекта: {{domxref("Window.crypto")}} на веб страницах, {{domxref("WorkerGlobalScope.crypto")}} для воркеров.</p> - -<p><code>RandomSource</code> не является интерфейсом и объект этого типа не может быть создан.</p> - -<h2 id="Свойства">Свойства</h2> - -<p><em><code>RandomSource</code> не объявляет и не наследует никаких свойств.</em></p> - -<dl> -</dl> - -<h2 id="Методы">Методы</h2> - -<dl> - <dt>{{ domxref("RandomSource.getRandomValues()") }}</dt> - <dd>Наполняет {{ domxref("ArrayBufferView") }} криптографически безопасными случайными числовыми значениями.</dd> -</dl> - -<h2 id="Specification" name="Specification">Спецификации</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Спецификация</th> - <th scope="col">Статус</th> - <th scope="col">Коммент</th> - </tr> - <tr> - <td>{{SpecName('Web Crypto API', '#dfn-RandomSource')}}</td> - <td>{{Spec2('Web Crypto API')}}</td> - <td>Изначальное определение</td> - </tr> - </tbody> -</table> - -<h2 id="Browser_compatibility" name="Browser_compatibility">Совместимость с браузерами</h2> - -<p>{{ CompatibilityTable() }}</p> - -<div id="compat-desktop"> -<table class="compat-table"> - <tbody> - <tr> - <th>Возможность</th> - <th>Chrome</th> - <th>Firefox (Gecko)</th> - <th>Internet Explorer</th> - <th>Opera</th> - <th>Safari</th> - </tr> - <tr> - <td>Базовая поддержка</td> - <td>11.0 {{ webkitbug("22049") }}</td> - <td>{{CompatGeckoDesktop(21)}} [1]</td> - <td>11.0</td> - <td>15.0</td> - <td>3.1</td> - </tr> - </tbody> -</table> -</div> - -<div id="compat-mobile"> -<table class="compat-table"> - <tbody> - <tr> - <th>Возможность</th> - <th>Android</th> - <th>Chrome for Android</th> - <th>Firefox Mobile (Gecko)</th> - <th>IE Mobile</th> - <th>Opera Mobile</th> - <th>Safari Mobile</th> - </tr> - <tr> - <td>Базовая поддержка</td> - <td>{{ CompatNo() }}</td> - <td>23</td> - <td>{{CompatGeckoMobile(21)}}</td> - <td>{{ CompatNo() }}</td> - <td>{{ CompatNo() }}</td> - <td>6</td> - </tr> - </tbody> -</table> -</div> - -<p>[1] Although the transparent <code>RandomSource</code> is only available since Firefox 26, the feature was available in Firefox 21.</p> - -<h2 id="Смотрите_также">Смотрите также</h2> - -<ul> - <li>{{ domxref("Window.crypto") }} to get a {{domxref("Crypto")}} object.</li> - <li>{{jsxref("Math.random")}}, не криптографический источник случайных чисел.</li> -</ul> diff --git a/files/ru/conflicting/web/api/document_object_model/index.html b/files/ru/conflicting/web/api/document_object_model/index.html deleted file mode 100644 index 1432597b41..0000000000 --- a/files/ru/conflicting/web/api/document_object_model/index.html +++ /dev/null @@ -1,63 +0,0 @@ ---- -title: DOM -slug: conflicting/Web/API/Document_Object_Model -tags: - - DOM -translation_of: Web/API/Document_Object_Model -translation_of_original: DOM -original_slug: DOM ---- -<div> - <p><b>Объектная модель документа</b> (<b>DOM</b>) — это API для <a href="/ru/docs/HTML">HTML</a> и <a href="/ru/docs/XML">XML</a> документов. Она предоставляет структуру документа, что позволяет изменять его содержимое и внешний вид. По сути, она связывает веб-страницы со скриптами или языками программирования.</p> -</div> -<table class="topicpage-table"> - <tbody> - <tr> - <td> - <h2 class="Documentation" id=".D0.94.D0.BE.D0.BA.D1.83.D0.BC.D0.B5.D0.BD.D1.82.D0.B0.D1.86.D0.B8.D1.8F" name=".D0.94.D0.BE.D0.BA.D1.83.D0.BC.D0.B5.D0.BD.D1.82.D0.B0.D1.86.D0.B8.D1.8F">Документация</h2> - <dl> - <dt> - <a href="/ru/docs/%d0%a1%d0%bf%d1%80%d0%b0%d0%b2%d0%be%d1%87%d0%bd%d0%b0%d1%8f_%d0%b8%d0%bd%d1%84%d0%be%d1%80%d0%bc%d0%b0%d1%86%d0%b8%d1%8f_%d0%bf%d0%be_Gecko_DOM">Справочная информация по Gecko DOM</a></dt> - <dd> - Объектная модель документа движка Gecko.</dd> - <dt> - <a href="/ru/docs/%d0%9e%d0%b1_%d0%be%d0%b1%d1%8a%d0%b5%d0%ba%d1%82%d0%bd%d0%be%d0%b9_%d0%bc%d0%be%d0%b4%d0%b5%d0%bb%d0%b8_%d0%b4%d0%be%d0%ba%d1%83%d0%bc%d0%b5%d0%bd%d1%82%d0%b0">Об объектной модели документа</a></dt> - <dd> - Краткое введение в DOM.</dd> - <dt> - <a href="/ru/docs/%d0%94%d0%b8%d0%bd%d0%b0%d0%bc%d0%b8%d1%87%d0%b5%d1%81%d0%ba%d0%b8_%d0%b8%d0%b7%d0%bc%d0%b5%d0%bd%d1%8f%d0%b5%d0%bc%d1%8b%d0%b9_%d0%bf%d0%be%d0%bb%d1%8c%d0%b7%d0%be%d0%b2%d0%b0%d1%82%d0%b5%d0%bb%d1%8c%d1%81%d0%ba%d0%b8%d0%b9_%d0%b8%d0%bd%d1%82%d0%b5%d1%80%d1%84%d0%b5%d0%b9%d1%81_%d0%bd%d0%b0_XUL">Динамически изменяемый пользовательский интерфейс на XUL</a></dt> - <dd> - Основы управления XUL UI с помощью методов DOM.</dd> - <dt> - <a href="/ru/docs/DOM_%d0%b8_JavaScript">DOM и JavaScript</a></dt> - <dd> - Что такое DOM? Что такое JavaScript? Как мне использовать их совместно на моей веб-странице? Этот документ отвечает на эти и другие вопросы.</dd> - <dt> - <a class="external" href="http://www.mozilla.org/docs/dom/">Объектная модель документа Mozilla</a></dt> - <dd> - Более старая документация по DOM, размещённая на mozilla.org.</dd> - </dl> - <p><span class="alllinks"><a href="/ru/docs/tag/DOM">Посмотреть все...</a></span></p> - </td> - <td> - <h2 class="Community" id=".D0.A1.D0.BE.D0.BE.D0.B1.D1.89.D0.B5.D1.81.D1.82.D0.B2.D0.BE" name=".D0.A1.D0.BE.D0.BE.D0.B1.D1.89.D0.B5.D1.81.D1.82.D0.B2.D0.BE">Сообщество</h2> - <ul> - <li>Форумы Mozilla... {{ DiscussionList("dev-tech-dom", "mozilla.dev.tech.dom") }}</li> - </ul> - <h2 class="Tools" id=".D0.98.D0.BD.D1.81.D1.82.D1.80.D1.83.D0.BC.D0.B5.D0.BD.D1.82.D1.8B" name=".D0.98.D0.BD.D1.81.D1.82.D1.80.D1.83.D0.BC.D0.B5.D0.BD.D1.82.D1.8B">Инструменты</h2> - <ul> - <li><a class="external" href="http://www.getfirebug.com/">Firebug </a></li> - <li><a href="/ru/docs/DOM_Inspector">DOM Inspector</a></li> - <li><a class="external" href="http://slayeroffice.com/tools/modi/v2.0/modi_help.html">Mouse-over DOM Inspector</a></li> - <li><a class="external" href="http://www.karmatics.com/aardvark/">Aardvark Firefox extension</a></li> - </ul> - <p><span class="alllinks"><a href="/ru/docs/tag/DOM:Tools">Посмотреть все...</a></span></p> - <h2 class="Related_Topics" id=".D0.A1.D1.81.D1.8B.D0.BB.D0.BA.D0.B8_.D0.BF.D0.BE_.D1.82.D0.B5.D0.BC.D0.B5" name=".D0.A1.D1.81.D1.8B.D0.BB.D0.BA.D0.B8_.D0.BF.D0.BE_.D1.82.D0.B5.D0.BC.D0.B5">Ссылки по теме</h2> - <ul> - <li><a href="/ru/docs/AJAX">AJAX</a>, <a href="/ru/docs/CSS">CSS</a>, <a href="/ru/docs/DHTML">DHTML</a>, <a href="/ru/docs/JavaScript">JavaScript</a></li> - </ul> - </td> - </tr> - </tbody> -</table> -<p> </p> diff --git a/files/ru/conflicting/web/api/document_object_model_5521049528397035462607d58539e0cc/index.html b/files/ru/conflicting/web/api/document_object_model_5521049528397035462607d58539e0cc/index.html deleted file mode 100644 index 7794d4e392..0000000000 --- a/files/ru/conflicting/web/api/document_object_model_5521049528397035462607d58539e0cc/index.html +++ /dev/null @@ -1,26 +0,0 @@ ---- -title: Об объектной модели документа -slug: conflicting/Web/API/Document_Object_Model_5521049528397035462607d58539e0cc -tags: - - DOM -translation_of: Web/API/Document_Object_Model -translation_of_original: DOM/About_the_Document_Object_Model -original_slug: Об_объектной_модели_документа ---- -<h3 id=".D0.A7.D1.82.D0.BE_.D1.82.D0.B0.D0.BA.D0.BE.D0.B5_DOM.3F" name=".D0.A7.D1.82.D0.BE_.D1.82.D0.B0.D0.BA.D0.BE.D0.B5_DOM.3F">Что такое DOM?</h3> - -<p><a href="ru/DOM">Document Object Model</a> — это API для <a href="ru/HTML">HTML</a> и <a href="ru/XML">XML</a> документов. Она предоставляет структурное представление документа, что позволяет изменять его содержимое и внешний вид. По сути, она связывает веб-страницы со скриптами или языками программирования.</p> - -<p>Все свойства, методы и события, доступные веб-разработчику для манипулирования и создания веб-страниц организованы в <a href="ru/%d0%a1%d0%bf%d1%80%d0%b0%d0%b2%d0%be%d1%87%d0%bd%d0%b0%d1%8f_%d0%b8%d0%bd%d1%84%d0%be%d1%80%d0%bc%d0%b0%d1%86%d0%b8%d1%8f_%d0%bf%d0%be_Gecko_DOM">объекты</a> (например, объект document, который представляет сам документ, объект table, который представляет элементы HTML-таблицы, и т.д.). Эти объекты доступны через скриптовые языки в большинстве современных браузеров.</p> - -<p>В основном DOM используется вместе с <a href="ru/JavaScript">JavaScript</a>. То есть код пишется на JavaScript, но он использует DOM для доступа к веб-странице и её элементам. Тем не менее, DOM создавался, чтобы независимо от конкретных языков программирования имелась возможность доступа к структурному представлению документа через один API. Несмотря на то, что на этом сайте мы заострим внимание на JavaScript, реализации DOM могут быть созданы для <a class="external" href="http://www.w3.org/DOM/Bindings">любого языка</a>.</p> - -<p><a class="external" href="http://www.w3.org/">World Wide Web Consortium</a> установил <a class="external" href="http://www.w3.org/DOM/">стандарт для DOM</a>, называемый W3C DOM. Сейчас, когда большинство браузеров поддерживают этот стандарт, появилась возможность создавать мощные кросс-браузерные приложения.</p> - -<h3 id=".D0.9F.D0.BE.D1.87.D0.B5.D0.BC.D1.83_.D1.82.D0.B0.D0.BA_.D0.B2.D0.B0.D0.B6.D0.BD.D0.B0_.D0.BF.D0.BE.D0.B4.D0.B4.D0.B5.D1.80.D0.B6.D0.BA.D0.B0_DOM_.D0.B2_Mozilla.3F" name=".D0.9F.D0.BE.D1.87.D0.B5.D0.BC.D1.83_.D1.82.D0.B0.D0.BA_.D0.B2.D0.B0.D0.B6.D0.BD.D0.B0_.D0.BF.D0.BE.D0.B4.D0.B4.D0.B5.D1.80.D0.B6.D0.BA.D0.B0_DOM_.D0.B2_Mozilla.3F">Почему так важна поддержка DOM в Mozilla?</h3> - -<p>"Динамический HTML" (<a href="ru/DHTML">DHTML</a>) — это термин, под которым понимают совокупность HTML, CSS и скриптов, которые позволяют создавать анимированные веб-страницы. Поскольку Mozilla позиционирует свой продукт как "платформу для веб-приложений", поддержка DOM является очень важной и необходимой, чтобы Mozilla была достойной альтернативой другим браузерам.</p> - -<p>Ещё более важным фактом является то, что пользовательский интерфейс в Mozilla (а также в Firefox и Thunderbird) построен на XUL — языке разметки пользовательского интерфейса. Так что Mozilla использует DOM для <a href="ru/Dynamically_modifying_XUL-based_user_interface">изменения своего интерфейса</a>.</p> - -<p>{{ languages( { "es": "es/Acerca_del_Modelo_de_Objetos_del_Documento", "fr": "fr/\u00c0_propos_du_Document_Object_Model", "ja": "ja/About_the_Document_Object_Model", "ko": "ko/About_the_Document_Object_Model", "pl": "pl/O_modelu_obiektowym_dokumentu", "zh-cn": "cn/\u5173\u4e8e\u6587\u6863\u5bf9\u8c61\u6a21\u578b" } ) }}</p> diff --git a/files/ru/conflicting/web/api/document_object_model_dd00a71ceceac547ab464128db6bd8ef/index.html b/files/ru/conflicting/web/api/document_object_model_dd00a71ceceac547ab464128db6bd8ef/index.html deleted file mode 100644 index 4d8706e804..0000000000 --- a/files/ru/conflicting/web/api/document_object_model_dd00a71ceceac547ab464128db6bd8ef/index.html +++ /dev/null @@ -1,39 +0,0 @@ ---- -title: DOM developer guide -slug: conflicting/Web/API/Document_Object_Model_dd00a71ceceac547ab464128db6bd8ef -tags: - - API - - DOM - - Guide - - NeedsContent - - NeedsTranslation - - TopicStub -translation_of: Web/API/Document_Object_Model -translation_of_original: Web/Guide/API/DOM -original_slug: Web/Guide/API/DOM ---- -<p>{{draft}}</p> - -<p>Объектная модель документа - это API для документов HTML и XML. Она обеспечивает структурное представление документа, позволяя разработчику изменять его содержание и визуальное представление. По сути, она соединяет веб-страницы со скриптами или языками программирования.</p> - -<p>Все свойства, методы и события, доступные веб-разработчику для манипулирования и создания веб-страниц, организованы в объекты (например, объект документа, представляющий сам документ, объект таблицы, представляющий элемент таблицы HTML и т. Д.) , Эти объекты доступны через скриптовые языки в самых последних веб-браузерах.</p> - -<p>DOM чаще всего используется в сочетании с JavaScript. Тем не менее, DOM был разработан, чтобы быть независимым от какого-либо конкретного языка программирования, делая структурное представление документа доступным из единого, согласованного API. Хотя мы,на этом сайте, сосредоточены на JavaScript реализации DOM могут быть построены для любого языка.</p> - -<p>Консорциум World Wide Web устанавливает стандарт для DOM, называемый W3C DOM. Теперь, когда наиболее важные браузеры правильно его реализуют, следует включить мощные кросс-браузерные приложения.</p> - -<h2 id="Why_is_the_DOM_support_in_Mozilla_important.3F" name="Why_is_the_DOM_support_in_Mozilla_important.3F">Почему так важен DOM?</h2> - -<p>"Dynamic HTML" (<a href="/en-US/docs/DHTML">DHTML</a>) это термин, используемый некоторыми поставщиками для описания комбинации HTML, таблиц стилей и сценариев, позволяющих анимировать документы. Рабочая группа W3C DOM усердно работает над тем, чтобы согласовать совместимые и не зависящие от языка решения (см. также <a href="http://www.w3.org/DOM/faq.html">W3C FAQ</a>).</p> - -<p>Поскольку Mozilla претендует на звание «Платформа веб-приложений», поддержка DOM является одной из наиболее востребованных функций и необходимой, если Mozilla хочет стать жизнеспособной альтернативой другим браузерам. Пользовательский интерфейс Mozilla (также Firefox и Thunderbird) построен с использованием <a href="/en-US/docs/XUL" title="/en-US/docs/XUL">XUL</a>, используя DOM для <a href="/en-US/docs/Dynamically_modifying_XUL-based_user_interface">управления собственным пользовательским интерфейсом UI</a>.</p> - -<h2 id="More_about_the_DOM">More about the DOM</h2> - -<p>{{LandingPageListSubpages}}</p> - - - -<p>«Динамический HTML» (DHTML) - это термин, используемый некоторыми поставщиками для описания комбинации HTML, таблиц стилей и сценариев, позволяющих анимировать документы. Рабочая группа W3C DOM усердно работает над тем, чтобы согласовать совместимые и не зависящие от языка решения (см. Также FAQ по W3C).</p> - -<p>Поскольку Mozilla претендует на звание «Платформа веб-приложений», поддержка DOM является одной из наиболее востребованных функций и необходимой, если Mozilla хочет стать жизнеспособной альтернативой другим браузерам. Пользовательский интерфейс Mozilla (также Firefox и Thunderbird) построен с использованием XUL, используя DOM для управления собственным пользовательским интерфейсом.</p> diff --git a/files/ru/conflicting/web/api/element/index.html b/files/ru/conflicting/web/api/element/index.html deleted file mode 100644 index 8656365064..0000000000 --- a/files/ru/conflicting/web/api/element/index.html +++ /dev/null @@ -1,46 +0,0 @@ ---- -title: Slotable -slug: conflicting/Web/API/Element -tags: - - миксины -translation_of: Web/API/Slottable -translation_of_original: Web/API/Slotable -original_slug: Web/API/Slotable ---- -<p>{{APIRef("Shadow DOM")}}</p> - -<p>Миксин <code>Slotable</code> определяет возможности, которые позволяют нодам становиться контентом элемента {{htmlelement("slot")}} — следующие возможности включены в {{domxref("Element")}} и {{domxref("Text")}}.</p> - -<h2 id="Свойства">Свойства</h2> - -<dl> - <dt>{{domxref("Slotable.assignedSlot")}} {{readonlyInline}}</dt> - <dd>Возвращает {{htmlelement("slot")}}, в который вставлена нода.</dd> -</dl> - -<h2 id="Методы">Методы</h2> - -<p>Нет.</p> - -<h2 id="Спецификации">Спецификации</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Спецификация</th> - <th scope="col">Статус</th> - <th scope="col">Комментарии</th> - </tr> - <tr> - <td>{{SpecName('DOM WHATWG','#slotable','Slotable')}}</td> - <td>{{Spec2('DOM WHATWG')}}</td> - <td>Первое определение.</td> - </tr> - </tbody> -</table> - -<h2 id="Поддержка_браузерами">Поддержка браузерами</h2> - - - -<p>{{Compat("api.Slotable")}}</p> diff --git a/files/ru/conflicting/web/api/element_861159909c20acebf8e506c3bb0e2f7e/index.html b/files/ru/conflicting/web/api/element_861159909c20acebf8e506c3bb0e2f7e/index.html deleted file mode 100644 index 64a1aab95a..0000000000 --- a/files/ru/conflicting/web/api/element_861159909c20acebf8e506c3bb0e2f7e/index.html +++ /dev/null @@ -1,133 +0,0 @@ ---- -title: NonDocumentTypeChildNode -slug: conflicting/Web/API/Element_861159909c20acebf8e506c3bb0e2f7e -tags: - - API - - DOM - - Interface - - NeedsTranslation - - Reference - - TopicStub -translation_of: Web/API/NonDocumentTypeChildNode -original_slug: Web/API/NonDocumentTypeChildNode ---- -<div>{{APIRef("DOM")}}</div> - -<p>The <code><strong>NonDocumentTypeChildNode</strong></code> interface contains methods that are particular to {{domxref("Node")}} objects that can have a parent, but not suitable for {{domxref("DocumentType")}}.</p> - -<p><code>NonDocumentTypeChildNode</code> is a raw interface and no object of this type can be created; it is implemented by {{domxref("Element")}}, and {{domxref("CharacterData")}} objects.</p> - -<h2 id="Properties">Properties</h2> - -<p><em>There is no inherited property.</em></p> - -<dl> - <dt>{{domxref("NonDocumentTypeChildNode.previousElementSibling")}} {{readonlyInline}}</dt> - <dd>Returns the {{domxref("Element")}} immediately prior to this node in its parent's children list, or <code>null</code> if there is no {{domxref("Element")}} in the list prior to this node.</dd> - <dt>{{domxref("NonDocumentTypeChildNode.nextElementSibling")}} {{readonlyInline}}</dt> - <dd>Returns the {{domxref("Element")}} immediately following this node in its parent's children list, or <code>null</code> if there is no {{domxref("Element")}} in the list following this node.</dd> -</dl> - -<h2 id="Methods">Methods</h2> - -<p><em>There is neither inherited, nor specific method.</em></p> - -<h2 id="Specifications">Specifications</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Specification</th> - <th scope="col">Status</th> - <th scope="col">Comment</th> - </tr> - <tr> - <td>{{SpecName('DOM WHATWG', '#interface-childnode', 'NonDocumentTypeChildNode')}}</td> - <td>{{Spec2('DOM WHATWG')}}</td> - <td>Splitted the <code>ElementTraversal</code> interface in {{domxref("ParentNode")}}, {{domxref("ChildNode")}}, and <code>NonDocumentTypeChildNode</code>. The <code>previousElementSibling</code> and <code>nextElementSibling</code> are now defined on the latter.<br> - The {{domxref("CharacterData")}} and {{domxref("Element")}} implemented the new interfaces.</td> - </tr> - <tr> - <td>{{SpecName('Element Traversal', '#interface-elementTraversal', 'ElementTraversal')}}</td> - <td>{{Spec2('Element Traversal')}}</td> - <td>Added the initial definition of its properties to the <code>ElementTraversal</code> pure interface and use it on {{domxref("Element")}}.</td> - </tr> - </tbody> -</table> - -<h2 id="Browser_compatibility">Browser compatibility</h2> - -<p>{{ CompatibilityTable() }}</p> - -<div id="compat-desktop"> -<table class="compat-table"> - <tbody> - <tr> - <th>Feature</th> - <th>Chrome</th> - <th>Firefox (Gecko)</th> - <th>Internet Explorer</th> - <th>Opera</th> - <th>Safari</th> - </tr> - <tr> - <td>Basic support (on {{domxref("Element")}})</td> - <td>1.0</td> - <td>{{CompatGeckoDesktop("1.9.1")}}</td> - <td>9.0</td> - <td>10.0</td> - <td>4.0</td> - </tr> - <tr> - <td>Support (on {{domxref("CharacterData")}})</td> - <td>1.0</td> - <td>{{CompatGeckoDesktop("25.0")}} [1]</td> - <td>9.0</td> - <td>10.0</td> - <td>4.0</td> - </tr> - </tbody> -</table> -</div> - -<div id="compat-mobile"> -<table class="compat-table"> - <tbody> - <tr> - <th>Feature</th> - <th>Android</th> - <th>Firefox Mobile (Gecko)</th> - <th>IE Mobile</th> - <th>Opera Mobile</th> - <th>Safari Mobile</th> - </tr> - <tr> - <td>Basic support (on {{domxref("Element")}})</td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{CompatGeckoDesktop("1.9.1")}}</td> - <td>{{ CompatVersionUnknown() }}</td> - <td>10.0</td> - <td>{{ CompatVersionUnknown() }}</td> - </tr> - <tr> - <td>Support (on {{domxref("CharacterData")}})</td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{CompatGeckoDesktop("25.0")}}</td> - <td>{{ CompatVersionUnknown() }}</td> - <td>10.0</td> - <td>{{ CompatVersionUnknown() }}</td> - </tr> - </tbody> -</table> -</div> - -<p>[1] Firefox 25 also added the two properties defined here on {{domxref("DocumentType")}}, this was removed in Firefox 28 due to compatibility problems, and led to the creation of this new pure interface.</p> - -<h2 id="See_also">See also</h2> - -<ul> - <li>The {{domxref("ParentNode")}} and {{domxref("ChildNode")}} pure interface.</li> - <li> - <div class="syntaxbox">Object types implementing this pure interface: {{domxref("CharacterData")}}, and {{domxref("Element")}}.</div> - </li> -</ul> diff --git a/files/ru/conflicting/web/api/eventtarget/addeventlistener/index.html b/files/ru/conflicting/web/api/eventtarget/addeventlistener/index.html deleted file mode 100644 index ce515d9e4f..0000000000 --- a/files/ru/conflicting/web/api/eventtarget/addeventlistener/index.html +++ /dev/null @@ -1,10 +0,0 @@ ---- -title: EventTarget.attachEvent() -slug: conflicting/Web/API/EventTarget/addEventListener -tags: - - Junk -translation_of: Web/API/EventTarget/addEventListener -translation_of_original: Web/API/EventTarget/attachEvent -original_slug: Web/API/EventTarget/attachEvent ---- -<p>{{DOMxRef("EventTarget.addEventListener","EventTarget.addEventListener()")}}</p> diff --git a/files/ru/conflicting/web/api/eventtarget/removeeventlistener/index.html b/files/ru/conflicting/web/api/eventtarget/removeeventlistener/index.html deleted file mode 100644 index 63c2b0c366..0000000000 --- a/files/ru/conflicting/web/api/eventtarget/removeeventlistener/index.html +++ /dev/null @@ -1,93 +0,0 @@ ---- -title: EventTarget.detachEvent() -slug: conflicting/Web/API/EventTarget/removeEventListener -translation_of: Web/API/EventTarget/removeEventListener -translation_of_original: Web/API/EventTarget/detachEvent -original_slug: Web/API/EventTarget/detachEvent ---- -<p>{{APIRef("DOM Events")}}</p> - -<p>{{ Non-standard_header() }}</p> - -<h2 id="Кратко">Кратко</h2> - -<p>Это проприетарная альтернатива методу {{domxref("EventTarget.removeEventListener()")}} в Microsoft Internet Explorer.</p> - -<h2 id="Syntax" name="Syntax">Синтаксис</h2> - -<pre class="syntaxbox"><em>target</em>.detachEvent(<em>eventNameWithOn</em>, <em>callback</em>) -</pre> - -<dl> - <dt>target</dt> - <dd>DOM элемент, для которого надо убрать обработчик.</dd> - <dt>eventNameWithOn</dt> - <dd>Название события, начинающийся на "on" (так если бы это был колбэк атрибут), чей обработчик должен быть убран. Например, вам следует использовать <code>"onclick" для удаления обработчика для данного "click" события.</code></dd> - <dt>callback</dt> - <dd>Функция, которую стоит убрать.</dd> -</dl> - -<h2 id="Спецификация">Спецификация</h2> - -<p>Не является частью спецификации.</p> - -<p>Microsoft <a href="https://msdn.microsoft.com/en-us/library/ms536411(v=vs.85).aspx">содержит описание на MSDN</a>.</p> - -<h2 id="Browser_Compatibility" name="Browser_Compatibility">Поддержка браузерами</h2> - -<p>{{ CompatibilityTable() }}</p> - -<div id="compat-desktop"> -<table class="compat-table"> - <tbody> - <tr> - <th>Feature</th> - <th>Chrome</th> - <th>Firefox (Gecko)</th> - <th>Internet Explorer</th> - <th>Opera</th> - <th>Safari (WebKit)</th> - </tr> - <tr> - <td>Базовая поддержка</td> - <td>{{ CompatNo() }}</td> - <td>{{ CompatNo() }}</td> - <td>6 thru 10 [1]</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatNo() }}</td> - </tr> - </tbody> -</table> -</div> - -<div id="compat-mobile"> -<table class="compat-table"> - <tbody> - <tr> - <th>Feature</th> - <th>Android</th> - <th>Firefox Mobile (Gecko)</th> - <th>IE Phone</th> - <th>Opera Mobile</th> - <th>Safari Mobile</th> - </tr> - <tr> - <td>Базовая поддержка</td> - <td>{{ CompatNo() }}</td> - <td>{{ CompatNo() }}</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatNo() }}</td> - </tr> - </tbody> -</table> -</div> - -<p>[1]: <code>detachEvent()</code> больше не поддерживается в IE11+. {{domxref("EventTarget.removeEventListener()")}} поддерживается в IE9+.</p> - -<h2 id="Смотрите_так-же">Смотрите так-же</h2> - -<ul> - <li>{{ domxref("EventTarget.attachEvent()") }}</li> - <li>{{ domxref("EventTarget.fireEvent()") }}</li> -</ul> diff --git a/files/ru/conflicting/web/api/geolocation/index.html b/files/ru/conflicting/web/api/geolocation/index.html deleted file mode 100644 index 9a15927312..0000000000 --- a/files/ru/conflicting/web/api/geolocation/index.html +++ /dev/null @@ -1,104 +0,0 @@ ---- -title: NavigatorGeolocation -slug: conflicting/Web/API/Geolocation -translation_of: Web/API/Geolocation -translation_of_original: Web/API/NavigatorGeolocation -original_slug: Web/API/NavigatorGeolocation ---- -<div>{{APIRef("Geolocation API")}}</div> - -<p><code><strong>NavigatorGeolocation</strong></code> содержит метод, позволяющий объектам реализовывать его,, получая {{domxref("Geolocation")}} экземпляр объекта.</p> - -<p>Здесь нет объектов типа <code>NavigatorGeolocation</code>, но некоторые интерфейсы, например, {{domxref("Navigator")}} реализуют его.</p> - -<h2 id="Свойства">Свойства</h2> - -<p><em>Интерфейс <code>NavigatorGeolocation</code></em><em> не наследует каких-либо свойств.</em></p> - -<dl> - <dt>{{domxref("NavigatorGeolocation.geolocation")}} {{readonlyInline}}</dt> - <dd>Возвращает объект {{domxref("Geolocation")}} позволяющий получить доступ к местоположению устройства.</dd> -</dl> - -<h2 id="Методы">Методы</h2> - -<p><em><code>Интерфейс </code></em><em><code>NavigatorGeolocation</code></em><em> ни реализует, ни наследует никаких методов.</em></p> - -<h2 id="Спецификации">Спецификации</h2> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Спецификация</th> - <th scope="col">Статус</th> - <th scope="col">Комментарий</th> - </tr> - </thead> - <tbody> - <tr> - <td>{{SpecName('Geolocation', '#navi-geo', 'NavigatorGeolocation')}}</td> - <td>{{Spec2('Geolocation')}}</td> - <td>Изначальное описание</td> - </tr> - </tbody> -</table> - -<h2 id="Совместимость_с_браузерами">Совместимость с браузерами</h2> - -<p>{{CompatibilityTable}}</p> - -<div id="compat-desktop"> -<table class="compat-table"> - <tbody> - <tr> - <th>Свойство</th> - <th>Chrome</th> - <th>Firefox (Gecko)</th> - <th>Internet Explorer</th> - <th>Opera</th> - <th>Safari</th> - </tr> - <tr> - <td>Базовая поддержка</td> - <td>5</td> - <td>{{CompatGeckoDesktop("1.9.1")}}</td> - <td>9</td> - <td>10.60<br> - {{CompatNo}} 15.0<br> - 16.0</td> - <td>5</td> - </tr> - </tbody> -</table> -</div> - -<div id="compat-mobile"> -<table class="compat-table"> - <tbody> - <tr> - <th>Свойство</th> - <th>Android</th> - <th>Chrome for Android</th> - <th>Firefox Mobile (Gecko)</th> - <th>IE Mobile</th> - <th>Opera Mobile</th> - <th>Safari Mobile</th> - </tr> - <tr> - <td>Базовая поддержка</td> - <td>{{CompatUnknown}}</td> - <td>{{CompatUnknown}}</td> - <td>{{CompatGeckoMobile("4")}}</td> - <td>{{CompatUnknown}}</td> - <td>10.60</td> - <td>{{CompatUnknown}}</td> - </tr> - </tbody> -</table> -</div> - -<h2 id="Смотрите_также">Смотрите также</h2> - -<ul> - <li><a href="/en-US/docs/WebAPI/Using_geolocation">Использование геолокации.</a></li> -</ul> diff --git a/files/ru/conflicting/web/api/htmlmediaelement/abort_event/index.html b/files/ru/conflicting/web/api/htmlmediaelement/abort_event/index.html deleted file mode 100644 index 22fadfb200..0000000000 --- a/files/ru/conflicting/web/api/htmlmediaelement/abort_event/index.html +++ /dev/null @@ -1,71 +0,0 @@ ---- -title: abort -slug: conflicting/Web/API/HTMLMediaElement/abort_event -tags: - - Событие -translation_of: Web/API/HTMLMediaElement/abort_event -translation_of_original: Web/Events/abort -original_slug: Web/Events/abort ---- -<p>Событие "abort" вызывается когда загрузка какого-либо ресурса была прервана.</p> - -<h2 id="Общая_информация">Общая информация</h2> - -<dl> - <dt style="float: left; text-align: right; width: 120px;">Спецификация</dt> - <dd style="margin: 0 0 0 120px;"><a class="external" href="http://www.w3.org/TR/DOM-Level-3-Events/#event-type-abort">DOM L3</a></dd> - <dt style="float: left; text-align: right; width: 120px;">Интерфейс</dt> - <dd style="margin: 0 0 0 120px;">{{domxref("UIEvent")}} если событие сгенерировано из пользовательского интерфейса, иначе {{domxref("Event")}}.</dd> - <dt style="float: left; text-align: right; width: 120px;">Всплывание</dt> - <dd style="margin: 0 0 0 120px;">Нет</dd> - <dt style="float: left; text-align: right; width: 120px;">Отменяемость</dt> - <dd style="margin: 0 0 0 120px;">Нет</dd> - <dt style="float: left; text-align: right; width: 120px;">Цель</dt> - <dd style="margin: 0 0 0 120px;">{{domxref("window")}}, {{domxref("Element")}}</dd> - <dt style="float: left; text-align: right; width: 120px;">Действие по умолчанию</dt> - <dd style="margin: 0 0 0 120px;">Нет</dd> -</dl> - -<h2 id="Свойства">Свойства</h2> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Свойство</th> - <th scope="col">Тип</th> - <th scope="col">Описание</th> - </tr> - </thead> - <tbody> - <tr> - <td><code>target</code> {{readonlyInline}}</td> - <td><a href="/en-US/docs/Web/API/EventTarget" title="EventTarget is an interface implemented by objects that can receive events and may have listeners for them."><code>EventTarget</code></a></td> - <td>Цель события (самый вышележащий элемент в DOM дереве).</td> - </tr> - <tr> - <td><code>type</code> {{readonlyInline}}</td> - <td><a href="/en-US/docs/Web/API/DOMString" title="DOMString is a UTF-16 String. As JavaScript already uses such strings, DOMString is mapped directly to a String."><code>DOMString</code></a></td> - <td>Тип события.</td> - </tr> - <tr> - <td><code>bubbles</code> {{readonlyInline}}</td> - <td><a href="/en-US/docs/Web/API/Boolean" title="The Boolean object is an object wrapper for a boolean value."><code>Boolean</code></a></td> - <td>Поднимается ли событие вверх как принято или нет.</td> - </tr> - <tr> - <td><code>cancelable</code> {{readonlyInline}}</td> - <td><a href="/en-US/docs/Web/API/Boolean" title="The Boolean object is an object wrapper for a boolean value."><code>Boolean</code></a></td> - <td>Является ли событие отменяемым или нет?</td> - </tr> - <tr> - <td><code>view</code> {{readonlyInline}}</td> - <td><a class="new" href="/en-US/docs/Web/API/WindowProxy" rel="nofollow" title="The documentation about this has not yet been written; please consider contributing!"><code>WindowProxy</code></a></td> - <td><a href="/en-US/docs/Web/API/Document/defaultView" title="In browsers, document.defaultView returns the window object associated with a document, or null if none is available."><code>document.defaultView</code></a> (свойство <code>window</code> объекта document)</td> - </tr> - <tr> - <td><code>detail</code> {{readonlyInline}}</td> - <td><code>long</code> (<code>float</code>)</td> - <td>0.</td> - </tr> - </tbody> -</table> diff --git a/files/ru/conflicting/web/api/index.html b/files/ru/conflicting/web/api/index.html deleted file mode 100644 index 325f2ca52b..0000000000 --- a/files/ru/conflicting/web/api/index.html +++ /dev/null @@ -1,132 +0,0 @@ ---- -title: WebAPI -slug: conflicting/Web/API -tags: - - API -translation_of: Web/API -translation_of_original: WebAPI -original_slug: Web/WebAPI ---- -<p><strong>WebAPI</strong> is a term used to refer to a suite of device compatibility and access APIs that allow Web apps and content to access device hardware (such as battery status or the device vibration hardware), as well as access to data stored on the device (such as the calendar or contacts list). By adding these APIs, we hope to expand what the Web can do today to also include what only proprietary platforms were able to do in the past.</p> - -<div class="note"> -<p><strong>Note:</strong> For a brief explanation of each badge, please see the <a href="/en-US/docs/Web/Apps/Packaged_apps#Types_of_packaged_apps" title="Web/Apps/Packaged_apps#Types_of_packaged_apps">packaged apps</a> documentation.</p> -</div> - -<p> </p> - -<div class="row topicpage-table"> -<div class="section"> -<h2 class="Documentation" id="Communication_APIs" name="Communication_APIs">Communication APIs</h2> - -<dl> - <dt><a href="/en-US/docs/WebAPI/Network_Information" title="WebAPI/Network_Information">Network Information API</a></dt> - <dd>Provides basic information about the current network connection, such as connection speed.</dd> - <dt><a href="/en-US/docs/WebAPI/WebBluetooth" title="WebAPI/WebBluetooth">Bluetooth</a> {{NonStandardBadge}}</dt> - <dd>The WebBluetooth API provides low-level access to the device's Bluetooth hardware.</dd> - <dt><a href="/en-US/docs/WebAPI/Mobile_Connection" title="WebAPI/Mobile_Connection">Mobile Connection API</a> {{NonStandardBadge}}</dt> - <dd>Exposes information about the device's cellular connectivity, such as signal strength, operator information, and so forth.</dd> - <dt><a href="/en-US/docs/WebAPI/Network_Stats" title="WebAPI/Network_Stats">Network Stats API</a> {{NonStandardBadge}}</dt> - <dd>Monitors data usage and exposes this data to privileged applications.</dd> - <dt><a href="/en-US/docs/WebAPI/WebTelephony" title="WebAPI/WebTelephony">Telephony</a> {{NonStandardBadge}}</dt> - <dd>Lets apps place and answer phone calls and use the built-in telephony user interface.</dd> - <dt><a href="/en-US/docs/WebAPI/WebSMS" title="WebAPI/WebSMS">WebSMS </a>{{NonStandardBadge}}</dt> - <dd>Lets apps send and receive SMS text messages, as well as to access and manage the messages stored on the device.</dd> - <dt><a href="/en-US/docs/WebAPI/WiFi_Information" title="WebAPI/WiFi_Information">WiFi Information API</a> {{NonStandardBadge}}</dt> - <dd>A privileged API which provides information about signal strength, the name of the current network, available WiFi networks, and so forth.</dd> -</dl> - -<h2 class="Documentation" id="Hardware_access_APIs" name="Hardware_access_APIs">Hardware access APIs</h2> - -<dl> - <dt><a href="/en-US/docs/WebAPI/Using_Light_Events">Ambient Light Sensor API</a></dt> - <dd>Provides access to the ambient light sensor, which lets your app detect the ambient light level in the vicinity of the device.</dd> - <dt><a href="/en-US/docs/WebAPI/Battery_Status" title="WebAPI/Battery_Status">Battery Status API</a></dt> - <dd>Provides information about the battery's charge level and whether or not the device is currently plugged in and charging.</dd> - <dt><a href="/en-US/docs/Using_geolocation" title="Using_geolocation">Geolocation API</a></dt> - <dd>Provides information about the device's physical location.</dd> - <dt><a href="/en-US/docs/WebAPI/Pointer_Lock" title="API/Pointer_Lock_API">Pointer Lock API</a></dt> - <dd>Lets apps lock access to the mouse and gain access to movement deltas rather than absolute coordinates; this is great for gaming.</dd> - <dt><a href="/en-US/docs/WebAPI/Proximity" title="WebAPI/Proximity">Proximity API</a></dt> - <dd>Lets you detect proximity of the device to a nearby object, such as the user's face.</dd> - <dt><a href="/en-US/docs/WebAPI/Detecting_device_orientation" title="WebAPI/Detecting_device_orientation">Device Orientation API</a></dt> - <dd>Provides notifications when the device's orientation changes.</dd> - <dt><a href="/en-US/docs/WebAPI/Managing_screen_orientation" title="WebAPI/Detecting_device_orientation">Screen Orientation API</a></dt> - <dd>Provides notifications when the screen's orientation changes. You can also use this API to let your app indicate what orientation it prefers.</dd> - <dt><a href="/en-US/docs/WebAPI/Vibration" title="WebAPI/Vibration">Vibration API</a></dt> - <dd>Lets apps control the device's vibration hardware for things such as haptic feedback in games. This is <strong>not</strong> intended for things such as notification vibrations. See the <a href="/en-US/docs/WebAPI/Alarm" title="WebAPI/Alarm">Alarm API</a> for that.</dd> - <dt><a href="/en-US/docs/WebAPI/Camera" title="WebAPI/Camera">Camera API</a> {{NonStandardBadge}}</dt> - <dd>Allows apps to take photographs and/or record video using the device's built-in camera.</dd> - <dt><a href="/en-US/docs/WebAPI/Power_Management" title="WebAPI/Power_Management">Power Management API </a>{{NonStandardBadge}}</dt> - <dd>Lets apps turn on and off the screen, CPU, device power, and so forth. Also provides support for listening for and inspecting resource lock events.</dd> -</dl> - -<p><span class="alllinks"><a href="/en-US/docs/tag/WebAPI" title="tag/CSS">View All...</a></span></p> -</div> - -<div class="section"> -<h2 class="Documentation" id="Data_management_APIs" name="Data_management_APIs">Data management APIs</h2> - -<dl> - <dt><a href="/en-US/docs/WebAPI/FileHandle_API" title="WebAPI/FileHandle_API">FileHandle API</a> {{NonStandardBadge}}</dt> - <dd>Provides support for writable files with locking support.</dd> - <dt><a href="/en-US/docs/IndexedDB" title="IndexedDB">IndexedDB</a></dt> - <dd>Client-side storage of structured data with support for high-performance searches.</dd> - <dt><a href="/en-US/docs/WebAPI/Settings" title="WebAPI/Settings">Settings API</a> {{NonStandardBadge}}</dt> - <dd>Lets apps examine and change system-wide configuration options that are permanently stored on the device.</dd> -</dl> - -<h2 class="Documentation" id="Other_APIs" name="Other_APIs">Other APIs</h2> - -<dl> - <dt><a href="/en-US/docs/WebAPI/Alarm" title="WebAPI/Alarm">Alarm API</a></dt> - <dd>Lets apps schedule notifications. Also provides support for automatically launching an app at a specific time.</dd> - <dt><a href="/en-US/docs/WebAPI/Simple_Push" title="WebAPI/Push_Notifications">Simple Push API</a></dt> - <dd>Lets the platform send notification messages to specific applications.</dd> - <dt><a href="/en-US/docs/Web/API/Push_API">Push API</a></dt> - <dd>Gives web applications the ability to receive messages pushed to them from a server, whether or not the web app is in the foreground, or even currently loaded, on a user agent.</dd> - <dt><a href="/en-US/docs/WebAPI/Using_Web_Notifications" title="/en-US/docs/WebAPI/Using_Web_Notifications">Web Notifications</a></dt> - <dd>Lets applications send notifications displayed at the system level.</dd> - <dt><a href="/en-US/docs/Web/API/Apps" title="Apps">Apps API</a> {{NonStandardBadge}}</dt> - <dd>The Open WebApps API provides support for installing and managing Web apps. In addition, support is provided to let apps determine payment information.</dd> - <dt><a href="/en-US/docs/WebAPI/Web_Activities" title="WebAPI/Web_Activities">Web Activities</a> {{NonStandardBadge}}</dt> - <dd>Lets an app delegate an activity to another app; for example, an app might ask another app to select (or create) and return a photo. Typically the user is able to configure what apps are used for which activities.</dd> - <dt><a href="/en-US/docs/Apps/Publishing/In-app_payments" title="Apps/Publishing/In-app_payments">WebPayment API</a> {{NonStandardBadge}}</dt> - <dd>Lets Web content initiate payments and refunds for virtual goods.</dd> - <dt><a href="/en-US/docs/DOM/Using_the_Browser_API" title="DOM/Using_the_Browser_API"><strong>Browser API</strong></a> {{NonStandardBadge}}</dt> - <dd>Provides support for building a Web browser completely using Web technologies (in essence, a browser within a browser).</dd> -</dl> - -<dl> - <dt><a href="/en-US/docs/WebAPI/Idle" title="WebAPI/Device_Storage_API">Idle API</a></dt> - <dd>Lets apps receive notifications when the user is not actively using the device.</dd> - <dt><a href="/en-US/docs/WebAPI/Permissions" title="WebAPI/Permissions">Permissions API</a> {{NonStandardBadge}}</dt> - <dd>Manages app permissions in a centralized location. Used by the Settings app.</dd> - <dt><a href="/en-US/docs/WebAPI/Time_and_Clock" title="WebAPI/Time_and_Clock">Time/Clock API</a> {{NonStandardBadge}}</dt> - <dd>Provides support for setting the current time. The time zone is set using the <a href="/en-US/docs/WebAPI/Settings" title="WebAPI/Settings">Settings API</a>.</dd> -</dl> - -<h2 class="Community" id="Community" name="Community">WebAPI community</h2> - -<p>If you need help with these APIs, there are several ways you can talk to other developers making use of them.</p> - -<ul> - <li>Consult the WebAPI forum: {{DiscussionList("dev-webapi", "mozilla.dev.webapi")}}</li> - <li>Visit the WebAPI IRC channel: <a href="irc://irc.mozilla.org/webapi" title="irc://irc.mozilla.org/webapi">#webapi</a></li> -</ul> - -<p><span class="alllinks"><a href="http://www.catb.org/~esr/faqs/smart-questions.html" title="http://www.catb.org/~esr/faqs/smart-questions.html">Don't forget about the <em>netiquette</em>...</a></span></p> - -<h2 class="Related_Topics" id="Related_Topics" name="Related_Topics">Related Topics</h2> - -<ul> - <li>The <a href="/en-US/docs/DOM" title="Document Object Model (DOM)">Document Object Model (DOM)</a> is the representation of an HTML document as a tree.</li> - <li><a href="/en-US/docs/JavaScript" title="JavaScript">JavaScript</a> - Scripting language for the Web.</li> - <li><a href="/en-US/docs/WebAPI/Doc_status" title="WebAPI/Doc_status">Doc status</a>: A list of WebAPI topics and their documentation status.</li> -</ul> -</div> -</div> - -<p> </p> - -<p> </p> diff --git a/files/ru/conflicting/web/api/node/index.html b/files/ru/conflicting/web/api/node/index.html deleted file mode 100644 index 867810d345..0000000000 --- a/files/ru/conflicting/web/api/node/index.html +++ /dev/null @@ -1,27 +0,0 @@ ---- -title: Node.baseURIObject -slug: conflicting/Web/API/Node -translation_of: Web/API/Node -translation_of_original: Web/API/Node/baseURIObject -original_slug: Web/API/Node/baseURIObject ---- -<div>{{APIRef("DOM")}} {{Non-standard_header}}</div> - -<p>Свойство <code><strong>Node.baseURIObject</strong></code> возвращает {{Interface("nsIURI")}} представляющий базовый URL узла (обычно документ или элемент). Это похоже на {{domxref("Node.baseURI")}}, за исключением того, что возвращает nsIURI вместо строки.</p> - -<p>Это свойство существует на всех узлах (HTML, XUL, SVG, MathML, и т.д.), но только если скрипт пытается использовать его имея привилегии UniversalXPConnect.</p> - -<p>Смотрите {{domxref("Node.baseURI")}} для уточнения деталей что такое базовый URL.</p> - -<h2 id="Syntax" name="Syntax">Синтаксис</h2> - -<pre class="syntaxbox"><var>uriObj</var> = <em>node</em>.baseURIObject -</pre> - -<h2 id="Notes" name="Notes">Примечания</h2> - -<p>Это свойство только для чтения; попытка записать информацию в него, будет сбрасывать исключения. <span id="result_box" lang="ru"><span class="hps">Кроме того,</span> <span class="hps">это свойство может</span> <span class="hps">быть</span> <span class="hps">доступно только для</span> <span class="hps">привилегированного</span> <span class="hps">кода.</span></span></p> - -<h2 id="Specification" name="Specification">Спецификация</h2> - -<p>Нет какой-либо спецификации.</p> diff --git a/files/ru/conflicting/web/api/node_378aed5ed6869e50853edbc988cf9556/index.html b/files/ru/conflicting/web/api/node_378aed5ed6869e50853edbc988cf9556/index.html deleted file mode 100644 index 8de371b4cf..0000000000 --- a/files/ru/conflicting/web/api/node_378aed5ed6869e50853edbc988cf9556/index.html +++ /dev/null @@ -1,30 +0,0 @@ ---- -title: Node.nodePrincipal -slug: conflicting/Web/API/Node_378aed5ed6869e50853edbc988cf9556 -translation_of: Web/API/Node -translation_of_original: Web/API/Node/nodePrincipal -original_slug: Web/API/Node/nodePrincipal ---- -<div> -<div>{{APIRef("DOM")}}</div> -{{Non-standard_header}} - -<p>Свойство <code><strong>Node.nodePrincipal</strong></code> только для чтения, возвращающее объект {{Interface("nsIPrincipal")}}, представляющий текущий контекст безопасности узла.</p> - -<p>{{Note("Это свойство существует во всех узлах (HTML, XUL, SVG, MathML, и т.д.), но только если скрипт пытается использовать chrome привилегии.")}}</p> - -<h2 id="Syntax" name="Syntax">Синтаксис</h2> - -<pre class="syntaxbox"><em>principalObj</em> = element.nodePrincipal -</pre> - -<h2 id="Notes" name="Notes">Примечания</h2> - -<p>Это свойство только для чтения; пытаясь вводить информацию в него, будет сбрасывать исключение.<span id="result_box" lang="ru"><span class="hps">Кроме того,</span> <span class="hps">это свойство может</span> <span class="hps">быть</span> <span class="hps">доступно только для</span> <span class="hps">привилегированного</span> <span class="hps">кода.</span></span></p> - -<h2 id="Specification" name="Specification">Спецификация</h2> - -<p>Нет никакой спецификации.</p> -</div> - -<p> </p> diff --git a/files/ru/conflicting/web/api/push_api/index.html b/files/ru/conflicting/web/api/push_api/index.html deleted file mode 100644 index b97028f3b5..0000000000 --- a/files/ru/conflicting/web/api/push_api/index.html +++ /dev/null @@ -1,421 +0,0 @@ ---- -title: Использование Push API -slug: conflicting/Web/API/Push_API -translation_of: Web/API/Push_API -translation_of_original: Web/API/Push_API/Using_the_Push_API -original_slug: Web/API/Push_API/Using_the_Push_API ---- -<p class="summary"><span class="seoSummary">W3C <a href="/en-US/docs/Web/API/Push_API">Push API</a> предоставляет некоторую захватывающую новую функциональность для разработчиков для использования в web-приложениях: эта статья предлагает вводную информацию о том, как настроить Push-уведомления и управлять ими, с помощью простого демо.</span></p> - -<p>Возможность посылать сообщения или уведомления от сервера клиенту в любое время — независимо от того, активно приложение или нет — было прерогативой нативных приложений некоторое время, и наконец пришло в Web! Поддерживается большинства возможностей Push сейчас возможна в браузерах Firefox 43+ и Chrome 42+ на настольных компьютерах, мобильные платформы, возможно, скоро присоединятся. {{domxref("PushMessageData")}} на данный момент экспериментально поддерживаются только в Firefox Nightly (44+), и реализация может меняться.</p> - -<div class="note"> -<p><strong>Примечание</strong>: Ранние версии Firefox OS использовали проприетарную версию этого API вызывая <a href="/en-US/docs/Web/API/Simple_Push_API">Simple Push</a>. Считается устаревшим по стандартам Push API.</p> -</div> - -<h2 id="Демо_основы_простого_сервера_чат-приложения">Демо: основы простого сервера чат-приложения</h2> - -<p>Демо, которые мы создали, представляет начальное описание простого чат-приложения. Оно представляет собой форму, в которую вводятся данные, и кнопку для подписки на push-сообщения . Как только кнопка будет нажата, вы подпишитесь на push-сообщения, ваши данные будут записаны на сервере, а отправленное push-сообщение сообщит всем текущим подписчикам, что кто-то подписался.</p> - -<p>На данном этапе, имя нового подписчика появится в списке подписчиков, вместе с текстовым полем и кнопкой рассылки, чтобы позволить подписчику отправить сообщение.</p> - -<p><img alt="" src="https://mdn.mozillademos.org/files/11823/push-api-demo.png" style="border: 1px solid black; display: block; height: 406px; margin: 0px auto; width: 705px;"></p> - -<p>Чтобы запустить демо, следуйте инструкциям на странице <a href="https://github.com/chrisdavidmills/push-api-demo">push-api-demo README</a>. Заметьте, что серверная компонента всё ещё нуждается в небольшой доработке для запуска в Chrome и в общем запускается более разумным путём. Но аспекты Push всё ещё могут быть полностью понятны; мы углубимся в это после того, как просмотрим технологии в процессе.</p> - -<h2 id="Обзор_технологии">Обзор технологии</h2> - -<p>Эта секция предоставляет описание того, какие технологии участвуют в примере.</p> - -<p>Web Push-сообщения это часть семейства технологий <a href="/en-US/docs/Web/API/Service_Worker_API">сервис воркеров</a>; в первую очередь, для получения push-сообщений сервис воркер должен быть активирован на странице. Сервис воркер получает push-сообщения, и затем вы сами решаете, как уведомить об этом страницу. Вы можете:</p> - -<ul> - <li>Отправить <a href="/en-US/docs/Web/API/Notifications_API">Web-уведомление</a>, которое вызовет всплытие системного уведомления. Для этого необходимо подтверждение разрешения на отправку push-сообщений.</li> - <li>Отправить сообщение обратно главной странице через {{domxref("MessageChannel")}}.</li> -</ul> - -<p>Обычно необходима комбинация этих двух решений; демо внизу включает пример обоих.</p> - -<div class="note"> -<p><strong>Примечание</strong>: вам необходим некоторый код, запущенный на сервере, для управления конечной точкой/шифрованием данных и отправки запросов push-сообщений. В нашем демо мы собрали на скорую руку сервер, используя <a href="https://nodejs.org/">NodeJS</a>.</p> -</div> - -<p>Сервис воркер так же должен подписаться на сервис push-сообщений. Каждой сессии предоставляется собственная уникальная конечная точка, когда она подписывается на сервис push-сообщений. Эта конечная точка получается из свойства ({{domxref("PushSubscription.endpoint")}}) объекта подписчика. Она может быть отправлена серверу и использоваться для пересылки сообщений активному сервис воркеру сессии. Каждый браузер имеет свой собственный сервер push-сообщений для управления отправкой push-сообщений.</p> - -<h3 id="Шифрование">Шифрование</h3> - -<div class="note"> -<p><strong>Примечание</strong>: Для интерактивного краткого обзора, попробуйте JR Conlin's <a href="https://jrconlin.github.io/WebPushDataTestPage/">Web Push Data Encryption Test Page</a>.</p> -</div> - -<p>Для отправки данных с помощью push-сообщений необходимо шифрование. Для этого необходим публичный ключ, созданный с использованием метода {{domxref("PushSubscription.getKey()")}}, который основывается на некотором комплексе механизмов шифрования, которые выполняются на стороне сервера; читайте <a href="https://tools.ietf.org/html/draft-ietf-webpush-encryption-01">Message Encryption for Web Push</a>. Со временем появятся библиотеки для управления генерацией ключей и шифрованием/дешифрованием push-сообщений; для этого демо мы используем Marco Castelluccio's NodeJS <a href="https://github.com/marco-c/web-push">web-push library</a>.</p> - -<div class="note"> -<p><strong>Примечание</strong>: Есть так же другая библиотека для управления шифрованием с помощью Node и Python, смотри <a href="https://github.com/martinthomson/encrypted-content-encoding">encrypted-content-encoding</a>.</p> -</div> - -<h3 id="Обобщение_рабочего_процесса_Push">Обобщение рабочего процесса Push</h3> - -<p>Общие сведения ниже это то, что необходимо для реализации push-сообщений. Вы можете найти больше информации о некоторых частях демо в последующих частях.</p> - -<ol> - <li>Запрос на разрешение web-уведомлений или что-то другое, что вы используете и для чего необходимо разрешение.</li> - <li>Регистрация сервис воркера для контроля над страницей с помощью вызова {{domxref("ServiceWorkerContainer.register()")}}.</li> - <li>Подписка на сервис push-уведомлений с помощью {{domxref("PushManager.subscribe()")}}.</li> - <li>Запрашивание конечной точки, соответствующей подписчику, и генерация публичного ключа клиента ({{domxref("PushSubscription.endpoint")}} и {{domxref("PushSubscription.getKey()")}}. Заметьте, что <code>getKey()</code> на данный момент экспериментальная технология и доступна только в Firefox.)</li> - <li>Отправка данных на сервер, чтобы тот мог присылать push-сообщения, когда необходимо. Это демо использует {{domxref("XMLHttpRequest")}}, но вы можете использовать <a href="/en-US/docs/Web/API/Fetch_API">Fetch</a>.</li> - <li>Если вы используете <a href="/en-US/docs/Web/API/Channel_Messaging_API">Channel Messaging API</a> для связи с сервис воркером, установите новый канал связи ({{domxref("MessageChannel.MessageChannel()")}}) и отправьте <code>port2</code> сервис воркеру с помощью вызова {{domxref("Worker.postMessage()")}} для того, чтобы открыть канал связи. Вы так же должны настроить обработчик ответов на сообщения, которые будут отправляться обратно с сервис воркера.</li> - <li>На стороне сервера сохраните конечную точку и все остальные необходимые данные, чтобы они были доступны, когда будет необходимо отправить push-сообщение добавленному подписчику (мы используем простой текстовый файл, но вы можете использовать базу данных или все что угодно на ваш вкус). В приложении на продакшене убедитесь, что скрываете эти данные, так что злоумышленники не смогут украсть конечную точку и разослать спам подписчикам в push-сообщениях.</li> - <li>Для отправки push-сообщений необходимо отослать HTTP <code>POST</code> конечному URL. Запрос должен включать <code>TTL</code> заголовок, который ограничивает время пребывания сообщения в очереди, если пользователь не в сети. Для добавления полезной информации в запросе, необходимо зашифровать её (что включает публичный ключ клиента). В нашем примере мы используем <a href="https://github.com/marco-c/web-push">web-push</a> модуль, который управляет всей тяжёлой работой.</li> - <li>Поверх в сервис воркере настройте обработчик событий <code>push</code> для ответов на полученные push-сообщения. - <ol> - <li>Если вы хотите отвечать отправкой сообщения канала обратно основному контексту (смотри шаг 6), необходимо сначала получить ссылку на <code>port2,</code> который был отправлен контексту сервис воркера ({{domxref("MessagePort")}}). Это доступно в объекте {{domxref("MessageEvent")}}, передаваемого обработчику <code>onmessage </code>({{domxref("ServiceWorkerGlobalScope.onmessage")}}). Конкретнее, он находится в свойстве <code>ports</code>, индекс 0. Когда это сделано, вы можете отправить сообщение обратно <code>port1</code>, используя {{domxref("MessagePort.postMessage()")}}.</li> - <li>Если вы хотите ответить запуском системного уведомления, вы можете сделать это, вызвав {{domxref("ServiceWorkerRegistration.showNotification()")}}. Заметьте, что в нашем коде мы вызываем его внутри метода {{domxref("ExtendableEvent.waitUntil()")}} — это продлевает время жизни события до момента запуска уведомления и гарантирует, что метод showNotification будет завершён полностью.<span id="cke_bm_307E" class="hidden"> </span></li> - </ol> - </li> -</ol> - -<h2 id="Сборка_демо">Сборка демо</h2> - -<p>Давайте пройдёмся по коду для демо, чтобы понять, как все работает.</p> - -<h3 id="HTML_и_CSS">HTML и CSS</h3> - -<p>Нет ничего примечательного в HTML и CSS демо; HTML содержит простую форму для ввода данных для входа в чат, кнопку для подписки на push-уведомления и двух списков, в которых перечислены подписчики и сообщения чата. После подписки появляются дополнительные средства для того, чтобы пользователь мог ввести сообщение в чат.</p> - -<p>CSS был оставлен очень минимальным, чтобы не отвлекать от объяснения того, как функционируют Push API.</p> - -<h3 id="Основной_файл_JavaScript">Основной файл JavaScript</h3> - -<p> JavaScript очевидно намного более существенный. Давайте взглянем на основной файл JavaScript.</p> - -<h4 id="Переменные_и_начальные_настройки">Переменные и начальные настройки</h4> - -<p>Для начала определим некоторые переменные, которые будем использовать в нашем приложении:</p> - -<pre class="brush: js">var isPushEnabled = false; -var useNotifications = false; - -var subBtn = document.querySelector('.subscribe'); -var sendBtn; -var sendInput; - -var controlsBlock = document.querySelector('.controls'); -var subscribersList = document.querySelector('.subscribers ul'); -var messagesList = document.querySelector('.messages ul'); - -var nameForm = document.querySelector('#form'); -var nameInput = document.querySelector('#name-input'); -nameForm.onsubmit = function(e) { - e.preventDefault() -}; -nameInput.value = 'Bob';</pre> - -<p>Сначала нам необходимо создать две булевы переменные, для того чтобы отслеживать подписку на push-сообщения и подтверждение разрешения на рассылку уведомлений.</p> - -<p>Далее, мы перехватываем ссылку на {{htmlelement("button")}} подписки/отписки и задаём переменные для сохранения ссылок на наши кнопку отправки сообщения/ввода (который создастся только после успешной подписки).<br> - <br> - Следующие переменные перехватывают ссылки на три основные {{htmlelement("div")}} элемента, так что мы можем включить в них элементы (к примеру, когда появится кнопка <em>Отправки Сообщения Чата</em> или сообщение появится в <em>списке сообщений</em>).</p> - -<p>Наконец, мы берем ссылки на нашу форму выбора имени и элемент {{htmlelement("input")}}, присваиваем входу значение по умолчанию и используем <code><a href="/en-US/docs/Web/API/Event/preventDefault">preventDefault()</a></code>, чтобы остановить отправку формы, которая будет отправлена нажатием кнопки return.</p> - -<p>Далее мы запрашиваем разрешение на отправку веб-уведомлений, используя {{domxref("Notification.requestPermission","requestPermission()")}}:</p> - -<pre class="brush: js">Notification.requestPermission();</pre> - -<p>Now we run a section of code when <code><a href="/en-US/docs/Web/API/GlobalEventHandlers/onload">onload</a></code> is fired, to start up the process of inialising the app when it is first loaded. First of all we add a click event listener to the subscribe/unsubscribe button that runs our <code>unsubscribe()</code> function if we are already subscribed (<code>isPushEnabled</code> is <code>true</code>), and <code>subscribe()</code> otherwise:</p> - -<pre class="brush: js">window.addEventListener('load', function() { - subBtn.addEventListener('click', function() { - if (isPushEnabled) { - unsubscribe(); - } else { - subscribe(); - } - });</pre> - -<p>Next we check to see if service workers are supported. If so, we register a service worker using {{domxref("ServiceWorkerContainer.register()")}}, and run our <code>initialiseState()</code> function. If not, we deliver an error message to the console.</p> - -<pre class="brush: js"> // Check that service workers are supported, if so, progressively - // enhance and add push messaging support, otherwise continue without it. - if ('serviceWorker' in navigator) { - navigator.serviceWorker.register('sw.js').then(function(reg) { - if(reg.installing) { - console.log('Service worker installing'); - } else if(reg.waiting) { - console.log('Service worker installed'); - } else if(reg.active) { - console.log('Service worker active'); - } - - initialiseState(reg); - }); - } else { - console.log('Service workers aren\'t supported in this browser.'); - } -}); -</pre> - -<p>The next thing in the source code is the <code>initialiseState()</code> function — for the full commented code, look at the <a href="https://github.com/chrisdavidmills/push-api-demo/blob/gh-pages/main.js"><code>initialiseState()</code> source on Github</a> (we are not repeating it here for brevity's sake.)</p> - -<p><code>initialiseState()</code> first checks whether notifications are supported on service workers, then sets the <code>useNotifications</code> variable to <code>true</code> if so. Next, it checks whether said notifications are permitted by the user, and if push messages are supported, and reacts accordingly to each.</p> - -<p>Finally, it uses {{domxref("ServiceWorkerContainer.ready()")}} to wait until the service worker is active and ready to start doing things. Once its promise resolves, we retrieve our subscription to push messaging using the {{domxref("ServiceWorkerRegistration.pushManager")}} property, which returns a {{domxref("PushManager")}} object that we then call {{domxref("PushManager.getSubscription()")}} on. Once this second inner promise resolves, we enable the subscribe/unsubscribe button (<code>subBtn.disabled = false;</code>), and check that we have a subscription object to work with.</p> - -<p>If we do, then we are already subscribed. This is possible when the app is not open in the browser; the service worker can still be active in the background. If we're subscribed, we update the UI to show that we are subscribed by updating the button label, then we set <code>isPushEnabled</code> to <code>true</code>, grab the subscription endpoint from {{domxref("PushSubscription.endpoint")}}, generate a public key using {{domxref("PushSubscription.getKey()")}}, and run our <code>updateStatus()</code> function, which as you'll see later communicates with the server.</p> - -<p>As an added bonus, we set up a new {{domxref("MessageChannel")}} using the {{domxref("MessageChannel.MessageChannel()")}} constructor, grab a reference to the active service worker using {{domxref("ServiceworkerRegistration.active")}}, then set up a channel betweeen the main browser context and the service worker context using {{domxref("Worker.postMessage()")}}. The browser context receives messages on {{domxref("MessageChannel.port1")}}; whenever that happens, we run the <code>handleChannelMessage()</code> function to decide what to do with that data (see the {{anch("Handling channel messages sent from the service worker")}} section).</p> - -<h4 id="Subscribing_and_unsubscribing">Subscribing and unsubscribing</h4> - -<p>Let's now turn our attention to the <code>subscribe()</code> and <code>unsubscribe()</code> functions used to subscribe/unsubscribe to the push notification service.</p> - -<p>In the case of subscription, we again check that our service worker is active and ready by calling {{domxref("ServiceWorkerContainer.ready()")}}. When the promise resolves, we subscribe to the service using {{domxref("PushManager.subscribe()")}}. If the subscription is successful, we get a {{domxref("PushSubscription")}} object, extract the subscription endpoint from this and generate a public key (again, {{domxref("PushSubscription.endpoint")}} and {{domxref("PushSubscription.getKey()")}}), and pass them to our <code>updateStatus()</code> function along with the update type (<code>subscribe</code>) to send the necessary details to the server.</p> - -<p>We also make the necessary updates to the app state (set <code>isPushEnabled</code> to <code>true</code>) and UI (enable the subscribe/unsubscribe button and set its label text to show that the next time it is pressed it will unsubscribe.)</p> - -<p>The <code>unsubscribe()</code> function is pretty similar in structure, but it basically does the opposite; the most notable difference is that it gets the current subscription using {{domxref("PushManager.getSubscription()")}}, and when that promise resolves it unsubscribes using {{domxref("PushSubscription.unsubscribe()")}}.</p> - -<p>Appropriate error handling is also provided in both functions. </p> - -<p>We only show the <code>subscribe()</code> code below, for brevity; see the full <a href="https://github.com/chrisdavidmills/push-api-demo/blob/gh-pages/main.js">subscribe/unsubscribe code on Github</a>.</p> - -<pre class="brush: js">function subscribe() { - // Disable the button so it can't be changed while - // we process the permission request - - subBtn.disabled = true; - - navigator.serviceWorker.ready.then(function(reg) { - reg.pushManager.subscribe({userVisibleOnly: true}) - .then(function(subscription) { - // The subscription was successful - isPushEnabled = true; - subBtn.textContent = 'Unsubscribe from Push Messaging'; - subBtn.disabled = false; - - // Update status to subscribe current user on server, and to let - // other users know this user has subscribed - var endpoint = subscription.endpoint; - var key = subscription.getKey('p256dh'); - updateStatus(endpoint,key,'subscribe'); - }) - .catch(function(e) { - if (Notification.permission === 'denied') { - // The user denied the notification permission which - // means we failed to subscribe and the user will need - // to manually change the notification permission to - // subscribe to push messages - console.log('Permission for Notifications was denied'); - - } else { - // A problem occurred with the subscription, this can - // often be down to an issue or lack of the gcm_sender_id - // and / or gcm_user_visible_only - console.log('Unable to subscribe to push.', e); - subBtn.disabled = false; - subBtn.textContent = 'Subscribe to Push Messaging'; - } - }); - }); -}</pre> - -<h4 id="Updating_the_status_in_the_app_and_server">Updating the status in the app and server</h4> - -<p>The next function in our main JavaScript is <code>updateStatus()</code>, which updates the UI for sending chat messages when subscribing/unsubscribing and sends a request to update this information on the server.</p> - -<p>The function does one of three different things, depending on the value of the <code>statusType</code> parameter passed into it:</p> - -<ul> - <li><code>subscribe</code>: The button and text input for sending chat messages are created and inserted into the UI, and an object is sent to the server via XHR containing the status type (<code>subscribe</code>), username of the subscriber, subscription endpoint, and client public key.</li> - <li><code>unsubscribe</code>: This basically works in the opposite way to subscribe — the chat UI elements are removed, and an object is sent to the server to tell it that the user has unsubscribed.</li> - <li><code>init</code>: This is run when the app is first loaded/initialised — it creates the chat UI elements, and sends an object to the server to tell it that which user has reinitialised (reloaded.)</li> -</ul> - -<p>Again, we have not included the entire function listing for brevity. Examine the <a href="https://github.com/chrisdavidmills/push-api-demo/blob/gh-pages/main.js">full <code>updateStatus()</code> code on Github</a>.</p> - -<h4 id="Handling_channel_messages_sent_from_the_service_worker">Handling channel messages sent from the service worker</h4> - -<p>As mentioned earlier, when a <a href="/en-US/docs/Web/API/Channel_Messaging_API">channel message</a> is received from the service worker, our <code>handleChannelMessage()</code> function is called to handle it. This is done by our handler for the {{event("message")}} event, {{domxref("channel.port1.onmessage")}}:</p> - -<pre class="brush: js">channel.port1.onmessage = function(e) { - handleChannelMessage(e.data); -}</pre> - -<p>This occurs when the <a href="https://github.com/chrisdavidmills/push-api-demo/blob/gh-pages/sw.js#L8">service worker sends a channel message over</a>.</p> - -<p>The <code>handleChannelMessage()</code> function looks like this:</p> - -<pre class="brush: js">function handleChannelMessage(data) { - if(data.action === 'subscribe' || data.action === 'init') { - var listItem = document.createElement('li'); - listItem.textContent = data.name; - subscribersList.appendChild(listItem); - } else if(data.action === 'unsubscribe') { - for(i = 0; i < subscribersList.children.length; i++) { - if(subscribersList.children[i].textContent === data.name) { - subscribersList.children[i].parentNode.removeChild(subscribersList.children[i]); - } - } - nameInput.disabled = false; - } else if(data.action === 'chatMsg') { - var listItem = document.createElement('li'); - listItem.textContent = data.name + ": " + data.msg; - messagesList.appendChild(listItem); - sendInput.value = ''; - } -}</pre> - -<p>What happens here depends on what the <code>action</code> property on the <code>data</code> object is set to:</p> - -<ul> - <li><code>subscribe</code> or <code>init</code> (at both startup and restart, we need to do the same thing in this sample): An {{htmlelement("li")}} element is created, its text content is set to <code>data.name</code> (the name of the subscriber), and it is appended to the subscribers list (a simple {{htmlelement("ul")}} element) so there is visual feedback that a subscriber has (re)joined the chat.</li> - <li><code>unsubscribe</code>: We loop through the children of the subscribers list, find the one whose text content is equal to <code>data.name</code> (the name of the unsubscriber), and delete that node to provide visual feedback that someone has unsubscribed.</li> - <li><code>chatMsg</code>: In a similar manner to the first case, an {{htmlelement("li")}} element is created, its text content is set to <code>data.name + ": " + data.msg</code> (so for example "Chris: This is my message"), and it is appended to the chat messages list; this is how the chat messages appear on the UI for each user.</li> -</ul> - -<div class="note"> -<p><strong>Note</strong>: We have to pass the data back to the main context before we do DOM updates because service workers don't have access to the DOM. You should be aware of the limitations of service workers before attemping to ue them. Read <a href="/en-US/docs/Web/API/Service_Worker_API/Using_Service_Workers">Using Service Workers</a> for more details.</p> -</div> - -<h4 id="Sending_chat_messages">Sending chat messages</h4> - -<p>When the <em>Send Chat Message</em> button is clicked, the content of the associated text field is sent as a chat message. This is handled by the <a href="https://github.com/chrisdavidmills/push-api-demo/blob/gh-pages/main.js"><code>sendChatMessage()</code> function</a> (again, not shown in full for brevity). This works in a similar way to the different parts of the <code>updateStatus()</code> function (see {{anch("Updating the status in the app and server")}}) — we retrieve an endpoint and public key via a {{domxref("PushSubscription")}} object, which is itself retrieved via {{domxref("ServiceWorkerContainer.ready()")}} and {{domxref("PushManager.subscribe()")}}. These are sent to the server via {{domxref("XMLHttpRequest")}} in a message object, along with the name of the subscribed user, the chat message to send, and a <code>statusType</code> of <code>chatMsg</code>.</p> - -<h3 id="The_server">The server</h3> - -<p>As mentioned above, we need a server-side component in our app, to handle storing subscription details, and send out push messages when updates occur. We've hacked together a quick-and-dirty server using <a href="http://nodejs.org/">NodeJS</a> (<code><a href="https://github.com/chrisdavidmills/push-api-demo/blob/gh-pages/server.js">server.js</a></code>), which handles the XHR requests sent by our client-side JavaScript code.</p> - -<p>It uses a text file (<code><a href="https://github.com/chrisdavidmills/push-api-demo/blob/gh-pages/endpoint.txt">endpoint.txt</a></code>) to store subscription details; this file starts out empty. There are four different types of request, marked by the <code>statusType</code> property of the object sent over in the request; these are the same as those understood client-side, and perform the required server actions for that same situation. Here's what each means in the context of the server:</p> - -<ul> - <li><code>subscribe</code>: The server adds the new subscriber's details into the subscription data store (<code><a href="https://github.com/chrisdavidmills/push-api-demo/blob/gh-pages/endpoint.txt">endpoint.txt</a></code>), including the endpoint, and then sends a push message to all the endpoints it has stored to tell each subscriber that someone new has joined the chat.</li> - <li><code>unsubscribe</code>: The server finds the sending subscriber's details in the subscription store and removes it, then sends a push message to all remaining subscribers telling them the user has unsubscribed.</li> - <li><code>init</code>: The server reads all the current subscribers from the text file, and sends each one a push message to tell them a user has initialized (rejoined) the chat.</li> - <li><code>chatMsg</code>: Sent by a subscriber that wishes to deliver a message to all users; the server reads the list of all current subscribers from the subscription store file, then sends each one a push message containing the new chat message they should display.</li> -</ul> - -<p>A couple more things to note:</p> - -<ul> - <li>We are using the Node.js <a href="https://nodejs.org/api/https.html">https module</a> to create the server, because for security purposes, service workers only work on a secure connection. This is why we need to include the <code>.pfx</code> security cert in the app, and reference it when creating the server in the Node code.</li> - <li>When you send a push message without data, you simply send it to the endpoint URL using an HTTP <code>POST</code> request. However, when the push message contains data, you need to encrypt it, which is quite a complex process. As time goes on, libraries will appear to do this kind of thing for you; for this demo we used Marco Castelluccio's NodeJS <a href="https://github.com/marco-c/web-push">web-push library</a>. Have a look at the source code to get more of an idea of how the encryption is done (and read <a href="https://tools.ietf.org/html/draft-ietf-webpush-encryption-01">Message Encryption for Web Push</a> for more details.) The library <a href="https://github.com/chrisdavidmills/push-api-demo/blob/gh-pages/server.js#L43-L46">makes sending a push message simple</a>.</li> -</ul> - -<h3 id="The_service_worker">The service worker</h3> - -<p>Now let's have a look at the service worker code (<code><a href="https://github.com/chrisdavidmills/push-api-demo/blob/gh-pages/sw.js">sw.js</a></code>), which responds to the push messages, represented by {{Event("push")}} events. These are handled on the service worker's scope by the ({{domxref("ServiceWorkerGlobalScope.onpush")}}) event handler; its job is to work out what to do in response to each received message. We first convert the received message back into an object by calling {{domxref("PushMessageData.json()")}}. Next, we check what type of push message it is, by looking at the object's <code>action</code> property:</p> - -<ul> - <li><code>subscribe</code> or <code>unsubscribe</code>: We send a system notification via the <code>fireNotification()</code> function, but also send a message back to the main context on our {{domxref("MessageChannel")}} so we can update the subscriber list accordingly (see {{anch("Handling channel messages sent from the service worker")}} for more details).</li> - <li><code>init</code> or <code>chatMsg</code>: We just send a channel message back to the main context to handle the <code>init</code> and <code>chatMsg</code> cases (these don't need a system notification).</li> -</ul> - -<pre class="brush: js">self.addEventListener('push', function(event) { - var obj = event.data.json(); - - if(obj.action === 'subscribe' || obj.action === 'unsubscribe') { - fireNotification(obj, event); - port.postMessage(obj); - } else if(obj.action === 'init' || obj.action === 'chatMsg') { - port.postMessage(obj); - } -});</pre> - -<p>Next, let's look at the <code>fireNotification()</code> function (which is blissfully pretty simple).</p> - -<pre class="brush: js">function fireNotification(obj, event) { - var title = 'Subscription change'; - var body = obj.name + ' has ' + obj.action + 'd.'; - var icon = 'push-icon.png'; - var tag = 'push'; - - event.waitUntil(self.registration.showNotification(title, { - body: body, - icon: icon, - tag: tag - })); -}</pre> - -<p>Here we assemble the assets needed by the notification box: the title, body, and icon. Then we send a notification via the {{domxref("ServiceWorkerRegistration.showNotification()")}} method, providing that information as well as the tag "push", which we can use to identify this notification among any other notifications we might be using. When the notification is successfully sent, it manifests as a system notification dialog on the users computers/devices in whatever style system notifications look like on those systems (the following image shows a Mac OSX system notification.)</p> - -<p><img alt="" src="https://mdn.mozillademos.org/files/11855/subscribe-notification.png" style="display: block; height: 65px; margin: 0px auto; width: 326px;"></p> - -<p>Note that we do this from inside an {{domxref("ExtendableEvent.waitUntil()")}} method; this is to make sure the service worker remains active until the notification has been sent. <code>waitUntil()</code> will extend the life cycle of the service worker until everything inside this method has completed.</p> - -<div class="note"> -<p><strong>Note</strong>: Web notifications from service workers were introduced around Firefox version 42, but are likely to be removed again while the surrounding functionality (such as <code>Clients.openWindow()</code>) is properly implemented (see {{bug(1203324)}} for more details.)</p> -</div> - -<h2 id="Handling_premature_subscription_expiration">Handling premature subscription expiration</h2> - -<p>Sometimes push subscriptions expire prematurely, without {{domxref("PushSubscription.unsubscribe()")}} being called. This can happen when the server gets overloaded, or if you are offline for a long time, for example. This is highly server-dependent, so the exact behavior is difficult to predict. In any case, you can handle this problem by watching for the {{Event("pushsubscriptionchange")}} event, which you can listen for by providing a {{domxref("ServiceWorkerGlobalScope.onpushsubscriptionchange")}} event handler; this event is fired only in this specific case.</p> - -<pre class="brush: js language-js"><code class="language-js">self<span class="punctuation token">.</span><span class="function token">addEventListener<span class="punctuation token">(</span></span><span class="string token">'pushsubscriptionchange'</span><span class="punctuation token">,</span> <span class="keyword token">function</span><span class="punctuation token">(</span><span class="punctuation token">)</span> <span class="punctuation token">{</span> - <span class="comment token"> // do something, usually resubscribe to push and -</span> <span class="comment token"> // send the new subscription details back to the -</span> <span class="comment token"> // server via XHR or Fetch -</span><span class="punctuation token">}</span><span class="punctuation token">)</span><span class="punctuation token">;</span></code></pre> - -<p>Note that we don't cover this case in our demo, as a subscription ending is not a big deal for a simple chat server. But for a more complex example you'd probably want to resubscribe the user.</p> - -<h2 id="Extra_steps_for_Chrome_support">Extra steps for Chrome support</h2> - -<p>To get the app working on Chrome, we need a few extra steps, as Chrome currently relies on Google's Cloud Messaging service to work.</p> - -<h3 id="Setting_up_Google_Cloud_Messaging">Setting up Google Cloud Messaging</h3> - -<p>To get this set up, follow these steps:</p> - -<ol> - <li>Navigate to the <a href="https://console.developers.google.com">Google Developers Console</a> and set up a new project.</li> - <li>Go to your project's homepage (ours is at <code>https://console.developers.google.com/project/push-project-978</code>, for example), then - <ol> - <li>Select the <em>Enable Google APIs for use in your apps</em> option.</li> - <li>In the next screen, click <em>Cloud Messaging for Android</em> under the <em>Mobile APIs</em> section.</li> - <li>Click the <em>Enable API</em> button.</li> - </ol> - </li> - <li>Now you need to make a note of your project number and API key because you'll need them later. To find them: - <ol> - <li><strong>Project number</strong>: click <em>Home</em> on the left; the project number is clearly marked at the top of your project's home page.</li> - <li><strong>API key</strong>: click <em>Credentials</em> on the left hand menu; the API key can be found on that screen.</li> - </ol> - </li> -</ol> - -<h3 id="manifest.json">manifest.json</h3> - -<p>You need to include a Google app-style <code>manifest.json</code> file in your app, which references the project number you made a note of earlier in the <code>gcm_sender_id</code> parameter. Here is our simple example <a href="https://github.com/chrisdavidmills/push-api-demo/blob/gh-pages/manifest.json">manifest.json</a>:</p> - -<pre class="brush: js">{ - "name": "Push Demo", - "short_name": "Push Demo", - "icons": [{ - "src": "push-icon.png", - "sizes": "111x111", - "type": "image/png" - }], - "start_url": "/index.html", - "display": "standalone", - "gcm_sender_id": "224273183921" -}</pre> - -<p>You also need to reference your manifest using a {{HTMLElement("link")}} element in your HTML:</p> - -<pre class="brush: html"><link rel="manifest" href="manifest.json"></pre> - -<h3 id="userVisibleOnly">userVisibleOnly</h3> - -<p>Chrome requires you to set the <a href="/en-US/docs/Web/API/PushManager/subscribe#Parameters"><code>userVisibleOnly</code> parameter</a> to <code>true</code> when subscribing to the push service, which indicates that we are promising to show a notification whenever a push is received. This can be <a href="https://github.com/chrisdavidmills/push-api-demo/blob/gh-pages/main.js#L127">seen in action in our <code>subscribe()</code> function</a>.</p> - -<h2 id="See_also">See also</h2> - -<ul> - <li><a href="/en-US/docs/Web/API/Push_API">Push API</a></li> - <li><a href="/en-US/docs/Web/API/Service_Worker_API">Service Worker API</a></li> -</ul> - -<div class="note"> -<p><strong>Note</strong>: Some of the client-side code in our Push demo is heavily influenced by Matt Gaunt's excellent examples in <a href="http://updates.html5rocks.com/2015/03/push-notificatons-on-the-open-web">Push Notifications on the Open Web</a>. Thanks for the awesome work, Matt!</p> -</div> diff --git a/files/ru/conflicting/web/api/svgaelement/target/index.html b/files/ru/conflicting/web/api/svgaelement/target/index.html deleted file mode 100644 index 376099e1f3..0000000000 --- a/files/ru/conflicting/web/api/svgaelement/target/index.html +++ /dev/null @@ -1,108 +0,0 @@ ---- -title: SVGAElement.target -slug: conflicting/Web/API/SVGAElement/target -translation_of: Web/API/SVGAElement/target -translation_of_original: Web/API/SVGAElement/SVGAlement.target -original_slug: Web/API/SVGAElement/SVGAlement.target ---- -<p>{{APIRef("SVGAElement")}}</p> - -<p> </p> - -<p>Свойство <code><strong>SVGAElement.target</strong></code> для чтения только {{domxref ("SVGAElement")}} возвращает объект {{domxref ("SVGAnimatedString")}}, который указывает часть целевого окна, фрейма, панель, в которую открывается при активации ссылки.</p> - -<p>Это свойство используется, когда существует множество возможных целей для конечного ресурса, например, когда родительский документ является документом HTML или HTML-документом mlti-frame.</p> - -<p> </p> - -<h2 id="Синтаксис">Синтаксис</h2> - -<pre><code><em>myLink</em>.target = '<em>value</em>';</code></pre> - -<h3 id="Стоимость">Стоимость</h3> - -<p>{{Domxref ("SVGAnimatedString")}}, указывающий конечную цель ресурса, которая открывает документ при активации ссылки.</p> - -<p>Значения для {{domxref ("target")}} можно увидеть <a href="https://www.w3.org/TR/2011/REC-SVG11-20110816/linking.html#AElementTargetAttribute">here</a></p> - -<h2 id="Пример">Пример</h2> - -<p>Код взят из <a href="/en-US/docs/Web/API/SVGAElement#Example">"SVGAElement example code"</a></p> - -<pre class="brush: js">... -var linkRef = document.querySelector('a'); -linkRef.target ='_blank'; -...</pre> - -<h2 id="Характеристики">Характеристики</h2> - -<table class="standard-table"> - <tbody> - <tr> - <td>Спецификация</td> - <td>Статус</td> - <td>Комментарий</td> - </tr> - <tr> - <td>{{SpecName('SVG1.1', 'text.html#InterfaceSVGAElement', 'target')}}</td> - <td>{{Spec2('SVG1.1')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Browser_compatibility" name="Browser_compatibility">Совместимость с браузером</h2> - -<p>{{ CompatibilityTable() }}</p> - -<div id="compat-desktop"> -<table class="compat-table"> - <tbody> - <tr> - <th>Feature</th> - <th>Chrome</th> - <th>Firefox (Gecko)</th> - <th>Internet Explorer</th> - <th>Opera</th> - <th>Safari (WebKit)</th> - </tr> - <tr> - <td>Basic support</td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatVersionUnknown() }}</td> - <td>9.0</td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatVersionUnknown() }}</td> - </tr> - </tbody> -</table> -</div> - -<div id="compat-mobile"> -<table class="compat-table"> - <tbody> - <tr> - <th>Feature</th> - <th>Android</th> - <th>Firefox Mobile (Gecko)</th> - <th>IE Mobile</th> - <th>Opera Mobile</th> - <th>Safari Mobile</th> - </tr> - <tr> - <td>Basic support</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatVersionUnknown() }}</td> - </tr> - </tbody> -</table> -</div> - -<h2 id="Смотрите_также">Смотрите также</h2> - -<ul> - <li>{{ SVGAttr("target") }}</li> -</ul> diff --git a/files/ru/conflicting/web/api/web_storage_api/index.html b/files/ru/conflicting/web/api/web_storage_api/index.html deleted file mode 100644 index 80b1e15366..0000000000 --- a/files/ru/conflicting/web/api/web_storage_api/index.html +++ /dev/null @@ -1,369 +0,0 @@ ---- -title: DOM Storage guide -slug: conflicting/Web/API/Web_Storage_API -translation_of: Web/API/Web_Storage_API -translation_of_original: Web/Guide/API/DOM/Storage -original_slug: Web/Guide/API/DOM/Storage ---- -<h2 id="sect1"> </h2> - -<p>DOM хранилище (DOM Storage) - это название для набора инструментов, <a href="http://www.whatwg.org/specs/web-apps/current-work/#storage">относящихся к хранилищам</a>, впервые представленных в спецификации <a class="external" href="http://www.whatwg.org/specs/web-apps/current-work/" title="http://www.whatwg.org/specs/web-apps/current-work/">Web Applications 1.0</a>, и выделенных теперь в отдельную спецификацию <a class="external" href="http://dev.w3.org/html5/webstorage/" title="http://dev.w3.org/html5/webstorage/">W3C Web Storage</a>. DOM хранилище было разработано с целью предоставления альтернативы хранению информации в кукисах. Предполагается, что DOM хранилище предоставляет больше объёма, оно более защищено и легче в использовании. Впервые оно было представлено в браузерах <a href="/en-US/docs/Firefox_2_for_developers" title="Firefox_2_for_developers">Firefox 2</a> и <a class="external" href="http://developer.apple.com/safari/library/documentation/iPhone/Conceptual/SafariJSDatabaseGuide/Name-ValueStorage/Name-ValueStorage.html" title="http://developer.apple.com/safari/library/documentation/iPhone/Conceptual/SafariJSDatabaseGuide/Name-ValueStorage/Name-ValueStorage.html">Safari 4</a>.</p> - -<div class="note"><strong>Примечание:</strong> DOM хранилище - это не то же самое, что <a href="/en-US/docs/Storage" title="Storage">mozStorage</a> (Mozilla's XPCOM interfaces to SQLite) или <a href="/en-US/docs/Session_store_API" title="Session_store_API">Session store API</a> (утилита <a href="/en-US/docs/XPCOM" title="XPCOM">XPCOM</a> - хранилище для использования в расширениях).</div> - -<div class="note"> -<p><strong>Примечание:</strong> Эта статья скоро будет сильно переработана. В<span style="line-height: 1.5;">место того, чтобы хранить всю информацию на одной странице, она будет</span><span style="line-height: 1.5;"> разбита на несколько статей, каждая из которых будет описывать разные </span><span style="line-height: 1.5;">API хранилища. Отдельная статья, помогающая разобраться в разных API, будет также добавлена.</span></p> -</div> - -<h2 id="Описание">Описание</h2> - -<p>Механизм DOM хранилища - средство, благодаря которому можно безопасно хранить и позже извлекать пары "ключ / значение". Целью этого является обеспечение комплексного средства, с помощью которого можно разрабатывать интерактивные приложения(включая приложения с продвинутыми возможностями, такими как возможность работать "автономно"("offline") в течение длительных периодов времени).</p> - -<p>Браузеры на основе Mozilla, Internet Explorer 8 +, Safari 4 + и Chrome обеспечивают рабочую реализацию спецификации DOM хранилища. (В случае, если нужна кросс-браузерная поддержка функциональности, включая более старые версии IE, будет полезно отметить, что IE также имеет подобную легаси функциональность под названием "<a href="http://msdn.microsoft.com/en-us/library/ms531424(VS.85).aspx">USERDATA поведение</a>", которая дополнение DOM хранилище IE в IE8.)</p> - -<p>DOM хранилище удобно, потому что нет других хороших способов хранения разумных объёмов данных за любой период времени, встроенных в браузер. <a href="http://en.wikipedia.org/wiki/HTTP_cookie">Кукисы </a>ограничены в количестве хранимой информации и не обеспечивают поддержку для организации постоянных данных, а другие методы (например, <a href="http://www.macromedia.com/support/documentation/en-US/docs/flashplayer/help/help02.html">флэш-локальное хранилище</a>) требуют плагина.</p> - -<p>Одним из первых известных приложений, использующих новые функциональные возможности DOM хранилища(в дополнение к USERDATA поведения в Internet Explorer) было <a href="http://aaronboodman.com/halfnote/">halfnote </a>(приложение для заметок), написанное <a href="http://aaronboodman.com/">Аароном Будменом</a>. В своём приложении, Аарон одновременно сохранял заметки на сервере (когда/если Интернет-подключение был доступно) и локального хранилища данных(в обратном случае). Это дало возможность пользователю смело писать резервные копии заметок даже при нерегулярном подключении к Интернету.</p> - -<p>Хотя идея и реализация halfnote были сравнительно простыми, создание halfnote показывает возможность для нового поколения веб-приложений, которые можно использовать как в онлайн-, так и офлайн-режиме.</p> - -<h2 id="Связь">Связь</h2> - -<p>Ниже приведены глобальные объекты, которые существуют как свойства каждого объекта <span style="line-height: 1.5;"> </span><code style="line-height: 1.5;"><a href="/en-US/docs/DOM/window" style="line-height: 1.5;" title="DOM/window">window</a></code><span style="line-height: 1.5;">. Это означает, что они могут быть доступны как </span><code style="font-style: normal;">sessionStorage</code> <span style="line-height: 1.5;">или </span><span style="font-family: 'Courier New', 'Andale Mono', monospace; line-height: 1.5;">window.sessionStorage</span><span style="line-height: 1.5;">. (Это важно, потому что вы можете использовать фреймы(IFrames) для хранения или доступа, дополнительные данные кроме того, что сразу же включено на странице.)</span></p> - -<h3 id="Storage"><code>Storage</code></h3> - -<p>Это конструктор<span style="line-height: 1.5;">(</span><code style="font-style: normal; line-height: 1.5;">Storage</code><span style="line-height: 1.5;">) </span><span style="line-height: 1.5;">для всех экземпляров </span><span style="line-height: 1.5;">Storage </span><span style="line-height: 1.5;">(</span><code style="font-style: normal; line-height: 1.5;">sessionStorage</code><span style="line-height: 1.5;"> и </span><code style="font-style: normal; line-height: 1.5;">globalStorage[location.hostname]</code>).</p> - -<p><span style="line-height: 1.5;">С</span><span style="line-height: 1.5;">охранение </span><code style="font-style: normal; line-height: 1.5;">Storage.prototype.removeKey = function(key){ this.removeItem(this.key(key)) }</code><span style="line-height: 1.5;"> будет доступно через </span><code style="font-style: normal; line-height: 1.5;">localStorage.removeKey</code><span style="line-height: 1.5;"> и </span><code style="font-style: normal; line-height: 1.5;">sessionStorage.removeKey</code><span style="line-height: 1.5;">.</span></p> - -<p>Единицы <code>globalStorage</code> являются экземплярами <span style="font-family: 'Courier New', 'Andale Mono', monospace; line-height: 1.5;">StorageObsolete,</span> а <span style="line-height: 1.5;">не </span><code style="font-style: normal; line-height: 1.5;">Storage</code><span style="line-height: 1.5;">.</span></p> - -<p><code>Storage</code> определён в WhatWG <a class="external" href="http://dev.w3.org/html5/webstorage/#storage-0" title="http://dev.w3.org/html5/webstorage/#storage-0">Storage Interface</a> следующим образом:</p> - -<pre class="eval">interface <dfn>Storage</dfn> { - readonly attribute unsigned long <a class="external" href="http://dev.w3.org/html5/webstorage/#dom-storage-length" title="dom-Storage-length">length</a>; - [IndexGetter] DOMString <a class="external" href="http://dev.w3.org/html5/webstorage/#dom-storage-key" title="dom-Storage-key">key</a>(in unsigned long index); - [NameGetter] DOMString <a class="external" href="http://dev.w3.org/html5/webstorage/#dom-storage-getitem" title="dom-Storage-getItem">getItem</a>(in DOMString key); - [NameSetter] void <a class="external" href="http://dev.w3.org/html5/webstorage/#dom-storage-setitem" title="dom-Storage-setItem">setItem</a>(in DOMString key, in DOMString data); - [NameDeleter] void <a class="external" href="http://dev.w3.org/html5/webstorage/#dom-storage-removeitem" title="dom-Storage-removeItem">removeItem</a>(in DOMString key); - void <a class="external" href="http://dev.w3.org/html5/webstorage/#dom-storage-clear" title="dom-Storage-clear">clear</a>(); -}; -</pre> - -<div class="note"><strong>Примечание: </strong>Несмотря на то, что значения доступны для чтения и записи через стандартные способы Javascript, рекомендуется использование <span style="line-height: 1.5;">getItem и setItem.</span></div> - -<div class="note"><strong>Примечание:</strong> Обратите внимание, что любые данные, которые хранятся в любом из хранилищ, описанных на этой странице, преобразуются в строку, используя метод<span style="font-family: 'Courier New', 'Andale Mono', monospace; line-height: 1.5;">.toString</span><span style="line-height: 1.5;">. перед тем, как сохранить значение. Попытка сохранить объект приведёт к сохранению строки </span><code style="font-style: italic;">"[object Object]"</code> <span style="line-height: 1.5;">вместо объекта или его JSON </span><span style="line-height: 1.5;">представления</span><span style="line-height: 1.5;">. Самым лучшим и распространённым способом сохранения объектов в формате строки является использование п</span><span style="line-height: 1.5;">редоставляемых браузером </span><span style="line-height: 1.5;">методов JSON для парсинга</span><span style="line-height: 1.5;"> </span><span style="line-height: 1.5;">и сериализации объектов.</span></div> - -<h3 id="sessionStorage"><code>sessionStorage</code></h3> - -<p>Это глобальный объект <span style="line-height: 1.5;">(</span><code style="font-style: normal; line-height: 1.5;">sessionStorage</code><span style="line-height: 1.5;">), который сохраняет значения, которые доступны в течение периода текущей сессии. Сессия страницы длится, пока браузер открыт, и восстанавливает свои значения после перегрузки страницы. Открытие страницы в новой вкладке или окне приведёт к созданию новой сессии для этой страницы.</span></p> - -<pre class="brush:js">// Сохранить данные в локальное хранилище текущей сессии -sessionStorage.setItem("username", "John"); - -// Получить значения сохранённого значения -alert( "username = " + sessionStorage.getItem("username")); -</pre> - -<p>Объект <code>sessionStorage</code> наиболее полезен для хранения временных данных, которые должны быть восстановлены, если страница браузер была случайно перегружена.</p> - -<p><strong>Примеры:</strong></p> - -<p>Автоматическое сохранение содержимого тестового поля, и если страница была случайно перегружена, то данные не будут потеряны.</p> - -<pre class="brush:js"> // Получить значение текстового поля, которое мы собираемся отслеживать - var field = document.getElementById("field"); - - // Проверяем, что значение поля autosave существует - // (это будет происходить при случайной перезагрузке страницы) - if (sessionStorage.getItem("autosave")) { - // Восстановить значение тестового поля - field.value = sessionStorage.getItem("autosave"); - } - - // Обрабатывать изменения значения текстового поля - field.addEventListener("change", function() { - // И сохранить результаты в объект хранилища сессий - sessionStorage.setItem("autosave", field.value); - }); -</pre> - -<p><strong>Больше информации:</strong></p> - -<ul> - <li><a class="external" href="http://dev.w3.org/html5/webstorage/#the-sessionstorage-attribute" title="http://dev.w3.org/html5/webstorage/#the-sessionstorage-attribute">sessionStorage specification</a></li> -</ul> - -<h3 id="localStorage" name="localStorage"><code>localStorage</code></h3> - -<p><code>localStorage</code> - это то же самое, что и<code> {{ Anch("sessionStorage") }},</code> поддерживает правила единого происхождения(same-origin rules), но хранение данных постоянно. <code>localStorage</code> был представлен в Firefox 3.5.</p> - -<div class="note"><strong>Примечание:</strong> Когда браузер переходит в частный режим браузера(<span style="line-height: 1.5;">private browsing mode), то новая, временная база данных создаётся для хранения данных локального хранилища; эта база данных очищается и удаляется, как только частный режим браузера выключается.</span></div> - -<h4 id="Совместимость">Совместимость</h4> - -<p>Объекты <code>Storage -</code> относительно недавнее дополнение стандарта. Это означает, что они не обязательно должны быть реализованы во всех браузерах. Проблему можно решить с помощью включения следующего куска кода в начале вашего скрипта, позволяя использовать объект <code>localStorage</code> в реализациях, которые нативно не поддерживают его.</p> - -<p>Следующий алгоритм - это точная имитация объекта <code style="font-style: normal; line-height: 1.5;">localStorage,</code> но использует куки.</p> - -<pre class="brush:js">if (!window.localStorage) { - Object.defineProperty(window, "localStorage", new (function () { - var aKeys = [], oStorage = {}; - Object.defineProperty(oStorage, "getItem", { - value: function (sKey) { return sKey ? this[sKey] : null; }, - writable: false, - configurable: false, - enumerable: false - }); - Object.defineProperty(oStorage, "key", { - value: function (nKeyId) { return aKeys[nKeyId]; }, - writable: false, - configurable: false, - enumerable: false - }); - Object.defineProperty(oStorage, "setItem", { - value: function (sKey, sValue) { - if(!sKey) { return; } - document.cookie = escape(sKey) + "=" + escape(sValue) + "; expires=Tue, 19 Jan 2038 03:14:07 GMT; path=/"; - }, - writable: false, - configurable: false, - enumerable: false - }); - Object.defineProperty(oStorage, "length", { - get: function () { return aKeys.length; }, - configurable: false, - enumerable: false - }); - Object.defineProperty(oStorage, "removeItem", { - value: function (sKey) { - if(!sKey) { return; } - document.cookie = escape(sKey) + "=; expires=Thu, 01 Jan 1970 00:00:00 GMT; path=/"; - }, - writable: false, - configurable: false, - enumerable: false - }); - this.get = function () { - var iThisIndx; - for (var sKey in oStorage) { - iThisIndx = aKeys.indexOf(sKey); - if (iThisIndx === -1) { oStorage.setItem(sKey, oStorage[sKey]); } - else { aKeys.splice(iThisIndx, 1); } - delete oStorage[sKey]; - } - for (aKeys; aKeys.length > 0; aKeys.splice(0, 1)) { oStorage.removeItem(aKeys[0]); } - for (var aCouple, iKey, nIdx = 0, aCouples = document.cookie.split(/\s*;\s*/); nIdx < aCouples.length; nIdx++) { - aCouple = aCouples[nIdx].split(/\s*=\s*/); - if (aCouple.length > 1) { - oStorage[iKey = unescape(aCouple[0])] = unescape(aCouple[1]); - aKeys.push(iKey); - } - } - return oStorage; - }; - this.configurable = false; - this.enumerable = true; - })()); -} -</pre> - -<div class="note"><strong>Note:</strong> The maximum size of data that can be saved is severely restricted by the use of cookies. With this algorithm, use the functions <code>localStorage.setItem()</code> and <code>localStorage.removeItem()</code> to add, change, or remove a key. The use of methods <code>localStorage.yourKey = yourValue;</code> and <code>delete localStorage.yourKey;</code> to set or delete a key <strong>is not a secure way with this code</strong>. You can also change its name and use it only to manage a document's cookies regardless of the localStorage object.</div> - -<div class="note"><strong>Note:</strong> By changing the string <code style="background: #ccc;">"; expires=Tue, 19 Jan 2038 03:14:07 GMT; path=/"</code> to: <code style="background: #ccc;">"; path=/"</code> (and changing the object's name), this will become a <code>sessionStorage</code> polyfill rather than a <code>localStorage</code> polyfill. However, this implementation will share stored values across browser tabs and windows (and will only be cleared when all browser windows have been closed), while a fully-compliant <span style="font-family: 'Courier New', 'Andale Mono', monospace; line-height: normal;">sessionStorage</span><span style="line-height: 1.5em;"> implementation restricts stored values to the current browsing context only.</span></div> - -<p>Here is another, less exact, imitation of the <code>localStorage</code> object. It is simpler than the previous one, but it is compatible with old browsers, like Internet Explorer < 8 (<strong>tested and working even in Internet Explorer 6</strong>). It also makes use of cookies.</p> - -<pre class="brush:js">if (!window.localStorage) { - window.localStorage = { - getItem: function (sKey) { - if (!sKey || !this.hasOwnProperty(sKey)) { return null; } - return unescape(document.cookie.replace(new RegExp("(?:^|.*;\\s*)" + escape(sKey).replace(/[\-\.\+\*]/g, "\\$&") + "\\s*\\=\\s*((?:[^;](?!;))*[^;]?).*"), "$1")); - }, - key: function (nKeyId) { - return unescape(document.cookie.replace(/\s*\=(?:.(?!;))*$/, "").split(/\s*\=(?:[^;](?!;))*[^;]?;\s*/)[nKeyId]); - }, - setItem: function (sKey, sValue) { - if(!sKey) { return; } - document.cookie = escape(sKey) + "=" + escape(sValue) + "; expires=Tue, 19 Jan 2038 03:14:07 GMT; path=/"; - this.length = document.cookie.match(/\=/g).length; - }, - length: 0, - removeItem: function (sKey) { - if (!sKey || !this.hasOwnProperty(sKey)) { return; } - document.cookie = escape(sKey) + "=; expires=Thu, 01 Jan 1970 00:00:00 GMT; path=/"; - this.length--; - }, - hasOwnProperty: function (sKey) { - return (new RegExp("(?:^|;\\s*)" + escape(sKey).replace(/[\-\.\+\*]/g, "\\$&") + "\\s*\\=")).test(document.cookie); - } - }; - window.localStorage.length = (document.cookie.match(/\=/g) || window.localStorage).length; -} -</pre> - -<div class="note"><strong>Note:</strong> The maximum size of data that can be saved is severely restricted by the use of cookies. With this algorithm, use the functions <code>localStorage.getItem()</code>, <code>localStorage.setItem()</code>, and <code>localStorage.removeItem()</code> to get, add, change, or remove a key. The use of method <code>localStorage.yourKey</code> in order to get, set, or delete a key <strong>is not permitted with this code</strong>. You can also change its name and use it only to manage a document's cookies regardless of the localStorage object.</div> - -<div class="note"><strong>Note:</strong> By changing the string <code style="background: #ccc;">"; expires=Tue, 19 Jan 2038 03:14:07 GMT; path=/"</code> to: <code style="background: #ccc;">"; path=/"</code> (and changing the object's name), this will become a <code>sessionStorage</code> polyfill rather than a <code>localStorage</code> polyfill. However, this implementation will share stored values across browser tabs and windows (and will only be cleared when all browser windows have been closed), while a fully-compliant <span style="font-family: 'Courier New', 'Andale Mono', monospace; line-height: normal;">sessionStorage</span><span style="line-height: 1.5em;"> implementation restricts stored values to the current browsing context only.</span></div> - -<h4 id="Compatibility_and_relation_with_globalStorage">Compatibility and relation with globalStorage</h4> - -<p class="note"><code>localStorage</code> is also the same as <code>globalStorage[location.hostname]</code>, with the exception of being scoped to an HTML5 origin (scheme + hostname + non-standard port) and <code>localStorage</code> being an instance of <code>Storage</code> as opposed to <code>globalStorage[location.hostname]</code> being an instance of <code>StorageObsolete</code> which is covered below. For example, <a class="external" href="http://example.com" rel="freelink">http://example.com</a> is not able to access the same <code>localStorage</code> object as <a class="link-https" href="https://example.com" rel="freelink">https://example.com</a> but they can access the same <code>globalStorage</code> item. <code>localStorage</code> is a standard interface while <code>globalStorage</code> is non-standard so you shouldn't rely on these.</p> - -<p>Please note that setting a property on <code>globalStorage[location.hostname]</code> does <strong>not</strong> set it on <code>localStorage</code> and extending <code>Storage.prototype</code> does not affect <code>globalStorage</code> items; only extending <code>StorageObsolete.prototype</code> does.</p> - -<h3 id="globalStorage"><code>globalStorage</code></h3> - -<div>{{ Non-standard_header }}{{ obsolete_header("13.0") }}</div> - -<p><code>globalStorage </code>is obsolete since Gecko 1.9.1 (Firefox 3.5) and unsupported since Gecko 13 (Firefox 13). Just use<code> {{ Anch("localStorage") }} </code>instead. This proposed addition to HTML5 has been removed from the HTML5 specification in favor of<code> {{ Anch("localStorage") }}</code>, which is implemented in Firefox 3.5. This is a global object (<code>globalStorage</code>) that maintains multiple private storage areas that can be used to hold data over a long period of time (e.g., over multiple pages and browser sessions).</p> - -<div class="warning">Note: <code>globalStorage</code> is not a <code>Storage</code> instance, but a <code>StorageList</code> instance containing <code>StorageObsolete</code> instances.</div> - -<pre class="eval deki-transform">// Save data that only scripts on the mozilla.org domain can access -globalStorage['mozilla.org'].setItem("snippet", "<b>Hello</b>, how are you?"); -</pre> - -<p>Specifically, the <code>globalStorage</code> object provides access to a number of different storage objects into which data can be stored. For example, if we were to build a web page that used <code>globalStorage</code> on this domain (developer.mozilla.org) we'd have the following storage object available to us:</p> - -<ul> - <li><code>globalStorage{{ mediawiki.external('\'developer.mozilla.org\'') }}</code> - All web pages within the developer.mozilla.org sub-domain can both read and write data to this storage object.</li> -</ul> - -<p><strong>Examples:</strong></p> - -<p>All of these examples require that you have a script inserted (with each of the following code) in every page that you want to see the result on.</p> - -<p>Remember a user's username for the particular sub-domain that is being visited:</p> - -<pre class="eval deki-transform"> globalStorage['developer.mozilla.org'].setItem("username", "John"); -</pre> - -<p>Keep track of the number of times that a user visits all pages of your domain:</p> - -<pre class="eval deki-transform"> // parseInt must be used since all data is stored as a string - globalStorage['mozilla.org'].setItem("visits", parseInt(globalStorage['mozilla.org'].getItem("visits") || 0 ) + 1); -</pre> - -<h2 id="Расположение_хранилища_и_очищение_данных">Расположение хранилища и очищение данных</h2> - -<p>In Firefox the DOM storage data is stored in the <a class="external" href="http://kb.mozillazine.org/Webappsstore.sqlite" title="http://kb.mozillazine.org/Webappsstore.sqlite">webappsstore.sqlite file</a> in the profile folder (there's also chromeappsstore.sqlite file used to store browser's own data, <a class="link-https" href="https://bugzilla.mozilla.org/show_bug.cgi?id=592990" title="https://bugzilla.mozilla.org/show_bug.cgi?id=592990">notably for the start page - about:home</a>, but potentially for other internal pages with "about:" URLs).</p> - -<ul> - <li>DOM Storage can be cleared via "Tools -> Clear Recent History -> Cookies" when Time range is "Everything" (via nsICookieManager::removeAll) - <ul> - <li>But not when another time range is specified: (<a class="link-https" href="https://bugzilla.mozilla.org/show_bug.cgi?id=527667" title="https://bugzilla.mozilla.org/show_bug.cgi?id=527667">bug 527667</a>)</li> - <li>Does not show up in Tools -> Options -> Privacy -> Remove individual cookies (<a class="link-https" href="https://bugzilla.mozilla.org/show_bug.cgi?id=506692" title="https://bugzilla.mozilla.org/show_bug.cgi?id=506692">bug 506692</a>)</li> - </ul> - </li> - <li>DOM Storage is <strong>not</strong> cleared via Tools -> Options -> Advanced -> Network -> Offline data -> Clear Now.</li> - <li>Doesn't show up in the "Tools -> Options -> Advanced -> Network -> Offline data" list, unless the site also uses the offline cache. If the site does appear in that list, its DOM storage data is removed along with the <a href="/en-US/docs/HTML/Using_the_application_cache" title="Offline resources in Firefox">offline cache</a> when clicking the Remove button.</li> -</ul> - -<p>See also <a href="/en-US/docs/HTML/Using_the_application_cache#Storage_location_and_clearing_the_offline_cache" title="Offline resources in Firefox#Storage location and clearing the offline cache">clearing offline resources cache</a>.</p> - -<h2 id="Больше_информации">Больше информации</h2> - -<ul> - <li><a class="external" href="http://www.w3.org/TR/webstorage/" title="http://www.w3.org/TR/webstorage/">Web Storage</a> (W3C Web Apps Working Group)</li> - <li><a class="external" href="http://kb.mozillazine.org/Dom.storage.enabled">Enable/Disable DOM Storage in Firefox or SeaMonkey</a></li> -</ul> - -<h2 id="Примеры">Примеры</h2> - -<ul> - <li><a class="external" href="http://www.diveintojavascript.com/tutorials/web-storage-tutorial-creating-an-address-book-application" title="JavaScript Web Storage Tutorial: Creating an Address Book Application">JavaScript Web Storage Tutorial: Creating an Address Book Application</a> - Hands-on tutorial describing how to use the Web Storage API by creating a simple address book application.</li> - <li><a class="external" href="http://hacks.mozilla.org/2010/01/offline-web-applications/" title="http://hacks.mozilla.org/2010/01/offline-web-applications/">offline web applications</a> at hacks.mozilla.org - Showcases an offline app demo and explains how it works.</li> - <li><a class="external" href="http://noteboard.eligrey.com/" title="http://noteboard.eligrey.com/">Noteboard</a> - Note writing application that stores all data locally.</li> - <li><a class="external" href="http://github.com/eligrey/jData-host" title="http://github.com/eligrey/jData-host">jData</a> - A shared localStorage object interface that can be accessed by any website on the internet and works on Firefox 3+, Webkit 3.1.2+ nightlies, and IE8. Think of it as pseudo-globalStorage[""] but write access needs user confirmation.</li> - <li><a class="external" href="http://codebase.es/test/webstorage.html" title="http://codebase.es/test/webstorage.html">HTML5 localStorage example</a> - Very simple and easy to understand example of localStorage. Saves and retrieves texts and shows a list of saved items. Tested in Firefox 3 or higher.</li> - <li><a class="external" href="http://upload.jonathanwilsson.com/html5/sessionstorage.php" title="http://upload.jonathanwilsson.com/html5/sessionstorage.php">HTML5 Session Storage</a> - A very simple example of session storage. Also includes a example on local storage. Tested in Firefox 3.6 or higher.</li> - <li><a class="external" href="http://channy.creation.net/work/firefox/domstorage/"><strike>Basic DOMStorage Examples</strike></a><strike> - Broken in Firefox 3 and up due to use of globalStorage on one domain level up from the current domain which is not allowed in Firefox 3.</strike></li> - <li><a class="external" href="http://aaronboodman.com/halfnote/"><strike>halfnote</strike></a><strike> - (displaying broken in Firefox 3) Note writing application that uses DOM Storage.</strike></li> -</ul> - -<h2 id="Совместимость_с_браузерами">Совместимость с браузерами</h2> - -<p>{{ CompatibilityTable() }}</p> - -<div id="compat-desktop"> -<table class="compat-table"> - <tbody> - <tr> - <th>Feature</th> - <th>Chrome</th> - <th>Firefox (Gecko)</th> - <th>Internet Explorer</th> - <th>Opera</th> - <th>Safari (WebKit)</th> - </tr> - <tr> - <td>localStorage</td> - <td>4</td> - <td>3.5</td> - <td>8</td> - <td>10.50</td> - <td>4</td> - </tr> - <tr> - <td>sessionStorage</td> - <td>5</td> - <td>2</td> - <td>8</td> - <td>10.50</td> - <td>4</td> - </tr> - <tr> - <td>globalStorage</td> - <td>{{ CompatNo }}</td> - <td>2-13</td> - <td>{{ CompatNo }}</td> - <td>{{ CompatNo }}</td> - <td>{{ CompatNo }}</td> - </tr> - </tbody> -</table> -</div> - -<div id="compat-mobile"> -<table class="compat-table"> - <tbody> - <tr> - <th>Feature</th> - <th>Android</th> - <th>Firefox Mobile (Gecko)</th> - <th>IE Phone</th> - <th>Opera Mobile</th> - <th>Safari Mobile</th> - </tr> - <tr> - <td>Basic support</td> - <td>2.1</td> - <td>{{ CompatUnknown }}</td> - <td>8</td> - <td>11</td> - <td>iOS 3.2</td> - </tr> - </tbody> -</table> -</div> - -<p>All browsers have varying capacity levels for both localStorage and sessionStorage. Here is a <a class="external" href="http://dev-test.nemikor.com/web-storage/support-test/" title="http://dev-test.nemikor.com/web-storage/support-test/">detailed rundown of all the storage capacities for various browsers</a>.</p> - -<div class="note"> -<p><strong>Note: </strong>since iOS 5.1, Safari Mobile stores localStorage data in the cache folder, which is subject to occasional clean up, at the behest of the OS, typically if space is short.</p> -</div> - -<h2 id="Полезные_ссылки">Полезные ссылки</h2> - -<ul> - <li><a class="external" href="http://en.wikipedia.org/wiki/HTTP_cookie">HTTP cookies</a> (<code><a href="/en-US/docs/DOM/document.cookie" title="DOM/document.cookie">document.cookie</a></code>)</li> - <li><a class="external" href="http://www.macromedia.com/support/documentation/en-US/docs/flashplayer/help/help02.html">Flash Local Storage</a></li> - <li><a class="external" href="http://msdn2.microsoft.com/en-us/library/ms531424.aspx">Internet Explorer userData behavior</a></li> - <li><a href="/en-US/docs/XPCOM_Interface_Reference/nsIDOMStorageEventObsolete" title="XPCOM Interface Reference/nsIDOMStorageEventObsolete">nsIDOMStorageEventObsolete</a></li> - <li><a href="/en-US/docs/DOM/event/StorageEvent" title="DOM/Event/StorageEvent">StorageEvent</a></li> - <li><a href="/en-US/docs/DOM/Storage/Implementation" title="/en-US/docs/DOM/Storage/Implementation">Implementation Details</a></li> -</ul> - -<div>{{ HTML5ArticleTOC }}</div> diff --git a/files/ru/conflicting/web/api/webrtc_api/index.html b/files/ru/conflicting/web/api/webrtc_api/index.html deleted file mode 100644 index 6e7c0536eb..0000000000 --- a/files/ru/conflicting/web/api/webrtc_api/index.html +++ /dev/null @@ -1,36 +0,0 @@ ---- -title: WebRTC -slug: conflicting/Web/API/WebRTC_API -translation_of: Web/API/WebRTC_API -translation_of_original: Web/Guide/API/WebRTC -original_slug: Web/Guide/API/WebRTC ---- -<p><strong>WebRTC</strong> (где RTC расшифровывается как Real-Time Communications) - это технология, которая позволяет передавать данные и потоковое аудио/видео между браузерами. Как набор стандартов в целом, WebRTC предоставляет любым поддерживающим этот стандарт, браузерам обмениваться данными и устраивать сеансы телеконференций в режиме точка-точка, без необходимости устанавливать какие-либо плагины и стороннее программное обеспечение.</p> - -<p>Компоненты WebRTC доступны через API JavaScript: Network Stream API, который представляет собой поток аудио и видео данных, PeerConnection API, который позволяет двум и более пользователям общаться браузер-браузер напрямую, DataChannel API, который позволяет обмениваться данными других типов, например в играх в режиме реального времени, текстовые чаты, обмен файлами и так далее.</p> - -<div class="note"> -<p><span style="color: #000000;"><strong>На заметку:</strong> Эта документация находится в процессе переезда <a href="/ru/docs/Web/API/WebRTC_API">в свой новый дом</a>.</span></p> -</div> - -<h2 id="Руководства">Руководства</h2> - -<dl> - <dt><a href="/en-US/docs/WebRTC/Peer-to-peer_communications_with_WebRTC" title="/en-US/docs/WebRTC/Peer-to-peer_communications_with_WebRTC">Обмен данными в режиме точка-точка с WebRTC</a></dt> - <dd>О том, как наладить обмен данными в режиме точка-точка используя API WebRTC.</dd> - <dt><a href="/en-US/docs/Web/Guide/API/WebRTC/WebRTC_architecture">Введение в архитектуру WebRTC</a></dt> - <dd><strong>(AKA "WebRTC and the Ocean of Acronyms")</strong> WebRTC состоит из множества частей и это может быть причиной сложностей для новичков. Эта статья рассказывает обо всех частях и объясняет то как они между собой связаны.</dd> - <dt><a href="/en-US/docs/Web/Guide/API/WebRTC/WebRTC_basics">Основы WebRTC </a></dt> - <dd>Теперь, когда вы уже знаете архитектуру WebRTC, вы можете перейти к этой статье, которая проведёт вас через путь создания кросс-браузерного RTC-приложения</dd> -</dl> - -<h2 id="Ссылки">Ссылки</h2> - -<dl> - <dt><a href="/en-US/docs/Web/API/MediaDevices/getUserMedia">MediaDevices.getUserMedia</a></dt> - <dd>API захвата медиа (видео/аудио)</dd> - <dt><a href="/en-US/docs/Web/API/RTCPeerConnection"><span style="color: #0095dd;">RTCPeerConnection</span></a></dt> - <dd>Интерфейс обработки потоковых данных между двумя пирами.</dd> - <dt><a href="/en-US/docs/Web/API/RTCDataChannel">RTCDataChannel</a></dt> - <dd>Интерфейс передачи произвольных данных через соединение точка-точка.</dd> -</dl> diff --git a/files/ru/conflicting/web/api/webrtc_api/signaling_and_video_calling/index.html b/files/ru/conflicting/web/api/webrtc_api/signaling_and_video_calling/index.html deleted file mode 100644 index fc0da52bbc..0000000000 --- a/files/ru/conflicting/web/api/webrtc_api/signaling_and_video_calling/index.html +++ /dev/null @@ -1,352 +0,0 @@ ---- -title: Основы WebRTC -slug: conflicting/Web/API/WebRTC_API/Signaling_and_video_calling -translation_of: Web/API/WebRTC_API/Signaling_and_video_calling -translation_of_original: Web/API/WebRTC_API/WebRTC_basics -original_slug: Web/API/WebRTC_API/WebRTC_basics ---- -<p>{{WebRTCSidebar}}</p> - -<p>{{Draft}}</p> - -<div class="summary"> -<p>После того, как вы понимаете <a href="https://developer.mozilla.org/en-US/docs/Web/API/WebRTC_API/Architecture" title="/en-US/docs/Web/Guide/API/WebRTC/WebRTC_architecture">WebRTC architecture</a>, вы можете прочитать эту статью, которая сопроводит вас через создание кросс-браузерного RTC приложения. К концу этой документации, вы должны иметь рабочие каналы соединения равноправных узлов ЛВС и передачи данных средств массовой информации.</p> -</div> - -<h2 id="Полу-старое_содержание_из">Полу-старое содержание, из</h2> - -<h2 id="RTCPeerConnection">RTCPeerConnection</h2> - -<p>Материал здесь происходит от RTCPeerConnection; она может остаться здесь, или же может переместится в другое место.</p> - -<p><strong>Основы использования</strong><br> - Базовое использование RTCPeerConnection предполагает переговоры связь между локальной машиной и удалённой машиной один генерируя Session Description Protocol для обмена между ними. Вызывающая программа начинает процесс, отправив предложение на удалённое устройство, которое реагирует либо принять или отклонить запрос на соединение.</p> - -<p>Обе стороны (вызывающий и вызываемый абонент) необходимо настроить свои собственные экземпляры RTCPeerConnection, чтобы представить их конец соединения равноправных узлов ЛВС:</p> - -<pre class="brush: js notranslate">var pc = new RTCPeerConnection(); -pc.onaddstream = function(obj) { - var vid = document.createElement("video"); - document.appendChild(vid); - vid.srcObject = obj.stream; -} - -// функция помощник -function endCall() { - var videos = document.getElementsByTagName("video"); - for (var i = 0; i < videos.length; i++) { - videos[i].pause(); - } - - pc.<a href="#close()">close</a>(); - - -function error(err) { - endCall(); -} -</pre> - -<h3 id="При_инициализации_вызова">При инициализации вызова</h3> - -<p>Если вы один инициирующий вызов, вы будете использовать navigator.getUserMedia(), чтобы получить видеопоток, а затем добавить поток в RTCPeerConnection. Как только это было сделано, вызов RTCPeerConnection, чтобы создать предложение, настроить предложение, а затем отправить его на сервер, через соединение которое было создано.</p> - -<pre class="brush: js notranslate">// Получить список людей с сервера -// Пользователь выбирает список людей, чтобы установить соединение с нужным человеком -navigator.getUserMedia({video: true}, function(stream) { - // Добавление локального потока не вызовет колбэк onaddstream, - // так называют его вручную. - pc.onaddstream = e => video.src = URL.createObjectURL(e.stream); - pc.<a href="#addStream()">addStream</a>(stream); - - pc.<a href="#createOffer()">createOffer</a>(function(offer) { - pc.<a href="#setLocalDescription()">setLocalDescription</a>(offer, function() { - // send the offer to a server to be forwarded to the friend you're calling. - }, error); - }, error); -}); -</pre> - -<h3 id="Ответ_на_вызов">Ответ на вызов</h3> - -<p>На противоположном конце, друг получит предложение от сервера, используя любой протокол используется для того чтобы сделать это. После того, как предложение прибывает, {{domxref ("navigator.getUserMedia ()")}} вновь используется для создания потока, который добавляется к RTCPeerConnection. {{Domxref ("RTCSessionDescription")}} объект создаётся и установить в качестве удалённого описания с помощью вызова {{domxref ("RTCPeerConnection.setRemoteDescription ()")}}.</p> - -<p>Тогда ответ создаётся с помощью RTCPeerConnection.createAnswer () и отправляется обратно на сервер, который направляет его к вызывающему абоненту.</p> - -<pre class="brush: js notranslate">var offer = getOfferFromFriend(); -navigator.getUserMedia({video: true}, function(stream) { - pc.onaddstream = e => video.src = URL.createObjectURL(e.stream); - pc.<a href="#addStream()">addStream</a>(stream); - - pc.setRemoteDescription(new <span class="nx">RTCSessionDescription</span>(offer), function() { - pc.<a href="#createAnswer()">createAnswer</a>(function(answer) { - pc.<a href="#setLocalDescription()">setLocalDescription</a>(answer, function() { - // send the answer to a server to be forwarded back to the caller (you) - }, error); - }, error); - }, error); -}); -</pre> - -<p><strong>Ответ на вызов</strong></p> - -<p>На противоположном конце, человек получит предложение от сервера, используя любой протокол используется для того чтобы сделать это. После того, как предложение принято, navigator.getUserMedia () вновь используется для создания потока, который добавляется к RTCPeerConnection. объект создаётся и установить в качестве удалённого описания с помощью вызова {{domxref ("RTCPeerConnection.setRemoteDescription ()")}}.</p> - -<p>Тогда ответ создаётся с помощью RTCPeerConnection.createAnswer () и отправляется обратно на сервер, который направляет его к вызывающему абоненту.</p> - -<pre class="brush: js notranslate">// ПК был создан раньше, когда мы сделали первоначальное предложение -var offer = getResponseFromFriend(); -pc.<a href="#createAnswer()">setRemoteDescription</a>(new <span class="nx">RTCSessionDescription</span>(offer), function() { }, error);</pre> - -<h2 id="Old_content_follows!">Old content follows!</h2> - -<p>Все, что находится ниже этого пункта, потенциально устарело. Это по-прежнему находится в стадии рассмотрения и возможного включения в другие части документации, если они все ещё актуальны.</p> - -<div class="note"> -<p><strong>Не используйте примеры на этой странице.</strong> Смотрите статью <a href="/en-US/docs/Web/API/WebRTC_API/Signaling_and_video_calling">Signaling and video calling</a> для работы, актуальный пример с использованием WebRTC media.</p> -</div> - -<h3 id="Note">Note</h3> - -<p>Due to recent changes in the API there are many old examples that require fixing:</p> - -<ul> - <li><a href="http://louisstow.github.io/WebRTC/media.html">louisstow</a></li> - <li><a href="http://mozilla.github.io/webrtc-landing/">mozilla</a></li> - <li><a href="https://www.webrtc-experiment.com/">webrtc-experiment</a></li> -</ul> - -<p>The currently working example is:</p> - -<ul> - <li><a href="https://apprtc.appspot.com">apprtc</a> (<a href="https://github.com/webrtc/apprtc">source</a>)</li> -</ul> - -<p>Implementation may be inferred from the <a href="http://w3c.github.io/webrtc-pc/">specification</a>.</p> - -<p>This remainder of this page contains outdated information as <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=1119285">noted on bugzilla</a>.</p> - -<h3 id="Shims">Shims</h3> - -<p>As you can imagine, with such an early API, you must use the browser prefixes and shim it to a common variable.</p> - -<pre class="brush: js notranslate">var RTCPeerConnection = window.mozRTCPeerConnection || window.webkitRTCPeerConnection; -var IceCandidate = window.mozRTCIceCandidate || window.RTCIceCandidate; -var SessionDescription = window.mozRTCSessionDescription || window.RTCSessionDescription; -navigator.getUserMedia = navigator.getUserMedia || navigator.mozGetUserMedia || navigator.webkitGetUserMedia;</pre> - -<h3 id="RTCPeerConnection_2">RTCPeerConnection</h3> - -<p>This is the starting point to creating a connection with a peer. It accepts configuration options about ICE servers to use to establish a connection.</p> - -<pre class="brush: js notranslate">var pc = new RTCPeerConnection(configuration);</pre> - -<h3 id="RTCConfiguration"><strong><code>RTCConfiguration</code></strong></h3> - -<p>The {{domxref("RTCConfiguration")}} object contains information about which TURN and/or STUN servers to use for ICE. This is required to ensure most users can actually create a connection by avoiding restrictions in NAT and firewalls.</p> - -<pre class="brush: js notranslate">var configuration = { - iceServers: [ - {urls: "stun:23.21.150.121"}, - {urls: "stun:stun.l.google.com:19302"}, - {urls: "turn:numb.viagenie.ca", credential: "webrtcdemo", username: "louis%40mozilla.com"} - ] -}</pre> - -<p>Google runs a <a href="https://code.google.com/p/natvpn/source/browse/trunk/stun_server_list">public STUN server</a> that we can use. I also created an account at http://numb.viagenie.ca/ for a free TURN server to access. You may want to do the same and replace with your own credentials.</p> - -<h3 id="ICECandidate">ICECandidate</h3> - - - -<p>After creating the PeerConnection and passing in the available <a href="/en-US/docs/Web/Guide/API/WebRTC/WebRTC_architecture#What_is_STUN.3F">STUN</a> and <a href="/en-US/docs/Web/Guide/API/WebRTC/WebRTC_architecture#What_is_TURN.3F">TURN</a> servers, an event will be fired once the ICE framework has found some “candidates” that will allow you to connect with a peer. This is known as an ICE Candidate and will execute a callback function on <a href="/en-US/docs/Web/API/RTCPeerConnection.onicecandidate">PeerConnection#onicecandidate</a>.</p> - -<pre class="brush: js notranslate" lang="javascript">pc.onicecandidate = function (e) { - // candidate exists in e.candidate - if (!e.candidate) return; - send("icecandidate", JSON.stringify(e.candidate)); -};</pre> - -<p>When the callback is executed, we must use the signal channel to send the Candidate to the peer. On Chrome, multiple ICE candidates are usually found, we only need one so I typically send the first one then remove the handler. Firefox includes the Candidate in the Offer SDP.</p> - -<h3 id="Signal_Channel">Signal Channel</h3> - -<p>Now that we have an ICE candidate, we need to send that to our peer so they know how to connect with us. However this leaves us with a chicken and egg situation; we want PeerConnection to send data to a peer but before that we need to send them metadata…</p> - -<p>This is where the signal channel comes in. It’s any method of data transport that allows two peers to exchange information. In this article, we’re going to use <a href="http://firebase.com">FireBase</a> because it’s incredibly easy to setup and doesn't require any hosting or server-code.</p> - -<p>For now just imagine two methods exist: <code>send()</code> will take a key and assign data to it and <code>recv()</code> will call a handler when a key has a value.</p> - -<p>The structure of the database will look like this:</p> - -<pre class="brush: js notranslate" lang="json">{ - "": { - "candidate:": … - "offer": … - "answer": … - } -}</pre> - -<p>Connections are divided by a <code>roomId</code> and will store 4 pieces of information, the ICE candidate from the offerer, the ICE candidate from the answerer, the offer SDP and the answer SDP.</p> - -<h3 id="Offer">Offer</h3> - -<p>An Offer SDP (Session Description Protocol) is metadata that describes to the other peer the format to expect (video, formats, codecs, encryption, resolution, size, etc etc).</p> - -<p>An exchange requires an offer from a peer, then the other peer must receive the offer and provide back an answer.</p> - -<pre class="brush: js notranslate" lang="javascript">pc.createOffer(function (offer) { - pc.setLocalDescription(offer, function() { - send("offer", JSON.stringify(pc.localDescription); - }, errorHandler); -}, errorHandler, options);</pre> - -<h4 id="errorHandler"><strong><code>errorHandler</code></strong></h4> - -<p>If there was an issue generating an offer, this method will be executed with error details as the first argument.</p> - -<pre class="brush: js notranslate" lang="javascript">var errorHandler = function (err) { - console.error(err); -};</pre> - -<h5 id="options"><strong><code>options</code></strong></h5> - -<p>Options for the offer SDP.</p> - -<pre class="brush: js notranslate" lang="javascript">var options = { - offerToReceiveAudio: true, - offerToReceiveVideo: true -};</pre> - -<p><code>offerToReceiveAudio/Video</code> tells the other peer that you would like to receive video or audio from them. This is not needed for DataChannels.</p> - -<p>Once the offer has been generated we must set the local SDP to the new offer and send it through the signal channel to the other peer and await their Answer SDP.</p> - -<h3 id="Answer">Answer</h3> - -<p>An Answer SDP is just like an offer but a response; sort of like answering the phone. We can only generate an answer once we have received an offer.</p> - -<pre class="brush: js notranslate" lang="javascript">recv("offer", function (offer) { - offer = new SessionDescription(JSON.parse(offer)) - pc.setRemoteDescription(offer); - - pc.createAnswer(function (answer) { - pc.setLocalDescription(answer, function() { - send("answer", JSON.stringify(pc.localDescription)); - }, errorHandler); - }, errorHandler); -});</pre> - -<h3 id="DataChannel">DataChannel</h3> - -<p>I will first explain how to use PeerConnection for the DataChannels API and transferring arbitrary data between peers.</p> - -<p><em>Note: At the time of this article, interoperability between Chrome and Firefox is not possible with DataChannels. Chrome supports a similar but private protocol and will be supporting the standard protocol soon.</em></p> - -<pre class="brush: js notranslate" lang="javascript">var channel = pc.createDataChannel(channelName, channelOptions);</pre> - -<p>The offerer should be the peer who creates the channel. The answerer will receive the channel in the callback <code>ondatachannel</code> on PeerConnection. You must call <code>createDataChannel()</code> once before creating the offer.</p> - -<h4 id="channelName"><strong><code>channelName</code></strong></h4> - -<p>This is a string that acts as a label for your channel name. <em>Warning: Make sure your channel name has no spaces or Chrome will fail on <code>createAnswer()</code>.</em></p> - -<h4 id="channelOptions"><strong><code>channelOptions</code></strong></h4> - -<pre class="brush: js notranslate" lang="javascript">var channelOptions = {};</pre> - -<p>Currently these options are not well supported on Chrome so you can leave this empty for now. Check the <a href="http://dev.w3.org/2011/webrtc/editor/webrtc.html#attributes-7">RFC</a> for more information about the options.</p> - -<h4 id="Channel_Events_and_Methods">Channel Events and Methods</h4> - -<h5 id="onopen"><strong><code>onopen</code></strong></h5> - -<p>Executed when the connection is established.</p> - -<h5 id="onerror"><strong><code>onerror</code></strong></h5> - -<p>Executed if there is an error creating the connection. First argument is an error object.</p> - -<pre class="brush: js notranslate" lang="javascript">channel.onerror = function (err) { - console.error("Channel Error:", err); -};</pre> - -<h5 id="onmessage"><strong><code>onmessage</code></strong></h5> - -<pre class="brush: js notranslate" lang="javascript">channel.onmessage = function (e) { - console.log("Got message:", e.data); -}</pre> - -<p>The heart of the connection. When you receive a message, this method will execute. The first argument is an event object which contains the data, time received and other information.</p> - -<h5 id="onclose"><strong><code>onclose</code></strong></h5> - -<p>Executed if the other peer closes the connection.</p> - -<h4 id="Binding_the_Events"><strong>Binding the Events</strong></h4> - -<p>If you were the creator of the channel (meaning the offerer), you can bind events directly to the DataChannel you created with <code>createChannel</code>. If you are the answerer, you must use the <code>ondatachannel</code> callback on PeerConnection to access the same channel.</p> - -<pre class="brush: js notranslate" lang="javascript">pc.ondatachannel = function (e) { - e.channel.onmessage = function () { … }; -};</pre> - -<p>The channel is available in the event object passed into the handler as <code>e.channel</code>.</p> - -<h5 id="send"><strong><code>send()</code></strong></h5> - -<pre class="brush: js notranslate" lang="javascript">channel.send("Hi Peer!");</pre> - -<p>This method allows you to send data directly to the peer! Amazing. You must send either String, Blob, ArrayBuffer or ArrayBufferView, so be sure to stringify objects.</p> - -<h5 id="close"><strong><code>close()</code></strong></h5> - -<p>Close the channel once the connection should end. It is recommended to do this on page unload.</p> - -<h3 id="Media">Media</h3> - -<p>Now we will cover transmitting media such as audio and video. To display the video and audio you must include a <code><video></code> tag on the document with the attribute <code>autoplay</code>.</p> - -<h4 id="Get_User_Media">Get User Media</h4> - -<pre class="brush: js notranslate"><video id="preview" autoplay></video> - -var video = document.getElementById("preview"); -navigator.getUserMedia(constraints, function (stream) { - video.src = URL.createObjectURL(stream); -}, errorHandler);</pre> - -<p><strong><code>constraints</code></strong></p> - -<p>Constraints on what media types you want to return from the user.</p> - -<pre class="brush: js notranslate" lang="javascript">var constraints = { - video: true, - audio: true -};</pre> - -<p>If you just want an audio chat, remove the <code>video</code> member.</p> - -<h5 id="errorHandler_2"><strong><code>errorHandler</code></strong></h5> - -<p>Executed if there is an error returning the requested media.</p> - -<h4 id="Media_Events_and_Methods">Media Events and Methods</h4> - -<h5 id="addStream"><strong><code>addStream</code></strong></h5> - -<p>Add the stream from <code>getUserMedia</code> to the PeerConnection.</p> - -<pre class="brush: js notranslate" lang="javascript">pc.addStream(stream);</pre> - -<h5 id="onaddstream"><strong><code>onaddstream</code></strong></h5> - -<pre class="brush: js notranslate"><video id="otherPeer" autoplay></video> - -var otherPeer = document.getElementById("otherPeer"); -pc.onaddstream = function (e) { - otherPeer.src = URL.createObjectURL(e.stream); -};</pre> - -<p>Executed when the connection has been setup and the other peer has added the stream to the peer connection with <code>addStream</code>. You need another <code><video></code> tag to display the other peer's media.</p> - -<p>The first argument is an event object with the other peer's media stream.</p> diff --git a/files/ru/conflicting/web/api/window/localstorage/index.html b/files/ru/conflicting/web/api/window/localstorage/index.html deleted file mode 100644 index 5e87d8edc8..0000000000 --- a/files/ru/conflicting/web/api/window/localstorage/index.html +++ /dev/null @@ -1,147 +0,0 @@ ---- -title: LocalStorage -slug: conflicting/Web/API/Window/localStorage -translation_of: Web/API/Window/localStorage -translation_of_original: Web/API/Web_Storage_API/Local_storage -original_slug: Web/API/Storage/LocalStorage ---- -<p><code>localStorage</code> это аналог <code><a href="/en-US/docs/Web/API/sessionStorage">sessionStorage</a></code>, с некоторыми same-origin правилами, но значения хранятся постоянно (в отличии от sessions). <code>localStorage</code> появился в Firefox 3.5.</p> - -<div class="note"><strong>Примечание:</strong> Когда браузер переходит в режим приватного просмотра, создаётся новое временное хранилище. Изначально оно пустое. После выхода из режима приватного просмотра временное хранилище очищается.</div> - -<pre class="brush:js" style="font-size: 14px;">// Сохраняет данные в текущий local store -localStorage.setItem("username", "John"); - -// Извлекает ранее сохранённые данные -alert( "username = " + localStorage.getItem("username"));</pre> - -<p class="note"><code>localStorage</code>'s позволяет постоянно хранить некоторую полезную информацию, включая счётчики посещения страницы, как показано в примере <a href="http://codepen.io/awesom3/pen/Hlfma">this tutorial on Codepen</a>.</p> - -<h4 id="Совместимость" style="line-height: 18px; font-size: 1.28571428571429rem;">Совместимость</h4> - -<p><code>Storage</code> objects недавно добавлен в стандарт. Он может отсутствовать в некоторых браузерах. Вы можете работать с этой технологией добавив в страницу один из двух скриптов, которые представлены ниже. <code>localStorage</code> object реализуется программно, если нет встроенной реализации.</p> - -<p>Этот алгоритм является точной имитацией <code>localStorage</code> object, но для хранения использует cookies.</p> - -<pre class="brush:js" style="font-size: 14px;">if (!window.localStorage) { - Object.defineProperty(window, "localStorage", new (function () { - var aKeys = [], oStorage = {}; - Object.defineProperty(oStorage, "getItem", { - value: function (sKey) { return sKey ? this[sKey] : null; }, - writable: false, - configurable: false, - enumerable: false - }); - Object.defineProperty(oStorage, "key", { - value: function (nKeyId) { return aKeys[nKeyId]; }, - writable: false, - configurable: false, - enumerable: false - }); - Object.defineProperty(oStorage, "setItem", { - value: function (sKey, sValue) { - if(!sKey) { return; } - document.cookie = escape(sKey) + "=" + escape(sValue) + "; expires=Tue, 19 Jan 2038 03:14:07 GMT; path=/"; - }, - writable: false, - configurable: false, - enumerable: false - }); - Object.defineProperty(oStorage, "length", { - get: function () { return aKeys.length; }, - configurable: false, - enumerable: false - }); - Object.defineProperty(oStorage, "removeItem", { - value: function (sKey) { - if(!sKey) { return; } - document.cookie = escape(sKey) + "=; expires=Thu, 01 Jan 1970 00:00:00 GMT; path=/"; - }, - writable: false, - configurable: false, - enumerable: false - }); - Object.defineProperty(oStorage, "clear", { - value: function () { - if(!aKeys.length) { return; } - for (var sKey in aKeys) { - document.cookie = escape(sKey) + "=; expires=Thu, 01 Jan 1970 00:00:00 GMT; path=/"; - } - }, - writable: false, - configurable: false, - enumerable: false - }); - this.get = function () { - var iThisIndx; - for (var sKey in oStorage) { - iThisIndx = aKeys.indexOf(sKey); - if (iThisIndx === -1) { oStorage.setItem(sKey, oStorage[sKey]); } - else { aKeys.splice(iThisIndx, 1); } - delete oStorage[sKey]; - } - for (aKeys; aKeys.length > 0; aKeys.splice(0, 1)) { oStorage.removeItem(aKeys[0]); } - for (var aCouple, iKey, nIdx = 0, aCouples = document.cookie.split(/\s*;\s*/); nIdx < aCouples.length; nIdx++) { - aCouple = aCouples[nIdx].split(/\s*=\s*/); - if (aCouple.length > 1) { - oStorage[iKey = unescape(aCouple[0])] = unescape(aCouple[1]); - aKeys.push(iKey); - } - } - return oStorage; - }; - this.configurable = false; - this.enumerable = true; - })()); -} -</pre> - -<div class="note"><strong>Примечание:</strong> Максимальный размер данных, которые могут быть сохранены, ограничен возможностями cookies. Используйте functions <code>localStorage.setItem()</code> и <code>localStorage.removeItem()</code> для добавления, изменения, или удаления ключа. Использование прямого присвоения <code>localStorage.yourKey = yourValue;</code> и <code>delete localStorage.yourKey;</code> для установки и удаления ключа <strong>не безопасно с этим кодом</strong>. Вы также можете изменить это имя (вместо window.localStorage прописать другое имя) и использовать объект для управления document's cookies, не обращая внимания на localStorage object.</div> - -<div class="note"><strong>Примечание:</strong> Если изменить строку <code style="background: rgb(204, 204, 204);">"; expires=Tue, 19 Jan 2038 03:14:07 GMT; path=/"</code> на: <code style="background: rgb(204, 204, 204);">"; path=/"</code> (и изменить имя объекта), он превратится в <code>sessionStorage</code> polyfill больше, чем в <code>localStorage</code> polyfill. Однако эта реализация будет хранить общие значения для всех вкладок и окон браузера (and will only be cleared when all browser windows have been closed), в то время как полностью совместимая <span style="font-family: 'Courier New','Andale Mono',monospace; line-height: normal;">sessionStorage</span><span style="line-height: 1.5em;"> реализация хранит значения</span><span style="line-height: 1.5em;"> to the current browsing context only.</span></div> - -<p>Here is another, less exact, imitation of the <code>localStorage</code> object. It is simpler than the previous one, but it is compatible with old browsers, like Internet Explorer < 8 (<strong>tested and working even in Internet Explorer 6</strong>). It also makes use of cookies.</p> - -<pre class="brush:js" style="font-size: 14px;">if (!window.localStorage) { - window.localStorage = { - getItem: function (sKey) { - if (!sKey || !this.hasOwnProperty(sKey)) { return null; } - return unescape(document.cookie.replace(new RegExp("(?:^|.*;\\s*)" + escape(sKey).replace(/[\-\.\+\*]/g, "\\$&") + "\\s*\\=\\s*((?:[^;](?!;))*[^;]?).*"), "$1")); - }, - key: function (nKeyId) { - return unescape(document.cookie.replace(/\s*\=(?:.(?!;))*$/, "").split(/\s*\=(?:[^;](?!;))*[^;]?;\s*/)[nKeyId]); - }, - setItem: function (sKey, sValue) { - if(!sKey) { return; } - document.cookie = escape(sKey) + "=" + escape(sValue) + "; expires=Tue, 19 Jan 2038 03:14:07 GMT; path=/"; - this.length = document.cookie.match(/\=/g).length; - }, - length: 0, - removeItem: function (sKey) { - if (!sKey || !this.hasOwnProperty(sKey)) { return; } - document.cookie = escape(sKey) + "=; expires=Thu, 01 Jan 1970 00:00:00 GMT; path=/"; - this.length--; - }, - hasOwnProperty: function (sKey) { - return (new RegExp("(?:^|;\\s*)" + escape(sKey).replace(/[\-\.\+\*]/g, "\\$&") + "\\s*\\=")).test(document.cookie); - } - }; - window.localStorage.length = (document.cookie.match(/\=/g) || window.localStorage).length; -} -</pre> - -<div class="note"><strong>Note:</strong> The maximum size of data that can be saved is severely restricted by the use of cookies. With this algorithm, use the functions <code>localStorage.getItem()</code>, <code>localStorage.setItem()</code>, and <code>localStorage.removeItem()</code> to get, add, change, or remove a key. The use of method <code>localStorage.yourKey</code> in order to get, set, or delete a key <strong>is not permitted with this code</strong>. You can also change its name and use it only to manage a document's cookies regardless of the localStorage object.</div> - -<div class="note"><strong>Note:</strong> By changing the string <code style="background: rgb(204, 204, 204);">"; expires=Tue, 19 Jan 2038 03:14:07 GMT; path=/"</code> to: <code style="background: rgb(204, 204, 204);">"; path=/"</code> (and changing the object's name), this will become a <code>sessionStorage</code> polyfill rather than a <code>localStorage</code> polyfill. However, this implementation will share stored values across browser tabs and windows (and will only be cleared when all browser windows have been closed), while a fully-compliant <span style="font-family: 'Courier New','Andale Mono',monospace; line-height: normal;">sessionStorage</span><span style="line-height: 1.5em;"> implementation restricts stored values to the current browsing context only.</span></div> - -<h4 id="Compatibility_and_relation_with_globalStorage" style="line-height: 18px; font-size: 1.28571428571429rem;">Compatibility and relation with globalStorage</h4> - -<p class="note"><code>localStorage</code> is also the same as <code>globalStorage[location.hostname]</code>, with the exception of being scoped to an HTML5 origin (scheme + hostname + non-standard port) and <code>localStorage</code> being an instance of <code>Storage</code> as opposed to <code>globalStorage[location.hostname]</code> being an instance of <code>StorageObsolete</code> which is covered below. For example, <a class="external" href="http://example.com" rel="freelink">http://example.com</a> is not able to access the same <code>localStorage</code> object as <a class="link-https" href="https://example.com" rel="freelink">https://example.com</a> but they can access the same <code>globalStorage</code> item. <code>localStorage</code> is a standard interface while <code>globalStorage</code> is non-standard so you shouldn't rely on these.</p> - -<p>Please note that setting a property on <code>globalStorage[location.hostname]</code> does <strong>not</strong> set it on <code>localStorage</code> and extending <code>Storage.prototype</code> does not affect <code>globalStorage</code> items; only extending <code>StorageObsolete.prototype</code> does.</p> - -<h4 id="Storage_format">Storage format</h4> - -<p><code>Storage</code> keys and values are both stored in the UTF-16 <a href="/en-US/docs/Web/API/DOMString">DOMString</a> format, which uses 2 bytes per character.</p> - -<p> </p> diff --git a/files/ru/conflicting/web/api/windoworworkerglobalscope/index.html b/files/ru/conflicting/web/api/windoworworkerglobalscope/index.html deleted file mode 100644 index 69bc73a64f..0000000000 --- a/files/ru/conflicting/web/api/windoworworkerglobalscope/index.html +++ /dev/null @@ -1,122 +0,0 @@ ---- -title: WindowBase64 -slug: conflicting/Web/API/WindowOrWorkerGlobalScope -tags: - - API - - HTML-DOM - - Helper - - NeedsTranslation - - TopicStub - - WindowBase64 -translation_of: Web/API/WindowOrWorkerGlobalScope -translation_of_original: Web/API/WindowBase64 -original_slug: Web/API/WindowBase64 ---- -<p>{{APIRef("HTML DOM")}}</p> - -<p>The <code><strong>WindowBase64</strong></code> helper contains utility methods to convert data to and from base64, a binary-to-text encoding scheme. For example it is used in <a href="/en-US/docs/data_URIs">data URIs</a>.</p> - -<p>There is no object of this type, though the context object, either the {{domxref("Window")}} for regular browsing scope, or the {{domxref("WorkerGlobalScope")}} for workers, implements it.</p> - -<h2 id="Properties">Properties</h2> - -<p><em>This helper neither defines nor inherits any properties.</em></p> - -<h2 id="Methods">Methods</h2> - -<p><em>This helper does not inherit any methods.</em></p> - -<dl> - <dt>{{domxref("WindowBase64.atob()")}}</dt> - <dd>Decodes a string of data which has been encoded using base-64 encoding.</dd> - <dt>{{domxref("WindowBase64.btoa()")}}</dt> - <dd>Creates a base-64 encoded ASCII string from a string of binary data.</dd> -</dl> - -<h2 id="Specifications">Specifications</h2> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Specification</th> - <th scope="col">Status</th> - <th scope="col">Comment</th> - </tr> - </thead> - <tbody> - <tr> - <td>{{SpecName('HTML WHATWG', '#windowbase64', 'WindowBase64')}}</td> - <td>{{Spec2('HTML WHATWG')}}</td> - <td>No change since the latest snapshot, {{SpecName("HTML5.1")}}.</td> - </tr> - <tr> - <td>{{SpecName('HTML5.1', '#windowbase64', 'WindowBase64')}}</td> - <td>{{Spec2('HTML5.1')}}</td> - <td>Snapshot of {{SpecName("HTML WHATWG")}}. No change.</td> - </tr> - <tr> - <td>{{SpecName("HTML5 W3C", "#windowbase64", "WindowBase64")}}</td> - <td>{{Spec2('HTML5 W3C')}}</td> - <td>Snapshot of {{SpecName("HTML WHATWG")}}. Creation of <code>WindowBase64</code> (properties where on the target before it).</td> - </tr> - </tbody> -</table> - -<h2 id="Browser_compatibility">Browser compatibility</h2> - -<p>{{CompatibilityTable}}</p> - -<div id="compat-desktop"> -<table class="compat-table"> - <tbody> - <tr> - <th>Feature</th> - <th>Firefox (Gecko)</th> - <th>Chrome</th> - <th>Internet Explorer</th> - <th>Opera</th> - <th>Safari</th> - </tr> - <tr> - <td>Basic support</td> - <td>{{CompatGeckoDesktop(1)}} [1]</td> - <td>{{CompatVersionUnknown}}</td> - <td>10.0</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - </tr> - </tbody> -</table> -</div> - -<div id="compat-mobile"> -<table class="compat-table"> - <tbody> - <tr> - <th>Feature</th> - <th>Firefox Mobile (Gecko)</th> - <th>Android</th> - <th>IE Mobile</th> - <th>Opera Mobile</th> - <th>Safari Mobile</th> - </tr> - <tr> - <td>Basic support</td> - <td>{{CompatGeckoMobile(1)}}</td> - <td rowspan="1">{{CompatVersionUnknown}}</td> - <td rowspan="1">{{CompatVersionUnknown}}</td> - <td rowspan="1">{{CompatVersionUnknown}}</td> - <td rowspan="1">{{CompatVersionUnknown}}</td> - </tr> - </tbody> -</table> -</div> - -<p>[1] <code>atob()</code> is also available to XPCOM components implemented in JavaScript, even though {{domxref("Window")}} is not the global object in components.</p> - -<h2 id="See_also">See also</h2> - -<ul> - <li><a href="/Web/API/WindowBase64/Base64_encoding_and_decoding">Base64 encoding and decoding</a></li> - <li>{{domxref("Window")}}, {{domxref("WorkerGlobalScope")}}, {{domxref("DedicatedWorkerGlobalScope")}}, {{domxref("SharedWorkerGlobalScope")}}, and {{domxref("ServiceWorkerGlobalScope")}}</li> -</ul> diff --git a/files/ru/conflicting/web/api/windoworworkerglobalscope_e2691f7ad05781a30c5fc5bb3b3f633a/index.html b/files/ru/conflicting/web/api/windoworworkerglobalscope_e2691f7ad05781a30c5fc5bb3b3f633a/index.html deleted file mode 100644 index 21a473532e..0000000000 --- a/files/ru/conflicting/web/api/windoworworkerglobalscope_e2691f7ad05781a30c5fc5bb3b3f633a/index.html +++ /dev/null @@ -1,121 +0,0 @@ ---- -title: WindowTimers -slug: conflicting/Web/API/WindowOrWorkerGlobalScope_e2691f7ad05781a30c5fc5bb3b3f633a -tags: - - API - - HTML DOM -translation_of: Web/API/WindowOrWorkerGlobalScope -translation_of_original: Web/API/WindowTimers -original_slug: Web/API/WindowTimers ---- -<div>{{APIRef("HTML DOM")}}</div> - -<p><code><strong>WindowTimers</strong></code> contains utility methods to set and clear timers.</p> - -<p>There is no object of this type, though the context object, either the {{domxref("Window")}} for regular browsing scope, or the {{domxref("WorkerGlobalScope")}} for workers, implements it.</p> - -<h2 id="Properties">Properties</h2> - -<p><em>This interface do not define any property, nor inherit any.</em></p> - -<h2 id="Methods">Methods</h2> - -<p><em>This interface do not inherit any method.</em></p> - -<dl> - <dt>{{domxref("WindowTimers.clearInterval()")}}</dt> - <dd>Cancels the repeated execution set using {{domxref("WindowTimers.setInterval()")}}.</dd> - <dt>{{domxref("WindowTimers.clearTimeout()")}}</dt> - <dd>Cancels the repeated execution set using {{domxref("WindowTimers.setTimeout()")}}.</dd> - <dt>{{domxref("WindowTimers.setInterval()")}}</dt> - <dd>Schedules the execution of a function each X milliseconds.</dd> - <dt>{{domxref("WindowTimers.setTimeout()")}}</dt> - <dd>Sets a delay for executing a function.</dd> -</dl> - -<h2 id="Specifications">Specifications</h2> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Specification</th> - <th scope="col">Status</th> - <th scope="col">Comment</th> - </tr> - </thead> - <tbody> - <tr> - <td>{{SpecName('HTML WHATWG', '#windowtimers', 'WindowTimers')}}</td> - <td>{{Spec2('HTML WHATWG')}}</td> - <td>No change since the latest snapshot, {{SpecName("HTML5.1")}}.</td> - </tr> - <tr> - <td>{{SpecName('HTML5.1', '#windowtimers', 'WindowTimers')}}</td> - <td>{{Spec2('HTML5.1')}}</td> - <td>Snapshot of {{SpecName("HTML WHATWG")}}. No change.</td> - </tr> - <tr> - <td>{{SpecName("HTML5 W3C", "#windowtimers", "WindowTimers")}}</td> - <td>{{Spec2('HTML5 W3C')}}</td> - <td>Snapshot of {{SpecName("HTML WHATWG")}}. Creation of <code>WindowBase64</code> (properties where on the target before it).</td> - </tr> - </tbody> -</table> - -<h2 id="Browser_compatibility">Browser compatibility</h2> - -<p>{{CompatibilityTable}}</p> - -<div id="compat-desktop"> -<table class="compat-table"> - <tbody> - <tr> - <th>Feature</th> - <th>Firefox (Gecko)</th> - <th>Chrome</th> - <th>Internet Explorer</th> - <th>Opera</th> - <th>Safari</th> - </tr> - <tr> - <td>Basic support</td> - <td>{{CompatGeckoDesktop(1)}}</td> - <td>1.0</td> - <td>4.0</td> - <td>4.0</td> - <td>1.0</td> - </tr> - </tbody> -</table> -</div> - -<div id="compat-mobile"> -<table class="compat-table"> - <tbody> - <tr> - <th>Feature</th> - <th>Firefox Mobile (Gecko)</th> - <th>Android</th> - <th>IE Mobile</th> - <th>Opera Mobile</th> - <th>Safari Mobile</th> - </tr> - <tr> - <td>Basic support</td> - <td>{{CompatGeckoMobile(1)}}</td> - <td rowspan="1">{{CompatVersionUnknown}}</td> - <td rowspan="1">{{CompatVersionUnknown}}</td> - <td rowspan="1">{{CompatVersionUnknown}}</td> - <td rowspan="1">{{CompatVersionUnknown}}</td> - </tr> - </tbody> -</table> -</div> - -<p> </p> - -<h2 id="See_also">See also</h2> - -<ul> - <li>{{domxref("Window")}}, {{domxref("WorkerGlobalScope")}}, {{domxref("DedicatedWorkerGlobalScope")}}, {{domxref("SharedWorkerGlobalScope")}}, and {{domxref("ServiceWorkerGlobalScope")}}</li> -</ul> diff --git a/files/ru/conflicting/web/api/xmlhttprequest/index.html b/files/ru/conflicting/web/api/xmlhttprequest/index.html deleted file mode 100644 index 10503ded9b..0000000000 --- a/files/ru/conflicting/web/api/xmlhttprequest/index.html +++ /dev/null @@ -1,283 +0,0 @@ ---- -title: XMLHttpRequest -slug: conflicting/Web/API/XMLHttpRequest -tags: - - AJAX - - XMLHttpRequest -original_slug: XMLHttpRequest ---- -<p><code>XMLHttpRequest</code> — это объект <a href="/ru/JavaScript" title="ru/JavaScript">JavaScript</a>, созданный Microsoft и адаптированный Mozilla. Вы можете использовать его для простой передачи данных через HTTP. Несмотря на своё название, он может быть использован не только для XML документов, но и, например, для <a href="/ru/JSON" title="ru/JSON">JSON</a>.</p> - -<p>Оставшаяся часть статьи может содержать информацию, специфичную для <a href="/ru/Gecko" title="ru/Gecko">Gecko</a> или привилегированного кода, такого как дополнения.</p> - -<p>В Gecko этот объект реализует интерфейсы <code><a href="/ru/NsIJSXMLHttpRequest" title="ru/NsIJSXMLHttpRequest">nsIJSXMLHttpRequest</a></code> и <code><a href="/ru/NsIXMLHttpRequest" title="ru/NsIXMLHttpRequest">nsIXMLHttpRequest</a></code>. Недавние версии Gecko содержат некоторые изменения для этого объекта (см. <a href="/ru/XMLHttpRequest_changes_for_Gecko1.8" title="ru/XMLHttpRequest_changes_for_Gecko1.8">XMLHttpRequest changes for Gecko1.8</a>).</p> - -<h3 id=".D0.9E.D1.81.D0.BD.D0.BE.D0.B2.D1.8B_.D0.B8.D1.81.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D1.8F" name=".D0.9E.D1.81.D0.BD.D0.BE.D0.B2.D1.8B_.D0.B8.D1.81.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D1.8F">Основы использования</h3> - -<p>Использовать <code>XMLHttpRequest</code> очень просто. Вы создаёте экземпляр объекта, открываете URL и отправляете запрос. Статус HTTP-ответа, так же как и возвращаемый документ, доступны в свойствах объекта запроса.</p> - -<div class="note"><strong>Замечание: </strong>Версии Firefox до версии 3 постоянно отправляют запрос, используя кодировку UTF-8. Отправляя документ, Firefox 3 использует кодировку, определённую в <code>data.inputEncoding</code> (где <code>data — </code>ненулевой объект, переданный в <code>send()</code>). Если не определено, то используется UTF-8.</div> - -<h4 id=".D0.9F.D1.80.D0.B8.D0.BC.D0.B5.D1.80" name=".D0.9F.D1.80.D0.B8.D0.BC.D0.B5.D1.80">Пример</h4> - -<pre>var req = new XMLHttpRequest(); -req.open('GET', 'http://www.mozilla.org/', false); -req.send(null); -if(req.status == 200) - dump(req.responseText); -</pre> - -<div class="note"><strong>Замечание:</strong> Этот пример работает синхронно, то есть он заблокирует интерфейс пользователя, если вы вызовете его из своего кода. Не рекомендуется использовать это на практике.</div> - -<h4 id=".D0.9F.D1.80.D0.B8.D0.BC.D0.B5.D1.80_.D0.B1.D0.B5.D0.B7_http_.D0.BF.D1.80.D0.BE.D1.82.D0.BE.D0.BA.D0.BE.D0.BB.D0.B0" name=".D0.9F.D1.80.D0.B8.D0.BC.D0.B5.D1.80_.D0.B1.D0.B5.D0.B7_http_.D0.BF.D1.80.D0.BE.D1.82.D0.BE.D0.BA.D0.BE.D0.BB.D0.B0">Пример без http протокола</h4> - -<pre>var req = new XMLHttpRequest(); -req.open('GET', 'file:///home/user/file.json', false); -req.send(null); -if(req.status == 0) - dump(req.responseText); -</pre> - -<div class="note"><strong>Замечание:</strong> file:/// и ftp:// не возвращают HTTP статуса, вот почему они возвращают ноль в <code>status</code> и пустую строчку в <code>statusText</code>. См. {{ Bug(331610) }} для подробной информации.</div> - -<h3 id=".D0.90.D1.81.D0.B8.D0.BD.D1.85.D1.80.D0.BE.D0.BD.D0.BD.D0.BE.D0.B5_.D0.B8.D1.81.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5" name=".D0.90.D1.81.D0.B8.D0.BD.D1.85.D1.80.D0.BE.D0.BD.D0.BD.D0.BE.D0.B5_.D0.B8.D1.81.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5">Асинхронное использование</h3> - -<p>Если вы собираетесь использовать <code>XMLHttpRequest</code> из дополнения, вы должны позволить ему загружаться асинхронно. Во время асинхронного использования вы получаете отзыв после загрузки данных, что позволяет браузеру продолжать работу пока ваш запрос обрабатывается.</p> - -<h4 id=".D0.9F.D1.80.D0.B8.D0.BC.D0.B5.D1.80_2" name=".D0.9F.D1.80.D0.B8.D0.BC.D0.B5.D1.80_2">Пример</h4> - -<pre>var req = new XMLHttpRequest(); -req.open('GET', 'http://www.mozilla.org/', true); /* Третий аргумент true означает асинхронность */ -req.onreadystatechange = function (aEvt) { - if (req.readyState == 4) { - if(req.status == 200) - dump(req.responseText); - else - dump("Error loading page\n"); - } -}; -req.send(null); -</pre> - -<h4 id=".D0.9D.D0.B0.D0.B1.D0.BB.D1.8E.D0.B4.D0.B5.D0.BD.D0.B8.D0.B5_.D0.B7.D0.B0_.D0.BF.D1.80.D0.BE.D0.B3.D1.80.D0.B5.D1.81.D1.81.D0.BE.D0.BC" name=".D0.9D.D0.B0.D0.B1.D0.BB.D1.8E.D0.B4.D0.B5.D0.BD.D0.B8.D0.B5_.D0.B7.D0.B0_.D0.BF.D1.80.D0.BE.D0.B3.D1.80.D0.B5.D1.81.D1.81.D0.BE.D0.BC">Наблюдение за прогрессом</h4> - -<p><code>XMLHttpRequest</code> предоставляет возможность отлавливать некоторые события которые могут возникнуть во время обработки запроса. Включая периодические уведомления о прогрессе, сообщения об ошибках и так далее.</p> - -<p>Если к примеру вы желаете предоставить информацию пользователю о прогрессе получения документа, вы можете использовать код вроде этого:</p> - -<pre>function onProgress(e) { - var percentComplete = (e.position / e.totalSize)*100; - ... -} - -function onError(e) { - alert("Error " + e.target.status + " occurred while receiving the document."); -} - -function onLoad(e) { - // ... -} -// ... -var req = new XMLHttpRequest(); -req.onprogress = onProgress; -req.open("GET", url, true); -req.onload = onLoad; -req.onerror = onError; -req.send(null); -</pre> - -<p>Атрибуты события <code>onprogress</code>: <code>position</code> и <code>totalSize</code>, отображают соответственно текущие количество принятых байтов и количество ожидаемых байтов.</p> - -<p>Все эти события имеют свои <code>target</code> атрибуты установленные в соответствии с <code>XMLHttpRequest</code>.</p> - -<div class="note"><strong>Замечание:</strong> <a href="/ru/Firefox_3" title="ru/Firefox_3">Firefox 3</a> по сути обеспечивает установку значений-ссылок полей <code>target</code>, <code>currentTarget</code> и <code>this</code> у объекта события на правильные объекты во время вызова обработчика событий для XML документов представленных в <code>XMLDocument</code>. См. {{ Bug(198595) }} для деталей.</div> - -<h3 id=".D0.94.D1.80.D1.83.D0.B3.D0.B8.D0.B5_.D0.A1.D0.B2.D0.BE.D0.B9.D1.81.D1.82.D0.B2.D0.B0_.D0.B8_.D0.9C.D0.B5.D1.82.D0.BE.D0.B4.D1.8B" name=".D0.94.D1.80.D1.83.D0.B3.D0.B8.D0.B5_.D0.A1.D0.B2.D0.BE.D0.B9.D1.81.D1.82.D0.B2.D0.B0_.D0.B8_.D0.9C.D0.B5.D1.82.D0.BE.D0.B4.D1.8B">Другие Свойства и Методы</h3> - -<p>В дополнение к свойствам и методам описанным выше, ниже следуют другие полезные свойства и методы для объекта запроса.</p> - -<h4 id="responseXML" name="responseXML">responseXML</h4> - -<p>Если вы загрузили <a href="/ru/XML" title="ru/XML">XML</a> документ свойство <code>responseXML</code> будет содержать документ в виде <code>XmlDocument</code> объекта которым вы можете манипулировать используя DOM методы. Если сервер отправляет правильно сформированные XML документы но не устанавливает Content-Type заголовок для него, вы можете использовать <code><a href="/ru/XMLHttpRequest#overrideMimeType.28.29" title="ru/XMLHttpRequest#overrideMimeType.28.29">overrideMimeType()</a></code> для того чтобы документ был обработан как XML. Если сервер не отправляет правильно сформированного документа XML, <code>responseXML</code> вернёт null независимо от любых перезаписей Content-Type заголовка.</p> - -<h4 id="overrideMimeType.28.29" name="overrideMimeType.28.29">overrideMimeType()</h4> - -<p>Этот метод может быть использован для обработки документа особенным образом. Обычно вы будете использовать его, когда запросите <code>responseXML,</code> и сервер отправит вам <a href="/ru/XML" title="ru/XML">XML</a>, но не отправит правильного Content-Type заголовка.</p> - -<div class="note"><strong>Замечание:</strong> Этот метод должен вызываться до вызова <code>send()</code>.</div> - -<pre>var req = new XMLHttpRequest(); -req.open('GET', 'http://www.mozilla.org/', true); -req.overrideMimeType('text/xml'); -req.send(null); -</pre> - -<h4 id="setRequestHeader.28.29" name="setRequestHeader.28.29">setRequestHeader()</h4> - -<p>Этот метод может быть использован чтобы установить HTTP заголовок в запросе до его отправки.</p> - -<div class="note"><strong>Замечание:</strong> вы должны вызвать вначале <code>open()</code>.</div> - -<pre>var req = new XMLHttpRequest(); -req.open('GET', 'http://www.mozilla.org/', true); -req.setRequestHeader("X-Foo", "Bar"); -req.send(null); -</pre> - -<h4 id="getResponseHeader.28.29" name="getResponseHeader.28.29">getResponseHeader()</h4> - -<p>Этот метод может быть использован для получения HTTP заголовка из ответа сервера.</p> - -<pre>var req = new XMLHttpRequest(); -req.open('GET', 'http://www.mozilla.org/', false); -req.send(null); -dump("Content-Type: " + req.getResponseHeader("Content-Type") + "\n"); -</pre> - -<h4 id="abort.28.29" name="abort.28.29">abort()</h4> - -<p>Этот метод может быть использован чтобы отменить обрабатываемый запрос.</p> - -<pre>var req = new XMLHttpRequest(); -req.open('GET', 'http://www.mozilla.org/', false); -req.send(null); -req.abort(); -</pre> - -<h4 id="mozBackgroundRequest" name="mozBackgroundRequest">mozBackgroundRequest</h4> - -<p>Это свойство может быть использовано чтобы уберечь от всплытия аутентификации и неправильных диалогов сертификации в ответ на запрос. Также запрос не будет отменён при закрытии его окна, которому он принадлежит. Это свойство работает только для кода chrome.</p> - -<pre>var req = new XMLHttpRequest(); -req.mozBackgroundRequest = true; -req.open('GET', 'http://www.mozilla.org/', true); -req.send(null); -</pre> - -<h3 id="Using_from_XPCOM_components" name="Using_from_XPCOM_components">Using from XPCOM components</h3> - -<div class="note"><strong>Note:</strong> Changes are required if you use XMLHttpRequest from a JavaScript XPCOM component.</div> - -<p>XMLHttpRequest cannot be instantiated using the <code>XMLHttpRequest()</code> constructor from a JavaScript XPCOM component. The constructor is not defined inside components and the code results in an error. You'll need to create and use it using a different syntax.</p> - -<p>Instead of this:</p> - -<pre>var req = new XMLHttpRequest(); -req.onprogress = onProgress; -req.onload = onLoad; -req.onerror = onError; -req.open("GET", url, true); -req.send(null); -</pre> - -<p>Do this:</p> - -<pre>var req = Components.classes["@mozilla.org/xmlextras/xmlhttprequest;1"] - .createInstance(Components.interfaces.nsIXMLHttpRequest); -req.onprogress = onProgress; -req.onload = onLoad; -req.onerror = onError; -req.open("GET", url, true); -req.send(null); -</pre> - -<p>For C++ code you would need to QueryInterface the component to an <code>nsIEventTarget</code> in order to add event listeners, but chances are in C++ using a channel directly would be better.</p> - -<h3 id="Limited_number_of_simultaneous_XMLHttpRequest_connections" name="Limited_number_of_simultaneous_XMLHttpRequest_connections">Limited number of simultaneous XMLHttpRequest connections</h3> - -<p>The about:config preference: network.http.max-persistent-connections-per-server limits the number of connections. In Firefox 3 this value is 6 by default, previous versions use 2 as the default. Some interactive web pages using xmlHttpRequest may keep a connection open. Opening two or three of these pages in different tabs or on different windows may cause the browser to hang in such a way that the window no longer repaints and browser controls don't respond.</p> - -<h3 id="Binary_Content" name="Binary_Content">Binary Content</h3> - -<p>Although less typical than sending/receiving character-oriented content, <code>XMLHttpRequest</code> can be used to send and receive binary content.</p> - -<h4 id="Retrieving_binary_content" name="Retrieving_binary_content">Retrieving binary content</h4> - -<pre>// Fetches BINARY FILES synchronously using XMLHttpRequest -function load_binary_resource(url) { - var req = new XMLHttpRequest(); - req.open('GET', url, false); - //XHR binary charset opt by Marcus Granado 2006 [http://mgran.blogspot.com] - req.overrideMimeType('text/plain; charset=x-user-defined'); - req.send(null); - if (req.status != 200) return ''; - return req.responseText; -} - -var filestream = load_binary_resource(url); -// x is the offset (i.e. position) of the byte in the returned binary file stream. The valid range for x is from 0 up to filestream.length-1. -var abyte = filestream.charCodeAt(x) & 0xff; // throw away high-order byte (f7) -</pre> - -<p>See <a class="external" href="http://mgran.blogspot.com/2006/08/downloading-binary-streams-with.html">downloading binary streams with XMLHttpRequest</a> for a detailed explanation. See also <a href="/ru/Code_snippets/Downloading_Files" title="ru/Code_snippets/Downloading_Files">downloading files</a>.</p> - -<h4 id="Sending_binary_content" name="Sending_binary_content">Sending binary content</h4> - -<p>This example POSTs binary content asynchronously. aBody is some data to send.</p> - -<pre class="eval"> var req = new XMLHttpRequest(); - req.open("POST", url, true); - // set headers and mime-type appropriately - req.setRequestHeader("Content-Length", 741); - req.sendAsBinary(aBody); -</pre> - -<p>You can also send binary content by passing an instance of interface <a href="/ru/NsIFileInputStream" title="ru/NsIFileInputStream">nsIFileInputStream</a> to <code>req.send()</code>. In that case, there is not need to set the Content-Length request header:</p> - -<pre>// Make a stream from a file. The file variable holds an nsIFile -var stream = Components.classes["@mozilla.org/network/file-input-stream;1"] - .createInstance(Components.interfaces.nsIFileInputStream); -stream.init(file, 0x04 | 0x08, 0644, 0x04); // file is an nsIFile instance - -// Try to determine the MIME type of the file -var mimeType = "text/plain"; -try { - var mimeService = Components.classes["@mozilla.org/mime;1"].getService(Components.interfaces.nsIMIMEService); - mimeType = mimeService.getTypeFromFile(file); // file is an nsIFile instance -} -catch(e) { /* eat it; just use text/plain */ } - -// Send -var req = Components.classes["@mozilla.org/xmlextras/xmlhttprequest;1"] - .createInstance(Components.interfaces.nsIXMLHttpRequest); -req.open('PUT', url, false); /* synchronous! */ -req.setRequestHeader('Content-Type', mimeType); -req.send(stream); -</pre> - -<h3 id="Bypassing_cache" name="Bypassing_cache">Bypassing cache</h3> - -<p>Normally, <code>XMLHttpRequest</code> attempts to retrieve content from local cache. To bypass this attempt, do the following:</p> - -<pre class="eval"> var req = new XMLHttpRequest(); - req.open('GET', url, false); - <strong>req.channel.loadFlags |= Components.interfaces.nsIRequest.LOAD_BYPASS_CACHE;</strong> - req.send(null); -</pre> - -<p>An alternative approach to bypassing cache, as described <a class="external" href="http://mozdev.org/pipermail/project_owners/2006-August/008353.html">here</a>:</p> - -<pre class="eval"> var req = new XMLHttpRequest(); - req.open("GET", url += (url.match(/\?/) == null ? "?" : "&") + (new Date()).getTime(), false); - req.send(null); -</pre> - -<p>This appends a timestamp URL parameter to the URL, taking care to insert a ? or & as appropriate. For example, <a class="external" href="http://foo.com/bar.html" rel="freelink">http://foo.com/bar.html</a> becomes <a class="external" href="http://foo.com/bar.html?12345" rel="freelink">http://foo.com/bar.html?12345</a> and <a class="external" href="http://foo.com/bar.html?foobar=baz" rel="freelink">http://foo.com/bar.html?foobar=baz</a> becomes <a class="external" href="http://foo.com/bar.html?foobar=baz&12345" rel="freelink">http://foo.com/bar.html?foobar=baz&12345</a>. Since local cache is indexed by URL, the idea is that every URL used by XMLHttpRequest is unique, bypassing the cache.</p> - -<h3 id="Downloading_JSON_and_JavaScript_in_extensions" name="Downloading_JSON_and_JavaScript_in_extensions">Downloading JSON and JavaScript in extensions</h3> - -<p>Extensions shouldn't use <a href="/ru/Core_JavaScript_1.5_Reference/Functions/eval" title="ru/Core_JavaScript_1.5_Reference/Functions/eval">eval()</a> on JSON or JavaScript downloaded from the web. See <a href="/ru/Downloading_JSON_and_JavaScript_in_extensions" title="ru/Downloading_JSON_and_JavaScript_in_extensions">Downloading JSON and JavaScript in extensions</a> for details.</p> - -<h3 id="References" name="References">References</h3> - -<ol> - <li><a href="/ru/AJAX/Getting_Started" title="ru/AJAX/Getting_Started">MDC AJAX introduction</a></li> - <li><a class="external" href="http://www.peej.co.uk/articles/rich-user-experience.html">XMLHttpRequest - REST and the Rich User Experience</a></li> - <li><a class="external" href="http://www.xulplanet.com/references/objref/XMLHttpRequest.html">XULPlanet documentation</a></li> - <li><a class="external" href="http://msdn.microsoft.com/library/default.asp?url=/library/en-us/xmlsdk/html/xmobjxmlhttprequest.asp">Microsoft documentation</a></li> - <li><a class="external" href="http://developer.apple.com/internet/webcontent/xmlhttpreq.html">Apple developers' reference</a></li> - <li><a class="external" href="http://jibbering.com/2002/4/httprequest.html">"Using the XMLHttpRequest Object" (jibbering.com)</a></li> - <li><a class="external" href="http://www.w3.org/TR/XMLHttpRequest/">The XMLHttpRequest Object: W3C Working Draft</a></li> -</ol> - -<p>{{ languages( { "es": "es/XMLHttpRequest", "fr": "fr/XMLHttpRequest", "it": "it/XMLHttpRequest", "ja": "ja/XMLHttpRequest", "ko": "ko/XMLHttpRequest", "pl": "pl/XMLHttpRequest", "zh-cn": "cn/XMLHttpRequest" } ) }}</p> diff --git a/files/ru/conflicting/web/css/@viewport/index.html b/files/ru/conflicting/web/css/@viewport/index.html deleted file mode 100644 index b59f0ac39a..0000000000 --- a/files/ru/conflicting/web/css/@viewport/index.html +++ /dev/null @@ -1,107 +0,0 @@ ---- -title: user-zoom -slug: conflicting/Web/CSS/@viewport -translation_of: Web/CSS/@viewport -translation_of_original: Web/CSS/@viewport/user-zoom -original_slug: Web/CSS/@viewport/user-zoom ---- -<div>{{ CSSRef }}</div> - -<h2 id="Summary" name="Summary">Введение</h2> - -<p>The <code>user-zoom</code> <a href="/en-US/docs/Web/CSS">CSS</a> descriptor controls whether or not the user should be able to change the zoom factor of a document defined by {{cssxref("@viewport")}}.</p> - -<p>{{cssinfo}}</p> - -<h2 id="Синтаксис">Синтаксис</h2> - -<pre class="brush:css">/* Keyword values */ -user-zoom: zoom; -user-zoom: fixed; -</pre> - -<h3 id="Значения">Значения</h3> - -<dl> - <dt><code>zoom</code></dt> - <dd>The user can zoom in or out.</dd> - <dt><code>fixed</code></dt> - <dd>The user cannot zoom in or out.</dd> -</dl> - -<h3 id="Формальный_синтаксис">Формальный синтаксис</h3> - -{{csssyntax}} - -<h2 id="Specifications" name="Specifications">Спецификации</h2> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Спецификации</th> - <th scope="col">Статус</th> - <th scope="col">Комментарий</th> - </tr> - </thead> - <tbody> - <tr> - <td>{{SpecName('CSS3 Device', '#the-lsquouser-zoomrsquo-descriptor', '"user-zoom" descriptor')}}</td> - <td>{{Spec2('CSS3 Device')}}</td> - <td>Initial definition</td> - </tr> - </tbody> -</table> - -<h2 id="Совместимость_с_браузерами">Совместимость с браузерами</h2> - -<p>{{ CompatibilityTable() }}</p> - -<div id="compat-desktop"> -<table class="compat-table"> - <tbody> - <tr> - <th>Feature</th> - <th>Chrome</th> - <th>Firefox (Gecko)</th> - <th>Internet Explorer</th> - <th>Opera</th> - <th>Safari</th> - </tr> - <tr> - <td>Basic support</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - </tr> - </tbody> -</table> -</div> - -<div id="compat-mobile"> -<table class="compat-table"> - <tbody> - <tr> - <th>Feature</th> - <th>Android</th> - <th>Chrome for Android</th> - <th>Firefox Mobile (Gecko)</th> - <th>IE Mobile</th> - <th>Opera Mobile</th> - <th>Safari Mobile</th> - </tr> - <tr> - <td>Basic support</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - </tr> - </tbody> -</table> -</div> - -<p> </p> diff --git a/files/ru/conflicting/web/css/_colon_is/index.html b/files/ru/conflicting/web/css/_colon_is/index.html deleted file mode 100644 index c771129bd5..0000000000 --- a/files/ru/conflicting/web/css/_colon_is/index.html +++ /dev/null @@ -1,191 +0,0 @@ ---- -title: ':any' -slug: conflicting/Web/CSS/:is -tags: - - CSS - - Experimental - - Псевдоклассы - - Руководство - - Экспериментальное -translation_of: Web/CSS/:is -translation_of_original: Web/CSS/:any -original_slug: Web/CSS/:any ---- -<div>{{CSSRef}}{{SeeCompatTable}}</div> - -<h2 id="Summary" name="Summary">Описание</h2> - -<p><a href="/ru/docs/Web/CSS/Псевдо-классы" title="CSS/Pseudo-classes">Псевдокласс</a> <code>:any()</code> даёт возможность быстрого конструирования наборов похожих селекторов путём составления групп, в которых каждый из входящих элементов будет комбинироваться с элементами из других групп. Это альтернатива для прописывания комбинаций селекторов для одного элемента, который может находится в разных родителях.</p> - -<div class="note"><strong>Замечание: </strong>Этот псевдокласс все ещё находится в процессе стандартизации в <a class="external" href="http://dev.w3.org/csswg/selectors4/#matches" title="http://dev.w3.org/csswg/selectors4/#matches"><em>CSS селекторах уровня 4</em></a> под именем <code>:matches()</code>. Вполне вероятно, что синтаксис и имя <code>:-<em>vendor</em>-any() </code>будут изменены в ближайшем будущем, чтобы соответствовать спецификации.</div> - -<h2 id="Syntax" name="Syntax">Синтаксис</h2> - -<pre class="syntaxbox">:-moz-any( <em>selector</em>[, <em>selector</em>]* ) :-webkit-any( selector[, selector]* )</pre> - -<h3 id="Values" name="Values">Параметры</h3> - -<dl> - <dt><code>selector</code></dt> - <dd>Селектор. Это может быть просто селектор или несколько селекторов, состоящих из <a class="external" href="http://www.w3.org/TR/css3-selectors/#simple-selectors" title="http://www.w3.org/TR/css3-selectors/#simple-selectors">CSS 3 простых селекторов</a> и может включать комбинацию потомков.</dd> -</dl> - -<div class="note"><strong>Замечание:</strong> Селекторы <strong>не</strong> могут содержать псевдо-элементы, допускается только комбинирование потомков.</div> - -<h2 id="Examples" name="Examples">Примеры</h2> - -<p>Например, следующий CSS:</p> - -<pre class="brush: css">/* на глубине 3 (или больше) неупорядоченные списки используют square */ -ol ol ul, ol ul ul, ol menu ul, ol dir ul, -ol ol menu, ol ul menu, ol menu menu, ol dir menu, -ol ol dir, ol ul dir, ol menu dir, ol dir dir, -ul ol ul, ul ul ul, ul menu ul, ul dir ul, -ul ol menu, ul ul menu, ul menu menu, ul dir menu, -ul ol dir, ul ul dir, ul menu dir, ul dir dir, -menu ol ul, menu ul ul, menu menu ul, menu dir ul, -menu ol menu, menu ul menu, menu menu menu, menu dir menu, -menu ol dir, menu ul dir, menu menu dir, menu dir dir, -dir ol ul, dir ul ul, dir menu ul, dir dir ul, -dir ol menu, dir ul menu, dir menu menu, dir dir menu, -dir ol dir, dir ul dir, dir menu dir, dir dir dir { - list-style-type: square; -} -</pre> - -<p>Может быть записано, как:</p> - -<pre class="brush: css">/* на глубине 3 (или больше) неупорядоченные списки используют square */ -:-moz-any(ol, ul, menu, dir) :-moz-any(ol, ul, menu, dir) ul, -:-moz-any(ol, ul, menu, dir) :-moz-any(ol, ul, menu, dir) menu, -:-moz-any(ol, ul, menu, dir) :-moz-any(ol, ul, menu, dir) dir { - list-style-type: square; -}</pre> - -<p>Однако, не нужно использовать это так: (Смотрите <a href="#Issues_with_performance_and_specificity">раздел о производительности</a> ниже.)</p> - -<pre class="brush: css">:-moz-any(ol, ul, menu, dir) :-moz-any(ol, ul, menu, dir) :-moz-any(ul, menu, dir) { - list-style-type: square; -}</pre> - -<h2 id="Notes" name="Notes">Примечания</h2> - -<p>Особенно полезен при работе с <a href="/en-US/docs/Sections_and_Outlines_of_an_HTML5_document" title="Sections and Outlines of an HTML5 document">разделами и заголовками</a> в HTML5 . Теги {{HTMLElement("section")}}, {{HTMLElement("article")}}, {{HTMLElement("aside")}}, и {{HTMLElement("nav")}} могут быть вложенными, без <code>:any()</code> стилизация их соответствия друг другу может быть сложной.</p> - -<p>Например, без <code>:any()</code>, стилизация всех элементов {{HTMLElement("h1")}} на разной глубине будет очень сложна:</p> - -<pre class="brush: css">/* Уровень 0 */ -h1 { - font-size: 30px; -} -/* Уровень 1 */ -section h1, article h1, aside h1, nav h1 { - font-size: 25px; -} -/* Уровень 2 */ -section section h1, section article h1, section aside h1, section nav h1, -article section h1, article article h1, article aside h1, article nav h1, -aside section h1, aside article h1, aside aside h1, aside nav h1, -nav section h1, nav article h1, nav aside h1, nav nav h1, { - font-size: 20px; -} -/* Уровень 3 */ -/* ... даже не думайте о нём*/ -</pre> - -<p>При использовании <code>:-any()</code>, это становится намного проще:</p> - -<pre class="brush: css">/* Уровень 0 */ -h1 { - font-size: 30px; -} -/* Уровень 1 */ -:-moz-any(section, article, aside, nav) h1 { - font-size: 25px; -} -/* Уровень 2 */ -:-moz-any(section, article, aside, nav) -:-moz-any(section, article, aside, nav) h1 { - font-size: 20px; -} -/* Уровень 3 */ -:-moz-any(section, article, aside, nav) -:-moz-any(section, article, aside, nav) -:-moz-any(section, article, aside, nav) h1 { - font-size: 15px; -}</pre> - -<h3 id="Issues_with_performance_and_specificity" name="Issues_with_performance_and_specificity">Проблемы с производительностью и особенности</h3> - -<p>{{ bug("561154") }} в Gecko, где специфика <code>:-moz-any()</code> не корректна. Текущая реализация (как в Firefox 12) ставит <code>:-moz-any()</code> в категорию универсальных правил, что означает, что использование его в качестве селектора справа будет медленнее, чем использование селекторов по ID, классу, или тегу.</p> - -<p>Например:</p> - -<pre class="brush: css">.a > :-moz-any(.b, .c) -</pre> - -<p>медленнее, чем:</p> - -<pre class="brush: css">.a > .b, .a > .c -</pre> - -<p>а следующее быстрее:</p> - -<pre class="brush: css">:-moz-any(.a, .d) > .b, :-moz-any(.a, .d) > .c -</pre> - -<h2 id="Browser_compatibility" name="Browser_compatibility">Поддержка браузерами</h2> - -<p>{{CompatibilityTable}}</p> - -<div id="compat-desktop"> -<table class="compat-table"> - <tbody> - <tr> - <th>Возможность</th> - <th>Firefox (Gecko)</th> - <th>Chrome</th> - <th>Internet Explorer</th> - <th>Opera</th> - <th>Safari</th> - </tr> - <tr> - <td>Базовая поддержка</td> - <td>{{CompatGeckoDesktop("2")}}{{property_prefix("-moz")}}</td> - <td>12.0 (534.30){{property_prefix("-webkit")}}</td> - <td> </td> - <td> </td> - <td> - <p>5<br> - {{property_prefix("-webkit")}}</p> - </td> - </tr> - </tbody> -</table> -</div> - -<div id="compat-mobile"> -<table class="compat-table"> - <tbody> - <tr> - <th>Возможность</th> - <th>Android</th> - <th>Chrome for Android</th> - <th>Firefox Mobile (Gecko)</th> - <th>IE Phone</th> - <th>Opera Mobile</th> - <th>Safari Mobile</th> - </tr> - <tr> - <td>Базовая поддержка</td> - <td>{{CompatUnknown}}</td> - <td>{{CompatVersionUnknown}}{{property_prefix("-webkit")}}</td> - <td>{{CompatUnknown}}</td> - <td>{{CompatUnknown}}</td> - <td>{{CompatUnknown}}</td> - <td>5<br> - {{property_prefix("-webkit")}}</td> - </tr> - </tbody> -</table> -</div> diff --git a/files/ru/conflicting/web/css/css_basic_user_interface/index.html b/files/ru/conflicting/web/css/css_basic_user_interface/index.html deleted file mode 100644 index 3a739dcff4..0000000000 --- a/files/ru/conflicting/web/css/css_basic_user_interface/index.html +++ /dev/null @@ -1,120 +0,0 @@ ---- -title: CSS Basic User Interface -slug: conflicting/Web/CSS/CSS_Basic_User_Interface -tags: - - CSS - - CSS Basic User Interface - - NeedsTranslation - - Overview - - Reference - - TopicStub -translation_of: Web/CSS/CSS_Basic_User_Interface -translation_of_original: Web/CSS/CSS_User_Interface -original_slug: Web/CSS/CSS_User_Interface ---- -<div>{{CSSRef}}</div> - -<p><strong>CSS User Interface</strong> is a CSS module that lets you define the rendering and functionality of features related to the user interface.</p> - -<h2 id="Reference">Reference</h2> - -<h3 id="Preferences">Preferences</h3> - -<div class="index"> -<ul> - <li>{{cssxref("box-sizing")}}</li> - <li>{{cssxref("cursor")}}</li> - <li>{{cssxref("outline")}}</li> - <li>{{cssxref("outline-width")}}</li> - <li>{{cssxref("outline-style")}}</li> - <li>{{cssxref("outline-color")}}</li> - <li>{{cssxref("outline-offset")}}</li> - <li>{{cssxref("resize")}}</li> - <li>{{cssxref("text-overflow")}}</li> - <li>{{cssxref("nav-down")}}</li> - <li>{{cssxref("nav-left")}}</li> - <li>{{cssxref("nav-right")}}</li> - <li>{{cssxref("nav-up")}}</li> -</ul> -</div> - -<h2 id="Guides">Guides</h2> - -<dl> - <dt><a href="/en-US/docs/Web/CSS/CSS_User_Interface/Using_URL_values_for_the_cursor_property">Using URL values for the <code>cursor</code> property</a></dt> - <dd>Explains how a URL can be used with the {{cssxref("cursor")}} property to produce custom cursors.</dd> -</dl> - -<h2 id="Specifications">Specifications</h2> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Specification</th> - <th scope="col">Status</th> - <th scope="col">Comment</th> - </tr> - </thead> - <tbody> - <tr> - <td>{{SpecName('CSS3 Basic UI')}}</td> - <td>{{Spec2('CSS3 Basic UI')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('CSS2.1', 'ui.html')}}</td> - <td>{{Spec2('CSS2.1')}}</td> - <td>Initial definition</td> - </tr> - </tbody> -</table> - -<h2 id="Browser_compatibility">Browser compatibility</h2> - -<div>{{CompatibilityTable}}</div> - -<div id="compat-desktop"> -<table class="compat-table"> - <tbody> - <tr> - <th>Feature</th> - <th>Chrome</th> - <th>Firefox (Gecko)</th> - <th>Internet Explorer</th> - <th>Opera</th> - <th>Safari (WebKit)</th> - </tr> - <tr> - <td>Basic support</td> - <td>1.0</td> - <td>1.5 (1.8)</td> - <td>8.0</td> - <td>7.0</td> - <td>1.2 (125)</td> - </tr> - </tbody> -</table> -</div> - -<div id="compat-mobile"> -<table class="compat-table"> - <tbody> - <tr> - <th>Feature</th> - <th>Android</th> - <th>Firefox Mobile (Gecko)</th> - <th>IE Phone</th> - <th>Opera Mobile</th> - <th>Safari Mobile</th> - </tr> - <tr> - <td>Basic support</td> - <td>1.0</td> - <td>{{CompatGeckoMobile(1.8)}}</td> - <td>8.0</td> - <td>6.0</td> - <td>3.1</td> - </tr> - </tbody> -</table> -</div> diff --git a/files/ru/conflicting/web/css/css_flexible_box_layout/basic_concepts_of_flexbox/index.html b/files/ru/conflicting/web/css/css_flexible_box_layout/basic_concepts_of_flexbox/index.html deleted file mode 100644 index e51bc42a20..0000000000 --- a/files/ru/conflicting/web/css/css_flexible_box_layout/basic_concepts_of_flexbox/index.html +++ /dev/null @@ -1,380 +0,0 @@ ---- -title: Используем CSS Flexible Boxes -slug: conflicting/Web/CSS/CSS_Flexible_Box_Layout/Basic_Concepts_of_Flexbox -translation_of: Web/CSS/CSS_Flexible_Box_Layout/Basic_Concepts_of_Flexbox -translation_of_original: Web/CSS/CSS_Flexible_Box_Layout/Using_CSS_flexible_boxes -original_slug: Web/CSS/CSS_Flexible_Box_Layout/Using_CSS_flexible_boxes ---- -<div>Эта статья устарела и удалена из английской версии. Вместо неё идёт перенаправление на статью: -<h1 id="Основные_понятия_Flexbox"><a href="https://developer.mozilla.org/ru/docs/Web/CSS/CSS_Flexible_Box_Layout/Basic_Concepts_of_Flexbox">Основные понятия Flexbox</a></h1> - - - -<p>У меня не поднялась рука удалить эту статью окончательно, но я рекомендую вам вместо неё, всё-таки, прочитать ту.</p> -</div> - -<div>{{CSSRef}}</div> - -<p><span class="seoSummary">CSS3 <strong>Flexible Box</strong>, или просто <strong>flexbox</strong> — это режим разметки, созданный для упорядочения элементов на странице таким образом, чтобы они вели себя предсказуемо в случаях, когда разметка страницы адаптирована под различные размеры экрана и устройства.</span> Во многих случаях флексбоксы лучше блочной модели разметки, поскольку не использует обтекания (floats) и не выполняет схлопывание отступлений flex-контейнера и его содержимого (margin collapse).</p> - -<p>Для многих дизайнеров модель использования флексбоксов будет более простой для применения. Дочерние элементы внутри флексбокса могут размещаться в любом направлении и могут менять размер, чтобы адаптироваться к различным размерам дисплея. Позиционирование элементов в таком случае является простым и комплексная разметка достигается значительно легче и с более чистым кодом, поскольку порядок отображения элементов не связан с их порядком в коде. Эта независимость умышленно касается только визуального рендеринга, оставляя порядок интерпретации и навигацию зависимыми от порядка в исходниках.</p> - -<div class="note"><strong>Внимание:</strong> некоторые браузеры все ещё могут частично или полностью не поддерживать флексбоксы. Ознакомьтесь с <a href="/ru/docs/Web/CSS/CSS_Flexible_Box_Layout/Using_CSS_flexible_boxes#Совместимость_с_браузерами">таблицей совместимости</a>.</div> - -<h2 id="Концепция_Flexbox">Концепция Flexbox</h2> - -<p>Главной концепцией Flexbox есть возможность изменения высоты и/или ширины его элементов, чтобы лучше заполнять пространство любого дисплея. Flex-контейнер увеличивает элементы, чтобы заполнить доступное пространство или уменьшает чтобы предотвратить перекрытие.</p> - -<p>Алгоритм разметки флексбоксами агностичено направлен в противовес блочной разметке, которая ориентирована строго вертикально, или горизонтально-ориентированной инлайн-разметке. Несмотря на то что разметка блоками хорошо подходит для страницы, ей не хватает объективного механизма для поддержки компонентов, которые должны менять ориентацию, размеры а также растягиваться или сжиматься при изменениях размера экрана, изменении ориентации с вертикальной на горизонтальную и так далее. Разметка флексбоксами наиболее желательна для компонентов приложения и шаблонов, которые мало масштабируются, тогда как grid-разметка создана для больших шаблонов. Обе технологии являются частью разработки CSS Working Group которая должна способствовать совместимости web-приложений с различными браузерами, режимами а также большей гибкости.</p> - -<h2 id="Терминология">Терминология</h2> - -<p>Поскольку описание флексбоксов не включает таких словосочетаний, как горизонтальная / inline и вертикальная / block оси, объяснение модели предусматривает новую терминологию. Используйте следующую диаграмму при просмотре словаря терминов. Она изображает flex-контейнер, имеющий flex-направление ряда, что означает, что каждый flex item расположен горизонтально, друг за другом по главной оси (main axis) в соответствии с установленным направлением написания текста элемента. Слева направо в данном случае.</p> - -<p><img alt="flex_terms.png" class="default internal" src="/files/3739/flex_terms.png"></p> - -<dl> - <dt>Flex-контейнер</dt> - <dd>Родительский элемент, в котором содержатся flex-элементы. Flex-контейнер определяется установкой свойства {{Cssxref("display")}} в <code>flex</code> или <code>inline-flex</code>.</dd> - <dt>Flex-элемент, flex item</dt> - <dd> - <p>Каждый дочерний элемент flex-контейнера становится flex-элементом. Текст, который напрямую содержится в flex-контейнере, оборачивается анонимным flex-элементом.</p> - </dd> - <dt>Оси</dt> - <dd> - <p>Каждый flexible-бокс шаблон строится по двум осям. Главная ось <strong>(main axis)</strong> — это ось, вдоль которой flex-элементы следуют один за другим, а перекрёстная ось <strong>(cross axis)</strong> перпендикулярна ей.</p> - - <ul> - <li>Свойство <code>{{Cssxref("flex-direction")}}</code> устанавливает главную ось.</li> - <li>Свойство <code>{{Cssxref("justify-content")}}</code> определяет расположение элементов вдоль главной оси в текущем ряду.</li> - <li>Свойство <a href="/ru/docs/Web/CSS/align-items"><code>align-items</code></a> расположение элементов вдоль перекрёстной оси в текущем ряду.</li> - <li>Свойство <a href="/ru/docs/Web/CSS/align-self"><code>align-self</code></a> устанавливает, как отдельный flex-элемент выровнен по перекрёстной оси, переопределяя значения, установленные с помощью <code>align-items.</code></li> - </ul> - </dd> - <dt>Направления</dt> - <dd> - <p>Главное начало и конец (<strong>main</strong>) и перекрёстное начало и конец (<strong>cross start</strong>/<strong>end</strong>) — это стороны контейнера, определяющие начало и окончание потока flex-элементов. Они следуют по главной и перекрёстной осями flex-контейнера в векторе, установленном режимом написания ({{Cssxref("writing-mode")}}) (слева направо, справа налево и т. д.).</p> - - <ul> - <li>Свойство {{Cssxref("order")}} присваивает элементы порядковым группам и определяет, в каком порядке их показывать.</li> - <li>Свойство {{Cssxref("flex-flow")}} — это короткая форма, состоящая из свойств {{Cssxref("flex-direction")}} и {{Cssxref("flex-wrap")}}, определяющих расположение элементов.</li> - </ul> - </dd> - <dt>Линии</dt> - <dd> - <p>Flex-элементы могут размещаться на одной или нескольких линиях в зависимости от значения свойства {{Cssxref("flex-wrap")}}, которое контролирует направление перекрёстных линий и направление в котором складываются новые линии.</p> - </dd> - <dt>Размеры</dt> - <dd> - <p>Флекс элементы агностически эквивалентны высоте и ширине <strong>главного размера</strong> и <strong>поперечного размера,</strong> которые равны, соответственно, главной оси (main axis) и поперечной оси (cross axis) флекс-контейнера.</p> - - <ul> - <li>Свойства <code><a href="/ru/docs/Web/CSS/min-height">min-height</a></code> и <code><a href="/ru/docs/Web/CSS/min-width">min-width</a></code> принимают значение по умолчанию 0.</li> - <li>Свойство <a href="/ru/docs/Web/CSS/flex"><code>flex</code></a> - это сокращённая запись свойств <a href="/ru/docs/Web/CSS/flex-grow"><code>flex-grow</code></a>, <code><a href="/ru/docs/Web/CSS/flex-shrink">flex-shrink</a> и</code> <code><a href="/ru/docs/Web/CSS/flex-basis">flex-basis</a>.</code></li> - </ul> - </dd> -</dl> - -<h2 id="Делаем_элемент_флексбоксом">Делаем элемент флексбоксом</h2> - -<p>Чтобы сделать элемент flexible-боксом, укажите значение {{cssxref("display")}} следующим образом:</p> - -<pre class="brush: css">display: flex</pre> - -<p>или</p> - -<pre class="brush: css">display: inline-flex</pre> - -<p>Таким образом мы определяем элемент как флексбокс, а его дочерние элементы — как flex-элементы. Значение <code>flex</code> делает контейнер блочным элементом, а <code>inline-flex</code> значение превращает его в инлайн-элемент.</p> - -<div class="note"><span class="notranslate"><strong>Внимание</strong></span><strong>:</strong> для <span class="notranslate">указания префикса вендора, добавьте строку в значение атрибута, а не к самому атрибуту</span>. <span class="notranslate">Например</span>, <code>display: -webkit-flex</code>.</div> - -<h2 id="Рассмотрим_flex-элементы">Рассмотрим flex-элементы</h2> - -<p>Текст, который содержится непосредственно внутри flex-контейнера, автоматически оборачивается анонимным flex-элементом. Однако, анонимный flex-элемент, содержащий только пробелы, не отображается (как будто было указано значение <code>display: none</code>).</p> - -<p>Абсолютно позиционированные дочерние элементы flex-контейнера позиционируются так, что их статическое положение определяется относительно главного начального угла содержащего их flex-контейнера.</p> - -<p>Отступы (margin) соседних flex-контейнеров не схлопываются. Установка значений <code>margin: auto </code>поглощает дополнительное место в вертикальном или горизонтальном направлении и может быть использовано для выравнивания или для разделения соседних flex-элементов. См. <a href="http://dev.w3.org/csswg/css3-flexbox/#auto-margins">Выравнивание при помощи 'автоматических' отступов </a>в разделе "Модель расположения при помощи flex-контейнеров" спецификации W3C.</p> - -<p>Свойства выравнивания flexbox выполняют "истинное" центрирование в отличие от других способов центрирования в CSS. Это означает, что flex-элементы будут оставаться отцентрированными даже если они переполняют flex-контейнер. Впрочем, это может иногда быть проблематичным, если они вылезают за верхний или левый край страницы (в языках с написанием слева направо; в языках с написанием справа налево, таких как арабский, возникает проблема с правой границей), так как вы не можете прокрутить страницу в данную область даже если там есть содержимое! В будущем релизе свойства выравнивания будут также дополнены "безопасной" опцией. На данный момент, если это проблема, вы можете использовать отступы (margin) для достижения центрирования, так как они сработают "безопасно" и центрирование будет прекращено при переполнении. Вместо использования свойства <code>align- </code>просто установите автоматические отступы (<code>margin: auto)</code> для flex-элементов, которые вы хотите отцентрировать. Вместо свойств <code>justify-</code> установите <code>margin: auto</code> на внешние края первого и последнего элемента в flex-контейнере. Автоматические отступы будут "подстраиваться" и занимать оставшееся место, центрируя flex-элементы при наличии свободного места и используя стандартное выравнивание при его отсутствии. Тем не менее, если вы пытаетесь заменить <code>justify-content </code>центрированием, основанным на отступах (margin-based) в многострочном flexbox, вам, видимо, не повезло, так как вам необходимо установить отступы для первого и последнего элемента на каждой строке. Если вы не можете предугадать заранее на какой строке окажется каждый элемент, вы не сможете надёжно использовать центрирование, основанное на отступах, на основной оси для замены свойства <code>justify-content</code>.</p> - -<p>Помните, что, несмотря на то, что порядок отображения элементов не зависит от их положения в исходном коде, эта независимость затрагивает только визуальное отображение, оставляя навигацию и голосовую помощь в исходном порядке. Даже свойство {{cssxref("order")}} не влияет на очерёдность голосовой помощи и навигации. Таким образом, разработчики должны уделять внимание правильному порядку элементов в исходном коде, чтобы не навредить доступности документа.</p> - -<h2 id="Свойства_Flexbox">Свойства Flexbox</h2> - -<h3 id="Свойства_не_влияющие_на_Flexbox">Свойства, не влияющие на Flexbox</h3> - -<p>Так как flexbox используют другой алгоритм расположения, некоторые свойства не имеют смысла для flex-контейнера:</p> - -<ul> - <li>свойства <code>column-*</code> <a href="/ru/docs/Web/Guide/CSS/Using_multi-column_layouts">модуля с множественными столбцами</a> не влияет на flex-элементы.</li> - <li>{{cssxref("clear")}} не действует на flex-элементах.</li> - <li>{{cssxref("float")}} заставляет свойство элемента <code>display</code> считаться как <code>block</code>.</li> - <li>{{cssxref("vertical-align")}} не оказывает эффекта на выравнивание flex-элементов.</li> -</ul> - -<h2 id="Пример">Пример</h2> - -<h3 id="Типичный_пример_flex">Типичный пример flex</h3> - -<p>Типичный пример показывает как применять "flex-эффект" к элементам и как соседние элементы ведут себя в состоянии flex.</p> - -<pre class="brush: html"><!DOCTYPE html> -<html lang="en"> - <head> - <style> - .flex { - /* basic styling */ - width: 350px; - height: 200px; - border: 1px solid #555; - font: 14px Arial; - - /* flexbox setup */ - display: flex; - flex-direction: row; - } - - .flex > div { - flex: 1 1 auto; - width: 30px; /* To make the transition work nicely. (Transitions to/from - "width:auto" are buggy in Gecko and Webkit, at least. - See http://bugzil.la/731886 for more info.) */ - transition: width 0.7s ease-out; - } - - /* colors */ - .flex > div:nth-child(1){ background: #009246; } - .flex > div:nth-child(2){ background: #F1F2F1; } - .flex > div:nth-child(3){ background: #CE2B37; } - - .flex > div:hover { - width: 200px; - } - - </style> - </head> - <body> - <p>Flexbox nuovo</p> - <div class="flex"> - <div>uno</div> - <div>due</div> - <div>tre</div> - </div> - </body> -</html></pre> - -<h3 id="Пример_расположения_Священный_Грааль">Пример расположения "Священный Грааль"</h3> - -<p>Данный пример показывает как flexbox предоставляет возможность динамически изменять расположение для различных разрешений экрана. Следующая схема иллюстрирует преобразование.</p> - -<p><img alt="HolyGrailLayout.png" class="default internal" src="/files/3760/HolyGrailLayout.png"></p> - -<p>Здесь изображён случай, когда расположение, подходящее для окна браузера должно быть оптимизировано для экрана смартфона. Не только элементы должны уменьшиться в размере, но и порядок, в котором они отображаются, должен измениться. Flexbox сильно упрощает это.</p> - -<pre class="brush: html"><!DOCTYPE html> -<html lang="en"> - <head> - <style> - body { - font: 24px Helvetica; - background: #999999; - } - - #main { - min-height: 800px; - margin: 0px; - padding: 0px; - display: flex; - flex-flow: row; - } - - #main > article { - margin: 4px; - padding: 5px; - border: 1px solid #cccc33; - border-radius: 7pt; - background: #dddd88; - flex: 3 1 60%; - order: 2; - } - - #main > nav { - margin: 4px; - padding: 5px; - border: 1px solid #8888bb; - border-radius: 7pt; - background: #ccccff; - flex: 1 6 20%; - order: 1; - } - - #main > aside { - margin: 4px; - padding: 5px; - border: 1px solid #8888bb; - border-radius: 7pt; - background: #ccccff; - flex: 1 6 20%; - order: 3; - } - - header, footer { - display: block; - margin: 4px; - padding: 5px; - min-height: 100px; - border: 1px solid #eebb55; - border-radius: 7pt; - background: #ffeebb; - } - - /* Too narrow to support three columns */ - @media all and (max-width: 640px) { - #main, #page { - flex-direction: column; - } - - #main > article, #main > nav, #main > aside { - /* Return them to document order */ - order: 0; - } - - #main > nav, #main > aside, header, footer { - min-height: 50px; - max-height: 50px; - } - } - </style> - </head> - <body> - <header>header</header> - <div id='main'> - <article>article</article> - <nav>nav</nav> - <aside>aside</aside> - </div> - <footer>footer</footer> - </body> -</html></pre> - -<h2 id="Песочница">Песочница</h2> - -<p>Существует несколько песочниц с flexbox, доступных онлайн для экспериментов:</p> - -<ul> - <li><a href="http://demo.agektmr.com/flexbox/">Flexbox Playground</a></li> - <li><a href="http://the-echoplex.net/flexyboxes">Flexy Boxes</a></li> - <li><a href="http://codepen.io/justd/pen/yydezN">Flexbox Properties Demonstration</a></li> - <li><a href="http://flexboxfroggy.com/">Flexbox Froggy</a></li> -</ul> - -<h2 id="О_чем_нужно_помнить">О чем нужно помнить</h2> - -<p>Алгоритм, описывающий как flex-элементы располагаются, иногда может быть довольно запутанным. Вот несколько правильных решений, которые позволят избежать неприятных сюрпризов при вёрстке с использованием flexbox.</p> - -<p>Flexbox располагаются в соответствие с <a href="https://developer.mozilla.org/ru/docs/Web/CSS/writing-mode">направлением письма</a>, что означает, что <strong>главное начало</strong> и <strong>главный конец </strong>располагаются в зависимости от положения <strong>начала </strong>и <strong>конца </strong>(строки - <em>прим.</em>).</p> - -<p><strong>Перекрёстное начало</strong> и <strong>перекрёстный конец </strong>полагаются на определение позиции <strong>начала </strong>и <strong>конца, </strong>которое зависит от значения свойства <code>{{cssxref("direction")}}</code>.</p> - -<p>Разрывы страницы допустимы в расположении flex-контейнеров, когда это позволяет свойство <code>break-. Свойства </code>CSS3 <code>break-after</code>, <code>break-before</code> и <code>break-inside</code>, а также свойства CSS 2.1 <code>page-break-before</code>, <code>page-break-after</code> и <code>page-break-inside</code> работают на flex-контейнере, flex-элементах, а также внутри flex-элементов.</p> - -<h2 id="Совместимость_с_браузерами">Совместимость с браузерами</h2> - -<p>{{CompatibilityTable}}</p> - -<div id="compat-desktop"> -<table class="compat-table"> - <tbody> - <tr> - <th>Feature</th> - <th>Firefox (Gecko)</th> - <th>Chrome</th> - <th>Internet Explorer</th> - <th>Opera</th> - <th>Safari</th> - </tr> - <tr> - <td>Basic support (single-line flexbox)</td> - <td>{{CompatGeckoDesktop("18.0")}}<sup>[6]</sup>{{property_prefix("-moz")}}<sup>[2]</sup><br> - {{CompatGeckoDesktop("22.0")}}</td> - <td>21.0{{property_prefix("-webkit")}}<br> - 29.0</td> - <td>11<sup>[3]</sup></td> - <td>12.10{{property_prefix("-webkit")}}<sup>[5]</sup></td> - <td>6.1{{property_prefix("-webkit")}}<sup>[1]</sup></td> - </tr> - <tr> - <td>Multi-line flexbox</td> - <td>{{CompatGeckoDesktop("28.0")}}</td> - <td>21.0{{property_prefix("-webkit")}}<br> - 29.0</td> - <td>11<sup>[3]</sup></td> - <td>12.10<sup>[5]</sup><br> - 15 {{property_prefix("-webkit")}}</td> - <td>6.1{{property_prefix("-webkit")}}<sup>[1]</sup></td> - </tr> - </tbody> -</table> -</div> - -<div id="compat-mobile"> -<table class="compat-table"> - <tbody> - <tr> - <th>Feature</th> - <th>Firefox Mobile (Gecko)</th> - <th>Firefox OS</th> - <th>Android</th> - <th>IE Phone</th> - <th>Opera Mobile</th> - <th>Safari Mobile</th> - </tr> - <tr> - <td>Basic support (single-line flexbox)</td> - <td>{{CompatGeckoMobile("18.0")}}{{property_prefix("-moz")}}<sup>[2]</sup><br> - {{CompatGeckoMobile("22.0")}}</td> - <td> - <p>1.0{{property_prefix("-moz")}}<sup>[2]</sup><br> - 1.1</p> - </td> - <td>2.1{{property_prefix("-webkit")}}<sup>[4]</sup><br> - 4.4</td> - <td>11</td> - <td>12.10<sup>[5]</sup><br> - 15{{property_prefix("-webkit")}}</td> - <td>7{{property_prefix("-webkit")}}<sup>[1]</sup></td> - </tr> - <tr> - <td>Multi-line flexbox</td> - <td>{{CompatGeckoMobile("28.0")}}</td> - <td>1.3</td> - <td>2.1{{property_prefix("-webkit")}}<sup>[4]</sup><br> - 4.4</td> - <td>11</td> - <td>12.10<sup>[5]</sup><br> - 15{{property_prefix("-webkit")}}</td> - <td>7{{property_prefix("-webkit")}}<sup>[1]</sup></td> - </tr> - </tbody> -</table> -</div> - -<p>[1] Safari до версии 6.0 (iOS.1) поддерживал старую несовместимую черновую версию спецификации. Safari 6.1 (и Safari на iOS 7) был обновлён для поддержки финальной версии.</p> - -<p>[2] До Firefox 22, чтобы активировать поддержку flexbox, пользователь должен установить параметр <code>about:config</code> <code>layout.css.flexbox.enabled</code> в значение <code>true</code>. Начиная с Firefox 22 по Firefox 27, параметр установлен в <code>true</code> по умолчанию, и полностью исключён в Firefox 28.</p> - -<p>[3] Internet Explorer 10 поддерживает старую несовместимую черновую версию спецификации; Internet Explorer 11 <a href="https://msdn.microsoft.com/ru-ru/library/dn265027(v=vs.85).aspx">был обновлён</a> для поддержки финальной версии.</p> - -<p>[4] Android browser до версии 4.3 поддерживал старую несовместимую черновую версию спецификации. Android 4.4 был обновлён для поддержки финальной версии.</p> - -<p>[5] Хотя изначальная реализация в Opera 12.10 <code>flexbox</code> была без приставки, она получила приставку {{property_prefix("-webkit")}} в версиях с 15 по 16 Opera и с 15 по 19 Opera Mobile. Приставка была снова убрана в Opera 17 и Opera Mobile 24.</p> - -<p>[6] До Firefox 29, <code>установка visibility: collapse</code> для flex-элемента заставляет его обрабатываться как <code>display: none</code> вместо предполагаемого поведения, обрабатывающего его как <code>visibility: hidden</code>. Предложенное решение - использовать <code>visibility:hidden</code> для flex-элементов, которые должны вести себя как при установленном <code>visibility:collapse</code>. Для большей информации, см {{bug(783470)}}.</p> - -<h2 id="Смотрите_также">Смотрите также</h2> - -<ul> - <li><a href="https://github.com/philipwalton/flexbugs">Проект Flexbugs </a>для информации о багах в браузерных реализациях flexbox.</li> -</ul> diff --git a/files/ru/conflicting/web/css/gap/index.html b/files/ru/conflicting/web/css/gap/index.html deleted file mode 100644 index 714cd0beb5..0000000000 --- a/files/ru/conflicting/web/css/gap/index.html +++ /dev/null @@ -1,195 +0,0 @@ ---- -title: grid-gap -slug: conflicting/Web/CSS/gap -translation_of: Web/CSS/gap -translation_of_original: Web/CSS/grid-gap -original_slug: Web/CSS/grid-gap ---- -<p>{{Deprecated_Header}}</p> - -<div class="note"> -<p><strong>Примечание</strong>. Свойство CSS с разделительной сеткой было переименовано в свойство prefix-less {{cssxref('gap')}}.</p> -</div> - -<p>Свойство CSS <strong><code>grid-gap</code></strong> является сокращённым свойством для {{cssxref("grid-row-gap")}} и {{cssxref("grid-column-gap")}}, определяющего желоба между строками и столбцами сетки.</p> - -<div>{{EmbedInteractiveExample("pages/css/grid-gap.html")}}</div> - -<p class="hidden">Источник этого интерактивного примера хранится в репозитории GitHub. Если вы хотите внести свой вклад в проект интерактивных примеров, скопируйте <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> и отправьте нам запрос на перенос.</p> - -<h2 id="Syntax">Syntax</h2> - -<pre class="brush: css no-line-numbers">/* Одно <length> значение */ -grid-gap: 20px; -grid-gap: 1em; -grid-gap: 3vmin; -grid-gap: 0.5cm; - -/* Одно <percentage> значение */ -grid-gap: 16%; -grid-gap: 100%; - -/* Два <length> значения */ -grid-gap: 20px 10px; -grid-gap: 1em 0.5em; -grid-gap: 3vmin 2vmax; -grid-gap: 0.5cm 2mm; - -/* Один или два <percentage> значения */ -grid-gap: 16% 100%; -grid-gap: 21px 82%; - -/* calc() значения */ -grid-gap: calc(10% + 20px); -grid-gap: calc(20px + 10%) calc(10% - 5px); - -/* Глобальные значения */ -grid-gap: inherit; -grid-gap: initial; -grid-gap: unset; -</pre> - -<p>Это свойство указывается как значение для <code><'grid-row-gap'></code> , за которым необязательно следует значение для <code><'grid-column-gap'></code>. Если <code><'grid-column-gap'></code> опущено, для него устанавливается то же значение, что и <code><'grid-row-gap'></code>.</p> - -<p>Каждое из свойств <code><'grid-row-gap'></code> и <code><'grid-column-gap'></code> указываются как <code><length></code> или <code><percentage></code>.</p> - -<h3 id="Значения">Значения</h3> - -<dl> - <dt><code><length></code></dt> - <dd>Ширина отступа, разделяющего линии сетки.</dd> - <dt><code><percentage></code></dt> - <dd>Ширина отступа, разделяющего линии сетки относительно размеров элемента.</dd> -</dl> - -<h3 id="Формальный_синтаксис">Формальный синтаксис</h3> - -{{csssyntax}} - -<h2 id="Примеры">Примеры</h2> - -<h3 id="HTML_Контент">HTML Контент</h3> - -<pre class="brush: html"><div id="grid"> - <div></div> - <div></div> - <div></div> - <div></div> - <div></div> - <div></div> - <div></div> - <div></div> - <div></div> -</div></pre> - -<h3 id="CSS_Контент">CSS Контент</h3> - -<pre class="brush: css; highlight[5]">#grid { - display: grid; - height: 200px; - grid-template: repeat(3, 1fr) / repeat(3, 1fr); - grid-gap: 20px 5px; -} - -#grid > div { - background-color: lime; -} -</pre> - -<p>{{EmbedLiveSample("Example", "100%", "200px")}}</p> - -<h2 id="Спецификации">Спецификации</h2> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Спецификация</th> - <th scope="col">Статус</th> - <th scope="col">Комментарий</th> - </tr> - </thead> - <tbody> - <tr> - <td>{{SpecName("CSS3 Box Alignment", "#propdef-grid-gap", "grid-gap")}}</td> - <td>{{Spec2("CSS3 Box Alignment")}}</td> - <td>Устарело в пользу <code><a href="/en-US/docs/Web/CSS/gap">gap</a></code></td> - </tr> - <tr> - <td>{{SpecName("CSS3 Grid", "#gutters", "grid-gap")}}</td> - <td>{{Spec2("CSS3 Grid")}}</td> - <td>Начальное определение</td> - </tr> - </tbody> -</table> - -<p>{{cssinfo}}</p> - -<h2 id="Совместимость_с_браузерами">Совместимость с браузерами</h2> - - - -<p>{{Compat("css.properties.grid-gap")}}</p> - -<h2 id="Смотрите_также">Смотрите также</h2> - -<ul> - <li>Prefixless CSS equivalents: {{cssxref("row-gap")}}, {{cssxref("column-gap")}}, {{cssxref("gap")}}</li> - <li>Related CSS properties: {{cssxref("grid-row-gap")}}, {{cssxref("grid-column-gap")}}</li> - <li>Grid Layout Guide: <em><a href="/en-US/docs/Web/CSS/CSS_Grid_Layout/Basic_Concepts_of_Grid_Layout#Gutters">Basic concepts of grid layout - Gutters</a></em></li> -</ul> - -<section class="Quick_links" id="Quick_Links"> -<ol> - <li><a href="/en-US/docs/Web/CSS"><strong>CSS</strong></a></li> - <li><a href="/en-US/docs/Web/CSS/Reference"><strong>CSS Reference</strong></a></li> - <li><a href="/en-US/docs/Web/CSS/CSS_Grid_Layout">CSS Grid Layout</a></li> - <li data-default-state="open"><a href="#"><strong>Guides</strong></a> - <ol> - <li><a href="/en-US/docs/Web/CSS/CSS_Grid_Layout/Basic_Concepts_of_Grid_Layout">Basics concepts of grid layout</a></li> - <li><a href="/en-US/docs/Web/CSS/CSS_Grid_Layout/Relationship_of_Grid_Layout">Relationship to other layout methods</a></li> - <li><a href="/en-US/docs/Web/CSS/CSS_Grid_Layout/Line-based_Placement_with_CSS_Grid">Line-based placement</a></li> - <li><a href="/en-US/docs/Web/CSS/CSS_Grid_Layout/Grid_Template_Areas">Grid template areas</a></li> - <li><a href="/en-US/docs/Web/CSS/CSS_Grid_Layout/Layout_using_Named_Grid_Lines">Layout using named grid lines</a></li> - <li><a href="/en-US/docs/Web/CSS/CSS_Grid_Layout/Auto-placement_in_CSS_Grid_Layout">Auto-placement in grid layout</a></li> - <li><a href="/en-US/docs/Web/CSS/CSS_Grid_Layout/Box_Alignment_in_CSS_Grid_Layout">Box alignment in grid layout</a></li> - <li><a href="/en-US/docs/Web/CSS/CSS_Grid_Layout/CSS_Grid,_Logical_Values_and_Writing_Modes">Grids, logical values and writing modes</a></li> - <li><a href="/en-US/docs/Web/CSS/CSS_Grid_Layout/CSS_Grid_Layout_and_Accessibility">CSS Grid Layout and Accessibility</a></li> - <li><a href="/en-US/docs/Web/CSS/CSS_Grid_Layout/CSS_Grid_and_Progressive_Enhancement">CSS Grid Layout and Progressive Enhancement</a></li> - <li><a href="/en-US/docs/Web/CSS/CSS_Grid_Layout/Realizing_common_layouts_using_CSS_Grid_Layout">Realizing common layouts using grids</a></li> - </ol> - </li> - <li data-default-state="open"><a href="#"><strong>Properties</strong></a> - <ol> - <li><a href="/en-US/docs/Web/CSS/grid">grid</a></li> - <li><a href="/en-US/docs/Web/CSS/grid-area">grid-area</a></li> - <li><a href="/en-US/docs/Web/CSS/grid-auto-columns">grid-auto-columns</a></li> - <li><a href="/en-US/docs/Web/CSS/grid-auto-flow">grid-auto-flow</a></li> - <li><a href="/en-US/docs/Web/CSS/grid-auto-rows">grid-auto-rows</a></li> - <li><a href="/en-US/docs/Web/CSS/grid-column">grid-column</a></li> - <li><a href="/en-US/docs/Web/CSS/grid-column-end">grid-column-end</a></li> - <li><a href="/en-US/docs/Web/CSS/grid-column-gap">grid-column-gap</a></li> - <li><a href="/en-US/docs/Web/CSS/grid-column-start">grid-column-start</a></li> - <li><a href="/en-US/docs/Web/CSS/grid-gap">grid-gap</a></li> - <li><a href="/en-US/docs/Web/CSS/grid-row">grid-row</a></li> - <li><a href="/en-US/docs/Web/CSS/grid-row-end">grid-row-end</a></li> - <li><a href="/en-US/docs/Web/CSS/grid-row-gap">grid-row-gap</a></li> - <li><a href="/en-US/docs/Web/CSS/grid-row-start">grid-row-start</a></li> - <li><a href="/en-US/docs/Web/CSS/grid-template">grid-template</a></li> - <li><a href="/en-US/docs/Web/CSS/grid-template-areas">grid-template-areas</a></li> - <li><a href="/en-US/docs/Web/CSS/grid-template-columns">grid-template-columns</a></li> - <li><a href="/en-US/docs/Web/CSS/grid-template-rows">grid-template-rows</a></li> - </ol> - </li> - <li data-default-state="open"><a href="#"><strong>Glossary</strong></a> - <ol> - <li><a href="/en-US/docs/Glossary/Grid_lines">Grid lines</a></li> - <li><a href="/en-US/docs/Glossary/Grid_tracks">Grid tracks</a></li> - <li><a href="/en-US/docs/Glossary/Grid_cell">Grid cell</a></li> - <li><a href="/en-US/docs/Glossary/Grid_areas">Grid areas</a></li> - <li><a href="/en-US/docs/Glossary/Gutters">Gutters</a></li> - <li><a href="/en-US/docs/Glossary/Grid_rows">Grid row</a></li> - <li><a href="/en-US/docs/Glossary/Grid_column">Grid column</a></li> - </ol> - </li> -</ol> -</section> diff --git a/files/ru/conflicting/web/css/url()/index.html b/files/ru/conflicting/web/css/url()/index.html deleted file mode 100644 index 97687fc05b..0000000000 --- a/files/ru/conflicting/web/css/url()/index.html +++ /dev/null @@ -1,36 +0,0 @@ ---- -title: url() -slug: conflicting/Web/CSS/url() -tags: - - CSS - - Начинающий - - Ссылка - - Функция -translation_of: Web/CSS/url() -translation_of_original: Web/CSS/filter-function/url -original_slug: Web/CSS/filter-function/url ---- -<div>{{cssref}}</div> - -<p><strong><code>url()</code></strong> - это <a href="/en-US/docs/Web/CSS">CSS</a> функция, использующая <a href="/en-US/docs/Web/SVG/Element/filter">SVG filter</a> для изменения внешнего вида у выводимого изображения.</p> - -<h2 id="Синтаксис">Синтаксис</h2> - -<pre class="syntaxbox">url(<em>расположение</em>)</pre> - -<h3 id="Параметры">Параметры</h3> - -<dl> - <dt><code>расположение</code></dt> - <dd>В {{cssxref("<URL-адрес>")}} из {{glossary("XML")}} указывается файл, который задаёт фильтр SVG, а также может включать в себя привязки к конкретному фильтрующему элементу.</dd> -</dl> - -<h2 id="Пример">Пример</h2> - -<pre class="brush: css">url(resources.svg#c1)</pre> - -<h2 id="Изучите_также">Изучите также</h2> - -<ul> - <li><a href="https://developer.mozilla.org/ru/docs/Web/CSS/filter-function">{{cssxref("<filter-function>")}}</a></li> -</ul> diff --git a/files/ru/conflicting/web/css/url()_168028c4e5edd9e19c061adb4b604d4f/index.html b/files/ru/conflicting/web/css/url()_168028c4e5edd9e19c061adb4b604d4f/index.html deleted file mode 100644 index d18bf82cc8..0000000000 --- a/files/ru/conflicting/web/css/url()_168028c4e5edd9e19c061adb4b604d4f/index.html +++ /dev/null @@ -1,95 +0,0 @@ ---- -title: <url> -slug: conflicting/Web/CSS/url()_168028c4e5edd9e19c061adb4b604d4f -tags: - - Адрес - - Типы данных - - относительный адрес -translation_of: Web/CSS/url() -translation_of_original: Web/CSS/url -original_slug: Web/CSS/url ---- -<div>{{CssRef}}</div> - -<p><a href="https://developer.mozilla.org/ru/docs/Web/CSS/CSS_Types">Тип данных</a> <a href="/en-US/docs/Web/CSS">CSS</a> <strong><code><url></code></strong> обозначает указатели на ресурсы, такие как изображения или шрифты. URL-адреса могут быть использованы в многочисленных свойствах CSS, таких как {{Cssxref("background-image")}}, {{Cssxref("cursor")}} или {{cssxref("list-style")}}.</p> - -<div class="note"> -<p><strong>URI или URL?</strong> Существует разница между {{Glossary("URI")}} и {{Glossary("URL")}}. URI просто идентифицирует ресурс. URL является типом URI, и описывает <em>месторасположение</em> ресурса.URI может быть либо URL-адресом, либо именем ресурса ({{Glossary("URN")}}).</p> - -<p>В CSS Уровень 1, функциональная нотация <code>url()</code>описывала только истинные URL-адреса. В CSS Уровень 2, определение <code>url()</code> было расширено для описания любого URI, будь то URL или URN. Неожиданно, что <code>url()</code> может быть использовано для создания типа данных CSS <code><uri></code>. Это изменение было не только неожиданным, но и ненужным, так как URN почти не используется в реальном CSS. Для избежания путаницы, CSS Уровень 3 вернулся к более узкому, первоначальному определению. Сейчас <code>url()</code> означает только истинное значение <code><url></code>.</p> -</div> - -<h2 id="Синтаксис">Синтаксис</h2> - -<p>Тип данных <code><url></code> является указанием к использованию функциональной нотации <code id="The_url()_functional_notation">url()</code>. Он может быть задан без кавычек или с использованием одинарных или двойных кавычек. Допускаются относительные URL-адреса, относящиеся к URL-адресу страницы стилей (а не к URL-адресу веб-страницы).</p> - -<pre class="syntaxbox"><a_css_property>: url("http://mysite.example.com/mycursor.png") -<a_css_property>: url('http://mysite.example.com/mycursor.png') -<a_css_property>: url(http://mysite.example.com/mycursor.png) -</pre> - -<div class="note"> -<p><strong>Примечание:</strong> Контрольные символы выше 0x7e не допустимы в URL-адресах без кавычек, начиная с Firefox 15. Смотри {{Bug(752230)}} для более детальной информации.</p> -</div> - -<h2 id="Примеры">Примеры</h2> - -<pre class="brush: css">.topbanner { - background: url("topbanner.png") #00D no-repeat fixed; -} -</pre> - -<pre class="brush: css">ul { - list-style: square url(http://www.example.com/redball.png); -} -</pre> - -<h2 id="Specifications" name="Specifications">Спецификации</h2> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Спецификация</th> - <th scope="col">Статус</th> - <th scope="col">Комментарий</th> - </tr> - </thead> - <tbody> - <tr> - <td>{{SpecName('CSS4 Values', '#urls', '<url>')}}</td> - <td>{{Spec2('CSS4 Values')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('CSS3 Values', '#urls', '<url>')}}</td> - <td>{{Spec2('CSS3 Values')}}</td> - <td>Нет значительных изменений по сравнению с CSS Уровень 2 (Revision 1).</td> - </tr> - <tr> - <td>{{Specname('CSS2.1', 'syndata.html#uri', '<uri>')}}</td> - <td>{{Spec2('CSS2.1')}}</td> - <td>Нет значительных изменений по сравнению с CSS Уровень 1.</td> - </tr> - <tr> - <td>{{SpecName('CSS1', '#url', '<url>')}}</td> - <td>{{Spec2('CSS1')}}</td> - <td>первое определение.</td> - </tr> - </tbody> -</table> - -<h2 id="Поддержка_браузерами">Поддержка браузерами</h2> - - - -<div>{{Compat("css.types.url")}}</div> - -<h2 id="Смотрите_также">Смотрите также</h2> - -<ul> - <li>{{cssxref("<gradient>")}}</li> - <li>{{cssxref("element()")}}</li> - <li>{{cssxref("_image","image()")}}</li> - <li>{{cssxref("image-set","image-set()")}}</li> - <li>{{cssxref("cross-fade")}}</li> -</ul> diff --git a/files/ru/conflicting/web/guide/index.html b/files/ru/conflicting/web/guide/index.html deleted file mode 100644 index 2ea0c7199a..0000000000 --- a/files/ru/conflicting/web/guide/index.html +++ /dev/null @@ -1,11 +0,0 @@ ---- -title: Веб-разработка -slug: conflicting/Web/Guide -translation_of: Web/Guide -translation_of_original: Web_Development -original_slug: Веб-разработка ---- -<p><strong>Веб-разработка</strong> включает в себя все аспекты разработки веб-сайта или веб-приложения. Статьи этого раздела освещают создание как простых веб-сайтов, так и сложных, интерактивных веб-приложений с использованием новейших технологий разработки для веб.</p> -<table class="mainpage-table"> <tbody> <tr> <td colspan="2"> <h2 id="Разделы_документации">Разделы документации</h2> </td> </tr> <tr> <td style="width: 50%;"> <dl> <dt><a class="internal" href="/en/Web_Development/Introduction_to_Web_development" title="Введение в веб-разработку">Введение в веб-разработку</a></dt> <dd>Руководство, обучающее разработке для веб.</dd> <dt><a class="internal" href="/ru/HTML" rel="internal" title="HTML">HTML</a></dt> <dd>HyperText Markup Language — основной язык, используемый для создания веб-страниц и других документов, пригодных для просмотра в браузере.</dd> <dt><a class="internal" href="/ru/JavaScript" rel="internal" title="JavaScript">JavaScript</a></dt> <dd>JavaScript — наиболее широко используемый для разработки веб-приложений скриптовый язык; он также используется и при разработке программного обеспечения основанного на Mozilla.</dd> <dt><a class="internal" href="/ru/CSS" rel="internal" title="CSS">CSS</a></dt> <dd>Cascading Style Sheets — таблицы стилей позволяющие создать make it possible to do advanced layout and page design on the Web.</dd> <dt><a class="internal" href="/ru/AJAX" rel="internal" title="AJAX">AJAX</a></dt> <dd>Asynchronous JavaScript and XML — не столько технология, сколько подход к сочетанию имеющихся технологий; JavaScript и другие современные веб-технологии используются совместно при создании динамических веб-приложений.</dd> </dl> </td> <td> <dl> <dt><a class="internal" href="/en/Web_Standards" title="Веб-стандарты">Веб-стандарты</a></dt> <dd>Learn how to make your Web site or application reach the largest number of users through compatibility with the open Web.</dd> <dt><a class="internal" href="/en/DOM" rel="internal" title="DOM">DOM</a></dt> <dd>Document Object Model — API для HTML- и XML-документов, providing a structural representation of the document that you can modify in order to alter its visual presentation.</dd> <dt><a class="internal" href="/en/XHTML" title="XHTML">XHTML</a></dt> <dd>Extensible HyperText Markup Language is an XML-based HTML-like language that offers a stricter syntax than HTML.</dd> <dt><a class="internal" href="/en/SVG" rel="internal" title="SVG">SVG</a></dt> <dd>Scalable Vector Graphics — язык разметки, основанный на XML, для описания двухмерной векторной графики.</dd> <dt><a class="internal" href="/en/Mozilla_Web_Developer_FAQ" title="Mozilla Web Developer FAQ">Mozilla Web developer FAQ</a></dt> <dd>Наиболее часто задаваемые веб-разработчиками вопросы. С ответами!</dd> </dl> <p><span class="alllinks"><a href="/Special:Tags?tag=Web_Development&language=en" title="Special:Tags?tag=Web_Development&language=en">View All...</a></span></p> </td> </tr> <tr> <td> <h2 id="Сообщество">Сообщество</h2> <ul> <li>Форумы Mozilla<span class="mw-headline">…</span> <ul> <li><a class=" link-https" href="https://lists.mozilla.org/listinfo/dev-web-development" rel="external nofollow" title="https://lists.mozilla.org/listinfo/dev-web-development">как список рассылки</a></li> <li><a class=" link-news" href="news://news.mozilla.org/mozilla.dev.web-development" rel="external nofollow" title="news://news.mozilla.org/mozilla.dev.web-development">как новостная группа</a></li> <li><a class=" external" href="http://groups.google.com/group/mozilla.dev.web-development" rel="external nofollow" title="http://groups.google.com/group/mozilla.dev.web-development">как Google Group</a></li> <li><a class=" external" href="http://groups.google.com/group/mozilla.dev.web-development/feeds" rel="external nofollow" title="http://groups.google.com/group/mozilla.dev.web-development/feeds">как новостная лента</a></li> </ul> </li> <li><a class="external" href="/web-tech" title="https://developer.mozilla.org/editor/fckeditor/core/editor/web-tech/">Блог Mozilla Web-tech</a></li> <li><a class="external" href="http://www.whatwg.org/" rel="external nofollow" title="http://www.whatwg.org/">Рабочая группа WHAT WG</a></li> <li><a class="external" href="http://webdevfeedhouse.com/" rel="external nofollow" title="http://webdevfeedhouse.com/">WebDev FeedHouse</a></li> </ul> </td> <td> <h2 id="Инструменты">Инструменты</h2> <ul> <li><a class="link-https" href="https://addons.mozilla.org/en-US/firefox/addon/1843" rel="external nofollow" title="Дополнение Firebug">Дополнение Firebug</a></li> <li><a class="link-https" href="https://addons.mozilla.org/en-US/firefox/addon/60" rel="external nofollow" title="Дополнение Web Developer">Дополнение Web Developer</a></li> <li><a href="/en/Venkman" rel="internal" title="Venkman">Venkman</a>, отладчик JavaScript</li> <li><a href="/en/DOM_Inspector" rel="internal" title="DOM Inspector">DOM Inspector</a> <p><span class="alllinks"><a href="/Special:Tags?tag=Web_Development:Tools&language=en" title="Special:Tags?tag=Web_Development:Tools&language=en">View All...</a></span></p> </li> </ul> </td> </tr> </tbody> -</table> -<p>{{ languages( { "de": "de/Webentwicklung", "en": "en/Web_Development", "es": "es/Desarrollo_Web", "fr": "fr/D\u00e9veloppement_Web", "it": "it/Sviluppo_Web", "ja": "ja/Web_Development", "pl": "pl/Programowanie_WWW", "zh-cn": "cn/Web_Development" } ) }}</p> diff --git a/files/ru/conflicting/web/guide/mobile/index.html b/files/ru/conflicting/web/guide/mobile/index.html deleted file mode 100644 index 028d0c71ed..0000000000 --- a/files/ru/conflicting/web/guide/mobile/index.html +++ /dev/null @@ -1,19 +0,0 @@ ---- -title: Mobile Web development -slug: conflicting/Web/Guide/Mobile -tags: - - Mobile - - NeedsTranslation - - TopicStub - - Web Development -translation_of: Web/Guide/Mobile -translation_of_original: Web_Development/Mobile -original_slug: Web_Development/Mobile ---- -<p>Developing web sites to be viewed on mobile devices requires approaches that ensure a web site works as well on mobile devices as it does on desktop browsers. The following articles describe some of these approaches.</p> -<ul> - <li><a class="vt-p" href="/en/Web_Development/Mobile/Mobile-friendliness" title="/en/Web_development/Mobile/Mobile-friendliness">What is mobile-friendliness?</a></li> - <li><a class="vt-p" href="/en/Web_Development/Mobile/Separate_sites" title="en/Web_development/Mobile/Separate sites">Separate sites</a></li> - <li><a class="vt-p" href="/en/Web_Development/Mobile/Responsive_design" title="/en/Web_development/Mobile/Responsive design">Responsive design</a></li> - <li><a class="vt-p" href="/en/Web_development/Mobile/A_hybrid_approach" title="A New Approach to Web Applications (external)">A hybrid approach</a></li> -</ul> diff --git a/files/ru/conflicting/web/http/cors/index.html b/files/ru/conflicting/web/http/cors/index.html deleted file mode 100644 index 23d269ec05..0000000000 --- a/files/ru/conflicting/web/http/cors/index.html +++ /dev/null @@ -1,214 +0,0 @@ ---- -title: Server-Side Access Control (CORS) -slug: conflicting/Web/HTTP/CORS -translation_of: Web/HTTP/CORS -translation_of_original: Web/HTTP/Server-Side_Access_Control -original_slug: Web/HTTP/Server-Side_Access_Control ---- -<p>Системы контроля доступа производят идентификацию <a href="http://searchsoftwarequality.techtarget.com/definition/authorization">авторизации</a>, <a href="http://searchsecurity.techtarget.com/definition/authentication">аутентификацию</a>, подтверждение доступа и подотчётность сущностей с помощью учётных данных для входа, включая <a href="http://searchsecurity.techtarget.com/definition/password">пароль</a>, личный идентификационный номер (PINs), <a href="http://searchsecurity.techtarget.com/definition/biometrics">биометрическое</a> сканирование и физический или электронный ключ.</p> - -<p>Контроль доступа --- это техника безопасности, которую можно использовать для регулирования процессом того, кто или что может видеть или использовать ресурсы в вычислительном окружении.</p> - -<p>{{HTTPSidebar}}</p> - -<p>Для меж-сайтовых запросов, произведённых с помощью {{domxref("XMLHttpRequest")}} или <a href="/en-US/docs/Web/API/Fetch_API">Fetch API</a>, браузеры передают специальные <a href="/en-US/docs/Web/HTTP/Headers">HTTP заголовки</a>. Так же ожидаемо увидеть определённые HTTP заголовки, переданные обратно внутри меж-сайтового ответа. Обзор этих заголовков, включая примеры JavaScript кода, создающего запросы и обрабатывающего ответы от сервера, как и описание каждого из заголовков, <a class="internal" href="/en-US/docs/Web/HTTP/Access_control_CORS">может быть найден в статье HTTP Access Control (CORS)</a> и должен быть прочитан вместе с данной. Эта статья покрывает обработку <strong>Запросов контроля доступа</strong> и формулировку <strong>Ответов контроля доступа </strong>в PHP. Целевая аудитория для этой статьи --- разработчики серверов и администраторы. Хотя примеры кода, приведённые тут, на PHP, подобная концепция применяется в ASP.net, Perl, Python, Java, etc.; в общем, эти концепции могут быть применены в любом сервером окружении, который обрабатывает HTTP запросы и динамически формирует HTTP ответы.</p> - -<h2 id="Discussion_of_HTTP_headers">Discussion of HTTP headers</h2> - -<p>The article <a class="internal" href="/en-US/docs/Web/HTTP/Access_control_CORS">covering the HTTP headers used by both clients and servers is here</a>, and should be considered prerequisite reading.</p> - -<h2 id="Working_code_samples">Working code samples</h2> - -<p>The PHP snippets (and the JavaScript invocations to the server) in subsequent sections are taken from <a class="external" href="http://arunranga.com/examples/access-control/">the working code samples posted here.</a> These will work in browsers that implement cross-site {{domxref("XMLHttpRequest")}}.</p> - -<h2 id="Simple_cross-site_requests">Simple cross-site requests</h2> - -<p><a class="internal" href="/en-US/docs/Web/HTTP/Access_control_CORS#Simple_requests">Simple Access Control Requests</a> are initiated when:</p> - -<ul> - <li>An HTTP/1.1 {{HTTPMethod("GET")}} or a {{HTTPMethod("POST")}} is used as request method. In the case of a POST, the {{HTTPHeader("Content-Type")}} of the request body is one of <code>application/x-www-form-urlencoded</code>, <code>multipart/form-data</code>, or <code>text/plain.</code></li> - <li>No custom headers are sent with the HTTP request (such as <code>X-Modified</code>, etc.)</li> -</ul> - -<p>In this case, responses can be sent back based on some considerations.</p> - -<ul> - <li>If the resource in question is meant to be widely accessed (just like any HTTP resource accessed by GET), then sending back the {{HTTPHeader("Access-Control-Allow-Origin")}}<code>: *</code> header will be sufficient, <strong>unless</strong> the resource needs credentials such as <a href="/en-US/docs/Web/HTTP/Cookies">Cookies</a> and HTTP Authentication information.</li> - <li>If the resource should be kept restricted based on requester domain, <strong>OR</strong> if the resource needs to be accessed with credentials (or sets credentials), then filtering by the request's {{HTTPHeader("Origin")}} header may be necessary, or at least echoing back the requester's <code>Origin</code> (e.g. {{HTTPHeader("Access-Control-Allow-Origin")}}<code>: <a class="external" href="http://arunranga.com" rel="freelink">http://arunranga.com</a></code>). Additionally, the {{HTTPHeader("Access-Control-Allow-Credentials")}}<code>: true</code> header will have to be sent. This is discussed in a <a class="internal" href="#Credentialed_Requests">subsequent section</a>.</li> -</ul> - -<p>The section on <a class="internal" href="/en-US/docs/Web/HTTP/Access_control_CORS#Simple_requests">Simple Access Control Requests</a> shows you the header exchanges between client and server. Here is a PHP code segment that handles a Simple Request:</p> - -<pre class="brush: php"><?php - -// We'll be granting access to only the arunranga.com domain -// which we think is safe to access this resource as application/xml - -if($_SERVER['HTTP_ORIGIN'] == "http://arunranga.com") { - header('Access-Control-Allow-Origin: http://arunranga.com'); - header('Content-type: application/xml'); - readfile('arunerDotNetResource.xml'); -} else { - header('Content-Type: text/html'); - echo "<html>"; - echo "<head>"; - echo " <title>Another Resource</title>"; - echo "</head>"; - echo "<body>", - "<p>This resource behaves two-fold:"; - echo "<ul>", - "<li>If accessed from <code>http://arunranga.com</code> it returns an XML document</li>"; - echo "<li>If accessed from any other origin including from simply typing in the URL into the browser's address bar,"; - echo "you get this HTML document</li>", - "</ul>", - "</body>", - "</html>"; -} -?> -</pre> - -<p>The above checks to see if the {{HTTPHeader("Origin")}} header sent by the browser (obtained through $_SERVER['HTTP_ORIGIN']) matches '<a class="external" href="http://arunranga.com" rel="freelink">http://arunranga.com</a>'. If yes, it returns {{HTTPHeader("Access-Control-Allow-Origin")}}<code>: <a class="external" href="http://arunranga.com" rel="freelink">http://arunranga.com</a></code>. This example can be <a class="external" href="http://arunranga.com/examples/access-control/">seen running here</a>.</p> - -<h2 id="Preflighted_requests">Preflighted requests</h2> - -<p><a class="internal" href="/en-US/docs/Web/HTTP/Access_control_CORS#Preflighted_requests">Preflighted Access Control Requests</a> occur when:</p> - -<ul> - <li>A method other than {{HTTPMethod("GET")}} or {{HTTPMethod("POST")}} is used, or if {{HTTPMethod("POST")}} is used with a {{HTTPHeader("Content-Type")}} <strong>other than</strong> one of <code>application/x-www-form-urlencoded</code>, <code>multipart/form-data</code>, or <code>text/plain</code>. For instance, if the <code>Content-Type</code> of the <code>POST</code> body is <code>application/xml</code>, a request is preflighted.</li> - <li>A custom header (such as <code>X-PINGARUNER</code>) is sent with the request.</li> -</ul> - -<p>The section on <a class="internal" href="/en-US/docs/Web/HTTP/Access_control_CORS#Preflighted_requests">Preflighted Access Control Requests</a> shows a header exchange between client and server. A server resource responding to a preflight requests needs to be able to make the following determinations:</p> - -<ul> - <li>Filtration based on {{HTTPHeader("Origin")}}, if any at all.</li> - <li>Response to an {{HTTPMethod("OPTIONS")}} request (which is the preflight request), including sending necessary values with {{HTTPHeader("Access-Control-Allow-Methods")}}, {{HTTPHeader("Access-Control-Allow-Headers")}} (if any additional headers are needed in order for the application to work), and, if credentials are necessary for this resource, {{HTTPHeader("Access-Control-Allow-Credentials")}}.</li> - <li>Response to the actual request, including handling <code>POST</code> data, etc.</li> -</ul> - -<p>Here is an example in PHP of handling a <a class="internal" href="/en-US/docs/Web/HTTP/Access_control_CORS#Preflighted_requests">preflighted request</a>:</p> - -<pre class="brush: php"><?php - -if($_SERVER['REQUEST_METHOD'] == "GET") { - - header('Content-Type: text/plain'); - echo "This HTTP resource is designed to handle POSTed XML input"; - echo "from arunranga.com and not be retrieved with GET"; - -} elseif($_SERVER['REQUEST_METHOD'] == "OPTIONS") { - // Tell the Client we support invocations from arunranga.com and - // that this preflight holds good for only 20 days - - if($_SERVER['HTTP_ORIGIN'] == "http://arunranga.com") { - header('Access-Control-Allow-Origin: http://arunranga.com'); - header('Access-Control-Allow-Methods: POST, GET, OPTIONS'); - header('Access-Control-Allow-Headers: X-PINGARUNER'); - header('Access-Control-Max-Age: 1728000'); - header("Content-Length: 0"); - header("Content-Type: text/plain"); - //exit(0); - } else { - header("HTTP/1.1 403 Access Forbidden"); - header("Content-Type: text/plain"); - echo "You cannot repeat this request"; - } - -} elseif($_SERVER['REQUEST_METHOD'] == "POST") { - // Handle POST by first getting the XML POST blob, - // and then doing something to it, and then sending results to the client - - if($_SERVER['HTTP_ORIGIN'] == "http://arunranga.com") { - $postData = file_get_contents('php://input'); - $document = simplexml_load_string($postData); - - // do something with POST data - - $ping = $_SERVER['HTTP_X_PINGARUNER']; - - header('Access-Control-Allow-Origin: http://arunranga.com'); - header('Content-Type: text/plain'); - echo // some string response after processing - } else { - die("POSTing Only Allowed from arunranga.com"); - } -} else { - die("No Other Methods Allowed"); -} -?> -</pre> - -<p>Note the appropriate headers being sent back in response to the {{HTTPMethod("OPTIONS")}} preflight as well as to the {{HTTPMethod("POST")}} data. One resource thus handles the preflight as well as the actual request. In the response to the <code>OPTIONS</code> request, the server notifies the client that the actual request can indeed be made with the <code>POST</code> method, and header fields such as <code>X-PINGARUNER</code> can be sent with the actual request. This example can be <a class="external" href="http://arunranga.com/examples/access-control/">seen running here</a>.</p> - -<h2 id="Credentialed_requests">Credentialed requests</h2> - -<p><a class="internal" href="/en-US/docs/Web/HTTP/Access_control_CORS#Requests_with_credentials">Credentialed Access Control Requests</a> – that is, requests that are accompanied by <a href="/en-US/docs/Web/HTTP/Cookies">Cookies</a> or HTTP Authentication information (and which expect Cookies to be sent with responses) – can be either <a class="internal" href="/en-US/docs/Web/HTTP/Access_control_CORS#Simple_requests">Simple</a> or <a class="internal" href="/en-US/docs/Web/HTTP/Access_control_CORS#Preflighted_requests">Preflighted</a>, depending on the request methods used.</p> - -<p>In a <a class="internal" href="/en-US/docs/Web/HTTP/Access_control_CORS#Simple_requests">Simple Request</a> scenario, the request will be sent with Cookies (e.g. if the <code><a href="/en-US/docs/Web/API/XMLHttpRequest/withCredentials">withCredentials</a></code> flag is set on {{domxref("XMLHttpRequest")}}). If the server responds with {{HTTPHeader("Access-Control-Allow-Credentials")}}<code>: true</code> attached to the credentialed response, then the response is accepted by the client and exposed to web content. In a <a class="internal" href="/en-US/docs/Web/HTTP/Access_control_CORS#Preflighted_requests">Preflighted Request</a>, the server can respond with <code>Access-Control-Allow-Credentials: true</code> to the <code>OPTIONS</code> request.</p> - -<p>Here is some PHP that handles credentialed requests:</p> - -<pre class="brush: php"><?php - -if($_SERVER['REQUEST_METHOD'] == "GET") { - header('Access-Control-Allow-Origin: http://arunranga.com'); - header('Access-Control-Allow-Credentials: true'); - header('Cache-Control: no-cache'); - header('Pragma: no-cache'); - header('Content-Type: text/plain'); - - // First See if There Is a Cookie - if (!isset($_COOKIE["pageAccess"])) { - setcookie("pageAccess", 1, time()+2592000); - echo 'I do not know you or anyone like you so I am going to'; - echo 'mark you with a Cookie :-)'; - } else { - $accesses = $_COOKIE['pageAccess']; - setcookie('pageAccess', ++$accesses, time()+2592000); - echo 'Hello -- I know you or something a lot like you!'; - echo 'You have been to ', $_SERVER['SERVER_NAME'], '; - echo 'at least ', $accesses-1, ' time(s) before!'; - } -} elseif($_SERVER['REQUEST_METHOD'] == "OPTIONS") { - // Tell the Client this preflight holds good for only 20 days - if($_SERVER['HTTP_ORIGIN'] == "http://arunranga.com") { - header('Access-Control-Allow-Origin: http://arunranga.com'); - header('Access-Control-Allow-Methods: GET, OPTIONS'); - header('Access-Control-Allow-Credentials: true'); - header('Access-Control-Max-Age: 1728000'); - header("Content-Length: 0"); - header("Content-Type: text/plain"); - } else { - header("HTTP/1.1 403 Access Forbidden"); - header("Content-Type: text/plain"); - echo "You cannot repeat this request"; - } -} else { - die("This HTTP Resource can ONLY be accessed with GET or OPTIONS"); -} -?> -</pre> - -<p>Note that in the case of credentialed requests, the <code>Access-Control-Allow-Origin:</code> header <strong>must not</strong> have a wildcard value of "*". It <strong>must</strong> mention a valid origin domain. The example above can be seen <a class="external" href="http://arunranga.com/examples/access-control/">running here</a>.</p> - -<h2 id="Apache_examples">Apache examples</h2> - -<h3 id="Restrict_access_to_certain_URIs">Restrict access to certain URIs</h3> - -<p>One helpful trick is to use an Apache rewrite, environment variable, and headers to apply <code>Access-Control-Allow-*</code> to certain URIs. This is useful, for example, to constrain cross-origin requests to <code>GET /api(.*).json</code> requests without credentials:</p> - -<pre>RewriteRule ^/api(.*)\.json$ /api$1.json [CORS=True] -Header set Access-Control-Allow-Origin "*" env=CORS -Header set Access-Control-Allow-Methods "GET" env=CORS -Header set Access-Control-Allow-Credentials "false" env=CORS -</pre> - -<h2 id="See_also">See also</h2> - -<ul> - <li><a class="external" href="http://arunranga.com/examples/access-control/">Examples of Access Control in Action</a></li> - <li><a href="https://github.com/jackblackevo/cors-jsonp-sample">Client-Side & Server-Side (Java) sample for Cross-Origin Resource Sharing (CORS)</a></li> - <li><a class="internal" href="/en-US/docs/Web/HTTP/Access_control_CORS">HTTP Access Control covering the HTTP headers</a></li> - <li>{{domxref("XMLHttpRequest")}}</li> - <li><a href="/en-US/docs/Web/API/Fetch_API">Fetch API</a></li> -</ul> diff --git a/files/ru/conflicting/web/http/csp/index.html b/files/ru/conflicting/web/http/csp/index.html deleted file mode 100644 index 0a998dd4ba..0000000000 --- a/files/ru/conflicting/web/http/csp/index.html +++ /dev/null @@ -1,44 +0,0 @@ ---- -title: CSP (Политика Защиты Контента) -slug: conflicting/Web/HTTP/CSP -tags: - - CSP - - Landing -translation_of: Web/HTTP/CSP -translation_of_original: Web/Security/CSP -original_slug: Web/Security/CSP ---- -<div>{{gecko_minversion_header("2.0")}}</div> - -<p><strong>Политика защиты контента</strong> (CSP) — это дополнительный уровень безопасности, который помогает обнаружить и смягчить некоторые виды атак, в том числе межсайтовый скриптинг (XSS) и инъекцию данных. Эти атаки используются для всего, от кражи данных до порчи сайтов и распространения вредоносного ПО.</p> - -<p>Хотя CSP выпустила первую в Firefox 4, с использованием <code>X-Content-Security-Policy</code> предварительно из-за наличия формальной спецификации для CSP. Firefox 23 содержит обновлённую реализацию CSP, которая используется без префикса заголовка Content-Security-Policy и директив, как описано в W3C CSP 1.0 spec.</p> - -<h2 id="Разделы_CSP">Разделы CSP</h2> - -<dl> - <dt><a href="/en-US/docs/Security/CSP/Introducing_Content_Security_Policy">Introducing Content Security Policy</a></dt> - <dd>Обзор того, что такое CSP и как это может сделать ваш сайт более безопасным.</dd> - <dt><a href="/en-US/docs/Security/CSP/CSP_policy_directives">CSP policy directives</a></dt> - <dd>Ссылка на CSP директивы политик.</dd> - <dt><a href="/en-US/docs/Security/CSP/Using_Content_Security_Policy">Using Content Security Policy</a></dt> - <dd>Вы можете настроить поведение CSP при настройке наборов правил политик. Это позволяет ослабить или усилить меры безопасности для отдельных видов ресурсов, исходя из потребностей вашего сайта. Эта статья описывает, как настроить CSP, а также о том, как включить его для вашего сайта.</dd> - <dt><a href="/en-US/docs/Security/CSP/Using_CSP_violation_reports">Using CSP violation reports</a></dt> - <dd>Как использовать сообщения CSP о нарушениях, чтобы контролировать попытки атаковать ваш сайт и его пользователей.</dd> - <dt><a href="/en-US/docs/Security/CSP/Default_CSP_restrictions">Default CSP restrictions </a>{{obsolete_inline("15.0")}}</dt> - <dd>Подробности об ограничениях внедрённых по умолчанию в CSP.</dd> -</dl> - -<h2 id="Смотрите_также">Смотрите также</h2> - -<ul> - <li><a href="/en-US/docs/Security">Security</a></li> - <li><a href="/en-US/docs/HTTP_access_control">HTTP access control</a></li> - <li><a class="link-https" href="http://www.w3.org/TR/CSP/">CSP 1.0 specification</a></li> - <li><a class="link-https" href="http://w3c.github.io/webappsec/specs/content-security-policy/csp-specification.dev.html">CSP 2 specification</a></li> - <li><a href="/docs/Apps/CSP">CSP restrictions for Open Web Apps</a></li> -</ul> - -<div id="__if72ru4rkjahiuyi_once" class="hidden"> </div> - -<div id="__hggasdgjhsagd_once" class="hidden"> </div> diff --git a/files/ru/conflicting/web/javascript/guide/index.html b/files/ru/conflicting/web/javascript/guide/index.html deleted file mode 100644 index aa546fe559..0000000000 --- a/files/ru/conflicting/web/javascript/guide/index.html +++ /dev/null @@ -1,924 +0,0 @@ ---- -title: Predefined Core Objects -slug: conflicting/Web/JavaScript/Guide -translation_of: Web/JavaScript/Guide -translation_of_original: Web/JavaScript/Guide/Predefined_Core_Objects -original_slug: Web/JavaScript/Guide/Predefined_Core_Objects ---- -<p>Эта глава описывает предопределённые объекты в стандартном JavaScript: <code>Array</code>, <code>Boolean</code>, <code>Date</code>, <code>Function</code>, <code>Math</code>, <code>Number</code>, <code>RegExp</code>, и <code>String</code>.</p> - -<h2 id="Объект_Array">Объект Array</h2> - -<p>В JavaScript массив как тип данных отсутствует. Тем не менее, вы можете использовать предопределённый объект <code>Array</code> и его методы, чтобы работать с массивами в ваших приложениях. Объект <code>Array</code> содержит различные методы для манипуляций с массивами, такими как объединение, обращение и сортировка. У него есть свойство для определения длины массива и другие свойства для работы с регулярными выражениями.</p> - -<p><em>Массив</em> - это упорядоченный набор значений, обращаться к которым можно с помощью имени и индекса. Например, можно создать массив <code>emp</code>, который содержит имена сотрудников фирмы, проиндексированные номерами. Тогда <code>emp[1]</code> будет соответствовать сотруднику номер один, <code>emp[2]</code> сотруднику номер два и так далее.</p> - -<h3 id="Создание_объекта_Array">Создание объекта Array</h3> - -<p>Следующие инструкции создают эквивалентные массивы:</p> - -<div style="margin-right: 270px;"> -<pre class="brush: js">var arr = new Array(element0, element1, ..., elementN); -var arr = Array(element0, element1, ..., elementN); -var arr = [element0, element1, ..., elementN]; -</pre> -</div> - -<p><code>element0, element1, ..., elementN</code> это список значений во вновь создаваемом массиве. Когда эти значения заданы, массив инициализирует ими свои элементы. Длина массива определяется по числу аргументов и сохраняется в свойстве <code>length </code>(длина).</p> - -<p>Синтаксис с квадратными скобками называется "литералом массива" (array literal) или "инициализатором массива" (array initializer). Такая запись короче других и используется чаще. Подробности смотрите в <a href="/en-US/docs/JavaScript/Guide/Values,_Variables,_and_Literals#Array_Literals" title="en-US/docs/JavaScript/Guide/Values, Variables, and Literals#Array Literals">Array Literals</a>.</p> - -<p>Создать массив ненулевой длины, но без элементов, можно одним из следующих способов:</p> - -<pre class="brush: js">var arr = new Array(arrayLength); -var arr = Array(arrayLength); - -// This has exactly the same effect -var arr = []; -arr.length = arrayLength; -</pre> - -<p>Обратите внимание: в приведённом выше коде <code>arrayLength</code> должен быть значением типа <code>Number</code>, то есть числом, иначе будет создан массив с одним элементом (переданным конструктору значением). Вызов <code>arr.length</code> возвратит <code>arrayLength</code>, хотя на самом деле элемент содержит пустые (неопределённые, undefined) элементы. Итерация по массиву циклом for...in не возвратит никаких элементов.</p> - -<p>Массивы можно не только определить как и переменные, но и присвоить существующему объекту как свойство:</p> - -<pre class="brush: js">var obj = {}; -// ... -obj.prop = [element0, element1, ..., elementN]; - -// OR -var obj = {prop: [element0, element1, ...., elementN]} -</pre> - -<p>Если же вы хотите создать одноэлементный массив, содержащий число, придётся использовать запись с квадратными скобками, так как когда конструктору Array() передаётся одно-единственное число, оно трактуется как длина массива, а не как хранимый элемент.</p> - -<pre><code>var arr = [42]; -var arr = Array(42); // Creates an array with no element, but with arr.length set to 42 - -// The above code is equivalent to -var arr = []; -arr.length = 42; -</code> -</pre> - -<p>Вызов <code>Array(N)</code> приводит к <code>RangeError</code>, если <code>N</code> не является целым числом, чья дробная часть не равна нулю. Следующий пример иллюстрирует это поведение.</p> - -<pre>var arr = Array(9.3); // RangeError: Invalid array length -</pre> - -<p>Если ваш код должен создавать массивы с отдельными элементами произвольного типа, безопаснее использовать литералы массива. Или, создайте пустой массив, прежде чем добавлять элементы к нему.</p> - -<h3 id="Заполнение_массива">Заполнение массива</h3> - -<p>You can populate an array by assigning values to its elements. For example,</p> - -<pre class="brush: js">var emp = []; -emp[0] = "Casey Jones"; -emp[1] = "Phil Lesh"; -emp[2] = "August West"; -</pre> - -<p><strong>Note:</strong> if you supply a non-integer value to the array operator in the code above, a property will be created in the object representing the array, instead of an array element.</p> - -<pre> var arr = []; -arr[3.4] = "Oranges"; -console.log(arr.length); // 0 -console.log(arr.hasOwnProperty(3.4)); // true -</pre> - -<p>You can also populate an array when you create it:</p> - -<pre class="brush: js">var myArray = new Array("Hello", myVar, 3.14159); -var myArray = ["Mango", "Apple", "Orange"] -</pre> - -<h3 id="Referring_to_Array_Elements">Referring to Array Elements</h3> - -<p>You refer to an array's elements by using the element's ordinal number. For example, suppose you define the following array:</p> - -<pre class="brush: js">var myArray = ["Wind", "Rain", "Fire"]; -</pre> - -<p>You then refer to the first element of the array as <code>myArray[0]</code> and the second element of the array as <code>myArray[1]</code>. The index of the elements begins with zero.</p> - -<p><strong>Note:</strong> the array operator (square brackets) is also used for accessing the array's properties (arrays are also objects in JavaScript). For example,</p> - -<pre> var arr = ["one", "two", "three"]; -arr[2]; // three -arr["length"]; // 3 -</pre> - -<h3 id="Understanding_length">Understanding length</h3> - -<p>At the implementation level, JavaScript's arrays actually store their elements as standard object properties, using the array index as the property name. The <code>length</code> property is special; it always returns the index of the last element plus one (in following example Dusty is indexed at 30 so cats.length returns 30 + 1). Remember, Javascript Array indexes are 0-based: they start at 0, not 1. This means that the <code><code>length</code></code> property will be one more than the highest index stored in the array:</p> - -<pre class="brush: js">var cats = []; -cats[30] = ['Dusty']; -print(cats.length); // 31 -</pre> - -<p>You can also assign to the <code>length</code> property. Writing a value that is shorter than the number of stored items truncates the array; writing 0 empties it entirely:</p> - -<pre class="brush: js">var cats = ['Dusty', 'Misty', 'Twiggy']; -console.log(cats.length); // 3 - -cats.length = 2; -console.log(cats); // prints "Dusty,Misty" - Twiggy has been removed - -cats.length = 0; -console.log(cats); // prints nothing; the cats array is empty - -cats.length = 3; -console.log(cats); // [undefined, undefined, undefined] -</pre> - -<h3 id="Iterating_over_arrays">Iterating over arrays</h3> - -<p>A common operation is to iterate over the values of an array, processing each one in some way. The simplest way to do this is as follows:</p> - -<pre class="brush: js">var colors = ['red', 'green', 'blue']; -for (var i = 0; i < colors.length; i++) { - console.log(colors[i]); -} -</pre> - -<p>If you know that none of the elements in your array evaluate to <code>false</code> in a boolean context — if your array consists only of <a href="/en-US/docs/DOM" title="en-US/docs/DOM">DOM</a> nodes, for example, you can use a more efficient idiom:</p> - -<pre class="brush: js">var divs = document.getElementsByTagName('div'); -for (var i = 0, div; div = divs[i]; i++) { - /* Process div in some way */ -} -</pre> - -<p>This avoids the overhead of checking the length of the array, and ensures that the <code>div</code> variable is reassigned to the current item each time around the loop for added convenience.</p> - -<p>The <a href="/en-US/docs/JavaScript/Reference/Global_Objects/Array/forEach" title="en-US/docs/JavaScript/Reference/Global_Objects/Array/forEach"><code>forEach()</code></a> method, introduced in JavaScript 1.6, provides another way of iterating over an array:</p> - -<pre class="brush: js">var colors = ['red', 'green', 'blue']; -colors.forEach(function(color) { - console.log(color); -}); -</pre> - -<p>The function passed to <code>forEach</code> is executed once for every item in the array, with the array item passed as the argument to the function. Unassigned values are not iterated in a <code>forEach</code> loop.</p> - -<p>Note that the elements of array omitted when the array is defined are not listed when iterating by <code>forEach, </code>but are listed when <code>undefined</code> has been manually assigned to the element:</p> - -<pre class="brush: js">var array = ['first', 'second', , 'fourth']; - -// returns ['first', 'second', 'fourth']; -array.forEach(function(element) { - console.log(element); -}) - -if(array[2] === undefined) { console.log('array[2] is undefined'); } // true - -var array = ['first', 'second', undefined, 'fourth']; - -// returns ['first', 'second', undefined, 'fourth']; -array.forEach(function(element) { - console.log(element); -})</pre> - -<p>Since JavaScript elements are saved as standard object properties, it is not advisable to iterate through JavaScript arrays using for...in loops because normal elements and all enumerable properties will be listed.</p> - -<h3 id="Array_Methods">Array Methods</h3> - -<p>The <code>Array</code> object has the following methods:</p> - -<ul> - <li><a href="/en-US/docs/JavaScript/Reference/Global_Objects/Array/concat" title="en-US/docs/JavaScript/Reference/Global - Objects/Array/concat"><code>concat()</code></a> joins two arrays and returns a new array. - - <pre class="brush: js">var myArray = new Array("1", "2", "3"); -myArray = myArray.concat("a", "b", "c"); // myArray is now ["1", "2", "3", "a", "b", "c"] -</pre> - </li> - <li><a href="/en-US/docs/JavaScript/Reference/Global_Objects/Array/join" title="en-US/docs/JavaScript/Reference/Global - Objects/Array/join"><code>join(deliminator = ",")</code></a> joins all elements of an array into a string. - <pre class="brush: js">var myArray = new Array("Wind", "Rain", "Fire"); -var list = myArray.join(" - "); // list is "Wind - Rain - Fire" -</pre> - </li> - <li><a href="/en-US/docs/JavaScript/Reference/Global_Objects/Array/push" title="en-US/docs/JavaScript/Reference/Global - Objects/Array/push"><code>push()</code></a> adds one or more elements to the end of an array and returns the resulting length of the array. - <pre class="brush: js">var myArray = new Array("1", "2"); -myArray.push("3"); // myArray is now ["1", "2", "3"] -</pre> - </li> - <li><a href="/en-US/docs/JavaScript/Reference/Global_Objects/Array/pop" title="en-US/docs/JavaScript/Reference/Global - Objects/Array/pop"><code>pop()</code></a> removes the last element from an array and returns that element. - <pre class="brush: js">var myArray = new Array("1", "2", "3"); -var last = myArray.pop(); // myArray is now ["1", "2"], last = "3" -</pre> - </li> - <li><a href="/en-US/docs/JavaScript/Reference/Global_Objects/Array/shift" title="en-US/docs/JavaScript/Reference/Global - Objects/Array/shift"><code>shift()</code></a> removes the first element from an array and returns that element. - <pre class="brush: js">var myArray = new Array ("1", "2", "3"); -var first = myArray.shift(); // myArray is now ["2", "3"], first is "1" -</pre> - </li> - <li><a href="/en-US/docs/JavaScript/Reference/Global_Objects/Array/unshift" title="en-US/docs/JavaScript/Reference/Global - Objects/Array/unshift"><code>unshift()</code></a> adds one or more elements to the front of an array and returns the new length of the array. - <pre class="brush: js">var myArray = new Array ("1", "2", "3"); -myArray.unshift("4", "5"); // myArray becomes ["4", "5", "1", "2", "3"]</pre> - </li> - <li><a href="/en-US/docs/JavaScript/Reference/Global_Objects/Array/slice" title="en-US/docs/JavaScript/Reference/Global - Objects/Array/slice"><code>slice(start_index, upto_index)</code></a> extracts a section of an array and returns a new array. - <pre class="brush: js">var myArray = new Array ("a", "b", "c", "d", "e"); -myArray = myArray.slice(1, 4); /* starts at index 1 and extracts all elements - until index 3, returning [ "b", "c", "d"] */ -</pre> - </li> - <li><a href="/en-US/docs/JavaScript/Reference/Global_Objects/Array/splice" title="en-US/docs/JavaScript/Reference/Global - Objects/Array/splice"><code>splice(index, count_to_remove, addelement1, addelement2, ...)</code></a> removes elements from an array and (optionally) replaces them. - <pre class="brush: js">var myArray = new Array ("1", "2", "3", "4", "5"); -myArray.splice(1, 3, "a", "b", "c", "d"); // myArray is now ["1", "a", "b", "c", "d", "5"] - // This code started at index one (or where the "2" was), removed 3 elements there, - // and then inserted all consecutive elements in its place. -</pre> - </li> - <li><a href="/en-US/docs/JavaScript/Reference/Global_Objects/Array/reverse" title="en-US/docs/JavaScript/Reference/Global - Objects/Array/reverse"><code>reverse()</code></a> transposes the elements of an array: the first array element becomes the last and the last becomes the first. - <pre class="brush: js">var myArray = new Array ("1", "2", "3"); -myArray.reverse(); // transposes the array so that myArray = [ "3", "2", "1" ] -</pre> - </li> - <li><a href="/en-US/docs/JavaScript/Reference/Global_Objects/Array/sort" title="en-US/docs/JavaScript/Reference/Global - Objects/Array/sort"><code>sort()</code></a> sorts the elements of an array. - <pre class="brush: js">var myArray = new Array("Wind", "Rain", "Fire"); -myArray.sort(); // sorts the array so that myArrray = [ "Fire", "Rain", "Wind" ] -</pre> - - <p><code>sort()</code> can also take a callback function to determine how array elements are compared. The function compares two values and returns one of three values:</p> - - <ul> - <li>if <code>a</code> is less than <code>b</code> by the sorting system, return -1 (or any negative number)</li> - <li>if <code>a</code> is greater than <code>b</code> by the sorting system, return 1 (or any positive number)</li> - <li>if <code>a</code> and <code>b</code> are considered equivalent, return 0.</li> - </ul> - - <p>For instance, the following will sort by the last letter of an array:</p> - - <pre class="brush: js">var sortFn = function(a, b){ - if (a[a.length - 1] < b[b.length - 1]) return -1; - if (a[a.length - 1] > b[b.length - 1]) return 1; - if (a[a.length - 1] == b[b.length - 1]) return 0; -} -myArray.sort(sortFn); // sorts the array so that myArray = ["Wind","Fire","Rain"]</pre> - </li> -</ul> - -<p>Compatibility code for older browsers can be found for each of these functions on the individual pages. Native browser support for these features in various browsers can be found<a class="external" href="http://www.robertnyman.com/javascript/" title="http://www.robertnyman.com/javascript/"> here.</a></p> - -<ul> - <li><a href="/en-US/docs/JavaScript/Reference/Global_Objects/Array/indexOf" title="en-US/docs/JavaScript/Reference/Global - Objects/Array/indexOf"><code>indexOf(searchElement[, fromIndex])</code></a> searches the array for <code>searchElement</code> and returns the index of the first match. - - <pre class="brush: js">var a = ['a', 'b', 'a', 'b', 'a']; -alert(a.indexOf('b')); // Alerts 1 -// Now try again, starting from after the last match -alert(a.indexOf('b', 2)); // Alerts 3 -alert(a.indexOf('z')); // Alerts -1, because 'z' was not found -</pre> - </li> - <li><a href="/en-US/docs/JavaScript/Reference/Global_Objects/Array/lastIndexOf" title="en-US/docs/JavaScript/Reference/Global - Objects/Array/lastIndexOf"><code>lastIndexOf(searchElement[, fromIndex])</code></a> works like <code>indexOf</code>, but starts at the end and searches backwards. - <pre class="brush: js">var a = ['a', 'b', 'c', 'd', 'a', 'b']; -alert(a.lastIndexOf('b')); // Alerts 5 -// Now try again, starting from before the last match -alert(a.lastIndexOf('b', 4)); // Alerts 1 -alert(a.lastIndexOf('z')); // Alerts -1 -</pre> - </li> - <li><a href="/en-US/docs/JavaScript/Reference/Global_Objects/Array/forEach" title="en-US/docs/JavaScript/Reference/Global - Objects/Array/forEach"><code>forEach(callback[, thisObject])</code></a> executes <code>callback</code> on every array item. - <pre class="brush: js">var a = ['a', 'b', 'c']; -a.forEach(alert); // Alerts each item in turn -</pre> - </li> - <li><a href="/en-US/docs/JavaScript/Reference/Global_Objects/Array/map" title="en-US/docs/JavaScript/Reference/Global - Objects/Array/map"><code>map(callback[, thisObject])</code></a> returns a new array of the return value from executing <code>callback</code> on every array item. - <pre class="brush: js">var a1 = ['a', 'b', 'c']; -var a2 = a1.map(function(item) { return item.toUpperCase(); }); -alert(a2); // Alerts A,B,C -</pre> - </li> - <li><a href="/en-US/docs/JavaScript/Reference/Global_Objects/Array/filter" title="en-US/docs/JavaScript/Reference/Global - Objects/Array/filter"><code>filter(callback[, thisObject])</code></a> returns a new array containing the items for which callback returned true. - <pre class="brush: js">var a1 = ['a', 10, 'b', 20, 'c', 30]; -var a2 = a1.filter(function(item) { return typeof item == 'number'; }); -alert(a2); // Alerts 10,20,30 -</pre> - </li> - <li><a href="/en-US/docs/JavaScript/Reference/Global_Objects/Array/every" title="en-US/docs/JavaScript/Reference/Global - Objects/Array/every"><code>every(callback[, thisObject])</code></a> returns true if <code>callback</code> returns true for every item in the array. - <pre class="brush: js">function isNumber(value){ - return typeof value == 'number'; -} -var a1 = [1, 2, 3]; -alert(a1.every(isNumber)); // Alerts true -var a2 = [1, '2', 3]; -alert(a2.every(isNumber)); // Alerts false -</pre> - </li> - <li><a href="/en-US/docs/JavaScript/Reference/Global_Objects/Array/some" title="en-US/docs/JavaScript/Reference/Global - Objects/Array/some"><code>some(callback[, thisObject])</code></a> returns true if <code>callback</code> returns true for at least one item in the array. - <pre class="brush: js">function isNumber(value){ - return typeof value == 'number'; -} -var a1 = [1, 2, 3]; -alert(a1.some(isNumber)); // Alerts true -var a2 = [1, '2', 3]; -alert(a2.some(isNumber)); // Alerts true -var a3 = ['1', '2', '3']; -alert(a3.some(isNumber)); // Alerts false -</pre> - </li> -</ul> - -<p>The methods above that take a callback are known as <em>iterative methods</em>, because they iterate over the entire array in some fashion. Each one takes an optional second argument called <code>thisObject</code>. If provided, <code>thisObject</code> becomes the value of the <code>this</code> keyword inside the body of the callback function. If not provided, as with other cases where a function is invoked outside of an explicit object context, <code>this</code> will refer to the global object (<a href="/en-US/docs/DOM/window" title="en-US/docs/DOM/window"><code>window</code></a>).</p> - -<p>The callback function is actually called with three arguments. The first is the value of the current item, the second is its array index, and the third is a reference to the array itself. JavaScript functions ignore any arguments that are not named in the parameter list so it is safe to provide a callback function that only takes a single argument, such as <code>alert</code>.</p> - -<ul> - <li><a href="/en-US/docs/JavaScript/Reference/Global_Objects/Array/Reduce" title="en-US/docs/JavaScript/Reference/Global - Objects/Array/reduce"><code>reduce(callback[, initialValue])</code></a> applies <code>callback(firstValue, secondValue)</code> to reduce the list of items down to a single value. - - <pre class="brush: js">var a = [10, 20, 30]; -var total = a.reduce(function(first, second) { return first + second; }, 0); -alert(total) // Alerts 60 -</pre> - </li> - <li><a href="/en-US/docs/JavaScript/Reference/Global_Objects/Array/ReduceRight" title="en-US/docs/JavaScript/Reference/Global - Objects/Array/reduceRight"><code>reduceRight(callback[, initialValue])</code></a> works like <code>reduce()</code>, but starts with the last element.</li> -</ul> - -<p><code>reduce</code> and <code>reduceRight</code> are the least obvious of the iterative array methods. They should be used for algorithms that combine two values recursively in order to reduce a sequence down to a single value.</p> - -<h3 id="Multi-Dimensional_Arrays">Multi-Dimensional Arrays</h3> - -<p>Arrays can be nested, meaning that an array can contain another array as an element. Using this characteristic of JavaScript arrays, multi-dimensional arrays can be created.</p> - -<p>The following code creates a two-dimensional array.</p> - -<pre class="brush: js">var a = new Array(4); -for (i = 0; i < 4; i++) { - a[i] = new Array(4); - for (j = 0; j < 4; j++) { - a[i][j] = "[" + i + "," + j + "]"; - } -} -</pre> - -<p>This example creates an array with the following rows:</p> - -<pre>Row 0: [0,0] [0,1] [0,2] [0,3] -Row 1: [1,0] [1,1] [1,2] [1,3] -Row 2: [2,0] [2,1] [2,2] [2,3] -Row 3: [3,0] [3,1] [3,2] [3,3] -</pre> - -<h3 id="Arrays_and_Regular_Expressions">Arrays and Regular Expressions</h3> - -<p>When an array is the result of a match between a regular expression and a string, the array returns properties and elements that provide information about the match. An array is the return value of <a href="/en-US/docs/JavaScript/Reference/Global_Objects/RegExp/exec" title="en-US/docs/JavaScript/Reference/Global Objects/RegExp/exec"><code>RegExp.exec()</code></a>, <a href="/en-US/docs/JavaScript/Reference/Global_Objects/String/match" title="en-US/docs/JavaScript/Reference/Global Objects/String/match"><code>String.match()</code></a>, and <a href="/en-US/docs/JavaScript/Reference/Global_Objects/String/split" title="en-US/docs/JavaScript/Reference/Global -Objects/String/split"><code>String.split()</code></a>. For information on using arrays with regular expressions, see <a href="/en-US/docs/JavaScript/Guide/Regular_Expressions" title="en-US/docs/JavaScript/Guide/Regular Expressions">Regular Expressions</a>.</p> - -<h3 id="Working_with_Array-like_objects">Working with Array-like objects</h3> - -<p>Some JavaScript objects, such as the <a href="/en-US/docs/DOM/NodeList" title="en-US/docs/DOM/NodeList"><code>NodeList</code></a> returned by <a href="/en-US/docs/DOM/document.getElementsByTagName" title="en-US/docs/DOM/document.getElementsByTagName"><code>document.getElementsByTagName()</code></a> or the <a href="/en-US/docs/JavaScript/Reference/Functions_and_function_scope/arguments" title="en-US/docs/JavaScript/Reference/Functions and -function -scope/arguments"><code>arguments</code></a> object made available within the body of a function, look and behave like arrays on the surface but do not share all of their methods. The <code>arguments</code> object provides a <a href="/en-US/docs/JavaScript/Reference/Functions_and_function_scope/arguments/length" title="en-US/docs/JavaScript/Reference/Functions -and function -scope/arguments/length"><code>length</code></a> attribute but does not implement the <a href="/en-US/docs/JavaScript/Reference/Global_Objects/Array/forEach" title="en-US/docs/JavaScript/Reference/Global Objects/Array/forEach"><code>forEach()</code></a> method, for example.</p> - -<p>Array generics, introduced in JavaScript 1.6, provide a way of running <code>Array</code> methods against other array-like objects. Each standard array method has a corresponding method on the <code>Array</code> object itself; for example:</p> - -<pre class="brush: js"> function alertArguments() { - Array.forEach(arguments, function(item) { - alert(item); - }); - } -</pre> - -<p>These generic methods can be emulated more verbosely in older versions of JavaScript using the call method provided by JavaScript function objects:</p> - -<pre class="brush: js"> Array.prototype.forEach.call(arguments, function(item) { - alert(item); - }); -</pre> - -<p>Array generic methods can be used on strings as well, since they provide sequential access to their characters in a similar way to arrays:</p> - -<pre class="brush: js">Array.forEach("a string", function(chr) { - alert(chr); -});</pre> - -<p>Here are some further examples of applying array methods to strings, also taking advantage of <a href="/en-US/docs/JavaScript/New_in_JavaScript/1.8#Expression_closures" title="en-US/docs/New_in_JavaScript_1.8#Expression_closures">JavaScript 1.8 expression closures</a>:</p> - -<pre class="brush: js">var str = 'abcdef'; -var consonantsOnlyStr = Array.filter(str, function (c) !(/[aeiou]/i).test(c)).join(''); // 'bcdf' -var vowelsPresent = Array.some(str, function (c) (/[aeiou]/i).test(c)); // true -var allVowels = Array.every(str, function (c) (/[aeiou]/i).test(c)); // false -var interpolatedZeros = Array.map(str, function (c) c+'0').join(''); // 'a0b0c0d0e0f0' -var numerologicalValue = Array.reduce(str, function (c, c2) c+c2.toLowerCase().charCodeAt()-96, 0); -// 21 (reduce() since JS v1.8) -</pre> - -<p>Note that <code>filter</code> and <code>map</code> do not automatically return the characters back into being members of a string in the return result; an array is returned, so we must use <code>join</code> to return back to a string.</p> - -<h3 id="Array_comprehensions">Array comprehensions</h3> - -<p>Introduced in JavaScript 1.7, array comprehensions provide a useful shortcut for constructing a new array based on the contents of another. Comprehensions can often be used in place of calls to <code>map()</code> and <code>filter()</code>, or as a way of combining the two.</p> - -<p>The following comprehension takes an array of numbers and creates a new array of the double of each of those numbers.</p> - -<pre class="brush: js">var numbers = [1, 2, 3, 4]; -var doubled = [i * 2 for (i of numbers)]; -alert(doubled); // Alerts 2,4,6,8 -</pre> - -<p>This is equivalent to the following <code>map()</code> operation:</p> - -<pre class="brush: js">var doubled = numbers.map(function(i){return i * 2;}); -</pre> - -<p>Comprehensions can also be used to select items that match a particular expression. Here is a comprehension which selects only even numbers:</p> - -<pre class="brush: js">var numbers = [1, 2, 3, 21, 22, 30]; -var evens = [i for (i of numbers) if (i % 2 === 0)]; -alert(evens); // Alerts 2,22,30 -</pre> - -<p><code>filter()</code> can be used for the same purpose:</p> - -<pre class="brush: js">var evens = numbers.filter(function(i){return i % 2 === 0;}); -</pre> - -<p><code>map()</code> and <code>filter()</code> style operations can be combined into a single array comprehension. Here is one that filters just the even numbers, then creates an array containing their doubles:</p> - -<pre class="brush: js">var numbers = [1, 2, 3, 21, 22, 30]; -var doubledEvens = [i * 2 for (i of numbers) if (i % 2 === 0)]; -alert(doubledEvens); // Alerts 4,44,60 -</pre> - -<p>The square brackets of an array comprehension introduce an implicit block for scoping purposes. New variables (such as i in the example) are treated as if they had been declared using <a href="/en-US/docs/JavaScript/Reference/Statements/let" title="/en-US/docs/JavaScript/Reference/Statements/let"><code>let</code></a>. This means that they will not be available outside of the comprehension.</p> - -<p>The input to an array comprehension does not itself need to be an array; <a href="/en-US/docs/JavaScript/Guide/Iterators_and_Generators" title="en-US/docs/JavaScript/Guide/Iterators and Generators">iterators and generators</a> can also be used.</p> - -<p>Even strings may be used as input; to achieve the filter and map actions (under Array-like objects) above:</p> - -<pre class="brush: js">var str = 'abcdef'; -var consonantsOnlyStr = [c for (c of str) if (!(/[aeiouAEIOU]/).test(c)) ].join(''); // 'bcdf' -var interpolatedZeros = [c+'0' for (c of str) ].join(''); // 'a0b0c0d0e0f0' -</pre> - -<p>Again, the input form is not preserved, so we have to use <code>join()</code> to revert back to a string.</p> - -<h2 id="Boolean_Object">Boolean Object</h2> - -<p>The <code>Boolean</code> object is a wrapper around the primitive Boolean data type. Use the following syntax to create a <code>Boolean</code> object:</p> - -<pre class="brush: js">var booleanObjectName = new Boolean(value); -</pre> - -<p>Do not confuse the primitive Boolean values <code>true</code> and <code>false</code> with the true and false values of the <code>Boolean</code> object. Any object whose value is not <code>undefined</code> , <code>null</code>, <code>0</code>, <code>NaN</code>, or the empty string, including a <code>Boolean</code> object whose value is false, evaluates to true when passed to a conditional statement. See <a href="/en-US/docs/JavaScript/Guide/Statements#if...else_Statement" title="en-US/docs/JavaScript/Guide/Statements#if...else Statement">if...else Statement</a> for more information.</p> - -<h2 id="Date_Object">Date Object</h2> - -<p>JavaScript does not have a date data type. However, you can use the <code>Date</code> object and its methods to work with dates and times in your applications. The <code>Date</code> object has a large number of methods for setting, getting, and manipulating dates. It does not have any properties.</p> - -<p>JavaScript handles dates similarly to Java. The two languages have many of the same date methods, and both languages store dates as the number of milliseconds since January 1, 1970, 00:00:00.</p> - -<p>The <code>Date</code> object range is -100,000,000 days to 100,000,000 days relative to 01 January, 1970 UTC.</p> - -<p>To create a <code>Date</code> object:</p> - -<pre class="brush: js">var dateObjectName = new Date([parameters]); -</pre> - -<p>where <code>dateObjectName</code> is the name of the <code>Date</code> object being created; it can be a new object or a property of an existing object.</p> - -<p>Calling <code>Date</code> without the <code>new</code> keyword simply converts the provided date to a string representation.</p> - -<p>The <code>parameters</code> in the preceding syntax can be any of the following:</p> - -<ul> - <li>Nothing: creates today's date and time. For example, <code>today = new Date();</code>.</li> - <li>A string representing a date in the following form: "Month day, year hours:minutes:seconds." For example, <code>var Xmas95 = new Date("December 25, 1995 13:30:00")</code>. If you omit hours, minutes, or seconds, the value will be set to zero.</li> - <li>A set of integer values for year, month, and day. For example, <code>var Xmas95 = new Date(1995, 11, 25)</code>.</li> - <li>A set of integer values for year, month, day, hour, minute, and seconds. For example, <code>var Xmas95 = new Date(1995, 11, 25, 9, 30, 0);</code>.</li> -</ul> - -<p><strong>JavaScript 1.2 and earlier</strong><br> - The <code>Date</code> object behaves as follows:</p> - -<ul> - <li>Dates prior to 1970 are not allowed.</li> - <li>JavaScript depends on platform-specific date facilities and behavior; the behavior of the <code>Date</code> object varies from platform to platform.</li> -</ul> - -<h3 id="Methods_of_the_Date_Object">Methods of the Date Object</h3> - -<p>The <code>Date</code> object methods for handling dates and times fall into these broad categories:</p> - -<ul> - <li>"set" methods, for setting date and time values in <code>Date</code> objects.</li> - <li>"get" methods, for getting date and time values from <code>Date</code> objects.</li> - <li>"to" methods, for returning string values from <code>Date</code> objects.</li> - <li>parse and UTC methods, for parsing <code>Date</code> strings.</li> -</ul> - -<p>With the "get" and "set" methods you can get and set seconds, minutes, hours, day of the month, day of the week, months, and years separately. There is a <code>getDay</code> method that returns the day of the week, but no corresponding <code>setDay</code> method, because the day of the week is set automatically. These methods use integers to represent these values as follows:</p> - -<ul> - <li>Seconds and minutes: 0 to 59</li> - <li>Hours: 0 to 23</li> - <li>Day: 0 (Sunday) to 6 (Saturday)</li> - <li>Date: 1 to 31 (day of the month)</li> - <li>Months: 0 (January) to 11 (December)</li> - <li>Year: years since 1900</li> -</ul> - -<p>For example, suppose you define the following date:</p> - -<pre class="brush: js">var Xmas95 = new Date("December 25, 1995"); -</pre> - -<p>Then <code>Xmas95.getMonth()</code> returns 11, and <code>Xmas95.getFullYear()</code> returns 1995.</p> - -<p>The <code>getTime</code> and <code>setTime</code> methods are useful for comparing dates. The <code>getTime</code> method returns the number of milliseconds since January 1, 1970, 00:00:00 for a <code>Date</code> object.</p> - -<p>For example, the following code displays the number of days left in the current year:</p> - -<pre class="brush: js">var today = new Date(); -var endYear = new Date(1995, 11, 31, 23, 59, 59, 999); // Set day and month -endYear.setFullYear(today.getFullYear()); // Set year to this year -var msPerDay = 24 * 60 * 60 * 1000; // Number of milliseconds per day -var daysLeft = (endYear.getTime() - today.getTime()) / msPerDay; -var daysLeft = Math.round(daysLeft); //returns days left in the year -</pre> - -<p>This example creates a <code>Date</code> object named <code>today</code> that contains today's date. It then creates a <code>Date</code> object named <code>endYear</code> and sets the year to the current year. Then, using the number of milliseconds per day, it computes the number of days between <code>today</code> and <code>endYear</code>, using <code>getTime</code> and rounding to a whole number of days.</p> - -<p>The <code>parse</code> method is useful for assigning values from date strings to existing <code>Date</code> objects. For example, the following code uses <code>parse</code> and <code>setTime</code> to assign a date value to the <code>IPOdate</code> object:</p> - -<pre class="brush: js">var IPOdate = new Date(); -IPOdate.setTime(Date.parse("Aug 9, 1995")); -</pre> - -<h3 id="Using_the_Date_Object_an_Example">Using the Date Object: an Example</h3> - -<p>In the following example, the function <code>JSClock()</code> returns the time in the format of a digital clock.</p> - -<pre class="brush: js">function JSClock() { - var time = new Date(); - var hour = time.getHours(); - var minute = time.getMinutes(); - var second = time.getSeconds(); - var temp = "" + ((hour > 12) ? hour - 12 : hour); - if (hour == 0) - temp = "12"; - temp += ((minute < 10) ? ":0" : ":") + minute; - temp += ((second < 10) ? ":0" : ":") + second; - temp += (hour >= 12) ? " P.M." : " A.M."; - return temp; -} -</pre> - -<p>The <code>JSClock</code> function first creates a new <code>Date</code> object called <code>time</code>; since no arguments are given, time is created with the current date and time. Then calls to the <code>getHours</code>, <code>getMinutes</code>, and <code>getSeconds</code> methods assign the value of the current hour, minute, and second to <code>hour</code>, <code>minute</code>, and <code>second</code>.</p> - -<p>The next four statements build a string value based on the time. The first statement creates a variable <code>temp</code>, assigning it a value using a conditional expression; if <code>hour</code> is greater than 12, (<code>hour - 12</code>), otherwise simply hour, unless hour is 0, in which case it becomes 12.</p> - -<p>The next statement appends a <code>minute</code> value to <code>temp</code>. If the value of <code>minute</code> is less than 10, the conditional expression adds a string with a preceding zero; otherwise it adds a string with a demarcating colon. Then a statement appends a seconds value to <code>temp</code> in the same way.</p> - -<p>Finally, a conditional expression appends "P.M." to <code>temp</code> if <code>hour</code> is 12 or greater; otherwise, it appends "A.M." to <code>temp</code>.</p> - -<h2 id="Function_Object">Function Object</h2> - -<p>The predefined <code>Function</code> object specifies a string of JavaScript code to be compiled as a function.</p> - -<p>To create a <code>Function</code> object:</p> - -<pre class="brush: js">var functionObjectName = new Function ([arg1, arg2, ... argn], functionBody); -</pre> - -<p><code>functionObjectName</code> is the name of a variable or a property of an existing object. It can also be an object followed by a lowercase event handler name, such as <code>window.onerror</code>.</p> - -<p><code>arg1</code>, <code>arg2</code>, ... <code>argn</code> are arguments to be used by the function as formal argument names. Each must be a string that corresponds to a valid JavaScript identifier; for example "x" or "theForm".</p> - -<p><code>functionBody</code> is a string specifying the JavaScript code to be compiled as the function body.</p> - -<p><code>Function</code> objects are evaluated each time they are used. This is less efficient than declaring a function and calling it within your code, because declared functions are compiled.</p> - -<p>In addition to defining functions as described here, you can also use the <a href="/en-US/docs/JavaScript/Reference/Statements/function" title="en-US/docs/JavaScript/Reference/Statements/function"><code>function</code> statement</a> and the function expression. See the <a href="/en-US/docs/JavaScript/Reference" title="en-US/docs/JavaScript/Reference">JavaScript Reference</a> for more information.</p> - -<p>The following code assigns a function to the variable <code>setBGColor</code>. This function sets the current document's background color.</p> - -<pre class="brush: js">var setBGColor = new Function("document.bgColor = 'antiquewhite'"); -</pre> - -<p>To call the <code>Function</code> object, you can specify the variable name as if it were a function. The following code executes the function specified by the <code>setBGColor</code> variable:</p> - -<pre class="brush: js">var colorChoice="antiquewhite"; -if (colorChoice=="antiquewhite") {setBGColor()} -</pre> - -<p>You can assign the function to an event handler in either of the following ways:</p> - -<ol> - <li> - <pre class="brush: js">document.form1.colorButton.onclick = setBGColor; -</pre> - </li> - <li> - <pre class="brush: html"><INPUT NAME="colorButton" TYPE="button" - VALUE="Change background color" - onClick="setBGColor()"> -</pre> - </li> -</ol> - -<p>Creating the variable <code>setBGColor</code> shown above is similar to declaring the following function:</p> - -<pre class="brush: js">function setBGColor() { - document.bgColor = 'antiquewhite'; -} -</pre> - -<p>Assigning a function to a variable is similar to declaring a function, but there are differences:</p> - -<ul> - <li>When you assign a function to a variable using <code>var setBGColor = new Function("...")</code>, <code>setBGColor</code> is a variable for which the current value is a reference to the function created with <code>new Function()</code>.</li> - <li>When you create a function using <code>function setBGColor() {...}</code>, <code>setBGColor</code> is not a variable, it is the name of a function.</li> -</ul> - -<p>You can nest a function within a function. The nested (inner) function is private to its containing (outer) function:</p> - -<ul> - <li>The inner function can be accessed only from statements in the outer function.</li> - <li>The inner function can use the arguments and variables of the outer function. The outer function cannot use the arguments and variables of the inner function.</li> -</ul> - -<h2 id="Math_Object">Math Object</h2> - -<p>The predefined <code>Math</code> object has properties and methods for mathematical constants and functions. For example, the <code>Math</code> object's <code>PI</code> property has the value of pi (3.141...), which you would use in an application as</p> - -<pre class="brush: js">Math.PI -</pre> - -<p>Similarly, standard mathematical functions are methods of <code>Math</code>. These include trigonometric, logarithmic, exponential, and other functions. For example, if you want to use the trigonometric function sine, you would write</p> - -<pre class="brush: js">Math.sin(1.56) -</pre> - -<p>Note that all trigonometric methods of <code>Math</code> take arguments in radians.</p> - -<p>The following table summarizes the <code>Math</code> object's methods.</p> - -<table class="standard-table"> - <caption>Table 7.1 Methods of Math</caption> - <thead> - <tr> - <th scope="col">Method</th> - <th scope="col">Description</th> - </tr> - </thead> - <tbody> - <tr> - <td><code>abs</code></td> - <td>Absolute value</td> - </tr> - <tr> - <td><code>sin</code>, <code>cos</code>, <code>tan</code></td> - <td>Standard trigonometric functions; argument in radians</td> - </tr> - <tr> - <td><code>acos</code>, <code>asin</code>, <code>atan</code>, <code>atan2</code></td> - <td>Inverse trigonometric functions; return values in radians</td> - </tr> - <tr> - <td><code>exp</code>, <code>log</code></td> - <td>Exponential and natural logarithm, base <code>e</code></td> - </tr> - <tr> - <td><code>ceil</code></td> - <td>Returns least integer greater than or equal to argument</td> - </tr> - <tr> - <td><code>floor</code></td> - <td>Returns greatest integer less than or equal to argument</td> - </tr> - <tr> - <td><code>min</code>, <code>max</code></td> - <td>Returns greater or lesser (respectively) of two arguments</td> - </tr> - <tr> - <td><code>pow</code></td> - <td>Exponential; first argument is base, second is exponent</td> - </tr> - <tr> - <td><code>random</code></td> - <td>Returns a random number between 0 and 1.</td> - </tr> - <tr> - <td><code>round</code></td> - <td>Rounds argument to nearest integer</td> - </tr> - <tr> - <td><code>sqrt</code></td> - <td>Square root</td> - </tr> - </tbody> -</table> - -<p>Unlike many other objects, you never create a <code>Math</code> object of your own. You always use the predefined <code>Math</code> object.</p> - -<h2 id="Number_Object">Number Object</h2> - -<p>The <code>Number</code> object has properties for numerical constants, such as maximum value, not-a-number, and infinity. You cannot change the values of these properties and you use them as follows:</p> - -<pre class="brush: js">var biggestNum = Number.MAX_VALUE; -var smallestNum = Number.MIN_VALUE; -var infiniteNum = Number.POSITIVE_INFINITY; -var negInfiniteNum = Number.NEGATIVE_INFINITY; -var notANum = Number.NaN; -</pre> - -<p>You always refer to a property of the predefined <code>Number</code> object as shown above, and not as a property of a <code>Number</code> object you create yourself.</p> - -<p>The following table summarizes the <code>Number</code> object's properties.</p> - -<table class="standard-table"> - <caption>Table 7.2 Properties of Number</caption> - <thead> - <tr> - <th scope="col">Property</th> - <th scope="col">Description</th> - </tr> - </thead> - <tbody> - <tr> - <td><code>MAX_VALUE</code></td> - <td>The largest representable number</td> - </tr> - <tr> - <td><code>MIN_VALUE</code></td> - <td>The smallest representable number</td> - </tr> - <tr> - <td><code>NaN</code></td> - <td>Special "not a number" value</td> - </tr> - <tr> - <td><code>NEGATIVE_INFINITY</code></td> - <td>Special negative infinite value; returned on overflow</td> - </tr> - <tr> - <td><code>POSITIVE_INFINITY</code></td> - <td>Special positive infinite value; returned on overflow</td> - </tr> - </tbody> -</table> - -<p>The Number prototype provides methods for retrieving information from Number objects in various formats. The following table summarizes the methods of <code>Number.prototype</code>.</p> - -<table class="fullwidth-table"> - <caption>Table 7.3 Methods of Number.prototype</caption> - <thead> - <tr> - <th scope="col">Method</th> - <th scope="col">Description</th> - </tr> - </thead> - <tbody> - <tr> - <td><code>toExponential</code></td> - <td>Returns a string representing the number in exponential notation.</td> - </tr> - <tr> - <td><code>toFixed</code></td> - <td>Returns a string representing the number in fixed-point notation.</td> - </tr> - <tr> - <td><code>toPrecision</code></td> - <td>Returns a string representing the number to a specified precision in fixed-point notation.</td> - </tr> - <tr> - <td><code>toSource</code></td> - <td>Returns an object literal representing the specified <code>Number</code> object; you can use this value to create a new object. Overrides the <code>Object.toSource</code> method.</td> - </tr> - <tr> - <td><code>toString</code></td> - <td>Returns a string representing the specified object. Overrides the <code>Object.toString </code>method.</td> - </tr> - <tr> - <td><code>valueOf</code></td> - <td>Returns the primitive value of the specified object. Overrides the <code>Object.valueOf </code>method.</td> - </tr> - </tbody> -</table> - -<h2 id="RegExp_Object">RegExp Object</h2> - -<p>The <code>RegExp</code> object lets you work with regular expressions. It is described in <a href="/en-US/docs/JavaScript/Guide/Regular_Expressions" title="en-US/docs/JavaScript/Guide/Regular Expressions">Regular Expressions</a>.</p> - -<h2 id="String_Object">String Object</h2> - -<p>The <code>String</code> object is a wrapper around the string primitive data type. Do not confuse a string literal with the <code>String</code> object. For example, the following code creates the string literal <code>s1</code> and also the <code>String</code> object <code>s2</code>:</p> - -<pre class="brush: js">var s1 = "foo"; //creates a string literal value -var s2 = new String("foo"); //creates a String object -</pre> - -<p>You can call any of the methods of the <code>String</code> object on a string literal value—JavaScript automatically converts the string literal to a temporary <code>String</code> object, calls the method, then discards the temporary <code>String</code> object. You can also use the <code>String.length</code> property with a string literal.</p> - -<p>You should use string literals unless you specifically need to use a <code>String</code> object, because <code>String</code> objects can have counterintuitive behavior. For example:</p> - -<pre class="brush: js">var s1 = "2 + 2"; //creates a string literal value -var s2 = new String("2 + 2"); //creates a String object -eval(s1); //returns the number 4 -eval(s2); //returns the string "2 + 2"</pre> - -<p>A <code>String</code> object has one property, <code>length</code>, that indicates the number of characters in the string. For example, the following code assigns <code>x</code> the value 13, because "Hello, World!" has 13 characters:</p> - -<pre class="brush: js">var mystring = "Hello, World!"; -var x = mystring.length; -</pre> - -<p>A <code>String</code> object has two types of methods: those that return a variation on the string itself, such as <code>substring</code> and <code>toUpperCase</code>, and those that return an HTML-formatted version of the string, such as <code>bold</code> and <code>link</code>.</p> - -<p>For example, using the previous example, both <code>mystring.toUpperCase()</code> and <code>"hello, world!".toUpperCase()</code> return the string "HELLO, WORLD!"</p> - -<p>The <code>substring</code> method takes two arguments and returns a subset of the string between the two arguments. Using the previous example, <code>mystring.substring(4, 9)</code> returns the string "o, Wo". See the <a href="/en-US/docs/JavaScript/Reference/Global_Objects/String/substring" title="en-US/docs/JavaScript/Reference/Global Objects/String/substring"><code>substring</code></a> method of the <code>String</code> object in the JavaScript Reference for more information.</p> - -<p>The <code>String</code> object also has a number of methods for automatic HTML formatting, such as <code>bold</code> to create boldface text and <code>link</code> to create a hyperlink. For example, you could create a hyperlink to a hypothetical URL with the <code>link</code> method as follows:</p> - -<pre class="brush: js">mystring.link("http://www.helloworld.com") -</pre> - -<p>The following table summarizes the methods of <code>String</code> objects.</p> - -<table class="fullwidth-table"> - <caption>Table 7.4 Methods of String Instances</caption> - <thead> - <tr> - <th scope="col">Method</th> - <th scope="col">Description</th> - </tr> - </thead> - <tbody> - <tr> - <td><code><a href="/en-US/docs/JavaScript/Reference/Global_Objects/String/anchor" title="en-US/docs/JavaScript/Reference/Global_Objects/String/anchor">anchor</a></code></td> - <td>Creates HTML named anchor.</td> - </tr> - <tr> - <td><code><a href="/en-US/docs/JavaScript/Reference/Global_Objects/String/big" title="en-US/docs/JavaScript/Reference/Global_Objects/String/big">big</a></code>, <code><a href="/en-US/docs/JavaScript/Reference/Global_Objects/String/blink" title="en-US/docs/JavaScript/Reference/Global_Objects/String/blink">blink</a></code>, <code><a href="/en-US/docs/JavaScript/Reference/Global_Objects/String/bold" title="en-US/docs/JavaScript/Reference/Global_Objects/String/bold">bold</a></code>, <code><a href="/en-US/docs/JavaScript/Reference/Global_Objects/String/fixed" title="en-US/docs/JavaScript/Reference/Global_Objects/String/fixed">fixed</a></code>, <code><a href="/en-US/docs/JavaScript/Reference/Global_Objects/String/italics" title="en-US/docs/JavaScript/Reference/Global_Objects/String/italics">italics</a></code>, <code><a href="/en-US/docs/JavaScript/Reference/Global_Objects/String/small" title="en-US/docs/JavaScript/Reference/Global_Objects/String/small">small</a></code>, <code><a href="/en-US/docs/JavaScript/Reference/Global_Objects/String/strike" title="en-US/docs/JavaScript/Reference/Global_Objects/String/strike">strike</a></code>, <code><a href="/en-US/docs/JavaScript/Reference/Global_Objects/String/sub" title="en-US/docs/JavaScript/Reference/Global_Objects/String/sub">sub</a></code>, <code><a href="/en-US/docs/JavaScript/Reference/Global_Objects/String/sup" title="en-US/docs/JavaScript/Reference/Global_Objects/String/sup">sup</a></code></td> - <td>Create HTML formatted string.</td> - </tr> - <tr> - <td><code><a href="/en-US/docs/JavaScript/Reference/Global_Objects/String/charAt" title="en-US/docs/JavaScript/Reference/Global_Objects/String/charAt">charAt</a></code>, <code><a href="/en-US/docs/JavaScript/Reference/Global_Objects/String/charCodeAt" title="en-US/docs/JavaScript/Reference/Global_Objects/String/charCodeAt">charCodeAt</a></code></td> - <td>Return the character or character code at the specified position in string.</td> - </tr> - <tr> - <td><code><a href="/en-US/docs/JavaScript/Reference/Global_Objects/String/indexOf" title="en-US/docs/JavaScript/Reference/Global_Objects/String/indexOf">indexOf</a></code>, <code><a href="/en-US/docs/JavaScript/Reference/Global_Objects/String/lastIndexOf" title="en-US/docs/JavaScript/Reference/Global_Objects/String/lastIndexOf">lastIndexOf</a></code></td> - <td>Return the position of specified substring in the string or last position of specified substring, respectively.</td> - </tr> - <tr> - <td><code><a href="/en-US/docs/JavaScript/Reference/Global_Objects/String/link" title="en-US/docs/JavaScript/Reference/Global_Objects/String/link">link</a></code></td> - <td>Creates HTML hyperlink.</td> - </tr> - <tr> - <td><code><a href="/en-US/docs/JavaScript/Reference/Global_Objects/String/concat" title="en-US/docs/JavaScript/Reference/Global_Objects/String/concat">concat</a></code></td> - <td>Combines the text of two strings and returns a new string.</td> - </tr> - <tr> - <td><code><a href="/en-US/docs/JavaScript/Reference/Global_Objects/String/fromCharCode" title="en-US/docs/JavaScript/Reference/Global_Objects/String/fromCharCode">fromCharCode</a></code></td> - <td>Constructs a string from the specified sequence of Unicode values. This is a method of the String class, not a String instance.</td> - </tr> - <tr> - <td><code><a href="/en-US/docs/JavaScript/Reference/Global_Objects/String/split" title="en-US/docs/JavaScript/Reference/Global_Objects/String/split">split</a></code></td> - <td>Splits a <code>String</code> object into an array of strings by separating the string into substrings.</td> - </tr> - <tr> - <td><code><a href="/en-US/docs/JavaScript/Reference/Global_Objects/String/slice" title="en-US/docs/JavaScript/Reference/Global_Objects/String/slice">slice</a></code></td> - <td>Extracts a section of an string and returns a new string.</td> - </tr> - <tr> - <td><code><a href="/en-US/docs/JavaScript/Reference/Global_Objects/String/substring" title="en-US/docs/JavaScript/Reference/Global_Objects/String/substring">substring</a></code>, <code><a href="/en-US/docs/JavaScript/Reference/Global_Objects/String/substr" title="en-US/docs/JavaScript/Reference/Global_Objects/String/substr">substr</a></code></td> - <td>Return the specified subset of the string, either by specifying the start and end indexes or the start index and a length.</td> - </tr> - <tr> - <td><code><a href="/en-US/docs/JavaScript/Reference/Global_Objects/String/match" title="en-US/docs/JavaScript/Reference/Global_Objects/String/match">match</a></code>, <code><a href="/en-US/docs/JavaScript/Reference/Global_Objects/String/replace" title="en-US/docs/JavaScript/Reference/Global_Objects/String/replace">replace</a></code>, <code><a href="/en-US/docs/JavaScript/Reference/Global_Objects/String/search" title="en-US/docs/JavaScript/Reference/Global_Objects/String/search">search</a></code></td> - <td>Work with regular expressions.</td> - </tr> - <tr> - <td><code><a href="/en-US/docs/JavaScript/Reference/Global_Objects/String/toLowerCase" title="en-US/docs/JavaScript/Reference/Global_Objects/String/toLowerCase">toLowerCase</a></code>, <code><a href="/en-US/docs/JavaScript/Reference/Global_Objects/String/toUpperCase" title="en-US/docs/JavaScript/Reference/Global_Objects/String/toUpperCase">toUpperCase</a></code></td> - <td> - <p>Return the string in all lowercase or all uppercase, respectively.</p> - </td> - </tr> - </tbody> -</table> - -<p>autoPreviousNext("JSGChapters")</p> diff --git a/files/ru/conflicting/web/javascript/guide/introduction/index.html b/files/ru/conflicting/web/javascript/guide/introduction/index.html deleted file mode 100644 index d77cb2c0ec..0000000000 --- a/files/ru/conflicting/web/javascript/guide/introduction/index.html +++ /dev/null @@ -1,160 +0,0 @@ ---- -title: Об этом учебнике -slug: conflicting/Web/JavaScript/Guide/Introduction -translation_of: Web/JavaScript/Guide/Introduction -translation_of_original: Web/JavaScript/Guide/About -original_slug: Web/JavaScript/Guide/About ---- -<p>JavaScript это кросс-платформенный, объектно-ориентированный интерпретируемый язык программирования. В этом учебнике описано все, что вам нужно знать для того, чтобы начать использовать JavaScript.</p> - -<h2 id="Особенности_разных_версий_JavaScript">Особенности разных версий JavaScript</h2> - -<p> </p> - -<ul> - <li><a class="new" href="/ru/docs/Web/JavaScript/New_in_JavaScript/1.2" rel="nofollow">/ru/docs/Web/JavaScript/New_in_JavaScript/1.2</a></li> - <li><a class="new" href="/ru/docs/Web/JavaScript/New_in_JavaScript/1.3" rel="nofollow">/ru/docs/Web/JavaScript/New_in_JavaScript/1.3</a></li> - <li><a class="new" href="/ru/docs/Web/JavaScript/New_in_JavaScript/1.4" rel="nofollow">/ru/docs/Web/JavaScript/New_in_JavaScript/1.4</a></li> - <li><a href="/ru/docs/Web/JavaScript/New_in_JavaScript/1.5">Новое в JavaScript 1.5</a></li> - <li><a href="/ru/docs/Web/JavaScript/New_in_JavaScript/1.6">Новое в JavaScript 1.6</a></li> - <li><a href="/ru/docs/Web/JavaScript/New_in_JavaScript/1.7">Новое в JavaScript 1.7</a></li> - <li><a href="/ru/docs/Web/JavaScript/New_in_JavaScript/1.8">New in JavaScript 1.8</a></li> - <li><a href="/ru/docs/Web/JavaScript/New_in_JavaScript/1.8.1">Новое в JavaScript 1.8.1</a></li> - <li><a href="/ru/docs/Web/JavaScript/New_in_JavaScript/1.8.5">Новое в JavaScript 1.8.5</a></li> -</ul> - -<p> </p> - -<h2 id="Что_вы_уже_должны_знать">Что вы уже должны знать</h2> - -<p>Этот учебник предполагает, что у вас уже имеются некоторые знания и опыт:</p> - -<p>Общее понимание, что такое Интернет и всемирная сеть WWW. Знание языка разметки гипертекста (<a href="/en/HTML" title="en/HTML">HTML</a>) также приветствуется.</p> - -<p>Некоторый опыт программирования на C или Visual Basic будет полезен, но не является обязательным.</p> - -<h2 id="Версии_JavaScript">Версии JavaScript</h2> - -<table class="standard-table"> - <caption>Таблица 1. Версии JavaScript и Navigator</caption> - <thead> - <tr> - <th scope="col">Версия JavaScript</th> - <th scope="col">Версия Navigator</th> - </tr> - </thead> - <tbody> - <tr> - <td>JavaScript 1.0</td> - <td>Navigator 2.0</td> - </tr> - <tr> - <td>JavaScript 1.1</td> - <td>Navigator 3.0</td> - </tr> - <tr> - <td>JavaScript 1.2</td> - <td>Navigator 4.0-4.05</td> - </tr> - <tr> - <td>JavaScript 1.3</td> - <td>Navigator 4.06-4.7x</td> - </tr> - <tr> - <td>JavaScript 1.4</td> - <td> </td> - </tr> - <tr> - <td>JavaScript 1.5</td> - <td>Navigator 6.0<br> - Mozilla (браузер с открытым исходным кодом)</td> - </tr> - <tr> - <td>JavaScript 1.6</td> - <td><a href="/en/Firefox_1.5_for_developers" title="en/Firefox_1.5_for_developers">Firefox 1.5</a>, другие, основанные на Mozilla 1.8 продукты</td> - </tr> - <tr> - <td>JavaScript 1.7</td> - <td><a href="/en/Firefox_2_for_developers" title="en/Firefox_2_for_developers">Firefox 2</a>, другие, основанные на Mozilla 1.8.1 продукты</td> - </tr> - <tr> - <td>JavaScript 1.8</td> - <td><a href="/en/Firefox_3_for_developers" title="en/Firefox_3_for_developers">Firefox 3</a>, другие, основанные на Mozilla 1.9 продукты</td> - </tr> - </tbody> -</table> - -<p>Каждая версия Netscape Enterprise Server также поддерживает разные версии JavaScript. Чтобы помочь вам писать скрипты совместимые с разными версиями Enterprise Server, это руководство пользуется аббревиатурой, которая однозначно идентифицирует версию сервера, в которой реализована каждая функциональность.</p> - -<p><br> - <strong style="font-style: inherit; font-weight: 700; line-height: 1.5;"> Таблица 2. Аббревиатуры версий Netscape Enterprise Server</strong></p> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Abbreviation</th> - <th scope="col">Enterprise Server version</th> - </tr> - </thead> - <tbody> - <tr> - <td>NES 2.0</td> - <td>Netscape Enterprise Server 2.0</td> - </tr> - <tr> - <td>NES 3.0</td> - <td>Netscape Enterprise Server 3.0</td> - </tr> - </tbody> -</table> - -<h2 id="Где_найти_информацию_по_JavaScript">Где найти информацию по JavaScript</h2> - -<p>Документация JavaScript включает в себя следующие материалы:</p> - -<ul> - <li><a href="/ru/JavaScript/Guide" title="en/Core_JavaScript_1.5_Guide">Учебник JavaScript</a> (тот учебник, который вы сейчас читаете) содержит информацию о языке JavaScript и его объектах.</li> - <li><a href="/en/JavaScript/Reference" title="en/JavaScript/Reference">JavaScript Reference</a> содержит справочный материал по языку JavaScript.</li> -</ul> - -<p>Если вы новичок в JavaScript, то начните с <a href="/en/JavaScript/Guide" title="en/Core_JavaScript_1.5_Guide">Учебника </a><a href="/en/JavaScript/Guide" title="en/Core_JavaScript_1.5_Guide">JavaScript</a>. Как только вы усвоили фундаментальные основы, вы можете начать пользоваться <a href="/en/JavaScript/Reference" title="en/JavaScript/Reference">Справочником JavaScript</a>, чтобы получить больше информации об определённых объектах, выражениях и операторах.</p> - -<h2 id="Советы_изучающим_JavaScript">Советы изучающим JavaScript</h2> - -<p>Начать изучать JavaScript очень легко: всё что вам нужно - это современный веб браузер. Этот учебник включает описание некоторых особенностей JavaScript, которые доступны только в самых последних версиях Firefox (и других браузерах основанных на движке Gecko), так что лучше всего воспользоваться самой последней версией Firefox.</p> - -<h3 id="Интерактивный_интерпретатор.">Интерактивный интерпретатор.</h3> - -<p>Интерактивная строка ввода JavaScript окажет бесценную услугу в изучении языка, так как позволит пробовать все вещи сразу же, вам не потребуется сохранять изменения в файле и обновлять страницу каждый раз. Консоль ошибок Firefox, доступна через меню Инструменты, предлагает простой способ попробовать выполнить JavaScript выражения: просто введите строку с кодом и нажмите кнопку "Evaluate".</p> - -<p><img alt="Image:ErrorConsole.png" class="internal" src="/@api/deki/files/192/=ErrorConsole.png"></p> - -<h3 id="Firebug">Firebug</h3> - -<p>Более продвинутое средство доступно в <a class="external" href="http://www.getfirebug.com/">Firebug</a>. Firebug это расширение Firefox. Хотя в последних версиях Firefox средства отладки становятся более совершенными и такой нужды Firebug уже нет. Выражения которые вы вводите интерпретируются как объекты и связываются c другими частями в Firebug. Например, вы можете сложить 5 плюс 5, заменить буквы в строке со строчных на прописные, получить кликабельную ссылку на документ, или получить ссылку на элемент в документе:</p> - -<p><img alt="" class="internal" src="/@api/deki/files/5188/=FirebugCommandLine.PNG" style="height: 281px; width: 728px;"></p> - -<p>Нажав на кнопке со стрелкой в нижнем правом углу вы можете открыть многострочный редактор скриптов.</p> - -<p>Firebug также имеет в составе продвинутый инспектор DOM, дебаггер JavaScript, инструменты профилирования и многие другие полезные утилиты. JavaScript код выполняемый на веб странице может вызвать функцию <code>console.log()</code>, которая выведет свой аргумент на консоль Firebug.</p> - -<p>Множество примеров в этом учебнике используют функцию <code>alert()</code>, чтобы вывести сообщение во время выполнения скрипта.</p> - -<h2 id="Принятые_соглашения_в_документе">Принятые соглашения в документе</h2> - -<p>JavaScript приложения выполняются на разных операционных системах; информация в этом учебнике актуальна в любом случае. Пути к директориям или файлам даны в формате Windows (обратный слеш как разделитель). Для версии Юникс, пути точно такие же, за исключением того, что используется обычный слеш вместо обратного, а также соответственно корневая директория начинается с '/' а не 'c:/' как это в Windows.</p> - -<p>Этот учебник использует единый локатор ресурсов (URL-ы) следующей формы:</p> - -<p><code>http://<em>server</em>.<em>domain</em>/<em>path</em>/<em>file</em>.html</code></p> - -<p>В этих URL-ах, <em>server</em> - это имя сервера на котором запущено ваше приложение, например <code>research1</code> или <code>www</code>; <em>domain</em> - это имя Internet домена, например <code>netscape.com</code> или <code>uiuc.edu</code>; <em>path</em> - структура директорий на сервере; и <em>file</em><code>.html</code> - имя файла, который расположен на вашем сервере. В общем, элементы выделенные курсивом в URL-ах это метки-заполнители, а элементы выделенные нормальным моноширинным шрифтом точные неизменные значения (например, конфигурацию сервера вы можете изменить, как и сменить доменное имя, структура каталогов может поменяться, а вот протокол всегда один, и расширение файла для веб-страниц тоже постоянно). Если ваш веб-сервер поддерживает Secure Sockets Layer (SSL), то вы можете пользоваться <code>https</code> вместо <code>http</code> в URL.</p> - -<p>Этот учебник пользуется следующим соглашением об использовании шрифтов:</p> - -<ul> - <li><code>Моноширинный шрифт </code>используется для примеров кода и их вывода, API и элементов языка (например, имена методов или имена свойств), имена файлов, имена директорий, путей, тегов HTML, и любого другого текста, который должен быть выведен на экран. (<code><em>Моноширинный курсивный шрифт</em></code> использован для меток-заменителей встроенных в код.)</li> - <li><em>Курсивное начертание </em>использовано для оглавлений, особого выделения, переменных и меток-заменителей, и слов использованных в буквальном смысле.</li> - <li><strong>Жирное начертание </strong>использовано для терминов из глоссария.</li> -</ul> diff --git a/files/ru/conflicting/web/javascript/guide/introduction_6f341ba6db4b060ccbd8dce4a0d5214b/index.html b/files/ru/conflicting/web/javascript/guide/introduction_6f341ba6db4b060ccbd8dce4a0d5214b/index.html deleted file mode 100644 index c102798643..0000000000 --- a/files/ru/conflicting/web/javascript/guide/introduction_6f341ba6db4b060ccbd8dce4a0d5214b/index.html +++ /dev/null @@ -1,143 +0,0 @@ ---- -title: Обзор JavaScript -slug: conflicting/Web/JavaScript/Guide/Introduction_6f341ba6db4b060ccbd8dce4a0d5214b -translation_of: Web/JavaScript/Guide/Introduction -translation_of_original: Web/JavaScript/Guide/JavaScript_Overview -original_slug: Web/JavaScript/Guide/JavaScript_Overview ---- -<p>Эта глава является введением в JavaScript и описывает некоторые из базовых понятий.</p> - -<h3 id="What_is_JavaScript.3F" name="What_is_JavaScript.3F">Что такое JavaScript?</h3> - -<p>JavaScript это кросс-платформенный, объектно-ориентированный, скриптовый язык. JavaScript - это маленький и легковесный язык; он спроектирован не для создания законченных, полноценных приложений, а для лёгкого встраивания в другие продукты и приложения, например, в веб браузеры. Внутри основного приложения, JavaScript может соединяться с объектами этого приложения и осуществлять программный контроль над ними.</p> - -<p>Ядро JavaScript содержит набор базовых объектов, например Array, Date и Math, и набор элементов языка: операторов, управляющих структур, и выражений. Ядро JavaScript может быть расширено для различных целей с помощью дополнений, например:</p> - -<ul> - <li><em>Client-side JavaScript</em> расширяет ядро языка предоставляя объекты управления браузером (Navigator или другой веб-браузер) и его Document Object Model (DOM). Например, клиентские расширения позволяют приложению размещать элементы в HTML-форме и реагировать на пользовательские события, такие как щелчок мыши, ввод данных в форму и навигация по страницам.</li> - <li><em>Server-side JavaScript</em> расширяет ядро языка предоставляя объекты для запуска JavaScript на сервере. Например, server-side расширения позволяют приложению соединяться с реляционной базой данных, обеспечивать непрерывность информации между вызовами приложения, или выполнять операции над файлами на сервере.</li> -</ul> - -<p>Используя функции JavaScript LiveConnect, вы можете позволить коду на Java и JavaScript общаться между собой. Вы можете создать экземпляр объекта Java из JavaScript и получить доступ к его публичным методам и свойствам. Из Java, вы можете получить доступ к объектам, свойствам и методам JavaScript.</p> - -<p>Впервые JavaScript был использован в браузерах Netscape.</p> - -<h3 id="JavaScript_and_Java" name="JavaScript_and_Java">JavaScript и Java</h3> - -<p>JavaScript и Java схожи в некоторых отношениях, но принципиально отличаются в других. Язык JavaScript напоминает Java, но не имеет статической типизации и строгой проверки типов. В основном, JavaScript следует большей части синтаксиса Java в выражениях, именованиях и основного потока управления конструкциями, что стало причиной, почему он был переименован из LiveScript в JavaScript.</p> - -<p>В отличии от системы компилированных классов в Java, построенной на объявлениях, JavaScript поддерживает систему исполнения, основанную на небольшом количестве типов данных, представляющих числовые, логические и строковые значения. JavaScript обладает моделью объектов на базе прототипов вместо более общей модели объектов на базе классов. Модель объектов на базе прототипов делает возможным динамическое наследование; то есть, то, что унаследовано, может различаться для отдельных объектов. JavaScript также поддерживает функции без каких-либо специальных декларативных требований. Функции могут быть свойствами объектов, выполняться как слабо типизированные методы.</p> - -<p>По сравнению с Java, JavaScript - это язык с очень свободной формой языка. Вам не надо объявлять переменные, классы или методы. Вы не должны беспокоиться, является ли метод public, private или protected, вам не надо реализовывать интерфейсы. Переменные, параметры и возвращаемые функциями типы не являются явно типизированными.</p> - -<p>Java - язык программирования на основе классов, предназначенный для быстрого выполнения и безопасности типов. Безопасность типов означает, например, что вы не можете взять тип Java integer и привести его к типу object reference или получить доступ к закрытой памяти изменяя байт-код Java. Ориентированная на классы модель Java означает, что программы состоят исключительно из классов и их методов. Наследование классов и строгая типизация в Java обычно требуют тесно связанную иерархию объектов. Эти требования делают программирование на Java более сложным чем на JavaScript.</p> - -<p>По духу JavaScript происходит от нескольких небольших, динамически типизированных языков программирования, таких как HyperTalk и dBASE. Эти скриптовые языки предлагают инструменты программирования для гораздо более широкой аудитории благодаря более простому синтаксису, специальной встроенной функциональности и минимальным требованиям для создания объектов.</p> - -<table class="standard-table"> - <caption>Таблица 1.1 Сравнение JavaScript и Java</caption> - <thead> - <tr> - <th scope="col">JavaScript</th> - <th scope="col">Java</th> - </tr> - </thead> - <tbody> - <tr> - <td>Объектно-ориентированный. Нет различий между типами объектов. Наследование реализовано через механизм прототипов, свойства и методы могут быть динамически добавлены к любому объекту.</td> - <td>На базе классов. Объекты делятся на классы и экземпляры с наследованием через иерархию классов. Классы и экземпляры не могут иметь динамически добавленные свойства и методы.</td> - </tr> - <tr> - <td>Типы данных переменных не объявлены (динамическая типизация).</td> - <td>Типы данных переменных должны быть объявлены (статическая типизация).</td> - </tr> - <tr> - <td>Не может автоматически записывать на жёсткий диск.</td> - <td>Может автоматически записывать на жёсткий диск.</td> - </tr> - </tbody> -</table> - -<p>Для получения дополнительной информации о различиях между JavaScript и Java, см. раздел <a href="/en/JavaScript/Guide/Details_of_the_Object_Model" title="en/JavaScript/Guide/Details of the Object Model">Details of the Object Model</a>.</p> - -<h3 id="JavaScript_and_the_ECMAScript_Specification" name="JavaScript_and_the_ECMAScript_Specification">JavaScript and the ECMAScript Specification</h3> - -<p>Netscape invented JavaScript, and JavaScript was first used in Netscape browsers. However, Netscape is working with <a class="external" href="http://www.ecma-international.org/">Ecma International</a> — the European association for standardizing information and communication systems (ECMA was formerly an acronym for the European Computer Manufacturers Association) to deliver a standardized, international programming language based on core JavaScript. This standardized version of JavaScript, called ECMAScript, behaves the same way in all applications that support the standard. Companies can use the open standard language to develop their implementation of JavaScript. The ECMAScript standard is documented in the ECMA-262 specification.</p> - -<p>The ECMA-262 standard is also approved by the <a class="external" href="http://www.iso.ch/">ISO</a> (International Organization for Standardization) as ISO-16262. You can find a <a class="external" href="http://www-archive.mozilla.org/js/language/E262-3.pdf" title="http://www-archive.mozilla.org/js/language/E262-3.pdf">PDF version of ECMA-262</a> (outdated version) at the Mozilla website. You can also find the specification on <a class="external" href="http://www.ecma-international.org/publications/standards/Ecma-262.htm">the Ecma International website</a>. The ECMAScript specification does not describe the Document Object Model (DOM), which is standardized by the <a class="external" href="http://www.w3.org/">World Wide Web Consortium (W3C)</a>. The DOM defines the way in which HTML document objects are exposed to your script.</p> - -<h4 id="Relationship_between_JavaScript_Versions_and_ECMAScript_Editions" name="Relationship_between_JavaScript_Versions_and_ECMAScript_Editions">Relationship between JavaScript Versions and ECMAScript Editions</h4> - -<p>Netscape worked closely with Ecma International to produce the ECMAScript Specification (ECMA-262). The following table describes the relationship between JavaScript versions and ECMAScript editions.</p> - -<table class="standard-table"> - <caption>Table 1.2 JavaScript versions and ECMAScript editions</caption> - <thead> - <tr> - <th scope="row">JavaScript version</th> - <th scope="col">Relationship to ECMAScript edition</th> - </tr> - </thead> - <tbody> - <tr> - <td>JavaScript 1.1</td> - <td>ECMA-262, Edition 1 is based on JavaScript 1.1.</td> - </tr> - <tr> - <td>JavaScript 1.2</td> - <td>ECMA-262 was not complete when JavaScript 1.2 was released. JavaScript 1.2 is not fully compatible with ECMA-262, Edition 1, for the following reasons: - <ul> - <li>Netscape developed additional features in JavaScript 1.2 that were not considered for ECMA-262.</li> - <li>ECMA-262 adds two new features: internationalization using Unicode, and uniform behavior across all platforms. Several features of JavaScript 1.2, such as the <code>Date</code> object, were platform-dependent and used platform-specific behavior.</li> - </ul> - </td> - </tr> - <tr> - <td> - <p>JavaScript 1.3</p> - </td> - <td> - <p>JavaScript 1.3 is fully compatible with ECMA-262, Edition 1.</p> - - <p>JavaScript 1.3 resolved the inconsistencies that JavaScript 1.2 had with ECMA-262, while keeping all the additional features of JavaScript 1.2 except == and !=, which were changed to conform with ECMA-262.</p> - </td> - </tr> - <tr> - <td> - <p>JavaScript 1.4</p> - </td> - <td> - <p>JavaScript 1.4 is fully compatible with ECMA-262, Edition 1.</p> - - <p>The third version of the ECMAScript specification was not finalized when JavaScript 1.4 was released.</p> - </td> - </tr> - <tr> - <td>JavaScript 1.5</td> - <td>JavaScript 1.5 is fully compatible with ECMA-262, Edition 3.</td> - </tr> - </tbody> -</table> - -<div class="note"><strong>Note</strong>: ECMA-262, Edition 2 consisted of minor editorial changes and bug fixes to the Edition 1 specification. The current release by the TC39 working group of Ecma International is ECMAScript Edition 5.1</div> - -<p>The <a href="/en/JavaScript/Reference" title="en/JavaScript/Reference">JavaScript Reference</a> indicates which features of the language are ECMAScript-compliant.</p> - -<p>JavaScript will always include features that are not part of the ECMAScript Specification; JavaScript is compatible with ECMAScript, while providing additional features.</p> - -<h4 id="JavaScript_Documentation_versus_the_ECMAScript_Specification" name="JavaScript_Documentation_versus_the_ECMAScript_Specification">JavaScript Documentation versus the ECMAScript Specification</h4> - -<p>The ECMAScript specification is a set of requirements for implementing ECMAScript; it is useful if you want to determine whether a JavaScript feature is supported in other ECMAScript implementations. If you plan to write JavaScript code that uses only features supported by ECMAScript, then you may need to review the ECMAScript specification.</p> - -<p>The ECMAScript document is not intended to help script programmers; use the JavaScript documentation for information on writing scripts.</p> - -<h4 id="JavaScript_and_ECMAScript_Terminology">JavaScript and ECMAScript Terminology</h4> - -<p>The ECMAScript specification uses terminology and syntax that may be unfamiliar to a JavaScript programmer. Although the description of the language may differ in ECMAScript, the language itself remains the same. JavaScript supports all functionality outlined in the ECMAScript specification.</p> - -<p>The JavaScript documentation describes aspects of the language that are appropriate for a JavaScript programmer. For example:</p> - -<ul> - <li>The Global Object is not discussed in the JavaScript documentation because you do not use it directly. The methods and properties of the Global Object, which you do use, are discussed in the JavaScript documentation but are called top-level functions and properties.</li> - <li>The no parameter (zero-argument) constructor with the <code>Number</code> and <code>String</code> objects is not discussed in the JavaScript documentation, because what is generated is of little use. A <code>Number</code> constructor without an argument returns +0, and a <code>String</code> constructor without an argument returns "" (an empty string).</li> -</ul> diff --git a/files/ru/conflicting/web/javascript/reference/global_objects/boolean/index.html b/files/ru/conflicting/web/javascript/reference/global_objects/boolean/index.html deleted file mode 100644 index 3ce22c081f..0000000000 --- a/files/ru/conflicting/web/javascript/reference/global_objects/boolean/index.html +++ /dev/null @@ -1,114 +0,0 @@ ---- -title: Boolean.prototype -slug: conflicting/Web/JavaScript/Reference/Global_Objects/Boolean -tags: - - Boolean - - JavaScript - - Property - - Prototype -translation_of: Web/JavaScript/Reference/Global_Objects/Boolean -translation_of_original: Web/JavaScript/Reference/Global_Objects/Boolean/prototype -original_slug: Web/JavaScript/Reference/Global_Objects/Boolean/prototype ---- -<div>{{JSRef("Global_Objects", "Boolean")}}</div> - -<h2 id="Summary" name="Summary">Сводка</h2> -<p>Свойство <strong><code>Boolean.prototype</code></strong> представляет прототип конструктора объекта {{jsxref("Global_Objects/Boolean", "Boolean")}}.</p> - -<div>{{js_property_attributes(0, 0, 0)}}</div> - -<h2 id="Description" name="Description">Описание</h2> -<p>Экземпляры объекта {{jsxref("Global_Objects/Boolean", "Boolean")}} наследуются от <code>Boolean.prototype</code>. Вы можете использовать прототип конструктора объекта для добавления свойств или методов ко всем экземплярам объекта {{jsxref("Global_Objects/Boolean", "Boolean")}}.</p> - -<h2 id="Properties" name="Properties">Свойства</h2> -<dl> - <dt><code>Boolean.prototype.constructor</code></dt> - <dd>Возвращает функцию, создающую экземпляр прототипа. По умолчанию, это функция {{jsxref("Global_Objects/Boolean", "Boolean")}}.</dd> -</dl> -<div>{{jsOverrides("Object", "properties", "constructor")}}</div> - -<h2 id="Methods" name="Methods">Методы</h2> -<dl> - <dt>{{jsxref("Boolean.prototype.toSource()")}} {{non-standard_inline}}</dt> - <dd>Возвращает строку, содержащую исходный код объекта {{jsxref("Global_Objects/Boolean", "Boolean")}}; вы можете использовать эту строку для создания эквивалентного объекта. Переопределяет метод {{jsxref("Object.prototype.toSource()")}}.</dd> - <dt>{{jsxref("Boolean.prototype.toString()")}}</dt> - <dd>Возвращает строку <code>"true"</code> или <code>"false"</code>, в зависимости от значения объекта. Переопределяет метод {{jsxref("Object.prototype.toString()")}}.</dd> - <dt>{{jsxref("Boolean.prototype.valueOf()")}}</dt> - <dd>Возвращает примитивное значение объекта {{jsxref("Global_Objects/Boolean", "Boolean")}}. Переопределяет метод {{jsxref("Object.prototype.valueOf()")}}.</dd> -</dl> -<div>{{jsOverrides("Object", "methods", "toSource", "toString", "valueOf")}}</div> - -<h2 id="Specifications" name="Specifications">Спецификации</h2> -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Спецификация</th> - <th scope="col">Статус</th> - <th scope="col">Комментарии</th> - </tr> - <tr> - <td>ECMAScript 1-е издание.</td> - <td>Стандарт</td> - <td>Изначальное определение. Реализована в JavaScript 1.0.</td> - </tr> - <tr> - <td>{{SpecName('ES5.1', '#sec-15.6.3.1', 'Boolean.prototype')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-boolean.prototype', 'Boolean.prototype')}}</td> - <td>{{Spec2('ES6')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Browser_compatibility" name="Browser_compatibility">Совместимость с браузерами</h2> -<div>{{CompatibilityTable}}</div> -<div id="compat-desktop"> - <table class="compat-table"> - <tbody> - <tr> - <th>Возможность</th> - <th>Chrome</th> - <th>Firefox (Gecko)</th> - <th>Internet Explorer</th> - <th>Opera</th> - <th>Safari</th> - </tr> - <tr> - <td>Базовая поддержка</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - </tr> - </tbody> - </table> -</div> -<div id="compat-mobile"> - <table class="compat-table"> - <tbody> - <tr> - <th>Возможность</th> - <th>Android</th> - <th>Chrome для Android</th> - <th>Firefox Mobile (Gecko)</th> - <th>IE Mobile</th> - <th>Opera Mobile</th> - <th>Safari Mobile</th> - </tr> - <tr> - <td>Базовая поддержка</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - </tr> - </tbody> - </table> -</div> diff --git a/files/ru/conflicting/web/javascript/reference/global_objects/date/index.html b/files/ru/conflicting/web/javascript/reference/global_objects/date/index.html deleted file mode 100644 index bb3a1eb411..0000000000 --- a/files/ru/conflicting/web/javascript/reference/global_objects/date/index.html +++ /dev/null @@ -1,230 +0,0 @@ ---- -title: Date.prototype -slug: conflicting/Web/JavaScript/Reference/Global_Objects/Date -tags: - - Date - - JavaScript - - Property - - Prototype - - Reference - - Référence(2) -translation_of: Web/JavaScript/Reference/Global_Objects/Date -translation_of_original: Web/JavaScript/Reference/Global_Objects/Date/prototype -original_slug: Web/JavaScript/Reference/Global_Objects/Date/prototype ---- -<div>{{JSRef("Global_Objects", "Date")}}</div> - -<h2 id="Summary" name="Summary">Сводка</h2> - -<p>Свойство <strong><code>Date.prototype</code></strong> представляет прототип конструктора {{jsxref("Global_Objects/Date", "Date")}}.</p> - -<div>{{js_property_attributes(0, 0, 1)}}</div> - -<h2 id="Description" name="Description">Описание</h2> - -<p>Все экземпляры {{jsxref("Global_Objects/Date", "Date")}} наследуются от <code>Date.prototype</code>. Объект прототипа конструктора {{jsxref("Global_Objects/Date", "Date")}} может быть изменён для затрагивания всех экземпляров объекта {{jsxref("Global_Objects/Date", "Date")}}.</p> - -<p>Для совместимости с вычислениями тысячелетия (другими словами, для учёта 2000 года), вы всегда должны указывать полный год; например, использовать число 1998, а не 98. Чтобы помочь вам определить полный год, JavaScript включает методы {{jsxref("Date.prototype.getFullYear()", "getFullYear()")}}, {{jsxref("Date.prototype.setFullYear()", "setFullYear()")}}, {{jsxref("Date.prototype.getUTCFullYear()", "getUTCFullYear()")}} и {{jsxref("Date.prototype.setUTCFullYear()", "setUTCFullYear()")}}.</p> - -<h2 id="Properties" name="Properties">Свойства</h2> - -<dl> - <dt><code>Date.prototype.constructor</code></dt> - <dd>Возвращает функцию, создавшую этот экземпляр объекта. По умолчанию ей является объект {{jsxref("Global_Objects/Date", "Date")}}.</dd> -</dl> - -<div>{{jsOverrides("Object", "properties", "constructor")}}</div> - -<h2 id="Methods" name="Methods">Методы</h2> - -<h3 id="Getter" name="Getter">Получения значения</h3> - -<dl> - <dt>{{jsxref("Date.prototype.getDate()")}}</dt> - <dd>Возвращает день месяца (1-31) указанной даты по местному времени.</dd> - <dt>{{jsxref("Date.prototype.getDay()")}}</dt> - <dd>Возвращает день недели (0-6) указанной даты по местному времени.</dd> - <dt>{{jsxref("Date.prototype.getFullYear()")}}</dt> - <dd>Возвращает год (4 цифры для 4-х значного года) указанной даты по местному времени.</dd> - <dt>{{jsxref("Date.prototype.getHours()")}}</dt> - <dd>Возвращает часы (0-23) указанной даты по местному времени.</dd> - <dt>{{jsxref("Date.prototype.getMilliseconds()")}}</dt> - <dd>Возвращает миллисекунды (0-999) указанной даты по местному времени.</dd> - <dt>{{jsxref("Date.prototype.getMinutes()")}}</dt> - <dd>Возвращает минуты (0-59) указанной даты по местному времени.</dd> - <dt>{{jsxref("Date.prototype.getMonth()")}}</dt> - <dd>Возвращает месяц (0-11) указанной даты по местному времени.</dd> - <dt>{{jsxref("Date.prototype.getSeconds()")}}</dt> - <dd>Возвращает секунды (0-59) указанной даты по местному времени.</dd> - <dt>{{jsxref("Date.prototype.getTime()")}}</dt> - <dd>Возвращает числовое значение указанной даты как количество миллисекунд, прошедших с 1 января 1970 года 00:00:00 по UTC (отрицательное значение для даты до этого момента).</dd> - <dt>{{jsxref("Date.prototype.getTimezoneOffset()")}}</dt> - <dd>Возвращает смещение часового пояса в минутах для текущей локали.</dd> - <dt>{{jsxref("Date.prototype.getUTCDate()")}}</dt> - <dd>Возвращает день месяца (1-31) указанной даты по всемирному координированному времени.</dd> - <dt>{{jsxref("Date.prototype.getUTCDay()")}}</dt> - <dd>Возвращает день недели (0-6) указанной даты по всемирному координированному времени.</dd> - <dt>{{jsxref("Date.prototype.getUTCFullYear()")}}</dt> - <dd>Возвращает год (4 цифры для 4-х значного года) указанной даты по всемирному координированному времени.</dd> - <dt>{{jsxref("Date.prototype.getUTCHours()")}}</dt> - <dd>Возвращает часы (0-23) указанной даты по всемирному координированному времени.</dd> - <dt>{{jsxref("Date.prototype.getUTCMilliseconds()")}}</dt> - <dd>Возвращает миллисекунды (0-999) указанной даты по всемирному координированному времени.</dd> - <dt>{{jsxref("Date.prototype.getUTCMinutes()")}}</dt> - <dd>Возвращает минуты (0-59) указанной даты по всемирному координированному времени.</dd> - <dt>{{jsxref("Date.prototype.getUTCMonth()")}}</dt> - <dd>Возвращает месяц (0-11) указанной даты по всемирному координированному времени.</dd> - <dt>{{jsxref("Date.prototype.getUTCSeconds()")}}</dt> - <dd>Возвращает секунды (0-59) указанной даты по всемирному координированному времени.</dd> - <dt>{{jsxref("Date.prototype.getYear()")}} {{deprecated_inline}}</dt> - <dd>Возвращает год (обычно 2-3 цифры) указанной даты по всемирному координированному времени. Вместо него используйте метод {{jsxref("Date.prototype.getFullYear()", "getFullYear()")}}.</dd> -</dl> - -<h3 id="Setter" name="Setter">Установки значения</h3> - -<dl> - <dt>{{jsxref("Date.prototype.setDate()")}}</dt> - <dd>Устанавливает день месяца указанной даты по местному времени.</dd> - <dt>{{jsxref("Date.prototype.setFullYear()")}}</dt> - <dd>Устанавливает полный год (4 цифры для 4-х значного года) указанной даты по местному времени.</dd> - <dt>{{jsxref("Date.prototype.setHours()")}}</dt> - <dd>Устанавливает часы указанной даты по местному времени.</dd> - <dt>{{jsxref("Date.prototype.setMilliseconds()")}}</dt> - <dd>Устанавливает миллисекунды указанной даты по местному времени.</dd> - <dt>{{jsxref("Date.prototype.setMinutes()")}}</dt> - <dd>Устанавливает минуты указанной даты по местному времени.</dd> - <dt>{{jsxref("Date.prototype.setMonth()")}}</dt> - <dd>Устанавливает месяц указанной даты по местному времени.</dd> - <dt>{{jsxref("Date.prototype.setSeconds()")}}</dt> - <dd>Устанавливает секунды указанной даты по местному времени.</dd> - <dt>{{jsxref("Date.prototype.setTime()")}}</dt> - <dd>Устанавливает объект {{jsxref("Global_Objects/Date", "Date")}} во время, представляемое количеством миллисекунд, прошедших с 1 января 1970 года 00:00:00 по UTC (отрицательное значение устанавливает даты до этого момента).</dd> - <dt>{{jsxref("Date.prototype.setUTCDate()")}}</dt> - <dd>Устанавливает день месяца указанной даты по всемирному координированному времени.</dd> - <dt>{{jsxref("Date.prototype.setUTCFullYear()")}}</dt> - <dd>Устанавливает полный год (4 цифры для 4-х значного года) указанной даты по всемирному координированному времени.</dd> - <dt>{{jsxref("Date.prototype.setUTCHours()")}}</dt> - <dd>Устанавливает часы указанной даты по всемирному координированному времени.</dd> - <dt>{{jsxref("Date.prototype.setUTCMilliseconds()")}}</dt> - <dd>Устанавливает миллисекунды указанной даты по всемирному координированному времени.</dd> - <dt>{{jsxref("Date.prototype.setUTCMinutes()")}}</dt> - <dd>Устанавливает минуты указанной даты по всемирному координированному времени.</dd> - <dt>{{jsxref("Date.prototype.setUTCMonth()")}}</dt> - <dd>Устанавливает месяц указанной даты по всемирному координированному времени.</dd> - <dt>{{jsxref("Date.prototype.setUTCSeconds()")}}</dt> - <dd>Устанавливает секунды указанной даты по всемирному координированному времени.</dd> - <dt>{{jsxref("Date.prototype.setYear()")}} {{deprecated_inline}}</dt> - <dd>Устанавливает год (обычно 2-3 цифры) указанной даты по всемирному координированному времени. Вместо него используйте метод {{jsxref("Date.prototype.setFullYear()", "setFullYear()")}}.</dd> -</dl> - -<h3 id="Conversion_getter" name="Conversion_getter">Получения преобразованного значения</h3> - -<dl> - <dt>{{jsxref("Date.prototype.toDateString()")}}</dt> - <dd>Возвращает часть, содержащую только дату объекта {{jsxref("Global_Objects/Date", "Date")}} в качестве человеко-читаемой строки.</dd> - <dt>{{jsxref("Date.prototype.toISOString()")}}</dt> - <dd>Преобразует дату в строку, следуя расширенному формату ISO 8601.</dd> - <dt>{{jsxref("Date.prototype.toJSON()")}}</dt> - <dd>Возвращает строку, представляющую объект {{jsxref("Global_Objects/Date", "Date")}}, используя метод {{jsxref("Date.prototype.toISOString()", "toISOString()")}}. Предназначен для использования методом {{jsxref("JSON.stringify()")}}.</dd> - <dt>{{jsxref("Date.prototype.toGMTString()")}} {{deprecated_inline}}</dt> - <dd>Возвращает строку, представляющую объект {{jsxref("Global_Objects/Date", "Date")}}, на основе часового пояса GMT (всемирное время). Вместо него используйте метод {{jsxref("Date.prototype.toUTCString()", "toUTCString()")}}.</dd> - <dt>{{jsxref("Date.prototype.toLocaleDateString()")}}</dt> - <dd>Возвращает строку с датой, чьё представление зависит от системных настроек локали.</dd> - <dt>{{jsxref("Date.prototype.toLocaleFormat()")}} {{non-standard_inline}}</dt> - <dd>Преобразует дату в строку, используя строку форматирования.</dd> - <dt>{{jsxref("Date.prototype.toLocaleString()")}}</dt> - <dd>Возвращает строку, чьё представление зависит от настроек локали. Переопределяет метод {{jsxref("Object.prototype.toLocaleString()")}}.</dd> - <dt>{{jsxref("Date.prototype.toLocaleTimeString()")}}</dt> - <dd>Возвращает строку со временем, чьё представление зависит от системных настроек локали.</dd> - <dt>{{jsxref("Date.prototype.toSource()")}} {{non-standard_inline}}</dt> - <dd>Возвращает строковое представление исходного кода эквивалентного объекта {{jsxref("Global_Objects/Date", "Date")}}; вы можете использовать это значение для создания нового объекта. Переопределяет метод {{jsxref("Object.prototype.toSource()")}}.</dd> - <dt>{{jsxref("Date.prototype.toString()")}}</dt> - <dd>Возвращает строковое представление указанного объекта {{jsxref("Global_Objects/Date", "Date")}}. Переопределяет метод {{jsxref("Object.prototype.toString()")}}.</dd> - <dt>{{jsxref("Date.prototype.toTimeString()")}}</dt> - <dd>Возвращает часть, содержащую только время объекта {{jsxref("Global_Objects/Date", "Date")}} в качестве человеко-читаемой строки.</dd> - <dt>{{jsxref("Date.prototype.toUTCString()")}}</dt> - <dd>Преобразует дату в строку, используя часовой пояс UTC.</dd> - <dt>{{jsxref("Date.prototype.valueOf()")}}</dt> - <dd>Возвращает примитивное значение объекта {{jsxref("Global_Objects/Date", "Date")}}. Переопределяет метод {{jsxref("Object.prototype.valueOf()")}}.</dd> -</dl> - -<div>{{jsOverrides("Object", "methods", "getDate", "getDay", "getFullYear", "getHours", "getMilliseconds", "getMinutes", "getMonth", "getSeconds", "getTime", "getTimezoneOffset", "getUTCDate", "getUTCDay", "getUTCFullYear", "getUTCHours", "getUTCMilliseconds", "getUTCMinutes", "getUTCMonth", "getUTCSeconds", "getYear", "setdate", "setFullYear", "setHours", "setMilliseconds", "setMinutes", "setMontth", "setSeconds", "setTime", "setUTCDate", "setUTCFullYear", "setUTCHours", "setUTCMilliseconds", "setUTCMinutes", "setUTCMonth", "setUTCSeconds", "setYear", "toDateString", "toGMTString", "toLocaleDateString", "toLocaleFormat", "toLocaleString", "toLocaleTimeString", "toSource", "toString", "toTimeString", "toUTCString", "valueOf")}}</div> - -<h2 id="Specifications" name="Specifications">Спецификации</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Спецификация</th> - <th scope="col">Статус</th> - <th scope="col">Комментарии</th> - </tr> - <tr> - <td>ECMAScript 1-е издание.</td> - <td>Стандарт</td> - <td>Изначальное определение. Реализована в JavaScript 1.1.</td> - </tr> - <tr> - <td>{{SpecName('ES5.1', '#sec-15.9.5', 'Date.prototype')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td></td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-properties-of-the-date-prototype-object', 'Date.prototype')}}</td> - <td>{{Spec2('ES6')}}</td> - <td></td> - </tr> - </tbody> -</table> - -<h2 id="Browser_compatibility" name="Browser_compatibility">Совместимость с браузерами</h2> - -<div>{{CompatibilityTable}}</div> - -<div id="compat-desktop"> -<table class="compat-table"> - <tbody> - <tr> - <th>Возможность</th> - <th>Chrome</th> - <th>Firefox (Gecko)</th> - <th>Internet Explorer</th> - <th>Opera</th> - <th>Safari</th> - </tr> - <tr> - <td>Базовая поддержка</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - </tr> - </tbody> -</table> -</div> - -<div id="compat-mobile"> -<table class="compat-table"> - <tbody> - <tr> - <th>Возможность</th> - <th>Android</th> - <th>Chrome для Android</th> - <th>Firefox Mobile (Gecko)</th> - <th>IE Mobile</th> - <th>Opera Mobile</th> - <th>Safari Mobile</th> - </tr> - <tr> - <td>Базовая поддержка</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - </tr> - </tbody> -</table> -</div> diff --git a/files/ru/conflicting/web/javascript/reference/global_objects/error/index.html b/files/ru/conflicting/web/javascript/reference/global_objects/error/index.html deleted file mode 100644 index d92653c075..0000000000 --- a/files/ru/conflicting/web/javascript/reference/global_objects/error/index.html +++ /dev/null @@ -1,156 +0,0 @@ ---- -title: Error.prototype -slug: conflicting/Web/JavaScript/Reference/Global_Objects/Error -tags: - - Error - - JavaScript - - Property -translation_of: Web/JavaScript/Reference/Global_Objects/Error -translation_of_original: Web/JavaScript/Reference/Global_Objects/Error/prototype -original_slug: Web/JavaScript/Reference/Global_Objects/Error/prototype ---- -<div>{{JSRef("Global_Objects", "Error", "EvalError,InternalError,RangeError,ReferenceError,SyntaxError,TypeError,URIError")}}</div> - -<h2 id="Summary" name="Summary">Сводка</h2> - -<p>Свойство <code><strong>Error.prototype</strong></code> представляет прототип конструктора объекта {{jsxref("Global_Objects/Error", "Error")}}.</p> - -<div>{{js_property_attributes(0, 0, 0)}}</div> - -<h2 id="Description" name="Description">Описание</h2> - -<p>Все экземпляры {{jsxref("Global_Objects/Error", "Error")}} и экземпляры {{jsxref("Global_Objects/Error", "неуниверсальных ошибок", "#Error_types", 1)}} наследуются от <code>Error.prototype</code>. Как и со всеми функциями-конструкторами, вы можете использовать прототип конструктора для добавления свойств и методов ко всем экземплярам, создаваемым этим конструктором.</p> - -<h2 id="Properties" name="Properties">Свойства</h2> - -<h3 id="Standard_properties" name="Standard_properties">Стандартные свойства</h3> - -<dl> - <dt><code>Error.prototype.constructor</code></dt> - <dd>Определяет функцию, создающую прототип экземпляра ошибки.</dd> - <dt>{{jsxref("Error.prototype.message")}}</dt> - <dd>Сообщение ошибки.</dd> - <dt>{{jsxref("Error.prototype.name")}}</dt> - <dd>Название ошибки.</dd> -</dl> - -<h3 id="Vendor-specific_extensions" name="Vendor-specific_extensions">Расширения вендоров</h3> - -<div>{{non-standard_header}}</div> - -<h4 id="Microsoft" name="Microsoft">Microsoft</h4> - -<dl> - <dt>{{jsxref("Error.prototype.description")}}</dt> - <dd>Описание ошибки. Аналогично свойству {{jsxref("Error.prototype.message", "message")}}.</dd> - <dt>{{jsxref("Error.prototype.number")}}</dt> - <dd>Номер ошибки.</dd> -</dl> - -<h4 id="Mozilla" name="Mozilla">Mozilla</h4> - -<dl> - <dt>{{jsxref("Error.prototype.fileName")}}</dt> - <dd>Путь к файлу, в котором возникла эта ошибка.</dd> - <dt>{{jsxref("Error.prototype.lineNumber")}}</dt> - <dd>Номер строки в файле, в котором возникла эта ошибка.</dd> - <dt>{{jsxref("Error.prototype.columnNumber")}}</dt> - <dd>Номер колонки в строке, на которой возникла эта ошибка.</dd> - <dt>{{jsxref("Error.prototype.stack")}}</dt> - <dd>Стек вызовов.</dd> -</dl> - -<h2 id="Methods" name="Methods">Методы</h2> - -<dl> - <dt>{{jsxref("Error.prototype.toSource()")}} {{non-standard_inline}}</dt> - <dd>Возвращает строку, содержащую исходный код указанного объекта {{jsxref("Global_Objects/Error", "Error")}}; вы можете использовать это значение для создания нового объекта. Переопределяет метод {{jsxref("Object.prototype.toSource()")}}.</dd> - <dt>{{jsxref("Error.prototype.toString()")}}</dt> - <dd>Возвращает строку, представляющую указанный объект. Переопределяет метод {{jsxref("Object.prototype.toString()")}}.</dd> -</dl> - -<h2 id="Specifications" name="Specifications">Спецификации</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Спецификация</th> - <th scope="col">Статус</th> - <th scope="col">Комментарии</th> - </tr> - <tr> - <td>ECMAScript 1-е издание.</td> - <td>Стандарт</td> - <td>Изначальное определение. Реализована в JavaScript 1.1.</td> - </tr> - <tr> - <td>{{SpecName('ES5.1', '#sec-15.11.3.1', 'Error')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-error.prototype', 'Error')}}</td> - <td>{{Spec2('ES6')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Browser_compatibility" name="Browser_compatibility">Совместимость с браузерами</h2> - -<div>{{CompatibilityTable}}</div> - -<div id="compat-desktop"> -<table class="compat-table"> - <tbody> - <tr> - <th>Возможность</th> - <th>Chrome</th> - <th>Firefox (Gecko)</th> - <th>Internet Explorer</th> - <th>Opera</th> - <th>Safari</th> - </tr> - <tr> - <td>Базовая поддержка</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - </tr> - </tbody> -</table> -</div> - -<div id="compat-mobile"> -<table class="compat-table"> - <tbody> - <tr> - <th>Возможность</th> - <th>Android</th> - <th>Chrome для Android</th> - <th>Firefox Mobile (Gecko)</th> - <th>IE Mobile</th> - <th>Opera Mobile</th> - <th>Safari Mobile</th> - </tr> - <tr> - <td>Базовая поддержка</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - </tr> - </tbody> -</table> -</div> - -<h2 id="See_also" name="See_also">Смотрите также</h2> - -<ul> - <li>{{jsxref("Error")}}</li> - <li>{{jsxref("Object.prototype")}}</li> -</ul> diff --git a/files/ru/conflicting/web/javascript/reference/global_objects/evalerror/index.html b/files/ru/conflicting/web/javascript/reference/global_objects/evalerror/index.html deleted file mode 100644 index 94204588e2..0000000000 --- a/files/ru/conflicting/web/javascript/reference/global_objects/evalerror/index.html +++ /dev/null @@ -1,123 +0,0 @@ ---- -title: EvalError.prototype -slug: conflicting/Web/JavaScript/Reference/Global_Objects/EvalError -tags: - - Error - - EvalError - - JavaScript - - Property -translation_of: Web/JavaScript/Reference/Global_Objects/EvalError -translation_of_original: Web/JavaScript/Reference/Global_Objects/EvalError/prototype -original_slug: Web/JavaScript/Reference/Global_Objects/EvalError/prototype ---- -<div>{{JSRef("Global_Objects", "Error", "EvalError,InternalError,RangeError,ReferenceError,SyntaxError,TypeError,URIError")}}</div> - -<h2 id="Summary" name="Summary">Сводка</h2> -<p>Свойство <code><strong>EvalError.prototype</strong></code> представляет прототип конструктора объекта {{jsxref("EvalError")}}.</p> - -<div>{{js_property_attributes(0, 0, 0)}}</div> - -<h2 id="Description" name="Description">Описание</h2> -<p>Все экземпляры {{jsxref("EvalError")}} наследуются от объекта <code>EvalError.prototype</code>. Вы можете использовать прототип для добавления свойств или методов ко всем экземплярам.</p> - -<h2 id="Properties" name="Properties">Свойства</h2> -<dl> - <dt><code>EvalError.prototype.constructor</code></dt> - <dd>Определяет функцию, создающую прототип экземпляра.</dd> - <dt>{{jsxref("Error.prototype.message", "EvalError.prototype.message")}}</dt> - <dd>Сообщение ошибки. Хотя стандарт ECMA-262 определяет, что {{jsxref("EvalError")}} должен предоставлять своё собственное свойство <code>message</code>, в <a href="/ru/docs/Mozilla/Projects/SpiderMonkey">SpiderMonkey</a> он наследует свойство {{jsxref("Error.prototype.message")}}.</dd> - <dt>{{jsxref("Error.prototype.name", "EvalError.prototype.name")}}</dt> - <dd>Название ошибки. Унаследовано от {{jsxref("Error")}}.</dd> - <dt>{{jsxref("Error.prototype.fileName", "EvalError.prototype.fileName")}}</dt> - <dd>Путь к файлу, в котором возникла эта ошибка. Унаследовано от {{jsxref("Error")}}.</dd> - <dt>{{jsxref("Error.prototype.lineNumber", "EvalError.prototype.lineNumber")}}</dt> - <dd>Номер строки в файле, в котором возникла эта ошибка. Унаследовано от {{jsxref("Error")}}.</dd> - <dt>{{jsxref("Error.prototype.columnNumber", "EvalError.prototype.columnNumber")}}</dt> - <dd>Номер колонки в строке, на которой возникла эта ошибка. Унаследовано от {{jsxref("Error")}}.</dd> - <dt>{{jsxref("Error.prototype.stack", "EvalError.prototype.stack")}}</dt> - <dd>Стек вызовов. Унаследовано от {{jsxref("Error")}}.</dd> -</dl> - -<h2 id="Methods" name="Methods">Методы</h2> -<p>Хотя объект прототипа {{jsxref("EvalError")}} не содержит собственных методов, экземпляры {{jsxref("EvalError")}} наследуют некоторые методы из цепочки прототипов.</p> - -<h2 id="Specifications" name="Specifications">Спецификации</h2> -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Спецификация</th> - <th scope="col">Статус</th> - <th scope="col">Комментарии</th> - </tr> - <tr> - <td>ECMAScript 3-е издание.</td> - <td>Стандарт</td> - <td>Изначальное определение.</td> - </tr> - <tr> - <td>{{SpecName('ES5.1', '#sec-15.11.7.6', 'NativeError.prototype')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td>Определено как <code><em>NativeError</em>.prototype</code>.</td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-nativeerror.prototype', 'NativeError.prototype')}}</td> - <td>{{Spec2('ES6')}}</td> - <td>Определено как <code><em>NativeError</em>.prototype</code>.</td> - </tr> - </tbody> -</table> - -<h2 id="Browser_compatibility" name="Browser_compatibility">Совместимость с браузерами</h2> -<div>{{CompatibilityTable}}</div> -<div id="compat-desktop"> - <table class="compat-table"> - <tbody> - <tr> - <th>Возможность</th> - <th>Chrome</th> - <th>Firefox (Gecko)</th> - <th>Internet Explorer</th> - <th>Opera</th> - <th>Safari</th> - </tr> - <tr> - <td>Базовая поддержка</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - </tr> - </tbody> - </table> -</div> -<div id="compat-mobile"> - <table class="compat-table"> - <tbody> - <tr> - <th>Возможность</th> - <th>Android</th> - <th>Chrome для Android</th> - <th>Firefox Mobile (Gecko)</th> - <th>IE Mobile</th> - <th>Opera Mobile</th> - <th>Safari Mobile</th> - </tr> - <tr> - <td>Базовая поддержка</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - </tr> - </tbody> - </table> -</div> - -<h2 id="See_also" name="See_also">Смотрите также</h2> -<ul> - <li>{{jsxref("Error.prototype")}}</li> - <li>{{jsxref("Function.prototype")}}</li> -</ul> diff --git a/files/ru/conflicting/web/javascript/reference/global_objects/function/index.html b/files/ru/conflicting/web/javascript/reference/global_objects/function/index.html deleted file mode 100644 index 40db9c03d2..0000000000 --- a/files/ru/conflicting/web/javascript/reference/global_objects/function/index.html +++ /dev/null @@ -1,153 +0,0 @@ ---- -title: Function.prototype -slug: conflicting/Web/JavaScript/Reference/Global_Objects/Function -tags: - - Function - - JavaScript - - Property - - Prototype - - Reference - - Référence(2) -translation_of: Web/JavaScript/Reference/Global_Objects/Function -translation_of_original: Web/JavaScript/Reference/Global_Objects/Function/prototype -original_slug: Web/JavaScript/Reference/Global_Objects/Function/prototype ---- -<div>{{JSRef("Global_Objects", "Function")}}</div> - -<h2 id="Summary" name="Summary">Сводка</h2> - -<p>Свойство <code><strong>Function.prototype</strong></code> представляет прототип объекта {{jsxref("Global_Objects/Function", "Function")}}.</p> - -<h2 id="Description" name="Description">Описание</h2> - -<p>Объекты {{jsxref("Global_Objects/Function", "Function")}} наследуются от <code>Function.prototype</code>. Объект <code>Function.prototype</code> не может быть изменён.</p> - -<h2 id="Properties" name="Properties">Свойства</h2> - -<dl> - <dt>{{jsxref("Function.arguments")}} {{deprecated_inline}}</dt> - <dd>Массив, соответствующий аргументам, переданным в функцию. Это устаревшее свойство {{jsxref("Global_Objects/Function", "Function")}}, используйте вместо него объект {{jsxref("Functions_and_function_scope/arguments", "arguments")}}, доступный внутри функции.</dd> - <dt><s class="obsoleteElement">{{jsxref("Function.arity")}} {{obsolete_inline}}</s></dt> - <dd><s class="obsoleteElement">Использовалось для определения количества аргументов, ожидаемых функцией, но было удалено. Вместо него используйте свойство {{jsxref("Function.length", "length")}}.</s></dd> - <dt>{{jsxref("Function.caller")}} {{non-standard_inline}}</dt> - <dd>Определяет функцию, вызвавшую текущую выполняющуюся функцию.</dd> - <dt>{{jsxref("Function.length")}}</dt> - <dd>Определяет количество аргументов, ожидаемых функцией.</dd> - <dt>{{jsxref("Function.name")}} {{non-standard_inline}}</dt> - <dd>Имя функции.</dd> - <dt>{{jsxref("Function.displayName")}} {{non-standard_inline}}</dt> - <dd>Отображаемое имя функции.</dd> - <dt><code>Function.prototype.constructor</code></dt> - <dd>Определяет функцию, создающую прототип объекта. Смотрите документацию по {{jsxref("Object.prototype.constructor")}}.</dd> -</dl> - -<h2 id="Methods" name="Methods">Методы</h2> - -<dl> - <dt>{{jsxref("Function.prototype.apply()")}}</dt> - <dd>Вызывает функцию и устанавливает <strong><code>this </code></strong>в контекст предоставленного значения; аргументы передаются объектом {{jsxref("Global_Objects/Array", "Array")}}.</dd> - <dt>{{jsxref("Function.prototype.bind()")}}</dt> - <dd>Создаёт новую функцию, которая, при вызове, самостоятельно вызывает эту функцию в контексте предоставленного значения, с данной последовательностью аргументов, предшествующих любым аргументам, переданным в новую функцию при её вызове. Устанавливает <strong><code>this </code></strong>в контекст предоставленного значения.</dd> - <dt>{{jsxref("Function.prototype.call()")}}</dt> - <dd>Вызывает (выполняет) функцию и устанавливает <strong><code>this </code></strong>в контекст предоставленного значения; аргументы передаются как есть.</dd> - <dt>{{jsxref("Function.prototype.isGenerator()")}} {{non-standard_inline}}</dt> - <dd>Возвращает <code>true</code>, если функция является <a href="/ru/docs/Web/JavaScript/Guide/Iterators_and_Generators">генератором</a>; в противном случае возвращает <code>false</code>.</dd> - <dt>{{jsxref("Function.prototype.toSource()")}} {{non-standard_inline}}</dt> - <dd>Возвращает строку, представляющую исходный код функции. Переопределяет метод {{jsxref("Object.prototype.toSource")}}.</dd> - <dt>{{jsxref("Function.prototype.toString()")}}</dt> - <dd>Возвращает строку, представляющую исходный код функции. Переопределяет метод {{jsxref("Object.prototype.toString")}}.</dd> -</dl> - -<h2 id="Specifications" name="Specifications">Спецификации</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Спецификация</th> - <th scope="col">Статус</th> - <th scope="col">Комментарии</th> - </tr> - <tr> - <td>{{SpecName('ES1')}}</td> - <td>{{Spec2('ES1')}}</td> - <td>Изначальное определение. Реализована в JavaScript 1.1.</td> - </tr> - <tr> - <td>{{SpecName('ES5.1', '#sec-15.3.3.1', 'Function.prototype')}}<br> - Для экземпляров объекта {{jsxref("Global_Objects/Function", "Function")}}:<br> - {{SpecName('ES5.1', '#sec-15.3.5.2', 'Function.prototype')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-function.prototype', 'Function.prototype')}}<br> - Для экземпляров объекта {{jsxref("Global_Objects/Function", "Function")}}:<br> - {{SpecName('ES6', '#sec-function-instances-prototype', 'Function.prototype')}}</td> - <td>{{Spec2('ES6')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-function-instances-prototype', 'Function.prototype')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Browser_compatibility" name="Browser_compatibility">Совместимость с браузерами</h2> - -<div>{{CompatibilityTable}}</div> - -<div id="compat-desktop"> -<table class="compat-table"> - <tbody> - <tr> - <th>Возможность</th> - <th>Chrome</th> - <th>Firefox (Gecko)</th> - <th>Internet Explorer</th> - <th>Opera</th> - <th>Safari</th> - </tr> - <tr> - <td>Базовая поддержка</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - </tr> - </tbody> -</table> -</div> - -<div id="compat-mobile"> -<table class="compat-table"> - <tbody> - <tr> - <th>Возможность</th> - <th>Android</th> - <th>Chrome для Android</th> - <th>Firefox Mobile (Gecko)</th> - <th>IE Mobile</th> - <th>Opera Mobile</th> - <th>Safari Mobile</th> - </tr> - <tr> - <td>Базовая поддержка</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - </tr> - </tbody> -</table> -</div> - -<h2 id="See_also" name="See_also">Смотрите также</h2> - -<ul> - <li>{{jsxref("Global_Objects/Function", "Function")}}</li> -</ul> diff --git a/files/ru/conflicting/web/javascript/reference/global_objects/generatorfunction/index.html b/files/ru/conflicting/web/javascript/reference/global_objects/generatorfunction/index.html deleted file mode 100644 index 7821c0d48c..0000000000 --- a/files/ru/conflicting/web/javascript/reference/global_objects/generatorfunction/index.html +++ /dev/null @@ -1,60 +0,0 @@ ---- -title: GeneratorFunction.prototype -slug: conflicting/Web/JavaScript/Reference/Global_Objects/GeneratorFunction -translation_of: Web/JavaScript/Reference/Global_Objects/GeneratorFunction -translation_of_original: Web/JavaScript/Reference/Global_Objects/GeneratorFunction/prototype -original_slug: Web/JavaScript/Reference/Global_Objects/GeneratorFunction/prototype ---- -<div>{{JSRef}}</div> - -<p>Свойство <code><strong>GeneratorFunction.prototype</strong></code> представляет собой прототип объекта {{jsxref("GeneratorFunction")}} .</p> - -<h2 id="Описание">Описание</h2> - -<p>Объект {{jsxref("GeneratorFunction")}} наследуется из <code>GeneratorFunction.prototype</code>. <code>GeneratorFunction.prototype</code> не может быть изменён.</p> - -<h2 id="Свойства">Свойства</h2> - -<dl> - <dt><code><strong>GeneratorFunction.constructor</strong></code></dt> - <dd>Изначальное значение {{jsxref("GeneratorFunction")}}.</dd> - <dt><code><strong>GeneratorFunction.prototype.prototype</strong></code></dt> - <dd>Значение <code>%GeneratorPrototype%</code>.</dd> -</dl> - -<h2 id="Спецификации">Спецификации</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Спецификация</th> - <th scope="col">Статус</th> - <th scope="col">Комментарий</th> - </tr> - <tr> - <td>{{SpecName('ES2015', '#sec-generatorfunction.prototype', 'GeneratorFunction.prototype')}}</td> - <td>{{Spec2('ES2015')}}</td> - <td>Изначальное определение.</td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-generatorfunction.prototype', 'GeneratorFunction.prototype')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td></td> - </tr> - </tbody> -</table> - -<h2 id="Совместимость_с_браузерами">Совместимость с браузерами</h2> - -<div> - - -<p>{{Compat("javascript.builtins.GeneratorFunction.prototype")}}</p> -</div> - -<h2 id="Смотрите_также">Смотрите также</h2> - -<ul> - <li>{{jsxref("GeneratorFunction")}}</li> - <li>{{jsxref("Function")}}</li> -</ul> diff --git a/files/ru/conflicting/web/javascript/reference/global_objects/internalerror/index.html b/files/ru/conflicting/web/javascript/reference/global_objects/internalerror/index.html deleted file mode 100644 index 0aa65612d3..0000000000 --- a/files/ru/conflicting/web/javascript/reference/global_objects/internalerror/index.html +++ /dev/null @@ -1,101 +0,0 @@ ---- -title: InternalError.prototype -slug: conflicting/Web/JavaScript/Reference/Global_Objects/InternalError -tags: - - Error - - InternalError - - JavaScript - - Non-standard - - Property -translation_of: Web/JavaScript/Reference/Global_Objects/InternalError -translation_of_original: Web/JavaScript/Reference/Global_Objects/InternalError/prototype -original_slug: Web/JavaScript/Reference/Global_Objects/InternalError/prototype ---- -<div>{{JSRef("Global_Objects", "Error", "EvalError,InternalError,RangeError,ReferenceError,SyntaxError,TypeError,URIError")}} {{non-standard_header}}</div> - -<h2 id="Summary" name="Summary">Сводка</h2> -<p>Свойство <code><strong>InternalError.prototype</strong></code> представляет прототип конструктора объекта {{jsxref("InternalError")}}.</p> - -<div>{{js_property_attributes(0, 0, 0)}}</div> - -<h2 id="Description" name="Description">Описание</h2> -<p>Все экземпляры {{jsxref("InternalError")}} наследуются от объекта <code>InternalError.prototype</code>. Вы можете использовать прототип для добавления свойств или методов ко всем экземплярам.</p> - -<h2 id="Properties" name="Properties">Свойства</h2> -<dl> - <dt><code>InternalError.prototype.constructor</code></dt> - <dd>Определяет функцию, создающую прототип экземпляра.</dd> - <dt>{{jsxref("Error.prototype.message", "InternalError.prototype.message")}}</dt> - <dd>Сообщение ошибки. Унаследовано от {{jsxref("Error")}}.</dd> - <dt>{{jsxref("Error.prototype.name", "InternalError.prototype.name")}}</dt> - <dd>Название ошибки. Унаследовано от {{jsxref("Error")}}.</dd> - <dt>{{jsxref("Error.prototype.fileName", "InternalError.prototype.fileName")}}</dt> - <dd>Путь к файлу, в котором возникла эта ошибка. Унаследовано от {{jsxref("Error")}}.</dd> - <dt>{{jsxref("Error.prototype.lineNumber", "InternalError.prototype.lineNumber")}}</dt> - <dd>Номер строки в файле, в котором возникла эта ошибка. Унаследовано от {{jsxref("Error")}}.</dd> - <dt>{{jsxref("Error.prototype.columnNumber", "InternalError.prototype.columnNumber")}}</dt> - <dd>Номер колонки в строке, на которой возникла эта ошибка. Унаследовано от {{jsxref("Error")}}.</dd> - <dt>{{jsxref("Error.prototype.stack", "InternalError.prototype.stack")}}</dt> - <dd>Стек вызовов. Унаследовано от {{jsxref("Error")}}.</dd> -</dl> - -<h2 id="Methods" name="Methods">Методы</h2> -<p>Хотя объект прототипа {{jsxref("InternalError")}} не содержит собственных методов, экземпляры {{jsxref("InternalError")}} наследуют некоторые методы из цепочки прототипов.</p> - -<h2 id="Specifications" name="Specifications">Спецификации</h2> -<p>Не является частью какой-либо спецификации.</p> - -<h2 id="Browser_compatibility" name="Browser_compatibility">Совместимость с браузерами</h2> -<div>{{CompatibilityTable}}</div> -<div id="compat-desktop"> - <table class="compat-table"> - <tbody> - <tr> - <th>Возможность</th> - <th>Chrome</th> - <th>Firefox (Gecko)</th> - <th>Internet Explorer</th> - <th>Opera</th> - <th>Safari</th> - </tr> - <tr> - <td>Базовая поддержка</td> - <td>{{CompatNo}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatNo}}</td> - <td>{{CompatNo}}</td> - <td>{{CompatNo}}</td> - </tr> - </tbody> - </table> -</div> -<div id="compat-mobile"> - <table class="compat-table"> - <tbody> - <tr> - <th>Возможность</th> - <th>Android</th> - <th>Chrome для Android</th> - <th>Firefox Mobile (Gecko)</th> - <th>IE Mobile</th> - <th>Opera Mobile</th> - <th>Safari Mobile</th> - </tr> - <tr> - <td>Базовая поддержка</td> - <td>{{CompatNo}}</td> - <td>{{CompatNo}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatNo}}</td> - <td>{{CompatNo}}</td> - <td>{{CompatNo}}</td> - </tr> - </tbody> - </table> -</div> - -<h2 id="See_also" name="See_also">Смотрите также</h2> -<ul> - <li>{{jsxref("Error.prototype")}}</li> - <li>{{jsxref("Function.prototype")}}</li> -</ul> diff --git a/files/ru/conflicting/web/javascript/reference/global_objects/intl/collator/index.html b/files/ru/conflicting/web/javascript/reference/global_objects/intl/collator/index.html deleted file mode 100644 index 8c3e037a3f..0000000000 --- a/files/ru/conflicting/web/javascript/reference/global_objects/intl/collator/index.html +++ /dev/null @@ -1,110 +0,0 @@ ---- -title: Intl.Collator.prototype -slug: conflicting/Web/JavaScript/Reference/Global_Objects/Intl/Collator -tags: - - Collator - - Internationalization - - JavaScript - - Property - - Prototype -translation_of: Web/JavaScript/Reference/Global_Objects/Intl/Collator -translation_of_original: Web/JavaScript/Reference/Global_Objects/Intl/Collator/prototype -original_slug: Web/JavaScript/Reference/Global_Objects/Intl/Collator/prototype ---- -<div>{{JSRef("Global_Objects", "Collator", "Intl,DateTimeFormat,NumberFormat")}}</div> - -<h2 id="Summary" name="Summary">Сводка</h2> -<p>Свойство <strong><code>Intl.Collator.prototype</code></strong> представляет объект прототипа конструктора {{jsxref("Global_Objects/Collator", "Intl.Collator")}}.</p> - -<div>{{js_property_attributes(0, 0, 0)}}</div> - -<h2 id="Description" name="Description">Описание</h2> -<p>Смотрите {{jsxref("Global_Objects/Collator", "Collator")}} для описания экземпляров <code>Intl.NumberFormat</code>.</p> -<p>Экземпляры {{jsxref("Global_Objects/Collator", "Intl.Collator")}} наследуются от <code>Intl.NumberFormat.prototype</code>. Изменения объекта прототипа наследуются всеми экземплярами {{jsxref("Global_Objects/Collator", "Intl.Collator")}}.</p> - -<h2 id="Properties" name="Properties">Свойства</h2> -<dl> - <dt><code>Intl.Collator.prototype.constructor</code></dt> - <dd>Ссылка на {{jsxref("Global_Objects/Collator", "Intl.Collator")}}.</dd> - <dt>{{jsxref("Collator.compare", "Intl.Collator.prototype.compare")}}</dt> - <dd>Геттер; возвращает функцию, сравнивающую две строки согласно порядку сортировки этого объекта {{jsxref("Global_Objects/Collator", "Collator")}}.</dd> -</dl> - -<h2 id="Methods" name="Methods">Методы</h2> -<dl> - <dt>{{jsxref("Collator.resolvedOptions", "Intl.Collator.prototype.resolvedOptions()")}}</dt> - <dd>Возвращает новый объект со свойствами, отражающими локаль и опции сравнения строк, вычисленные при инициализации объекта.</dd> -</dl> - -<h2 id="Specifications" name="Specifications">Спецификации</h2> -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Спецификация</th> - <th scope="col">Статус</th> - <th scope="col">Комментарии</th> - </tr> - <tr> - <td>{{SpecName('ES Int 1.0', '#sec-10.2.1', 'Intl.Collator.prototype')}}</td> - <td>{{Spec2('ES Int 1.0')}}</td> - <td>Изначальное определение.</td> - </tr> - </tbody> -</table> - -<h2 id="Browser_compatibility" name="Browser_compatibility">Совместимость с браузерами</h2> -<div>{{CompatibilityTable}}</div> -<div id="compat-desktop"> - <table class="compat-table"> - <tbody> - <tr> - <th>Возможность</th> - <th>Chrome</th> - <th>Firefox (Gecko)</th> - <th>Internet Explorer</th> - <th>Opera</th> - <th>Safari (WebKit)</th> - </tr> - <tr> - <td>Базовая поддержка</td> - <td>{{CompatChrome("24")}}</td> - <td>{{CompatGeckoDesktop("29")}}</td> - <td>{{CompatIE("11")}}</td> - <td>{{CompatOpera("15")}}</td> - <td>{{CompatNo}}</td> - </tr> - </tbody> - </table> -</div> -<div id="compat-mobile"> - <table class="compat-table"> - <tbody> - <tr> - <th>Возможность</th> - <th>Android</th> - <th>Chrome для Android</th> - <th>Firefox Mobile (Gecko)</th> - <th>IE Phone</th> - <th>Opera Mobile</th> - <th>Safari Mobile</th> - </tr> - <tr> - <td>Базовая поддержка</td> - <td>{{CompatNo}}</td> - <td>{{CompatChrome("26")}}</td> - <td> - {{CompatNo}}<br> - {{bug("864843")}} - </td> - <td>{{CompatNo}}</td> - <td>{{CompatNo}}</td> - <td>{{CompatNo}}</td> - </tr> - </tbody> - </table> -</div> - -<h2 id="See_also" name="See_also">Смотрите также</h2> -<ul> - <li>{{jsxref("Global_Objects/Collator", "Intl.Collator")}}</li> -</ul> diff --git a/files/ru/conflicting/web/javascript/reference/global_objects/intl/datetimeformat/index.html b/files/ru/conflicting/web/javascript/reference/global_objects/intl/datetimeformat/index.html deleted file mode 100644 index 7338c53fd2..0000000000 --- a/files/ru/conflicting/web/javascript/reference/global_objects/intl/datetimeformat/index.html +++ /dev/null @@ -1,110 +0,0 @@ ---- -title: Intl.DateTimeFormat.prototype -slug: conflicting/Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat -tags: - - DateTimeFormat - - Internationalization - - JavaScript - - Property - - Prototype -translation_of: Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat -translation_of_original: Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat/prototype -original_slug: Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat/prototype ---- -<div>{{JSRef("Global_Objects", "DateTimeFormat", "Intl,Collator,NumberFormat")}}</div> - -<h2 id="Summary" name="Summary">Сводка</h2> -<p>Свойство <strong><code>Intl.DateTimeFormat.prototype</code></strong> представляет объект прототипа конструктора {{jsxref("Global_Objects/DateTimeFormat", "Intl.DateTimeFormat")}}.</p> - -<div>{{js_property_attributes(0, 0, 0)}}</div> - -<h2 id="Description" name="Description">Описание</h2> -<p>Смотрите {{jsxref("Global_Objects/DateTimeFormat", "DateTimeFormat")}} для описания экземпляров <code>Intl.NumberFormat</code>.</p> -<p>Экземпляры {{jsxref("Global_Objects/DateTimeFormat", "Intl.DateTimeFormat")}} наследуются от <code>Intl.NumberFormat.prototype</code>. Изменения объекта прототипа наследуются всеми экземплярами {{jsxref("Global_Objects/DateTimeFormat", "Intl.DateTimeFormat")}}.</p> - -<h2 id="Properties" name="Properties">Свойства</h2> -<dl> - <dt><code>Intl.DateTimeFormat.prototype.constructor</code></dt> - <dd>Ссылка на {{jsxref("Global_Objects/DateTimeFormat", "Intl.DateTimeFormat")}}.</dd> - <dt>{{jsxref("DateTimeFormat.format", "Intl.DateTimeFormat.prototype.format")}}</dt> - <dd>Геттер; возвращает функцию, форматирующую дату согласно локали и опциям форматирования этого объекта {{jsxref("Global_Objects/DateTimeFormat", "DateTimeFormat")}}.</dd> -</dl> - -<h2 id="Methods" name="Methods">Методы</h2> -<dl> - <dt>{{jsxref("DateTimeFormat.resolvedOptions", "Intl.DateTimeFormat.prototype.resolvedOptions()")}}</dt> - <dd>Возвращает новый объект со свойствами, отражающими локаль и опции форматирования, вычисленные при инициализации объекта.</dd> -</dl> - -<h2 id="Specifications" name="Specifications">Спецификации</h2> -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Спецификация</th> - <th scope="col">Статус</th> - <th scope="col">Комментарии</th> - </tr> - <tr> - <td>{{SpecName('ES Int 1.0', '#sec-12.2.1', 'Intl.DateTimeFormat.prototype')}}</td> - <td>{{Spec2('ES Int 1.0')}}</td> - <td>Изначальное определение.</td> - </tr> - </tbody> -</table> - -<h2 id="Browser_compatibility" name="Browser_compatibility">Совместимость с браузерами</h2> -<div>{{CompatibilityTable}}</div> -<div id="compat-desktop"> - <table class="compat-table"> - <tbody> - <tr> - <th>Возможность</th> - <th>Chrome</th> - <th>Firefox (Gecko)</th> - <th>Internet Explorer</th> - <th>Opera</th> - <th>Safari (WebKit)</th> - </tr> - <tr> - <td>Базовая поддержка</td> - <td>{{CompatChrome("24")}}</td> - <td>{{CompatGeckoDesktop("29")}}</td> - <td>{{CompatIE("11")}}</td> - <td>{{CompatOpera("15")}}</td> - <td>{{CompatNo}}</td> - </tr> - </tbody> - </table> -</div> -<div id="compat-mobile"> - <table class="compat-table"> - <tbody> - <tr> - <th>Возможность</th> - <th>Android</th> - <th>Chrome для Android</th> - <th>Firefox Mobile (Gecko)</th> - <th>IE Phone</th> - <th>Opera Mobile</th> - <th>Safari Mobile</th> - </tr> - <tr> - <td>Базовая поддержка</td> - <td>{{CompatNo}}</td> - <td>{{CompatChrome("26")}}</td> - <td> - {{CompatNo}}<br> - {{bug("864843")}} - </td> - <td>{{CompatNo}}</td> - <td>{{CompatNo}}</td> - <td>{{CompatNo}}</td> - </tr> - </tbody> - </table> -</div> - -<h2 id="See_also" name="See_also">Смотрите также</h2> -<ul> - <li>{{jsxref("Global_Objects/DateTimeFormat", "Intl.DateTimeFormat")}}</li> -</ul> diff --git a/files/ru/conflicting/web/javascript/reference/global_objects/intl/numberformat/index.html b/files/ru/conflicting/web/javascript/reference/global_objects/intl/numberformat/index.html deleted file mode 100644 index 3f5329e5fc..0000000000 --- a/files/ru/conflicting/web/javascript/reference/global_objects/intl/numberformat/index.html +++ /dev/null @@ -1,110 +0,0 @@ ---- -title: Intl.NumberFormat.prototype -slug: conflicting/Web/JavaScript/Reference/Global_Objects/Intl/NumberFormat -tags: - - Internationalization - - JavaScript - - NumberFormat - - Property - - Prototype -translation_of: Web/JavaScript/Reference/Global_Objects/Intl/NumberFormat -translation_of_original: Web/JavaScript/Reference/Global_Objects/Intl/NumberFormat/prototype -original_slug: Web/JavaScript/Reference/Global_Objects/Intl/NumberFormat/prototype ---- -<div>{{JSRef("Global_Objects", "NumberFormat", "Intl,Collator,DateTimeFormat")}}</div> - -<h2 id="Summary" name="Summary">Сводка</h2> -<p>Свойство <strong><code>Intl.NumberFormat.prototype</code></strong> представляет объект прототипа конструктора {{jsxref("Global_Objects/NumberFormat", "Intl.NumberFormat")}}.</p> - -<div>{{js_property_attributes(0, 0, 0)}}</div> - -<h2 id="Description" name="Description">Описание</h2> -<p>Смотрите {{jsxref("NumberFormat")}} для описания экземпляров <code>Intl.NumberFormat</code>.</p> -<p>Экземпляры {{jsxref("Global_Objects/NumberFormat", "Intl.NumberFormat")}} наследуются от <code>Intl.NumberFormat.prototype</code>. Изменения объекта прототипа наследуются всеми экземплярами {{jsxref("Global_Objects/NumberFormat", "Intl.NumberFormat")}}.</p> - -<h2 id="Properties" name="Properties">Свойства</h2> -<dl> - <dt><code>Intl.NumberFormat.prototype.constructor</code></dt> - <dd>Ссылка на {{jsxref("Global_Objects/NumberFormat", "Intl.NumberFormat")}}.</dd> - <dt>{{jsxref("NumberFormat.format", "Intl.NumberFormat.prototype.format")}}</dt> - <dd>Геттер; возвращает функцию, форматирующую число согласно локали и опциям форматирования этого объекта {{jsxref("Global_Objects/NumberFormat", "NumberFormat")}}.</dd> -</dl> - -<h2 id="Methods" name="Methods">Методы</h2> -<dl> - <dt>{{jsxref("NumberFormat.resolvedOptions", "Intl.NumberFormat.prototype.resolvedOptions()")}}</dt> - <dd>Возвращает новый объект со свойствами, отражающими локаль и опции сравнения, вычисленные при инициализации объекта.</dd> -</dl> - -<h2 id="Specifications" name="Specifications">Спецификации</h2> -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Спецификация</th> - <th scope="col">Статус</th> - <th scope="col">Комментарии</th> - </tr> - <tr> - <td>{{SpecName('ES Int 1.0', '#sec-11.2.1', 'Intl.NumberFormat.prototype')}}</td> - <td>{{Spec2('ES Int 1.0')}}</td> - <td>Изначальное определение.</td> - </tr> - </tbody> -</table> - -<h2 id="Browser_compatibility" name="Browser_compatibility">Совместимость с браузерами</h2> -<div>{{CompatibilityTable}}</div> -<div id="compat-desktop"> - <table class="compat-table"> - <tbody> - <tr> - <th>Возможность</th> - <th>Chrome</th> - <th>Firefox (Gecko)</th> - <th>Internet Explorer</th> - <th>Opera</th> - <th>Safari (WebKit)</th> - </tr> - <tr> - <td>Базовая поддержка</td> - <td>{{CompatChrome("24")}}</td> - <td>{{CompatGeckoDesktop("29")}}</td> - <td>{{CompatIE("11")}}</td> - <td>{{CompatOpera("15")}}</td> - <td>{{CompatNo}}</td> - </tr> - </tbody> - </table> -</div> -<div id="compat-mobile"> - <table class="compat-table"> - <tbody> - <tr> - <th>Возможность</th> - <th>Android</th> - <th>Chrome для Android</th> - <th>Firefox Mobile (Gecko)</th> - <th>IE Phone</th> - <th>Opera Mobile</th> - <th>Safari Mobile</th> - </tr> - <tr> - <td>Базовая поддержка</td> - <td>{{CompatNo}}</td> - <td>{{CompatChrome("26")}}</td> - <td> - {{CompatNo}}<br> - {{bug("864843")}} - </td> - <td>{{CompatNo}}</td> - <td>{{CompatNo}}</td> - <td>{{CompatNo}}</td> - </tr> - </tbody> - </table> -</div> - -<h2 id="See_also" name="See_also">Смотрите также</h2> -<ul> - <li>{{jsxref("NumberFormat", "Intl.NumberFormat")}}</li> -</ul> diff --git a/files/ru/conflicting/web/javascript/reference/global_objects/map/index.html b/files/ru/conflicting/web/javascript/reference/global_objects/map/index.html deleted file mode 100644 index 709d9ce927..0000000000 --- a/files/ru/conflicting/web/javascript/reference/global_objects/map/index.html +++ /dev/null @@ -1,127 +0,0 @@ ---- -title: Map.prototype -slug: conflicting/Web/JavaScript/Reference/Global_Objects/Map -translation_of: Web/JavaScript/Reference/Global_Objects/Map -translation_of_original: Web/JavaScript/Reference/Global_Objects/Map/prototype -original_slug: Web/JavaScript/Reference/Global_Objects/Map/prototype ---- -<div>{{JSRef}}</div> - -<p>Свойство <code><strong>Map</strong></code><strong><code>.prototype</code></strong> представляет собой прототип конструктора {{jsxref("Map")}}.</p> - -<div>{{js_property_attributes(0,0,0)}}</div> - -<h2 id="Описание">Описание</h2> - -<p>Экземпляры {{jsxref("Map")}} наследуются от {{jsxref("Map.prototype")}}. Вы можете использовать объект конструктора прототипа для добавления свойств и методов ко всем экземплярам <code>Map</code>.</p> - -<h2 id="Свойства">Свойства</h2> - -<dl> - <dt><code>Map.prototype.constructor</code></dt> - <dd>Возвращает функцию, создающую экземпляр прототипа. Это функция {{jsxref("Map")}} по умолчанию. </dd> - <dt>{{jsxref("Map.prototype.size")}}</dt> - <dd>Возвращает количество пар key/value, содержащихся в объекте <code>Map</code>.</dd> -</dl> - -<h2 id="Методы">Методы</h2> - -<dl> - <dt>{{jsxref("Map.prototype.clear()")}}</dt> - <dd>Удаляет все пары key/value из объекта <code>Map</code>.</dd> - <dt>{{jsxref("Map.delete", "Map.prototype.delete(key)")}}</dt> - <dd>Возвращает <code>true</code>, если элемент присутствовал в объекте <code>Map</code> и был удалён, или <code>false</code>, если элемент отсутствует. После вызова этого метода <code>Map.prototype.has(key)</code> вернёт <code>false</code>.</dd> - <dt>{{jsxref("Map.prototype.entries()")}}</dt> - <dd>Возвращает новый объект итератора - new <code>Iterator</code>, который содержит <strong>массив из [key, value]</strong> для каждого элемента в объекте <code>Map</code> в порядке добавления.</dd> - <dt>{{jsxref("Map.forEach", "Map.prototype.forEach(callbackFn[, thisArg])")}}</dt> - <dd>Вызывает callbackFn для каждой пары key/value, находящейся в объекте <code>Map</code>, в порядке добавления. Если указан параметр thisArg, он будет использоваться в качестве значения this при каждом вызове callbackFn. </dd> - <dt>{{jsxref("Map.get", "Map.prototype.get(key)")}}</dt> - <dd>Возвращает значение по указанному ключу <code>key</code> или <code>undefined</code>, если значение отсутствует. </dd> - <dt>{{jsxref("Map.has", "Map.prototype.has(key)")}}</dt> - <dd>Возвращает <code>true</code> или <code>false</code> в зависимости от того, было ли значение связано с <code>key</code> в объекте <code>Map</code> или нет.</dd> - <dt>{{jsxref("Map.prototype.keys()")}}</dt> - <dd>Возвращает новый объект итератора - new <code>Iterator</code>, который содержит <strong>keys</strong> для каждого элемента в объекте <code>Map</code> в порядке добавления.</dd> - <dt>{{jsxref("Map.set", "Map.prototype.set(key, value)")}}</dt> - <dd>Устанавливает value для <code>key</code> в объекте <code>Map</code>. Возвращает объект <code>Map</code>.</dd> - <dt>{{jsxref("Map.prototype.values()")}}</dt> - <dd>Возвращает новый объект итератора - new <code>Iterator</code>, который содержит <strong>values</strong> для каждого элемента в объекте <code>Map</code> в порядке добавления.</dd> - <dt>{{jsxref("Map.@@iterator", "Map.prototype[@@iterator]()")}}</dt> - <dd>Возвращает новый объект итератора - new <code>Iterator</code>, который содержит <strong>массив из [key, value]</strong> для каждого элемента в объекте <code>Map</code> в порядке добавления. </dd> -</dl> - -<h2 id="Спецификации">Спецификации</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Спецификация</th> - <th scope="col">Статус</th> - <th scope="col">Комментарии</th> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-map.prototype', 'Map.prototype')}}</td> - <td>{{Spec2('ES6')}}</td> - <td>Initial definition.</td> - </tr> - </tbody> -</table> - -<h2 id="Совместимость_с_браузерами">Совместимость с браузерами</h2> - -<p>{{CompatibilityTable}}</p> - -<div id="compat-desktop"> -<table class="compat-table"> - <tbody> - <tr> - <th>Возможность</th> - <th>Chrome</th> - <th>Firefox (Gecko)</th> - <th>Internet Explorer</th> - <th>Opera</th> - <th>Safari</th> - </tr> - <tr> - <td>Базовая поддержка</td> - <td>38</td> - <td>{{ CompatGeckoDesktop("13") }}</td> - <td>11</td> - <td>25</td> - <td>7.1</td> - </tr> - </tbody> -</table> -</div> - -<div id="compat-mobile"> -<table class="compat-table"> - <tbody> - <tr> - <th>Возможность</th> - <th>Android</th> - <th>Chrome for Android</th> - <th>Firefox Mobile (Gecko)</th> - <th>IE Mobile</th> - <th>Opera Mobile</th> - <th>Safari Mobile</th> - </tr> - <tr> - <td>Базовая поддержка</td> - <td>{{CompatNo}}</td> - <td>38</td> - <td>{{CompatGeckoMobile("13")}}</td> - <td>{{CompatNo}}</td> - <td>{{CompatNo}}</td> - <td> - <p>8</p> - </td> - </tr> - </tbody> -</table> -</div> - -<h2 id="Смотрите_также">Смотрите также</h2> - -<ul> - <li>{{jsxref("Set.prototype")}}</li> -</ul> diff --git a/files/ru/conflicting/web/javascript/reference/global_objects/number/index.html b/files/ru/conflicting/web/javascript/reference/global_objects/number/index.html deleted file mode 100644 index 6ec29a1dc9..0000000000 --- a/files/ru/conflicting/web/javascript/reference/global_objects/number/index.html +++ /dev/null @@ -1,125 +0,0 @@ ---- -title: Number.prototype -slug: conflicting/Web/JavaScript/Reference/Global_Objects/Number -tags: - - JavaScript - - Number - - Property - - Prototype - - Reference -translation_of: Web/JavaScript/Reference/Global_Objects/Number -translation_of_original: Web/JavaScript/Reference/Global_Objects/Number/prototype -original_slug: Web/JavaScript/Reference/Global_Objects/Number/prototype ---- -<div>{{JSRef("Global_Objects", "Number")}}</div> - -<h2 id="Summary" name="Summary">Сводка</h2> -<p>Свойство <strong><code>Number.prototype</code></strong> представляет прототип конструктора {{jsxref("Global_Objects/Number", "Number")}}.</p> - -<div>{{js_property_attributes(0, 0, 0)}}</div> - -<h2 id="Description" name="Description">Описание</h2> -<p>Все экземпляры {{jsxref("Global_Objects/Number", "Number")}} наследуются от <code>Number.prototype</code>. Объект прототипа конструктора {{jsxref("Global_Objects/Number", "Number")}} может быть изменён для затрагивания всех экземпляров объекта {{jsxref("Global_Objects/Number", "Number")}}.</p> - -<h2 id="Properties" name="Properties">Свойства</h2> -<dl> - <dt><code>Number.prototype.constructor</code></dt> - <dd>Возвращает функцию, создавшую этот экземпляр объекта. По умолчанию ей является объект {{jsxref("Global_Objects/Number", "Number")}}.</dd> -</dl> - -<div>{{jsOverrides("Object", "properties", "constructor")}}</div> - -<h2 id="Methods" name="Methods">Методы</h2> -<dl> - <dt>{{jsxref("Number.prototype.toExponential()")}}</dt> - <dd>Возвращает строку, представляющую число в экспоненциальной записи.</dd> - <dt>{{jsxref("Number.prototype.toFixed()")}}</dt> - <dd>Возвращает строку, представляющую число в записи с фиксированной запятой.</dd> - <dt>{{jsxref("Number.prototype.toLocaleString()")}}</dt> - <dd>Возвращает строку с языкозависимым представлением числа. Переопределяет метод {{jsxref("Object.prototype.toLocaleString()")}}.</dd> - <dt>{{jsxref("Number.prototype.toPrecision()")}}</dt> - <dd>Возвращает строку, представляющую число с указанной точностью в экспоненциальной записи, либо записи с фиксированной запятой.</dd> - <dt>{{jsxref("Number.prototype.toSource()")}} {{non-standard_inline}}</dt> - <dd>Возвращает объектный литерал, представляющий объект {{jsxref("Global_Objects/Number", "Number")}}; вы можете использовать это значение для создания нового объекта. Переопределяет метод {{jsxref("Object.prototype.toSource()")}}.</dd> - <dt>{{jsxref("Number.prototype.toString()")}}</dt> - <dd>Возвращает строку, представляющую указанный объект по указанному основанию системы счисления. Переопределяет метод {{jsxref("Object.prototype.toString()")}}.</dd> - <dt>{{jsxref("Number.prototype.valueOf()")}}</dt> - <dd>Возвращает примитивное значение указанного объекта. Переопределяет метод {{jsxref("Object.prototype.valueOf()")}}.</dd> -</dl> - -<div>{{jsOverrides("Object", "methods", "toExponential", "toFixed", "toLocaleString", "toPrecision", "toSource", "toString", "valueOf")}}</div> - -<h2 id="Specifications" name="Specifications">Спецификации</h2> -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Спецификация</th> - <th scope="col">Статус</th> - <th scope="col">Комментарии</th> - </tr> - <tr> - <td>ECMAScript 1-е издание.</td> - <td>Стандарт</td> - <td>Изначальное определение. Реализована в JavaScript 1.1.</td> - </tr> - <tr> - <td>{{SpecName('ES5.1', '#sec-15.7.4', 'Number')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-properties-of-the-number-prototype-object', 'Number')}}</td> - <td>{{Spec2('ES6')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Browser_compatibility" name="Browser_compatibility">Совместимость с браузерами</h2> -<div>{{CompatibilityTable}}</div> -<div id="compat-desktop"> - <table class="compat-table"> - <tbody> - <tr> - <th>Возможность</th> - <th>Chrome</th> - <th>Firefox (Gecko)</th> - <th>Internet Explorer</th> - <th>Opera</th> - <th>Safari</th> - </tr> - <tr> - <td>Базовая поддержка</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - </tr> - </tbody> - </table> -</div> -<div id="compat-mobile"> - <table class="compat-table"> - <tbody> - <tr> - <th>Возможность</th> - <th>Android</th> - <th>Chrome для Android</th> - <th>Firefox Mobile (Gecko)</th> - <th>IE Mobile</th> - <th>Opera Mobile</th> - <th>Safari Mobile</th> - </tr> - <tr> - <td>Базовая поддержка</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - </tr> - </tbody> - </table> -</div> diff --git a/files/ru/conflicting/web/javascript/reference/global_objects/object/index.html b/files/ru/conflicting/web/javascript/reference/global_objects/object/index.html deleted file mode 100644 index 27b29f5934..0000000000 --- a/files/ru/conflicting/web/javascript/reference/global_objects/object/index.html +++ /dev/null @@ -1,206 +0,0 @@ ---- -title: Object.prototype -slug: conflicting/Web/JavaScript/Reference/Global_Objects/Object -tags: - - JavaScript - - Object - - Property - - Reference -translation_of: Web/JavaScript/Reference/Global_Objects/Object -translation_of_original: Web/JavaScript/Reference/Global_Objects/Object/prototype -original_slug: Web/JavaScript/Reference/Global_Objects/Object/prototype ---- -<div>{{JSRef("Global_Objects", "Object")}}</div> - -<h2 id="Summary" name="Summary">Сводка</h2> - -<p>Свойство <code><strong>Object.prototype</strong></code> представляет объект прототипа {{jsxref("Global_Objects/Object", "Object")}}.</p> - -<div>{{js_property_attributes(0, 0, 0)}}</div> - -<h2 id="Description" name="Description">Описание</h2> - -<p>Все объекты в JavaScript являются потомками {{jsxref("Global_Objects/Object", "Object")}}; все объекты наследуют методы и свойства из прототипа объекта <code>Object.prototype</code>, хотя они и могут быть переопределены (за исключением объекта <code>Object</code> с прототипом <code>null</code>, то есть, созданным вызовом <code>Object.create(null)</code>). Например, прототипы других конструкторов переопределяют свойство <code>constructor</code> и предоставляют свои собственные методы {{jsxref("Object.prototype.toString()", "toString()")}}. Изменения в объекте прототипа {{jsxref("Global_Objects/Object", "Object")}} распространяются на все объекты до тех пор, пока свойства и методы, учитывающие эти изменения, не переопределяются дальше по цепочке прототипов.</p> - -<h2 id="Properties" name="Properties">Свойства</h2> - -<dl> - <dt>{{jsxref("Object.prototype.constructor")}}</dt> - <dd>Определяет функцию, создающую прототип объекта.</dd> - <dt>{{jsxref("Object.proto", "Object.prototype.__proto__")}} {{non-standard_inline}}</dt> - <dd>Указывает на объект, который использовался в качестве прототипа при инстанцировании объекта.</dd> - <dt>{{jsxref("Object.noSuchMethod", "Object.prototype.__noSuchMethod__")}} {{non-standard_inline}}</dt> - <dd>Позволяет определить функцию, выполняющуюся при вызове в качестве метода неопределённого члена объекта.</dd> - <dt><s class="obsoleteElement">{{jsxref("Object.count", "Object.prototype.__count__")}} {{obsolete_inline}}</s></dt> - <dd><s class="obsoleteElement">Использовалось для возврата количества перечисляемых свойств, определённых напрямую на пользовательском объекте, но было удалено.</s></dd> - <dt><s class="obsoleteElement">{{jsxref("Object.parent", "Object.prototype.__parent__")}} {{obsolete_inline}}</s></dt> - <dd><s class="obsoleteElement">Использовалось для указания контекста объекта, но было удалено.</s></dd> -</dl> - -<h2 id="Methods" name="Methods">Методы</h2> - -<dl> - <dt>{{jsxref("Object.defineGetter", "Object.prototype.__defineGetter__()")}} {{non-standard_inline}} {{deprecated_inline}}</dt> - <dd>Ассоциирует функцию со свойством, которое, при доступе к нему, выполняет эту функцию и возвращает её возвращаемое значение.</dd> - <dt>{{jsxref("Object.defineSetter", "Object.prototype.__defineSetter__()")}} {{non-standard_inline}} {{deprecated_inline}}</dt> - <dd>Ассоциирует функцию со свойством, которое, при его установке, выполняет эту функцию, изменяющую свойство.</dd> - <dt>{{jsxref("Object.lookupGetter", "Object.prototype.__lookupGetter__()")}} {{non-standard_inline}} {{deprecated_inline}}</dt> - <dd>Возвращает функцию, ассоциированную с указанным свойством методом {{jsxref("Object.defineGetter", "__defineGetter__")}}.</dd> - <dt>{{jsxref("Object.lookupSetter", "Object.prototype.__lookupSetter__()")}} {{non-standard_inline}} {{deprecated_inline}}</dt> - <dd>Возвращает функцию, ассоциированную с указанным свойством методом {{jsxref("Object.defineSetter", "__defineSetter__")}}.</dd> - <dt>{{jsxref("Object.prototype.hasOwnProperty()")}}</dt> - <dd>Возвращает логическое значение, указывающее, содержит ли указанное свойство непосредственно объект, или он унаследовал его по цепочке прототипов.</dd> - <dt>{{jsxref("Object.prototype.isPrototypeOf()")}}</dt> - <dd>Возвращает логическое значение, указывающее, состоит ли указанный объект в цепочке прототипов объекта, на котором был вызван данный метод.</dd> - <dt>{{jsxref("Object.prototype.propertyIsEnumerable()")}}</dt> - <dd>Возвращает логическое значение, указывающее, установлен ли внутренний <a href="/ru/docs/ECMAScript_DontEnum_attribute">атрибут ECMAScript DontEnum</a>.</dd> - <dt>{{jsxref("Object.prototype.toSource()")}} {{non-standard_inline}}</dt> - <dd>Возвращает строку, содержащую исходный код объекта в литеральной форме, представляющего объект, на котором был вызван данный метод; вы можете использовать это значение для создания нового объекта.</dd> - <dt>{{jsxref("Object.prototype.toLocaleString()")}}</dt> - <dd>Вызывает {{jsxref("Object.toString", "toString()")}}.</dd> - <dt>{{jsxref("Object.prototype.toString()")}}</dt> - <dd>Возвращает строковое представление объекта.</dd> - <dt>{{jsxref("Object.prototype.unwatch()")}} {{non-standard_inline}}</dt> - <dd>Удаляет точку наблюдения (watchpoint) со свойства объекта.</dd> - <dt>{{jsxref("Object.prototype.valueOf()")}}</dt> - <dd>Возвращает значение примитива указанного объекта.</dd> - <dt>{{jsxref("Object.prototype.watch()")}} {{non-standard_inline}}</dt> - <dd>Добавляет точку наблюдения (watchpoint) к свойству объекта.</dd> - <dt><s class="obsoleteElement">{{jsxref("Object.prototype.eval()")}} {{obsolete_inline}}</s></dt> - <dd><s class="obsoleteElement">Использовался для вычисления строки с JavaScript-кодом в контексте указанного объекта, но был удалён.</s></dd> -</dl> - -<h2 id="Examples" name="Examples">Примеры</h2> - -<p>Поскольку Javascript, строго говоря, не имеет объекты подклассов, прототип является полезным обходным путём создания объекта «базового класса» из определённых функций, которые выступают в роли объектов. Например:</p> - -<pre class="brush: js">var Person = function(name) { - this.name = name; - this.canTalk = true; - this.greet = function() { - if (this.canTalk) { - console.log('Привет, я ' + this.name); - } - }; -}; - -var Employee = function(name, title) { - this.name = name; - this.title = title; - this.greet = function() { - if (this.canTalk) { - console.log('Привет, я ' + this.name + ', ' + this.title); - } - }; -}; -Employee.prototype = new Person(); - -var Customer = function(name) { - this.name = name; -}; -Customer.prototype = new Person(); - -var Mime = function(name) { - this.name = name; - this.canTalk = false; -}; -Mime.prototype = new Person(); - -var bob = new Employee('Боб', 'Строитель'); -var joe = new Customer('Джо'); -var rg = new Employee('Ред Грин', 'Разнорабочий'); -var mike = new Customer('Майк'); -var mime = new Mime('Мим'); -bob.greet(); -joe.greet(); -rg.greet(); -mike.greet(); -mime.greet(); -</pre> - -<p>Вывод будет следующим:</p> - -<pre class="brush: js">Привет, я Боб, Строитель -Привет, я Джо -Привет, я Ред Грин, Разнорабочий -Привет, я Майк -</pre> - -<h2 id="Specifications" name="Specifications">Спецификации</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Спецификация</th> - <th scope="col">Статус</th> - <th scope="col">Комментарии</th> - </tr> - <tr> - <td>ECMAScript 1-е издание.</td> - <td>Стандарт</td> - <td>Изначальное определение. Реализована в JavaScript 1.0.</td> - </tr> - <tr> - <td>{{SpecName('ES5.1', '#sec-15.2.3.1', 'Object.prototype')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td></td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-object.prototype', 'Object.prototype')}}</td> - <td>{{Spec2('ES6')}}</td> - <td></td> - </tr> - </tbody> -</table> - -<h2 id="Browser_compatibility" name="Browser_compatibility">Совместимость с браузерами</h2> - -<div>{{CompatibilityTable}}</div> - -<div id="compat-desktop"> -<table class="compat-table"> - <tbody> - <tr> - <th>Возможность</th> - <th>Chrome</th> - <th>Firefox (Gecko)</th> - <th>Internet Explorer</th> - <th>Opera</th> - <th>Safari</th> - </tr> - <tr> - <td>Базовая поддержка</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - </tr> - </tbody> -</table> -</div> - -<div id="compat-mobile"> -<table class="compat-table"> - <tbody> - <tr> - <th>Возможность</th> - <th>Android</th> - <th>Chrome для Android</th> - <th>Firefox Mobile (Gecko)</th> - <th>IE Mobile</th> - <th>Opera Mobile</th> - <th>Safari Mobile</th> - </tr> - <tr> - <td>Базовая поддержка</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - </tr> - </tbody> -</table> -</div> diff --git a/files/ru/conflicting/web/javascript/reference/global_objects/promise/index.html b/files/ru/conflicting/web/javascript/reference/global_objects/promise/index.html deleted file mode 100644 index e0459a437d..0000000000 --- a/files/ru/conflicting/web/javascript/reference/global_objects/promise/index.html +++ /dev/null @@ -1,68 +0,0 @@ ---- -title: Promise.prototype -slug: conflicting/Web/JavaScript/Reference/Global_Objects/Promise -tags: - - JavaScript - - Промис - - Свойство -translation_of: Web/JavaScript/Reference/Global_Objects/Promise -translation_of_original: Web/JavaScript/Reference/Global_Objects/Promise/prototype -original_slug: Web/JavaScript/Reference/Global_Objects/Promise/prototype ---- -<div>{{JSRef}}</div> - -<p>Свойство <code><strong>Promise</strong></code><strong><code>.prototype</code></strong> представляет собой прототип конструктора {{jsxref("Promise")}}.</p> - -<div>{{js_property_attributes(0,0,0)}}</div> - -<h2 id="Описание">Описание</h2> - -<p>{{jsxref("Promise")}} объект наследованный от {{jsxref("Promise.prototype")}}. Вы можете использовать прототип конструктора чтобы добавлять свойства или методы во все объекты промисов.</p> - -<h2 id="Свойства">Свойства</h2> - -<dl> - <dt><code>Promise.prototype.constructor</code></dt> - <dd>Возвращает функцию, которая создала прототип экземпляра. Это функция всех промисов по умолчанию.</dd> -</dl> - -<h2 id="Методы">Методы</h2> - -<dl> - <dt>{{jsxref("Promise.catch", "Promise.prototype.catch(onRejected)")}}</dt> - <dd>Добавляет колбэк-функцию для обработки отклонения промиса, которая возвращает новый промис выполненный с переданным значением, если он вызван, или оригинальное значение resolve, если промис выполнен.</dd> - <dt>{{jsxref("Promise.then", "Promise.prototype.then(onFulfilled, onRejected)")}}</dt> - <dd style="margin-bottom: 0.5cm;">Добавляет обработчик выполнения и отклонения промиса, и возвращает новый промис выполненный со значением вызванного обработчика, или оригинальное значение, если промис не был обработан (т.е. если соответствующий обработчик onFulfilled или onRejected не является функцией).</dd> -</dl> - -<h2 id="Спецификация">Спецификация</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Specification</th> - <th scope="col">Status</th> - <th scope="col">Comment</th> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-promise.prototype', 'Promise.prototype')}}</td> - <td>{{Spec2('ES6')}}</td> - <td>Initial definition.</td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-promise.prototype', 'Promise.prototype')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td></td> - </tr> - </tbody> -</table> - -<h2 id="Совместимость_с_браузерами">Совместимость с браузерами</h2> - - - -<h2 id="Смотрите_также">Смотрите также</h2> - -<ul> - <li>{{jsxref("Promise")}}</li> -</ul> diff --git a/files/ru/conflicting/web/javascript/reference/global_objects/proxy/proxy/index.html b/files/ru/conflicting/web/javascript/reference/global_objects/proxy/proxy/index.html deleted file mode 100644 index 300a6fab10..0000000000 --- a/files/ru/conflicting/web/javascript/reference/global_objects/proxy/proxy/index.html +++ /dev/null @@ -1,136 +0,0 @@ ---- -title: Proxy handler -slug: conflicting/Web/JavaScript/Reference/Global_Objects/Proxy/Proxy -tags: - - ECMAScript 2015 - - JavaScript - - NeedsTranslation - - Proxy - - TopicStub - - Прокси - - Русский - - ловушки -translation_of: Web/JavaScript/Reference/Global_Objects/Proxy/Proxy -translation_of_original: Web/JavaScript/Reference/Global_Objects/Proxy/handler -original_slug: Web/JavaScript/Reference/Global_Objects/Proxy/handler ---- -<div>{{JSRef}}</div> - -<p>Объект-обработчик прокси - это объект, который содержит ловушки для {{jsxref("Proxy", "proxies", "", 1)}}.</p> - -<h2 id="Методы">Методы</h2> - -<p><span class="VIiyi" lang="ru"><span class="ChMk0b JLqJ4b"><span>Все ловушки ставятся по желанию разработчика.</span></span> <span class="ChMk0b JLqJ4b"><span>Если ловушка не была определена, то, по умолчанию, операция перенаправляется на исходный объект (target).</span></span></span></p> - -<dl> - <dt>{{jsxref("Global_Objects/Proxy/handler/getPrototypeOf", "handler.getPrototypeOf()")}}</dt> - <dd>Ловушка для {{jsxref("Object.getPrototypeOf")}}.</dd> - <dt>{{jsxref("Global_Objects/Proxy/handler/setPrototypeOf", "handler.setPrototypeOf()")}}</dt> - <dd>Ловушка для {{jsxref("Object.setPrototypeOf")}}.</dd> - <dt>{{jsxref("Global_Objects/Proxy/handler/isExtensible", "handler.isExtensible()")}}</dt> - <dd>Ловушка для {{jsxref("Object.isExtensible")}}.</dd> - <dt>{{jsxref("Global_Objects/Proxy/handler/preventExtensions", "handler.preventExtensions()")}}</dt> - <dd>Ловушка для {{jsxref("Object.preventExtensions")}}.</dd> - <dt>{{jsxref("Global_Objects/Proxy/handler/getOwnPropertyDescriptor", "handler.getOwnPropertyDescriptor()")}}</dt> - <dd>Ловушка для {{jsxref("Object.getOwnPropertyDescriptor")}}.</dd> - <dt>{{jsxref("Global_Objects/Proxy/handler/defineProperty", "handler.defineProperty()")}}</dt> - <dd>Ловушка для {{jsxref("Object.defineProperty")}}.</dd> - <dt>{{jsxref("Global_Objects/Proxy/handler/has", "handler.has()")}}</dt> - <dd>Ловушка для оператора {{jsxref("Operators/in", "in")}}.</dd> - <dt>{{jsxref("Global_Objects/Proxy/handler/get", "handler.get()")}}</dt> - <dd>Ловушка для получения значений из свойств.</dd> - <dt>{{jsxref("Global_Objects/Proxy/handler/set", "handler.set()")}}</dt> - <dd>Ловушка для установки значений в свойства.</dd> - <dt>{{jsxref("Global_Objects/Proxy/handler/deleteProperty", "handler.deleteProperty()")}}</dt> - <dd>Ловушка для оператора {{jsxref("Operators/delete", "delete")}}.</dd> - <dt>{{jsxref("Global_Objects/Proxy/handler/ownKeys", "handler.ownKeys()")}}</dt> - <dd>Ловушка для {{jsxref("Object.getOwnPropertyNames")}} и {{jsxref("Object.getOwnPropertySymbols")}}.</dd> - <dt>{{jsxref("Global_Objects/Proxy/handler/apply", "handler.apply()")}}</dt> - <dd>Ловушка для вызова функции.</dd> - <dt>{{jsxref("Global_Objects/Proxy/handler/construct", "handler.construct()")}}</dt> - <dd>Ловушка для оператора {{jsxref("Operators/new", "new")}}.</dd> -</dl> - -<p>Некоторые нестандартные ловушки <a href="/en-US/docs/Web/JavaScript/Reference/Deprecated_and_obsolete_features#Proxy">устарели и были удалены</a>.</p> - -<h2 id="Спецификации">Спецификации</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Спецификация</th> - <th scope="col">Статус</th> - <th scope="col">Комментарий</th> - </tr> - <tr> - <td>{{SpecName('ES2015', '#sec-proxy-object-internal-methods-and-internal-slots', 'Proxy Object Internal Methods and Internal Slots')}}</td> - <td>{{Spec2('ES2015')}}</td> - <td>Определении при инициализации.</td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-proxy-object-internal-methods-and-internal-slots', 'Proxy Object Internal Methods and Internal Slots')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td>Обработчик <code>enumerate</code> был удалён.</td> - </tr> - </tbody> -</table> - -<h2 id="Совместимость_с_браузерами">Совместимость с браузерами</h2> - -<p>{{CompatibilityTable}}</p> - -<div id="compat-desktop"> -<table class="compat-table"> - <tbody> - <tr> - <th>Feature</th> - <th>Chrome</th> - <th>Firefox (Gecko)</th> - <th>Internet Explorer</th> - <th>Opera</th> - <th>Safari</th> - </tr> - <tr> - <td>Basic support</td> - <td>49 [1]</td> - <td>{{ CompatGeckoDesktop("18") }}</td> - <td>12</td> - <td>{{CompatOpera(36)}}</td> - <td>{{CompatSafari(10)}}</td> - </tr> - </tbody> -</table> -</div> - -<div id="compat-mobile"> -<table class="compat-table"> - <tbody> - <tr> - <th>Feature</th> - <th>Android</th> - <th>Chrome for Android</th> - <th>Firefox Mobile (Gecko)</th> - <th>IE Mobile</th> - <th>Opera Mobile</th> - <th>Safari Mobile</th> - </tr> - <tr> - <td>Basic support</td> - <td>{{CompatNo}}</td> - <td>{{CompatNo}}</td> - <td>{{ CompatGeckoDesktop("18") }}</td> - <td>{{CompatNo}}</td> - <td>{{CompatNo}}</td> - <td>{{CompatNo}}</td> - </tr> - </tbody> -</table> -</div> - -<p>[1] <a href="https://www.chromestatus.com/features/4811188005240832">Разрешён по умолчанию</a>.</p> - -<h2 id="Смотрите_также">Смотрите также</h2> - -<ul> - <li>{{jsxref("Proxy")}}</li> -</ul> diff --git a/files/ru/conflicting/web/javascript/reference/global_objects/rangeerror/index.html b/files/ru/conflicting/web/javascript/reference/global_objects/rangeerror/index.html deleted file mode 100644 index 9f3a393d34..0000000000 --- a/files/ru/conflicting/web/javascript/reference/global_objects/rangeerror/index.html +++ /dev/null @@ -1,124 +0,0 @@ ---- -title: RangeError.prototype -slug: conflicting/Web/JavaScript/Reference/Global_Objects/RangeError -tags: - - Error - - JavaScript - - Property - - Prototype - - RangeError -translation_of: Web/JavaScript/Reference/Global_Objects/RangeError -translation_of_original: Web/JavaScript/Reference/Global_Objects/RangeError/prototype -original_slug: Web/JavaScript/Reference/Global_Objects/RangeError/prototype ---- -<div>{{JSRef("Global_Objects", "Error", "EvalError,InternalError,RangeError,ReferenceError,SyntaxError,TypeError,URIError")}}</div> - -<h2 id="Summary" name="Summary">Сводка</h2> -<p>Свойство <code><strong>RangeError.prototype</strong></code> представляет прототип конструктора объекта {{jsxref("RangeError")}}.</p> - -<div>{{js_property_attributes(0, 0, 0)}}</div> - -<h2 id="Description" name="Description">Описание</h2> -<p>Все экземпляры {{jsxref("RangeError")}} наследуются от объекта <code>RangeError.prototype</code>. Вы можете использовать прототип для добавления свойств или методов ко всем экземплярам.</p> - -<h2 id="Properties" name="Properties">Свойства</h2> -<dl> - <dt><code>RangeError.prototype.constructor</code></dt> - <dd>Определяет функцию, создающую прототип экземпляра.</dd> - <dt>{{jsxref("Error.prototype.message", "RangeError.prototype.message")}}</dt> - <dd>Сообщение ошибки. Хотя стандарт ECMA-262 определяет, что {{jsxref("RangeError")}} должен предоставлять своё собственное свойство <code>message</code>, в <a href="/ru/docs/Mozilla/Projects/SpiderMonkey">SpiderMonkey</a> он наследует свойство {{jsxref("Error.prototype.message")}}.</dd> - <dt>{{jsxref("Error.prototype.name", "RangeError.prototype.name")}}</dt> - <dd>Название ошибки. Унаследовано от {{jsxref("Error")}}.</dd> - <dt>{{jsxref("Error.prototype.fileName", "RangeError.prototype.fileName")}}</dt> - <dd>Путь к файлу, в котором возникла эта ошибка. Унаследовано от {{jsxref("Error")}}.</dd> - <dt>{{jsxref("Error.prototype.lineNumber", "RangeError.prototype.lineNumber")}}</dt> - <dd>Номер строки в файле, в котором возникла эта ошибка. Унаследовано от {{jsxref("Error")}}.</dd> - <dt>{{jsxref("Error.prototype.columnNumber", "RangeError.prototype.columnNumber")}}</dt> - <dd>Номер колонки в строке, на которой возникла эта ошибка. Унаследовано от {{jsxref("Error")}}.</dd> - <dt>{{jsxref("Error.prototype.stack", "RangeError.prototype.stack")}}</dt> - <dd>Стек вызовов. Унаследовано от {{jsxref("Error")}}.</dd> -</dl> - -<h2 id="Methods" name="Methods">Методы</h2> -<p>Хотя объект прототипа {{jsxref("RangeError")}} не содержит собственных методов, экземпляры {{jsxref("RangeError")}} наследуют некоторые методы из цепочки прототипов.</p> - -<h2 id="Specifications" name="Specifications">Спецификации</h2> -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Спецификация</th> - <th scope="col">Статус</th> - <th scope="col">Комментарии</th> - </tr> - <tr> - <td>ECMAScript 3-е издание.</td> - <td>Стандарт</td> - <td>Изначальное определение.</td> - </tr> - <tr> - <td>{{SpecName('ES5.1', '#sec-15.11.7.6', 'NativeError.prototype')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td>Определено как <code><em>NativeError</em>.prototype</code>.</td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-nativeerror.prototype', 'NativeError.prototype')}}</td> - <td>{{Spec2('ES6')}}</td> - <td>Определено как <code><em>NativeError</em>.prototype</code>.</td> - </tr> - </tbody> -</table> - -<h2 id="Browser_compatibility" name="Browser_compatibility">Совместимость с браузерами</h2> -<div>{{CompatibilityTable}}</div> -<div id="compat-desktop"> - <table class="compat-table"> - <tbody> - <tr> - <th>Возможность</th> - <th>Chrome</th> - <th>Firefox (Gecko)</th> - <th>Internet Explorer</th> - <th>Opera</th> - <th>Safari</th> - </tr> - <tr> - <td>Базовая поддержка</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - </tr> - </tbody> - </table> -</div> -<div id="compat-mobile"> - <table class="compat-table"> - <tbody> - <tr> - <th>Возможность</th> - <th>Android</th> - <th>Chrome для Android</th> - <th>Firefox Mobile (Gecko)</th> - <th>IE Mobile</th> - <th>Opera Mobile</th> - <th>Safari Mobile</th> - </tr> - <tr> - <td>Базовая поддержка</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - </tr> - </tbody> - </table> -</div> - -<h2 id="See_also" name="See_also">Смотрите также</h2> -<ul> - <li>{{jsxref("Error.prototype")}}</li> - <li>{{jsxref("Function.prototype")}}</li> -</ul> diff --git a/files/ru/conflicting/web/javascript/reference/global_objects/referenceerror/index.html b/files/ru/conflicting/web/javascript/reference/global_objects/referenceerror/index.html deleted file mode 100644 index 541fdaf0a1..0000000000 --- a/files/ru/conflicting/web/javascript/reference/global_objects/referenceerror/index.html +++ /dev/null @@ -1,124 +0,0 @@ ---- -title: ReferenceError.prototype -slug: conflicting/Web/JavaScript/Reference/Global_Objects/ReferenceError -tags: - - Error - - JavaScript - - Property - - Prototype - - ReferenceError -translation_of: Web/JavaScript/Reference/Global_Objects/ReferenceError -translation_of_original: Web/JavaScript/Reference/Global_Objects/ReferenceError/prototype -original_slug: Web/JavaScript/Reference/Global_Objects/ReferenceError/prototype ---- -<div>{{JSRef("Global_Objects", "Error", "EvalError,InternalError,RangeError,ReferenceError,SyntaxError,TypeError,URIError")}}</div> - -<h2 id="Summary" name="Summary">Сводка</h2> -<p>Свойство <code><strong>ReferenceError.prototype</strong></code> представляет прототип конструктора объекта {{jsxref("ReferenceError")}}.</p> - -<div>{{js_property_attributes(0, 0, 0)}}</div> - -<h2 id="Description" name="Description">Описание</h2> -<p>Все экземпляры {{jsxref("ReferenceError")}} наследуются от объекта <code>ReferenceError.prototype</code>. Вы можете использовать прототип для добавления свойств или методов ко всем экземплярам.</p> - -<h2 id="Properties" name="Properties">Свойства</h2> -<dl> - <dt><code>ReferenceError.prototype.constructor</code></dt> - <dd>Определяет функцию, создающую прототип экземпляра.</dd> - <dt>{{jsxref("Error.prototype.message", "ReferenceError.prototype.message")}}</dt> - <dd>Сообщение ошибки. Хотя стандарт ECMA-262 определяет, что {{jsxref("ReferenceError")}} должен предоставлять своё собственное свойство <code>message</code>, в <a href="/ru/docs/Mozilla/Projects/SpiderMonkey">SpiderMonkey</a> он наследует свойство {{jsxref("Error.prototype.message")}}.</dd> - <dt>{{jsxref("Error.prototype.name", "ReferenceError.prototype.name")}}</dt> - <dd>Название ошибки. Унаследовано от {{jsxref("Error")}}.</dd> - <dt>{{jsxref("Error.prototype.fileName", "ReferenceError.prototype.fileName")}}</dt> - <dd>Путь к файлу, в котором возникла эта ошибка. Унаследовано от {{jsxref("Error")}}.</dd> - <dt>{{jsxref("Error.prototype.lineNumber", "ReferenceError.prototype.lineNumber")}}</dt> - <dd>Номер строки в файле, в котором возникла эта ошибка. Унаследовано от {{jsxref("Error")}}.</dd> - <dt>{{jsxref("Error.prototype.columnNumber", "ReferenceError.prototype.columnNumber")}}</dt> - <dd>Номер колонки в строке, на которой возникла эта ошибка. Унаследовано от {{jsxref("Error")}}.</dd> - <dt>{{jsxref("Error.prototype.stack", "ReferenceError.prototype.stack")}}</dt> - <dd>Стек вызовов. Унаследовано от {{jsxref("Error")}}.</dd> -</dl> - -<h2 id="Methods" name="Methods">Методы</h2> -<p>Хотя объект прототипа {{jsxref("ReferenceError")}} не содержит собственных методов, экземпляры {{jsxref("ReferenceError")}} наследуют некоторые методы из цепочки прототипов.</p> - -<h2 id="Specifications" name="Specifications">Спецификации</h2> -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Спецификация</th> - <th scope="col">Статус</th> - <th scope="col">Комментарии</th> - </tr> - <tr> - <td>ECMAScript 3-е издание.</td> - <td>Стандарт</td> - <td>Изначальное определение.</td> - </tr> - <tr> - <td>{{SpecName('ES5.1', '#sec-15.11.7.6', 'NativeError.prototype')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td>Определено как <code><em>NativeError</em>.prototype</code>.</td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-nativeerror.prototype', 'NativeError.prototype')}}</td> - <td>{{Spec2('ES6')}}</td> - <td>Определено как <code><em>NativeError</em>.prototype</code>.</td> - </tr> - </tbody> -</table> - -<h2 id="Browser_compatibility" name="Browser_compatibility">Совместимость с браузерами</h2> -<div>{{CompatibilityTable}}</div> -<div id="compat-desktop"> - <table class="compat-table"> - <tbody> - <tr> - <th>Возможность</th> - <th>Chrome</th> - <th>Firefox (Gecko)</th> - <th>Internet Explorer</th> - <th>Opera</th> - <th>Safari</th> - </tr> - <tr> - <td>Базовая поддержка</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - </tr> - </tbody> - </table> -</div> -<div id="compat-mobile"> - <table class="compat-table"> - <tbody> - <tr> - <th>Возможность</th> - <th>Android</th> - <th>Chrome для Android</th> - <th>Firefox Mobile (Gecko)</th> - <th>IE Mobile</th> - <th>Opera Mobile</th> - <th>Safari Mobile</th> - </tr> - <tr> - <td>Базовая поддержка</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - </tr> - </tbody> - </table> -</div> - -<h2 id="See_also" name="See_also">Смотрите также</h2> -<ul> - <li>{{jsxref("Error.prototype")}}</li> - <li>{{jsxref("Function.prototype")}}</li> -</ul> diff --git a/files/ru/conflicting/web/javascript/reference/global_objects/regexp/index.html b/files/ru/conflicting/web/javascript/reference/global_objects/regexp/index.html deleted file mode 100644 index ab1bd02ef7..0000000000 --- a/files/ru/conflicting/web/javascript/reference/global_objects/regexp/index.html +++ /dev/null @@ -1,142 +0,0 @@ ---- -title: RegExp.prototype -slug: conflicting/Web/JavaScript/Reference/Global_Objects/RegExp -tags: - - JavaScript - - Property - - Prototype - - Reference - - RegExp - - регулярные выражения -translation_of: Web/JavaScript/Reference/Global_Objects/RegExp -translation_of_original: Web/JavaScript/Reference/Global_Objects/RegExp/prototype -original_slug: Web/JavaScript/Reference/Global_Objects/RegExp/prototype ---- -<div>{{JSRef("Global_Objects", "RegExp")}}</div> - -<h2 id="Summary" name="Summary">Сводка</h2> -<p>Свойство <strong><code>RegExp.prototype</code></strong> представляет объект прототипа для конструктора {{jsxref("Global_Objects/RegExp", "RegExp")}}.</p> - -<div>{{js_property_attributes(0, 0, 0)}}</div> - -<h2 id="Description" name="Description">Описание</h2> -<p>Описание экземпляров регулярных выражений смотрите на странице документации, посвящённой объекту {{jsxref("Global_Objects/RegExp", "RegExp")}}. Экземпляры регулярных выражений наследуются от <code>RegExp.prototype</code>. Изменение объекта прототипа распространяется на все экземпляры регулярных выражений.</p> - -<h2 id="Properties" name="Properties">Свойства</h2> -<p>Также смотрите <a href="/ru/docs/Web/JavaScript/Reference/Deprecated_and_obsolete_features#RegExp_Properties">устаревшие свойства объекта <code>RegExp</code></a></p> -<p>Обратите внимание, что некоторые свойства объекта {{jsxref("Global_Objects/RegExp", "RegExp")}} имеют как длинные, так и короткие (Perl-подобные) имена. Оба имени всегда ссылаются на одно и тоже значение. Perl — это язык программирования, откуда JavaScript взял свои регулярные выражения.</p> -<dl> - <dt><code>RegExp.prototype.constructor</code></dt> - <dd>Определяет функцию, создающую прототип объекта.</dd> - <dt>{{jsxref("RegExp.prototype.global")}}</dt> - <dd>Определяет, надо ли проверять регулярное выражение на все возможные сопоставления со строкой, или достаточно только первый раз.</dd> - <dt>{{jsxref("RegExp.prototype.ignoreCase")}}</dt> - <dd>Определяет, надо ли игнорировать регистр символов при попытке сопоставления со строкой.</dd> - <dt>{{jsxref("RegExp.prototype.lastIndex")}}</dt> - <dd>Индекс, по которому начинается следующее сопоставление.</dd> - <dt>{{jsxref("RegExp.prototype.multiline")}}</dt> - <dd>Определяет, надо ли искать по нескольким строкам.</dd> - <dt>{{jsxref("RegExp.prototype.source")}}</dt> - <dd>Текст шаблона.</dd> - <dt>{{jsxref("RegExp.prototype.sticky")}} {{experimental_inline}}</dt> - <dd>Определяет, включён ли режим «липкого» поиска.</dd> - <dt>{{jsxref("RegExp.prototype.flags")}} {{experimental_inline}}</dt> - <dd>Строка, состоящая из флагов объекта регулярного выражения.</dd> -</dl> -<div>{{jsOverrides("Object", "properties", "constructor", "global", "ignoreCase", "lastIndex", "multiline", "source", "sticky")}}</div> - -<h2 id="Methods" name="Methods">Методы</h2> -<p>Также смотрите <a href="/ru/docs/Web/JavaScript/Reference/Deprecated_and_obsolete_features#RegExp_Methods">устаревшие методы объекта <code>RegExp</code></a></p> -<dl> - <dt>{{jsxref("RegExp.prototype.exec()")}}</dt> - <dd>Выполняет поиск сопоставлений регулярного выражения в своём строковом параметре.</dd> - <dt>{{jsxref("RegExp.prototype.test()")}}</dt> - <dd>Пытается сопоставить регулярное выражение своему строковому параметру.</dd> - <dt>{{jsxref("RegExp.prototype.toSource()")}} {{non-standard_inline}}</dt> - <dd>Возвращает объектный литерал, представляющий указанный объект; вы можете использовать это значение для создания нового объекта. Переопределяет метод {{jsxref("Object.prototype.toSource()")}}.</dd> - <dt>{{jsxref("RegExp.prototype.toString()")}}</dt> - <dd>Возвращает строку, представляющую указанный объект. Переопределяет метод {{jsxref("Object.prototype.toString()")}}.</dd> -</dl> -<div>{{jsOverrides("Object", "Methods", "exec", "test", "toSource", "toString")}}</div> - -<h2 id="Specifications" name="Specifications">Спецификации</h2> -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Спецификация</th> - <th scope="col">Статус</th> - <th scope="col">Комментарии</th> - </tr> - <tr> - <td>ECMAScript 1-е издание.</td> - <td>Стандарт</td> - <td>Изначальное определение. Реализована в JavaScript 1.1.</td> - </tr> - <tr> - <td>{{SpecName('ES5.1', '#sec-15.10.5.1', 'RegExp')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-regexp.prototype', 'RegExp.prototype')}}</td> - <td>{{Spec2('ES6')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Browser_compatibility" name="Browser_compatibility">Совместимость с браузерами</h2> -<div>{{CompatibilityTable}}</div> -<div id="compat-desktop"> - <table class="compat-table"> - <tbody> - <tr> - <th>Возможность</th> - <th>Chrome</th> - <th>Firefox (Gecko)</th> - <th>Internet Explorer</th> - <th>Opera</th> - <th>Safari</th> - </tr> - <tr> - <td>Базовая поддержка</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - </tr> - </tbody> - </table> -</div> -<div id="compat-mobile"> - <table class="compat-table"> - <tbody> - <tr> - <th>Возможность</th> - <th>Android</th> - <th>Chrome для Android</th> - <th>Firefox Mobile (Gecko)</th> - <th>IE Mobile</th> - <th>Opera Mobile</th> - <th>Safari Mobile</th> - </tr> - <tr> - <td>Базовая поддержка</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - </tr> - </tbody> - </table> -</div> - -<h2 id="See_also" name="See_also">Смотрите также</h2> -<ul> - <li>Глава про <a href="/ru/docs/Web/JavaScript/Guide/Regular_Expressions">регулярные выражения</a> в <a href="/ru/docs/Web/JavaScript/Guide">руководстве по JavaScript</a></li> - <li>{{jsxref("Global_Objects/RegExp", "RegExp")}}</li> - <li>{{jsxref("Function.prototype")}}</li> -</ul> diff --git a/files/ru/conflicting/web/javascript/reference/global_objects/set/index.html b/files/ru/conflicting/web/javascript/reference/global_objects/set/index.html deleted file mode 100644 index 6609e026ae..0000000000 --- a/files/ru/conflicting/web/javascript/reference/global_objects/set/index.html +++ /dev/null @@ -1,82 +0,0 @@ ---- -title: Set.prototype -slug: conflicting/Web/JavaScript/Reference/Global_Objects/Set -translation_of: Web/JavaScript/Reference/Global_Objects/Set -translation_of_original: Web/JavaScript/Reference/Global_Objects/Set/prototype -original_slug: Web/JavaScript/Reference/Global_Objects/Set/prototype ---- -<div>{{JSRef}}</div> - -<p>The <code><strong>Set</strong></code><strong><code>.prototype</code></strong> property represents the prototype for the {{jsxref("Set")}} constructor.</p> - -<div>{{js_property_attributes(0,0,0)}}</div> - -<h2 id="Description">Description</h2> - -<p>{{jsxref("Set")}} instances inherit from {{jsxref("Set.prototype")}}. You can use the constructor's prototype object to add properties or methods to all <code>Set</code> instances.</p> - -<h2 id="Свойства">Свойства</h2> - -<dl> - <dt><code>Set.prototype.constructor</code></dt> - <dd>Возвращает функцию, которая создала прототип экземпляра. Это функция {{jsxref("Set")}} по умолчанию.</dd> - <dt>{{jsxref("Set.prototype.size")}}</dt> - <dd>Возвращает количество элементов в объекте <code>Set</code>.</dd> -</dl> - -<h2 id="Методы">Методы</h2> - -<dl> - <dt>{{jsxref("Set.add", "Set.prototype.add(value)")}}</dt> - <dd>Добавляет новый элемент с переданным значением в <code>Set</code> объект. Возвращает <code>Set</code> объект.</dd> - <dt>{{jsxref("Set.prototype.clear()")}}</dt> - <dd>Removes all elements from the <code>Set</code> object.</dd> - <dt>{{jsxref("Set.delete", "Set.prototype.delete(value)")}}</dt> - <dd>Removes the element associated to the <code>value</code> and returns the value that <code>Set.prototype.has(value)</code> would have previously returned. <code>Set.prototype.has(value)</code> will return <code>false</code> afterwards.</dd> - <dt>{{jsxref("Set.prototype.entries()")}}</dt> - <dd>Returns a new <code>Iterator</code> object that contains<strong> an array of <code>[value, value]</code></strong> for each element in the <code>Set</code> object, in insertion order. This is kept similar to the <code>Map</code> object, so that each entry has the same value for its <em>key</em> and <em>value</em> here.</dd> - <dt>{{jsxref("Set.forEach", "Set.prototype.forEach(callbackFn[, thisArg])")}}</dt> - <dd>Calls <code>callbackFn</code> once for each value present in the <code>Set</code> object, in insertion order. If a <code>thisArg</code> parameter is provided to <code>forEach</code>, it will be used as the <code>this</code> value for each callback.</dd> - <dt>{{jsxref("Set.has", "Set.prototype.has(value)")}}</dt> - <dd>Returns a boolean asserting whether an element is present with the given value in the <code>Set</code> object or not.</dd> - <dt>{{jsxref("Set.prototype.keys()")}}</dt> - <dd>Is the same function as the <strong><code>values()</code></strong> function and returns a new <code>Iterator</code> object that contains the values for each element in the <code>Set</code> object in insertion order.</dd> - <dt>{{jsxref("Set.prototype.values()")}}</dt> - <dd>Returns a new <code>Iterator</code> object that contains the <strong>values</strong> for each element in the <code>Set</code> object in insertion order.</dd> - <dt>{{jsxref("Set.prototype.@@iterator()", "Set.prototype[@@iterator]()")}}</dt> - <dd>Returns a new <code>Iterator</code> object that contains the <strong>values</strong> for each element in the <code>Set</code> object in insertion order.</dd> -</dl> - -<h2 id="Specifications">Specifications</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Specification</th> - <th scope="col">Status</th> - <th scope="col">Comment</th> - </tr> - <tr> - <td>{{SpecName('ES2015', '#sec-set.prototype', 'Set.prototype')}}</td> - <td>{{Spec2('ES2015')}}</td> - <td>Initial definition.</td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-set.prototype', 'Set.prototype')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td></td> - </tr> - </tbody> -</table> - -<h2 id="Browser_compatibility">Browser compatibility</h2> - - - -<p>{{Compat("javascript.builtins.Set.prototype")}}</p> - -<h2 id="See_also">See also</h2> - -<ul> - <li>{{jsxref("Map.prototype")}}</li> -</ul> diff --git a/files/ru/conflicting/web/javascript/reference/global_objects/string/index.html b/files/ru/conflicting/web/javascript/reference/global_objects/string/index.html deleted file mode 100644 index f0de3d5413..0000000000 --- a/files/ru/conflicting/web/javascript/reference/global_objects/string/index.html +++ /dev/null @@ -1,231 +0,0 @@ ---- -title: String.prototype -slug: conflicting/Web/JavaScript/Reference/Global_Objects/String -tags: - - JavaScript - - Property - - Prototype - - Reference - - String -translation_of: Web/JavaScript/Reference/Global_Objects/String -translation_of_original: Web/JavaScript/Reference/Global_Objects/String/prototype -original_slug: Web/JavaScript/Reference/Global_Objects/String/prototype ---- -<div>{{JSRef("Global_Objects", "String")}}</div> - -<h2 id="Summary" name="Summary">Сводка</h2> - -<p>Свойство <strong><code>String.prototype</code></strong> представляет прототип объекта {{jsxref("Global_Objects/String", "String")}}.</p> - -<div>{{js_property_attributes(0, 0, 0)}}</div> - -<h2 id="Description" name="Description">Описание</h2> - -<p>Все объекты {{jsxref("Global_Objects/String", "String")}} наследуются от <code>String.prototype</code>. Изменения в прототипе объекта {{jsxref("Global_Objects/String", "String")}} распространяются на все его экземпляры.</p> - -<h2 id="Properties" name="Properties">Свойства</h2> - -<dl> - <dt><code>String.prototype.constructor</code></dt> - <dd>Определяет функцию, создающую прототип этого объекта.</dd> - <dt>{{jsxref("String.prototype.length")}}</dt> - <dd>Отражает длину строки.</dd> - <dt><code><em>N</em></code></dt> - <dd>Используется для доступа к символу в позиции <em>N</em>, где <em>N</em> — это целое число между 0 и длиной строки {{jsxref("String.length", "length")}} минус один. Эти свойства доступны только для чтения.</dd> -</dl> - -<h2 id="Methods" name="Methods">Методы</h2> - -<h3 id="Methods_unrelated_to_HTML" name="Methods_unrelated_to_HTML">Методы, не относящиеся к HTML</h3> - -<dl> - <dt>{{jsxref("String.prototype.charAt()")}}</dt> - <dd>Возвращает символ по указанному индексу.</dd> - <dt>{{jsxref("String.prototype.charCodeAt()")}}</dt> - <dd>Возвращает число, представляющее значение символа в Юникоде по указанному индексу.</dd> - <dt>{{jsxref("String.prototype.codePointAt()")}} {{experimental_inline}}</dt> - <dd>Возвращает неотрицательное целое число, представляющее закодированную в UTF-16 кодовую точку значения по указанной позиции.</dd> - <dt>{{jsxref("String.prototype.concat()")}}</dt> - <dd>Объединяет текст двух строк и возвращает новую строку.</dd> - <dt>{{jsxref("String.prototype.includes()")}} {{experimental_inline}}</dt> - <dd>Определяет, находится ли строка внутри другой строки.</dd> - <dt>{{jsxref("String.prototype.endsWith()")}} {{experimental_inline}}</dt> - <dd>Определяет, заканчивается ли строка символами другой строки.</dd> - <dt>{{jsxref("String.prototype.indexOf()")}}</dt> - <dd>Возвращает индекс первого вхождения указанного значения в объекте {{jsxref("Global_Objects/String", "String")}}, на котором был вызван этот метод, или -1, если вхождений нет.</dd> - <dt>{{jsxref("String.prototype.lastIndexOf()")}}</dt> - <dd>Возвращает индекс последнего вхождения указанного значения в объекте {{jsxref("Global_Objects/String", "String")}}, на котором был вызван этот метод, или -1, если вхождений нет.</dd> - <dt>{{jsxref("String.prototype.localeCompare()")}}</dt> - <dd>Возвращает число, указывающее, находится ли образцовая строка до, после или на том же самом месте, что и указанная строка в порядке сортировки.</dd> - <dt>{{jsxref("String.prototype.match()")}}</dt> - <dd>Используется для сопоставления строке регулярного выражения.</dd> -</dl> - -<dl> - <dt>{{jsxref("String.prototype.matchAll()")}}</dt> - <dd>Возвращает итератор по всем результатам при сопоставлении строки с регулярным выражением.</dd> -</dl> - -<dl> - <dt>{{jsxref("String.prototype.normalize()")}} {{experimental_inline}}</dt> - <dd>Возвращает форму нормализации Юникода для строкового значения.</dd> - <dt><s class="obsoleteElement">{{jsxref("String.prototype.quote()")}} {{obsolete_inline}}</s></dt> - <dd><s class="obsoleteElement">Оборачивает строку в двойные кавычки ("<code>"</code>").</s></dd> - <dt>{{jsxref("String.prototype.repeat()")}} {{experimental_inline}}</dt> - <dd>Возвращает строку. состоящую из элементов объекта, повторённых указанное количество раз.</dd> - <dt>{{jsxref("String.prototype.replace()")}}</dt> - <dd>Используется для сопоставления строке регулярного выражения и для замены совпавшей подстроки на новую подстроку.</dd> - <dt>{{jsxref("String.prototype.search()")}}</dt> - <dd>Выполняет поиск совпадения регулярного выражения со строкой.</dd> - <dt>{{jsxref("String.prototype.slice()")}}</dt> - <dd>Извлекает часть строки и возвращает новую строку.</dd> - <dt>{{jsxref("String.prototype.split()")}}</dt> - <dd>Разбивает объект {{jsxref("Global_Objects/String", "String")}} на массив строк, разделённых указанной строкой на подстроки.</dd> - <dt>{{jsxref("String.prototype.startsWith()")}} {{experimental_inline}}</dt> - <dd>Определяет, начинается ли строка символами другой строки.</dd> - <dt>{{jsxref("String.prototype.substr()")}}</dt> - <dd>Возвращает указанное количество символов в строке, начинающихся с указанной позиции.</dd> - <dt>{{jsxref("String.prototype.substring()")}}</dt> - <dd>Возвращает символы в строке между двумя индексами.</dd> - <dt>{{jsxref("String.prototype.toLocaleLowerCase()")}}</dt> - <dd>Приводит символы в строке к нижнему регистру согласно текущей локали. Для большинства языков, метод делает то же самое, что и метод {{jsxref("String.prototype.toLowerCase()", "toLowerCase()")}}.</dd> - <dt>{{jsxref("String.prototype.toLocaleUpperCase()")}}</dt> - <dd>Приводит символы в строке к верхнему регистру согласно текущей локали. Для большинства языков, метод делает то же самое, что и метод {{jsxref("String.prototype.toUpperCase()", "toUpperCase()")}}.</dd> - <dt>{{jsxref("String.prototype.toLowerCase()")}}</dt> - <dd>Возвращает строковое значение с символами в нижнем регистре.</dd> - <dt>{{jsxref("String.prototype.toSource()")}} {{non-standard_inline}}</dt> - <dd>Возвращает литерал объекта, представляющий указанный объект; вы можете использовать это значение для создания нового объекта. Переопределяет метод {{jsxref("Object.prototype.toSource()")}}.</dd> - <dt>{{jsxref("String.prototype.toString()")}}</dt> - <dd>Возвращает строковое представление указанного объекта. Переопределяет метод {{jsxref("Object.prototype.toString()")}}.</dd> - <dt>{{jsxref("String.prototype.toUpperCase()")}}</dt> - <dd>Возвращает строковое значение с символами в верхнем регистре.</dd> - <dt>{{jsxref("String.prototype.trim()")}}</dt> - <dd>Обрезает пробельные символы в начале и в конце строки. Часть стандарта ECMAScript 5.</dd> - <dt>{{jsxref("String.prototype.trimLeft()")}} {{non-standard_inline}}</dt> - <dd>Обрезает пробельные символы с левой стороны строки.</dd> - <dt>{{jsxref("String.prototype.trimRight()")}} {{non-standard_inline}}</dt> - <dd>Обрезает пробельные символы с правой стороны строки.</dd> - <dt>{{jsxref("String.prototype.valueOf()")}}</dt> - <dd>Возвращает примитивное значение указанного объекта. Переопределяет метод {{jsxref("Object.prototype.valueOf()")}}.</dd> - <dt>{{jsxref("String.prototype.@@iterator()", "String.prototype[@@iterator]()")}} {{experimental_inline}}</dt> - <dd>Возвращает новый объект итератора <code>Iterator</code>, который итерируется по кодовым точкам строки и возвращает каждую кодовую точку в виде строкового значения.</dd> -</dl> - -<h3 id="HTML_wrapper_methods" name="HTML_wrapper_methods">Методы-обёртки HTML</h3> - -<p>Эти методы имеют ограниченное применение, поскольку они представляют только ограниченное подмножество доступных тегов и атрибутов HTML.</p> - -<dl> - <dt>{{jsxref("String.prototype.anchor()")}} {{deprecated_inline}}</dt> - <dd><code><a href="/ru/docs/Web/HTML/Element/a#attr-name"><a name="<em>имя</em>"></a></code> (цель гипертекста)</dd> - <dt>{{jsxref("String.prototype.big()")}} {{deprecated_inline}}</dt> - <dd>{{HTMLElement("big")}}</dd> - <dt>{{jsxref("String.prototype.blink()")}} {{deprecated_inline}}</dt> - <dd>{{HTMLElement("blink")}}</dd> - <dt>{{jsxref("String.prototype.bold()")}} {{deprecated_inline}}</dt> - <dd>{{HTMLElement("b")}}</dd> - <dt>{{jsxref("String.prototype.fixed()")}} {{deprecated_inline}}</dt> - <dd>{{HTMLElement("tt")}}</dd> - <dt>{{jsxref("String.prototype.fontcolor()")}} {{deprecated_inline}}</dt> - <dd><a href="/ru/docs/Web/HTML/Element/font#attr-color"><code><font color="<em>цвет</em>"></code></a></dd> - <dt>{{jsxref("String.prototype.fontsize()")}} {{deprecated_inline}}</dt> - <dd><a href="/ru/docs/Web/HTML/Element/font#attr-size"><code><font size="<em>размер</em>"></code></a></dd> - <dt>{{jsxref("String.prototype.italics()")}} {{deprecated_inline}}</dt> - <dd>{{HTMLElement("i")}}</dd> - <dt>{{jsxref("String.prototype.link()")}} {{deprecated_inline}}</dt> - <dd><a href="/ru/docs/Web/HTML/Element/a#attr-href"><code><a href="<em>url</em>"></code></a> (ссылка на URL)</dd> - <dt>{{jsxref("String.prototype.small()")}} {{deprecated_inline}}</dt> - <dd>{{HTMLElement("small")}}</dd> - <dt>{{jsxref("String.prototype.strike()")}} {{deprecated_inline}}</dt> - <dd>{{HTMLElement("strike")}}</dd> - <dt>{{jsxref("String.prototype.sub()")}} {{deprecated_inline}}}</dt> - <dd>{{HTMLElement("sub")}}</dd> - <dt>{{jsxref("String.prototype.sup()")}} {{deprecated_inline}}</dt> - <dd>{{HTMLElement("sup")}}</dd> -</dl> - -<h2 id="Specifications" name="Specifications">Спецификации</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Спецификация</th> - <th scope="col">Статус</th> - <th scope="col">Комментарии</th> - </tr> - <tr> - <td>ECMAScript 1-е издание.</td> - <td>Стандарт</td> - <td>Изначальное определение.</td> - </tr> - <tr> - <td>{{SpecName('ES5.1', '#sec-15.5.3.1', 'String.prototype')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td></td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-string.prototype', 'String.prototype')}}</td> - <td>{{Spec2('ES6')}}</td> - <td></td> - </tr> - </tbody> -</table> - -<h2 id="Browser_compatibility" name="Browser_compatibility">Совместимость с браузерами</h2> - -<div>{{CompatibilityTable}}</div> - -<div id="compat-desktop"> -<table class="compat-table"> - <tbody> - <tr> - <th>Возможность</th> - <th>Chrome</th> - <th>Firefox (Gecko)</th> - <th>Internet Explorer</th> - <th>Opera</th> - <th>Safari</th> - </tr> - <tr> - <td>Базовая поддержка</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - </tr> - </tbody> -</table> -</div> - -<div id="compat-mobile"> -<table class="compat-table"> - <tbody> - <tr> - <th>Возможность</th> - <th>Android</th> - <th>Chrome для Android</th> - <th>Firefox Mobile (Gecko)</th> - <th>IE Mobile</th> - <th>Opera Mobile</th> - <th>Safari Mobile</th> - </tr> - <tr> - <td>Базовая поддержка</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - </tr> - </tbody> -</table> -</div> - -<h2 id="See_also" name="See_also">Смотрите также</h2> - -<ul> - <li>{{jsxref("Global_Objects/String", "String")}}</li> - <li>{{jsxref("Function.prototype")}}</li> -</ul> diff --git a/files/ru/conflicting/web/javascript/reference/global_objects/symbol/index.html b/files/ru/conflicting/web/javascript/reference/global_objects/symbol/index.html deleted file mode 100644 index 9da7ee5440..0000000000 --- a/files/ru/conflicting/web/javascript/reference/global_objects/symbol/index.html +++ /dev/null @@ -1,108 +0,0 @@ ---- -title: Symbol.prototype -slug: conflicting/Web/JavaScript/Reference/Global_Objects/Symbol -tags: - - ECMAScript6 - - JavaScript - - Свойство - - Символы -translation_of: Web/JavaScript/Reference/Global_Objects/Symbol -translation_of_original: Web/JavaScript/Reference/Global_Objects/Symbol/prototype -original_slug: Web/JavaScript/Reference/Global_Objects/Symbol/prototype ---- -<div>{{JSRef}}</div> - -<p>Свойство <code><strong>Symbol</strong></code><strong><code>.prototype</code></strong> указывает на прототип конструктора {{jsxref("Symbol")}}.</p> - -<div>{{js_property_attributes(0,0,0)}}</div> - -<h2 id="Описание">Описание</h2> - -<p>Экземпляры типа {{jsxref("Symbol")}} наследуют {{jsxref("Symbol.prototype")}}. Вы можете использовать прототип конструктора, чтобы добавить свойства и методы ко всем экземплярам типа <code>Symbol</code>.</p> - -<h2 id="Свойства">Свойства</h2> - -<dl> - <dt><code>Symbol.prototype.constructor</code></dt> - <dd>Указывает на функцию, создавшую прототип экземпляра. По умолчанию это функция {{jsxref("Symbol")}}.</dd> -</dl> - -<h2 id="Методы">Методы</h2> - -<dl> - <dt>{{jsxref("Symbol.prototype.toSource()")}} {{Non-standard_inline}}</dt> - <dd>Возвращает строку, содержащую исходный код объекта {{jsxref("Global_Objects/Symbol", "Symbol")}}. Перегружает метод {{jsxref("Object.prototype.toSource()")}}.</dd> - <dt>{{jsxref("Symbol.prototype.toString()")}}</dt> - <dd>Возвращает строку, содержащую описание символа. Перегружает метод {{jsxref("Object.prototype.toString()")}}.</dd> - <dt>{{jsxref("Symbol.prototype.valueOf()")}}</dt> - <dd>Возвращает примитивное значение объекта {{jsxref("Symbol")}}. Перегружает метод {{jsxref("Object.prototype.valueOf()")}}.</dd> -</dl> - -<h2 id="Спецификации">Спецификации</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Спецификация</th> - <th scope="col">Статус</th> - <th scope="col">Комментарий</th> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-symbol.prototype', 'Symbol.prototype')}}</td> - <td>{{Spec2('ES6')}}</td> - <td>Изначальное определение.</td> - </tr> - </tbody> -</table> - -<h2 id="Поддержка_браузерами">Поддержка браузерами</h2> - -<p>{{CompatibilityTable}}</p> - -<div id="compat-desktop"> -<table class="compat-table"> - <tbody> - <tr> - <th>Возможность</th> - <th>Chrome</th> - <th>Firefox (Gecko)</th> - <th>Internet Explorer</th> - <th>Opera</th> - <th>Safari</th> - </tr> - <tr> - <td>Базовая поддержка</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{ CompatGeckoDesktop("36.0") }}</td> - <td>{{CompatNo}}</td> - <td>{{CompatNo}}</td> - <td>{{CompatNo}}</td> - </tr> - </tbody> -</table> -</div> - -<div id="compat-mobile"> -<table class="compat-table"> - <tbody> - <tr> - <th>Возможность</th> - <th>Android</th> - <th>Chrome for Android</th> - <th>Firefox Mobile (Gecko)</th> - <th>IE Mobile</th> - <th>Opera Mobile</th> - <th>Safari Mobile</th> - </tr> - <tr> - <td>Базовая поддержка</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{ CompatGeckoMobile("36.0") }}</td> - <td>{{CompatNo}}</td> - <td>{{CompatNo}}</td> - <td>{{CompatNo}}</td> - </tr> - </tbody> -</table> -</div> diff --git a/files/ru/conflicting/web/javascript/reference/global_objects/syntaxerror/index.html b/files/ru/conflicting/web/javascript/reference/global_objects/syntaxerror/index.html deleted file mode 100644 index 20340178e9..0000000000 --- a/files/ru/conflicting/web/javascript/reference/global_objects/syntaxerror/index.html +++ /dev/null @@ -1,124 +0,0 @@ ---- -title: SyntaxError.prototype -slug: conflicting/Web/JavaScript/Reference/Global_Objects/SyntaxError -tags: - - Error - - JavaScript - - Property - - Prototype - - SyntaxError -translation_of: Web/JavaScript/Reference/Global_Objects/SyntaxError -translation_of_original: Web/JavaScript/Reference/Global_Objects/SyntaxError/prototype -original_slug: Web/JavaScript/Reference/Global_Objects/SyntaxError/prototype ---- -<div>{{JSRef("Global_Objects", "Error", "EvalError,InternalError,RangeError,ReferenceError,SyntaxError,TypeError,URIError")}}</div> - -<h2 id="Summary" name="Summary">Сводка</h2> -<p>Свойство <code><strong>SyntaxError.prototype</strong></code> представляет прототип конструктора объекта {{jsxref("SyntaxError")}}.</p> - -<div>{{js_property_attributes(0, 0, 0)}}</div> - -<h2 id="Description" name="Description">Описание</h2> -<p>Все экземпляры {{jsxref("SyntaxError")}} наследуются от объекта <code>SyntaxError.prototype</code>. Вы можете использовать прототип для добавления свойств или методов ко всем экземплярам.</p> - -<h2 id="Properties" name="Properties">Свойства</h2> -<dl> - <dt><code>SyntaxError.prototype.constructor</code></dt> - <dd>Определяет функцию, создающую прототип экземпляра.</dd> - <dt>{{jsxref("Error.prototype.message", "SyntaxError.prototype.message")}}</dt> - <dd>Сообщение ошибки. Хотя стандарт ECMA-262 определяет, что {{jsxref("SyntaxError")}} должен предоставлять своё собственное свойство <code>message</code>, в <a href="/ru/docs/Mozilla/Projects/SpiderMonkey">SpiderMonkey</a> он наследует свойство {{jsxref("Error.prototype.message")}}.</dd> - <dt>{{jsxref("Error.prototype.name", "SyntaxError.prototype.name")}}</dt> - <dd>Название ошибки. Унаследовано от {{jsxref("Error")}}.</dd> - <dt>{{jsxref("Error.prototype.fileName", "SyntaxError.prototype.fileName")}}</dt> - <dd>Путь к файлу, в котором возникла эта ошибка. Унаследовано от {{jsxref("Error")}}.</dd> - <dt>{{jsxref("Error.prototype.lineNumber", "SyntaxError.prototype.lineNumber")}}</dt> - <dd>Номер строки в файле, в котором возникла эта ошибка. Унаследовано от {{jsxref("Error")}}.</dd> - <dt>{{jsxref("Error.prototype.columnNumber", "SyntaxError.prototype.columnNumber")}}</dt> - <dd>Номер колонки в строке, на которой возникла эта ошибка. Унаследовано от {{jsxref("Error")}}.</dd> - <dt>{{jsxref("Error.prototype.stack", "SyntaxError.prototype.stack")}}</dt> - <dd>Стек вызовов. Унаследовано от {{jsxref("Error")}}.</dd> -</dl> - -<h2 id="Methods" name="Methods">Методы</h2> -<p>Хотя объект прототипа {{jsxref("SyntaxError")}} не содержит собственных методов, экземпляры {{jsxref("SyntaxError")}} наследуют некоторые методы из цепочки прототипов.</p> - -<h2 id="Specifications" name="Specifications">Спецификации</h2> -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Спецификация</th> - <th scope="col">Статус</th> - <th scope="col">Комментарии</th> - </tr> - <tr> - <td>ECMAScript 3-е издание.</td> - <td>Стандарт</td> - <td>Изначальное определение.</td> - </tr> - <tr> - <td>{{SpecName('ES5.1', '#sec-15.11.7.6', 'NativeError.prototype')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td>Определено как <code><em>NativeError</em>.prototype</code>.</td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-nativeerror.prototype', 'NativeError.prototype')}}</td> - <td>{{Spec2('ES6')}}</td> - <td>Определено как <code><em>NativeError</em>.prototype</code>.</td> - </tr> - </tbody> -</table> - -<h2 id="Browser_compatibility" name="Browser_compatibility">Совместимость с браузерами</h2> -<div>{{CompatibilityTable}}</div> -<div id="compat-desktop"> - <table class="compat-table"> - <tbody> - <tr> - <th>Возможность</th> - <th>Chrome</th> - <th>Firefox (Gecko)</th> - <th>Internet Explorer</th> - <th>Opera</th> - <th>Safari</th> - </tr> - <tr> - <td>Базовая поддержка</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - </tr> - </tbody> - </table> -</div> -<div id="compat-mobile"> - <table class="compat-table"> - <tbody> - <tr> - <th>Возможность</th> - <th>Android</th> - <th>Chrome для Android</th> - <th>Firefox Mobile (Gecko)</th> - <th>IE Mobile</th> - <th>Opera Mobile</th> - <th>Safari Mobile</th> - </tr> - <tr> - <td>Базовая поддержка</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - </tr> - </tbody> - </table> -</div> - -<h2 id="See_also" name="See_also">Смотрите также</h2> -<ul> - <li>{{jsxref("Error.prototype")}}</li> - <li>{{jsxref("Function.prototype")}}</li> -</ul> diff --git a/files/ru/conflicting/web/javascript/reference/global_objects/typedarray/index.html b/files/ru/conflicting/web/javascript/reference/global_objects/typedarray/index.html deleted file mode 100644 index d5ce10fc9f..0000000000 --- a/files/ru/conflicting/web/javascript/reference/global_objects/typedarray/index.html +++ /dev/null @@ -1,127 +0,0 @@ ---- -title: TypedArray.prototype -slug: conflicting/Web/JavaScript/Reference/Global_Objects/TypedArray -tags: - - TypedArray - - Типизированный массив -translation_of: Web/JavaScript/Reference/Global_Objects/TypedArray -translation_of_original: Web/JavaScript/Reference/Global_Objects/TypedArray/prototype -original_slug: Web/JavaScript/Reference/Global_Objects/TypedArray/prototype ---- -<div>{{JSRef}}</div> - -<p><code><strong>Свойство TypedArray</strong></code><strong><code>.prototype</code></strong> является прототипом для {{jsxref("TypedArray")}}-конструкторов.</p> - -<div>{{js_property_attributes(0,0,0)}}</div> - -<h2 id="Описание">Описание</h2> - -<p>Экземпляры {{jsxref("TypedArray")}} наследуются от {{jsxref("TypedArray.prototype")}}. Вы можете использовать объект прототипа конструктора для добавления в свойств и методов во все экземпляры <em>TypedArray</em>, где <em>TypedArray</em> это один из <a href="/ru/docs/Web/JavaScript/Reference/Global_Objects/TypedArray#TypedArray_objects">типизированных массивов</a>.</p> - -<p>Также смотрите описание <a href="/ru/docs/Web/JavaScript/Reference/Global_Objects/TypedArray#Description"><em>TypedArray</em></a> для детальной информации о наследниках.</p> - -<h2 id="Свойства"><a id="Properties" name="Properties">Свойства</a></h2> - -<dl> - <dt><code>TypedArray.prototype.constructor</code></dt> - <dd>Возвращает функцию, которая создала прототип экземпляра. Это единственное, что для объектов <a href="/ru/docs/Web/JavaScript/Reference/Global_Objects/TypedArray#TypedArray_objects">типизированных массивов</a> функционирует по умолчанию.</dd> - <dt>{{jsxref("TypedArray.prototype.buffer")}} {{readonlyInline}}</dt> - <dd>Возвращает {{jsxref("ArrayBuffer")}}, на который ссылается типизированный массив. Значение фиксировано с времени создания и доступно <strong>только для чтения</strong>.</dd> - <dt>{{jsxref("TypedArray.prototype.byteLength")}} {{readonlyInline}}</dt> - <dd>Возвращает длину (в байтах) типизированного массива (с начала {{jsxref("ArrayBuffer")}}). Значение фиксировано с времени создания и доступно <strong>только для чтения</strong>.</dd> - <dt>{{jsxref("TypedArray.prototype.byteOffset")}} {{readonlyInline}}</dt> - <dd>Возвращает смещение (в байтах) типизированного массива от его {{jsxref("ArrayBuffer")}}. Значение фиксировано с времени создания и доступно <strong>только для чтения</strong>.</dd> - <dt>{{jsxref("TypedArray.prototype.length")}} {{readonlyInline}}</dt> - <dd>Возвращает число элементов типизированного массива. Значение фиксировано с времени создания и доступно <strong>только для чтения</strong>.</dd> -</dl> - -<h2 id="Методы"><a id="Methods" name="Methods">Методы</a></h2> - -<dl> - <dt>{{jsxref("TypedArray.prototype.copyWithin()")}}</dt> - <dd>Копирует последовательность элементов массива внутри него. Подробнее {{jsxref("Array.prototype.copyWithin()")}}.</dd> - <dt>{{jsxref("TypedArray.prototype.entries()")}}</dt> - <dd>Возвращает новый объект итератора <code><strong>Array Iterator</strong></code>, содержащий пары ключ / значение для каждого индекса массива. Подробнее {{jsxref("Array.prototype.entries()")}}.</dd> - <dt>{{jsxref("TypedArray.prototype.every()")}}</dt> - <dd>Проверяет, удовлетворяют ли все элементы массива условию, заданному в передаваемой функции. Подробнее {{jsxref("Array.prototype.every()")}}.</dd> - <dt>{{jsxref("TypedArray.prototype.fill()")}}</dt> - <dd>Заполняет все элементы массива от начального индекса до конечного индекса указанным значением. Подробнее {{jsxref("Array.prototype.fill()")}}.</dd> - <dt>{{jsxref("TypedArray.prototype.filter()")}}</dt> - <dd>Создаёт новый массив с теми элементами текущего массива, с которыми фильтрующая функция вернёт <code>true</code>. Подробнее {{jsxref("Array.prototype.filter()")}}.</dd> - <dt>{{jsxref("TypedArray.prototype.find()")}}</dt> - <dd>Возвращает значение элемента массива, если элемент удовлетворяет условию проверяющей функции, иначе возвращается <a href="https://developer.mozilla.org/ru/docs/Web/JavaScript/Reference/Global_Objects/undefined" title="Значение глобального свойства undefined представляет значение undefined. Это одно из примитивных значений JavaScript."><code>undefined</code></a>. Подробнее {{jsxref("Array.prototype.find()")}}.</dd> - <dt>{{jsxref("TypedArray.prototype.findIndex()")}}</dt> - <dd>Возвращает индекс элемента массива, если элемент удовлетворяет условию проверяющей функции, иначе возвращается -1. Подробнее {{jsxref("Array.prototype.findIndex()")}}.</dd> - <dt>{{jsxref("TypedArray.prototype.forEach()")}}</dt> - <dd>Выполняет указанную функцию один раз для каждого элемента в массиве. Подробнее {{jsxref("Array.prototype.forEach()")}}.</dd> - <dt>{{jsxref("TypedArray.prototype.includes()")}} {{experimental_inline}}</dt> - <dd>Определяет, содержит ли массив определённый элемент, возвращая в зависимости от этого <code>true</code> или <code>false</code>. Подробнее {{jsxref("Array.prototype.includes()")}}.</dd> - <dt>{{jsxref("TypedArray.prototype.indexOf()")}}</dt> - <dd>Возвращает первый (меньший) индекс элемента, значение которого равно указанному значению или -1, если такого индекса нет. Подробнее {{jsxref("Array.prototype.indexOf()")}}.</dd> - <dt>{{jsxref("TypedArray.prototype.join()")}}</dt> - <dd>Объединяет все элементы массива в строку . Подробнее {{jsxref("Array.prototype.join()")}}.</dd> - <dt>{{jsxref("TypedArray.prototype.keys()")}}</dt> - <dd>Возвращает новый итератор массива <code><strong>Array Iterator</strong></code>, содержащий ключи каждого индекса в массиве. Подробнее {{jsxref("Array.prototype.keys()")}}.</dd> - <dt>{{jsxref("TypedArray.prototype.lastIndexOf()")}}</dt> - <dd>Возвращает последний (больший) индекс элемента, значение которого равно заданному значению или -1, если такого индекса нет. Подробнее {{jsxref("Array.prototype.lastIndexOf()")}}.</dd> - <dt>{{jsxref("TypedArray.prototype.map()")}}</dt> - <dd>Создаёт новый массив с результатом вызова указанной функции для каждого элемента массива. Подробнее {{jsxref("Array.prototype.map()")}}.</dd> - <dt>{{jsxref("TypedArray.prototype.move()")}} {{non-standard_inline}} {{unimplemented_inline}}</dt> - <dd>Ранний нестандартный вариант от {{jsxref("TypedArray.prototype.copyWithin()")}}.</dd> - <dt>{{jsxref("TypedArray.prototype.reduce()")}}</dt> - <dd>Применяет функцию к аккумулятору и каждому значению массива (слева-направо), сводя его к одному значению. Подробнее {{jsxref("Array.prototype.reduce()")}}.</dd> - <dt>{{jsxref("TypedArray.prototype.reduceRight()")}}</dt> - <dd>Применяет функцию к аккумулятору и каждому значению массива (справа-налево), сводя его к одному значению. Подробнее {{jsxref("Array.prototype.reduceRight()")}}.</dd> - <dt>{{jsxref("TypedArray.prototype.reverse()")}}</dt> - <dd>Обращает порядок следования элементов массива. Первый элемент массива становится последним, а последний — первым. Подробнее {{jsxref("Array.prototype.reverse()")}}.</dd> - <dt>{{jsxref("TypedArray.prototype.set()")}}</dt> - <dd>Сохраняет несколько значений в типизированном массиве, получая входные значения из указанного массива.</dd> - <dt>{{jsxref("TypedArray.prototype.slice()")}}</dt> - <dd>Возвращает часть массива в новый объект массива. Подробнее {{jsxref("Array.prototype.slice()")}}.</dd> - <dt>{{jsxref("TypedArray.prototype.some()")}}</dt> - <dd>Возвращает <code>true</code>, если хоть какой-нибудь элемент массива удовлетворяет условию, заданному в передаваемой функции. Подробнее {{jsxref("Array.prototype.some()")}}.</dd> - <dt>{{jsxref("TypedArray.prototype.sort()")}}</dt> - <dd>На месте сортирует элементы массива и возвращает отсортированный массив. Подробнее {{jsxref("Array.prototype.sort()")}}.</dd> - <dt>{{jsxref("TypedArray.prototype.subarray()")}}</dt> - <dd>Возвращает новый <code>TypedArray</code>-объект, начиная с указанного стартового и кончая указанным конечным индексом элемента массива.</dd> - <dt>{{jsxref("TypedArray.prototype.values()")}}</dt> - <dd>Возвращает новый объект итератора массива <strong><code>Array Iterator</code></strong>, содержащий значения для каждого индекса в массиве. Подробнее {{jsxref("Array.prototype.values()")}}.</dd> - <dt>{{jsxref("TypedArray.prototype.toLocaleString()")}}</dt> - <dd>Возвращает локализованное строковое представление элементов массива. Подробнее {{jsxref("Array.prototype.toLocaleString()")}}.</dd> - <dt>{{jsxref("TypedArray.prototype.toString()")}}</dt> - <dd>Возвращает строковое представление указанного массива и его элементов . Подробнее {{jsxref("Array.prototype.toString()")}}.</dd> - <dt>{{jsxref("TypedArray.prototype.@@iterator()", "TypedArray.prototype[@@iterator]()")}}</dt> - <dd>Возвращает новый объект итератора массива <strong><code>Array Iterator</code></strong>, содержащий значения для каждого индекса массива.</dd> -</dl> - -<h2 id="Спецификации">Спецификации</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Спецификация</th> - <th scope="col">Статус</th> - <th scope="col">Описание</th> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-properties-of-the-%typedarrayprototype%-object', 'TypedArray prototype')}}</td> - <td>{{Spec2('ES6')}}</td> - <td>Первоначальное определение</td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-properties-of-the-%typedarrayprototype%-object', 'TypedArray prototype')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Совместимость_браузеров">Совместимость браузеров</h2> -<p>{{Compat("javascript.builtins.TypedArray.prototype")}}</p> - -<h2 id="Смотрите_также">Смотрите также</h2> - -<ul> - <li><a href="/en-US/docs/Web/JavaScript/Typed_arrays">JavaScript typed arrays</a></li> - <li>{{jsxref("TypedArray")}}</li> -</ul> diff --git a/files/ru/conflicting/web/javascript/reference/global_objects/typeerror/index.html b/files/ru/conflicting/web/javascript/reference/global_objects/typeerror/index.html deleted file mode 100644 index 0c83655781..0000000000 --- a/files/ru/conflicting/web/javascript/reference/global_objects/typeerror/index.html +++ /dev/null @@ -1,124 +0,0 @@ ---- -title: TypeError.prototype -slug: conflicting/Web/JavaScript/Reference/Global_Objects/TypeError -tags: - - Error - - JavaScript - - Property - - Prototype - - TypeError -translation_of: Web/JavaScript/Reference/Global_Objects/TypeError -translation_of_original: Web/JavaScript/Reference/Global_Objects/TypeError/prototype -original_slug: Web/JavaScript/Reference/Global_Objects/TypeError/prototype ---- -<div>{{JSRef("Global_Objects", "Error", "EvalError,InternalError,RangeError,ReferenceError,SyntaxError,TypeError,URIError")}}</div> - -<h2 id="Summary" name="Summary">Сводка</h2> -<p>Свойство <code><strong>TypeError.prototype</strong></code> представляет прототип конструктора объекта {{jsxref("TypeError")}}.</p> - -<div>{{js_property_attributes(0, 0, 0)}}</div> - -<h2 id="Description" name="Description">Описание</h2> -<p>Все экземпляры {{jsxref("TypeError")}} наследуются от объекта <code>TypeError.prototype</code>. Вы можете использовать прототип для добавления свойств или методов ко всем экземплярам.</p> - -<h2 id="Properties" name="Properties">Свойства</h2> -<dl> - <dt><code>TypeError.prototype.constructor</code></dt> - <dd>Определяет функцию, создающую прототип экземпляра.</dd> - <dt>{{jsxref("Error.prototype.message", "TypeError.prototype.message")}}</dt> - <dd>Сообщение ошибки. Хотя стандарт ECMA-262 определяет, что {{jsxref("TypeError")}} должен предоставлять своё собственное свойство <code>message</code>, в <a href="/ru/docs/Mozilla/Projects/SpiderMonkey">SpiderMonkey</a> он наследует свойство {{jsxref("Error.prototype.message")}}.</dd> - <dt>{{jsxref("Error.prototype.name", "TypeError.prototype.name")}}</dt> - <dd>Название ошибки. Унаследовано от {{jsxref("Error")}}.</dd> - <dt>{{jsxref("Error.prototype.fileName", "TypeError.prototype.fileName")}}</dt> - <dd>Путь к файлу, в котором возникла эта ошибка. Унаследовано от {{jsxref("Error")}}.</dd> - <dt>{{jsxref("Error.prototype.lineNumber", "TypeError.prototype.lineNumber")}}</dt> - <dd>Номер строки в файле, в котором возникла эта ошибка. Унаследовано от {{jsxref("Error")}}.</dd> - <dt>{{jsxref("Error.prototype.columnNumber", "TypeError.prototype.columnNumber")}}</dt> - <dd>Номер колонки в строке, на которой возникла эта ошибка. Унаследовано от {{jsxref("Error")}}.</dd> - <dt>{{jsxref("Error.prototype.stack", "TypeError.prototype.stack")}}</dt> - <dd>Стек вызовов. Унаследовано от {{jsxref("Error")}}.</dd> -</dl> - -<h2 id="Methods" name="Methods">Методы</h2> -<p>Хотя объект прототипа {{jsxref("TypeError")}} не содержит собственных методов, экземпляры {{jsxref("TypeError")}} наследуют некоторые методы из цепочки прототипов.</p> - -<h2 id="Specifications" name="Specifications">Спецификации</h2> -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Спецификация</th> - <th scope="col">Статус</th> - <th scope="col">Комментарии</th> - </tr> - <tr> - <td>ECMAScript 3-е издание.</td> - <td>Стандарт</td> - <td>Изначальное определение.</td> - </tr> - <tr> - <td>{{SpecName('ES5.1', '#sec-15.11.7.6', 'NativeError.prototype')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td>Определено как <code><em>NativeError</em>.prototype</code>.</td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-nativeerror.prototype', 'NativeError.prototype')}}</td> - <td>{{Spec2('ES6')}}</td> - <td>Определено как <code><em>NativeError</em>.prototype</code>.</td> - </tr> - </tbody> -</table> - -<h2 id="Browser_compatibility" name="Browser_compatibility">Совместимость с браузерами</h2> -<div>{{CompatibilityTable}}</div> -<div id="compat-desktop"> - <table class="compat-table"> - <tbody> - <tr> - <th>Возможность</th> - <th>Chrome</th> - <th>Firefox (Gecko)</th> - <th>Internet Explorer</th> - <th>Opera</th> - <th>Safari</th> - </tr> - <tr> - <td>Базовая поддержка</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - </tr> - </tbody> - </table> -</div> -<div id="compat-mobile"> - <table class="compat-table"> - <tbody> - <tr> - <th>Возможность</th> - <th>Android</th> - <th>Chrome для Android</th> - <th>Firefox Mobile (Gecko)</th> - <th>IE Mobile</th> - <th>Opera Mobile</th> - <th>Safari Mobile</th> - </tr> - <tr> - <td>Базовая поддержка</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - </tr> - </tbody> - </table> -</div> - -<h2 id="See_also" name="See_also">Смотрите также</h2> -<ul> - <li>{{jsxref("Error.prototype")}}</li> - <li>{{jsxref("Function.prototype")}}</li> -</ul> diff --git a/files/ru/conflicting/web/javascript/reference/global_objects/urierror/index.html b/files/ru/conflicting/web/javascript/reference/global_objects/urierror/index.html deleted file mode 100644 index 65bae4f674..0000000000 --- a/files/ru/conflicting/web/javascript/reference/global_objects/urierror/index.html +++ /dev/null @@ -1,124 +0,0 @@ ---- -title: URIError.prototype -slug: conflicting/Web/JavaScript/Reference/Global_Objects/URIError -tags: - - Error - - JavaScript - - Property - - Prototype - - URIError -translation_of: Web/JavaScript/Reference/Global_Objects/URIError -translation_of_original: Web/JavaScript/Reference/Global_Objects/URIError/prototype -original_slug: Web/JavaScript/Reference/Global_Objects/URIError/prototype ---- -<div>{{JSRef("Global_Objects", "Error", "EvalError,InternalError,RangeError,ReferenceError,SyntaxError,TypeError,URIError")}}</div> - -<h2 id="Summary" name="Summary">Сводка</h2> -<p>Свойство <code><strong>URIError.prototype</strong></code> представляет прототип конструктора объекта {{jsxref("URIError")}}.</p> - -<div>{{js_property_attributes(0, 0, 0)}}</div> - -<h2 id="Description" name="Description">Описание</h2> -<p>Все экземпляры {{jsxref("URIError")}} наследуются от объекта <code>URIError.prototype</code>. Вы можете использовать прототип для добавления свойств или методов ко всем экземплярам.</p> - -<h2 id="Properties" name="Properties">Свойства</h2> -<dl> - <dt><code>URIError.prototype.constructor</code></dt> - <dd>Определяет функцию, создающую прототип экземпляра.</dd> - <dt>{{jsxref("Error.prototype.message", "URIError.prototype.message")}}</dt> - <dd>Сообщение ошибки. Хотя стандарт ECMA-262 определяет, что {{jsxref("URIError")}} должен предоставлять своё собственное свойство <code>message</code>, в <a href="/ru/docs/Mozilla/Projects/SpiderMonkey">SpiderMonkey</a> он наследует свойство {{jsxref("Error.prototype.message")}}.</dd> - <dt>{{jsxref("Error.prototype.name", "URIError.prototype.name")}}</dt> - <dd>Название ошибки. Унаследовано от {{jsxref("Error")}}.</dd> - <dt>{{jsxref("Error.prototype.fileName", "URIError.prototype.fileName")}}</dt> - <dd>Путь к файлу, в котором возникла эта ошибка. Унаследовано от {{jsxref("Error")}}.</dd> - <dt>{{jsxref("Error.prototype.lineNumber", "URIError.prototype.lineNumber")}}</dt> - <dd>Номер строки в файле, в котором возникла эта ошибка. Унаследовано от {{jsxref("Error")}}.</dd> - <dt>{{jsxref("Error.prototype.columnNumber", "URIError.prototype.columnNumber")}}</dt> - <dd>Номер колонки в строке, на которой возникла эта ошибка. Унаследовано от {{jsxref("Error")}}.</dd> - <dt>{{jsxref("Error.prototype.stack", "URIError.prototype.stack")}}</dt> - <dd>Стек вызовов. Унаследовано от {{jsxref("Error")}}.</dd> -</dl> - -<h2 id="Methods" name="Methods">Методы</h2> -<p>Хотя объект прототипа {{jsxref("URIError")}} не содержит собственных методов, экземпляры {{jsxref("URIError")}} наследуют некоторые методы из цепочки прототипов.</p> - -<h2 id="Specifications" name="Specifications">Спецификации</h2> -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Спецификация</th> - <th scope="col">Статус</th> - <th scope="col">Комментарии</th> - </tr> - <tr> - <td>ECMAScript 3-е издание.</td> - <td>Стандарт</td> - <td>Изначальное определение.</td> - </tr> - <tr> - <td>{{SpecName('ES5.1', '#sec-15.11.7.6', 'NativeError.prototype')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td>Определено как <code><em>NativeError</em>.prototype</code>.</td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-nativeerror.prototype', 'NativeError.prototype')}}</td> - <td>{{Spec2('ES6')}}</td> - <td>Определено как <code><em>NativeError</em>.prototype</code>.</td> - </tr> - </tbody> -</table> - -<h2 id="Browser_compatibility" name="Browser_compatibility">Совместимость с браузерами</h2> -<div>{{CompatibilityTable}}</div> -<div id="compat-desktop"> - <table class="compat-table"> - <tbody> - <tr> - <th>Возможность</th> - <th>Chrome</th> - <th>Firefox (Gecko)</th> - <th>Internet Explorer</th> - <th>Opera</th> - <th>Safari</th> - </tr> - <tr> - <td>Базовая поддержка</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - </tr> - </tbody> - </table> -</div> -<div id="compat-mobile"> - <table class="compat-table"> - <tbody> - <tr> - <th>Возможность</th> - <th>Android</th> - <th>Chrome для Android</th> - <th>Firefox Mobile (Gecko)</th> - <th>IE Mobile</th> - <th>Opera Mobile</th> - <th>Safari Mobile</th> - </tr> - <tr> - <td>Базовая поддержка</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - </tr> - </tbody> - </table> -</div> - -<h2 id="See_also" name="See_also">Смотрите также</h2> -<ul> - <li>{{jsxref("Error.prototype")}}</li> - <li>{{jsxref("Function.prototype")}}</li> -</ul> diff --git a/files/ru/conflicting/web/javascript/reference/global_objects/weakmap/index.html b/files/ru/conflicting/web/javascript/reference/global_objects/weakmap/index.html deleted file mode 100644 index 1b946c504b..0000000000 --- a/files/ru/conflicting/web/javascript/reference/global_objects/weakmap/index.html +++ /dev/null @@ -1,76 +0,0 @@ ---- -title: WeakMap.prototype -slug: conflicting/Web/JavaScript/Reference/Global_Objects/WeakMap -translation_of: Web/JavaScript/Reference/Global_Objects/WeakMap -translation_of_original: Web/JavaScript/Reference/Global_Objects/WeakMap/prototype -original_slug: Web/JavaScript/Reference/Global_Objects/WeakMap/prototype ---- -<div>{{JSRef}}</div> - -<p><code><strong>WeakMap</strong></code><strong><code>.prototype</code></strong> свойство указывает на прототип {{jsxref("WeakMap")}} конструктора.</p> - -<div>{{js_property_attributes(0,0,0)}}</div> - -<h2 id="Описание">Описание</h2> - -<p>{{jsxref("WeakMap")}} экземпляры наследуют {{jsxref("WeakMap.prototype")}}. Вы можете использовать прототип конструктора объекта для добавления новых свойств и/или методов всем экземпляра класса <code>WeakMap</code>.</p> - -<p><code>WeakMap.prototype</code> является простым объектом:</p> - -<pre class="brush: js">Object.prototype.toString.call(WeakMap.prototype); // "[object Object]"</pre> - -<h2 id="Свойства">Свойства</h2> - -<dl> - <dt><code>WeakMap.prototype.constructor</code></dt> - <dd>Возвращает функцию, создавшую экземпляр. {{jsxref("WeakMap")}} function by default.</dd> -</dl> - -<h2 id="Методы">Методы</h2> - -<dl> - <dt>{{jsxref("WeakMap.delete", "WeakMap.prototype.delete(key)")}}</dt> - <dd>Удаление значение по ключу. <code>WeakMap.prototype.has(key)</code> вернёт <code>false</code> после.</dd> - <dt>{{jsxref("WeakMap.get", "WeakMap.prototype.get(key)")}}</dt> - <dd>Возвращает значение по ключу, or <code>undefined</code> такового нет.</dd> - <dt>{{jsxref("WeakMap.has", "WeakMap.prototype.has(key)")}}</dt> - <dd>Вернёт логическое значение, связанное с существованием ключа.</dd> - <dt>{{jsxref("WeakMap.set", "WeakMap.prototype.set(key, value)")}}</dt> - <dd>Устанавливает значение по ключу, после возвращает самого себя.</dd> - <dt><s class="obsoleteElement">{{jsxref("WeakMap.prototype.clear()")}} {{obsolete_inline}}</s></dt> - <dd><s class="obsoleteElement">Удаляет все ключи-значения из <code>WeakMap</code> объекта. Заметьте, что это возможно, только есть <code>WeakMap</code>-like объект имеет<code>.clear()</code> метод путём инкапсулирования <code>WeakMap</code> объекта, раннее не имевшего его (смотри пример на странице {{jsxref("WeakMap")}})</s></dd> -</dl> - -<h2 id="Спецификации">Спецификации</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Specification</th> - <th scope="col">Status</th> - <th scope="col">Comment</th> - </tr> - <tr> - <td>{{SpecName('ES2015', '#sec-weakmap.prototype', 'WeakMap.prototype')}}</td> - <td>{{Spec2('ES2015')}}</td> - <td>Initial definition.</td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-weakmap.prototype', 'WeakMap.prototype')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Совместимость">Совместимость</h2> - - - -<p>{{Compat("javascript.builtins.WeakMap.prototype")}}</p> - -<h2 id="Рекомендуем">Рекомендуем</h2> - -<ul> - <li>{{jsxref("Map.prototype")}}</li> -</ul> diff --git a/files/ru/conflicting/web/javascript/reference/global_objects/weakset/index.html b/files/ru/conflicting/web/javascript/reference/global_objects/weakset/index.html deleted file mode 100644 index fe31196afe..0000000000 --- a/files/ru/conflicting/web/javascript/reference/global_objects/weakset/index.html +++ /dev/null @@ -1,143 +0,0 @@ ---- -title: WeakSet.prototype -slug: conflicting/Web/JavaScript/Reference/Global_Objects/WeakSet -tags: - - ECMAScript6 - - JavaScript - - Property - - WeakSet -translation_of: Web/JavaScript/Reference/Global_Objects/WeakSet -translation_of_original: Web/JavaScript/Reference/Global_Objects/WeakSet/prototype -original_slug: Web/JavaScript/Reference/Global_Objects/WeakSet/prototype ---- -<div>{{JSRef("Global_Objects", "WeakSet")}}</div> - -<p>Свойство <code><strong>WeakSet</strong></code><strong><code>.prototype</code></strong> представляет прототип для конструктора {{jsxref("WeakSet")}}.</p> - -<div>{{js_property_attributes(0,0,0)}}</div> - -<h2 id="Description" name="Description">Описание</h2> - -<p>Экземпляры {{jsxref("WeakSet")}} наследуются от {{jsxref("WeakSet.prototype")}}. Вы можете изменять прототип конструктора объекта для применения изменений ко всем экземплярам класса <code>WeakSet.</code></p> - -<p><code>WeakSet.prototype</code> сам по себе является обычным объектом:</p> - -<pre class="brush: js">Object.prototype.toString.call(WeakSet.prototype); // "[object Object]"</pre> - -<h2 id="Properties" name="Properties">Свойства</h2> - -<dl> - <dt><code>WeakSet.prototype.constructor</code></dt> - <dd>Возвращает функцию, создающую экземпляр прототипа. По умолчанию, это функция {{jsxref("WeakSet")}}.</dd> -</dl> - -<h2 id="Methods" name="Methods">Методы</h2> - -<dl> - <dt>{{jsxref("WeakSet.add", "WeakSet.prototype.add(value)")}}</dt> - <dd>Добавляет объект value в WeakSet. </dd> - <dt>{{jsxref("WeakSet.delete", "WeakSet.prototype.delete(value)")}}</dt> - <dd>Удаляет из WeakSet элемент value. После удаления вызов <code>WeakSet.prototype.has(value) возвращает false.</code> </dd> - <dt>{{jsxref("WeakSet.has", "WeakSet.prototype.has(value)")}}</dt> - <dd>Определяет, содержит WeakSet объект value или нет, возвращая, соответственно, true или false. </dd> - <dt><s class="obsoleteElement">{{jsxref("WeakSet.prototype.clear()")}} {{obsolete_inline}}</s></dt> - <dd><s class="obsoleteElement">Удаляет все элементы из объекта WeakSet.</s></dd> -</dl> - -<h2 id="Specifications" name="Specifications">Спецификации</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Specification</th> - <th scope="col">Status</th> - <th scope="col">Comment</th> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-weakset.prototype', 'WeakSet.prototype')}}</td> - <td>{{Spec2('ES6')}}</td> - <td>Изначальное определение.</td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-weakset.prototype', 'WeakSet.prototype')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Browser_compatibility" name="Browser_compatibility">Совместимость с браузерами</h2> - -<p>{{CompatibilityTable}}</p> - -<div id="compat-desktop"> -<table class="compat-table"> - <tbody> - <tr> - <th>Feature</th> - <th>Chrome</th> - <th>Firefox (Gecko)</th> - <th>Internet Explorer</th> - <th>Opera</th> - <th>Safari</th> - </tr> - <tr> - <td>Basic support</td> - <td>36</td> - <td>{{ CompatGeckoDesktop(34) }}</td> - <td>{{CompatNo}}</td> - <td>23</td> - <td>{{CompatNo}}</td> - </tr> - <tr> - <td>Ordinary object</td> - <td>{{CompatUnknown}}</td> - <td>{{CompatGeckoDesktop("40")}}</td> - <td>{{CompatUnknown}}</td> - <td>{{CompatUnknown}}</td> - <td>{{CompatUnknown}}</td> - </tr> - </tbody> -</table> -</div> - -<div id="compat-mobile"> -<table class="compat-table"> - <tbody> - <tr> - <th>Feature</th> - <th>Chrome for Android</th> - <th>Android</th> - <th>Firefox Mobile (Gecko)</th> - <th>IE Mobile</th> - <th>Opera Mobile</th> - <th>Safari Mobile</th> - </tr> - <tr> - <td>Basic support</td> - <td>{{CompatNo}}</td> - <td>{{CompatNo}}</td> - <td>{{ CompatGeckoMobile(34) }}</td> - <td>{{CompatNo}}</td> - <td>{{CompatNo}}</td> - <td>{{CompatNo}}</td> - </tr> - <tr> - <td>Ordinary object</td> - <td>{{CompatUnknown}}</td> - <td>{{CompatUnknown}}</td> - <td>{{CompatGeckoMobile("40")}}</td> - <td>{{CompatUnknown}}</td> - <td>{{CompatUnknown}}</td> - <td>{{CompatUnknown}}</td> - </tr> - </tbody> -</table> -</div> - -<h2 id="See_also" name="See_also">Смотрите также</h2> - -<ul> - <li>{{jsxref("Set.prototype")}}</li> - <li>{{jsxref("WeakMap.prototype")}}</li> -</ul> diff --git a/files/ru/conflicting/web/javascript/reference/operators/index.html b/files/ru/conflicting/web/javascript/reference/operators/index.html deleted file mode 100644 index 1a2799b922..0000000000 --- a/files/ru/conflicting/web/javascript/reference/operators/index.html +++ /dev/null @@ -1,292 +0,0 @@ ---- -title: Арифметические операции -slug: conflicting/Web/JavaScript/Reference/Operators -tags: - - JavaScript - - Операторы -translation_of: Web/JavaScript/Reference/Operators -translation_of_original: Web/JavaScript/Reference/Operators/Arithmetic_Operators -original_slug: Web/JavaScript/Reference/Operators/Arithmetic_Operators ---- -<div> -<div>{{jsSidebar("Operators")}}</div> -</div> - -<p><strong>Арифметические операции</strong> принимают в качестве операндов числовые значения (это может быть и литерал и переменная) и возвращают результат в виде одного числового значения. Стандартными арифметическими операциями являются сложение (<code>+</code>), вычитание (<code>-</code>), умножение (<code>*</code>) и деление (<code>/</code>).</p> - -<h2 id="Сложение"><a name="Addition">Сложение (+)</a></h2> - -<p>Оператор сложения возвращает сумму числовых операндов или объединяет строки.</p> - -<h3 id="Syntax" name="Syntax">Синтаксис</h3> - -<pre class="syntaxbox"><strong>Operator:</strong> x + y -</pre> - -<h3 id="Examples" name="Examples">Примеры</h3> - -<pre class="brush: js">// Number + Number -> сложение -1 + 2 // 3 - -// Boolean + Number -> сложение -true + 1 // 2 - -// Boolean + Boolean -> сложение -false + false // 0 - -// Number + String -> конкатенация -5 + "foo" // "5foo" - -// String + Boolean -> конкатенация -"foo" + false // "foofalse" - -// String + String -> конкатенация -"foo" + "bar" // "foobar" -</pre> - -<h2 id="Вычитание_-"><a name="Subtraction">Вычитание (-)</a></h2> - -<p>Оператор вычитания вычитает один операнд из другого и возвращает разницу.</p> - -<h3 id="Syntax_2" name="Syntax_2">Синтаксис</h3> - -<pre class="syntaxbox"><strong>Operator:</strong> x - y -</pre> - -<h3 id="Examples_2" name="Examples_2">Примеры</h3> - -<pre class="brush: js">5 - 3 // 2 -3 - 5 // -2 -"foo" - 3 // NaN</pre> - -<h2 id="Деление"><a name="Division">Деление (/)</a></h2> - -<p>Оператор деления производит деление его операндов, где левый операнд - делимый, а правый - делитель.</p> - -<h3 id="Syntax_3" name="Syntax_3">Синтаксис</h3> - -<pre class="syntaxbox"><strong>Operator:</strong> x / y -</pre> - -<h3 id="Examples_3" name="Examples_3">Примеры</h3> - -<pre class="brush: js">1 / 2 // возвращает 0.5 в JavaScript -1 / 2 // возвращает 0 в Java -// (так числа не с плавающими точками) - -1.0 / 2.0 // возвращает 0.5 и в JavaScript и в Java - -2.0 / 0 // возвращает Infinity в JavaScript -2.0 / 0.0 // тоже возвращает Infinity -2.0 / -0.0 // возвращает -Infinity в JavaScript</pre> - -<h2 id="Умножение_*"><a name="Multiplication">Умножение (*)</a></h2> - -<p>Оператор умножения возвращает произведение операндов.</p> - -<h3 id="Syntax_4" name="Syntax_4">Синтаксис</h3> - -<pre class="syntaxbox"><strong>Operator:</strong> x * y -</pre> - -<h3 id="Examples_4" name="Examples_4">Примеры</h3> - -<pre class="brush: js">2 * 2 // 4 --2 * 2 // -4 -Infinity * 0 // NaN -Infinity * Infinity // Infinity -"foo" * 2 // NaN -</pre> - -<h2 id="Остаток_от_деления"><a name="Remainder">Остаток от деления (%)</a></h2> - -<p>Оператор возвращает целый остаток от деления левого операнда на правый. Возвращаемое значение всегда получает знак делимого, а не делителя. Он использует встроенную функцию <code>modulo</code>, для получения результата, которая является целочисленным остатком деления <code>var1</code> на <code>var2</code> — например— <code>var1</code> modulo <code>var2</code>. <a href="http://wiki.ecmascript.org/doku.php?id=strawman:modulo_operator" title="http://wiki.ecmascript.org/doku.php?id=strawman:modulo_operator">Есть предложение добавить оператор modulo в будущие версии ECMAScript</a>, с той разницей, что оператор будет брать знак делителя, а не делимого.</p> - -<h3 id="Syntax_5" name="Syntax_5">Синтаксис</h3> - -<pre class="syntaxbox"><strong>Оператор:</strong> var1 % var2 -</pre> - -<h3 id="Examples_5" name="Examples_5">Примеры</h3> - -<pre class="brush: js line-numbers language-js"><code class="language-js"><span class="number token">12</span> <span class="operator token">%</span> <span class="number token">5</span> <span class="comment token">// 2</span> -<span class="operator token">-</span><span class="number token">1</span> <span class="operator token">%</span> <span class="number token">2</span> <span class="comment token">// -1</span> -<span class="number token">NaN</span> <span class="operator token">%</span> <span class="number token">2</span> <span class="comment token">// NaN</span> -<span class="number token">1</span> <span class="operator token">%</span> <span class="number token">2</span> <span class="comment token">// 1</span> -<span class="number token">2</span> <span class="operator token">%</span> <span class="number token">3</span> <span class="comment token">// 2</span> -<span class="operator token">-</span><span class="number token">4</span> <span class="operator token">%</span> <span class="number token">2</span> <span class="comment token">// -0</span> -<span class="number token">5.5</span> <span class="operator token">%</span> <span class="number token">2</span> <span class="comment token">// 1.5</span></code></pre> - -<h2 id="Возведение_в_степень_**"><a name="Exponentiation">Возведение в степень (**)</a></h2> - -<p>Оператор возведения в степень возвращает результат первого операнда в степень. это, <code>var1</code><sup><code>var2</code></sup>, в предыдущем выражении, где <code>var1</code> и <code>var2</code> - переменные. Он право ассоциативен. <code>a ** b ** c</code> равно <code>a ** (b ** c)</code>.</p> - -<h3 id="Синтаксис">Синтаксис</h3> - -<pre class="syntaxbox"><strong>Оператор:</strong> var1 ** var2</pre> - -<h3 id="Замечания">Замечания</h3> - -<p>Во многих языках, таких как PHP и Python и других, есть оператор возведения возведения в степень (обычно ^ или **), оператор определён имеющим приоритет выше, чем у унарных операторов, таких как унарный + и унарный -, но есть несколько исключений. Например, в Bash оператор ** создан имеющим приоритет ниже, чем у унарных операторов. В JavaScript невозможно написать двусмысленное выражение, т.е. вы не можете ставить унарный оператор (<code>+/-/~/!/delete/void/typeof</code>) непосредственно перед базовым числом.</p> - -<pre class="brush: js">-2 ** 2; -// 4 в Bash, -4 в других языках. -// Это некорректно в JavaScript, т.е. операция двухсмыслена. - - --(2 ** 2); -// -4 в JavaScript, намерения автора однозначны.</pre> - -<h3 id="Примеры">Примеры</h3> - -<pre class="brush: js">2 ** 3 // 8 -3 ** 2 // 9 -3 ** 2.5 // 15.588457268119896 -10 ** -1 // 0.1 -NaN ** 2 // NaN - -2 ** 3 ** 2 // 512 -2 ** (3 ** 2) // 512 -(2 ** 3) ** 2 // 64</pre> - -<p>Изменим знак результата возведения в степень:</p> - -<pre class="brush: js">-(2 ** 2) // -4</pre> - -<p>Несильная установка основания как отрицательного числа:</p> - -<pre class="brush: js">(-2) ** 2 // 4</pre> - -<h2 id="Инкремент"><a name="Increment">Инкремент (++)</a></h2> - -<p>Оператор инкремента увеличивает на единицу(инкрементирует) операнд и возвращает значение.</p> - -<ul> - <li>Если операция используется как постфикс, с оператором после операнда (например, x++), значение операнда возвращается, а затем увеличивается на единицу.</li> - <li>Если используется префиксная форма с оператором перед операндом (например, ++x), значение операнда возвращается увеличенным на единицу.</li> -</ul> - -<h3 id="Syntax_6" name="Syntax_6">Синтаксис</h3> - -<pre class="syntaxbox"><strong>Оператор:</strong> x++ или ++x -</pre> - -<h3 id="Examples_6" name="Examples_6">Примеры</h3> - -<pre class="brush: js">// Постфиксный -var x = 3; -y = x++; // y = 3, x = 4 - -// Префиксный -var a = 2; -b = ++a; // a = 3, b = 3 -</pre> - -<h2 id="sect1"></h2> - -<h2 id="Декремент_--"><a name="Decrement">Декремент (--)</a></h2> - -<p>Операция декремента уменьшает на 1 (отнимает единицу) свой операнд и возвращает значение.</p> - -<ul> - <li>Если операция используется как постфикс (например, x--), значение операнда возвращается, а затем уменьшается на единицу.</li> - <li>Если используется префиксная форма (например, --x), значение операнда возвращается уменьшенным на единицу.</li> -</ul> - -<h3 id="Syntax_7" name="Syntax_7">Синтаксис</h3> - -<pre class="syntaxbox"><strong>Оператор:</strong> x-- или --x -</pre> - -<h3 id="Examples_7" name="Examples_7">Примеры</h3> - -<pre class="brush: js">// Постфиксный -var x = 3; -y = x--; // y = 3, x = 2 - -// Префиксный -var a = 2; -b = --a; // a = 1, b = 1 -</pre> - -<h2 id="Унарный_минус_-"><a name="Unary_negation">Унарный минус (-)</a></h2> - -<p>Унарный минус ставится перед своим операндом и возвращает его математическое отрицание.</p> - -<h3 id="Syntax_8" name="Syntax_8">Синтаксис</h3> - -<pre class="syntaxbox"><strong>Оператор:</strong> -x -</pre> - -<h3 id="Examples_8" name="Examples_8">Примеры</h3> - -<pre class="brush: js">var x = 3; -y = -x; // y = -3, x = 3 -</pre> - -<h2 id="Унарный_плюс"><a name="Unary_plus">Унарный плюс</a> (+)</h2> - -<p>Оператор унарный плюс предшествует своему операнду и оценивает его, пытается преобразовать его в число, если он им не является. Хотя, унарное отрицание (-) также конвертирует не числа, унарный плюс - быстрейший и предпочитаемый способ конвертирования чего-либо в число потому, что он не выполняет каких-либо операций с числом. Он может конвертировать строковые представления целых и чисел с плавающей точкой, а также нестроковые значения <code>true</code>, <code>false</code> и <code>null</code>. Поддерживаются числа в десятичном и шестнадцатеричном (с префиксом "0x") формате. Отрицательные числа тоже поддерживаются (но не 16-ричные). Если он не может вычислить конкретное значение, выполнится как <a href="/ru/docs/Web/JavaScript/Reference/Global_Objects/NaN">NaN</a>.</p> - -<h3 id="Syntax_9" name="Syntax_9">Синтаксис</h3> - -<pre class="syntaxbox"><strong>Оператор:</strong> +x -</pre> - -<h3 id="Examples_9" name="Examples_9">Примеры</h3> - -<pre class="brush: js">+3 // 3 -+"3" // 3 -+true // 1 -+false // 0 -+null // 0 -</pre> - -<h2 id="Specifications" name="Specifications">Спецификации</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Спецификация</th> - <th scope="col">Статус</th> - <th scope="col">Примечание</th> - </tr> - <tr> - <td>{{SpecName('ES1')}}</td> - <td>{{Spec2('ES1')}}</td> - <td>Изначальное определение</td> - </tr> - <tr> - <td>{{SpecName('ES5.1', '#sec-11.3')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td>Определено в нескольких секциях спецификации: <a href="http://www.ecma-international.org/ecma-262/5.1/#sec-11.6">Additive operators</a>, <a href="http://www.ecma-international.org/ecma-262/5.1/#sec-11.5">Multiplicative operators</a>, <a href="http://www.ecma-international.org/ecma-262/5.1/#sec-11.3">Postfix expressions</a>, <a href="http://www.ecma-international.org/ecma-262/5.1/#sec-11.4">Unary operators</a>.</td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-postfix-expressions')}}</td> - <td>{{Spec2('ES6')}}</td> - <td>Определено в нескольких секциях спецификации: <a href="http://www.ecma-international.org/ecma-262/6.0/#sec-additive-operators">Additive operators</a>, <a href="http://www.ecma-international.org/ecma-262/6.0/#sec-multiplicative-operators">Multiplicative operators</a>, <a href="http://www.ecma-international.org/ecma-262/6.0/#sec-postfix-expressions">Postfix expressions</a>, <a href="http://www.ecma-international.org/ecma-262/6.0/#sec-unary-operators">Unary operators</a>.</td> - </tr> - <tr> - <td>{{SpecName('ES7', '#sec-postfix-expressions')}}</td> - <td>{{Spec2('ES7')}}</td> - <td>Добавлен <a href="https://github.com/rwaldron/exponentiation-operator">Оператор возведения в степень</a>.</td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-postfix-expressions')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td></td> - </tr> - </tbody> -</table> - -<h2 id="Поддержка_браузерами">Поддержка браузерами</h2> - - - -<p>{{Compat("javascript.operators.arithmetic")}}</p> - -<h2 id="See_also" name="See_also">Смотрите также</h2> - -<ul> - <li><a href="/ru/docs/Web/JavaScript/Reference/Operators/Assignment_Operators">Операторы присваивания</a></li> -</ul> diff --git a/files/ru/conflicting/web/javascript/reference/operators_69135a8d5772f8b6e45265523df05d89/index.html b/files/ru/conflicting/web/javascript/reference/operators_69135a8d5772f8b6e45265523df05d89/index.html deleted file mode 100644 index 4f6c0a178f..0000000000 --- a/files/ru/conflicting/web/javascript/reference/operators_69135a8d5772f8b6e45265523df05d89/index.html +++ /dev/null @@ -1,288 +0,0 @@ ---- -title: Операторы сравнения -slug: >- - conflicting/Web/JavaScript/Reference/Operators_69135a8d5772f8b6e45265523df05d89 -tags: - - JavaScript - - Операторы -translation_of: Web/JavaScript/Reference/Operators -translation_of_original: Web/JavaScript/Reference/Operators/Comparison_Operators -original_slug: Web/JavaScript/Reference/Operators/Операторы_сравнения ---- -<div>{{jsSidebar("Operators")}}</div> - -<p>В JavaScript имеются как строгие сравнения, так и сравнения с преобразованием типа операндов. Строгие сравнения (к примеру, ===) истинны только в том случае, если типы сравниваемых значений являются одинаковыми (к примеру: string-string, number-number). Однако, чаще используются сравнения с преобразованием типов (к примеру, ==). Такой тип сравнения, перед тем как непосредственно выполнить сравнение, приводит операнды к одному типу. В случае же абстрактного реляционного сравнения, операнды сперва преобразуются в примитивы, затем приводятся к одному типу, и только после этого сравниваются.</p> - -<p>Строки сравниваются на основе стандартного лексикографического упорядочения, используя значения Unicode.</p> - -<p>Особенности сравнений:</p> - -<ul> - <li>Две строки строго равны только в том случае, если они имеют одинаковую длину, и те же символы в одинаковой последовательности и соответствующих позициях.</li> - <li>Два числа строго равны в том случае, если они численно равны. <a href="/ru/docs/Web/JavaScript/Reference/Global_Objects/NaN" title="NaN">NaN</a> не равно ничему, в том числе и NaN. Нули с положительным и отрицательным знаком равны.</li> - <li>Два логических значения (boolean) равны только в том случае, если они оба <code>истинны (true)</code> или <code>ложны (false</code>).</li> - <li>Два различных объекта никогда не равны как в строгих, так и в абстрактных сравнениях.</li> - <li>Сравнение объекта истинно лишь в том случае, если оба операнда ссылаются на один и тот же объект в памяти.</li> - <li>Виды <code>null</code> и <code>undefined</code> равны себе как в строгом сравнении, так и в абстрактном.</li> -</ul> - -<p><strong>При использовании сравнения с преобразованием типов, следует быть крайне осторожным, так как это может привести к непредвиденным проблемам, связанным с особенностями конвертации различных типов (см. параграф "Использование операторов равенства").</strong></p> - -<h2 id="Операторы_равенства">Операторы равенства</h2> - -<h3 id="Равно"><a name="Equality">Равно (==)</a></h3> - -<p><em>Оператор равно</em> сначала приводит операнды к одному типу, и затем применяет строгое сравнение. Если оба операнда являются объектами, то JavaScript сравнивает внутренние ссылки, которые равны в том случае, если они ссылаются на один и тот же объект в памяти.</p> - -<h4 id="Синтаксис">Синтаксис</h4> - -<pre class="syntaxbox notranslate">x == y -</pre> - -<h4 id="Примеры">Примеры</h4> - -<pre class="brush: js notranslate"> 1 == 1 // истина -"1" == 1 // истина - 1 == '1' // истина - 3 == 5 // ложь - 0 == false // истина -"foo" == "bar" // ложь -</pre> - -<h3 id="Не_равно_!"><a name="Inequality">Не равно (!=)</a></h3> - -<p><em>Оператор не равно</em> возвращает <code>true</code> в том случае, если операнды не равны.<em>Он </em>аналогичен оператору равенства, перед сравнением приводит операнды к одному типу. В случае если оба операнда являются объектами, JavaScript сравнивает внутренние ссылки, которые не равны в том случае, если относятся к разным объектам в памяти.</p> - -<h4 id="Синтаксис_2">Синтаксис</h4> - -<pre class="syntaxbox notranslate">x != y</pre> - -<h4 id="Примеры_2">Примеры</h4> - -<pre class="brush: js notranslate">1 != 2 // истина -1 != "1" // ложь -1 != '1' // ложь -1 != true // ложь -0 != false // ложь -"foo" != "bar" // истина -</pre> - -<h3 id="Строго_равно"><a name="Identity">Строго равно (===)</a></h3> - -<p>Оператор возвращает истину в том случае, если операнды строго равны (см. выше). В отличие от <em>оператора равно</em>, данный оператор <strong>не приводит операнды к одному типу.</strong></p> - -<h4 id="Синтаксис_3">Синтаксис</h4> - -<pre class="syntaxbox notranslate">x === y</pre> - -<h4 id="Примеры_3">Примеры</h4> - -<pre class="brush: js notranslate">3 === 3 // истина -3 === '3' // ложь -'foo' === 'foo' // истина -</pre> - -<h3 id="Строго_не_равно_!"><a name="Nonidentity">Строго не равно (!==)</a></h3> - -<p><em>Оператор строго не равно </em>возвращает истину в том случае, <strong>если операнды не равны, или их типы отличаются друг от друга.</strong></p> - -<h4 id="Синтаксис_4">Синтаксис</h4> - -<pre class="syntaxbox notranslate">x !== y</pre> - -<h4 id="Примеры_4">Примеры</h4> - -<pre class="brush: js notranslate">3 !== '3' // истина -4 !== 3 // истина -</pre> - -<h2 id="Операторы_сравнения">Операторы сравнения</h2> - -<h3 id="Больше_>"><a name="Greater_than_operator">Больше (>)</a></h3> - -<p><em>Оператор больше</em> возвращает истину в том случае, если значение левого операнда больше, чем правого.</p> - -<h4 id="Синтаксис_5">Синтаксис</h4> - -<pre class="syntaxbox notranslate">x > y</pre> - -<h4 id="Примеры_5">Примеры</h4> - -<pre class="brush: js notranslate">4 > 3 // истина -1 > 5 // ложь -</pre> - -<h3 id="Больше_или_равно_>"><a name="Greater_than_or_equal_operator">Больше или равно (>=)</a></h3> - -<p><em>Оператор больше или равно, </em>возвращает истину в том случае, если значение операнда слева больше или равно значению операнда справа.</p> - -<h4 id="Синтаксис_6">Синтаксис</h4> - -<pre class="syntaxbox notranslate"> x >= y</pre> - -<h4 id="Примеры_6">Примеры</h4> - -<pre class="brush: js notranslate">4 >= 3 // истина -3 >= 3 // истина -</pre> - -<h3 id="Меньше<"><a name="Less_than_operator">Меньше(<)</a></h3> - -<p><em>Оператор меньше, </em>возвращает истину в том случае, если значение операнда слева меньше, чем значение операнда справа.</p> - -<h4 id="Синтаксис_7">Синтаксис</h4> - -<pre class="syntaxbox notranslate"> x < y</pre> - -<h4 id="Примеры_7">Примеры</h4> - -<pre class="brush: js notranslate">3 < 4 // истина -5 < 2 // ложь -</pre> - -<h3 id="Меньше_или_равно_<"><a id="Less_than_or_equal_operator" name="Less_than_or_equal_operator">Меньше или равно (<=)</a></h3> - -<p><em>Оператор меньше или равно, </em>возвращает истину в том случае, если значение операнда слева меньше, или равно значению операнда справа.</p> - -<h4 id="Синтаксис_8">Синтаксис</h4> - -<pre class="syntaxbox notranslate"> x <= y</pre> - -<h4 id="Примеры_8">Примеры</h4> - -<pre class="brush: js notranslate">3 <= 4 // истина -3 <= 3 // истина -</pre> - -<h2 id="Использование_операторов_равенства">Использование операторов равенства</h2> - -<p>Стандартные операции равенства с преобразованием типов (<code>==</code> и <code>!=</code>) используют <a href="http://www.ecma-international.org/ecma-262/5.1/#sec-11.9.3">Абстрактный Алгоритм Эквивалентного Сравнения</a> для сравнения двух операндов. Если у операндов различные типы, то JavaScript пытается привести их к одному типу, перед тем как сравнивать их. К примеру, в выражении <code>5 == '5'</code>, строка справа конвертируется в число, и только потом сравнивается.</p> - -<p><em>Операторы строгого равентсва</em> (<code>===</code> и <code>!==</code>) используют Строгий Алгоритм Эквивалентного Сравнения, и предназначены для сравнения операндов одного типа. <strong>Если операнды имеют разные типы, то результат операции сравнения всегда будет ложью.</strong> К примеру, выражение <code>5 !== '5'</code> будет истинным.</p> - -<p>Используйте <em>операторы строгого равенства</em> в тех случаях, когда необходимо проверять не только значения операндов, но так же и их типы. Во противном случае, используйте операторы стандартного равенства, которые позволяют сравнить два операнда вне зависимости от их типов.</p> - -<p>Когда происходит преобразование типов (т.е в случаях использования нестрогого сравнения), JavaScript преобразует типы String, Number, Boolean и Object, следующим образом:</p> - -<ul> - <li>При сравнении числа <code>(Number)</code> и строки <code>(String)</code>, JavaScript пытается преобразовать числовой литерал строки в число. Затем полученное число округляется до ближайшего возможного значения типа <code>Number</code>.</li> - <li>Если один из операндов является логическим <code>(Boolean)</code>, то он преобразуется в значение типа <code>(Number)</code>. <strong>Если значение логического операнда равняется истине <code>(true)</code>, то значение этого операнда преобразуется в 1. Иначе - в 0 <code>(ложь / false)</code>.</strong></li> - <li>Если объект сравнивается с числом или строкой, JavaScript пытается получить значение по умолчанию для данного объекта. Полученное значение преобразуется в примитив, посредством методов <strong><code>valueOf()</code></strong> и <strong><code>toString()</code></strong>. Если преобразовать объект не удаётся, генерируется ошибка времени выполнения.</li> - <li>Обратите внимание на то, что объект преобразуется в примитив, если, и только если, второй операнд является примитивом. В ином случае, операнды сравниваются как объекты, соответственно, операция сравнения вернёт истину в том случае, если внутренние ссылки обоих объектов ссылаются на один и тот же объект в памяти.</li> -</ul> - -<div class="note"><strong>Внимание:</strong> Объекты String имеют тип Object, а не String. Такие объекты используются редко, так что следующий код может вас сильно удивить.</div> - -<pre class="brush:js notranslate">// Истина, так как оба операнда имеют тип String -'foo' === 'foo' - -var a = new String('foo'); -var b = new String('foo'); - -// Ложь, так как операнды являются объектами, внутренние ссылки которых, ссылаются на разные объекты в памяти -a == b - -// Ложь, так как операнды являются объектами, внутренние ссылки которых, ссылаются на разные объекты в памяти -a === b - -// Истина, так как объект a (String) будет преобразован в строку 'foo', перед сопоставлением -a == 'foo' </pre> - -<h2 id="Спецификации">Спецификации</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Спецификация</th> - <th scope="col">Статус</th> - <th scope="col">Комментарий</th> - </tr> - <tr> - <td>{{SpecName('ES1')}}</td> - <td>{{Spec2('ES1')}}</td> - <td>Появление в спецификации. Выполняется в JavaScript 1.0</td> - </tr> - <tr> - <td>{{SpecName('ES3')}}</td> - <td>{{Spec2('ES3')}}</td> - <td>Добавлены операторы <code>===</code> и <code>!==</code>. Выполняется в JavaScript 1.3</td> - </tr> - <tr> - <td>{{SpecName('ES5.1', '#sec-11.8')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td>Определено в нескольких секциях спецификации: <a href="http://www.ecma-international.org/ecma-262/5.1/#sec-11.8">Относительные операторы</a>, <a href="http://www.ecma-international.org/ecma-262/5.1/#sec-11.9">Операторы равенства</a></td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-relational-operators')}}</td> - <td>{{Spec2('ES6')}}</td> - <td>Определено в нескольких секциях спецификации: <a href="http://www.ecma-international.org/ecma-262/5.1/#sec-11.8">Относительные операторы</a>, <a href="http://www.ecma-international.org/ecma-262/5.1/#sec-11.9">Операторы равенства</a></td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-relational-operators')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td>Определено в нескольких секциях спецификации: <a href="http://www.ecma-international.org/ecma-262/5.1/#sec-11.8">Относительные операторы</a>, <a href="http://www.ecma-international.org/ecma-262/5.1/#sec-11.9">Операторы равенства</a></td> - </tr> - </tbody> -</table> - -<h2 id="Поддержка_браузерами">Поддержка браузерами</h2> - -<p>{{CompatibilityTable}}</p> - -<div id="compat-desktop"> -<table class="compat-table"> - <tbody> - <tr> - <th></th> - <th>Chrome</th> - <th>Firefox (Gecko)</th> - <th>Internet Explorer</th> - <th>Opera</th> - <th>Safari</th> - </tr> - <tr> - <td>Базовая поддержка</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td> - <p>{{CompatVersionUnknown}}</p> - </td> - </tr> - </tbody> -</table> -</div> - -<div id="compat-mobile"> -<table class="compat-table" style="height: 73px; width: 1078px;"> - <tbody> - <tr> - <th></th> - <th>Android</th> - <th>Chrome for Android</th> - <th>Firefox Mobile (Gecko)</th> - <th>IE Mobile</th> - <th>Opera Mobile</th> - <th>Safari Mobile</th> - </tr> - <tr> - <td>Базовая поддержка</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - </tr> - </tbody> -</table> -</div> - -<h2 id="Смотрите_также"><br> - Смотрите также</h2> - -<ul> - <li>{{jsxref("Object.is()")}}</li> - <li><a href="/ru/docs/Web/JavaScript/Equality_comparisons_and_sameness">Операторы сравнения и одинаковость</a></li> -</ul> diff --git a/files/ru/conflicting/web/javascript/reference/operators_7c8eb9475d97a4a734c5991857698560/index.html b/files/ru/conflicting/web/javascript/reference/operators_7c8eb9475d97a4a734c5991857698560/index.html deleted file mode 100644 index 8357e8b85a..0000000000 --- a/files/ru/conflicting/web/javascript/reference/operators_7c8eb9475d97a4a734c5991857698560/index.html +++ /dev/null @@ -1,628 +0,0 @@ ---- -title: Битовые операции -slug: >- - conflicting/Web/JavaScript/Reference/Operators_7c8eb9475d97a4a734c5991857698560 -tags: - - JavaScript - - Оператор -translation_of: Web/JavaScript/Reference/Operators -translation_of_original: Web/JavaScript/Reference/Operators/Bitwise_Operators -original_slug: Web/JavaScript/Reference/Operators/Bitwise_Operators ---- -<div>{{jsSidebar("Operators")}}</div> - -<h2 id="Summary" name="Summary">Сводка</h2> - -<p>Битовые операции обращаются со своими операндами как с 32-х разрядными последовательностями нулей и единиц, а не как с десятичными, восьмеричными или шестнадцатеричными числами. К примеру десятичное число 9 в двоичном представлении будет выглядеть как 1001. Битовые операции производят свои преобразования именно с двоичным представлением числа, но возвращают стандартные числовые значения языка JavaScript.</p> - -<table class="fullwidth-table"> - <tbody> - <tr> - <td class="header" colspan="2">Операторы</td> - </tr> - <tr> - <td>Реализованы в:</td> - <td>JavaScript 1.0</td> - </tr> - <tr> - <td>Версия ECMA:</td> - <td>ECMA-262</td> - </tr> - </tbody> -</table> - -<p>Следующая таблица содержит сводные данные о битовых операциях в JavaScript:</p> - -<table class="fullwidth-table"> - <tbody> - <tr> - <th>Оператор</th> - <th>Использование</th> - <th>Описание</th> - </tr> - <tr> - <td>Побитовое И</td> - <td style="white-space: nowrap;"><code>a & b</code></td> - <td>Возвращает 1 в тех разрядах, которые у обоих операндов были равны 1.</td> - </tr> - <tr> - <td>Побитовое ИЛИ</td> - <td style="white-space: nowrap;"><code>a | b</code></td> - <td>Возвращает 1 в тех разрядах, которые хотя бы у одного из операндов были равны 1.</td> - </tr> - <tr> - <td>Побитовое исключающее ИЛИ</td> - <td style="white-space: nowrap;"><code>a ^ b</code></td> - <td>Возвращает 1 в тех позициях, которые только у одного из операндов были равны 1.</td> - </tr> - <tr> - <td>Побитовое НЕ</td> - <td style="white-space: nowrap;"><code>~ a</code></td> - <td>Инвертирует биты операнда.</td> - </tr> - <tr> - <td>Сдвиг влево</td> - <td style="white-space: nowrap;"><code>a << b</code></td> - <td>Сдвигает двоичное представление числа a на b разрядов влево заполняя освободившиеся справа разряды нулями.</td> - </tr> - <tr> - <td>Арифметический сдвиг вправо</td> - <td style="white-space: nowrap;"><code>a >> b</code></td> - <td>Сдвигает двоичное представление числа a на b разрядов вправо. Освобождающиеся разряды заполняются знаковым битом.</td> - </tr> - <tr> - <td>Логический сдвиг вправо</td> - <td style="white-space: nowrap;"><code>a >>> b</code></td> - <td>Сдвигает двоичное представление числа a на b разрядов вправо. Освобождающиеся разряды заполняются нулями.</td> - </tr> - </tbody> -</table> - -<h3 id="Signed_32-bit_integers" name="Signed_32-bit_integers">Представление чисел (Signed 32-bit integers)</h3> - -<p>Операнды всех битовых операций конвертируются в 32-х битовые целые со знаком представленные в дополнительном коде и с использованием порядка битов от "старшего к младшему". Порядок битов "от старшего к младшему" означает, что наиболее значимый бит (бит с наибольшим значением) находится слева если 32-х разрядное число представлено в виде горизонтальной линии (шкалы). Представление в дополнительном коде означает, что отрицательное значение числа (например 5 и -5) получается путём инвертирования числа (операция "побитовое НЕ", также известное как "обратный код") и прибавления к нему единицы.</p> - -<p>Возьмём, к примеру, число 314. Представим его в двоичном коде:</p> - -<pre class="eval">00000000000000000000000100111010 -</pre> - -<p>Следующая строка представляет собой его обратный код или ~314:</p> - -<pre class="eval">11111111111111111111111011000101 -</pre> - -<p>Прибавив к нему единицу, мы получаем двоичное представление числа -314, оно же 314 в дополнительном коде:</p> - -<pre class="eval">11111111111111111111111011000110</pre> - -<p>Дополнение до 2-х гарантирует нам, что у положительного числа самый левый бит равен 0, в то время как у отрицательного он равен 1. Он зовётся <em>знаковым битом</em>.</p> - -<p><br> - Число 0 есть число, у которого во всех битовых позициях записаны нули.</p> - -<pre class="line-numbers language-html"><code class="language-html">0 (base 10) = 00000000000000000000000000000000 </code></pre> - -<p>Число -1 есть число, у которого во всех битовых позициях записаны единицы.</p> - -<pre class="line-numbers language-html"><code class="language-html">-1 (base 10) = 11111111111111111111111111111111 </code></pre> - -<p>Число <code>-2147483648</code> (в шестнадцатеричной системе счисления: <code>-0x80000000</code>) - это вещественное число, которое состоит только из 0, за исключением самого первого слева, который есть 1 (отвечает за знак числа).</p> - -<pre class="line-numbers language-html"><code class="language-html">-2147483648 (base 10) = 10000000000000000000000000000000</code></pre> - -<p>Число <code>2147483648</code> (в шестнадцатеричной системе счисления: <code>0x80000000</code>) - это вещественное число, которое состоит только из 1, за исключением самого первого слева, который есть 0 (отвечает за знак числа).</p> - -<pre class="line-numbers language-html"><code class="language-html">2147483647 (base 10) = 01111111111111111111111111111111</code></pre> - -<p><code>-2147483648 и 2147483647 - это самое минимальное и самое максимальное числа, которые можно представить в 32 разрядной ячейке памяти.</code></p> - -<h2 id="Bitwise_logical_operators" name="Bitwise_logical_operators">Побитовые логические операции</h2> - -<p>Побитовые логические операции работают следующим образом:</p> - -<ul> - <li>Операнды конвертируются в 32-х битовые числа отображаемые последовательностью нулей и единиц. Числа более 32-х бит теряют свои старшие биты. Например:</li> -</ul> - -<pre class="line-numbers language-html"><code class="language-html">До: 11100110111110100000000000000110000000000001 -После: 10100000000000000110000000000001</code> -</pre> - -<ul> - <li>Каждый бит первого операнда считается парным соответствующему биту второго операнда. Первый бит - первому, второй второму и т.д..</li> - <li>Операция применяется к каждой паре битов, and the result is constructed bitwise.</li> -</ul> - -<h3 id="_.28Bitwise_AND.29" name="&_.28Bitwise_AND.29">& (Побитовое AND)</h3> - -<p>Производит побитовое И над каждой парой битов. Операция <code>a</code> AND <code>b</code> вернёт 1 если только и <code>a</code> и <code>b</code> равны 1. Таблица истинности для этой операции выглядит так:</p> - -<table class="standard-table"> - <tbody> - <tr> - <td class="header">a</td> - <td class="header">b</td> - <td class="header">a AND b</td> - </tr> - <tr> - <td>0</td> - <td>0</td> - <td>0</td> - </tr> - <tr> - <td>0</td> - <td>1</td> - <td>0</td> - </tr> - <tr> - <td>1</td> - <td>0</td> - <td>0</td> - </tr> - <tr> - <td>1</td> - <td>1</td> - <td>1</td> - </tr> - </tbody> -</table> - -<p>Пример:</p> - -<pre class="eval"> 9 (основание 10) = 00000000000000000000000000001001 (основание 2) - 14 (основание 10) = 00000000000000000000000000001110 (основание 2) - -------------------------------- -14 & 9 (основание 10) = 00000000000000000000000000001000 (осн. 2) = 8 (осн. 10) -</pre> - -<p>Побитовое AND любого числа x с нулём вернёт 0.</p> - -<p>Побитовое AND любого числа x с числом -1 вернёт х.</p> - -<h3 id="_.28Bitwise_OR.29" name="|_.28Bitwise_OR.29">| (Побитовое OR)</h3> - -<p style="margin-top: 0px; margin-right: 0px; margin-bottom: 1.7em; margin-left: 0px; padding-top: 0px; padding-right: 0px; padding-bottom: 0px; padding-left: 0px;">Производит побитовое ИЛИ над каждой парой битов. Операция <code style="color: rgb(37, 34, 29); font-weight: inherit;">a</code> OR <code style="color: rgb(37, 34, 29); font-weight: inherit;">b</code> вернёт 1 если <code style="color: rgb(37, 34, 29); font-weight: inherit;">a</code> или <code style="color: rgb(37, 34, 29); font-weight: inherit;">b</code> равны 1. Таблица истинности для этой операции выглядит так:</p> - -<table class="standard-table"> - <tbody> - <tr> - <td class="header">a</td> - <td class="header">b</td> - <td class="header">a OR b</td> - </tr> - <tr> - <td>0</td> - <td>0</td> - <td>0</td> - </tr> - <tr> - <td>0</td> - <td>1</td> - <td>1</td> - </tr> - <tr> - <td>1</td> - <td>0</td> - <td>1</td> - </tr> - <tr> - <td>1</td> - <td>1</td> - <td>1</td> - </tr> - </tbody> -</table> - -<pre class="eval">Пример: - -9 (осн. 10) = 00000000000000000000000000001001 (осн. 2) -14 (осн. 10) = 00000000000000000000000000001110 (осн. 2) - -------------------------------- -14 | 9 (осн. 10) = 00000000000000000000000000001111 (осн. 2) = 15 (осн. 10) -</pre> - -<p>Побитовое OR любого числа x c нулём вернёт x.</p> - -<p>Побитовое OR любого числа x с числом -1 вернёт -1.</p> - -<h3 id=".5E_.28Bitwise_XOR.29" name=".5E_.28Bitwise_XOR.29">^ (Побитовое XOR)</h3> - -<p>Производит побитовое XOR над каждой парой битов. Операция <code>a</code> XOR <code>b</code> вернёт 1 если <code>a</code> и <code>b</code> различны. Таблица истинности для этой операции выглядит так:</p> - -<table class="standard-table"> - <tbody> - <tr> - <td class="header">a</td> - <td class="header">b</td> - <td class="header">a XOR b</td> - </tr> - <tr> - <td>0</td> - <td>0</td> - <td>0</td> - </tr> - <tr> - <td>0</td> - <td>1</td> - <td>1</td> - </tr> - <tr> - <td>1</td> - <td>0</td> - <td>1</td> - </tr> - <tr> - <td>1</td> - <td>1</td> - <td>0</td> - </tr> - </tbody> -</table> - -<p>Пример:</p> - -<pre class="eval"> 9 (осн. 10) = 00000000000000000000000000001001 (осн. 2) - 14 (осн. 10) = 00000000000000000000000000001110 (осн. 2) - -------------------------------- -14 ^ 9 (осн. 10) = 00000000000000000000000000000111 (осн. 2) = 7 (осн. 10) -</pre> - -<p>Побитовое XOR любого числа x c нулём вернёт x.</p> - -<p>Побитовое XOR любого числа x c числом -1 вернёт ~x.</p> - -<h3 id=".7E_.28Bitwise_NOT.29" name=".7E_.28Bitwise_NOT.29">~ (Побитовое NOT)</h3> - -<p>Производит операцию NOT над каждым битом. NOT <code>a</code> вернёт побитово инвертированное значение (обратный код) операнда. Таблица истинности для этой операции выглядит так:</p> - -<table class="standard-table"> - <tbody> - <tr> - <td class="header">a</td> - <td class="header">NOT a</td> - </tr> - <tr> - <td>0</td> - <td>1</td> - </tr> - <tr> - <td>1</td> - <td>0</td> - </tr> - </tbody> -</table> - -<p>Пример:</p> - -<pre class="eval"> 9 (осн. 10) = 00000000000000000000000000001001 (осн. 2) - -------------------------------- -~9 (осн. 10) = 11111111111111111111111111110110 (осн. 2) = -10 (осн. 10) -</pre> - -<p>Побитовое NOT любого числа x вернёт -(x + 1). Например, ~5 вернёт -6.</p> - -<h2 id="Bitwise_shift_operators" name="Bitwise_shift_operators">Побитовые операции сдвига</h2> - -<p>Оператор побитового сдвига принимает в себя два операнда: первый - величина, которую сдвигают, второй - число позиций, на которое сдвигаются биты первого операнда. Направление сдвига зависит от используемого оператора.</p> - -<p>Операторы сдвига конвертируют операнды в 32-ух разрядные числа с порядком байтов от старшего к младшему, а результат возвращает того же типа, что и левый операнд.</p> - -<h3 id=".3C.3C_.28Left_shift.29" name=".3C.3C_.28Left_shift.29"><< (Сдвиг влево)</h3> - -<p>Оператор побитового сдвига влево сдвигает первый операнд на заданное число битов влево. Лишние биты отбрасываются.</p> - -<p>Например, <code>9 << 2</code> в результате даст 36:</p> - -<pre class="eval"> 9 (осн. 10): 00000000000000000000000000001001 (осн. 2) - -------------------------------- -9 << 2 (осн. 10): 00000000000000000000000000100100 (осн. 2) = 36 (осн. 10) - - -</pre> - -<p>Побитовй сдвиг любого числа <code>x</code> влево на <code>y</code> бит в результате даёт <code>x * 2 ** y</code>.</p> - -<h3 id=".3E.3E_.28Sign-propagating_right_shift.29" name=".3E.3E_.28Sign-propagating_right_shift.29">>> (Сдвиг вправо с сохранением знака)</h3> - -<p>Оператор побитового сдвига вправо сдвигает первый операнд на заданное число битов вправо. Лишние биты отбрасываются. Слева добавляется заданное число битов равных первому биту исходного числа. Поскольку значение первого бита, определяющего знак числа, останется неизменным, знак получившегося результата будет таким же как у первого аргумента. Отсюда "с сохранением знака" в названии.</p> - -<p>Например, <code>9 >> 2</code> в результате даст 2:</p> - -<pre class="eval"> 9 (осн. 10): 00000000000000000000000000001001 (осн. 2) - -------------------------------- -9 >> 2 (осн. 10): 00000000000000000000000000000010 (осн. 2) = 2 (осн. 10) -</pre> - -<p>Аналогично, <code>-9 >> 2</code> даст в результате -3, так как знак сохранён:</p> - -<pre class="eval"> -9 (осн. 10): 11111111111111111111111111110111 (осн. 2) - -------------------------------- --9 >> 2 (осн. 10): 11111111111111111111111111111101 (осн. 2) = -3 (осн. 10) -</pre> - -<h3 id=".3E.3E_.28Sign-propagating_right_shift.29" name=".3E.3E_.28Sign-propagating_right_shift.29">>>> (Сдвиг вправо с заполнением нулями)</h3> - -<p>Оператор побитового сдвига вправо сдвигает первый операнд на заданное число битов вправо. Лишние биты отбрасываются. Слева добавляется заданное число нулевых битов. Поскольку значение первого бита, определяющего знак числа, становится нулевым, результатом операции всегда будет положительное число.</p> - -<p>Для положительных чисел, сдвиг вправо с сохранением знака и сдвиг вправо с заполнением нулями эквивалентны.</p> - -<p>Например, <code>9 >>> 2</code> даёт в результате 2, как и <code>9 >> 2</code>:</p> - -<pre class="eval"> 9 (осн. 10): 00000000000000000000000000001001 (осн. 2) - -------------------------------- -9 >>> 2 (осн. 10): 00000000000000000000000000000010 (осн. 2) = 2 (осн. 10) -</pre> - -<p>Важно отметить, что для отрицательных результаты будут разными. Например, <code>-9 >>> 2</code> даёт в результате 1073741821, что отличается от результата <code>-9 >> 2</code> (равно -3):</p> - -<pre class="eval"> -9 (осн. 10): 11111111111111111111111111110111 (осн. 2) - -------------------------------- --9 >>> 2 (осн. 10): 00111111111111111111111111111101 (осн. 2) = 1073741821 (осн. 10) -</pre> - -<h3 id="Examples" name="Examples">Примеры</h3> - -<h4 id="Example_Flags_and_bitmasks" name="Example:_Flags_and_bitmasks">Пример: флаги и битовые маски</h4> - -<p>Побитовые логические операторы часто используются для создания, обработки и чтения последовательности флагов, которые осуществляются также, как и двоичные переменные. Переменные могут быть использованы вместо этих последовательностей, но двоичные флаги занимают гораздо меньше памяти (в 32 разрядной ячейке памяти).</p> - -<p>Предположим, существует 4 флага:</p> - -<ul> - <li>флаг A: у нас есть проблема с муравьями</li> - <li>флаг B: у нас есть летучая мышь</li> - <li>флаг C: у нас есть кошка</li> - <li>флаг D: у нас есть утка</li> -</ul> - -<p>Эти флаги представлены последовательностью битов: DCBA. Считается, что флаг <em>установлен (the flag is set)</em>, если его значение равно 1. Флаг <em>сброшен (the flag is cleared)</em>, если его значение равно 0. Предположим, что переменная <code>flags</code> содержит двоичное значение 0101:</p> - -<pre class="eval">var flags = 0x5; // двоичное 0101 -</pre> - -<p>Из этого значения следует:</p> - -<ul> - <li>флаг A установлен (у нас есть проблема с муравьями);</li> - <li>флаг B сброшен (у нас нет летучей мыши);</li> - <li>флаг C установлен (у нас есть кошка);</li> - <li>флаг D сброшен (у нас нет утки);</li> -</ul> - -<p>Так как битовые операторы 32-битные, то 0101 в действительности представлено значением 00000000000000000000000000000101, но ведущие нули могут быть опущены, потому, что не содержат значимой информации.</p> - -<p><em>Битовая маска, </em>это последовательность битов, которая позволяет манипулировать и/или считывать значения флагов. Обычно для каждого флага задаётся "примитивная" битовая маска:</p> - -<pre class="eval">var FLAG_A = 0x1; // 0001 -var FLAG_B = 0x2; // 0010 -var FLAG_C = 0x4; // 0100 -var FLAG_D = 0x8; // 1000 -</pre> - -<p>New bitmasks can be created by using the bitwise logical operators on these primitive bitmasks. For example, the bitmask 1011 can be created by ORing FLAG_A, FLAG_B, and FLAG_D:</p> - -<pre class="eval">var mask = FLAG_A | FLAG_B | FLAG_D; // 0001 | 0010 | 1000 => 1011 -</pre> - -<p>Individual flag values can be extracted by ANDing them with a bitmask, where each bit with the value of one will "extract" the corresponding flag. The bitmask <em>masks</em> out the non-relevant flags by ANDing with zeros (hence the term "bitmask"). For example, the bitmask 0100 can be used to see if flag C is set:</p> - -<pre class="eval">// if we own a cat -if (flags & FLAG_C) { // 0101 & 0100 => 0100 => true - // do stuff -} -</pre> - -<p>A bitmask with multiple set flags acts like an "either/or". For example, the following two are equivalent:</p> - -<pre class="eval">// if we own a bat or we own a cat -if ((flags & FLAG_B) || (flags & FLAG_C)) { // (0101 & 0010) || (0101 & 0100) => 0000 || 0100 => true - // do stuff -} -</pre> - -<pre class="eval">// if we own a bat or cat -var mask = FLAG_B | FLAG_C; // 0010 | 0100 => 0110 -if (flags & mask) { // 0101 & 0110 => 0100 => true - // do stuff -} -</pre> - -<p>Flags can be set by ORing them with a bitmask, where each bit with the value one will set the corresponding flag, if that flag isn't already set. For example, the bitmask 1010 can be used to set flags C and D:</p> - -<pre class="eval">// yes, we own a cat and a duck -var mask = FLAG_C | FLAG_D; // 0100 | 1000 => 1100 -flags |= mask; // 0101 | 1100 => 1101 -</pre> - -<p>Flags can be cleared by ANDing them with a bitmask, where each bit with the value zero will clear the corresponding flag, if it isn't already cleared. This bitmask can be created by NOTing primitive bitmasks. For example, the bitmask 1010 can be used to clear flags A and C:</p> - -<pre class="eval">// no, we don't neither have an ant problem nor own a cat -var mask = ~(FLAG_A | FLAG_C); // ~0101 => 1010 -flags &= mask; // 1101 & 1010 => 1000 -</pre> - -<p>The mask could also have been created with <code>~FLAG_A & ~FLAG_C</code> (De Morgan's law):</p> - -<pre class="eval">// no, we don't have an ant problem, and we don't own a cat -var mask = ~FLAG_A & ~FLAG_C; -flags &= mask; // 1101 & 1010 => 1000 -</pre> - -<p>Flags can be toggled by XORing them with a bitmask, where each bit with the value one will toggle the corresponding flag. For example, the bitmask 0110 can be used to toggle flags B and C:</p> - -<pre class="eval">// if we didn't have a bat, we have one now, and if we did have one, bye-bye bat -// same thing for cats -var mask = FLAG_B | FLAG_C; -flags = flags ^ mask; // 1100 ^ 0110 => 1010 -</pre> - -<p>Finally, the flags can all be flipped with the NOT operator:</p> - -<pre class="eval">// entering parallel universe... -flags = ~flags; // ~1010 => 0101 - -</pre> - -<h2 id="Совместимость_с_браузерами">Совместимость с браузерами</h2> - -<p>{{ CompatibilityTable() }}</p> - -<div id="compat-desktop"> -<table class="compat-table"> - <tbody> - <tr> - <th>Возможность</th> - <th>Chrome</th> - <th>Firefox (Gecko)</th> - <th>Internet Explorer</th> - <th>Opera</th> - <th>Safari</th> - </tr> - <tr> - <td><a href="#Bitwise_NOT">Битовый NOT (<code>~</code>)</a></td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatVersionUnknown() }}</td> - </tr> - <tr> - <td><a href="#Bitwise_AND">Битовый AND (<code>&</code>)</a></td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatVersionUnknown() }}</td> - </tr> - <tr> - <td><a href="#Bitwise_OR">Битовый OR (<code>|</code>)</a></td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatVersionUnknown() }}</td> - </tr> - <tr> - <td><a href="#Bitwise_XOR">Битовый XOR (<code>^</code>)</a></td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatVersionUnknown() }}</td> - </tr> - <tr> - <td><a href="#Left_shift">Сдвиг влево (<code><<</code>)</a></td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatVersionUnknown() }}</td> - </tr> - <tr> - <td><a href="#Right_shift">Сдвиг вправо (<code>>></code>)</a></td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatVersionUnknown() }}</td> - </tr> - <tr> - <td><a href="#Unsigned_right_shift">Беззнаковый сдвиг вправо (<code>>>></code>)</a></td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatVersionUnknown() }}</td> - </tr> - </tbody> -</table> -</div> - -<div id="compat-mobile"> -<table class="compat-table"> - <tbody> - <tr> - <th>Возможность</th> - <th>Android</th> - <th>Chrome for Android</th> - <th>Firefox Mobile (Gecko)</th> - <th>IE Mobile</th> - <th>Opera Mobile</th> - <th>Safari Mobile</th> - </tr> - <tr> - <td><a href="#Bitwise_NOT">Битовый NOT (<code>~</code>)</a></td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatVersionUnknown() }}</td> - </tr> - <tr> - <td><a href="#Bitwise_AND">Битовый AND (<code>&</code>)</a></td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatVersionUnknown() }}</td> - </tr> - <tr> - <td><a href="#Bitwise_OR">Битовый OR (<code>|</code>)</a></td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatVersionUnknown() }}</td> - </tr> - <tr> - <td><a href="#Bitwise_XOR">Битовый XOR (<code>^</code>)</a></td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatVersionUnknown() }}</td> - </tr> - <tr> - <td><a href="#Left_shift">Сдвиг влево (<code><<</code>)</a></td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatVersionUnknown() }}</td> - </tr> - <tr> - <td><a href="#Right_shift">Сдвиг вправо (<code>>></code>)</a></td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatVersionUnknown() }}</td> - </tr> - <tr> - <td><a href="#Unsigned_right_shift">Беззнаковый сдвиг вправо (<code>>>></code>)</a></td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatVersionUnknown() }}</td> - </tr> - </tbody> -</table> -</div> - -<h2 id="See_also" name="See_also">Смотрите также</h2> - -<ul> - <li><a class="external" href="http://ru.wikipedia.org/wiki/%D0%91%D0%B8%D1%82%D0%BE%D0%B2%D1%8B%D0%B5_%D0%BE%D0%BF%D0%B5%D1%80%D0%B0%D1%86%D0%B8%D0%B8" title="http://ru.wikipedia.org/wiki/Битовые_операции">Wikipedia Битовые операции</a></li> - <li><a class="external" href="http://ru.wikipedia.org/wiki/%D0%94%D0%BE%D0%BF%D0%BE%D0%BB%D0%BD%D0%B8%D1%82%D0%B5%D0%BB%D1%8C%D0%BD%D1%8B%D0%B9_%D0%BA%D0%BE%D0%B4_(%D0%BF%D1%80%D0%B5%D0%B4%D1%81%D1%82%D0%B0%D0%B2%D0%BB%D0%B5%D0%BD%D0%B8%D0%B5_%D1%87%D0%B8%D1%81%D0%BB%D0%B0)" title="http://ru.wikipedia.org/wiki/Дополнительный_код_(представление_числа)">Wikipedia Дополнительный код</a></li> - <li><a class="external" href="http://ru.wikipedia.org/wiki/%D0%9E%D0%B1%D1%80%D0%B0%D1%82%D0%BD%D1%8B%D0%B9_%D0%BA%D0%BE%D0%B4_(%D0%BF%D1%80%D0%B5%D0%B4%D1%81%D1%82%D0%B0%D0%B2%D0%BB%D0%B5%D0%BD%D0%B8%D0%B5_%D1%87%D0%B8%D1%81%D0%BB%D0%B0)" title="http://ru.wikipedia.org/wiki/Обратный_код_(представление_числа)">Wikipedia Обратный код</a></li> - <li><a href="/ru/docs/Web/JavaScript/Reference/Operators/Logical_Operators">Логические операции</a></li> -</ul> diff --git a/files/ru/conflicting/web/javascript/reference/operators_843c998343f0cdaa5699874c806d4cea/index.html b/files/ru/conflicting/web/javascript/reference/operators_843c998343f0cdaa5699874c806d4cea/index.html deleted file mode 100644 index b5f93ec4e7..0000000000 --- a/files/ru/conflicting/web/javascript/reference/operators_843c998343f0cdaa5699874c806d4cea/index.html +++ /dev/null @@ -1,302 +0,0 @@ ---- -title: Логические операторы -slug: >- - conflicting/Web/JavaScript/Reference/Operators_843c998343f0cdaa5699874c806d4cea -translation_of: Web/JavaScript/Reference/Operators -translation_of_original: Web/JavaScript/Reference/Operators/Logical_Operators -original_slug: Web/JavaScript/Reference/Operators/Логические_операторы ---- -<div>{{jsSidebar("Operators")}}</div> - -<div>Логические операторы используются, как правило, с примитивами {{jsxref("Boolean")}} (логического) типа. В этом случае результатом работы оператора является значение типа Boolean. Между тем операторы && и || возвращают, вообще говоря, значение одного из операнда, потому при использовании в качестве аргументов этих операторов величин, тип которых отличен от Boolean, тип возвращаемого значения может быть отличным от Boolean.</div> - -<div></div> - -<h2 id="Описание">Описание</h2> - -<p>В таблице приведены описания логических операторов:</p> - -<table class="fullwidth-table"> - <tbody> - <tr> - <th>Оператор</th> - <th>Использование</th> - <th>Описание</th> - </tr> - <tr> - <td>Логическое И (&&)</td> - <td><code><em>expr1</em> && <em>expr2</em></code></td> - <td>Возвращает значение <code>expr1</code>, если оно может быть преобразовано в false; иначе возвращает значение <code>expr2</code>. Таким образом, при использовании с величинами типа Boolean оператор && вернёт true, если оба операнда могут быть преобразованы в true; иначе оператор && вернёт false. </td> - </tr> - <tr> - <td>Логическое ИЛИ (<code>||</code>)</td> - <td><code><em>expr1</em> || <em>expr2</em></code></td> - <td> - <p>Возвращает значение <code>expr1</code>, если оно может быть преобразовано в true; иначе возвращает значение <code>expr2.</code> Таким образом, при использовании с величинами типа Boolean оператор <code>||</code> вернёт <code>true</code> если хоть один из них равен <code>true</code>; в других случаях вернёт <code>false</code>.</p> - </td> - </tr> - <tr> - <td>Логическое НЕ (<code>!</code>)</td> - <td><code>!<em>expr</em></code></td> - <td>Возвращает false если значение <code>expr </code>можно<font face="Consolas, Liberation Mono, Courier, monospace"> </font>привести к <code>true</code>; в противоположном случае возвращает <code>true</code>.</td> - </tr> - </tbody> -</table> - -<p>Примеры значений выражений, которые могут быть преобразованы в <code>false</code>:</p> - -<ul> - <li><code>null</code>;</li> - <li><code>NaN;</code></li> - <li><code>0</code>;</li> - <li>пустая строка (<code>""</code>); </li> - <li><code>undefined</code>.</li> -</ul> - -<p>Хоть операторы <code>&&</code> и <code>||</code> могут использовать операнды с не булевыми значениями, но они всё равно рассматриваются, как булевы операторы, т.к. их возвращаемые ими значения всегда могут быть сконвертированы в булевы значения.</p> - -<h3 id="Короткая_схема_вычислений">Короткая схема вычислений</h3> - -<p>Так как логические операторы выполняются слева направо, они проверяются на "короткие вычисления" по следующим правилам:</p> - -<ul> - <li><code>false && (<em>anything)</em></code> короткое вычисление дающее false.</li> - <li><code>true || (<em>anything)</em></code> короткое замыкание дающее true.</li> -</ul> - -<p>Часть выражения <code>(<em>anything)</em></code> не вычисляется. Если в ней есть вызов функции, то эта функция не будет вызвана.</p> - -<p>Например, следующие две функции делают одно и тоже:</p> - -<pre class="brush: js">function shortCircuitEvaluation() { - doSomething() || doSomethingElse() -} - -function equivalentEvaluation() { - var flag = doSomething(); - if (!flag) { - doSomethingElse(); - } -} -</pre> - -<p>Однако, следующие выражения дают разный результат в связи с <a href="/ru/docs/Web/JavaScript/Reference/Operators/Operator_Precedence">приоритетом операторов</a>.</p> - -<pre class="brush: js">false && true || true // вернёт true -false && (true || true) // вернёт false</pre> - -<h3 id="Логическое_И"><a name="Logical_AND">Логическое И (<code>&&</code>)</a></h3> - -<p>Следующий код показывает пример оператора <code>&&</code> (логическое И).</p> - -<pre class="brush: js">a1 = true && true // t && t вернёт true -a2 = true && false // t && f вернёт false -a3 = false && true // f && t вернёт false -a4 = false && (3 == 4) // f && f вернёт false -a5 = "Cat" && "Dog" // t && t вернёт "Dog" -a6 = false && "Cat" // f && t вернёт false -a7 = "Cat" && false // t && f вернёт false -</pre> - -<h3 id="Логическое_ИЛИ"><a name="Logical_OR">Логическое ИЛИ (<code>||</code>)</a></h3> - -<p>Это код представляет собой пример оператора <code>||</code> (логическое ИЛИ).</p> - -<pre class="brush: js">o1 = true || true // t || t вернёт true -o2 = false || true // f || t вернёт true -o3 = true || false // t || f вернёт true -o4 = false || (3 == 4) // f || f вернёт false -o5 = "Cat" || "Dog" // t || t вернёт "Cat" -o6 = false || "Cat" // f || t вернёт "Cat" -o7 = "Cat" || false // t || f вернёт "Cat" -</pre> - -<h3 id="Логическое_НЕ_!"><a name="Logical_NOT">Логическое НЕ (<code>!</code>)</a></h3> - -<p>Следующий код является примером оператора <code>!</code> (логическое НЕ).</p> - -<pre class="brush: js">n1 = !true // !t вернёт false -n2 = !false // !f вернёт true -n3 = !"Cat" // !t вернёт false -</pre> - -<h3 id="Правила_преобразования">Правила преобразования</h3> - -<h4 id="Конвертирование_И_в_ИЛИ">Конвертирование И в ИЛИ</h4> - -<p>следующая операция использует булев тип:</p> - -<pre class="brush: js">bCondition1 && bCondition2</pre> - -<p>это всегда равно:</p> - -<pre class="brush: js">!(!bCondition1 || !bCondition2)</pre> - -<h4 id="Конвертирование_ИЛИ_в_И">Конвертирование ИЛИ в И</h4> - -<p>эта операция использует булев тип:</p> - -<pre class="brush: js">bCondition1 || bCondition2</pre> - -<p>что эквивалентно:</p> - -<pre class="brush: js">!(!bCondition1 && !bCondition2)</pre> - -<h4 id="Конвертирование_многих_НЕ">Конвертирование многих НЕ</h4> - -<p>следующая операция использует булев тип:</p> - -<pre class="brush: js">!!bCondition</pre> - -<p>что равно:</p> - -<pre class="brush: js">bCondition</pre> - -<h3 id="Удаление_вложенных_скобок">Удаление вложенных скобок</h3> - -<p>Так как логические выражения выполняются слева направо, становится возможным удалить круглые скобки из комплексного выражения, следуя следующим правилам.</p> - -<h4 id="Удаление_вложенных_И">Удаление вложенных И</h4> - -<p>Это составное выражение использует булев тип:</p> - -<pre class="brush: js">bCondition1 || (bCondition2 && bCondition3)</pre> - -<p>что будет равным:</p> - -<pre class="brush: js">bCondition1 || bCondition2 && bCondition3</pre> - -<h4 id="Удаление_вложенного_ИЛИ">Удаление вложенного ИЛИ</h4> - -<p>Следующее составное выражение использует булев тип:</p> - -<pre class="brush: js">bCondition1 && (bCondition2 || bCondition3)</pre> - -<p>всегда равно:</p> - -<pre class="brush: js">!(!bCondition1 || !bCondition2 && !bCondition3)</pre> - -<h2 id="Спецификации">Спецификации</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Спецификация</th> - <th scope="col">Статус</th> - <th scope="col">Комментарий</th> - </tr> - <tr> - <td>{{SpecName('ES5.1')}}</td> - <td>{{Spec2('ES1')}}</td> - <td>Изначальное определение</td> - </tr> - <tr> - <td>{{SpecName('ES5.1', '#sec-11.11')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td>Определено в нескольких секциях спецификации: <a href="http://www.ecma-international.org/ecma-262/5.1/#sec-11.4.9">Логический оператор НЕ</a>, <a href="http://www.ecma-international.org/ecma-262/5.1/#sec-11.11">Бинарные логические операторы</a></td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-binary-logical-operators')}}</td> - <td>{{Spec2('ES6')}}</td> - <td>Определено в нескольких секциях спецификации: <a href="http://www.ecma-international.org/ecma-262/5.1/#sec-11.4.9">Логический оператор НЕ</a>, <a href="http://www.ecma-international.org/ecma-262/5.1/#sec-11.11">Бинарные логические операторы</a></td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-binary-logical-operators')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td>Определено в нескольких секциях спецификации: <a href="http://tc39.github.io/ecma262/#sec-logical-not-operator">Логический оператор НЕ</a>, <a href="http://tc39.github.io/ecma262/#sec-binary-logical-operators">Бинарные логические операторы</a></td> - </tr> - </tbody> -</table> - -<h2 id="Поддержка_браузерами">Поддержка браузерами</h2> - -<p>{{CompatibilityTable}}</p> - -<div id="compat-desktop"> -<table class="compat-table"> - <tbody> - <tr> - <th>Возможность</th> - <th>Chrome</th> - <th>Firefox (Gecko)</th> - <th>Internet Explorer</th> - <th>Opera</th> - <th>Safari</th> - </tr> - <tr> - <td><a href="#Logical_AND">Логическое И (<code>&&</code>)</a></td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - </tr> - <tr> - <td><a href="#Logical_OR">Логическое ИЛИ (<code>||</code>)</a></td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - </tr> - <tr> - <td><a href="#Logical_NOT">Логическое НЕ (<code>!</code>)</a></td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - </tr> - </tbody> -</table> -</div> - -<div id="compat-mobile"> -<table class="compat-table"> - <tbody> - <tr> - <th>Возможность</th> - <th>Android</th> - <th>Chrome for Android</th> - <th>Firefox Mobile (Gecko)</th> - <th>IE Mobile</th> - <th>Opera Mobile</th> - <th>Safari Mobile</th> - </tr> - <tr> - <td><a href="#Logical_AND">Логическое И (<code>&&</code>)</a></td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - </tr> - <tr> - <td><a href="#Logical_OR">Логическое ИЛИ (<code>||</code>)</a></td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - </tr> - <tr> - <td><a href="#Logical_NOT">Логическое НЕ (<code>!</code>)</a></td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - </tr> - </tbody> -</table> -</div> - -<h2 id="Смотрите_также">Смотрите также</h2> - -<ul> - <li><a href="/ru/docs/Web/JavaScript/Reference/Operators/Bitwise_Operators">Битовые операторы</a></li> - <li><a href="/ru/docs/Web/JavaScript/Reference/Global_Objects/Boolean">Boolean</a></li> -</ul> diff --git a/files/ru/conflicting/web/javascript/reference/operators_8d54701de06af40a7c984517cbe87b3e/index.html b/files/ru/conflicting/web/javascript/reference/operators_8d54701de06af40a7c984517cbe87b3e/index.html deleted file mode 100644 index 98a8d2af79..0000000000 --- a/files/ru/conflicting/web/javascript/reference/operators_8d54701de06af40a7c984517cbe87b3e/index.html +++ /dev/null @@ -1,433 +0,0 @@ ---- -title: Операторы присваивания -slug: >- - conflicting/Web/JavaScript/Reference/Operators_8d54701de06af40a7c984517cbe87b3e -tags: - - JavaScript - - Оператор -translation_of: Web/JavaScript/Reference/Operators#Assignment_operators -translation_of_original: Web/JavaScript/Reference/Operators/Assignment_Operators -original_slug: Web/JavaScript/Reference/Operators/Assignment_Operators ---- -<div>{{jsSidebar("Operators")}}</div> - -<p><strong>Оператор присваивания</strong> присваивает левому операнду значение, основанное на значении правого операнда.</p> - -<h2 id="Описание">Описание</h2> - -<p>Основной оператор присваивания - это знак равно (<code>=</code>), он и присваивает значение правого операнда, левому. То есть - <code>x = y</code> присваивает значение переменной <code>y</code>, переменной <code>x</code>. Другие операторы присваивания, как следует из приведённой ниже таблицы с определениями и примерами, являются сокращениями стандартных операций.</p> - -<table class="standard-table"> - <tbody> - <tr> - <th>Имя</th> - <th>Сокращённый оператор</th> - <th>Смысл</th> - </tr> - <tr> - <td><a href="#Assignment">Присваивание</a></td> - <td><code>x = y</code></td> - <td><code>x = y</code></td> - </tr> - <tr> - <td><a href="#Addition_assignment">Присваивание со сложением</a></td> - <td><code>x += y</code></td> - <td><code>x = x + y</code></td> - </tr> - <tr> - <td><a href="#Subtraction_assignment">Присваивание с вычитанием</a></td> - <td><code>x -= y</code></td> - <td><code>x = x - y</code></td> - </tr> - <tr> - <td><a href="#Multiplication_assignment">Присваивание с умножением</a></td> - <td><code>x *= y</code></td> - <td><code>x = x * y</code></td> - </tr> - <tr> - <td><a href="#Division_assignment">Присваивание с делением</a></td> - <td><code>x /= y</code></td> - <td><code>x = x / y</code></td> - </tr> - <tr> - <td><a href="#Remainder_assignment">Присваивание по модулю</a></td> - <td><code>x %= y</code></td> - <td><code>x = x % y</code></td> - </tr> - <tr> - <td><a href="#Left_shift_assignment">Присваивание с левым сдвигом</a></td> - <td><code>x <<= y</code></td> - <td><code>x = x << y</code></td> - </tr> - <tr> - <td><a href="#Right_shift_assignment">Присваивание с правым сдвигом</a></td> - <td><code>x >>= y</code></td> - <td><code>x = x >> y</code></td> - </tr> - <tr> - <td><a href="#Unsigned_right_shift_assignment">Присваивание с беззнаковым сдвигом вправо</a></td> - <td><code>x >>>= y</code></td> - <td><code>x = x >>> y</code></td> - </tr> - <tr> - <td><a href="#Bitwise_AND_assignment">Присваивание с побитовым AND</a></td> - <td><code>x &= y</code></td> - <td><code>x = x & y</code></td> - </tr> - <tr> - <td><a href="#Bitwise_XOR_assignment">Присваивание с побитовым XOR</a></td> - <td><code>x ^= y</code></td> - <td><code>x = x ^ y</code></td> - </tr> - <tr> - <td><a href="#Bitwise_OR_assignment">Присваивание с побитовым OR</a></td> - <td><code>x |= y</code></td> - <td><code>x = x | y</code></td> - </tr> - </tbody> -</table> - -<h2 id="Присваивание">Присваивание</h2> - -<p>Простой оператор присваивания, который задаёт значение переменной. Цепочка операторов присваивания может быть использована для назначения нескольким переменным одного и того же значения. Смотрите пример.</p> - -<h4 id="Синтаксис">Синтаксис</h4> - -<pre class="syntaxbox"><strong>Оператор:</strong> x = y -</pre> - -<h4 id="Примеры">Примеры</h4> - -<pre class="brush: js">// Например, следующие переменные: -// x = 5 -// y = 10 -// z = 25 - -x = y // x - 10 -x = y = z // x, y и z все равны 25 -</pre> - -<h2 id="Присваивание_со_сложением">Присваивание со сложением</h2> - -<p>Оператор добавочного присваивания, <strong>добавляет</strong> значение правого операнда к значению левого, и сохраняет результат в переменную левого операнда.<strong> </strong>Типы значений обоих операндов, определяют поведение оператора добавочного присваивания. Возможны сложение и конкатенация. Смотрите {{jsxref("Operators/Arithmetic_Operators", "addition operator", "#Addition", 1)}} для подробностей.</p> - -<h4 id="Синтаксис_2">Синтаксис</h4> - -<pre class="syntaxbox"><strong>Оператор:</strong> x += y -<strong>Значение:</strong> x = x + y -</pre> - -<h4 id="Примеры_2">Примеры</h4> - -<pre class="brush: js">// Например, следующие переменные: -// foo = "foo" -// bar = 5 -// baz = true - -// Результат исполнения каждого нижеприведённого примера -// представлен в изоляции от предыдущих примеров (как если -// бы значения переменных foo, bar, baz возвращались на -// первоначальные) - -// Number + Number -> сложение -bar += 2 // 7 - -// Boolean + Number -> сложение -baz += 1 // 2 - -// Boolean + Boolean -> сложение -baz += false // 1 - -// Number + String -> конкатенация -bar += "foo" // "5foo" - -// String + Boolean -> конкатенация -foo += false // "foofalse" - -// String + String -> конкатенация -foo += "bar" // "foobar" -</pre> - -<h2 id="Присваивание_с_вычитанием">Присваивание с вычитанием</h2> - -<p>Оператор вычитаемого присваивания <strong>вычитает</strong> значение правого операнда из значения левого, и присваивает результат переменной левого операнда. Смотрите {{jsxref("Operators/Arithmetic_Operators", "subtraction operator", "#Subtraction", 1)}} для подробностей.</p> - -<h4 id="Синтаксис_3">Синтаксис</h4> - -<pre class="syntaxbox"><strong>Оператор:</strong> x -= y -<strong>Значение:</strong> x = x - y -</pre> - -<h4 id="Примеры_3">Примеры</h4> - -<pre class="brush: js">// Например, следующие переменные: -// bar = 5 - -bar -= 2 // 3 -bar -= "foo" // NaN -</pre> - -<h3 id="Присваивание_с_умножением"><a name="Multiplication_assignment">Присваивание с умножением</a></h3> - -<p>The multiplication assignment operator <strong>multiplies</strong> a variable by the value of the right operand and assigns the result to the variable. See the {{jsxref("Operators/Arithmetic_Operators", "multiplication operator", "#Multiplication", 1)}} for more details.</p> - -<h4 id="Синтаксис_4">Синтаксис</h4> - -<pre class="syntaxbox"><strong>Оператор:</strong> x *= y -<strong>Значение:</strong> x = x * y -</pre> - -<h4 id="Примеры_4">Примеры</h4> - -<pre class="brush: js">// Assuming the following variable -// bar = 5 - -bar *= 2 // 10 -bar *= "foo" // NaN -</pre> - -<h3 id="Присваивание_с_делением"><a name="Division_assignment">Присваивание с делением</a></h3> - -<p>The division assignment operator <strong>divides</strong> a variable by the value of the right operand and assigns the result to the variable. See the {{jsxref("Operators/Arithmetic_Operators", "division operator", "#Division", 1)}} for more details.</p> - -<h4 id="Синтаксис_5">Синтаксис</h4> - -<pre class="syntaxbox"><strong>Оператор:</strong> x /= y -<strong>Значение:</strong> x = x / y -</pre> - -<h4 id="Примеры_5">Примеры</h4> - -<pre class="brush: js">// Assuming the following variable -// bar = 5 - -bar /= 2 // 2.5 -bar /= "foo" // NaN -bar /= 0 // Infinity -</pre> - -<h3 id="Присваивание_по_модулю"><a name="Remainder_assignment">Присваивание по модулю</a></h3> - -<p>The remainder assignment operator <strong>divides</strong> a variable by the value of the right operand and assigns the <strong>remainder</strong> to the variable. See the {{jsxref("Operators/Arithmetic_Operators", "remainder operator", "#Remainder", 1)}} for more details.</p> - -<h4 id="Синтаксис_6">Синтаксис</h4> - -<pre class="syntaxbox"><strong>Оператор:</strong> x %= y -<strong>Значение:</strong> x = x % y -</pre> - -<h4 id="Примеры_6">Примеры</h4> - -<pre class="brush: js">// Assuming the following variable -// bar = 5 - -bar %= 2 // 1 -bar %= "foo" // NaN -bar %= 0 // NaN -</pre> - -<h3 id="Присваивание_с_левым_сдвигом"><a name="Left_shift_assignment">Присваивание с левым сдвигом</a></h3> - -<p>The left shift assignment operator moves the specified amount of bits to the left and assigns the result to the variable. See the {{jsxref("Operators/Bitwise_Operators", "left shift operator", "#Left_shift", 1)}} for more details.</p> - -<h4 id="Синтаксис_7">Синтаксис</h4> - -<pre class="syntaxbox"><strong>Оператор:</strong> x <<= y -<strong>Значение:</strong> x = x << y -</pre> - -<h4 id="Примеры_7">Примеры</h4> - -<pre class="brush: js">var bar = 5; // (00000000000000000000000000000101) -bar <<= 2; // 20 (00000000000000000000000000010100) -</pre> - -<h3 id="Присваивание_с_правым_сдвигом"><a name="Right_shift_assignment">Присваивание с правым сдвигом</a></h3> - -<p>The right shift assignment operator moves the specified amount of bits to the right and assigns the result to the variable. See the {{jsxref("Operators/Bitwise_Operators", "right shift operator", "#Right_shift", 1)}} for more details.</p> - -<h4 id="Синтаксис_8">Синтаксис</h4> - -<pre class="syntaxbox"><strong>Оператор:</strong> x >>= y -<strong>Значение:</strong> x = x >> y -</pre> - -<h4 id="Примеры_8">Примеры</h4> - -<pre class="brush: js">var bar = 5; // (00000000000000000000000000000101) -bar >>= 2; // 1 (00000000000000000000000000000001) - -var bar -5; // (-00000000000000000000000000000101) -bar >>= 2; // -2 (-00000000000000000000000000000010) -</pre> - -<h3 id="Присваивание_с_беззнаковым_сдвигом_вправо"><a name="Unsigned_right_shift_assignment">Присваивание с беззнаковым сдвигом вправо</a></h3> - -<p>The unsigned right shift assignment operator moves the specified amount of bits to the right and assigns the result to the variable. See the {{jsxref("Operators/Bitwise_Operators", " unsigned right shift operator", "#Unsigned_right_shift", 1)}} for more details.</p> - -<h4 id="Синтаксис_9">Синтаксис</h4> - -<pre class="syntaxbox"><strong>Оператор:</strong> x >>>= y -<strong>Значение:</strong> x = x >>> y -</pre> - -<h4 id="Примеры_9">Примеры</h4> - -<pre class="brush: js">var bar = 5; // (00000000000000000000000000000101) -bar >>>= 2; // 1 (00000000000000000000000000000001) - -var bar = -5; // (-00000000000000000000000000000101) -bar >>>= 2; // 1073741822 (00111111111111111111111111111110)</pre> - -<h3 id="Присваивание_с_побитовым_AND"><a name="Bitwise_AND_assignment">Присваивание с побитовым AND</a></h3> - -<p>The bitwise AND assignment operator uses the binary representation of both operands, does a bitwise AND operation on them and assigns the result to the variable. See the {{jsxref("Operators/Bitwise_Operators", "bitwise AND operator", "#Bitwise_AND", 1)}} for more details.</p> - -<h4 id="Синтаксис_10">Синтаксис</h4> - -<pre class="syntaxbox"><strong>Оператор:</strong> x &= y -<strong>Значение:</strong> x = x & y -</pre> - -<h4 id="Примеры_10">Примеры</h4> - -<pre class="brush: js">var bar = 5; -// 5: 00000000000000000000000000000101 -// 2: 00000000000000000000000000000010 -bar &= 2; // 0 -</pre> - -<h3 id="Присваивание_с_побитовым_XOR"><a name="Bitwise_XOR_assignment">Присваивание с побитовым XOR</a></h3> - -<p>Побитовый оператор присваивания XOR использует двоичное представление обоих операндов, выполняет побитовую XOR-операцию и присваивает результат переменной. Для получения более подробной информации см. {{jsxref("Operators/Bitwise_Operators", "Побитовый оператор XOR", "#Bitwise_XOR", 1)}}.</p> - -<h4 id="Синтаксис_11">Синтаксис</h4> - -<pre class="syntaxbox"><strong>Оператор:</strong> x ^= y -<strong>Значение:</strong> x = x ^ y -</pre> - -<h4 id="Примеры_11">Примеры</h4> - -<pre class="brush: js">var bar = 5; -bar ^= 2; // 7 -// 5: 00000000000000000000000000000101 -// 2: 00000000000000000000000000000010 -// ----------------------------------- -// 7: 00000000000000000000000000000111 -</pre> - -<h3 id="Присваиванием_с_побитовым_OR"><a name="Bitwise_OR_assignment">Присваиванием с побитовым OR</a></h3> - -<p>Побитовый оператор присваивания OR использует двоичное (бинарное) представление обоих операндов, выполняет побитовое ИЛИ для них и присваивает результат переменной. Дополнительную информацию см. {{jsxref("Operators/Bitwise_Operators", "Побитовый оператор OR", "#Bitwise_OR", 1)}}.</p> - -<h4 id="Синтаксис_12">Синтаксис</h4> - -<pre class="syntaxbox"><strong>Оператор:</strong> x |= y -<strong>Значение:</strong> x = x | y -</pre> - -<h4 id="Примеры_12">Примеры</h4> - -<pre class="brush: js">var bar = 5; -bar |= 2; // 7 -// 5: 00000000000000000000000000000101 -// 2: 00000000000000000000000000000010 -// ----------------------------------- -// 7: 00000000000000000000000000000111 -</pre> - -<h2 id="Примеры_13">Примеры</h2> - -<h3 id="Левый_операнд_с_другим_оператором_присваивания">Левый операнд с другим оператором присваивания</h3> - -<p>В необычных ситуациях оператор присваивания, например, <em>x += y</em> не идентичен выражению, <em>x = x + y</em>. Когда левый операнд оператора присваивания содержит оператор присваивания, левый операнд оценивается только один раз. Например:</p> - -<pre class="brush: js">a[i++] += 5 // i оценивается только один раз -a[i++] = a[i++] + 5 // i оценивается дважды -</pre> - -<h2 id="Спецификации">Спецификации</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Спецификация</th> - <th scope="col">Статус</th> - <th scope="col">Комментарий</th> - </tr> - <tr> - <td>ECMAScript 1-е издание.</td> - <td>Стандарт</td> - <td>Изначальное определение.</td> - </tr> - <tr> - <td>{{SpecName('ES5.1', '#sec-11.13', 'Операторы присваивания')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-assignment-operators', 'Операторы присваивания')}}</td> - <td>{{Spec2('ES6')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Совместимость_с_браузерами">Совместимость с браузерами</h2> - -<p>{{ CompatibilityTable() }}</p> - -<div id="compat-desktop"> -<table class="compat-table"> - <tbody> - <tr> - <th>Возможность</th> - <th>Chrome</th> - <th>Firefox (Gecko)</th> - <th>Internet Explorer</th> - <th>Opera</th> - <th>Safari</th> - </tr> - <tr> - <td>Базовая поддержка</td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatVersionUnknown() }}</td> - </tr> - </tbody> -</table> -</div> - -<div id="compat-mobile"> -<table class="compat-table"> - <tbody> - <tr> - <th>Возможность</th> - <th>Android</th> - <th>Chrome for Android</th> - <th>Firefox Mobile (Gecko)</th> - <th>IE Mobile</th> - <th>Opera Mobile</th> - <th>Safari Mobile</th> - </tr> - <tr> - <td>Базовая поддержка</td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatVersionUnknown() }}</td> - </tr> - </tbody> -</table> -</div> - -<h2 id="Смотрите_также">Смотрите также</h2> - -<ul> - <li><a href="/ru/docs/Web/JavaScript/Reference/Operators/Arithmetic_Operators">Арифметические операции</a></li> -</ul> diff --git a/files/ru/conflicting/web/javascript/reference/statements/switch/index.html b/files/ru/conflicting/web/javascript/reference/statements/switch/index.html deleted file mode 100644 index 13c6428189..0000000000 --- a/files/ru/conflicting/web/javascript/reference/statements/switch/index.html +++ /dev/null @@ -1,118 +0,0 @@ ---- -title: default -slug: conflicting/Web/JavaScript/Reference/Statements/switch -tags: - - JavaScript - - Keyword - - Switch - - export -translation_of: Web/JavaScript/Reference/Statements/switch -translation_of_original: Web/JavaScript/Reference/Statements/default -original_slug: Web/JavaScript/Reference/Statements/default ---- -<div>{{jsSidebar("Statements")}}</div> - -<p>В JavaScript ключевое слово <strong>default </strong>используется в двух случаях: внутри конструкции {{jsxref("Statements/switch", "switch")}} или с конструкцией {{jsxref("Statements/export", "export")}}.</p> - -<h2 id="Синтаксис">Синтаксис</h2> - -<p>В конструкции {{jsxref("Statements/switch", "switch")}}:</p> - -<pre class="syntaxbox">switch (expression) { - case value1: - // Выражение выполнится, когда значение expression соответствует value1 - [break;] - default: - // Выражение выполнится, когда ни одно из значений не будет соответствовать значению expression - [break;] -}</pre> - -<p>С конструкцией {{jsxref("Statements/export", "export")}}:</p> - -<pre class="syntaxbox">export default <em>nameN</em> </pre> - -<h2 id="Описание">Описание</h2> - -<p>Для получения дополнительной информации смотрите:</p> - -<ul> - <li>{{jsxref("Statements/switch", "switch")}}</li> - <li>{{jsxref("Statements/export", "export")}}</li> -</ul> - -<h2 id="Примеры">Примеры</h2> - -<h3 id="Использование_default_в_switch">Использование <code>default</code> в <code>switch</code></h3> - -<p>В следующем примере, если <code>expr</code> имеет значение "Апельсины" или "Яблоки", то программа сопоставит это значение с "Апельсины" или с "Яблоки", а затем выполнит соответствующее выражение. В других случаях поможет ключевое слово <strong>default,</strong> выполняя связанное выражение.</p> - -<pre class="brush: js">switch (expr) { - case 'Апельсины': - console.log('Апельсины стоят $0.59 за фунт.'); - break; - case 'Яблоки': - console.log('Яблоки стоят $0.32 за фунт.'); - break; - default: - console.log(`Извините, у нас закончились ${expr}.`); -}</pre> - -<h3 id="Использование_default_с_export">Использование <code>default</code> с<font face="Open Sans, arial, sans-serif"> </font><code>export</code></h3> - -<p>При необходимости экспорта единственного значения или резервирования (fallback) значения для модуля, можно воспользоваться<strong> </strong>экспортом по умолчанию: </p> - -<pre class="brush: js">// модуль "my-module.js" -let cube = function cube(x) { - return x * x * x; -}; -export default cube;</pre> - -<p>Тогда, в другом файле JavaScript, становится возможным просто импортировать экспортируемое по умолчанию значение:</p> - -<pre class="brush: js">// модуль "my-module.js" -import myFunction from 'my-module'; -console.log(myFunction(3)); // 27 -</pre> - -<h2 id="Спецификация">Спецификация</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Спецификация</th> - <th scope="col">Статус</th> - <th scope="col">Комментарий</th> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-switch-statement', 'switch statement')}}</td> - <td>{{Spec2('ES6')}}</td> - <td></td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-exports', 'Exports')}}</td> - <td>{{Spec2('ES6')}}</td> - <td></td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-switch-statement', 'switch statement')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td></td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-exports', 'Exports')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td></td> - </tr> - </tbody> -</table> - -<h2 id="Совместимость_с_браузерами">Совместимость с браузерами</h2> - -<p>{{Compat("javascript.statements.default")}}</p> - -<h2 id="Смотрите_также">Смотрите также</h2> - -<ul> - <li>{{jsxref("Statements/export", "export")}}</li> - <li>{{jsxref("Statements/switch", "switch")}}</li> -</ul> diff --git a/files/ru/conflicting/web/media/formats/index.html b/files/ru/conflicting/web/media/formats/index.html deleted file mode 100644 index 61a80ea1e4..0000000000 --- a/files/ru/conflicting/web/media/formats/index.html +++ /dev/null @@ -1,518 +0,0 @@ ---- -title: Форматы медиа поддерживаемые HTML audio и video элементами -slug: conflicting/Web/Media/Formats -translation_of: Web/Media/Formats -translation_of_original: Web/HTML/Supported_media_formats -original_slug: Web/HTML/Поддерживаемые_медиа_форматы ---- -<p><span class="seoSummary">{{ HTMLElement("audio") }} и {{ HTMLElement("video") }} элементы предоставляют поддержку для проигрывания аудио и видео медиа без нужды в плагинах. </span>Формат медиафайла состоит из контейнера, содержащего один или несколько потоков данных, закодированных с использованием формата сжатия, называемого кодеком. Контейнер идентифицируется по расширению файла. Потоки внутри контейнера имеют несколько типов, которые могут включать в себя видео, аудио, данные или титры. Один контейнер (т. е. медиафайл) может содержать несколько потоков одного типа. В аудио- и видео- потоках находятся кодеки. Кодек — сокращение слов "кодера-декодер" — является алгоритмом сжатия данных в файле. Каждый тип контейнера имеет только определённые кодеки, которые он поддерживает.</p> - -<p>Важно понять, почему в Интернете нужны разные медиаформаты. По разным причинам, выходящим за рамки данной статьи, различные браузеры поддерживают разные медиаформаты. Кроме того, область медиаформатов в Интернете сильно пострадала от патентного права во многих странах, включая США и страны ЕС. (Примечания к патентам в этой статье предоставляются как есть, так и без каких-либо гарантий.) В этой статье рассматриваются наиболее важные для Интернета форматы, включая поддержку в браузерах как мобильных, так и десктопных .</p> - -<p> </p> - -<h3 id="Отображение_медиа">Отображение медиа</h3> - -<p> </p> - -<p>Ниже краткий обзор того, как медиа-элементы отображаются в HTML. Более подробную информацию смотрите в статьях для каждого элемента.</p> - -<p>HTML5 поддерживает несколько элементов мультимедиа. Элементы {{HTMLElement ("video")}} и {{HTMLElement ("audio")}} могут использоваться отдельно или в сочетании с элементом {{HTMLElement ("source")}}. Наш краткий пример отображает это. Хотя элементы <code><video></code> и <code><audio></code> содержат атрибуты src, этот пример использует элемент <code><source></code> для предоставления видеофайлов в нескольких форматах, позволяя каждому браузеру выбирать элемент, который он поддерживает.</p> - -<pre class="brush: html"><video controls> - <source src="somevideo.webm" type="video/webm"> - <source src="somevideo.mp4" type="video/mp4"> - Сожалею; ваш браузер не поддерживает HTML5 видео в WebM с VP8 или MP4 с H.264. - <!-- Ты можешь встроить флеш плеер сюда, для воспроизведения твоего mp4 видео в старых браузерах --> -</video> -</pre> - -<h2 id="WebM">WebM</h2> - -<p>Формат <a class="external" href="http://www.webmproject.org/" title="http://www.webmproject.org/">WebM</a> основан на ограниченной версии формата контейнера <a class="external" href="http://corecodec.com/products/matroska" title="http://corecodec.com/products/matroska">Matroska</a>. Формат всегда использует видео кодек VP8 или VP9 и аудио кодек Vorbis или Opus. WebM нативно поддерживается в десктопной и мобильной версиях Gecko (Firefox), Chrome и Opera. Поддержка формата может быть добавлена в Internet Explorer и Safari (но не на iOS) установкой плагина. Нативная поддержка VP9 WebM в Edge сейчас в стадии разработки.</p> - -<p>Формат WebM, а точнее видеокодек VP8, подвергся претензиям в нарушениях патентов от ряда компаний, отвечающих на требования, MPEG LA о формировании списка патентов, но при этом <a href="http://www.businesswire.com/news/home/20130307006192/en/Google-MPEG-LA-Announce-Agreement-Covering-VP8">MPEG LA дала согласие на лицензирование этих патентов для Google</a> под лицензией "<a href="http://xiphmont.livejournal.com/59893.html?thread=310261#t310261">perpetual, transferable, royalty free license"</a>. Это фактически означает, что все известные патенты, относящиеся к формату WebM лицензированы для свободного использования всеми.</p> - -<p>Движок Gecko распознаёт следующие типы MIME как файлы WebM:</p> - -<dl> - <dt><code>video/webm</code></dt> - <dd>файл WebM, содержащий видео (а возможно, также и аудио).</dd> - <dt><code>audio/webm</code></dt> - <dd>Файл WebM, содержащий только аудиоданные.</dd> -</dl> - -<h2 id="Ogg_Theora_Vorbis">Ogg Theora Vorbis</h2> - -<p>The Ogg container format with the Theora video codec and the Vorbis audio codec is supported in desktop/mobile Gecko (Firefox), Chrome, and Opera, and support for the format can be added to Safari (but not on iOS) by installing an add-on. The format is not supported in Internet Explorer in any way.</p> - -<p>WebM is generally preferred over Ogg Theora Vorbis when available, because it provides a better compression to quality ratio and is supported in more browsers. The Ogg format can however be used to support older browser versions (for example Firefox 3.5/3.6 don't support WebM, but do support Ogg.)</p> - -<p>The patent situation of Theora is similar to that of WebM.</p> - -<p>You can learn more about creating Ogg media by reading the <a class="external" href="http://en.flossmanuals.net/ogg-theora/" title="http://en.flossmanuals.net/ogg-theora/">Theora Cookbook</a>.</p> - -<p>Gecko recognizes the following MIME types as Ogg files:</p> - -<dl> - <dt><code>audio/ogg</code></dt> - <dd>An Ogg file containing only audio.</dd> - <dt><code>video/ogg</code></dt> - <dd>An ogg file containing video (and possibly also audio).</dd> - <dt><code>application/ogg</code></dt> - <dd>An Ogg file with unspecified content. Using one of the other two MIME types is preferred, but you can use this if you don't know what the contents of the file are.</dd> -</dl> - -<h2 id="Ogg_Opus">Ogg Opus</h2> - -<p>The Ogg container can also contain audio encoded using the <a class="external" href="http://www.opus-codec.org/" title="http://www.opus-codec.org/">Opus codec</a>. Support for this is available in Gecko 15.0 {{ geckoRelease("15.0") }} and later, on desktop and mobile browsers.</p> - -<h2 id="MP4_H.264_(AAC_or_MP3)">MP4 H.264 (AAC or MP3)</h2> - -<p>The MP4 container format with the H.264 video codec and the AAC audio codec is natively supported by desktop/mobile Internet Explorer, Safari and Chrome, but Chromium and Opera do not support the format. IE and Chrome also support the MP3 audio codec in the MP4 container, but Safari does not. Firefox/Firefox for Android/Firefox OS supports the format in some cases, but only when a third-party decoder is available, and the device hardware can handle the profile used to encode the MP4.</p> - -<div class="note"> -<p><strong>Note</strong>: MP4s encoded with a high profile will not run on lower end hardware, such as low end Firefox OS phones.</p> -</div> - -<p>The MPEG media formats are covered by patents, which are not freely licensed. All the necessary licenses can be bought from MPEG LA. Since H.264 is currently not a royalty free format, it is unfit for the open web platform, according to Mozilla [<a class="external" href="http://shaver.off.net/diary/2010/01/23/html5-video-and-codecs/" title="http://shaver.off.net/diary/2010/01/23/html5-video-and-codecs/">1</a>, <a class="external" href="http://robert.ocallahan.org/2010/01/video-freedom-and-mozilla_23.html" title="http://robert.ocallahan.org/2010/01/video-freedom-and-mozilla_23.html">2</a>], Google [<a class="external" href="http://blog.chromium.org/2011/01/html-video-codec-support-in-chrome.html" title="http://blog.chromium.org/2011/01/html-video-codec-support-in-chrome.html">1</a>, <a class="external" href="http://blog.chromium.org/2011/01/more-about-chrome-html-video-codec.html" title="http://blog.chromium.org/2011/01/more-about-chrome-html-video-codec.html">2</a>] and Opera. However, since royalty free formats are not supported by Internet Explorer and Safari, <a href="https://hacks.mozilla.org/2012/03/video-mobile-and-the-open-web/" title="https://hacks.mozilla.org/2012/03/video-mobile-and-the-open-web/">Mozilla has decided to support the format anyway</a>, and Google never fulfilled their promise to <span class="external">remove support for it in Chrome</span>.</p> - -<h2 id="MP3">MP3</h2> - -<p>MP3 аудио формат (.mp3, <code>audio/mpeg</code>; в отличии от выше MP3 аудио в случае MP4 контейнера) поддерживается в <code><audio></code> Firefox/Firefox для Android/Firefox OS когда операционная система обеспечивает MP3 декодер, и Internet Explorer, Chrome и Safari.</p> - -<h2 id="WAVE_PCM">WAVE PCM</h2> - -<p>The WAVE container format, with the PCM audio codec (WAVE codec "1") is supported by desktop/mobile Gecko (Firefox) and Safari. Files in the WAVE container format typically end with the ".wav" extension.</p> - -<div class="note"><strong>Note: </strong>See <a class="external" href="http://www.rfc-editor.org/rfc/rfc2361.txt" title="http://www.rfc-editor.org/rfc/rfc2361.txt">RFC 2361</a> for the WAVE codec registry.</div> - -<p>Gecko recognizes the following MIME types as WAVE audio files:</p> - -<ul> - <li><code>audio/wave</code> (preferred; does not work in Chrome)</li> - <li><code>audio/wav</code></li> - <li><code>audio/x-wav</code></li> - <li><code>audio/x-pn-wav</code></li> -</ul> - -<h2 id="Media_Source_Extensions_(MSE)">Media Source Extensions (MSE)</h2> - -<p><a href="https://dvcs.w3.org/hg/html-media/raw-file/tip/media-source/media-source.html">Media Source Extensions</a> is a W3C working draft that plans to extend {{ domxref("HTMLMediaElement") }} to allow JavaScript to generate media streams for playback. Allowing JavaScript to generate streams facilitates a variety of use cases like adaptive streaming and time shifting live streams. This currently has experimental support in Firefox desktop, and other browsers too.<br> - <br> - For example, <a href="http://msopentech.com/blog/2014/01/03/streaming_video_player/">you could implement MPEG-DASH using JavaScript while offloading the decoding to MSE</a>.</p> - -<div class="note"> -<p><strong>Note</strong>: Time Shifting is the process of consuming a live stream some time after it happened.</p> -</div> - -<h2 id="Browser_compatibility">Browser compatibility</h2> - -<p>{{ CompatibilityTable() }}</p> - -<div id="compat-desktop"> -<table class="compat-table"> - <tbody> - <tr> - <th>Feature</th> - <th>Chrome</th> - <th>Firefox (Gecko)</th> - <th>Internet Explorer</th> - <th>Opera</th> - <th>Safari</th> - </tr> - <tr> - <td>Basic support</td> - <td>3.0</td> - <td>{{ CompatGeckoDesktop("1.9.1") }}</td> - <td>9.0</td> - <td>10.50</td> - <td>3.1</td> - </tr> - <tr> - <td><code><audio></code>: PCM in WAVE</td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatGeckoDesktop("1.9.1") }}</td> - <td>{{ CompatNo() }}</td> - <td>10.50</td> - <td>3.1</td> - </tr> - <tr> - <td><code><audio></code>: Vorbis in WebM</td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatGeckoDesktop("2.0") }}</td> - <td>{{ CompatNo() }}</td> - <td>10.60</td> - <td>3.1 (must be installed separately)</td> - </tr> - <tr> - <td><code><audio></code>: Streaming Vorbis in WebM via <a href="https://w3c.github.io/media-source/">Media Source Extensions (MSE)</a></td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatGeckoDesktop("36.0") }} in Nightly/Dev edition only</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - </tr> - <tr> - <td><code><audio></code>: Vorbis in Ogg</td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatGeckoDesktop("1.9.1") }}</td> - <td>{{ CompatNo() }}</td> - <td>10.50</td> - <td>3.1 (must be installed separately, e.g. <a class="external" href="http://www.xiph.org/quicktime/" title="http://www.xiph.org/quicktime/">XiphQT</a>)</td> - </tr> - <tr> - <td><audio>: MP3</td> - <td>{{ CompatVersionUnknown() }} (Not in Chromium)</td> - <td>Partial (see below)</td> - <td>9.0</td> - <td>{{ CompatVersionUnknown() }}</td> - <td>3.1</td> - </tr> - <tr> - <td><code><audio></code>: MP3 in MP4</td> - <td> - <p>{{ CompatUnknown() }}</p> - </td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatVersionUnknown() }}</td> - </tr> - <tr> - <td><code><audio></code>: AAC in MP4</td> - <td> - <p>{{ CompatVersionUnknown() }} (Main only) (Not in Chromium)</p> - </td> - <td> - <p>Partial (see below)</p> - </td> - <td>9.0</td> - <td>{{ CompatVersionUnknown() }}</td> - <td>3.1</td> - </tr> - <tr> - <td><code><audio></code>: Opus in Ogg</td> - <td>27.0</td> - <td>{{ CompatGeckoDesktop("15.0") }}</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - </tr> - <tr> - <td><code><video></code>: VP8 and Vorbis in WebM</td> - <td>6.0</td> - <td>{{ CompatGeckoDesktop("2.0") }}</td> - <td>9.0 (<a class="external" href="http://blogs.msdn.com/b/ie/archive/2011/03/16/html5-video-update-webm-for-ie9.aspx" title="http://blogs.msdn.com/b/ie/archive/2011/03/16/html5-video-update-webm-for-ie9.aspx">must be installed separately</a>, e.g. <a class="external" href="http://tools.google.com/dlpage/webmmf/" title="http://tools.google.com/dlpage/webmmf/">WebM MF</a>)</td> - <td>10.60</td> - <td>3.1 (must be installed separately, e.g. <a class="external" href="http://perian.org/" title="http://perian.org/">Perian</a>)</td> - </tr> - <tr> - <td><code><video></code>: VP9 and Opus in WebM</td> - <td>29.0</td> - <td>{{ CompatGeckoDesktop("28.0") }}</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - </tr> - <tr> - <td><code><video></code>: Streaming VP9 and Opus/VP8 and Opus in WebM via <a href="https://w3c.github.io/media-source/">Media Source Extensions (MSE)</a></td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatGeckoDesktop("36.0") }} in Nightly/Dev edition only</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - </tr> - <tr> - <td><code><video></code>: Theora and Vorbis in Ogg</td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatGeckoDesktop("1.9.1") }}</td> - <td>{{ CompatNo() }}</td> - <td>10.50</td> - <td>3.1 (must be installed separately, e.g. <a class="external" href="http://www.xiph.org/quicktime/" title="http://www.xiph.org/quicktime/">XiphQT</a>)</td> - </tr> - <tr> - <td><code><video></code>: H.264 and MP3 in MP4</td> - <td> - <p>{{ CompatVersionUnknown() }} (Not in Chromium)</p> - </td> - <td>Partial (see below)</td> - <td>9.0</td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatVersionUnknown() }}</td> - </tr> - <tr> - <td><code><video></code>: H.264 and AAC in MP4</td> - <td> - <p>{{ CompatVersionUnknown() }} (Not in Chromium)</p> - </td> - <td>Partial (see below)</td> - <td>9.0</td> - <td>{{ CompatVersionUnknown() }}</td> - <td>3.1</td> - </tr> - <tr> - <td>any other format</td> - <td>{{ CompatNo() }}</td> - <td>{{ CompatNo() }}</td> - <td>{{ CompatNo() }}</td> - <td>{{ CompatNo() }}</td> - <td>3.1 (plays all formats available via QuickTime)</td> - </tr> - </tbody> -</table> -</div> - -<div id="compat-mobile"> -<table class="compat-table"> - <tbody> - <tr> - <th>Feature</th> - <th>Android</th> - <th>Firefox Mobile (Gecko)</th> - <th>Firefox OS (Gecko)</th> - <th>IE Mobile</th> - <th>Opera Mobile</th> - <th>Opera Mini</th> - <th>Safari Mobile</th> - <th>Chrome for Android</th> - </tr> - <tr> - <td>Basic support</td> - <td>2.3</td> - <td>24.0</td> - <td>1.0.1</td> - <td>10.0</td> - <td>11.0</td> - <td>Partial (see below)</td> - <td>3.2</td> - <td>29.0</td> - </tr> - <tr> - <td><code><audio></code>: PCM in WAVE</td> - <td>{{ CompatUnknown() }}</td> - <td>24.0</td> - <td>1.0.1</td> - <td>{{ CompatNo() }}</td> - <td>{{ CompatNo() }}</td> - <td>Partial (see below)</td> - <td>3.2</td> - <td>{{ CompatUnknown() }}</td> - </tr> - <tr> - <td><code><audio></code>: Vorbis in WebM</td> - <td>{{ CompatUnknown() }}</td> - <td>24.0</td> - <td>1.0.1</td> - <td>{{ CompatNo() }}</td> - <td>11.0</td> - <td>Partial (see below)</td> - <td>{{ CompatNo() }}</td> - <td>{{ CompatUnknown() }}</td> - </tr> - <tr> - <td><code><audio></code>: Streaming Vorbis in WebM via <a href="https://w3c.github.io/media-source/">Media Source Extensions (MSE)</a></td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - </tr> - <tr> - <td><code><audio></code>: Vorbis in Ogg</td> - <td>{{ CompatUnknown() }}</td> - <td>24.0</td> - <td>1.0.1</td> - <td>{{ CompatNo() }}</td> - <td>11.0</td> - <td>Partial (see below)</td> - <td>{{ CompatNo() }}</td> - <td>{{ CompatUnknown() }}</td> - </tr> - <tr> - <td><code><audio></code>: MP3</td> - <td>{{ CompatUnknown() }}</td> - <td>Partial (see below)</td> - <td>Partial (see below)</td> - <td>10.0</td> - <td>{{ CompatUnknown() }}</td> - <td>Partial (see below)</td> - <td>3.2</td> - <td>{{ CompatUnknown() }}</td> - </tr> - <tr> - <td><code><audio></code>: MP3 in MP4</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - </tr> - <tr> - <td><code><audio></code>: AAC in MP4</td> - <td>{{ CompatUnknown() }}</td> - <td>Partial (see below)</td> - <td>Partial (see below)</td> - <td>10.0</td> - <td>{{ CompatUnknown() }}</td> - <td>Partial (see below)</td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - </tr> - <tr> - <td><code><audio></code>: Opus in Ogg</td> - <td>{{ CompatNo() }}</td> - <td>24.0</td> - <td>{{ CompatNo() }}</td> - <td>{{ CompatNo() }}</td> - <td>{{ CompatNo() }}</td> - <td>Partial (see below)</td> - <td>{{ CompatNo() }}</td> - <td>{{ CompatNo() }}</td> - </tr> - <tr> - <td><code><video></code>: VP8 and Vorbis in WebM</td> - <td>2.3</td> - <td>24.0</td> - <td>1.0.1</td> - <td>{{ CompatNo() }}</td> - <td>16.0</td> - <td>Partial (see below)</td> - <td>{{ CompatNo() }}</td> - <td>29.0</td> - </tr> - <tr> - <td><code><video></code>: VP9 and Opus in WebM</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - </tr> - <tr> - <td><code><video></code>: Streaming VP9 and Opus/VP8 and Opus in WebM via <a href="https://w3c.github.io/media-source/">Media Source Extensions (MSE)</a></td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - </tr> - <tr> - <td><code><video></code>: Theora and Vorbis in Ogg</td> - <td>{{ CompatNo() }}</td> - <td>24.0</td> - <td>1.0.1</td> - <td>{{ CompatNo() }}</td> - <td>{{ CompatNo() }}</td> - <td>Partial (see below)</td> - <td>{{ CompatNo() }}</td> - <td>{{ CompatNo() }}</td> - </tr> - <tr> - <td><code><video></code>: H.264 and MP3 in MP4</td> - <td>Partial (see below)</td> - <td>24.0</td> - <td>Partial (see below)</td> - <td>10.0</td> - <td>Partial since 11.0, full since 16.0</td> - <td>Partial (see below)</td> - <td>{{ CompatVersionUnknown() }}</td> - <td>29.0</td> - </tr> - <tr> - <td><code><video></code>: H.264 and AAC in MP4</td> - <td>Partial (see below)</td> - <td>24.0</td> - <td>Partial (see below)</td> - <td>10.0</td> - <td>Partial since 11.0, full since 16.0</td> - <td>Partial (see below)</td> - <td>3.2</td> - <td>29.0</td> - </tr> - <tr> - <td>any other format</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - </tr> - </tbody> -</table> -</div> - -<p>Notes:</p> - -<ul> - <li>AAC is only supported in the MP4 container.</li> - <li>Opera Mini itself doesn't support any video or audio, but any video or audio is passed to the device to play if it has support for that format. Opera Mobile also does this with unsupported formats.</li> - <li>To get the default Android browser to play H.264 video, you need to jump through some hoops, as <a href="http://www.broken-links.com/2010/07/08/making-html5-video-work-on-android-phones/">explained by Peter Gasston</a>.</li> - <li>In Firefox OS 1.0.1, when detecting <code><video></code> support for different formats, <code>HTMLMediaElement.prototype.canPlayType</code> incorrectly reports <code>true</code> for h.264 video whereas in actual fact h.264 is not supported. In Firefox OS 1.1 this problem has been fixed.</li> - <li>To avoid patent issues, support for MPEG 4, H.264, MP3 and AAC is not built directly into Firefox on desktop and mobile (Android and Firefox OS). Instead it relies on support from the OS or hardware (the hardware also needs to be able to support the profile used to encode the video, in the case of MP4). Firefox desktop supports these formats on the following platforms:</li> -</ul> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Platform</th> - <th scope="col">Firefox version</th> - </tr> - </thead> - <tbody> - <tr> - <td><a href="https://bugzilla.mozilla.org/show_bug.cgi?id=825153" title="https://bugzilla.mozilla.org/show_bug.cgi?id=825153">Windows Vista</a>+</td> - <td>22.0+</td> - </tr> - <tr> - <td><a href="https://bugzilla.mozilla.org/show_bug.cgi?id=748351" title="https://bugzilla.mozilla.org/show_bug.cgi?id=748351">Android</a></td> - <td>20.0+</td> - </tr> - <tr> - <td><a href="https://bugzilla.mozilla.org/show_bug.cgi?id=714408" title="https://bugzilla.mozilla.org/show_bug.cgi?id=714408">Firefox OS</a></td> - <td>15.0+</td> - </tr> - <tr> - <td>Linux</td> - <td> - <p>26.0+ (relies on GStreamer codecs)</p> - </td> - </tr> - <tr> - <td><a href="https://bugzilla.mozilla.org/show_bug.cgi?id=851290">OS X 10.7+</a></td> - <td>35.0+</td> - </tr> - </tbody> -</table> - -<ul> - <li><a class="external" href="http://dev.opera.com/articles/view/introduction-html5-video/#codecs" title="http://dev.opera.com/articles/view/introduction-html5-video/#codecs">Video codecs in Opera</a></li> - <li><a class="external" href="http://msdn.microsoft.com/en-us/library/ff975073%28v=VS.85%29.aspx" title="http://msdn.microsoft.com/en-us/library/ff975073%28v=VS.85%29.aspx">Video codecs in Internet Explorer</a></li> - <li><a class="external" href="http://msdn.microsoft.com/en-us/library/ff975061%28v=vs.85%29.aspx" title="http://msdn.microsoft.com/en-us/library/ff975061%28v=vs.85%29.aspx">Audio codecs in Internet Explorer</a></li> - <li><a href="http://www.chromium.org/audio-video" title="http://www.chromium.org/audio-video">Audio & Video codecs in Chrome</a></li> -</ul> - -<h2 id="See_also">See also</h2> - -<ul> - <li><a class="internal" href="/en/Using_HTML5_audio_and_video" title="En/Using audio and video in Firefox">Using audio and video in Firefox</a></li> - <li><a href="http://bluishcoder.co.nz/2013/08/21/html-media-support-in-firefox.html">HTML media support in Firefox</a></li> - <li><a class="external" href="http://www.whatwg.org/specs/web-apps/current-work/#media-elements" title="http://www.whatwg.org/specs/web-apps/current-work/#media-elements">Media elements</a> (HTML 5 specification)</li> - <li><code><a class="internal" href="/en/HTML/Element/Video" title="En/HTML/Element/Video">video</a></code></li> - <li><a class="internal" href="/en/HTML/Element/Audio" title="En/HTML/Element/Audio"><code>audio</code></a></li> -</ul> diff --git a/files/ru/conflicting/web/progressive_web_apps/index.html b/files/ru/conflicting/web/progressive_web_apps/index.html deleted file mode 100644 index ff8150db65..0000000000 --- a/files/ru/conflicting/web/progressive_web_apps/index.html +++ /dev/null @@ -1,49 +0,0 @@ ---- -title: Адаптивный дизайн -slug: conflicting/Web/Progressive_web_apps -translation_of: Web/Progressive_web_apps -translation_of_original: Web/Guide/Responsive_design -original_slug: Web_Development/Mobile/Responsive_design ---- -<p>As a reaction to the problems associated with the <a href="/en-US/docs/Web_Development/Mobile/Separate_sites" title="Web development/Mobile/Separate sites">separate sites</a> approach to developing Web sites for both mobile and desktop, a relatively new idea (which is actually <a href="http://www.alistapart.com/articles/dao/">quite old</a>) is growing in popularity: ditch user-agent detection, and instead make your page respond on the client-side to the browser’s capabilities. This approach, introduced by Ethan Marcotte in his article for <a href="http://alistapart.com" title="http://alistapart.com">A List Apart</a>, came to be known as <a href="http://www.alistapart.com/articles/responsive-web-design/" style="line-height: 1.572;">Responsive Web Design</a>. Like the separate sites approach, responsive Web design has positive and negative aspects.</p> -<h2 id="The_Advantages">The Advantages</h2> -<p>Though it wasn’t initially proposed as method for creating mobile sites, responsive design has recently gained a lot of attention as a way of taking some first steps towards mobile-friendliness in lieu of a separate mobile site.</p> -<ol style="font-size: medium;"> - <li>It saves time and money as there isn't a need to maintain separate websites for different devices.</li> - <li>Responsive Design provides every page with a single and unique URL.</li> - <li>Social sharing stats (Facebook Likes, Tweets, +1 on Google plus) are not split, since the mobile and desktop versions of your web pages use a single and unique URL.</li> - <li>Responsive Design doesn't care about user agents.</li> -</ol> -<p>There are some really nice aspects to this approach. Since it does not rely on user-agent detection, it is more resilient and future-proof than the separate sites approach. For simple sites, it can also be significantly easier to implement and maintain than other options.</p> -<h2 id="The_Negatives">The Negatives</h2> -<p>This approach isn’t without its limitations. Because content must be altered on the client-side with JavaScript, only minimal content changes are encouraged. In general, things can get very hairy very quickly if you are trying to code two separate sets of JavaScript to work with the same DOM. This is a big reason why web applications tend not to adopt this approach.</p> -<p>Giving your existing site a responsive design also involves a rewrite of your styles if the you are not sporting a <a href="http://www.smashingmagazine.com/2008/06/26/flexible-layouts-challenge-for-the-future/">flexible layout</a> already. This could be a blessing in disguise, though; making your site’s layout responsive could be a good opportunity to modernize and clean up your site’s CSS.</p> -<p>Finally, since you are adding code to your scripts and styles, performance may be worse than the Separate Sites approach. There is not really any way around this, though a thoughtful refactoring of your scripts and styles might actually save a few bytes in the long run.</p> -<h2 id="When_it_is_right_to_choose_this_option">When it is right to choose this option</h2> -<p><a href="/@api/deki/files/5894/=teixido_responsive-300x177.png" title="teixido_responsive-300x177.png"><img align="right" alt="teixido_responsive-300x177.png" class="internal rwrap" height="177" src="/@api/deki/files/5894/=teixido_responsive-300x177.png?size=webview" width="300"></a>As mentioned above, because content changes can be difficult, when you take this approach, you are not able to give users a strikingly different experience on mobile without a significant increase in code complexity. That said, if the desktop and mobile versions of your site are very similar, then this approach is a great option. It is well-suited to document-centric sites whose a primary use case is consistent across devices, like product pages. You may notice that the examples below are all blogs or portfolios!</p> -<h2 id="Examples" name="Examples" style="overflow: hidden;">Examples</h2> -<p>Though it is not as popular as the separate sites approach, there are more and more websites employing this technique every day. Luckily, since all the code is client-side, if you’d like to see how a site technically implements this approach, it is as simple as visiting the site and clicking “View Page Source.” Here are a few examples:</p> -<ul> - <li><a href="http://teixido.co/">http://teixido.co/</a> – one of my favorite responsive designs, also pictured above!</li> - <li><a href="http://adactio.com/journal/1696">http://adactio.com/journal/1696</a> – also a good article to read, with its own links to examples</li> - <li><a href="http://thinkvitamin.com/">http://thinkvitamin.com/</a></li> - <li><a href="http://stephencaver.com/">http://stephencaver.com/</a></li> - <li><a href="http://hicksdesign.co.uk/">http://hicksdesign.co.uk/</a></li> -</ul> -<p>Despite being a relatively young approach, there are already some emerging best practices. For example, if you are designing a site from scratch with this option in mind, it is usually worthwhile to <a href="http://www.lukew.com/ff/entry.asp?1117">create a small-screen design first</a>, so that the constraints of mobile are with you from the beginning. It’s also great to use progressive enhancement for your styles instead of hiding elements of your existing site with media queries. This way, older browsers that might not support media queries still show the proper layout. An excellent presentation on the merits of this method is available <a href="http://www.slideshare.net/bryanrieger/rethinking-the-mobile-web-by-yiibu">here</a>.</p> -<h2 id="Approaches_to_mobile_Web_development">Approaches to mobile Web development</h2> -<p>See the following articles for background and other approaches to developing for mobile platforms.</p> -<ul> - <li><a href="/en-US/docs/Web_Development/Mobile/Mobile-friendliness" title="XML Web Services">What is mobile-friendliness?</a></li> - <li><a href="/en-US/docs/Web_Development/Mobile/Separate_sites" title="Web development/Mobile/Separate sites">Separate sites</a></li> - <li><a href="/en-US/docs/Web_development/Mobile/A_hybrid_approach" title="Web development/Mobile/Hybrid approach">A hybrid approach</a></li> -</ul> -<h2 id="See_also">See also</h2> -<ul> - <li><a href="/en-US/docs/Web_Development/Responsive_Web_design" title="Responsive Web design">Responsive Web design</a> for additional resources</li> -</ul> -<div class="originaldocinfo"> - <h3 id="Original_document_information">Original document information</h3> - <p>Originally published on 27 May, 2011 on the Mozilla Webdev blog as "<a href="http://blog.mozilla.com/webdev/2011/05/27/approaches-to-mobile-web-development-part-3-responsive-design/" title="http://blog.mozilla.com/webdev/2011/05/27/approaches-to-mobile-web-development-part-3-responsive-design/">Approaches to Mobile Web Development Part 3 - Responsive Design</a>", by Jason Grlicky.</p> -</div> -<p> </p> diff --git a/files/ru/conflicting/web/progressive_web_apps_628955cdadd77b10ec99de034fc76374/index.html b/files/ru/conflicting/web/progressive_web_apps_628955cdadd77b10ec99de034fc76374/index.html deleted file mode 100644 index 482e7a0e42..0000000000 --- a/files/ru/conflicting/web/progressive_web_apps_628955cdadd77b10ec99de034fc76374/index.html +++ /dev/null @@ -1,65 +0,0 @@ ---- -title: Заметный -slug: conflicting/Web/Progressive_web_apps_628955cdadd77b10ec99de034fc76374 -tags: - - Веб-манифест - - Видимый - - Манифест - - Приложения - - Прогрессивные веб-приложения - - Современные веб-приложения -translation_of: Web/Progressive_web_apps -translation_of_original: Web/Progressive_web_apps/Discoverable -original_slug: Web/Progressive_web_apps/Заметный ---- -<div class="column-container summary"> -<div class="column-11">Как только вы опубликуете новое веб-приложение, вы захотите, чтобы мир узнал об этом. Поисковые системы, конечно, помогают, но, обычно, большее внимание уделяется тому, как ваши приложения представлены на результатах поиска. Новый манифест W3C для веб-приложений может помочь с этим и предоставить дополнительные возможности.</div> - -<div class="column-1"><img alt="" src="https://mdn.mozillademos.org/files/12654/discoverable.svg" style="height: 43px; width: 34px;"></div> -</div> - -<p>Возможные перспективы для веб-приложения:</p> - -<ul> - <li>Лучшее представление сайта в поисковых системах.</li> - <li>Упрощение администрирования</li> - <li>Размещение мета-данных, поддерживаемых браузерами для получения дополнительных возможностей</li> -</ul> - -<h2 id="Основные_руководства">Основные руководства</h2> - -<p>None written as yet; contributions appreciated.</p> - -<h2 id="Технологии">Технологии</h2> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Технология</th> - <th scope="col">Описание</th> - <th scope="col">Поддержка</th> - <th scope="col">Последняя спецификация</th> - </tr> - </thead> - <tbody> - <tr> - <td> - <p><a href="/en-US/docs/Web/Manifest">Манифест веб-приложения</a></p> - </td> - <td>Устанавливает свойства приложения, такие как имя, иконка, окно загрузки и цвета темы для использования в каталогах приложений и т.д.</td> - <td>Экспериментальный, поддерживается в Chrome, ограниченная поддержка в Firefox (<a href="/en-US/docs/Web/Manifest#Browser_compatibility">больше деталей</a>)</td> - <td>{{SpecName('Manifest')}}</td> - </tr> - </tbody> -</table> - -<h2 id="Инструменты">Инструменты</h2> - -<p>Добавьте ссылки на полезные библиотеки и инструменты.</p> - -<h2 id="Смотрите_также">Смотрите также</h2> - -<dl> - <dt><a href="http://ogp.me/">Open Graph (англ.)</a></dt> - <dd>Стандарт, описывающий формат размещения мета-данных в тегах <code><head></code>, используя мета-тэги в HTML. Поддерживается Facebook и другими.</dd> -</dl> diff --git a/files/ru/orphaned/mdn/editor/basics/index.html b/files/ru/orphaned/mdn/editor/basics/index.html deleted file mode 100644 index 77db90898e..0000000000 --- a/files/ru/orphaned/mdn/editor/basics/index.html +++ /dev/null @@ -1,63 +0,0 @@ ---- -title: Редактор UI элементов -slug: orphaned/MDN/Editor/Basics -translation_of: MDN/Editor/Basics -original_slug: MDN/Editor/Basics ---- -<div>{{MDNSidebar}}</div> - -<p><span class="seoSummary">Встроенный WYSIWYG редактор на MDN разработан так, чтобы максимально упростить создание, редактирование и улучшение статей и других страниц практически на всем сайте. Окно редактора, как показано ниже, состоит из восьми блоков.<br> - Это руководство предоставляет информацию о каждом разделе, чтобы вы знали, как использовать все возможности нашего редактора.</span></p> - -<div class="note"> -<p><strong>Note:</strong> Мы постоянно работаем над улучшением MDN, так что может наступить такой момент, когда эта документация и скриншоты к ней окажутся немного устаревшими. Чтобы идти в ногу со временем - мы будем периодически обновлять документацию.</p> -</div> - -<p><img alt="Edit page with en/ru labels" src="https://mdn.mozillademos.org/files/16406/edit-page-with-labels-ru.png" style="height: 723px; width: 808px;"></p> - -<p>Интерфейс редактора содержит следующие разделы, как показано выше. Нажмите на ссылку ниже чтобы прочесть о конкретном разделе.</p> - -<ul> - <li><a href="/ru/docs/MDN/Contribute/Editor/Basics/Page_info">Информация о странице</a></li> - <li><a href="/ru/docs/MDN/Contribute/Editor/Basics/Page_controls">Управление страницей</a></li> - <li><a href="/ru/docs/MDN/Contribute/Editor/Basics/Toolbar">Панель инструментов</a></li> - <li>{{anch("Поле редактирования")}}</li> - <li><a href="/ru/docs/MDN/Contribute/Editor/Basics/Tags">Теги</a></li> - <li>{{anch("Примечание")}}</li> - <li>{{anch("Запрос проверки")}}</li> - <li><a href="/ru/docs/MDN/Contribute/Editor/Basics/Attachments">Прикреплённые файлы</a></li> -</ul> - -<h2 id="Поле_редактирования">Поле редактирования</h2> - -<p>Поле редактирования - это, конечно же. место где вы вводите текст.</p> - -<p>Нажатие правой кнопки мыши (ПКМ) в поле редактирования показывает дополнительные опции, в зависимости от контекста. Нажатие ПКМ на таблице, например, предлагает опции для работы с таблицами, а на списке, соответственно, опции для работы со списками. По умолчанию редактор использует своё собственное контекстное меню в поле редактирования. Чтобы открыть стандартное браузерное контекстное меню, при нажатии ПКМ зажмите <kbd>Shift</kbd> или <kbd>Control</kbd> (<kbd>Command</kbd> на Mac OS X).</p> - -<p>Во время работы в окне редактирования вы можете использовать специальные сочетания клавиш.</p> - -<h2 id="Примечание">Примечание</h2> - -<p>После того как вы закончили свою работу, настоятельно рекомендуется добавлять к своим изменениям примечание. Оно будет показано в истории изменений к этой странице, а также в обзорной панели изменений (<a href="/en-US/dashboards/revisions">Revision Dashboard</a>). Это поможет объяснить и донести смысл ваших изменений до тех, кто может просматривать их позже. Чтобы добавить своё примечание, просто заполните это поле перед нажатием на кнопку <strong>Сохранить</strong>/<strong>Опубликовать</strong>.</p> - -<p>Вот несколько причин почему это полезно:</p> - -<ul> - <li>Если причина ваших изменений не очевидна, ваш комментарий поможет её донести до других.</li> - <li>Если ваши правки технически сложные, примечание поможет в них разобраться. Оно может содержать номер ошибки, например, к которой редакторы смогут обратиться для более подробной информации.</li> - <li>Если ваши изменения содержат в себе удаление большого количества контента, вы можете объяснить своё решение (например: "Я переместил этот текст в статью N").</li> -</ul> - -<h2 id="Запрос_проверки">Запрос проверки</h2> - -<p>MDN сообщество использует проверки (reviews) для того чтобы следить за качеством контента и улучшать его. Это работает с помощью переключения флажка у нужного пункта. Вы можете узнать больше о технической проверке (technical review) и редакционной проверке (editorial review) в руководствах <a href="/ru/docs/MDN/Contribute/Howto">"Как сделать"</a>.</p> - -<p>Для запроса проверки статьи, над которой вы работали, переключите флажок возле нужного пункта. Техническую проверку следует запрашивать каждый раз, когда вы вносите изменения в технические детали работы чего-либо. Редакционная же проверка хороший выбор когда вы хотите посторонней оценки стиля или качества вашего текста.</p> - -<p>Несмотря на то что эти опции добавляют вашу работу в соответствующие списки (<a href="/en-US/docs/needs-review/technical">needing technical review</a> или <a href="/en-US/docs/needs-review/editorial">needing editorial review</a>), это не означает что она будет проверена немедленно. Для технической проверки хорошей идеей будет прямо обратиться к специалистам в этой области (см. <a href="https://developer.mozilla.org/en-US/docs/MDN/Community/Roles/Subject-matter_experts">subject-matter expert</a>). Для редакционной проверки вы можете написать на форуме MDN (см. <a href="https://discourse.mozilla.org/c/mdn">MDN discussion forum</a>) с просьбой проверить вашу работу.</p> - -<p>Будьте внимательны, убедитесь что установили нужные флажки перед нажатием кнопки <strong>Сохранить</strong>/<strong>Опубликовать</strong>.</p> - -<p> </p> - -<p id="Блок_управления">{{EditorGuideQuicklinks}}</p> diff --git a/files/ru/orphaned/mdn/editor/basics/page_controls/index.html b/files/ru/orphaned/mdn/editor/basics/page_controls/index.html deleted file mode 100644 index a9fced467d..0000000000 --- a/files/ru/orphaned/mdn/editor/basics/page_controls/index.html +++ /dev/null @@ -1,38 +0,0 @@ ---- -title: Элементы управления страницей в редакторе MDN -slug: orphaned/MDN/Editor/Basics/Page_controls -tags: - - Beginner - - Guide - - editor -translation_of: MDN/Editor/Basics/Page_controls -original_slug: MDN/Editor/Basics/Page_controls ---- -<div>{{MDNSidebar}}</div> - -<p>Элементы управления состоят из кнопок, затрагивающих страницу в целом. Они расположены наверху и внизу страницы, для удобства прокрутки страницы. Здесь расположены четыре кнопки:</p> - -<div class="note"> -<p>Если вы пытаетесь сохранить вашу работу и ваши изменения отклоняются как некорректные, но вы уверены, что ваш контент подходит для MDN, вам следует связаться с <a href="mailto:mdn-spam-watch@mozilla.com?subject=MDN%3A%20Content%20Rejection%20Appeal&body=%3CDescribe%20the%20content%20you%20were%20trying%20to%20save%20and%20where%20you%20were%20trying%20to%20place%20it.%3E">командой редакторов</a> для разрешения проблемы.</p> -</div> - -<dl> - <dt>Сохранить и продолжить редактирование</dt> - <dd>Эта кнопка сохраняет и публикует страницу, не закрывая редактор. Это позволяет периодически сохранять вашу работу, оставляя запись в истории. Благодаря этому вы сможете при необходимости откатить изменения, или приостановить работу и продолжить в удобное время. Эта функция недоступна при создании новых страниц. Смотрите также раздел о <a href="/ru/docs/MDN/Contribute/Editor/Basics#%D0%9F%D1%80%D0%B8%D0%BC%D0%B5%D1%87%D0%B0%D0%BD%D0%B8%D0%B5">примечании</a>, чтобы узнать как оставить комментарий к вашим изменениям и зачем это делать. </dd> - <dt>Опубликовать</dt> - <dd>Эта кнопка сохраняет и публикует изменения, а также закрывает редактор и возвращает вас на страницу в обычном режиме.</dd> - <dt>Предварительный просмотр</dt> - <dd>Эта кнопка открывает новую вкладку или окно, в котором показано как будут выглядеть ваши изменения после публикации. Это подразумевает, что все ваши <a href="/ru/docs/MDN/Contribute/Content/Macros">макросы</a> и <a href="/ru/docs/MDN/Kuma/Introduction_to_KumaScript#Template_Syntax">шаблоны</a> будут показаны как уже обработанные. Обратите внимание, что ваша работа не будет сохранена при использовании этой опции. Эта возможность позволяет вам проверить, до того как вы сделали свои изменения публичными, не допустили ли вы ошибок в своих шаблонах, макросах, или при оформлении текста. Если вы столкнулись с ошибками выполнения скриптов, смотрите <a href="https://developer.mozilla.org/en-US/docs/MDN/Contribute/Troubleshooting#Scripting_error_while_previewing_a_page">Troubleshooting scripting error while previewing a page</a>.</dd> - <dd> - <div class="warning" style="font-size: 14px;"> - <p><strong>Внимание:</strong> В настоящее время некоторые шаблоны и макросы не выполняются корректно при предварительном просмотре, оставляя страницу без части контента (таких как боковые меню), и, следовательно, частично искажая страницу. Кроме того, если <a href="https://developer.mozilla.org/en-US/docs/MDN/Contribute/Editor/Basics#scayt"><abbr title="Spell-Check As You Type">SCAYT</abbr> включён</a> (и если страница содержит определённые рабочие макросы или шаблоны), режим предварительного просмотра может выдавать ошибку выполнения скриптов.</p> - </div> - </dd> - <dt>Отменить</dt> - <dd>Эта кнопка отменяет все ваши несохраненные изменения. Вы будете возвращены на страницу в обычном режиме чтения.</dd> - <dd> - <div class="warning" style="font-size: 14px;"> - <p><strong>Warning:</strong> Occasionally <strong>Discard</strong> can malfunction and start acting more like a partial "discard," undoing many of your changes without exiting the editor. If this happens to you, you should save, exit, and re-enter the editor.</p> - </div> - </dd> -</dl> diff --git a/files/ru/orphaned/mdn/editor/basics/toolbar/index.html b/files/ru/orphaned/mdn/editor/basics/toolbar/index.html deleted file mode 100644 index 237dd51494..0000000000 --- a/files/ru/orphaned/mdn/editor/basics/toolbar/index.html +++ /dev/null @@ -1,257 +0,0 @@ ---- -title: Панель инструментов редактора MDN -slug: orphaned/MDN/Editor/Basics/Toolbar -tags: - - Beginner - - editor -translation_of: MDN/Editor/Basics/Toolbar -original_slug: MDN/Editor/Basics/Toolbar ---- -<div>{{MDNSidebar}}</div> - -<p class="summary">Панель инструментов редактора предоставляет вам возможность менять внешний вид и структуру документов во время работы. Эта статья описывает назначение кнопок в панели инструментов. </p> - -<p>На панели расположено три ряда. На первых двух - кнопки, а на третьем HTML контекст, который показывает вам какой элемент вы редактируете в данный момент. На скриншоте ниже, например, редактирование происходит в {{htmlelement("p")}} элементе. </p> - -<p><img alt="Screenshot of the toolbar, with labels for the button groups" src="https://mdn.mozillademos.org/files/15269/toolbar-labeled.png" style="border-style: solid; border-width: 2px; float: right; height: 142px; width: 725px;">Кнопки на панели инструментов разделены на девять групп. Давайте взглянем на все. Мы будем изучать кнопки в каждой группе по порядку, слева направо.</p> - -<ul> - <li><a href="#Документ">Документ</a></li> - <li><a href="#Правка">Правка</a></li> - <li><a href="#Работа_с_текстом">Работа с текстом</a></li> - <li><a href="#Вид">Вид</a></li> - <li><a href="#Строковые_стили">Строковые стили</a></li> - <li><a href="#Работа_со_ссылками">Работа со ссылками</a></li> - <li><a href="#Специальные_стили">Специальные стили</a></li> - <li><a href="#Блоки">Блоки</a></li> - <li><a href="#Списки_и_поток_текста">Списки и поток текста</a></li> - <li><a href="#Медиа">Медиа</a></li> -</ul> - -<h2 id="Документ">Документ</h2> - -<p>Кнопки из этой группы используются для управления на уровне всего документа.</p> - -<dl> - <dt>Source</dt> - <dd>Кнопка <strong>Source</strong> позволяет переключаться между редактированием в режиме WYSIWYG и редактированием разметки HTML. Мы просим вас избегать редактирования разметки, т.к. в таком случае очень легко неправильно оформить статью или вовсе столкнуться с ошибками. Правда в настоящее время у редактора могут встречаться некоторые причуды в работе, из-за которых сделать некоторые вещи не удастся, не отредактировав разметку напрямую. Смотрите <a href="https://developer.mozilla.org/ru/docs/MDN/Contribute/Editor/Source_mode">Режим разметки в редакторе MDN</a> чтобы более подробно изучить этот режим и понять что в разметке писать можно, а чего писать не следует.</dd> - <dt>Publish</dt> - <dd>То же что и кнопка <strong>Опубликовать</strong>.</dd> -</dl> - -<div class="note"> -<p><strong>Примечание:</strong> Если вы пытаетесь сохранить вашу работу и ваши изменения отклоняются как некорректные, но вы уверены, что ваш контент подходит для MDN, вам следует связаться с <a href="mailto:mdn-spam-watch@mozilla.com?subject=MDN%3A%20Content%20Rejection%20Appeal&body=%3CDescribe%20the%20content%20you%20were%20trying%20to%20save%20and%20where%20you%20were%20trying%20to%20place%20it.%3E">командой редакторов</a> для разрешения проблемы.</p> -</div> - -<dl> - <dt>Preview</dt> - <dd>Аналог кнопки <strong>Предварительный просмотр</strong>.</dd> -</dl> - -<h2 id="Правка">Правка</h2> - -<p>Функции этих кнопок очень схожи с соответствующими из меню <strong>Правка </strong>в любом другом редакторе.</p> - -<dl> - <dt>Paste / Вставить</dt> - <dd>Вставить контент из буфера обмена в поле редактора.</dd> - <dt>Paste as plain text / Вставить как обычный текст</dt> - <dd>Открывает диалоговое окно в которое вы можете вставить текст. Этот текст будет отделен от всего лишнего, так что вы не вставите случайно текст с лишними стилями или ссылками. После вставки текста, вы можете его отредактировать, если нужно, а затем, кликнув на кнопку <strong>OK</strong>, вставить на страницу.</dd> - <dd> - <div class="note"> - <p><strong>Примечание:</strong> Обратите внимание, что во время вставки контента в редактор, если вы копировали стилизованный контент (например, скопированный с другого сайта код с подсветкой синтаксиса), вы можете случайно вставить вместе с ним стили или посторонние классы. Пожалуйста, будьте внимательны и не допускайте этого. Проверяйте свои изменения в режиме разметки, если требуется, чтобы удалить лишние стили и классы (или позаботьтесь об этом заранее, воспользовавшись кнопкой "Paste as plain text").</p> - </div> - </dd> - <dt>Undo</dt> - <dd>Отменить последнее изменение.</dd> - <dt>Redo</dt> - <dd>Применить последнее отменённое изменение.</dd> -</dl> - -<h2 id="Работа_с_текстом">Работа с текстом</h2> - -<dl> - <dt>Find / Найти</dt> - <dd>Открывает диалоговое окно <strong>Find and Replace</strong> в режиме "Find", который позволяет найти в вашем документе определённую строку.</dd> - <dt>Replace / Заменить</dt> - <dd>Открывает диалоговое окно <strong>Find and Replace</strong> в режиме "Replace", с помощью которого можно найти нужную строку и заменить на новую.</dd> -</dl> - -<p>Кнопки <strong>Find</strong> и <strong>Replace</strong> открывают одно и то же диалоговое окно, которое имеет несколько опций для поиска и, опционально, замены текста.</p> - -<dl> - <dt>Spell Checker / Проверка правописания</dt> - <dd>Эта кнопка открывает меню с несколькими пунктами: - <dl> - <dt>Enable SCAYT/Disable SCAYT</dt> - <dd>Включает или отключает Spell Check As You Type (SCAYT)</dd> - <dt>Options</dt> - <dd>Если SCAYT включён, этот пункт открывает диалоговое окно SCAYT во вкладке с опциями для настройки SCAYT.</dd> - <dt>Languages</dt> - <dd>Если SCAYT включён, этот пункт открывает диалоговое окно SCAYT во вкладке "Languages", где вы можете выбрать язык для проверки правописания.</dd> - <dt>Dictionaries</dt> - <dd>Если SCAYT включён, этот пункт открывает диалоговое окно SCAYT во вкладке "Dictionaries", где вы можете сами выбрать словарь, который SCAYT будет использовать.</dd> - <dt>About SCAYT</dt> - <dd>Если SCAYT включён, этот пункт открывает диалоговое окно SCAYT во вкладке "About", в которой написано о SCAYT.</dd> - <dt>Check Spelling</dt> - <dd>Этот пункт открывает диалоговое окно Spell Checker, в котором вы можете проверить правописание в пакетном режиме (batch mode) для всего документа. Вы можете воспользоваться вкладкой Grammar для проверки грамматических ошибок, или воспользоваться вкладкой Thesaurus для поиска синонимов для слов в документе.</dd> - </dl> - </dd> -</dl> - -<h2 id="Вид">Вид</h2> - -<p>Эта группа позволяет настроить вид отображения интерфейса редактора. </p> - -<dl> - <dt>Maximize</dt> - <dd>Эта кнопка разворачивает интерфейс редактора (то есть панель инструментов и поле редактирования) во всё окно браузера, предоставляя вам как можно больше места для работы.</dd> - <dt>Show blocks</dt> - <dd>Эта кнопка отображает контуры вокруг блочных элементов в вашем документе. Это может быть удобным для проверки структуры документа без необходимости заглядывать в разметку.</dd> -</dl> - -<h2 id="Строковые_стили">Строковые стили</h2> - -<p>Строковые стили содержат распространённые стили, которые могут вам пригодиться при оформлении текста.</p> - -<dl> - <dt>Bold</dt> - <dd>Переключает <strong>жирный</strong> стиль текста, создавая при этом в разметке элемент {{htmlelement("strong")}}.</dd> - <dt>Italic</dt> - <dd>Переключает <em>курсив</em>. Создаёт {{htmlelement("em")}} элемент.</dd> - <dt>Underline</dt> - <dd>Переключает <u>нижнее подчёркивание</u>. Создаёт {{htmlelement("u")}} элемент.</dd> - <dt>Strike through</dt> - <dd>Переключает <s>перечёркивание</s>. Создаёт {{htmlelement("s")}} элемент.</dd> - <dt>Subscript</dt> - <dd>Переключает <sub>нижний индекс</sub>. Создаёт {{htmlelement("sub")}} элемент.</dd> - <dt>Superscript</dt> - <dd>Переключает <sup>верхний индекс</sup>. Создаёт {{htmlelement("sup")}} элемент. Заметьте, что такой строковый стиль не используется на MDN, так что вам вряд ли когда-нибудь пригодится эта кнопка.</dd> - <dt>Remove format</dt> - <dd>Удаляет текущий строковый стиль в выделенном тексте.</dd> - <dt>Code</dt> - <dd>Переключает стиль для <code>кода</code>. Создаёт {{htmlelement("code")}} элемент. Это используется для представления в тексте имён переменных, функций, объектов, файлов и т.п.</dd> -</dl> - -<h2 id="Работа_со_ссылками">Работа со ссылками</h2> - -<p>Данная группа предоставляет инструменты для работы со ссылками.</p> - -<dl> - <dt>Link</dt> - <dd>Создаёт новую ссылку. При нажатии вызывается окно создания ссылки, работа с которым подробна описана в <a href="/ru/docs/MDN/Contribute/Editor/Links#Using_the_toolbar">Ссылки с помощью панели инструментов</a>.</dd> - <dt>Unlink</dt> - <dd>Удаляет ссылку в месте, где расположен курсор.</dd> - <dt>Anchor</dt> - <dd>Создаёт якорь в месте, где расположен курсор. Заметьте, что вам не нужно создавать якорь для заголовков, редактор автоматически создаёт <code>{{htmlattrxref("id")}}</code> для каждого заголовка, заменяя пробелы в названии на нижние подчёркивания. Например, заголовок этой секции имеет <code>id</code>, значение которого <code>Работа_со_ссылками</code>.</dd> - <dt>Create a redirect</dt> - <dd>Встраивает переадресацию на другую страницу. Смотрите <a href="/ru/docs/MDN/Contribute/Editor/Redirects#Creating_redirects">Создание переадресаций</a> для подробной информации.</dd> -</dl> - -<h2 id="Специальные_стили">Специальные стили</h2> - -<p>Кнопка <strong>Styles</strong> - это выпадающее меню, предлагающее на выбор специальные стили форматирования текста.</p> - -<h3 id="Блочные_стили">Блочные стили</h3> - -<dl> - <dt>None</dt> - <dd>Удаляет стиль с выбранного блока.</dd> - <dt>Note box</dt> - <dd>Создаёт блок с примечание, как показано ниже. Вы должны всегда начинать примечание со слова <strong>"Примечание:"</strong> жирными буквами.</dd> -</dl> - -<div class="note"> -<p><strong>Примечание:</strong> Это поле с примечанием.</p> -</div> - -<dl> - <dt>Warning box</dt> - <dd>Создаёт блок с предупреждением, как показано ниже. Блок должен всегда начинаться со слова <strong>"Внимание:"</strong> жирными буквами.</dd> -</dl> - -<div class="warning"> -<p><strong>Внимание:</strong> Это поле с предупреждением.</p> -</div> - -<dl> - <dt>Two columns</dt> - <dd>Делает выделенный текст или блок двухколоночным на браузерах, которые это поддерживают.</dd> - <dt>Three columns</dt> - <dd>Делает выделенный текст или блок трёхколоночным на браузерах, которые это поддерживают.</dd> - <dt>Syntax box</dt> - <dd>Создаёт поле для синтаксиса, как показано ниже. Это создаёт {{htmlelement("pre")}}. Вы можете также использовать кнопку "PRE".</dd> - <dt> - <pre class="syntaxbox notranslate">Это поле для синтаксиса</pre> - </dt> - <dt>Hidden when reading</dt> - <dd>Создаёт блок, который видно только в режиме редактирования. Это не то же, что и HTML-комментарий, который виден только в режиме разметки.</dd> -</dl> - -<h3 id="Строковые_стили_2">Строковые стили</h3> - -<dl> - <dt>SEO summary</dt> - <dd>Этот специальный стиль используется чтобы выделить предложение или два, которые будут использованы как краткое описание для поисковой оптимизации. Он также используется макросами для автоматического создания посадочных страниц. Если вы не воспользуетесь этим стилем, MDN автоматически использует первый абзац вашей статьи. Но иногда это не самый лучший вариант и лучше воспользоваться предложенным стилем.</dd> -</dl> - -<h2 id="Блоки">Блоки</h2> - -<p>Эта группа включает опции для прочих стилей блоков. Некоторые из них относятся к стандартному HTML, а другие - уникальны, т.к. относятся к Kuma.</p> - -<dl> - <dt>Blockquote</dt> - <dd>Вставляет блок для цитаты. <strong>Пожалуйста, не используйте это</strong>. Блоки с цитатами не являются частью нашего стайлгайда, и эта кнопка будет удалена в ближайшем будущем.</dd> - <dt>Preformatted Text</dt> - <dd>Вставляет {{htmlelement("pre")}} блок, или превращает в него текущий. Все примеры кода должны быть оформлены в такой блок.</dd> - <dt>Headings</dt> - <dd>Кнопки заголовков позволяют вам вставить нужный заголовок. Нажмите на одну из этих кнопок для создания нового заголовка соответственной глубины. По умолчанию заголовки с H2 по H4 включаются в оглавление, но вы можете изменить это, как описано в разделе <a href="/ru/docs/MDN/Contribute/Editor/Basics/Page_info">Информация о странице</a>.</dd> - <dt>Syntax highlighter</dt> - <dd>Подсветка синтаксиса позволяет вам выбрать язык, синтаксис которого будет подсвечиваться в {{htmlelement("pre")}} блоке. Если такой блок не был выбран изначально, он будет создан. Выберите язык используемый в блоке, и блок будет подсвечен соответствующим образом.</dd> - <dt>Insert Code Sample Template</dt> - <dd>Эта кнопка используется системой живых примеров (the live sample system), чтобы помочь вам быстро вставить новый живой пример (live sample). Смотрите <a href="/ru/docs/MDN/Contribute/Structures/Live_samples#Using_the_live_sample_system">Пользование системой живых примеров</a> чтобы узнать подробнее.</dd> - <dt>Insert Code Sample iFrame</dt> - <dd>Вставляет в документ подходящий макрос для отображения нужного живого примера. Смотрите <a href="/ru/docs/MDN/Contribute/Structures/Live_samples#Using_the_live_sample_system">Пользование системой живых примеров</a> для деталей использования и информации о других функциях живых примеров.</dd> -</dl> - -<h2 id="Списки_и_поток_текста">Списки и поток текста</h2> - -<p>Эта группа предоставляет инструменты для создания списков и изменения поведения текста в блоках.</p> - -<dl> - <dt>Insert/remove numbered list</dt> - <dd>Создаёт или удаляет нумерованный список. Когда вы работаете над списком, при каждом нажатии <kbd>Enter</kbd> будет создаваться новый элемент списка. Клавиша <kbd>Tab</kbd> может быть использована для увеличения вложенности, а <kbd>Shift</kbd> + <kbd>Tab</kbd>, соответственно, для уменьшения. При нажатии на <kbd>Enter</kbd> в пустом элементе список будет закончен. Нажатие ПКМ на списке открывает контекстное меню с опцией Numbered list properties, в которой можно выбрать стиль маркера.</dd> - <dt>Insert/remove bulleted list</dt> - <dd>Создаёт или удаляет маркированный список. Когда вы работаете над списком, при каждом нажатии <kbd>Enter</kbd> будет создаваться новый элемент списка. Клавиша <kbd>Tab</kbd> используется для увеличения вложенности, а <kbd>Shift</kbd> + <kbd>Tab</kbd> для уменьшения. При нажатии на <kbd>Enter</kbd> в пустом элементе список будет закончен. Нажатие ПКМ на списке открывает контекстное меню с опцией Bulleted list properties, в которой можно выбрать стиль нумерации (числа, буквы, римские цифры и пр., а также с какой цифры начинать).</dd> - <dt>Definition List</dt> - <dd>Создаёт новый список с определениями (definition list). Этот список состоит из серии терминов и определений (именно такой список вы сейчас читаете).</dd> - <dt>Definition Term</dt> - <dd>Создаёт новый блок с термином в списке. Если в данный момент вы не редактируете список, он будет создан. Нажатие на <kbd>Enter</kbd> автоматически переключается на редактирование нового определения.</dd> - <dt>Definition Value</dt> - <dd>Создаёт новый блок с определением в списке. Нажатие на <kbd>Enter</kbd> создаёт новый термин. Нажав дважды, вы покинете список.</dd> - <dt>Decrease indent</dt> - <dd>Уменьшает вложенность. Того же эффекта можно добиться нажав <kbd>Shift</kbd> + <kbd>Tab</kbd> в списке.</dd> - <dt>Increase indent</dt> - <dd>Увеличивает вложенность. То же самое, что и нажатие <kbd>Tab</kbd> в списке.</dd> - <dt>Text direction left-to-right</dt> - <dd>Переключает текущее направление текста на слева направо. Используется при работе с другими языками. Например, при работе с английским текстом в арабском.</dd> - <dt>Text direction right-to-left</dt> - <dd>Переключает текущее направление текста на справа налево. Используется при работе с другими языками. Например, при работе с арабским текстом в английском.</dd> -</dl> - -<h2 id="Медиа">Медиа</h2> - -<p>Данная группа предоставляет инструменты для работы с медиафайлами.</p> - -<dl> - <dt>Image</dt> - <dd>Вставляет новое изображение в статью. Смотрите <a href="/ru/docs/MDN/Contribute/Editor/Images">Изображения</a> для подробностей.</dd> - <dt>Table</dt> - <dd>Вставляет таблицу в статью. Смотрите <a href="/ru/docs/MDN/Contribute/Editor/Tables">Таблицы</a> для подробной информации о таблицах в статьях.</dd> - <dt>Embed YouTube Video</dt> - <dd>Открывает диалоговое окно, в котором вы можете ввести URL для видео YouTube. С этой информацией создаётся вызов макроса EmbedYouTube. Это безопасный способ встроить видеоконтент.</dd> - <dt>Insert MathML based on (La)TeX</dt> - <dd>Открывает диалоговое окно, в которое вы можете вставить свой код TeX или LaTeX. Этот код будет конвертирован в <a href="/ru/docs/Web/MathML">MathML</a> вставлен в документ в {{htmlelement("math")}} блоке.</dd> -</dl> - -<p> </p> diff --git a/files/ru/orphaned/mdn/editor/images/index.html b/files/ru/orphaned/mdn/editor/images/index.html deleted file mode 100644 index 19adda54f1..0000000000 --- a/files/ru/orphaned/mdn/editor/images/index.html +++ /dev/null @@ -1,79 +0,0 @@ ---- -title: Изображения -slug: orphaned/MDN/Editor/Images -tags: - - Изображение - - Работа с изображениями - - Рисунок - - Руководство -translation_of: MDN/Editor/Images -original_slug: MDN/Editor/Картинки ---- -<div>{{MDNSidebar}}</div> - -<p><span class="seoSummary">Изображения очень часто используются при оформлении статей. Они могут быть снимками экрана (screenshot), примерами того, как должно выглядеть произведение искусства, SVG-диаграммами. Данная статья описывает способы работы с изображениями в контенте сайта MDN.</span></p> - -<div class="note"><strong>Замечание: </strong>При загрузке изображения, пожалуйста, убедитесь, что используете инструменты оптимизации, чтобы сделать файл маленьким, а загрузку возможной. Это сокращает время загрузки страницы и помогает производительности MDN в целом. Вы можете использовать свой любимый инструмент, если он у вас есть. Иначе, мы предлагаем <a href="https://tinypng.com/">TinyPNG</a> - удобный Веб инструмент.</div> - -<p id="Adding_images_to_an_article">После добавления изображения на страницу (смотрите {{SectionOnPage("/en-US/docs/MDN/Contribute/Editor/Basics", "The attachments box")}}), его можно использовать в оформлении статьи. Также можно использовать любые уже загруженные изображения, размещённые на сайте MDN. Для добавления нажмите на кнопку "Изображение" на панели инструментов: <img alt="Toolbar icon for inserting image" src="https://mdn.mozillademos.org/files/12475/image_icon.png" style="height: 15px; width: 18px;"></p> - -<p>Окно<strong> Свойства изображения</strong>:</p> - -<p><img alt=""></p> - -<p>Здесь присутствуют три вкладки: "<strong>Данные об изображении</strong>" (Image Info), "<strong>Ссылка</strong>" (Link), "<strong>Дополнительно</strong>" (Advanced).</p> - -<h2 id="Вкладка_Данные_об_изображении"><strong>Вкладка "Данные об изображении"</strong></h2> - -<dl> - <dt>Прикреплённые файлы (Attachments)</dt> - <dd>Этот выпадающий список содержит прикреплённые к странице элементы. Здесь перечислены только объекты, загруженные в текущем сеансе редактирования или те, которые уже используются на странице.</dd> - <dt>Ссылка (URL)</dt> - <dd>Если есть необходимость использовать рисунок, которого нет в прикреплённых файлах, например, файл загружен в прошлом сеансе редактирования или используется где-то на MDN, то можно указать URL рисунка.</dd> - <dt>Альтернативный текст (Alternative text)</dt> - <dd>Текст, который будет показываться вместо изображения, если оно не отображается (например, если пользователь выключил отображение картинок в браузере). Этот текст также используется программами чтения с экрана, поэтому, пожалуйста, поместите соответствующую заметку здесь для удобства доступа.</dd> - <dt>Ширина / Высота (Width / Height)</dt> - <dd>Вы можете настраивать ширину и высоту изображения, как указано в этой статье. По умолчанию эти поля заблокированы для сохранения пропорций изображения, но блокировку можно отключить нажатием на значок <img alt="">.</dd> - <dt>Граница (Border)</dt> - <dd>Дополнительно можно установить толщину границы вокруг изображения. Рекомендуется указывать 0 (ноль или оставить пустым) или 1. Используйте эту опцию только в том случае, если фон изображения светлый и его нужно дополнительно выделить на фоне веб-страницы.</dd> - <dt>Горизонтальный отступ / Вертикальный отступ (HSpace / VSpace)</dt> - <dd>Указывается число пикселей, которое нужно отступить от изображения по горизонтали или вертикали, например, чтобы отодвинуть текст. Обычно эта настройка используется вместе с выравниванием, описанным ниже.</dd> - <dt>Выравнивание (Alignment)</dt> - <dd>По умолчанию изображения отображаются по отдельности от текста или других изображений (текст и новые изображения обычно переносятся на новую строку). Но этой опцией можно указать, какой стороны листа (левой или правой) должно придерживаться изображение и с какой стороны (правой или левой соответственно) текст будет его обтекать. Так приходится оформлять статьи, если изображение маленькое (или, например, узкое и длинное), и тем самым можно сэкономить свободное пространство и повысить удобство чтения. Если используется эта опция, то, вероятно, нужно будет использовать опции горизонтального и вертикального отступа, чтобы немного отодвинуть текст от изображения. Например, для отступа может использоваться значение 6 или 8.</dd> -</dl> - -<p>Область "Предпросмотр" показывает пример изображения, которое изменится, исходя из введённых параметров.</p> - -<h2 id="Вкладка_Ссылка">Вкладка "Ссылка"</h2> - -<p>Здесь настраивается ссылка, по которой произойдёт переход при клике на изображение. Часто используется ссылка на увеличенное изображение (можно использовать ту же ссылку, что и на вкладке "Данные об изображении"). Пример:</p> - -<p><img alt=""></p> - -<dl> - <dt>Ссылка (URL)</dt> - <dd>Ссылка для перехода при клике на изображение.</dd> - <dt>Цель (Target)</dt> - <dd>Вариант открытия страницы перехода. Значения аналогичные атрибуту {{htmlattrxref("target", "a")}} HTML-тега {{HTMLElement("a")}}. <strong>Не рекомендуется использовать это поле </strong>на MDN. На MDN отдаётся предпочтение открытию ссылок на текущей вкладке браузера.</dd> -</dl> - -<h2 id="Поддерживаемые_типы_изображений">Поддерживаемые типы изображений</h2> - -<p>Вы можете загружать изображения следующих типов: GIF, JPEG, PNG , а также SVG-диаграммы. Предпочитаемые типы на MDN:</p> - -<ul> - <li>PNG для снимков экрана</li> - <li>SVG для диаграмм и графиков, потому что их проще перевести на другие языки, чем обычные картинки</li> -</ul> - -<p>Можно загружать файлы из Photoshop. Но их нельзя будет использовать для оформления статей, а только выкладывать для загрузки пользователями.</p> - -<h2 id="Удаление_и_изменение">Удаление и изменение</h2> - -<p>Для удаление изображения из статьи кликните в изображение мышкой (или установите курсор непосредственно до изображения) и нажмите на клавиатуре клавишу "delete".</p> - -<p>Можно изменить свойства изображения, кликнув на него дважды или кликнув правой кнопкой мыши и выбрав из выпадающего контекстного меню пункт "<strong>Свойства изображения</strong>". В обоих случаях откроется один и тот же диалог.</p> - -<p>Удалять вложения могут только администраторы MDN. Обычно мы оставляем старые версии изображений, потому что на них могут оставаться ссылки из старых версий документов. В случае обнаружения недопустимых, неуместных или проприетарных изображений, пожалуйста, обратитесь к <a href="/en-US/docs/MDN/Community/Roles/Admins">администратору MDN</a> для удаления такого вложения или <a href="https://bugzilla.mozilla.org/enter_bug.cgi?product=Developer+Documentation">заведите инцидент</a> для удаления.</p> - -<p>{{EditorGuideQuicklinks}}</p> diff --git a/files/ru/orphaned/mdn/editor/index.html b/files/ru/orphaned/mdn/editor/index.html deleted file mode 100644 index 6a775db62e..0000000000 --- a/files/ru/orphaned/mdn/editor/index.html +++ /dev/null @@ -1,48 +0,0 @@ ---- -title: Руководство по MDN редактору -slug: orphaned/MDN/Editor -tags: - - Landing - - MDN - - Редактор MDN -translation_of: MDN/Editor -original_slug: MDN/Editor ---- -<div>{{MDNSidebar}}</div> - -<div>{{IncludeSubnav("/ru/docs/MDN")}}</div> - -<p><span class="seoSummary">WYSIWYG ("<em>what-you-see-is-what-you-get"</em> в переводе "<em>что видишь, то и получишь</em>") — редактор для веб-документов MDN, который позволяет легко делать вклад в новый контент. Это руководство показывает, как использовать редактор и улучшить вашу продуктивность. Пожалуйста, убедитесь в том, что прочитали <a href="https://www.mozilla.org/en-US/about/legal/terms/mozilla/">Условия использования Mozilla</a> и согласны с ними перед тем, как начать редактировать или создавать новые страницы.</span></p> - -<p><a href="/ru/docs/Project:Writer's_guide" title="/en-US/docs/Project:MDN/Style_guide">Руководство по оформлению MDN</a> предлагает информацию о том, как оформлять и стилизовать контент, включая предпочтительные грамматические и орфографические правила.</p> - -<div class="row topicpage-table"> -<div class="section"> -<dl> - <dt class="landingPageList"><a href="https://wiki.developer.mozilla.org/ru/docs/MDN/Contribute/Editor/Basics">Редактор UI элементов</a></dt> - <dd class="landingPageList">Встроенный WYSIWYG редактор на MDN разработан так, чтобы максимально упростить создание, редактирование и улучшение статей и других страниц практически на всем сайте. Окно редактора, как показано ниже, состоит из восьми блоков.<br> - Это руководство предоставляет информацию о каждом разделе, чтобы вы знали, как использовать все возможности нашего редактора.</dd> - <dt class="landingPageList"><a href="https://wiki.developer.mozilla.org/ru/docs/MDN/Contribute/Editor/%D0%9A%D0%B0%D1%80%D1%82%D0%B8%D0%BD%D0%BA%D0%B8">Изображения</a></dt> - <dd class="landingPageList">Изображения очень часто используются при оформлении статей. Они могут быть снимками экрана, примерами того, как должен выглядеть результат, SVG-диаграммами. Данная статья описывает способы работы с изображениями в контенте сайта MDN.</dd> - <dt class="landingPageList"><a href="https://wiki.developer.mozilla.org/ru/docs/MDN/Contribute/Editor/%D0%93%D0%BE%D1%80%D1%8F%D1%87%D0%B8%D0%B5_%D0%BA%D0%BB%D0%B0%D0%B2%D0%B8%D1%88%D0%B8">Горячие клавиши в редакторе MDN</a></dt> - <dd class="landingPageList">Существует ряд удобных горячих клавиш, позволяющих вам не отрывать руки от клавиатуры во время работы в UI редактора MDN. Они перечислены в этой статье.</dd> - <dt class="landingPageList"><a href="https://wiki.developer.mozilla.org/ru/docs/MDN/Contribute/Editor/%D0%A1%D1%81%D1%8B%D0%BB%D0%BA%D0%B8">Ссылки</a></dt> - <dd class="landingPageList">Ссылки — это ключевой компонент любой вики не только среди множества документов, но и в пределах одного. К счастью, ссылки очень легко создавать, даже несмотря на то, что есть <em>очень много</em> способов сделать их! В статье рассказывается всё о ссылках в редакторе MDN.</dd> -</dl> -</div> - -<div class="section"> -<dl> - <dt class="landingPageList"><a href="https://wiki.developer.mozilla.org/ru/docs/MDN/Contribute/Editor/%D0%9F%D0%B5%D1%80%D0%B5%D0%BD%D0%B0%D0%BF%D1%80%D0%B0%D0%B2%D0%BB%D0%B5%D0%BD%D0%B8%D0%B5">Перенаправление</a></dt> - <dd class="landingPageList">Иногда вам понадобится создать страницу, которая просто перенаправляет на другую страницу. В этой статье рассказывается, как сделать переадресацию.</dd> - <dt class="landingPageList"><a href="https://wiki.developer.mozilla.org/ru/docs/MDN/Contribute/Editor/Source_mode">Режим источника</a></dt> - <dd class="landingPageList">В редакторе MDN есть особая кнопка, позволяющая вам включать режим источника. В этом режиме вы можете видеть HTML-код тела статьи, которую вы пишете. Это руководство поможет вам понять, что вы <strong>можете</strong> делать в режиме источника, что вам <strong>следует</strong> с ним делать и, самое важное, чего вам делать <strong>не следует</strong>.</dd> - <dt class="landingPageList"><a href="https://wiki.developer.mozilla.org/ru/docs/MDN/Contribute/Editor/%D0%A1%D0%B8%D0%BD%D1%82%D0%B0%D0%BA%D1%81%D0%B8%D1%87%D0%B5%D1%81%D0%BA%D0%B8%D0%B5_%D0%B2%D1%8B%D0%B4%D0%B5%D0%BB%D0%B5%D0%BD%D0%B8%D1%8F">Синтаксические выделения</a></dt> - <dd class="landingPageList">Синтаксическое выделение кода крайне полезно в статьях. Режим синтаксического выделения также используется в нашей системе шаблонов, чтобы определять, как использовать каждый отрывок кода при сборке в готовый экземпляр.</dd> - <dt class="landingPageList"><a href="https://wiki.developer.mozilla.org/ru/docs/MDN/Contribute/Editor/Tables">Таблицы</a></dt> - <dd class="landingPageList">Таблицы полезны для представления информации. В этой статье описано, как создавать и обслуживать таблицы на MDN и когда стоит и не стоит использовать их.</dd> -</dl> -</div> -</div> - -<p>{{EditorGuideQuicklinks}}</p> diff --git a/files/ru/orphaned/mdn/editor/keyboard_shortcuts/index.html b/files/ru/orphaned/mdn/editor/keyboard_shortcuts/index.html deleted file mode 100644 index 851dc023d4..0000000000 --- a/files/ru/orphaned/mdn/editor/keyboard_shortcuts/index.html +++ /dev/null @@ -1,147 +0,0 @@ ---- -title: Горячие клавиши в редакторе MDN -slug: orphaned/MDN/Editor/Keyboard_shortcuts -tags: - - MDN - - MDN Meta - - Reference - - Горячие клавиши - - Клавиши - - Редактор -translation_of: MDN/Editor/Keyboard_shortcuts -original_slug: MDN/Editor/Горячие_клавиши ---- -<p><span class="seoSummary">Существует ряд удобных горячих клавиш, позволяющих вам не отрывать руки от клавиатуры во время работы в UI редактора MDN.</span></p> - -<p>Горячие клавиши перечислены для Windows и Linux; для Mac вместо ключа <kbd>Control</kbd> используйте <kbd>Command</kbd>.</p> - -<table class="standard-table"> - <colgroup> - <col style="width: 15em;"> - </colgroup> - <tbody> - <tr> - <th>Сочетание клавиш</th> - <th>Описание</th> - </tr> - <tr> - <td><kbd>Ctrl</kbd> + <kbd>A</kbd></td> - <td>Выделить всё</td> - </tr> - <tr> - <td><kbd>Ctrl</kbd> + <kbd>C</kbd></td> - <td>Копировать</td> - </tr> - <tr> - <td><kbd>Ctrl</kbd> + <kbd>V</kbd></td> - <td>Вставить</td> - </tr> - <tr> - <td><kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>V</kbd></td> - <td>Вставить без форматирования</td> - </tr> - <tr> - <td><kbd>Ctrl</kbd> + <kbd>X</kbd></td> - <td>Вырезать</td> - </tr> - <tr> - <td><kbd>Ctrl</kbd> + <kbd>Z</kbd></td> - <td>Отменить</td> - </tr> - <tr> - <td><kbd>Ctrl</kbd> + <kbd>Y</kbd></td> - <td>Повторить</td> - </tr> - <tr> - <td><kbd>Ctrl</kbd> + <kbd>K</kbd></td> - <td>Открыть редактор ссылок/добавить новую ссылку</td> - </tr> - <tr> - <td><kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>K</kbd></td> - <td>Удалить ссылку в текущем положении курсора</td> - </tr> - <tr> - <td><kbd>Ctrl</kbd> + <kbd>B</kbd></td> - <td><strong>Полужирный текст</strong></td> - </tr> - <tr> - <td><kbd>Ctrl</kbd> + <kbd>I</kbd></td> - <td><em>Курсив</em></td> - </tr> - <tr> - <td><kbd>Ctrl</kbd> + <kbd>O</kbd></td> - <td>Включить стилизацию <code><code></code></td> - </tr> - <tr> - <td><kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>O</kbd></td> - <td> - <p>Включить режим просмотра источника</p> - - <div class="note">Будьте внимательны при работе в режиме источника: вы должны придерживаться наших стандартов заполнения содержимого. Ознакомьтесь с нашим <a href="/en-US/docs/MDN/Contribute/Editor/Source_mode">гайдом по режиму источника</a>, чтобы узнать, как использовать режим источника и что вам следует и не следует делать в нём.</div> - </td> - </tr> - <tr> - <td><kbd>Ctrl</kbd> + <kbd>P</kbd></td> - <td> - <pre class="notranslate"> -Включить или отключить стилизацию <code><pre></code> в текущем блоке.</pre> - </td> - </tr> - <tr> - <td><kbd>Ctrl</kbd> + <kbd>U</kbd></td> - <td><u>Подчёркивание</u></td> - </tr> - <tr> - <td><kbd>Ctrl</kbd> + <kbd>S</kbd></td> - <td>Опубликовать изменения, не закрывая редактор</td> - </tr> - <tr> - <td><kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>S</kbd></td> - <td>Опубликовать изменения и закрыть редактор</td> - </tr> - <tr> - <td><kbd>Ctrl</kbd> + <kbd>0</kbd></td> - <td>Удалить форматирование в выделенной области (Это ноль, а не буква "О")</td> - </tr> - <tr> - <td>От <kbd>Ctrl</kbd> + <kbd>2</kbd> до <kbd>Ctrl</kbd> + <kbd>5</kbd></td> - <td>Выбор уровней заголовков от 2 до 5. Уровень 1 предназначен для заголовка страницы, расположенного в верху статьи</td> - </tr> - <tr> - <td><kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>L</kbd></td> - <td>Преобразование выделенного текста (по порядку): в нумерованный список — в маркированный список — удалить список</td> - </tr> - <tr> - <td><kbd>Tab</kbd></td> - <td>Увеличивает отступ или же вставляет два пробела. В таблицах перемещает курсор в следующую ячейку или вставляет новый ряд, если следующей клетки нет. Курсор перемещается на следующий абзац, если находится на заголовке страницы</td> - </tr> - <tr> - <td><kbd>Shift</kbd> + <kbd>Tab</kbd></td> - <td>Уменьшает отступ. В таблицах перемещает курсор в предыдущую ячейку или вставляет новый ряд, если предыдущей клетки нет. Курсор перемещается на следующий абзац, если находится на заголовке страницы</td> - </tr> - <tr> - <td><kbd>Shift</kbd> + <kbd>Space</kbd></td> - <td>Вставляет неразрывный пробел(<code>&nbsp;</code>)</td> - </tr> - <tr> - <td><kbd>Shift</kbd> + <kbd>Enter</kbd></td> - <td> - <p>Выводит из блока. К примеру, если вы редактируете блок <code><pre></code>, <kbd>Shift</kbd> + <kbd>Enter</kbd> выводит курсор из блока, помещая его обратно в тело статьи</p> - - <div class="blockIndicator note"> - <p>На данный момент не поддерживается: {{bug('780055')}}.</p> - </div> - </td> - </tr> - </tbody> -</table> - -<h2 id="Смотрите_также">Смотрите также</h2> - -<ul> - <li><a href="https://wiki.developer.mozilla.org/ru/docs/MDN/Contribute/Editor/Basics">Редактор UI элементов</a></li> - <li><a href="https://developer.mozilla.org/ru/docs/MDN/Contribute">Сотрудничество с MDN</a></li> - <li><a href="https://wiki.developer.mozilla.org/ru/docs/MDN/Getting_started">Mozilla - быстрый старт!</a></li> -</ul> - -<div>{{MDNSidebar}}</div> diff --git a/files/ru/orphaned/mdn/editor/links/index.html b/files/ru/orphaned/mdn/editor/links/index.html deleted file mode 100644 index fe1182a58a..0000000000 --- a/files/ru/orphaned/mdn/editor/links/index.html +++ /dev/null @@ -1,188 +0,0 @@ ---- -title: Создание ссылок в статьях MDN -slug: orphaned/MDN/Editor/Links -tags: - - Guide - - MDN - - MDN Meta - - Документация - - Редактор - - Руководство -translation_of: MDN/Editor/Links -original_slug: MDN/Editor/Ссылки ---- -<div>{{MDNSidebar}}</div> - -<p id="Creating_and_editing_links"><span class="seoSummary">Ссылки — это ключевой компонент любой вики не только среди множества документов, но и в пределах одного. К счастью, ссылки очень легко создавать, даже несмотря на то, что есть <em>очень много</em> способов сделать их!</span></p> - -<div class="note"> -<p><strong>Обратите внимание</strong>, что у нас есть <a href="https://wiki.developer.mozilla.org/en-US/docs/MDN/Contribute/Guidelines/Writing_style_guide#Links">особые правила применения ссылок</a>: они описаны в <a href="https://developer.mozilla.org/ru/docs/Project:Writer's_guide">руководстве по оформлению материалов MDN</a>.</p> -</div> - -<h2 id="Использование_панели_инструментов">Использование панели инструментов</h2> - -<p>Самый очевидный способ создать ссылку — нажать на кнопку <kbd>Вставить/Редактировать ссылку</kbd> на панели инструментов или нажать сочетание <kbd>Ctl</kbd>+<kbd>K</kbd> (<kbd>Command</kbd>-<kbd>K</kbd> для Mac). Кнопка ссылки выглядит так: <img alt="The link button (as of 2015-12-04)" src="https://mdn.mozillademos.org/files/12003/link-button.png" style="height: 16px; width: 16px;">. Вы можете добавлять текст к выделенному тексту.</p> - -<h3 id="Создание_ссылки">Создание ссылки</h3> - -<p>После нажатия на кнопку ссылки появится диалоговое окно для работы с ссылками:</p> - -<p><img alt="Окно для работы с ссылками" src="https://mdn.mozillademos.org/files/15289/link-info.png" style="height: 320px; width: 335px;"></p> - -<p>Здесь вы можете создать новую ссылку. Параметры окна:</p> - -<dl> - <dt>Ссылка (Link Type)</dt> - <dd>Это тип создаваемой вами ссылки. Тип по умолчанию, URL, используется в сети — или в MDN, или вне его. Вы также можете выбрать "Link to anchor in the text" или "Email". Ссылка-якорь позволяет вам привязать её к якорю, созданному вами ранее с помощью кнопки <kbd>Вставить / редактировать якорь</kbd> на панели инструментов. Опция email позволяет вам настроить: URL-адрес получателя, получателя и сообщение. Чаще всего вы будете использовать тип URL.</dd> - <dt>Поиск ссылки по заголовку / Текст ссылки (Article Title Lookup / Link Text)</dt> - <dd>У этого поля есть две цели: во-первых, вы обозначаете текст, который будет использован как указатель ссылки (или, если вы выделили текст до открытия окна, он будет отображён как указатель ссылки), во-вторых, текст, введённый в это поле, используется для поиска статей на MDN, чтобы найти возможное направление ссылки. К примеру, если вы введёте "Array" в поле, вы увидите что-то наподобие этого:<br> - <img alt='Screenshot of the Link dialog box, showing a lookup menu for the text "Array"' src="https://mdn.mozillademos.org/files/15291/link%20dialog%20with%20lookup%20menu.png" style="border-style: solid; border-width: 1px; height: 388px; width: 496px;"></dd> -</dl> - -<dl> - <dd>На картинке вы можете видеть все страницы MDN, чьи заголовки содержат текст, напечатанный вами. Вы можете прокрутить список и выбрать одну из страниц или продолжить набирать текст, сужая список. Заметьте, у названий страниц отображается их язык (в нашем примере это "[en-US]"). Это не отображается в указателе ссылки; так сделано для того, чтобы вы убедились, что вы ссылаетесь на статью того же языка, на котором пишете вы.</dd> - <dt>Прикрепление ссылки (Attachments)</dt> - <dd>В качестве альтернативы вы можете сделать так, чтобы ссылка была привязана к одному из файлов, прикреплённому к этой странице. Это отличный способ предоставить ссылку для скачивания примера кода и тому подобное.</dd> - <dt>URL</dt> - <dd>Наконец, поле для URL-адреса позволяет вам ввести URL; в поле также выводятся URL выбранных вами элементов из меню <strong>Article Title Lookup</strong> или <strong>Attachments</strong>, если вы их использовали. Нередко используют URL-адреса страниц MDN, поэтому, если вы ссылаетесь на другую страницу MDN, удалите доменное имя ("https://developer.mozilla.org") из начала URL.</dd> -</dl> - -<p>Как только завершите настройку ссылки, нажмите <kbd><strong>OK</strong></kbd><strong>.</strong></p> - -<div class="note"> -<p>В верху окна также есть вкладка <strong>Advanced</strong>. Нет опций, которые мы советуем вам использовать регулярно, по крайней мере, сейчас. Можете быть, в будущем появятся новые стили для ссылок, но мы, вероятно, добавим новую панель инструментов для этих опций.</p> -</div> - -<h3 id="Ссылки">Ссылки</h3> - -<p>Если у вас есть текст, который вы хотели бы превратить в ссылку, вы можете слегка упростить процесс. Выделите нужный вам текст, затем откройте окно для работы с ссылками; поле <strong>Article Title / Lookup Text </strong>будет заполнено выделенным текстом. К примеру, есть у нас, скажем, следующий текст:</p> - -<blockquote> -<p>You may find it useful to use JavaScript arrays when working on this project.</p> -</blockquote> - -<p>Нам хотелось бы преобразовать <em>arrays</em> в ссылку на файл с соответствующим содержанием. Просто выделите слово и включите окно для работы с ссылками; у вас появится заполненное окно, похожее на изображение выше. Наводя мышь на поле-подсказку, вы можете видеть её относительный путь (его URL относится к <code>developer.mozilla.org</code>), благодаря чему вы можете лучше узнать, где находится статья и о чём она.</p> - -<p><img alt="Screenshot of the Link dialog box, showing a lookup menu and a URL tooltip" src="https://mdn.mozillademos.org/files/15293/Rollover%20of%20lookup%20menu.png" style="border-style: solid; border-width: 1px; height: 387px; width: 493px;"></p> - -<p>На примере: подсказки — это возможные совпадения. Кажется, <em>arrays</em> было выбрано удачно; выберем этот вариант. Поле сразу заполняется URL-адресом, поэтому мы просто жмём <kbd><strong>OK</strong></kbd>, и цитата будет выглядеть так:</p> - -<blockquote> -<p>You may find it useful to use JavaScript <a href="/en-US/docs/Web/JavaScript/Typed_arrays">arrays</a> when working on this project.</p> -</blockquote> - -<h2 id="Использование_макросов">Использование макросов</h2> - -<p>MDN часто использует <a href="/en-US/docs/Project:MDN/Contributing/Editor_guide#Using_macros">макросы</a>, чтобы автоматически создавать термины-ссылки с соответствующим содержанием, стилизуя их как ссылки в соответствии с нашими <a href="https://wiki.developer.mozilla.org/ru/docs/Project:Writer's_guide">правилами оформления элементов</a>. Учтите: наше <a href="https://wiki.developer.mozilla.org/ru/docs/Project:Writer's_guide">руководство</a> отмечает, что API-термины, элементы и атрибуты HTML, свойства, имена функций CSS и тому подобное,— должны быть стилизованы с помощью элемента {{HTMLElement("code")}}. Также должны быть ссылки на другие страницы MDN.</p> - -<p>К использованию макросов для создания ссылок легко привыкнуть, и это предоставляет множество плюсов:</p> - -<ul> - <li>Стили добавлены для вас.</li> - <li>Ссылка создана для вас — и она не подвергается изменениям, если структура MDN меняется.</li> - <li>Соответствующие подсказки также созданы для вас.</li> -</ul> - -<p>Есть очень много таких макросов, и мы не будем останавливаться на них подробно здесь. Вместо этого мы разберём несколько самых часто употребляемых. Если интересно, ознакомьтесь с разделом "<a href="https://wiki.developer.mozilla.org/en-US/docs/MDN/Contribute/Structures/Macros/Commonly-used_macros#Linking">Создание гиперссылок</a>" в нашей статье <a href="/en-US/docs/Project:MDN/Contributing/Custom_macros">Пользовательский макрос для MDN</a>.</p> - -<div class="blockIndicator note"> -<p>Ещё проще посетить <a href="/en-US/docs/Project:Introduction_to_KumaScript">KumaScript</a>, где есть любой из этих макросов; ко многим макросам есть комментарии вверху, объясняющие, как макрос работает и какие у него переменные.</p> -</div> - -<h3 id="Ссылка_на_документацию_для_API">Ссылка на документацию для API</h3> - -<p>У нас есть несколько невероятно полезных макросов для создания стилизованных ссылок для API. В этом подразделе перечислены самые удобные; в каждый блок могут быть добавлены доступные параметры, чтобы предоставить больший контроль над выводом. На название каждого макроса можно кликнуть, чтобы увидеть сам код макроса; у каждого макроса есть комментарии вверху, объясняющие, как макрос работает и какие у него переменные.</p> - -<dl> - <dt>{{TemplateLink("HTMLElement")}}</dt> - <dd>Вставляет в HTML-код название элемента с необходимыми стилизацией и ссылками. К примеру: <code>\{{HTMLElement("table")}}</code> даёт {{HTMLElement("table")}}.</dd> - <dt>{{TemplateLink("cssxref")}}</dt> - <dd>Вставляет в CSS-код документацию свойства, правила или селектора. Например: <code>\{{cssxref("background-color")}}</code> в результате выводит {{cssxref("background-color")}}.</dd> - <dt>{{TemplateLink("domxref")}}</dt> - <dd>Вставляет данный термин API. Пример: <code>\{{domxref("window")}}</code> даёт в результате {{domxref("window")}}, и <code>\{{domxref("window.scrollBy()")}}</code> вставляет {{domxref("window.scrollBy()")}}. Вы также можете вставить дополнительный параметр, чтобы заменить текст: <code>\{{domxref("window.scrollBy", "scrollBy()")}}</code> заменяет <code>{{domxref("window.scrollBy")}}</code> на {{domxref("window.scrollBy", "scrollBy()")}}.</dd> - <dt>{{TemplateLink("SVGElement")}}</dt> - <dd>Вставляет название SVG-элемента с необходимыми стилизацией и ссылками. К примеру: <code>\{{SVGElement("circle")}}</code> даёт {{SVGElement("circle")}}.</dd> -</dl> - -<h3 id="Добавление_якорей">Добавление якорей</h3> - -<p>Чтобы применить ссылку к области с таким же названием, следует использовать макрос {{TemplateLink("anch")}}. Синтаксис — проще некуда: <code>\{{anch("Name of destination section")}}</code>. По умолчанию текст ссылки — это название области, но вы можете добавить второй, необязательный, параметр, обозначающий альтернативный текст. Несколько примеров:</p> - -<ul> - <li><code>\{{anch("Использование панели инструментов</code><code>")}}</code> будет выглядеть так: {{anch("Использование панели инструментов")}}</li> - <li><code>\{{anch("Использование панели инструментов</code><code>", "Ранее в этой статье")}}</code> выведет: {{anch("Использование панели инструментов", "Ранее в этой статье")}}</li> -</ul> - -<h3 id="Ссылки_к_багам">Ссылки к багам</h3> - -<p>Вы можете создать ссылку на базу данных Mozilla's Bugzilla с макросом {{TemplateLink("bug")}}. У этого макроса всего один параметр: номер бага, на который ссылаются. К примеру, <code>\{{bug(765642)}}</code> покажет: {{bug(765642)}}.</p> - -<p>Таким же образом вы можете создавать ссылки к багам на других браузерах и браузерных движках:</p> - -<dl> - <dt>WebKit (Safari и т.д.)</dt> - <dd>{{TemplateLink("WebkitBug")}}: <code>\{{webkitbug(31277)}}</code> даёт {{webkitbug(31277)}}.</dd> -</dl> - -<h3 id="Ссылки_к_RFC">Ссылки к RFC</h3> - -<p>Суть работы Интернета изложена в RFC. Вы можете с лёгкостью обратиться к RFCs с помощью {{TemplateLink("RFC")}}. Для примера, \{{RFC(2616)}} станет {{RFC(2616)}}. Вы можете при желании снабдить макрос альтернативной ссылкой, чтобы использовать вместо выделенного участка текста или нескольких участков, с описанием, к какой ссылке привязать их.</p> - -<p><span style="">Ссылки к информации о XPCOM-интерфейсах</span></p> - -<div class="note"> -<p>MDN больше не поддерживает XPCOM-документацию, но внесение вклада приветствуется!</p> -</div> - -<p>Если вы документируете свойства Mozilla, способность быстро создать ссылку к документации XPCOM очень полезна. Здесь несколько макросов для этого.</p> - -<p>Синтаксис: <code>\{{interface("interfacename")}}</code>. К примеру, вы написали:</p> - -<blockquote> -<p>When you need to parse or create URIs, the \{{interface("nsIIOService")}} interface can help.</p> -</blockquote> - -<p>В результате получится</p> - -<blockquote> -<p>When you need to parse or create URIs, the {{interface("nsIIOService")}} interface can help.</p> -</blockquote> - -<p>Если вам нужна ссылка к информации о методе или атрибуте XPCOM-интерфейса, макросы {{TemplateLink("ifmethod")}} и {{TemplateLink("ifattribute")}} точно для вас. Названия интерфейса и метода или атрибута, к которым вы ссылаетесь, принимаются за параметры. Макрос {{TemplateLink("ifmethod")}} особенно интересен, т.к. он по-особому форматирует элемент при добавлении стиля родителя после названия метода. Например, <code>\{{ifmethod("nsIIOService", "newURI")}}</code> выводит {{ifmethod("nsIIOService", "newURI")}}. Это контейнер, в котором вы защищены от стилевых изменений MDN в будущем!</p> - -<h3 id="Ссылка_к_привилегированной_документации_Mozilla">Ссылка к привилегированной документации Mozilla</h3> - -<p>Для вставки Mozilla preference и для того, чтобы привязать её к соответствующей странице в <a href="/en-US/docs/Mozilla/Preferences/Preference_reference">Preference reference</a>, используйте макрос {{TemplateLink("pref")}} . У него всего один параметр: полное название привилегерованного элемента. Например, <code>\{{pref("javascript.options.showInConsole")}}</code> преобразуется в: {{pref("javascript.options.showInConsole")}}.</p> - -<h3 id="Ссылка_к_ресурсам_Mozilla">Ссылка к ресурсам Mozilla</h3> - -<p>Вы можете ссылаться на дерево ресурсов Mozilla's (хотя не стоит делать это часто), используя макрос {{TemplateLink("source")}}. Вместо указания абсолютного пути вам достаточно указать путь относительно директории <code>/source/</code>. Для примера: \{{source("browser/Makefile.in")}} создаёт эту ссылку: {{source("browser/Makefile.in")}}.</p> - -<p>Вы можете при желании снабдить ссылку альтернативным текстом. Например, как видите, \{{source("browser/Makefile.in", "the browser's makefile")}} преобразуется в: {{source("browser/Makefile.in", "the browser's makefile")}}.</p> - -<div class="note"> -<p>Обратите внимание на документацию {{anch("Использование макросов")}}, если вы заинтересованы в более подробном изучении макросов и посетите <a href="/en-US/docs/Project:MDN/Kuma/KumaScript_guide">KumaScript</a>, чтобы больше узнать о системе макросов.</p> -</div> - -<h2 id="Ссылки_на_рекомендованные_статьи">Ссылки на рекомендованные статьи</h2> - -<p>Если вы хотите создать список связанных страниц или другого рекомендованного материала к прочтению, вам следует делать это с помощью создания контейнера быстрых ссылок в боковой панели. Такой подход заменяет наши старые <em>Смотрите также</em> в конце статей. О том, как создавать контейнер с быстрыми ссылками, читайте в статье <a href="/en-US/docs/MDN/Contribute/Structures/Quicklinks">Быстрые ссылки</a>.</p> - -<h2 id="Схемы_URL-адресов">Схемы URL-адресов</h2> - -<p>В целях безопасности создавайте ссылки, имеющие следующие схемы:</p> - -<ul> - <li><code>http://</code></li> - <li><code>https://</code></li> - <li><code>ftp://</code></li> - <li><code>mailto:</code></li> -</ul> - -<p>Другие схемы просто-напросто будут удалены.</p> - -<div class="note"> -<p>Особые URL-схемы, такие как <code>about:</code> и <code>chrome:</code> используются Firefox, Google Chrome и некоторыми другими браузерами, чтобы предоставить доступ к особым опциям, таким как привилегерованные элементы, отладочная информация и так далее. Эти ссылки не работают в содержимом статьи, поэтому не создавайте ссылки, используя эти схемы в MDN. То же относится и к схемам <code>javascript:</code> и <code>jar:</code>, которые блокируются большинством браузеров в целях безопасности.</p> -</div> - -<p>{{EditorGuideQuicklinks}}</p> diff --git a/files/ru/orphaned/mdn/editor/redirects/index.html b/files/ru/orphaned/mdn/editor/redirects/index.html deleted file mode 100644 index 3a5a15c6fc..0000000000 --- a/files/ru/orphaned/mdn/editor/redirects/index.html +++ /dev/null @@ -1,32 +0,0 @@ ---- -title: Перенаправление -slug: orphaned/MDN/Editor/Redirects -tags: - - Гайд - - Переадресация - - Перенаправление - - Удаление -translation_of: MDN/Editor/Redirects -original_slug: MDN/Editor/Перенаправление ---- -<div>{{MDNSidebar}}</div> - -<p><span class="seoSummary">Иногда вам понадобится создать страницу, которая просто перенаправляет на другую страницу. В этой статье рассказывается, как сделать переадресацию.</span></p> - -<h2 id="Создание_перенаправления">Создание перенаправления</h2> - -<p>Перенаправление необходимо, к примеру, когда страница слилась с другой. Чтобы создать перенаправление, просто нажмите эту кнопку в панели инструментов: <img alt="" src="https://mdn.mozillademos.org/files/5131/redirect.png" style="height: 17px; width: 17px;">.</p> - -<p>Она откроет диалоговое окно, в котором запрашивается имя документа и его URL-адрес. Вообще, имя не так важно; оно больше нужно, если вы сами ищете страницу, и вам нужно знать, куда вы перенаправляете. В поле <em>URL</em> должен быть указан абсолютный (полный) путь, например, "/en-US/docs/foo". Относительные ссылки не сработают. Вы можете перенаправить на раздел страницы, используя хештег ("#"), например: "/destination/url/here#название_раздела". Таким образом вы перенаправить пользователя прямиком в раздел страницы.</p> - -<p>На странице должно быть только перенаправление; перед его созданием переместите всё содержимое в его новый "дом". Удалите также ревизионные флаги с этой страницы.</p> - -<div class="note"> -<p><strong>Замечание:</strong> Обязательно удалите все теги со страницы: если вы это не сделаете, страница с перенаправлением будет рядом со страницей, на которую перенаправили (теги-то одинаковые), смущая людей и занимая свободное место на странице результатов поиска. Ещё это плохо скажется на поисковой оптимизации.</p> -</div> - -<h2 id="При_удалении_страницы">При удалении страницы</h2> - -<p>Перед удалением страницы подумайте: а не будет ли лучше перенаправить посетителя на другую страницу MDN? Ведь, если он попадёт на страницу по старой ссылке, лучше отправить его на правильную страницу, чем если бы ему выдали ошибку 404 ("страница не найдена"). Удалять страницу стоит только в крайнем случае: если она забита спамом и прочим неуместным контентом.</p> - -<p>{{EditorGuideQuicklinks}}</p> diff --git a/files/ru/orphaned/mdn/editor/source_mode/index.html b/files/ru/orphaned/mdn/editor/source_mode/index.html deleted file mode 100644 index 7923b81be6..0000000000 --- a/files/ru/orphaned/mdn/editor/source_mode/index.html +++ /dev/null @@ -1,129 +0,0 @@ ---- -title: Режим источника -slug: orphaned/MDN/Editor/Source_mode -tags: - - Guide - - MDN Meta - - NeedsContent - - editor - - Редактор MDN - - Руководство -translation_of: MDN/Editor/Source_mode -original_slug: MDN/Editor/Source_mode ---- -<div>{{MDNSidebar}}</div> - -<p class="summary"> В редакторе MDN есть особая кнопка, позволяющая вам включать режим источника. В этом режиме вы можете видеть HTML-код тела статьи, которую вы пишите. <span class="seoSummary">Это руководство поможет вам понять, что вы <strong>можете</strong> делать в режиме источника, что вам <strong>следует</strong> с ним делать и, самое важное, чего вам делать <strong>не следует</strong>.</span></p> - -<div class="blockIndicator warning"> -<p>Перед тем как использовать режим источника, примите во внимание, что мы <em>крайне</em> <strong>не</strong> рекомендуем использовать режим источника. За исключением случаев, когда то, что вы делаете в режиме источника, соответствует нашему руководству по оформлению кода (мы нуждаемся в опциях, которые, к сожалению, пока что не могут быть созданы без режима источника), вам нет необходимости в использовании этого режима. Смотрите {{anch("Предостережения")}} ниже.</p> -</div> - -<h2 id="Включение_режима_источника">Включение режима источника</h2> - -<p>Включить режим источника очень легко. В левом верхнем углу нажмите кнопку <strong>Источник</strong>.</p> - -<p><img alt="Partial screenshot of the editor toolbar, with the Source mode button highlighted" src="https://mdn.mozillademos.org/files/15295/Source%20mode%20button.png" style="height: 98px; width: 267px;"></p> - -<h2 id="Предостережения">Предостережения</h2> - -<p>Как упомянуто ранее, вам редко понадобится режим источника. Немного вы сможете сделать в этом режиме. Со временем мы обновим интерфейс редактора, чтобы настроить это <em>немного</em> для вас.</p> - -<p>Всего того, что неявно описано где-то в <a href="https://developer.mozilla.org/ru/docs/MDN/Contribute">руководстве по сотрудничеству с MDN</a>, <strong>не</strong> должно быть в источнике. Это значит, что:</p> - -<ul> - <li>Никаких пользовательских шрифтов и стилей</li> - <li>Никаких других цветов. Используйте только те цвета, которые являются частью нашего оформления, задаваемого нашими стилями</li> -</ul> - -<h2 id="Работа_в_режиме_источника">Работа в режиме источника</h2> - -<p>В режиме источника вы работаете с HTML-кодом, который составляет контент страницы вики. Если вы не ограничиваетесь обычным редактором, вы должны убедиться в том, что ваша работа соответствует <a href="https://developer.mozilla.org//en-US/docs/MDN/Contribute/Guidelines/CSS_style_guide">оформлению</a> и что она работает надёжно и безопасно.</p> - -<p>К сожалению, клавиша <kbd>Tab</kbd> пока что не работает в режиме источника. Используйте два пробела там, где обычно используете <kbd>Tab</kbd>.</p> - -<p>Элементы и атрибуты, которые MDN не поддерживает, будут удалены после сохранения документа. Вдобавок HTML документа преобразован, чтобы он был более читаемым и совместимым.</p> - -<h2 id="Использование_режима_источника">Использование режима источника</h2> - -<p>Здесь описано несколько случаев, когда единственный способ соответствовать оформлению статей MDN — использовать режим источника. Этот раздел описывает эти ситуации и как правильно выполнять данные функции, чтобы не испортить остальное.</p> - -<h3 id="Выделение_строк_в_примерах_кода">Выделение строк в примерах кода</h3> - -<p>Блоки примеров кода устанавливаются кнопками <strong>PRE</strong> или <strong>Syntax Highlighter</strong> в <a href="https://wiki.developer.mozilla.org/ru/docs/MDN/Contribute/Editor/Basics/Toolbar#%D0%91%D0%BB%D0%BE%D0%BA%D0%B8" rel="noopener">блоках панели инструментов</a>, но вы, возможно, захотите обратить внимание читателей на определённые строки кода. Единственный способ сделать это — открыть режим источника, найти там блок <a href="https://wiki.developer.mozilla.org/en-US/docs/Web/HTML/Element/pre" rel="noopener" title="The HTML <pre> element represents preformatted text which is to be presented exactly as written in the HTML file."><code><pre></code></a>, содержащий код, и добавить в атрибут <code><a href="https://wiki.developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes#attr-class" rel="noopener">class</a></code> тега <code><pre></code> компонент <code>highlight</code>, отформатированный следующим образом:</p> - -<ul> - <li><code>highlight[<em>НомерСтроки1</em>, <em>НомерСтроки2</em>, ..., <em>НомерСтрокиN</em>]</code></li> - <li><code>highlight[<em>НомерСтрокиНачальной</em>-<em>НомерСтрокиКонечной</em>, ..., <em>НомерСтрокиN</em>]</code></li> -</ul> - -<pre class="syntaxbox notranslate">"hightlight[" <a href="https://wiki.developer.mozilla.org/en-US/docs/MDN/Contribute/Editor/Source_mode#highlight-line-number-list"><список-номеров-строк></a> "]" - -<strong>Где:</strong> -<a id="highlight-line-number-list" name="highlight-line-number-list"><список-номеров-строк></a> = <a href="/en-US/docs/Web/CSS/Value_definition_syntax#Brackets">[</a> <a href="#highlight-line-number"><номер-строки></a> <a href="/en-US/docs/Web/CSS/Value_definition_syntax#Single_bar">|</a> <a href="#highlight-line-range"><диапазон-строк></a> <a href="/en-US/docs/Web/CSS/Value_definition_syntax#Brackets">]</a><a href="/en-US/docs/Web/CSS/Value_definition_syntax#Hash_mark">#</a> -<a id="highlight-line-range" name="highlight-line-range"><диапазон-строк></a> = <a href="#highlight-line-number"><номер-строки></a> - <a href="#highlight-line-number"><номер-строки></a> -<a id="highlight-line-number" name="highlight-line-number"><номер-строки></a> = <число-токен></pre> - -<div class="blockIndicator note"> -<p>Выделенные строки не отображаются в редакторе MDN.</p> -</div> - -<p>К примеру, если есть тег <code><pre class="brush: js;"></code>, и вы хотите выделить строки 4 и 7, то вы меняете тег: <code><pre class="brush: js; highlight[4, 7]"></code>.</p> - -<p>Давайте взглянем на более полный пример:</p> - -<div style="overflow: auto;"> -<table class="fullwidth-table"> - <thead> - <tr> - <th scope="col">До выделения</th> - <th scope="col">С выделением</th> - </tr> - </thead> - <tbody> - <tr> - <td> - <pre class="brush: js; notranslate"> -var canvas = document.getElementById("canvas"); -var ctx = canvas.getContext("2d"); - -var path1 = new Path2D(); -path1.rect(10, 10, 100, 100); - -var path2 = new Path2D(path1); -path2.moveTo(220, 60); -path2.arc(170, 60, 50, 0, 2 * Math.PI); - -ctx.stroke(path2); -</pre> - - <p>Здесь тег {{HTMLElement("pre")}} равен: <code><pre class="brush: js;"></code></p> - </td> - <td> - <pre class="brush: js; highlight[4, 7] notranslate"> -var canvas = document.getElementById("canvas"); -var ctx = canvas.getContext("2d"); - -var path1 = new Path2D(); -path1.rect(10, 10, 100, 100); - -var path2 = new Path2D(path1); -path2.moveTo(220, 60); -path2.arc(170, 60, 50, 0, 2 * Math.PI); - -ctx.stroke(path2);</pre> - - <p>А здесь тег <code><pre></code> изменён на: <code><pre class="brush: js; highlight[4, 7]"></code></p> - </td> - </tr> - </tbody> -</table> -</div> - -<h3 id="Стили_которых_нет_в_панели_инструментов">Стили, которых нет в панели инструментов</h3> - -<p>У нас есть несколько стилей, которые нельзя применить, не используя режим источника. К счастью, их редко когда используют. Например:</p> - -<ul> - <li>Некоторые особые стили, применяемые на специальных страницах, необходимо добавлять с помощью кода, например, секции с группами. Вот почему у нас есть макросы для составления компонентов целевых страниц автоматически.</li> -</ul> diff --git a/files/ru/orphaned/mdn/editor/syntax_highlighting/index.html b/files/ru/orphaned/mdn/editor/syntax_highlighting/index.html deleted file mode 100644 index 62f149e52a..0000000000 --- a/files/ru/orphaned/mdn/editor/syntax_highlighting/index.html +++ /dev/null @@ -1,182 +0,0 @@ ---- -title: Синтаксические выделения -slug: orphaned/MDN/Editor/Syntax_highlighting -tags: - - Guide - - Howto - - MDN - - MDN Meta - - Редактор - - Руководство - - выделение -translation_of: MDN/Editor/Syntax_highlighting -original_slug: MDN/Editor/Синтаксические_выделения ---- -<div>{{MDNSidebar}}</div> - -<p class="summary"><span class="seoSummary">Синтаксическое выделение кода крайне полезно в статьях. Режим синтаксического выделения также используется в нашей системе шаблонов, чтобы определять, как использовать каждый отрывок кода при сборке в готовый экземпляр.</span></p> - -<h2 id="Поддержка_синтаксических_выделений">Поддержка синтаксических выделений</h2> - -<p>MDN поддерживает все периодически используемые нами на MDN языки (так же, как и те, что используются лишь иногда):</p> - -<div class="threecolumns"> -<ul> - <li>Bash shell</li> - <li> - <p>C/C++</p> - </li> - <li> - <p>CSS</p> - </li> - <li>HTML</li> - <li>XML</li> - <li> - <p>Java</p> - </li> - <li> - <p>JavaScript</p> - </li> - <li> - <p>JSON</p> - </li> - <li> - <p>PHP</p> - </li> - <li> - <p>Python</p> - </li> - <li> - <p>SQL </p> - </li> -</ul> -</div> - -<p>Синтаксические выделения делают код удобнее в прочтении, особенно когда статья переполнена другими видами текста. Выделения также помогают выделить ошибки в примерах и отрывках кода.</p> - -<h2 id="Добавление_выделения">Добавление выделения</h2> - -<p>Как правило, следует выделять любой блок {{HTMLElement("pre")}}, который представляет код, состоящий из более чем одной строчки; выделение однострочного кода будет зависеть от контекста.</p> - -<p>Синтаксические выделения в примерах кода:</p> - -<ol> - <li> - <p>Наберите или вставьте код в статью. Например:</p> - - <p>void main(int argc, char **argv) {</p> - - <p>printf("Привет, мир!\n");</p> - - <p>}</p> - </li> - <li> - <p>Выделите текст и нажмите кнопку <strong>PRE</strong> в панели инструментов. Результат:</p> - - <pre class="notranslate">void main(int argc, char **argv) { - -printf("Hello world\n"); - -} -</pre> - </li> - <li> - <p class="brush: cpp">Нажмите кнопку <strong>Syntax Highlighter</strong> и выберите название соответствующего коду языка программирования. В нашем примере это C/C++:</p> - - <pre class="brush: cpp; notranslate">void main(int argc, char **argv) { - -printf("Hello world\n"); - -}</pre> - </li> -</ol> - -<p>Вы можете немного упростить процесс, не нажимая кнопку <strong>PRE</strong> и сразу выбрав нужный вам язык. Добавление выделения автоматически вставит необходимый блок {{HTMLElement("pre")}}, если он ещё не на месте.</p> - -<p>Далее представлен перевод раздела {{SectionOnPage("/en-US/docs/MDN/Contribute/Editor/Source_mode", "Выделение строк в режиме источника")}}:</p> - -<h3 id="Выделение_линий_в_примере">Выделение линий в примере</h3> - -<p>Блоки примеров кода устанавливаются кнопками <strong>PRE</strong> или <strong>Syntax Highlighter</strong> в <a href="https://wiki.developer.mozilla.org/ru/docs/MDN/Contribute/Editor/Basics/Toolbar#%D0%91%D0%BB%D0%BE%D0%BA%D0%B8">блоках панели инструментов</a>, но вы, возможно, захотите обратить внимание читателей на определённые строки кода. Единственный способ сделать это — открыть режим источника, найти там блок <a href="https://wiki.developer.mozilla.org/en-US/docs/Web/HTML/Element/pre" title="The HTML <pre> element represents preformatted text which is to be presented exactly as written in the HTML file."><code><pre></code></a>, содержащий код, и добавить в атрибут <code><a href="https://wiki.developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes#attr-class">class</a></code> тега <code><pre></code> компонент <code>highlight</code>, отформатированный следующим образом:</p> - -<ul> - <li> - <p><code>highlight[<em>НомерСтроки1</em>, <em>НомерСтроки2</em>, ..., <em>НомерСтрокиN</em>]</code></p> - </li> - <li> - <p><code>highlight[<em>НомерСтрокиНачальной</em>-<em>НомерСтрокиКонечной</em>, ..., <em>НомерСтрокиN</em>]</code></p> - </li> -</ul> - -<pre class="notranslate">"hightlight[" <a href="https://wiki.developer.mozilla.org/en-US/docs/MDN/Contribute/Editor/Source_mode#highlight-line-number-list"><список-номеров-строк></a> "]" - -<strong>Где:</strong> -<a id="highlight-line-number-list" name="highlight-line-number-list"><список-номеров-строк></a> = <a href="https://wiki.developer.mozilla.org/en-US/docs/Web/CSS/Value_definition_syntax#Brackets">[</a> <a href="https://wiki.developer.mozilla.org/en-US/docs/MDN/Contribute/Editor/Source_mode#highlight-line-number"><номер-строки></a> <a href="https://wiki.developer.mozilla.org/en-US/docs/Web/CSS/Value_definition_syntax#Single_bar">|</a> <a href="https://wiki.developer.mozilla.org/en-US/docs/MDN/Contribute/Editor/Source_mode#highlight-line-range"><диапазон-строк></a> <a href="https://wiki.developer.mozilla.org/en-US/docs/Web/CSS/Value_definition_syntax#Brackets">]</a><a href="https://wiki.developer.mozilla.org/en-US/docs/Web/CSS/Value_definition_syntax#Hash_mark">#</a> -<a id="highlight-line-range" name="highlight-line-range"><диапазон-строк></a> = <a href="https://wiki.developer.mozilla.org/en-US/docs/MDN/Contribute/Editor/Source_mode#highlight-line-number"><номер-строки></a> - <a href="https://wiki.developer.mozilla.org/en-US/docs/MDN/Contribute/Editor/Source_mode#highlight-line-number"><line-number></a> -<a id="highlight-line-number" name="highlight-line-number"><номер-строки></a> = <токен></pre> - -<p>К примеру, если есть тег <code><pre class="brush: js;"></code>, и вы хотите выделить строки 4 и 7, то вы меняете тег: <code><pre class="brush: js; highlight[4, 7]"></code>.</p> - -<p>Давайте взглянем на более полный пример:</p> - -<div style="overflow: auto;"> -<table class="fullwidth-table"> - <thead> - <tr> - <th scope="col">До выделения</th> - <th scope="col">С выделением</th> - </tr> - </thead> - <tbody> - <tr> - <td> - <pre class="brush: js; notranslate"> -var canvas = document.getElementById("canvas"); -var ctx = canvas.getContext("2d"); - -var path1 = new Path2D(); -path1.rect(10, 10, 100, 100); - -var path2 = new Path2D(path1); -path2.moveTo(220, 60); -path2.arc(170, 60, 50, 0, 2 * Math.PI); - -ctx.stroke(path2); -</pre> - - <p>Здесь тег {{HTMLElement("pre")}} равен: <code><pre class="brush: js;"></code></p> - </td> - <td> - <pre class="brush: js; highlight[4, 7] notranslate"> -var canvas = document.getElementById("canvas"); -var ctx = canvas.getContext("2d"); - -var path1 = new Path2D(); -path1.rect(10, 10, 100, 100); - -var path2 = new Path2D(path1); -path2.moveTo(220, 60); -path2.arc(170, 60, 50, 0, 2 * Math.PI); - -ctx.stroke(path2);</pre> - - <p>А здесь тег <code><pre></code> был изменён на: <code><pre class="brush: js; highlight[4, 7]"></code></p> - </td> - </tr> - </tbody> -</table> -</div> - -<div class="blockIndicator note"> -<p>Выделенные строки не отображаются в редакторе MDN.</p> -</div> - -<h2 id="Смотрите_также">Смотрите также</h2> - -<ul> - <li><a href="/ru/docs/MDN/Contribute/Structures/Live_samples">Шаблоны</a></li> - <li><a href="/ru/docs/MDN/Contribute/Editor">Руководство по MDN редактору</a></li> - <li><a href="/ru/docs/MDN/Getting_started">Mozilla - Быстрый старт!</a></li> -</ul> - -<div>{{EditorGuideQuicklinks}}</div> diff --git a/files/ru/orphaned/mdn/editor/tables/index.html b/files/ru/orphaned/mdn/editor/tables/index.html deleted file mode 100644 index 23de7cacb8..0000000000 --- a/files/ru/orphaned/mdn/editor/tables/index.html +++ /dev/null @@ -1,163 +0,0 @@ ---- -title: Таблицы -slug: orphaned/MDN/Editor/Tables -tags: - - Guide - - MDN - - MDN Meta - - Редактор - - Руководство -translation_of: MDN/Editor/Tables -original_slug: MDN/Editor/Tables ---- -<div>{{MDNSidebar}}</div> - -<p><span class="seoSummary">Таблицы полезны для представления информации; в этой статье описано, как создавать и обслуживать таблицы на MDN и когда стоит и не стоит использовать их.</span></p> - -<p>В MDN, в основном, мы используем таблицы для представления перечня информации из более чем двух участков информации, приходящихся на один пункт. Если вы создаёте лист из названия элементов и их значений, то лучше создать список описаний вместо таблицы; это потому что мы стараемся по возможности реже использовать таблицы из двух колонок, так как возникают трудности их отображения при чтении на мобильных устройствах.</p> - -<p>Пожалуйста, прочтите <a href="https://developer.mozilla.org/ru/docs/Project:Writer's_guide">Руководство по оформлению материалов MDN</a>, чтобы лучше узнать об использовании таблиц и их правильном оформлении; всё же давайте посмотрим, как вставлять и редактировать таблицы.</p> - -<h2 id="Создание_таблицы">Создание таблицы</h2> - -<p>Чтобы вставить таблицу, нажмите кнопку <strong>Таблица</strong> на панели инструментов, которая выглядит так: <img alt="as of Aug-2017" src="https://mdn.mozillademos.org/files/15297/table%20icon.png" style="height: 14px; width: 15px;"></p> - -<p>Откроется окно <strong>Свойства таблицы</strong>:</p> - -<p><img alt='Скриншот окна "Свойства таблицы"' src="https://mdn.mozillademos.org/files/17047/Table_properties_dialog_box_-_ru.JPG" style="border-style: solid; border-width: 1px; height: 402px; width: 332px;"></p> - -<p>В окне две вкладки: <strong>Свойства таблицы</strong> и <strong>Дополнительно</strong>.</p> - -<h3 id="Вкладка_Свойства_таблицы">Вкладка <strong>Свойства таблицы</strong></h3> - -<p>В этой вкладке вы будете выполнять бо́льшую часть настроек, потому что во вкладке <strong>Дополнительно</strong> гораздо меньше настроек, которые мы рекомендуем использовать. Опции:</p> - -<dl> - <dt>Строки</dt> - <dd>Число строк в вашей таблице. Вы также можете добавить строки непосредственно в редакторе, но так будет быстрее.</dd> - <dt>Колонки</dt> - <dd>Число колонок в таблице.</dd> - <dt>Заголовки</dt> - <dd>Позволяет вам обозначить заголовки, если это необходимо. По умолчанию в таблице нет заголовков; однако мы предпочитаем использовать заголовки, поэтому советуем вам использовать их в большинстве случаев. Возможные значения: <strong>Без заголовков</strong>, <strong>Первая строка</strong>, <strong>Левая колонка</strong> и <strong>Сверху и слева</strong>.</dd> - <dt>Выравнивание</dt> - <dd>Позволяет выравнивать таблицу в левой, правой или центральной части страницы. <strong>Пожалуйста, не используйте эту опцию.</strong> В нашем руководстве по оформлению указано, что таблицы всегда должны находиться слева. (Из этого правила есть исключения.)</dd> - <dt>Заголовок</dt> - <dd>Вы можете выбрать заголовок к таблице; однако мы редко делаем это в MDN, поэтому лучше не использовать эту опцию.</dd> - <dt>Итоги</dt> - <dd>Просто пропустите этот пункт, потому что рядом с таблицей вам придётся писать объяснение.</dd> -</dl> - -<h3 id="Вкладка_Дополнительно">Вкладка <strong>Дополнительно</strong></h3> - -<p>Вкладка <strong>Дополнительно</strong> предоставляет несколько возможностей, большую часть которых мы не используем на MDN и в будущем уберём.</p> - -<p><img alt='Скриншот вкладки "Дополнительно"' src="https://mdn.mozillademos.org/files/17048/Table_proprties_Advanced_tab_-_ru.JPG" style="border-style: solid; border-width: 1px; height: 405px; width: 334px;"></p> - -<p>Как видите, тут немного опций:</p> - -<dl> - <dt>Идентификатор</dt> - <dd>Идентификатор (<code>id</code>) элемента {{HTMLElement("table")}}. Мы в принципе не используем идентификаторы в таблицах на MDN.</dd> - <dt>Направление текста</dt> - <dd>Позволяет настроить направление текста в таблице. Используется только при локализации контента.</dd> - <dt>Стиль</dt> - <dd>В этом поле вы можете применить собственный стиль CSS к таблице. <strong>Вообще не используйте это поле! В таком случае мы просто удалим вашу таблицу. </strong>Мы стараемся избавляться от пользовательских стилей там, где применяются наши.</dd> - <dt>CSS классы</dt> - <dd>Добавляет класс к стилю таблицы. Значение всегда должно быть <em>standard-table</em>, являющееся нашим стандартным классом для таблиц.</dd> -</dl> - -<p>Как только вы завершите настройку, нажмите кнопку <strong>OK</strong> для создания таблицы.</p> - -<h2 id="Обслуживание_таблиц">Обслуживание таблиц</h2> - -<p>Работа с таблицей очень похожа на работу в любом редакторе таблиц — надо просто заполнить ячейки. Клавиша <kbd>Tab</kbd> переместит вас на следующую ячейку таблицы или создаст новую строку, если следующей клетки нет.</p> - -<p><span style="">Кликните правой кнопкой мыши по таблице, чтобы появился ряд опций для регулировки самих ячеек, строчек и колонок таблицы, а также самой таблицы:</span></p> - -<p><img alt="Скриншот контекстного меню" src="https://mdn.mozillademos.org/files/17049/Table_context_menu_-_ru.jpg" style="border-style: solid; border-width: 1px; height: 199px; width: 166px;"></p> - -<dl> - <dt>Вставить</dt> - <dd>В браузерах поддерживается вставка через скрипт (в некоторых браузерах, в том числе в Firefox, это не поддерживается из соображений безопасности). Эта опция вставляет содержимое буфера обмена в текущую ячейку таблицы.</dd> - <dt>Ячейка</dt> - <dd>Открывает подменю для работы с ячейками.</dd> - <dt>Строка</dt> - <dd>Открывает подменю для работы со строками.</dd> - <dt>Колонка</dt> - <dd>Открывает подменю для работы с колонками.</dd> - <dt>Удалить таблицу</dt> - <dd>Удаляет текущую таблицу.</dd> - <dt>Сортировка (Sort Table)</dt> - <dd>Открывает диалоговое окно для сортировки данных в таблице.</dd> - <dt>Свойства таблицы</dt> - <dd>Открывает то же окно для создания таблицы.</dd> -</dl> - -<h3 id="Подменю_Ячейка">Подменю <strong>Ячейка</strong></h3> - -<p>Подменю предоставляет опции для манипуляций с ячейками вашей таблицы, и оно выглядит так:</p> - -<p><img alt='Скриншот подменю "Ячейка" в контекстном меню' src="https://mdn.mozillademos.org/files/17050/Table_context_menu_-_cell_submenu_-_ru.jpg" style="border-style: solid; border-width: 1px; height: 252px; width: 378px;"></p> - -<p>Названия опций говорят сами за себя, но стоит оговориться, что <strong>Объединить ячейки</strong> доступно, только если вы выбрали несколько ячеек. Опции <strong>Объединить с правой</strong> и <strong>Объединить с нижней</strong> объединяют текущую ячейку с той, что находится справа или снизу соответственно.</p> - -<h3 id="Окно_Свойства_ячейки">Окно <strong>Свойства ячейки</strong></h3> - -<p>Опция <strong>Свойства ячейки</strong> открывает диалоговое окно для детальной настройки ячейки. Окно выглядит вот так:</p> - -<p><img alt='Скриншот окна "Свойства ячейки"' src="https://mdn.mozillademos.org/files/17051/Cell_Properties_dialog_box_-_ru.JPG" style="border-style: solid; border-width: 1px; height: 333px; width: 432px;"></p> - -<p>Опции:</p> - -<dl> - <dt>Ширина</dt> - <dd>Изменяет ширину клетки; вы можете выбрать единицу изменения в выпадающем меню рядом. <strong>Пожалуйста, не используете эту опцию.</strong> Вам не понадобится изменять ширину клетки, за исключением случаев, когда надо вставить изображение или пример кода в таблицу.</dd> - <dt>Высота</dt> - <dd>Устанавливает высоту клетки (всегда в пикселах). <strong>Пожалуйста, не используете эту опцию.</strong> Высота клетки определяется автоматически.</dd> - <dt>Перенос по словам</dt> - <dd>Определяет, будет переноситься содержимое ячейки или нет. Всегда должно быть установлено значение по умолчанию, <em>Да</em>.</dd> - <dt>Горизонтальное выравнивание</dt> - <dd>Позволяет устанавливать выравнивание текста по горизонтали. Следует всегда оставлять значение по умолчанию, <em>По левому краю</em>.</dd> - <dt>Вертикальное выравнивание</dt> - <dd>Позволяет устанавливать выравнивание текста по вертикали.</dd> - <dt>Тип ячейки</dt> - <dd>Позволяет вам определить, какой тип у ячейки — <em>Заголовок</em> или <em>Данные</em>. Если установлено значение <em>Заголовок</em>, то будет применена соответствующая стилизация.</dd> - <dt>Объединяет строк</dt> - <dd>Позволяет определить, сколько строк необходимо объединить. Используется редко, но в некоторых таблицах очень полезно.</dd> - <dt>Объединяет колонок</dt> - <dd>Определяет, сколько колонок необходимо объединить.</dd> - <dt>Цвет фона</dt> - <dd>Определяет цвет фона ячейки. Старайтесь не использовать эту функцию; редкие случаи, когда смена цвета ячейки приемлема, прописаны в классах CSS.</dd> - <dt>Цвет границ</dt> - <dd>Определяет цвет границы ячейки. Старайтесь не использовать эту функцию; редкие случаи, когда смена цвета границы ячейки приемлема, прописаны в классах CSS.</dd> -</dl> - -<h3 id="Подменю_Строка">Подменю <strong>Строка</strong></h3> - -<p>Подменю <strong>Строка</strong> предоставляет опции, используя которые вы можете корректировать строки:</p> - -<p><img alt='Скриншот подменю "Строка" в контекстном меню' src="https://mdn.mozillademos.org/files/17052/Table_context_menu_-_row_submenu_-_ru.jpg" style="border-style: solid; border-width: 1px; height: 181px; width: 326px;"></p> - -<p>Опции подменю по порядку:</p> - -<ul> - <li><strong>Вставить строку сверху</strong> добавляет новую строку перед той, в которой находится курсор</li> - <li><strong>Вставить строку снизу</strong> добавляет строку ниже текущей</li> - <li><strong>Удалить строки</strong> удаляет текущую строку или выделенные строки</li> -</ul> - -<h3 id="Подменю_Колонка">Подменю <strong>Колонка</strong></h3> - -<p>Подменю позволяет вам изменять колонки в вашей таблице:</p> - -<p><img alt='Скриншот подменю "Колонка" в контекстном меню' src="https://mdn.mozillademos.org/files/17053/Table_context_menu_-_column_submenu_-_ru.jpg" style="border-style: solid; border-width: 1px; height: 180px; width: 333px;"></p> - -<p>Опции похожи на опции подменю <strong>Строка</strong>:</p> - -<ul> - <li><strong>Вставить колонку слева</strong> вставляет новую колонку слева</li> - <li><strong>Вставить колонку справа</strong> вставляет новую колонку справа</li> - <li><strong>Удалить колонки</strong> удаляет текущую колонку или выделенные колонки</li> -</ul> - -<p>{{EditorGuideQuicklinks}}</p> diff --git a/files/ru/orphaned/mdn/structures/live_samples/simple_live_sample_demo/index.html b/files/ru/orphaned/mdn/structures/live_samples/simple_live_sample_demo/index.html deleted file mode 100644 index c16264ed11..0000000000 --- a/files/ru/orphaned/mdn/structures/live_samples/simple_live_sample_demo/index.html +++ /dev/null @@ -1,38 +0,0 @@ ---- -title: A simple demo of a live code sample -slug: orphaned/MDN/Structures/Live_samples/Simple_live_sample_demo -tags: - - MDN Meta - - Конструкции - - Пример -translation_of: MDN/Structures/Live_samples/Simple_live_sample_demo -original_slug: MDN/Structures/Live_samples/Simple_live_sample_demo ---- -<div>{{MDNSidebar}}</div> - -<h2 id="Пример">Пример</h2> - -<p id="Simple_example_of_a_live_demo">Это очень простой пример показывающий вам, как сделать живой образец на MDN. Для большей информации смотрите <a href="/en-US/docs/MDN/Contribute/Structures/Live_samples">Live samples</a>.</p> - -<pre class="brush: html notranslate"><form> - <label>Try me<input type="text" name="name"></label> - <input type="submit" value="go"> -</form></pre> - -<pre class="brush: css notranslate">form { - border-radius: 10px; - background: powderblue; -}</pre> - -<pre class="brush: js notranslate">var f = document.querySelector('form'); - -f.addEventListener('submit', function(ev) { - ev.preventDefault(); - document.querySelectorAll('input')[1].value = 'sending'; -}, false);</pre> - -<p>{{ EmbedLiveSample('Пример', '', '', '') }}</p> - -<div class="blockIndicator note"> -<p>Примечание: На локализованных страницах значение первого параметра должно совпадать с ID заголовка в котором находится пример.</p> -</div> diff --git a/files/ru/orphaned/mdn/tools/feeds/index.html b/files/ru/orphaned/mdn/tools/feeds/index.html deleted file mode 100644 index 130548d70c..0000000000 --- a/files/ru/orphaned/mdn/tools/feeds/index.html +++ /dev/null @@ -1,74 +0,0 @@ ---- -title: Ленты новостей MDN -slug: orphaned/MDN/Tools/Feeds -tags: - - Kuma -translation_of: MDN/Tools/Feeds -original_slug: MDN/User_guide/Feeds ---- -<div>{{MDNSidebar}}</div><p>Вики MDN предлагает ряд лент новостей, которые вы можете использовать для слежения за сайтом. В будущем их, вероятно, будет больше, а некоторые из них до сих пор ещё в разработке, но эта информация всё равно может быть для вас полезна.</p> - -<h2 id="Accessing_the_feeds" name="Accessing_the_feeds">Получение доступа к лентам новостей</h2> -<p>Все ленты новостей начинаются со следующего базового URL:</p> -<pre>https://developer.mozilla.org/<em><локаль></em>/docs/feeds/<em><формат></em>/</pre> -<p>Заполнители в базовом URL могут быть заменены следующими значениями:</p> -<ul> - <li><code><локаль></code> — это одна из стандартных строк локалей, например, "en-US", "ja" и так далее. В ленту новостей включаются записи только для статей в указанной локали, если вы не добавите в URL параметр <code>?all_locales</code>.</li> - <li><code><формат></code> — это одна из строк <code>rss</code>, <code>atom</code> или <code>json</code></li> -</ul> -<p>Если вы используете формат <code>json</code>, вы также можете определить дополнительный параметр запроса <code>?callback=<em><имя колбэк-функции></em></code>, который следует <a href="https://ru.wikipedia.org/wiki/JSONP">соглашению JSONP</a> для загрузки данных как JavaScript.</p> - -<h2 id="Available_feeds" name="Available_feeds">Доступные ленты</h2> -<table class="standard-table"> - <tbody> - <tr> - <th>Лента</th> - <th>Описание</th> - </tr> - <tr> - <td><code>all</code></td> - <td> - <p>Все недавно изменённые статьи, упорядоченные по дате изменения. Также она включает в себя новые статьи. Все изменения объединяются в одну запись в ленте новостей для каждой статьи. Например:</p> - <p><a href="/ru/docs/feeds/rss/all">https://developer.mozilla.org/ru/docs/feeds/rss/all</a></p> - </td> - </tr> - <tr> - <td><code>revisions</code></td> - <td> - <p>Все ревизии статей, упорядоченные по дате изменения, включая новые статьи. Каждая ревизия занимает отдельную запись в ленте. Например:</p> - <p><a href="/ru/docs/feeds/atom/revisions">https://developer.mozilla.org/ru/docs/feeds/atom/revisions</a></p> - </td> - </tr> - <tr> - <td><code>tag/<em><имя-метки></em></code></td> - <td> - <p>Недавно изменённые статьи, упорядоченные по дате изменения. В ленту включаются только статьи с определённой меткой. Например:</p> - <p><a href="/ru/docs/feeds/json/tag/CSS?callback=loadFeed">https://developer.mozilla.org/ru/docs/feeds/json/tag/CSS?callback=loadFeed</a></p> - </td> - </tr> - <tr> - <td><code>files</code></td> - <td> - <p>Недавно изменённые или загруженные файлы. Например:</p> - <p><a href="/ru/docs/feeds/atom/files">https://developer.mozilla.org/ru/docs/feeds/atom/files</a></p> - </td> - </tr> - <tr> - <td><code>l10n-updates</code></td> - <td> - <p>Переводные статьи, чей оригинал был изменён с последнего редактирования этой статьи. Например:</p> - <p><a href="/ru/docs/feeds/atom/l10n-updates">https://developer.mozilla.org/ru/docs/feeds/atom/l10n-updates</a></p> - </td> - </tr> - <tr> - <td><nobr><code>needs-review[/<em><тип-проверки></em>]</code></nobr></td> - <td> - <p>Список статей, требующих определённой проверки, либо статьи, требующие любой проверки, если тип проверки не указан. Тип проверки может быть одним из <code>technical</code>, <code>editorial</code> или <code>kumascript</code>.</p> - <p><a href="/ru/docs/feeds/json/needs-review">https://developer.mozilla.org/ru/docs/feeds/json/needs-review</a></p> - <p><a href="/ru/docs/feeds/rss/needs-review/technical">https://developer.mozilla.org/ru/docs/feeds/rss/needs-review/technical</a></p> - <p><a href="/ru/docs/feeds/atom/needs-review/editorial">https://developer.mozilla.org/ru/docs/feeds/atom/needs-review/editorial</a></p> - <p><a href="/ru/docs/feeds/atom/needs-review/kumascript">https://developer.mozilla.org/ru/docs/feeds/atom/needs-review/kumascript</a></p> - </td> - </tr> - </tbody> -</table> diff --git a/files/ru/orphaned/mdn/tools/page_deletion/index.html b/files/ru/orphaned/mdn/tools/page_deletion/index.html deleted file mode 100644 index ee44aa31f1..0000000000 --- a/files/ru/orphaned/mdn/tools/page_deletion/index.html +++ /dev/null @@ -1,17 +0,0 @@ ---- -title: Удаление страниц -slug: orphaned/MDN/Tools/Page_deletion -tags: - - Guide - - MDN -translation_of: MDN/Tools/Page_deletion -original_slug: MDN/User_guide/Deleting_pages ---- -<div>{{MDNSidebar}}</div><p>Только администраторы MDN имеют право и могут удалять страницы. <span class="seoSummary">Эта статья описывает, как отправить запрос на удаление страницы с MDN.</span></p> -<p>Чтобы организовать удаление страницы, вы должны сделать следующее:</p> -<ol> - <li><strong>Не очищайте и не изменяйте содержимое страницы.</strong> Мы хотим видеть эту страницу во время удаления.</li> - <li>Добавьте метку «junk» к странице. Не удаляйте другие метки.</li> - <li>Если страница особенно срочно нуждается в удалении (например, её содержимое неуместно, оскорбительно или технически опасно), <a href="mailto:mdn-admins@mozilla.org" title="Уведомить администратора">уведомите администратора MDN</a>.</li> -</ol> -<p>Администратор удалит страницу, когда это будет возможно, после того как убедится, что это удаление целесообразно.</p> diff --git a/files/ru/orphaned/mdn/tools/page_watching/index.html b/files/ru/orphaned/mdn/tools/page_watching/index.html deleted file mode 100644 index 4c75e0f72b..0000000000 --- a/files/ru/orphaned/mdn/tools/page_watching/index.html +++ /dev/null @@ -1,51 +0,0 @@ ---- -title: Подписка на страницы -slug: orphaned/MDN/Tools/Page_watching -tags: - - MDN Meta - - Подписка - - Руководство - - Страница уровня - - инструменты -translation_of: MDN/Tools/Page_watching -original_slug: MDN/Tools/Page_watching ---- -<div>{{MDNSidebar}}</div><p>Ok</p> - -<p class="seoSummary">Подписка на страницу в MDN позволяет вам получать уведомление по электронной почте всякий раз, когда она обновляется или изменяется. Кнопка «Смотреть» <kbd>{{FontAwesomeIcon("icon-eye")}}</kbd> расположена в верхнем правом углу каждой страницы MDN. Чтобы получить доступ к параметрам подписки, наведите курсор на кнопку «Смотреть», чтобы открыть меню «Смотреть»: </p> - -<p><img alt="Screenshot of MDN Watch menu" src="https://mdn.mozillademos.org/files/12551/MDN_-_Watch_Menu.png" style="height: 298px; width: 463px;"></p> - -<p>Выберите вариант просмотра только одной страницы или этой страницы и её подстраниц.</p> - -<h2 id="Подписаться_на_страницу">Подписаться на страницу</h2> - -<p>Нажмите первый вариант <em>«Подписаться на название страницы»</em>, чтобы получать уведомление по электронной почте каждый раз, когда пользователь редактирует только одну страницу.</p> - -<h2 id="Подпишитесь_на_страницу_и_все_её_подзаголовки">Подпишитесь на страницу и все её подзаголовки</h2> - -<p>Нажмите второй вариант <em>«Подписаться на название страницы и все её под-статьи»</em>, чтобы получать уведомление по электронной почте каждый раз, когда пользователь редактирует эту страницу, а также любую её подстраницу. Это включает в себя дополнительные страницы, добавленные после того, как вы запросили подписку, поэтому, если в будущем будет создано больше подстраниц, вы также получите уведомления для них.</p> - -<h2 id="Отменить_подписку_на_страницу">Отменить подписку на страницу</h2> - -<p>Чтобы отказаться от подписки и прекратить просмотр страницы, откройте меню «Смотреть» ещё раз и нажмите <em>«Отменить подписку на название страницы»</em>. Если вы подписаны на страницу, вы увидите только <em>«Отказаться от названия страницы»</em>. Вы больше не будете получать электронное письмо при каждом изменении страницы.</p> - -<h2 id="Электронные_письма_с_изменением_страницы">Электронные письма с изменением страницы</h2> - -<p>Если вы подписаны на страницу, каждый раз при сохранении изменений вы получите электронное письмо. Эти письма поступают с notifications@developer.mozilla.org и отправляются на адрес электронной почты, зарегистрированный на вашей учётной записи MDN. Каждое сообщение имеет заголовок формы:</p> - -<pre class="notranslate">[MDN] Page "<em>Page title</em>" changed by <em>username</em></pre> - -<p>Сообщение начинается с повторения информации в заголовке, а затем представляет стандартный разброс содержимого, показывающий точно, что изменилось. Изменения отображаются как исходный HTML-код, который может быть немного странным для чтения, если вы не используете его в контексте MDN.</p> - -<p>Ниже diff есть список полезных ссылок, которые вы можете использовать для изменения, включая:</p> - -<ul> - <li>Просмотр профиля MDN пользователя, внёсшего изменения</li> - <li>Сравнение предыдущих и новых версий страницы с использованием функции истории событий на MDN</li> - <li>Просмотр статьи в своём браузере</li> - <li>Редактирование статьи</li> - <li>Просмотр истории статьи</li> -</ul> - -<p>В нижней части письма есть уведомление о том, какая подписка сгенерировала электронное письмо, например «Вы подписаны на изменения: ссылка на элемент HTML и все его подтемы», а также ссылку на отмену подписки. Если вы нажмёте ссылку, чтобы отказаться от подписки, вы больше не будете получать сообщения для этого запроса на просмотр.</p> diff --git a/files/ru/orphaned/mdn/tools/search/index.html b/files/ru/orphaned/mdn/tools/search/index.html deleted file mode 100644 index 239ba0dcc9..0000000000 --- a/files/ru/orphaned/mdn/tools/search/index.html +++ /dev/null @@ -1,105 +0,0 @@ ---- -title: Использование продвинутого поиска -slug: orphaned/MDN/Tools/Search -tags: - - Guide - - MDN -translation_of: MDN/Tools/Search -original_slug: MDN/Tools/Search ---- -<div>{{MDNSidebar}}</div><p><span class="seoSummary">В качестве дополнительной возможности внесения для вкладчиков в MDN у нас есть продвинутый механизм поиска, который позволяется вам искать по исходному коду страницы — то есть, по сырому HTML сайта, с макросами вместо их вывода — что позволяет искать использования определённых макросов, атрибутов HTML и тому подобное.</span></p> -<p>На текущий момент для использования продвинутого механизма поиска нет пользовательского интерфейса, но вы можете получить к нему доступ посредством специально сформированных URL. Вы можете получить вывод либо на стандартную страницу с результатами поиска по MDN, либо в формате JSON (последнее означает, что вы можете использовать этот механизм, например, из кода на KumaScript). <span class="seoSummary">Эта статья описывает, как всем этим пользоваться.</span></p> -<div class="note"> - <p><strong>Примечание:</strong> эти поисковые запросы не предназначены для конструирования распространяемых URL; а предназначены для использования во вспомогательных инструментах и утилитах. В будущем они могут измениться, также не обязательно, что эти запросы самые эффективные.</p> -</div> - -<h2 id="Search_query_format" name="Search_query_format">Формат поискового запроса</h2> -<p>Продвинутые поисковые запросы позволяются конструировать URL с соответствующими параметрами. Базовый URL может быть одним из следующих:</p> -<dl> - <dt><code>https://developer.mozilla.org/en-US/search</code></dt> - <dd>Используйте этот базовый URL для получения стандартной страницы с результатами поиска по MDN.</dd> - <dt><code>https://developer.mozilla.org/en-US/search.json</code></dt> - <dd>Используйте этот базовый URL для получения результатов в формате JSON. О формате результата смотрите раздел {{anch("JSON_result_format", "формат JSON для результата")}}.</dd> -</dl> -<p>Кроме того, вам нужно добавить соответствующие параметры для получения желаемого результата. Вы можете использовать любую комбинацию следующих параметров:</p> -<dl> - <dt><code>locale=</code></dt> - <dd>Рассматриваемая локаль. По умолчанию рассматриваются все локали. Также вы можете явно указать «все локали» при помощи шаблона <code>"*"</code>. Например, вы можете определить <code>locale=en-US</code> для ограничения поиска только по англоязычным страницам.</dd> - <dt><code>css_classnames=</code></dt> - <dd>Классы CSS для сопоставления. Этот параметр ограничивает результат поиска страницами, чей HTML-код включает в себя как минимум одно использование указанных классов.</dd> - <dt><code>html_attributes=</code></dt> - <dd>Текст атрибутов HTML для сопоставления. Поиск ведётся по началу текста; то есть, если указанный текст появляется в начале строки атрибута HTML, он будет считаться совпавшим. Подробности смотрите ниже.</dd> - <dt><code>kumascript_macros=</code></dt> - <dd>Список искомых макросов KumaScript. Этот параметр позволяет вам находить статьи, использующие определённый макрос; это может быть полезно в тех случаях, если, к примеру, макрос устарел или его параметры поменялись и вам нужно обновить существующие варианты его использования.</dd> -</dl> - -<h2 id="Examples" name="Examples">Примеры</h2> -<p>Здесь приведено несколько примеров поисковых запросов.</p> - -<h3 id="Searching_by_locale" name="Searching_by_locale">Поиск по локали</h3> -<pre>https://developer.mozilla.org/en-US/search?locale=en-US</pre> -<p>В этом примере возвращается список всех англоязычных статей без каких-либо иных ограничений. На момент написания этой статьи их было 12865 (к тому времени, как вы прочитаете эту статью, их, конечно же, станет больше, поскольку мы постоянно растём)!</p> - -<h3 id="Searching_by_CSS_class_name" name="Searching_by_CSS_class_name">Поиск по имени CSS-класса</h3> -<pre>https://developer.mozilla.org/en-US/search?locale=en-US&css_classnames=smaller</pre> -<p>В этом примере мы добавили к поисковому условию использование CSS-класса <code>"smaller"</code>; на момент написания этой статьи количество результатов снизилось всего до 6 страниц.</p> - -<h3 id="Searching_by_HTML_attribute_string" name="Searching_by_HTML_attribute_string">Поиск по строке атрибута HTML</h3> -<pre>https://developer.mozilla.org/en-US/search?locale=en-US&html_attributes=style</pre> -<p>Здесь мы ищем использования атрибута <code>"style"</code> на элементах HTML. На момент написания этой статьи мы нашли 4935 таких страниц. Это плохо и это нужно искоренять; мы собираемся заменить все такие вхождения на наши стандартные классы.</p> -<p>Также вы можете включать в поисковый запрос значение атрибута, но помните, что если вы захотите включить символы вроде <code>"="</code> или <code>"/"</code> в ваш поисковый запрос, вы должны их закодировать для использования в URL. Например, чтобы найти страницы, ссылающиеся на www.mozilla.org, вы можете сделать так:</p> -<pre>https://developer.mozilla.org/en-US/search?locale=en-US&html_attributes=href%3D%22https%3A%2F%2Fwww.mozilla.org</pre> -<p>Этот поиск вернул 29 результатов. Это удивительно малое количество ссылок на сайт www.mozilla.org!</p> - -<h3 id="Searching_for_KumaScript_macro_usage" name="Searching_for_KumaScript_macro_usage">Поиск по используемому макросу KumaScript</h3> -<pre>https://developer.mozilla.org/en-US/search?locale=en-US&kumascript_macros=unimplemented_header</pre> -<p>Этот поисковый запрос ищет использования макроса {{TemplateLink("unimplemented_header")}}. На момент написания этой статьи было найдено шесть страниц. Он позволяет нам искать макросы, чьи параметры были изменены, либо те, которые мы хотим прекратить использовать (последний случай как раз относится к рассматриваемому макросу).</p> - -<h2 id="JSON_result_format" name="JSON_result_format">Формат JSON для результата</h2> -<p>Когда вы запрашиваете результат в формате JSON, вы по прежнему получаете результаты по одной странице за раз. Каждая страница является объектом KumaScript, который состоит из нескольких частей с метаданными о результатах, плюс массив стандартных объектов страницы с одним дополнительным полем: URL-адресом для начала редактирования страницы.</p> -<p>В результирующем объекте содержатся следующие данные:</p> -<dl> - <dt><code>count</code></dt> - <dd>Общее количество найденных результатов.</dd> - <dt><code>next</code></dt> - <dd>URL, по которому можно перейти на следующую страницу с результатами (либо {{jsxref("Global_Objects/null", "null")}} для последней страницы).</dd> - <dt><code>previous</code></dt> - <dd>URL, по которому можно перейти на предыдущую страницу с результатами (либо {{jsxref("Global_Objects/null", "null")}} для первой страницы).</dd> - <dt><code>query</code></dt> - <dd>???</dd> - <dt><code>page</code></dt> - <dd>Номер страницы с результатами, описываемой этим объектом.</dd> - <dt><code>pages</code></dt> - <dd>Общее количество страниц с результатами.</dd> - <dt><code>start</code></dt> - <dd>Номер первого элемента на этой странице с результатами.</dd> - <dt><code>end</code></dt> - <dd>Номер последнего элемента на этой странице с результатами.</dd> - <dt><code>filters</code></dt> - <dd>Массив конфигураций различных поисковых фильтров. Эти фильтры доступны в стандартном поиске.</dd> - <dt><code>documents</code></dt> - <dd>Массив {{anch("Page_objects", "объектов страницы")}}, описывающих каждую совпавшую страницу.</dd> -</dl> - -<h3 id="Page_objects" name="Page_objects">Объекты страницы</h3> -<p>Каждый объект страницы содержит следующие поля:</p> -<dl> - <dt><code>title</code></dt> - <dd>Заголовок статьи.</dd> - <dt><code>slug</code></dt> - <dd>Идентификатор статьи. Это вся часть URL страницы, следующая за локалью и последующим символом слеша.</dd> - <dt><code>locale</code></dt> - <dd>Локаль страницы.</dd> - <dt><code>excerpt</code></dt> - <dd>Фрагмент содержания страницы; это либо первый блок обычного текста статьи, либо содержимое, отмеченное классом "SEO Summary".</dd> - <dt><code>url</code></dt> - <dd>Полный URL страницы.</dd> - <dt><code>edit_url</code></dt> - <dd>Полный URL страницы в режиме редактирования.</dd> - <dt><code>tags</code></dt> - <dd>Массив меток страницы.</dd> - <dt><code>score</code></dt> - <dd>Значение очков, присвоенное странице поисковым движком.</dd> - <dt><code>explanation</code></dt> - <dd>Различная информация от поискового движка о том, почему страница соответствует вашему запросу. Описание этого содержимого выходит за рамки данного документа.</dd> -</dl> diff --git a/files/ru/orphaned/mozilla/add-ons/webextensions/debugging/index.html b/files/ru/orphaned/mozilla/add-ons/webextensions/debugging/index.html deleted file mode 100644 index 7e520f3a84..0000000000 --- a/files/ru/orphaned/mozilla/add-ons/webextensions/debugging/index.html +++ /dev/null @@ -1,219 +0,0 @@ ---- -title: Отладка -slug: orphaned/Mozilla/Add-ons/WebExtensions/Debugging -tags: - - Firefox - - Mozilla - - Отладка - - Пособие - - Предоставление Веб-страниц -translation_of: Mozilla/Add-ons/WebExtensions/Debugging -original_slug: Mozilla/Add-ons/WebExtensions/Перевод ---- -<div>{{AddonSidebar}}</div> - -<div>This article explains how you can use the Firefox developer tools to debug extensions built with WebExtension APIs.</div> - -<p>An extension can consist of various different pieces — background scripts, popups, options pages, content scripts, sidebars — and you'll need to use a slightly different workflow to debug each piece. So each piece gets a top-level section in this article, and the intention is that these sections can be read in isolation. We'll begin by introducing the Add-on Debugger, which you'll use to debug most of the pieces of your extension.</p> - -<ul> -</ul> - -<h2 id="The_Add-on_Debugger">The Add-on Debugger</h2> - -<p>For most of this article we'll use the Add-on Debugger. To open the Add-on Debugger:</p> - -<ul> - <li>open Firefox</li> - <li>enter "about:debugging" in the URL bar</li> - <li>check the box labelled "Enable add-on debugging"</li> - <li>click the "Debug" button next to your extension</li> - <li>click "OK" in the warning dialog.</li> -</ul> - -<p>You'll then see a new window open. The main Firefox window will be switched into the foreground, so you'll have to click on the new window to bring it in front.</p> - -<p>{{EmbedYouTube("G2a65ewjfj0")}}</p> - -<p>This new window is sometimes called a "toolbox" and contains the debugging tools we'll use. It has a tabbed interface: the row of tabs along the top lets you switch between the different tools:</p> - -<p><img alt="" src="https://mdn.mozillademos.org/files/16309/add-on-debugger.png" style="display: block; height: 472px; margin-left: auto; margin-right: auto; width: 922px;"></p> - -<p>In this article we'll use three debugging tools:</p> - -<ul> - <li><a href="/en-US/docs/Tools/Web_Console">The Console</a>: this displays messages logged by the extension as well as error messages logged by the browser as it runs the extension. It also provides a command line enabling you to execute JavaScript in the extension's context.</li> - <li><a href="/en-US/docs/Tools/Debugger">The Debugger</a>: this enables you to set breakpoints and watchpoints in your extension's JavaScript, and examine and modify its internal state.</li> - <li><a href="/en-US/docs/Tools/Page_Inspector">The Inspector</a>: this enables you to examine and modify the HTML and CSS used to build your extension's pages.</li> -</ul> - -<h2 id="Debugging_background_scripts">Debugging background scripts</h2> - -<div class="note"> -<p>The examples in this section use the "notify-link-clicks-l10n" example extension. If you'd like to play along, you can find this example in the <a href="https://github.com/mdn/webextensions-examples">webextensions-examples</a> repository.</p> -</div> - -<p><a href="/en-US/Add-ons/WebExtensions/Anatomy_of_a_WebExtension#Background_scripts">Background scripts</a> stay loaded for the lifetime of the extension. They're loaded inside an invisible "background page": by default this is an empty HTML document, but you can specify your own HTML content using the <a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/manifest.json/background">"background" key in "manifest.json"</a>.</p> - -<p>You can debug background scripts using the <a href="/en-US/Add-ons/WebExtensions/Debugging_(Firefox_50_onwards)#The_Add-on_Debugger">Add-on Debugger</a>.</p> - -<p>In the Add-on Debugger's Console you'll see logged output, including calls to <code><a href="/en-US/docs/Web/API/Console/log">console.log()</a></code> from your own background scripts and any errors the browser raises as it executes them. Note that at the moment, the console shows all errors raised by the browser, not just errors related to your extensions code.</p> - -<p>For example, the <a href="https://github.com/mdn/webextensions-examples/tree/master/notify-link-clicks-i18n">notify-link-clicks-i18n</a> example extension logs a message from its background script when it receives a message from one of its content scripts:</p> - -<p>{{EmbedYouTube("WDQsBU-rpN0")}}</p> - -<p>Using the Console's command line, you can access and modify the objects created by your background scripts.</p> - -<p>For example, here we call the <code>notify()</code> function defined in the extension's background script:</p> - -<p>{{EmbedYouTube("g-Qgf8Mc2wg")}}</p> - -<p>If you switch to the Debugger, you'll see all your extension's background scripts. You can set breakpoints, step through code, and do <a href="https://developer.mozilla.org/en-US/docs/Tools/Debugger">everything else you'd expect to be able to do in a debugger</a>.</p> - -<p>{{EmbedYouTube("MNeaz2jdmzY")}}</p> - -<p>If you press the Escape key while you're in the Debugger, the toolbox will be split, with the bottom half now occupied by the Console. While you're at a breakpoint, you can now modify the program's state using the console. See <a href="/en-US/docs/Tools/Web_Console/Split_console">Split console</a> for more on this.</p> - -<h2 id="Debugging_options_pages">Debugging options pages</h2> - -<p><a href="/en-US/Add-ons/WebExtensions/Anatomy_of_a_WebExtension#Options_pages">Options pages</a> are HTML pages that the extension developer can supply, that contain options for the extension. They are typically displayed in an iframe in the Add-ons Manager (to see the Add-ons Manager, visit the "about:addons" page).</p> - -<p>To debug options pages:</p> - -<ul> - <li>open the <a href="/en-US/Add-ons/WebExtensions/Debugging_(Firefox_50_onwards)#The_Add-on_Debugger">Add-on Debugger</a> for your extension</li> - <li>open your extension's option page.</li> -</ul> - -<p>Any JavaScript sources it includes are then listed in the Debugger:</p> - -<p>{{EmbedYouTube("BUMG-M8tFF4")}}</p> - -<div class="note"> -<p>This video uses the <a href="https://github.com/mdn/webextensions-examples/tree/master/favourite-colourbeastify">favourite-colour</a> example extension.</p> -</div> - -<p>You'll also see any messages logged by your code in the Add-on Debugger's Console.</p> - -<p>You can also use the Add-on Debugger to debug the page's HTML and CSS. First, though, you need to point the tools at the iframe that hosts the options page. To do this: open the options page, click the icon highlighted in the screenshot below, and select the options page from the drop-down list:</p> - -<p><img alt="" src="https://mdn.mozillademos.org/files/13863/toolbox-iframe.png" style="display: block; height: 417px; margin-left: auto; margin-right: auto; width: 876px;"></p> - -<p>Now switch to the Inspector tab, and you'll be able to examine and edit HTML and CSS for the page:</p> - -<p>{{EmbedYouTube("-2m3ubFAU94")}}</p> - -<h2 id="Debugging_popups">Debugging popups</h2> - -<p><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/Popups">Popups</a> are dialogs that are attached to browser actions or page actions. They are specified using an HTML document that can include CSS and JavaScript sources for styling and behavior. Whenever the popup is visible, you can use the <a href="/en-US/Add-ons/WebExtensions/Debugging_(Firefox_50_onwards)#The_Add-on_Debugger">Add-on Debugger</a> to debug its code.</p> - -<p>One problem with popups is that if a popup is open and you click outside the popup, the popup is closed and its code is unloaded. This obviously makes them impossible to debug. To suppress this behavior, select Disable Popup Auto-Hide from the Elipsis menu as shown below:</p> - -<p><img alt="" src="https://mdn.mozillademos.org/files/16301/add-on-debugger.png" style="display: block; height: 612px; margin-left: auto; margin-right: auto; width: 876px;"></p> - -<p>Now, when you open a popup it will stay open until you press Escape.</p> - -<div class="note"> -<p><strong>Note:</strong> This change applies to built-in browser popups, like the Elipsis menu (<code>...</code>), as well as extension popups.</p> - -<p>The setting does not persist across sessions. When you close the window, the setting reverts to auto-hide popups.</p> -Internally, this button just toggles the <code>ui.popup.disable_autohide</code> preference, which you can toggle manually using about:config.</div> - -<p>When the popup is open, its JavaScript sources will be listed in the Debugger. You can set breakpoints and modify the program's internal state:</p> - -<p>{{EmbedYouTube("hzwnR8qoz2I")}}</p> - -<div class="note"> -<p>This video uses the <a href="https://github.com/mdn/webextensions-examples/tree/master/beastify">beastify</a> example extension.</p> -</div> - -<p>You can also use the Add-on Debugger to debug the popup's HTML and CSS. First, though, you need to point the tools at the popup's document. To do this: open the popup, then click the icon highlighted in the screenshot below and select the popup's page from the drop-down list:<img alt="" src="https://mdn.mozillademos.org/files/13863/toolbox-iframe.png" style="display: block; height: 417px; margin-left: auto; margin-right: auto; width: 876px;"></p> - -<p>Now switch to the Inspector, and you'll be able to examine and edit the popup's HTML and CSS:</p> - -<p>{{EmbedYouTube("6lvdm7jaq7Y")}}</p> - -<h2 id="Debugging_content_scripts">Debugging content scripts</h2> - -<p>You can use the Add-on Debugger to debug background pages, options pages, and popups. However, you can't use it to debug content scripts. This is because, in <a href="/en-US/docs/Mozilla/Firefox/Multiprocess_Firefox">multiprocess Firefox</a>, content scripts run in a different process from the other parts of your extension. The browser console has similar limitations.</p> - -<p>To debug content scripts attached to a web page, use the normal web developer tools for that page:</p> - -<ul> - <li>either select "Toggle Tools" from the Web Developer submenu in the Firefox Menu (or Tools menu if you display the menu bar or are on Mac OS X)</li> - <li>or press the <kbd>Ctrl</kbd><kbd>Shift</kbd><kbd>I</kbd> (<kbd>Command</kbd><kbd>Option</kbd><kbd>I</kbd> on OS X) keyboard shortcut.</li> -</ul> - -<p>{{EmbedYouTube("f46hMLELyaI")}}</p> - -<p>By default, the tools are shown attached to the bottom of browser tab, to reflect the fact that they are attached to this tab. You'll see any output from <code><a href="/en-US/docs/Web/API/Console/log">console.log()</a></code> statements in your content scripts. You will also see your content scripts listed in the Debugger, where you'll be able to set breakpoints, step through the code, and so on.</p> - -<p>{{EmbedYouTube("Hx3GU_fEPeo")}}</p> - -<div class="note"> -<p>This video uses the <a href="https://github.com/mdn/webextensions-examples/tree/master/notify-link-clicks-i18n">notify-link-clicks-i18n</a> example extension.</p> -</div> - -<div class="note"> -<p>If the developer tools tab was not already open when the content script was injected, sometimes the content script is not listed in the debugger panel. If you experience this, reloading the page with the developer tools tab open should fix the problem.</p> -</div> - -<h2 id="Debugging_sidebars">Debugging sidebars</h2> - -<p><a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/user_interface/Sidebars">Sidebars</a> are HTML pages opened as a sidebar in the browser UI that the extension developer can supply.</p> - -<p>To debug sidebars:</p> - -<ul> - <li>open the <a href="/en-US/Add-ons/WebExtensions/Debugging_(Firefox_50_onwards)#The_Add-on_Debugger">Add-on Debugger</a> for your extension</li> - <li>open your extension's sidebar.</li> -</ul> - -<p>Any JavaScript sources it includes are then listed in the Debugger.</p> - -<p>You'll also see any messages logged by your code in the Add-on Debugger's Console.</p> - -<p>You can also use the Add-on Debugger to debug the page's HTML and CSS. First, though, you need to point the tools at the iframe that hosts the options page. To do this: open the sidebar, click the icon highlighted in the screenshot below, and select the sidebar from the drop-down list:</p> - -<p><img alt="" src="https://mdn.mozillademos.org/files/13863/toolbox-iframe.png" style="display: block; height: 417px; margin-left: auto; margin-right: auto; width: 876px;"></p> - -<h2 id="Debug_runtime_permission_requests">Debug runtime permission requests</h2> - -<p> </p> - -<p>Runtime permissions granted in your extension are persistent. Therefore, if you want to test cases where the permission has not been granted you will need to add a feature to programmatically remove the permission, use the <a class="external external-icon" href="https://github.com/rpl/dev-webext-permissions-manager" rel="noopener">Extensions Permission Manager,</a> or give your extension a new ID. For more information, see <a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/Test_permission_requests#Retest_runtime_permission_grants">Retest runtime permission grants</a> in <a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/Test_permission_requests">Test permission requests</a>.</p> - -<p> </p> - -<h2 id="Debugging_developer_tools_pages_panels">Debugging developer tools pages & panels</h2> - -<p><a href="/en-US/Add-ons/WebExtensions/Extending_the_developer_tools">Developer tools</a> are extended by loading a hidden HTML page when devtools are opened and <a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/API/devtools.panels/create">developer tools panels</a> are HTML pages displayed as a developer tool in the browser UI that the extension developer can supply.</p> - -<p>To debug the developer tools page:</p> - -<ul> - <li>open the <a href="/en-US/Add-ons/WebExtensions/Debugging_(Firefox_50_onwards)#The_Add-on_Debugger">Add-on Debugger</a> for your extension</li> - <li>open the Web Developer Tools</li> -</ul> - -<p>To debug developer tools panels:</p> - -<ul> - <li>Follow the steps for the developer tools page above</li> - <li>Select your developer tools panel</li> -</ul> - -<p>Any JavaScript sources it includes are then listed in the Debugger.</p> - -<p>You'll also see any messages logged by your code in the Add-on Debugger's Console.</p> - -<p>You can also use the Add-on Debugger to debug the page's HTML and CSS. First, though, you need to point the tools at the iframe that hosts the options page. To do this: open the sidebar, click the icon highlighted in the screenshot below, and select the sidebar from the drop-down list:</p> - -<p><img alt="" src="https://mdn.mozillademos.org/files/13863/toolbox-iframe.png" style="display: block; height: 417px; margin-left: auto; margin-right: auto; width: 876px;"></p> - -<h2 id="Debugging_Browser_Restarts">Debugging Browser Restarts</h2> - -<p>If your extension is active in ways that might be affected by the browser restarting, such as a session being restored, then you may want to do extra testing to ensure your code works as expected in those conditions.</p> - -<p>See <a href="/en-US/docs/Mozilla/Add-ons/WebExtensions/Testing_persistent_and_restart_features">Testing persistent and restart features</a> for more details.</p> diff --git a/files/ru/orphaned/toolkit_api/index.html b/files/ru/orphaned/toolkit_api/index.html deleted file mode 100644 index 373040c565..0000000000 --- a/files/ru/orphaned/toolkit_api/index.html +++ /dev/null @@ -1,19 +0,0 @@ ---- -title: Toolkit API (Инструментарий API) -slug: orphaned/Toolkit_API -tags: - - Toolkit API -original_slug: Toolkit_API ---- -<p><strong>Mozilla Toolkit</strong> это набор программных интерфейсов (APIs) собранных на базе Gecko которые обеспечивают продвинутые службы на базе XUL приложения. Эти службы включают:</p> -<ul> <li>Менеджер профиля</li> <li>Chrome регистрация</li> <li>История просмотра</li> <li>Расширения и Управление темами</li> <li>Служба обновления приложения</li> <li>Безопасный режим</li> -</ul> -<h3 id="Официальное_руководство">Официальное руководство</h3> -<ul> <li><a href="../../../../en/Bundles">Структура одной из инсталлируемых пачек</a>: описывает основную структуру инсталлируемой пачки, включает расширения, темы, и XULRunner приложения</li> <li><a href="../../../../en/Extension_Packaging">Упаковка расширений</a>: конкретная информация о том, как упаковать расширение</li> <li><a href="../../../../en/Theme_Packaging">Упаковка темы</a>: конкретная информация о том, как упаковать тему</li> <li><a href="../../../../en/Multiple_Item_Packaging">Упаковка многозначного расширения</a>: конкретная информация о множественных-значениях расширения XPIs</li> <li><a href="../../../../en/XUL_Application_Packaging">Упаковка </a><a href="../../../../en/XUL_Application_Packaging">XUL приложения</a>: конкретная информация о том, как упаковать XULRunner приложение</li> <li><a href="../../../../en/Chrome_Registration">Регистрация </a><a href="../../../../en/Chrome_Registration">Chrome<br> </a></li> -</ul> -<h3 id="Дополнительная_информация">Дополнительная информация</h3> -<p>Следующие страницы разработчика содержат примеры и обсуждение конкретных тем</p> -<p><a href="../../../../en/XUL">XUL</a>; <a href="../../../../en/XUL_Overlays">XUL Overlays</a>; <a href="../../../../en/Extensions">Developing Extensions</a>; <a href="../../../../en/XULRunner">XULRunner</a>; <a href="../../../../en/Themes">Developing Themes</a>; <a href="../../../../en/DOM">DOM</a>; <a href="../../../../en/RDF">RDF</a>; <a href="../../../../en/Storage">Storage</a>; <a href="../../../../en/Help_Viewer">Creating Help Documentation</a></p> -<p><span>Categories</span></p> -<p><span>Interwiki Language Links</span></p> -<p>{{ languages( { "ca": "ca/API_del_Toolkit", "es": "es/API_del_Toolkit", "fr": "fr/API_du_toolkit", "it": "it/Toolkit_API", "ja": "ja/Toolkit_API", "ko": "ko/Toolkit_API", "pl": "pl/Toolkit_API" } ) }}</p> diff --git a/files/ru/orphaned/tools/add-ons/dom_inspector/index.html b/files/ru/orphaned/tools/add-ons/dom_inspector/index.html deleted file mode 100644 index 719178baac..0000000000 --- a/files/ru/orphaned/tools/add-ons/dom_inspector/index.html +++ /dev/null @@ -1,58 +0,0 @@ ---- -title: DOM Inspector -slug: orphaned/Tools/Add-ons/DOM_Inspector -translation_of: Tools/Add-ons/DOM_Inspector -original_slug: Tools/Add-ons/DOM_Inspector ---- -<div>{{ToolsSidebar}}</div><p><strong>Инспектор DOM</strong> (также известный как <strong>DOMi</strong>) — инструмент для разработчиков, используемый для проверки, просмотра и редактирования <a href="/en/DOM" title="en/DOM">объектной модели документа</a><a href="/en-US/docs/"> </a>- обычных веб-страниц или <a href="/en/XUL" title="en/XUL"> XUL</a> windows. По иерархии DOM можно перемещаться с помощью двух окон, отображающих целый ряд различных представлений документа и всех вложенных в него узлов.</p> - -<div class="note"> -<p>Этот инструмент является дополнением для приложений, основанных на XUL, таких как Firefox и Thunderbird. Если вы ищете инспектор DOM, который встроен в Firefox, обратитесь к разделу документации <a href="/ru/docs/Tools/Page_Inspector">Инспектор страницы</a>.</p> -</div> - -<h2 id="Documentation" name="Documentation">Документация</h2> - -<dl> - <dt><a href="/en/DOM_Inspector/Introduction_to_DOM_Inspector" title="en/DOM_Inspector/Introduction_to_DOM_Inspector">Введение в инспектор DOM</a></dt> - <dd>Руководствоваться учебник, который поможет вам начать работу с DOM Inspector.</dd> -</dl> - -<dl> - <dt><a href="/en/DOM_Inspector/DOM_Inspector_FAQ" title="en/DOM_Inspector/DOM_Inspector_FAQ">FAQ инспектор DOM</a></dt> - <dd>Ответы на общие вопросы по DOM Inspector.</dd> -</dl> - -<dl> - <dt><a class="external" href="http://kb.mozillazine.org/DOM_Inspector">страницы на MozillaZine</a></dt> - <dd>Более подробную информацию о DOM Inspector.</dd> - <dt><a href="http://asurkov.blogspot.com/2013/02/build-dom-inspector.html">как скомпилировать инспектор DOM</a></dt> - <dd>Сообщение в блоге на здание инспектор DOM от источника.</dd> -</dl> - -<h2 id="Getting_DOM_Inspector" name="Getting_DOM_Inspector">Получение инспектор DOM</h2> - -<dl> - <dt>Firefox и Thunderbird</dt> - <dd>Вы можете скачать и установить <a class="link-https" href="https://addons.mozilla.org/en-US/firefox/addon/6622" title="https://addons.mozilla.org/en-US/firefox/addon/6622"> Инспектор DOM</a> на веб-сайте AMO. (Thunderbird пользователей, использующих AMO в Firefox следует сохранить ссылку установки, или посетить страницу <a class="link-https" href="https://addons.mozilla.org/en-US/thunderbird/addon/6622" title="https://addons.mozilla.org/en-US/thunderbird/addon/6622"> Инспектор DOM для Thunderbird</a>).</dd> -</dl> - -<dl> - <dt>Thunderbird 2</dt> - <dd><a class="link-https" href="https://addons.mozilla.org/en-US/thunderbird/addon/1806">Инспектор DOM для Thunderbird 2</a> доступен из <a class="link-https" href="https://addons.mozilla.org/en-US/thunderbird/"> Дополнений для Thunderbird</a>. Или настройте Thunderbird сами со следующими параметрами:</dd> -</dl> - -<pre><code>ac_add_options --enable-extensions="default inspector" -ac_add_options --enable-inspector-apis</code></pre> - -<dl> - <dt>Mozilla Suite и SeaMonkey</dt> - <dd>Выберите Инструменты > Веб-разработка > Инспектор DOM. Вы также можете установить боковую панель через Правка > Настройки > Дополнительно > Инспектор DOM, затем просто откройте панель инспектора DOM и посетите любой веб-сайт.</dd> -</dl> - -<h2 id="Report_a_bug_in_DOM_Inspector" name="Report_a_bug_in_DOM_Inspector">Отчёт об ошибке в DOM Inspector</h2> - -<p>Использовать удобно именованный раздел <a href="https://bugzilla.mozilla.org/enter_bug.cgi?format=__default__&product=Other%20Applications&component=DOM%20Inspector">компонент «Инспектор DOM» в Bugzilla</a>.</p> - -<p>Чтобы узнать о тех, кто знает <a href="https://hg.mozilla.org/dom-inspector" title="https://hg.mozilla.org/dom-inspector"> код DOM Inspector</a> и где он живёт, см. <a class="link-https" href="https://wiki.mozilla.org/Modules/All#DOM_Inspector" title="https://wiki.mozilla.org/Modules/All#DOM_Inspector"> <span class="external"> листинг модуля DOM Inspector</span></a>.</p> - -<p>{{ languages( { "es": "es/DOM_Inspector", "it": "it/DOM_Inspector", "fr": "fr/Inspecteur_DOM", "ja": "ja/DOM_Inspector", "ko": "ko/DOM_Inspector", "pl": "pl/Inspektor_DOM" } ) }}</p> diff --git a/files/ru/orphaned/tools/add-ons/index.html b/files/ru/orphaned/tools/add-ons/index.html deleted file mode 100644 index c385f15d53..0000000000 --- a/files/ru/orphaned/tools/add-ons/index.html +++ /dev/null @@ -1,16 +0,0 @@ ---- -title: Add-ons -slug: orphaned/Tools/Add-ons -tags: - - NeedsTranslation - - TopicStub -translation_of: Tools/Add-ons -original_slug: Tools/Add-ons ---- -<div>{{ToolsSidebar}}</div><p>Developer tools that are not built into Firefox, but ship as separate add-ons.</p> - -<dl> - <dt><a href="https://addons.mozilla.org/en-US/firefox/addon/websocket-monitor/">WebSocket Monitor</a></dt> - <dd>Examine the data exchanged in a WebSocket connection.</dd> - <dd> </dd> -</dl> diff --git a/files/ru/orphaned/tools/debugger/keyboard_shortcuts/index.html b/files/ru/orphaned/tools/debugger/keyboard_shortcuts/index.html deleted file mode 100644 index 772d865ee2..0000000000 --- a/files/ru/orphaned/tools/debugger/keyboard_shortcuts/index.html +++ /dev/null @@ -1,17 +0,0 @@ ---- -title: Комбинации клавиш отладчика -slug: orphaned/Tools/Debugger/Keyboard_shortcuts -tags: - - Клавиатура - - Отладчик - - комбинации клавиш -translation_of: Tools/Debugger/Keyboard_shortcuts -original_slug: Tools/Debugger/Keyboard_shortcuts ---- -<div>{{ToolsSidebar}}</div> - -<p>{{ Page ("ru/docs/tools/Keyboard_shortcuts", "debugger") }}</p> - -<h2 id="Общие_комбинации_клавиш">Общие комбинации клавиш</h2> - -<p>{{ Page ("ru/docs/tools/Keyboard_shortcuts", "all-toolbox-tools") }}</p> diff --git a/files/ru/orphaned/tools/page_inspector/keyboard_shortcuts/index.html b/files/ru/orphaned/tools/page_inspector/keyboard_shortcuts/index.html deleted file mode 100644 index 0814802641..0000000000 --- a/files/ru/orphaned/tools/page_inspector/keyboard_shortcuts/index.html +++ /dev/null @@ -1,14 +0,0 @@ ---- -title: Клавиатурные сокращения -slug: orphaned/Tools/Page_Inspector/Keyboard_shortcuts -tags: - - Инспектор - - инструменты -translation_of: Tools/Page_Inspector/Keyboard_shortcuts -original_slug: Tools/Page_Inspector/Keyboard_shortcuts ---- -<div>{{ToolsSidebar}}</div><p>{{ Page ("ru/docs/tools/Keyboard_shortcuts", "page-inspector") }}</p> - -<h3 id="Глобальные_сокращения">Глобальные сокращения</h3> - -<p>{{ Page ("ru/docs/tools/Keyboard_shortcuts", "all-toolbox-tools") }}</p> diff --git a/files/ru/orphaned/web/api/abstractworker/index.html b/files/ru/orphaned/web/api/abstractworker/index.html deleted file mode 100644 index 24a8af3b19..0000000000 --- a/files/ru/orphaned/web/api/abstractworker/index.html +++ /dev/null @@ -1,96 +0,0 @@ ---- -title: AbstractWorker -slug: orphaned/Web/API/AbstractWorker -tags: - - API - - AbstractWorker - - Interface - - SharedWorker - - Web Workers - - Web Workers API - - Worker - - Абстрактный - - Интерфейс -translation_of: Web/API/AbstractWorker -original_slug: Web/API/AbstractWorker ---- -<div>{{ APIRef("Web Workers API") }}</div> - -<div>Интерфейс <span class="seoSummary"><strong><code>AbstractWorker (абстрактный воркер)</code></strong></span> , как часть <span class="seoSummary"> <a href="https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API">Web Workers API</a></span> - это абстрактный интерфейс, который определяет общие свойства и методы для всех типов воркеров: для базового <span class="seoSummary">{{domxref("Worker")}}</span> и также для <span class="seoSummary">{{domxref("ServiceWorker")}}</span> и <span class="seoSummary">{{domxref("SharedWorker")}}</span>. Вы напрямую не взаимодействует с <code>AbstractWorker</code>, как и с абстрактным классом.</div> - -<h2 id="Свойства">Свойства</h2> - -<p><em>Интерфейс <code>AbstractWorker</code></em><em> не наследует никаких свойств</em></p> - -<h3 id="Обработчики_событий">Обработчики событий</h3> - -<dl> - <dt>{{domxref("AbstractWorker.onerror")}}</dt> - <dd>{{ domxref("EventListener") }}, который вызывается каждый раз, когда {{domxref("ErrorEvent")}} с типом <code>error</code> всплывает через воркер.</dd> -</dl> - -<h2 id="Методы">Методы</h2> - -<p><em>Интерфейс <code>AbstractWorker</code></em><em> не наследует и не реализует никаких свойств</em></p> - -<h2 id="Пример">Пример</h2> - -<p>Прямого использования <code>AbstractWorker</code> не будет в коде, так как это абстрактный интерфейс. Вместо этого, взаимодействие будет происходить либо с {{domxref("Worker")}}, либо с {{domxref("SharedWorker")}}, оба из которых наследуют свойства от <code>AbstractWorker</code>.</p> - -<p>Ниже фрагмент кода, который демонстрирует создание нового <code>Worker</code> с помощью конструктора {{domxref("Worker.Worker", "Worker()")}}; ещё здесь показан способ как послать сообщению воркеру.</p> - -<pre class="brush: js">var myWorker = new Worker('worker.js'); - -first.onchange = function() { - myWorker.postMessage([first.value, second.value]); - console.log('Message posted to worker'); -}</pre> - -<p>Код воркера загружается из файла <code>"worker.js"</code>. В данном коде предполагается, что есть элемент {{HTMLElement("input")}}, его определяет переменная <code>first</code>. Для события {{domxref("change")}} элемента создаётся обработчик, поэтому когда пользователь изменяет значение для <code>first</code>, отправляется сообщение в воркер для уведомления его об данных изменениях.</p> - -<p>Вы можете найти больше примеров в репозитории MDN Web Docs на GitHub:</p> - -<ul> - <li><a class="external external-icon" href="https://github.com/mdn/simple-web-worker">Базовый пример для dedicated worker</a> (<a class="external external-icon" href="http://mdn.github.io/simple-web-worker/">запустить dedicated worker</a>).</li> - <li><a class="external external-icon" href="https://github.com/mdn/simple-shared-worker">Базовый пример для shared worker</a> (<a class="external external-icon" href="http://mdn.github.io/simple-shared-worker/">запустить shared worker</a>).</li> -</ul> - -<h2 id="Спецификации">Спецификации</h2> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Спецификация</th> - <th scope="col">Статус</th> - <th scope="col">Комментарий</th> - </tr> - </thead> - <tbody> - <tr> - <td>{{SpecName("HTML WHATWG", "#abstractworker", "AbstractWorker")}}</td> - <td>{{Spec2("HTML WHATWG")}}</td> - <td>Без изменений {{SpecName("Web Workers")}}.</td> - </tr> - <tr> - <td>{{SpecName("Web Workers", "#the-abstractworker-abstract-interface", "AbstractWorker")}}</td> - <td>{{Spec2("Web Workers")}}</td> - <td>Начальное определение.</td> - </tr> - </tbody> -</table> - -<h2 id="Совместимость_с_браузерами">Совместимость с браузерами</h2> - -<div> - - -<p>{{Compat("api.AbstractWorker")}}</p> -</div> - -<h2 id="Смотрите_также">Смотрите также</h2> - -<ul> - <li>Интерфейсы для {{domxref("Worker")}}, {{domxref("ServiceWorker")}}, и {{domxref("SharedWorker")}} , которые все основаны на <code>AbstractWorker</code>.</li> - <li><a href="/en-US/docs/Web/API/Web_Workers_API">Web Workers API</a></li> - <li><a href="/en-US/docs/Web/API/Web_Workers_API/Using_web_workers">Using Web Workers</a></li> -</ul> diff --git a/files/ru/orphaned/web/api/ambient_light_events/index.html b/files/ru/orphaned/web/api/ambient_light_events/index.html deleted file mode 100644 index 9cacc1fffa..0000000000 --- a/files/ru/orphaned/web/api/ambient_light_events/index.html +++ /dev/null @@ -1,63 +0,0 @@ ---- -title: Ambient Light Events -slug: orphaned/Web/API/Ambient_Light_Events -tags: - - Освещённость -translation_of: Web/API/Ambient_Light_Events -original_slug: Web/API/Ambient_Light_Events ---- -<div>{{DefaultAPISidebar("Ambient Light Events")}}{{SeeCompatTable}}</div> - -<p>События "окружающего света" - удобный способ уведомить веб-страницу или приложение о каком-либо изменении интенсивности света. Это позволяет им реагировать на такое изменение, например, путём изменения цветового контраста пользовательского интерфейса (UI) или путём изменения экспозиции, необходимой для фотографирования.</p> - -<h2 id="Световые_события">Световые события</h2> - -<p>Когда датчик света устройства обнаруживает изменение уровня освещённости, он уведомляет браузер об этом изменении. Когда браузер получает такое уведомление, он вызывает {{domxref("DeviceLightEvent")}} событие, которое предоставляет информацию о точной интенсивности света.</p> - -<p>Это событие может быть захвачено на уровне объектом окна, используя метод {{domxref("EventTarget.addEventListener","addEventListener")}} (используя имя события {{event("devicelight")}} ) или путём присоединения обработчика событий к свойству {{domxref("window.ondevicelight")}}.</p> - -<p>После того, как захвачен объект события даёт доступ к интенсивности света, выраженного в <a href="http://en.wikipedia.org/wiki/Lux">lux</a> через свойство {{domxref("DeviceLightEvent.value")}}.</p> - -<h2 id="Пример">Пример</h2> - -<pre class="brush: js">window.addEventListener('devicelight', function(event) { - var html = document.getElementsByTagName('html')[0]; - - if (event.value < 50) { - html.classList.add('darklight'); - html.classList.remove('brightlight'); - } else { - html.classList.add('brightlight'); - html.classList.remove('darklight'); - } -});</pre> - -<h2 id="Характеристики">Характеристики</h2> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Specification</th> - <th scope="col">Status</th> - <th scope="col">Comment</th> - </tr> - </thead> - <tbody> - <tr> - <td>{{SpecName("AmbientLight", "", "Ambient Light Events")}}</td> - <td>{{Spec2("AmbientLight")}}</td> - <td>Initial definition</td> - </tr> - </tbody> -</table> - -<h2 id="Поддержка_браузерами">Поддержка браузерами</h2> - -<p>{{Compat("api.DeviceLightEvent")}}</p> - -<h2 id="Смотрите_также">Смотрите также</h2> - -<ul> - <li>{{domxref("DeviceLightEvent")}}</li> - <li>{{event("devicelight")}}</li> -</ul> diff --git a/files/ru/orphaned/web/api/body/arraybuffer/index.html b/files/ru/orphaned/web/api/body/arraybuffer/index.html deleted file mode 100644 index 8c2e092cf3..0000000000 --- a/files/ru/orphaned/web/api/body/arraybuffer/index.html +++ /dev/null @@ -1,91 +0,0 @@ ---- -title: Body.arrayBuffer() -slug: orphaned/Web/API/Body/arrayBuffer -tags: - - API - - Экспериментальный - - справочник -translation_of: Web/API/Body/arrayBuffer -original_slug: Web/API/Body/arrayBuffer ---- -<div>{{APIRef("Fetch")}}</div> - -<p>Метод <strong><code>arrayBuffer()</code></strong> из примеси(mixin) {{domxref("Body")}} берёт поток(stream) {{domxref("Response")}} и читает его до завершения. Он возвращает промис, который будет успешно завершён с помощью {{domxref("ArrayBuffer")}}.</p> - -<h2 id="Синтаксис">Синтаксис</h2> - -<pre class="brush: js">response.arrayBuffer().then(function(buffer) { - // можно сделать что либо с буфером -});</pre> - -<h3 id="Параметры">Параметры</h3> - -<p>Нат параметров.</p> - -<h3 id="Возвращаемое_значение">Возвращаемое значение</h3> - -<p>Промис, который содержит {{domxref("ArrayBuffer")}}.</p> - -<h2 id="Пример">Пример</h2> - -<p>В нашем примере <a href="http://mdn.github.io/fetch-examples/fetch-array-buffer/">живой загрузки с array buffer</a> есть кнопка Play. При нажатии на кнопку вызывается функция <code>getData()</code>. Стоит учесть что до проигрывания аудио файл будет скачан целиком. Если вам необходимо начать воспроизведение файла ogg во время загрузки (стримить аудио) - то лучше рассмотреть {{domxref("HTMLAudioElement")}}:</p> - -<pre class="brush: js">new Audio(music.ogg).play() -</pre> - -<p>В функции <code>getData()</code> мы создаём новый запрос используя конструктор {{domxref("Request.Request")}}, после этого используем его чтобы загрузить OGG звук. Мы также используем {{domxref("AudioContext.createBufferSource")}} чтобы создать ресурс аудиобуффера. При успешном завершении запроса, мы считываем {{domxref("ArrayBuffer")}} из ответа используя <code>arrayBuffer()</code>, декодируем аудио с помощью {{domxref("AudioContext.decodeAudioData")}}, устанавливаем раскодированные данные как ресурс аудио буфера (<code>source.buffer</code>), затем используем данные этого ресурса в {{domxref("AudioContext.destination")}}.</p> - -<p>Когда функция <code>getData()</code> заканчивает своё выполнение, мы стартуем проигрывание аудио ресурса функцией <code>start(0)</code>, потом блокируем кнопку проигрывания для предотвращения повторного проигрывания (это может привести к ошибкам)</p> - -<pre class="brush: js">function getData() { - source = audioCtx.createBufferSource(); - - var myRequest = new Request('viper.ogg'); - - fetch(myRequest).then(function(response) { - return response.arrayBuffer(); - }).then(function(buffer) { - audioCtx.decodeAudioData(buffer, function(decodedData) { - source.buffer = decodedData; - source.connect(audioCtx.destination); - }); - }); -}; - -// навешиваем обработчики старт и стоп на кнопку -play.onclick = function() { - getData(); - source.start(0); - play.setAttribute('disabled', 'disabled'); -}</pre> - -<h2 id="Спецификация">Спецификация</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Спецификация</th> - <th scope="col">Статус</th> - <th scope="col">Комментарии</th> - </tr> - <tr> - <td>{{SpecName('Fetch','#dom-body-arraybuffer','arrayBuffer()')}}</td> - <td>{{Spec2('Fetch')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Поддержка_браузерами">Поддержка браузерами</h2> - - - -<p>{{Compat("api.Body.arrayBuffer")}}</p> - -<h2 id="Смотрите_также">Смотрите также</h2> - -<ul> - <li><a href="/en-US/docs/Web/API/ServiceWorker_API">ServiceWorker API</a></li> - <li><a href="/en-US/docs/Web/HTTP/Access_control_CORS">HTTP access control (CORS)</a></li> - <li><a href="/en-US/docs/Web/HTTP">HTTP</a></li> -</ul> diff --git a/files/ru/orphaned/web/api/body/formdata/index.html b/files/ru/orphaned/web/api/body/formdata/index.html deleted file mode 100644 index 5e04b96274..0000000000 --- a/files/ru/orphaned/web/api/body/formdata/index.html +++ /dev/null @@ -1,60 +0,0 @@ ---- -title: Body.formData() -slug: orphaned/Web/API/Body/formData -translation_of: Web/API/Body/formData -original_slug: Web/API/Body/formData ---- -<div>{{APIRef("Fetch")}}</div> - -<p>Метод <strong><code>formData()</code></strong> из {{domxref("Body")}} принимает поток ответа {{domxref("Response")}} и считывает его до завершения. Он возвращает промис, который разрешается с помощью объекта {{domxref("FormData")}}.</p> - -<div class="note"> -<p><strong>Примечание:</strong> Это в основном относится к <a href="/en-US/docs/Web/API/ServiceWorker_API">service workers</a>. Если пользователь отправляет форму а service worker перехватывает запрос, можно, например, вызвать <code>formData()</code> чтобы получить набор данных в формате ключ-значение, изменить некоторые поля, а затем отправить форму на сервер, или использовать её локально.</p> -</div> - -<h2 id="Синтаксис">Синтаксис</h2> - -<pre class="syntaxbox">response.formData() -.then(function(formdata) { - // do something with your formdata -});</pre> - -<h3 id="Параметры">Параметры</h3> - -<p>Нет.</p> - -<h3 id="Возвращаемое_значение">Возвращаемое значение</h3> - -<p>{{domxref("Promise")}} которое разрешается с помощью объекта {{domxref("FormData")}}.</p> - -<h2 id="Пример">Пример</h2> - -<p>Нужно добавить.</p> - -<h2 id="Спецификации">Спецификации</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Specification</th> - <th scope="col">Status</th> - <th scope="col">Comment</th> - </tr> - <tr> - <td>{{SpecName('Fetch','#dom-body-formdata','formData()')}}</td> - <td>{{Spec2('Fetch')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Браузерная_совместимость">Браузерная совместимость</h2> -<p>{{Compat("api.Body.formData")}}</p> - -<h2 id="Также_смотрите">Также смотрите</h2> - -<ul> - <li><a href="/en-US/docs/Web/API/ServiceWorker_API">ServiceWorker API</a></li> - <li><a href="/en-US/docs/Web/HTTP/Access_control_CORS">HTTP access control (CORS)</a></li> - <li><a href="/en-US/docs/Web/HTTP">HTTP</a></li> -</ul> diff --git a/files/ru/orphaned/web/api/body/index.html b/files/ru/orphaned/web/api/body/index.html deleted file mode 100644 index 0794ac997e..0000000000 --- a/files/ru/orphaned/web/api/body/index.html +++ /dev/null @@ -1,100 +0,0 @@ ---- -title: Body -slug: orphaned/Web/API/Body -tags: - - API - - BODY - - Experimental - - Fetch - - Fetch API - - Interface - - NeedsTranslation - - Reference - - TopicStub - - request -translation_of: Web/API/Body -original_slug: Web/API/Body ---- -<div>{{ APIRef("Fetch") }}</div> - -<p><span class="seoSummary">The <strong><code>Body</code></strong> {{glossary("mixin")}} of the <a href="/en-US/docs/Web/API/Fetch_API">Fetch API</a> represents the body of the response/request, allowing you to declare what its content type is and how it should be handled.</span></p> - -<p><code>Body</code> is implemented by both {{domxref("Request")}} and {{domxref("Response")}}. This provides these objects with an associated <dfn>body</dfn> (a <a href="/en-US/docs/Web/API/Streams_API">stream</a>), a <dfn>used flag</dfn> (initially unset), and a <dfn>MIME type</dfn> (initially the empty byte sequence).</p> - -<h2 id="Properties">Properties</h2> - -<dl> - <dt>{{domxref("Body.body")}} {{readonlyInline}}</dt> - <dd>A simple getter used to expose a {{domxref("ReadableStream")}} of the body contents.</dd> - <dt>{{domxref("Body.bodyUsed")}} {{readonlyInline}}</dt> - <dd>A {{domxref("Boolean")}} that indicates whether the body has been read.</dd> -</dl> - -<h2 id="Methods">Methods</h2> - -<dl> - <dt>{{domxref("Body.arrayBuffer()")}}</dt> - <dd>Takes a {{domxref("Response")}} stream and reads it to completion. It returns a promise that resolves with an {{domxref("ArrayBuffer")}}.</dd> - <dt>{{domxref("Body.blob()")}}</dt> - <dd>Takes a {{domxref("Response")}} stream and reads it to completion. It returns a promise that resolves with a {{domxref("Blob")}}.</dd> - <dt>{{domxref("Body.formData()")}}</dt> - <dd>Takes a {{domxref("Response")}} stream and reads it to completion. It returns a promise that resolves with a {{domxref("FormData")}} object.</dd> - <dt>{{domxref("Body.json()")}}</dt> - <dd>Takes a {{domxref("Response")}} stream and reads it to completion. It returns a promise that resolves with the result of parsing the body text as {{jsxref("JSON")}}.</dd> - <dt>{{domxref("Body.text()")}}</dt> - <dd>Takes a {{domxref("Response")}} stream and reads it to completion. It returns a promise that resolves with a {{domxref("USVString")}} (text). The response is <em>always</em> decoded using UTF-8.</dd> -</dl> - -<h2 id="Examples">Examples</h2> - -<p>The example below uses a simple fetch call to grab an image and display it in an {{htmlelement("img")}} tag. You'll notice that since we are requesting an image, we need to run {{domxref("Body.blob","Body.blob()")}} ({{domxref("Response")}} implements body) to give the response its correct MIME type.</p> - -<h3 id="HTML_Content">HTML Content</h3> - -<pre class="brush: html"><img class="my-image" src="https://wikipedia.org/static/images/project-logos/frwiki-1.5x.png"> -</pre> - -<h3 id="JS_Content">JS Content</h3> - -<pre class="brush: js">var myImage = document.querySelector('.my-image'); -fetch('https://upload.wikimedia.org/wikipedia/commons/7/77/Delete_key1.jpg') - .then(res => res.blob()) - .then(res => { - var objectURL = URL.createObjectURL(res); - myImage.src = objectURL; -});</pre> - -<p>{{ EmbedLiveSample('Examples', '100%', '250px') }}</p> - -<h2 id="Specifications">Specifications</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Specification</th> - <th scope="col">Status</th> - <th scope="col">Comment</th> - </tr> - <tr> - <td>{{SpecName('Fetch','#body-mixin','Body')}}</td> - <td>{{Spec2('Fetch')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Browser_compatibility">Browser compatibility</h2> - - - -<p>{{Compat("api.Body")}}</p> - -<h2 id="See_also">See also</h2> - -<ul> - <li><a href="/en-US/docs/Web/API/ServiceWorker_API">ServiceWorker API</a></li> - <li><a href="/en-US/docs/Web/HTTP/Access_control_CORS">HTTP access control (CORS)</a></li> - <li><a href="/en-US/docs/Web/HTTP">HTTP</a></li> -</ul> - -<p> </p> diff --git a/files/ru/orphaned/web/api/body/json/index.html b/files/ru/orphaned/web/api/body/json/index.html deleted file mode 100644 index ae8657f9bb..0000000000 --- a/files/ru/orphaned/web/api/body/json/index.html +++ /dev/null @@ -1,75 +0,0 @@ ---- -title: Body.json() -slug: orphaned/Web/API/Body/json -tags: - - Fetch-запрос - - Справка - - метод -translation_of: Web/API/Body/json -original_slug: Web/API/Body/json ---- -<div>{{APIRef("Fetch")}}</div> - -<p>Метод <strong><code>json()</code></strong> , определён на миксине {{domxref("Body")}}, который включён в объектах <a href="https://developer.mozilla.org/ru/docs/Web/API/Request" rel="nofollow" title="Документация об этом ещё не написана; пожалуйста, поспособствуйте её написанию!"><code>Request</code></a> и <a href="https://developer.mozilla.org/ru/docs/Web/API/Response" rel="nofollow" title="Документация об этом ещё не написана; пожалуйста, поспособствуйте её написанию!"><code>Response</code></a>, принимает и читает тело {{domxref("Response")}} stream. Возвращает промис, который, когда ответ будет получен, вызовет колбэк с результатом парсинга тела ответа в {{jsxref("JSON")}} объект.</p> - -<h2 id="Синтаксис">Синтаксис</h2> - -<pre class="brush: js">response.json().then(function(data) { - // do something with your data -});</pre> - -<h3 id="Аргументы">Аргументы</h3> - -<p>Нет.</p> - -<h3 id="Возвращает">Возвращает</h3> - -<p>Промис, который, когда ответ будет получен, вызовет колбэк с результатом парсинга тела ответа в JSON объект. Этим может быть что угодно, что может быть представлено как JSON объект — объект, массив, строка, число...</p> - -<h2 id="Пример">Пример</h2> - -<p>В нашем <a href="https://github.com/mdn/fetch-examples/tree/master/fetch-json">fetch json примере</a> (запустите <a href="http://mdn.github.io/fetch-examples/fetch-json/">fetch json live</a>), мы создаём новый запрос, используя {{domxref("Request.Request")}} конструктор, в последствии мы используем его (запрос) для получения <code>.json</code> файла. Когда fetch запрос будет выполнен, мы прочтём и спарсим данные, используя <code>json()</code>, а далее вставим значения из полученного объекта в list элементы списка для отображения данных по нашему продукту.</p> - -<pre class="brush: js">var myList = document.querySelector('ul'); - -var myRequest = new Request('products.json'); - -fetch(myRequest) - .then(function(response) { return response.json(); }) - .then(function(data) { - for (var i = 0; i < data.products.length; i++) { - var listItem = document.createElement('li'); - listItem.innerHTML = '<strong>' + data.products[i].Name + '</strong> can be found in ' + - data.products[i].Location + - '. Cost: <strong>£' + data.products[i].Price + '</strong>'; - myList.appendChild(listItem); - } - });</pre> - -<h2 id="Спецификации">Спецификации</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Specification</th> - <th scope="col">Status</th> - <th scope="col">Comment</th> - </tr> - <tr> - <td>{{SpecName('Fetch','#dom-body-json','json()')}}</td> - <td>{{Spec2('Fetch')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Совместимость_с_браузерами">Совместимость с браузерами</h2> -<p>{{Compat("api.Body.json")}}</p> - -<h2 id="Смотрите_также">Смотрите также</h2> - -<ul> - <li><a href="/en-US/docs/Web/API/ServiceWorker_API">ServiceWorker API</a></li> - <li><a href="/en-US/docs/Web/HTTP/Access_control_CORS">HTTP access control (CORS)</a></li> - <li><a href="/en-US/docs/Web/HTTP">HTTP</a></li> -</ul> diff --git a/files/ru/orphaned/web/api/childnode/index.html b/files/ru/orphaned/web/api/childnode/index.html deleted file mode 100644 index e150876787..0000000000 --- a/files/ru/orphaned/web/api/childnode/index.html +++ /dev/null @@ -1,78 +0,0 @@ ---- -title: ChildNode -slug: orphaned/Web/API/ChildNode -tags: - - API - - DOM - - Experimental - - Expérimental(2) - - NeedsTranslation - - TopicStub -translation_of: Web/API/ChildNode -original_slug: Web/API/ChildNode ---- -<p>{{APIRef("DOM")}}</p> - -<p>Интерфейс <code><strong>ChildNode</strong></code> содержит методы, специфичные для объектов {{domxref("Node")}}, которые имеют родителя.</p> - -<p><code>ChildNode</code> это просто интерфейс и ни один объект этого типа не может быть создан; он реализуется объектами {{domxref("Element")}}, {{domxref("DocumentType")}} и {{domxref("CharacterData")}}.</p> - -<h2 id="Properties">Properties</h2> - -<p><em>There is neither inherited, nor specific property.</em></p> - -<h2 id="Methods">Methods</h2> - -<p><em>Отсутствуют унаследованные методы.</em></p> - -<dl> - <dt>{{domxref("ChildNode.remove()")}} {{experimental_inline}}</dt> - <dd>Удаляет данный <code>ChildNode</code> из списка потомков его родителя.</dd> - <dt>{{domxref("ChildNode.before()")}} {{experimental_inline}}</dt> - <dd>Inserts a set of {{domxref("Node")}} or {{domxref("DOMString")}} objects in the children list of this <code>ChildNode</code>'s parent, just before this <code>ChildNode</code>. {{domxref("DOMString")}} objects are inserted as equivalent {{domxref("Text")}} nodes.</dd> - <dt>{{domxref("ChildNode.after()")}} {{experimental_inline}}</dt> - <dd>Inserts a set of {{domxref("Node")}} or {{domxref("DOMString")}} objects in the children list of this <code>ChildNode</code>'s parent, just after this <code>ChildNode</code>. {{domxref("DOMString")}} objects are inserted as equivalent {{domxref("Text")}} nodes.</dd> - <dt>{{domxref("ChildNode.replaceWith()")}} {{experimental_inline}}</dt> - <dd>Заменяет <code>ChildNode</code> в списке потомков его родителя набором {{domxref("Node")}} или {{domxref("DOMString")}} объектов. {{domxref("DOMString")}} objects are inserted as equivalent {{domxref("Text")}} nodes.</dd> -</dl> - -<h2 id="Specifications">Specifications</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Specification</th> - <th scope="col">Status</th> - <th scope="col">Comment</th> - </tr> - <tr> - <td>{{SpecName('DOM WHATWG', '#interface-childnode', 'ChildNode')}}</td> - <td>{{Spec2('DOM WHATWG')}}</td> - <td>Интерфейс <code>ElementTraversal</code> разделён на {{domxref("ParentNode")}} и <code>ChildNode</code>. Свойства <code>previousElementSibling</code> и <code>nextElementSibling</code> теперь определены в последнем.<br> - The {{domxref("CharacterData")}} and {{domxref("DocumentType")}} implemented the new interfaces.<br> - Добавлены методы <code>remove()</code>, <code>before()</code>, <code>after()</code> и <code>replaceWith()</code>.</td> - </tr> - <tr> - <td>{{SpecName('Element Traversal', '#interface-elementTraversal', 'ElementTraversal')}}</td> - <td>{{Spec2('Element Traversal')}}</td> - <td>Added the initial definition of its properties to the <code>ElementTraversal</code> pure interface and use it on {{domxref("Element")}}.</td> - </tr> - </tbody> -</table> - -<h2 id="Polyfill">Polyfill</h2> - -<p>External on github: <a href="https://github.com/seznam/JAK/blob/master/lib/polyfills/childNode.js">childNode.js</a></p> - -<h2 id="Browser_compatibility">Browser compatibility</h2> - -<p>{{Compat("api.ChildNode")}}</p> - -<h2 id="See_also">See also</h2> - -<ul> - <li>The {{domxref("ParentNode")}} pure interface.</li> - <li> - <div class="syntaxbox">Object types implementing this pure interface: {{domxref("CharacterData")}}, {{domxref("Element")}}, and {{domxref("DocumentType")}}.</div> - </li> -</ul> diff --git a/files/ru/orphaned/web/api/childnode/remove/index.html b/files/ru/orphaned/web/api/childnode/remove/index.html deleted file mode 100644 index 2f39c5641a..0000000000 --- a/files/ru/orphaned/web/api/childnode/remove/index.html +++ /dev/null @@ -1,91 +0,0 @@ ---- -title: Node.remove() -slug: orphaned/Web/API/ChildNode/remove -translation_of: Web/API/ChildNode/remove -original_slug: Web/API/ChildNode/remove ---- -<p>Метод <code><strong>Node.remove()</strong></code> удаляет узел из дерева DOM</p> - -<p> </p> - -<p>То, что элемент удалён из DOM, ещё не значит, что он удалён совсем! </p> - -<p>Он остался объектом и исчезнет только тогда, когда исчезнут все ссылки на него.</p> - -<p> </p> - -<h2 id="Синтаксис">Синтаксис</h2> - -<pre><em>Node</em>.remove(); -</pre> - -<ul> - <li><strong><code>Node</code></strong> - любой узел DOM</li> -</ul> - -<h2 id="Пример">Пример</h2> - -<h3 id="Использование_remove()">Использование remove()</h3> - -<pre><div id="box"> - <div id="one"></div> - <div id="two"></div> -</div></pre> - -<pre class="brush: js">var elem = document.querySelector("#one"); -elem.remove(); -alert(document.querySelector("#box").innerHTML); //Исчез блок #one -alert(elem); //Но как видите, сам объект ещё жив</pre> - -<h2 id="Полифил">Полифил</h2> - -<p>Можно создать полифил для IE 9 и выше, используя следующий код:</p> - -<pre class="brush: js">(function() { - var arr = [window.Element, window.CharacterData, window.DocumentType]; - var args = []; - - arr.forEach(function (item) { - if (item) { - args.push(item.prototype); - } - }); - - // from:https://github.com/jserz/js_piece/blob/master/DOM/ChildNode/remove()/remove().md - (function (arr) { - arr.forEach(function (item) { - if (item.hasOwnProperty('remove')) { - return; - } - Object.defineProperty(item, 'remove', { - configurable: true, - enumerable: true, - writable: true, - value: function remove() { - this.parentNode.removeChild(this); - } - }); - }); - })(args); -})();</pre> - -<h2 id="Спецификация">Спецификация</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Спецификация</th> - <th scope="col">Статус</th> - <th scope="col">Комментарий</th> - </tr> - <tr> - <td>{{SpecName('DOM WHATWG', '#dom-childnode-remove', 'ChildNode.remove')}}</td> - <td>{{Spec2('DOM WHATWG')}}</td> - <td>Initial definition.</td> - </tr> - </tbody> -</table> - -<h2 id="Поддержка_браузерами">Поддержка браузерами</h2> - -<p>{{Compat("api.ChildNode.remove")}}</p> diff --git a/files/ru/orphaned/web/api/childnode/replacewith/index.html b/files/ru/orphaned/web/api/childnode/replacewith/index.html deleted file mode 100644 index 0ee9091325..0000000000 --- a/files/ru/orphaned/web/api/childnode/replacewith/index.html +++ /dev/null @@ -1,114 +0,0 @@ ---- -title: ChildNode.replaceWith() -slug: orphaned/Web/API/ChildNode/replaceWith -translation_of: Web/API/ChildNode/replaceWith -original_slug: Web/API/ChildNode/replaceWith ---- -<div>{{APIRef("DOM")}}</div> - -<p>Метод <code><strong>ChildNode.replaceWith()</strong></code> заменяет <code>ChildNode</code> в списке детей их родителя множеством {{domxref("Node")}} или {{domxref("DOMString")}} объектов. {{domxref("DOMString")}} объекты вставляются как эквивалент нод {{domxref("Text")}}.</p> - -<h2 id="Синтаксис">Синтаксис</h2> - -<pre class="syntaxbox notranslate">[Throws, Unscopable] -void ChildNode.replaceWith((Node or DOMString)... nodes); -</pre> - -<h3 id="Параметры">Параметры</h3> - -<dl> - <dt><code>nodes</code></dt> - <dd>Множество заменяемых {{domxref("Node")}} или {{domxref("DOMString")}} объектов.</dd> -</dl> - -<h3 id="Исключения">Исключения</h3> - -<ul> - <li>{{domxref("HierarchyRequestError")}}: <span class="VIiyi" lang="ru"><span class="ChMk0b JLqJ4b"><span>Нода не может быть вставлена в указанную точку иерархии.</span></span></span></li> -</ul> - -<h2 id="Примеры">Примеры</h2> - -<h3 id="Использование_replaceWith">Использование <code>replaceWith()</code></h3> - -<pre class="brush: js notranslate">var parent = document.createElement("div"); -var child = document.createElement("p"); -parent.appendChild(child); -var span = document.createElement("span"); - -child.replaceWith(span); - -console.log(parent.outerHTML); -// "<div><span></span></div>" -</pre> - -<h3 id="ChildNode.replaceWith_не_выполним"><code>ChildNode.replaceWith()</code> не выполним</h3> - -<p>Метод <code>replaceWith()</code> не входит в область видимости оператора <code>with</code>. Смотрите {{jsxref("Symbol.unscopables")}} для дополнительной информации.</p> - -<pre class="brush: js notranslate">with(node) { - replaceWith("foo"); -} -// ReferenceError: replaceWith is not defined </pre> - -<h2 id="Полифил">Полифил</h2> - -<p>Вы можете заполнить метод <code>replaceWith()</code> в Internet Explorer 10+ и выше следующим кодом:</p> - -<pre class="brush: js notranslate">function ReplaceWithPolyfill() { - 'use-strict'; // For safari, and IE > 10 - var parent = this.parentNode, i = arguments.length, currentNode; - if (!parent) return; - if (!i) // if there are no arguments - parent.removeChild(this); - while (i--) { // i-- decrements i and returns the value of i before the decrement - currentNode = arguments[i]; - if (typeof currentNode !== 'object'){ - currentNode = this.ownerDocument.createTextNode(currentNode); - } else if (currentNode.parentNode){ - currentNode.parentNode.removeChild(currentNode); - } - // the value of "i" below is after the decrement - if (!i) // if currentNode is the first argument (currentNode === arguments[0]) - parent.replaceChild(currentNode, this); - else // if currentNode isn't the first - parent.insertBefore(currentNode, this.nextSibling); - } -} -if (!Element.prototype.replaceWith) - Element.prototype.replaceWith = ReplaceWithPolyfill; -if (!CharacterData.prototype.replaceWith) - CharacterData.prototype.replaceWith = ReplaceWithPolyfill; -if (!DocumentType.prototype.replaceWith) - DocumentType.prototype.replaceWith = ReplaceWithPolyfill;</pre> - -<h2 id="Спецификация">Спецификация</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Specification</th> - <th scope="col">Status</th> - <th scope="col">Comment</th> - </tr> - <tr> - <td>{{SpecName('DOM WHATWG', '#dom-childnode-replacewith', 'ChildNode.replacewith()')}}</td> - <td>{{Spec2('DOM WHATWG')}}</td> - <td>Initial definition.</td> - </tr> - </tbody> -</table> - -<h2 id="Совместимость_с_браузерами">Совместимость с браузерами</h2> - - - -<p>{{Compat("api.ChildNode.replaceWith")}}</p> - -<h2 id="Смотрите_также">Смотрите также</h2> - -<ul> - <li>{{domxref("ChildNode")}} and {{domxref("ParentNode")}}</li> - <li>{{domxref("Node.replaceChild()")}}</li> - <li>{{domxref("NodeList")}}</li> -</ul> diff --git a/files/ru/orphaned/web/api/document_object_model/events/index.html b/files/ru/orphaned/web/api/document_object_model/events/index.html deleted file mode 100644 index 3bdc87fe96..0000000000 --- a/files/ru/orphaned/web/api/document_object_model/events/index.html +++ /dev/null @@ -1,81 +0,0 @@ ---- -title: Events and the DOM -slug: orphaned/Web/API/Document_Object_Model/Events -translation_of: Web/API/Document_Object_Model/Events -original_slug: Web/API/Document_Object_Model/Events ---- -<p>Вступление</p> - -<h2 id="Вступление">Вступление</h2> - -<p>В этой главе описывается модель событий DOM. <a href="http://www.w3.org/TR/DOM-Level-2-Events/events.html#Events-Event">Топ скрыть</a> Интерфейс сам по себе описано, а также интерфейсы для регистрации событий на узлах в DOM, Также а <a href="/ru/docs/Web/API/EventTarget.addEventListener">обработчики события</a> Главного , Также а Несколько больше Примеры, которые показывают, как Различные интерфейсы связаны друг события Главного с другом.</p> - -<p>Существует отличная диаграмма, которая чётко объясняет события трёх этапов через DOM в проекте <a href="http://www.w3.org/TR/DOM-Level-3-Events/#dom-event-architecture">DOM Level 3 Events</a> .</p> - -<p>Также см. <a href="/ru/docs/DOM/DOM_Reference/Examples#Example_5:_Event_Propagation">Пример 5: Распространение событий</a> в главе «Примеры» для более подробного примера.</p> - -<h2 id="Регистрация_обработчиков_событий">Регистрация обработчиков событий</h2> - -<p>Есть 3 способа регистрации обработанных событий для элемента DOM.</p> - -<h3 id="EventTarget.addEventListener"><a href="/ru/docs/Web/API/EventTarget.addEventListener"><code>EventTarget.addEventListener</code></a></h3> - -<pre class="brush: js">// Предполагая, что myButton является элементом кнопки -myButton.addEventListener ('click', greet, false); -function greet (event) { - // распечатать и посмотреть на объект события - // всегда печатать аргументы в случае пропуска любых других аргументов - console.log ('greet:', arguments); - оповещение («Привет, мир»); -} -</pre> - -<p>Это метод, который вы должны использовать на современных веб-страницах.</p> - -<p>Примечание. Internet Explorer 6-8 не поддерживает этот метод, предлагая аналогичный {{domxref ("EventTarget.attachEvent")}} API. Для кросс-браузерной совместимости используйте одну из множества доступных библиотек JavaScript.</p> - -<p>Дополнительную информацию можно найти на справочной странице {{domxref ("EventTarget.addEventListener")}}.</p> - -<h3 id="Атрибут_HTML"><a href="/ru/docs/Web/Guide/HTML/Event_attributes">Атрибут HTML</a></h3> - -<pre class="brush: html"><button onclick = "alert ('Hello world!')"> -</pre> - -<p>Код JavaScript в атрибуте передаётся объекту Event через <code>event</code>параметр. <a href="http://dev.w3.org/html5/spec/webappapis.html#the-event-handler-processing-algorithm">Возвращаемое значение обрабатывается особым образом, описанным в спецификации HTML</a> .</p> - -<p>Этого пути следует избегать. Это делает разметку больше и менее читаемой. Проблемы содержания / структуры и поведения плохо разделены, что затрудняет поиск ошибки.</p> - -<h3 id="Свойства_элемента_DOM">Свойства элемента DOM</h3> - -<pre class="brush: js">// Предполагая, что myButton является элементом кнопки -<code>myButton.onclick = function(event){alert('Hello world');};</code> -</pre> - -<p>Функция может быть определена для получения <code>event</code>параметра. <a href="http://dev.w3.org/html5/spec/webappapis.html#the-event-handler-processing-algorithm">Возвращаемое значение обрабатывается особым образом, описанным в спецификации HTML</a> .</p> - -<p>Проблема этого метода в том, что для каждого элемента и для каждого события может быть установлен только один обработчик.</p> - -<h2 id="Доступ_к_интерфейсам_событий">Доступ к интерфейсам событий</h2> - -<p>Обработчики событий могут быть присоединены к различным объектам, включая элементы DOM, документ, <a href="/ru/docs/Web/JavaScript/Reference/Global_Objects">объект окна</a> и т. Д. Когда происходит событие, объект события создаётся и последовательно передаётся обработчикам события.</p> - -<p>Интерфейс {{domxref ("Event")}} доступен из функции-обработчика через объект события, переданный в качестве первого аргумента. В следующем простом примере показано, как объект события передаётся в функцию-обработчик события и может использоваться из одной такой функции.</p> - -<pre class="brush: js"><code>function print(evt) {</code> - // параметру evt автоматически назначается объект события - // позаботимся о различиях в console.log и alert - <code>console.log('print:', evt); - alert(evt); -}</code> -// любая функция должна иметь подходящее имя, это то, что называется семантическим -<code>table_el.onclick = print; </code> -</pre> - -<h2 id="Subnav">Subnav</h2> - -<ul> - <li><a href="/ru/docs/Web/API/Document_Object_Model">DOM Ссылка</a></li> - <li><a href="/ru/docs/Web/API/Document_Object_Model/Introduction">Введение в DOM</a></li> - <li><a href="/ru/docs/Web/API/Document_Object_Model/Events">События и DOM</a></li> - <li><a href="/ru/docs/Web/API/Document_Object_Model/Examples">Примеры</a></li> -</ul> diff --git a/files/ru/orphaned/web/api/element/currentstyle/index.html b/files/ru/orphaned/web/api/element/currentstyle/index.html deleted file mode 100644 index f98340d418..0000000000 --- a/files/ru/orphaned/web/api/element/currentstyle/index.html +++ /dev/null @@ -1,51 +0,0 @@ ---- -title: Element.currentStyle -slug: orphaned/Web/API/Element/currentStyle -tags: - - API - - NeedsExample - - Non-standard - - Property -translation_of: Web/API/Element/currentStyle -original_slug: Web/API/Element/currentStyle ---- -<p>{{Non-standard_header}}</p> - -<p class="summary"><span class="seoSummary"><strong><code>Element.currentStyle</code></strong> является собственностью, похожей на стандартизированную {{DOMxRef("window.getComputedStyle()")}} method.</span> Он доступен в старых версиях Microsoft Internet Explorer. Однако, он возвращает единицы, установленные в CSS в то время как <code>window.getComputedStyle()</code>возвращает значения в пикселях.</p> - -<h2 id="Polyfill">Polyfill</h2> - -<div class="note"> -<p>Эта polyfill возвращает значения в пикселях и, скорее всего, будет довольно медленным, так как оно должно называться {{domxref("window.getComputedStyle()")}} каждый раз, когда читается его значение.</p> -</div> - -<pre class="brush: js">/* Любое авторское право посвящено Общественному достоянию. - * http://creativecommons.org/publicdomain/zero/1.0/ */ - -if (!("currentStyle" in Element.prototype)) { - Object.defineProperty(Element.prototype, "currentStyle", { - get: function() { - return window.getComputedStyle(this); - } - }); -} -</pre> - -<h2 id="Спецификации">Спецификации</h2> - -<p>Не входит ни в какие спецификации.</p> - -<p>Microsoft <a href="https://web.archive.org/web/20150629144515/https://msdn.microsoft.com/en-us/library/ms535231(v=vs.85).aspx">had a description on MSDN</a>.</p> - -<h2 id="Browser_Compatibility" name="Browser_Compatibility">Совместимость с браузерами</h2> - -<p>{{Compat("api.Element.currentStyle")}}</p> - -<h2 id="Смотрите_также">Смотрите также</h2> - -<ul> - <li>{{DOMxRef("Element.runtimeStyle")}}</li> - <li>{{DOMxRef("window.getComputedStyle()")}}</li> -</ul> - -<div>{{APIRef("DOM")}}</div> diff --git a/files/ru/orphaned/web/api/elementcssinlinestyle/style/index.html b/files/ru/orphaned/web/api/elementcssinlinestyle/style/index.html deleted file mode 100644 index 72bae0ee34..0000000000 --- a/files/ru/orphaned/web/api/elementcssinlinestyle/style/index.html +++ /dev/null @@ -1,79 +0,0 @@ ---- -title: HTMLElement.style -slug: orphaned/Web/API/ElementCSSInlineStyle/style -tags: - - API - - HTML DOM - - HTMLElement - - NeedsBrowserAgnosticism - - NeedsBrowserCompatibility - - NeedsMarkupWork - - NeedsSpecTable - - Свойство - - Ссылки -translation_of: Web/API/ElementCSSInlineStyle/style -original_slug: Web/API/ElementCSSInlineStyle/style ---- -<h2 id="Кратко">Кратко</h2> - -<div> -<div>{{ APIRef("HTML DOM") }}</div> -</div> - -<p>Свойство<strong> </strong><code><strong>HTMLElement.style</strong></code> используется для получения и установки инлайновых стилей. При получении возвращается объект <a href="/en-US/docs/DOM/CSSStyleDeclaration" title="DOM/CSSStyleDeclaration"><code>CSSStyleDeclaration</code></a> , который содержит список из всех свойств стилей для этого элемента с значениями заданными для атрибутов , что определённы в инлайновом стиле (см. <a href="/en-US/docs/Web/HTML/Global_attributes#style"><code>атрибут</code> стиля</a>) элемента. См. <a href="/en-US/docs/Web/CSS/CSS_Properties_Reference" title="/en-US/docs/Web/CSS/CSS_Properties_Reference">CSS Properties Reference</a> для получения списка CSS свойств применимых вместе со style. </p> - -<h3 id="Настройка_стилей">Настройка стилей</h3> - -<p>Свойство style имеет тот же приоритет (и выше) в каскаде CSS как и прямая декларация стиля через атрибут style, полезен для настройки стиля отдельного специфичного элемента.</p> - -<p>Стили не следует устанавливать непосредственно через свойство <code>style</code> (например <code>elt.style = "color: blue;"</code>), поскольку оно считается доступным только для чтения и атрибут style возвращает объект <code>CSSStyleDeclaration</code> который доступен только для чтения. Вместо этого стили могут быть установлены путём присвоения значений свойствам <code>style</code>. Для добавления определённых стилей для элемента без изменения других свойств стилей предпочтительно использовать отдельные свойства <code>style</code> (например <code>elt.style.color = '...'</code>). -При использовании <br><code>elt.style.cssText = '...'</code> или <code>elt.setAttribute('style','...')</code> устанавливаются стили перезаписывая уже существующие. Обратите внимание, что имена свойств стилей задаются в camel-case а не в kebab-case <code>elt.style.<property></code> (т.е., <code>elt.style.fontSize</code>, а не <code>elt.style.font-size</code>).</p> - -<p>Объявленные стили сбрасываются присваиванием значения <font face="consolas, Liberation Mono, courier, monospace"><span style="background-color: rgba(220, 220, 220, 0.5);">null</span></font>, <br><code>elt.style.color = null</code></p> - -<h2 id="Example" name="Example">Примеры</h2> - -<pre><code>// Устанавливает несколько стилей в одном выражении -elt.style.cssText = "color: blue; border: 1px solid black"; -// Или -elt.setAttribute("style", "color:red; border: 1px solid blue;"); - -// Устанавливает определённый стиль оставляя другие значения стиля нетронутыми -elt.style.color = "blue";</code></pre> - -<h3 id="Получение_стиль-информации">Получение стиль-информации</h3> - -<p>Свойство <code>style</code> в основном не имеет пользы в части информации о стиле элемента, оно только олицетворяет собой набор CSS деклараций атрибутов style элемента, а не тех которые проистекают из стиль-правил откуда-либо ещё, таких как стилевые правила раздела {{HTMLElement("head")}}, или внешней таблицы стилей. Для получения значений всех CSS свойств элемента вы должны использовать вместо этого {{domxref("window.getComputedStyle()")}}.</p> - -<div style="overflow: hidden;"> -<pre class="brush:js">var div = document.getElementById("div1"); -div.style.marginTop = ".25in";</pre> -</div> - -<p>Следующий код показывает имена всех свойств стиля, значений, заданных явно для элемента elt и унаследованных "рассчитанных" значений:</p> - -<pre class="brush:js">var elt = document.getElementById("elementIdHere"); -var out = ""; -var st = elt.style; -var cs = window.getComputedStyle(elt, null); -for (x in st) { - out += " " + x + " = '" + st[x] + "' > '" + cs[x] + "'\n"; -}</pre> - -<h2 id="Specification" name="Specification">Спецификация</h2> - -<p><a href="http://www.w3.org/TR/DOM-Level-2-Style/css.html#CSS-ElementCSSInlineStyle">DOM Level 2 Style: ElementCSSInlineStyle.style</a></p> - -<p><a href="https://www.w3.org/TR/cssom-1/#the-elementcssinlinestyle-interface">CSSOM: ElementCSSInlineStyle</a></p> - -<h2 id="Совместимость">Совместимость</h2> - - - -<p>{{Compat("api.HTMLElement.style")}}</p> - -<h2 id="Смотрите_также">Смотрите также</h2> - -<ul> - <li><a href="/en-US/docs/DOM/Using_dynamic_styling_information" title="DOM/Using dynamic styling information">Использование динамической стиль-информации</a></li> -</ul> diff --git a/files/ru/orphaned/web/api/htmlhyperlinkelementutils/index.html b/files/ru/orphaned/web/api/htmlhyperlinkelementutils/index.html deleted file mode 100644 index 2ee02cdbfd..0000000000 --- a/files/ru/orphaned/web/api/htmlhyperlinkelementutils/index.html +++ /dev/null @@ -1,179 +0,0 @@ ---- -title: HTMLHyperlinkElementUtils -slug: orphaned/Web/API/HTMLHyperlinkElementUtils -tags: - - API - - Experimental - - Mixin - - NeedsTranslation - - TopicStub - - URL API -translation_of: Web/API/HTMLHyperlinkElementUtils -original_slug: Web/API/HTMLHyperlinkElementUtils ---- -<p>{{ApiRef("URL API")}}{{SeeCompatTable}}</p> - -<p>The <strong><code>HTMLHyperlinkElementUtils</code></strong> mixin defines utility methods and properties to work with {{domxref("HTMLAnchorElement")}} and {{domxref("HTMLAreaElement")}}. These utilities allow to deal with common features like URLs.</p> - -<p>There are no objects of this type, but several objects {{domxref("HTMLAnchorElement")}} and {{domxref("HTMLAreaElement")}} implement it.</p> - -<h2 id="Properties">Properties</h2> - -<p><em>This interface doesn't inherit any property.</em></p> - -<dl> - <dt>{{domxref("HTMLHyperlinkElementUtils.href")}}</dt> - <dd>Is a {{domxref("USVString")}} containing the whole URL.</dd> - <dt>{{domxref("HTMLHyperlinkElementUtils.protocol")}}</dt> - <dd>Is a {{domxref("USVString")}} containing the protocol scheme of the URL, including the final <code>':'</code>.</dd> - <dt>{{domxref("HTMLHyperlinkElementUtils.host")}}</dt> - <dd>Is a {{domxref("USVString")}} containing the host, that is the <em>hostname</em>, and then, if the <em>port</em> of the URL is not empty (which can happen because it was not specified or because it was specified to be the default port of the URL's scheme), a <code>':'</code>, and the <em>port</em> of the URL.</dd> - <dt>{{domxref("HTMLHyperlinkElementUtils.hostname")}}</dt> - <dd>Is a {{domxref("USVString")}} containing the domain of the URL.</dd> - <dt>{{domxref("HTMLHyperlinkElementUtils.port")}}</dt> - <dd>Is a {{domxref("USVString")}} containing the port number of the URL.</dd> - <dt>{{domxref("HTMLHyperlinkElementUtils.pathname")}}</dt> - <dd>Is a {{domxref("USVString")}} containing an initial <code>'/'</code> followed by the path of the URL.</dd> - <dt>{{domxref("HTMLHyperlinkElementUtils.search")}}</dt> - <dd>Is a {{domxref("USVString")}} containing a <code>'?'</code> followed by the parameters of the URL.</dd> - <dt>{{domxref("HTMLHyperlinkElementUtils.hash")}}</dt> - <dd>Is a {{domxref("USVString")}} containing a <code>'#'</code> followed by the fragment identifier of the URL.</dd> - <dt>{{domxref("HTMLHyperlinkElementUtils.username")}}</dt> - <dd>Is a {{domxref("USVString")}} containing the username specified before the domain name.</dd> - <dt>{{domxref("HTMLHyperlinkElementUtils.password")}}</dt> - <dd>Is a {{domxref("USVString")}} containing the password specified before the domain name.</dd> - <dt>{{domxref("HTMLHyperlinkElementUtils.origin")}} {{readonlyInline}}</dt> - <dd>Returns a {{domxref("USVString")}} containing the origin of the URL, that is its scheme, its domain and its port.</dd> -</dl> - -<h2 id="Methods">Methods</h2> - -<p><em>This interface doesn't inherit any method.</em></p> - -<dl> - <dt>{{domxref("HTMLHyperlinkElementUtils.toString()")}}</dt> - <dd>Returns a {{domxref("DOMString")}} containing the whole URL. It is a synonym for {{domxref("HTMLHyperlinkElementUtils.href")}}, though it can't be used to modify the value.</dd> -</dl> - -<h2 id="Specifications">Specifications</h2> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Specification</th> - <th scope="col">Status</th> - <th scope="col">Comment</th> - </tr> - </thead> - <tbody> - <tr> - <td>{{SpecName('HTML WHATWG', '#htmlhyperlinkelementutils', 'HTMLHyperlinkElementUtils')}}</td> - <td>{{Spec2('HTML WHATWG')}}</td> - <td>Initial definition</td> - </tr> - </tbody> -</table> - -<h2 id="Browser_compatibility">Browser compatibility</h2> - -<p>{{ CompatibilityTable() }}</p> - -<div id="compat-desktop"> -<table class="compat-table"> - <tbody> - <tr> - <th>Feature</th> - <th>Chrome</th> - <th>Firefox (Gecko)</th> - <th>Internet Explorer</th> - <th>Opera</th> - <th>Safari</th> - </tr> - <tr> - <td>Basic support</td> - <td>{{CompatNo}} [1]</td> - <td>{{CompatGeckoDesktop("22")}} [2]</td> - <td>{{CompatNo}} [1]</td> - <td>{{CompatNo}} [1]</td> - <td>{{CompatNo}} [1]</td> - </tr> - <tr> - <td><code>username</code> and <code>password</code></td> - <td>{{CompatUnknown}}</td> - <td>{{CompatGeckoDesktop("26")}} [2]</td> - <td>{{CompatNo}}</td> - <td>{{CompatUnknown}}</td> - <td>{{CompatUnknown}}</td> - </tr> - <tr> - <td><code>origin </code></td> - <td>{{CompatVersionUnknown()}}</td> - <td>{{CompatGeckoDesktop("26")}} [2]</td> - <td>{{CompatUnknown}}</td> - <td>{{CompatUnknown}}</td> - <td>{{CompatUnknown}}</td> - </tr> - </tbody> -</table> -</div> - -<div id="compat-mobile"> -<table class="compat-table"> - <tbody> - <tr> - <th>Feature</th> - <th>Android</th> - <th>Chrome for Android</th> - <th>Firefox Mobile (Gecko)</th> - <th>IE Mobile</th> - <th>Opera Mobile</th> - <th>Safari Mobile</th> - </tr> - <tr> - <td>Basic support</td> - <td>{{CompatNo}} [1]</td> - <td>{{CompatNo}} [1]</td> - <td>{{CompatGeckoMobile("22")}} [2]</td> - <td>{{CompatNo}} [1]</td> - <td>{{CompatNo}} [1]</td> - <td>{{CompatNo}} [1]</td> - </tr> - <tr> - <td><code>username</code> and <code>password</code></td> - <td>{{CompatUnknown}}</td> - <td>{{CompatUnknown}}</td> - <td>{{CompatGeckoMobile("26")}} [2]</td> - <td>{{CompatNo}}</td> - <td>{{CompatUnknown}}</td> - <td>{{CompatUnknown}}</td> - </tr> - <tr> - <td><code>origin </code></td> - <td>{{CompatUnknown}}</td> - <td>{{CompatUnknown}}</td> - <td>{{CompatGeckoMobile("26")}} [2]</td> - <td>{{CompatUnknown}}</td> - <td>{{CompatUnknown}}</td> - <td>{{CompatUnknown}}</td> - </tr> - </tbody> -</table> -</div> - -<p>[1] Though not grouped in a single abstract interface, these methods are directly available on the interfaces that implement it, if this interface is supported.</p> - -<p>[2] This mixin was called <code>URLUtils</code> before Firefox 45, and was also implemented to other by other interfaces, like {{domxref("Location")}}. From Firefox 45, the other interfaces implements their own version of the properties and methods they need.</p> - -<h2 id="See_also">See also</h2> - -<ul> - <li>Interfaces implementing this one: {{domxref("HTMLAnchorElement")}}, {{domxref("HTMLAreaElement")}} - <dl><br> - <dd> </dd> - </dl> - </li> -</ul> - -<dl> - <dd> </dd> -</dl> diff --git a/files/ru/orphaned/web/api/htmlorforeignelement/dataset/index.html b/files/ru/orphaned/web/api/htmlorforeignelement/dataset/index.html deleted file mode 100644 index a0e0c95bcd..0000000000 --- a/files/ru/orphaned/web/api/htmlorforeignelement/dataset/index.html +++ /dev/null @@ -1,115 +0,0 @@ ---- -title: HTMLElement.dataset -slug: orphaned/Web/API/HTMLOrForeignElement/dataset -translation_of: Web/API/HTMLOrForeignElement/dataset -original_slug: Web/API/HTMLOrForeignElement/dataset ---- -<p>{{ APIRef("HTML DOM") }}</p> - -<p>Свойство <code><strong>HTMLElement.dataset</strong></code> предоставляет доступ как для чтения, так и для изменения всех пользовательских дата-атрибутов <a href="/en/HTML/Global_attributes#attr-data-*" title="https://developer.mozilla.org/en/HTML/Global_attributes#attr-data-*">custom data attributes</a> (<code>data-*</code>) , установленных у элемента. Это <a href="/en/DOM/DOMStringMap" title="en/DOM/DOMStringMap">map of DOMString</a>, одна запись для каждого пользовательского атрибута данных. Обратите внимание, свойство <code><strong>dataset</strong></code> доступно только для чтения. Для записи должны использоваться его "свойства", которые представлены data-атрибутами. Также обратите внимание, что HTML <code><strong>data-</strong></code><em>атрибут</em> и соответствующий ему DOM-<code>dataset.</code><em>property</em> не имеют одно и то же имя, но они всегда похожи:</p> - -<ul> - <li>Имя пользовательского дата атрибута в HTML начинается с "<code>data-</code>". Оно может состоять из букв, цифр и символов: дефис-минус (<code>-</code>, <code>U+002D</code>), точка (<code>.</code>), двоеточие (<code>:</code>), подчёркивание (<code>_</code>). Имя НЕ МОЖЕТ включать в себя заглавные буквы.</li> - <li>Имя пользовательского дата-атрибута в Javascript — это имя того же атрибута в HTML, но с использованием нотации camelCase и без дефисов, точек и т.д.<br> - <br> - В дополнение к приведённой ниже информации вы найдёте руководство по использованию HTML data-атрибутов в нашей статье <a href="/en-US/docs/Learn/HTML/Howto/Use_data_attributes">Использование data-атрибутов</a>.</li> -</ul> - -<h3 id="Преобразование_имён">Преобразование имён</h3> - -<p><code>dash-style</code> в <code>camelCase</code>: имя пользовательского дата-атрибута преобразуется в ключ для {{ domxref("DOMStringMap") }} по следующим правилам:</p> - -<ul> - <li>удаляется префикс <code>data-</code> (вместе с дефисом);</li> - <li>дефисы (<code>U+002D</code>) со следующими за ними <span style="line-height: 1.5;">ASCII-символами </span><code>a</code><span style="line-height: 1.5;">-</span><code>z</code><span style="line-height: 1.5;"> в нижнем регистре: черта удаляется, а символ преобразуется в верхний регистр;</span></li> - <li>остальные символы (включая дефисы) остаются без изменений.</li> -</ul> - -<p><code>camelCase</code> в <code>dash-style</code>: обратное преобразование ключа в имя атрибута производится по следующим правилам:</p> - -<ul> - <li>Ограничение: сразу после дефиса не может быть ASCII-символа <code>a</code>-<code>z</code> в нижнем регистре (до преобразования);</li> - <li>добавляется префикс <code>data-</code>;</li> - <li>все ASCII-символы <code>A</code>-<code>Z</code> в верхнем регистре заменяются на дефис с символом в нижнем регистре;</li> - <li>остальные символы остаются без изменений.</li> -</ul> - -<p>Ограничение в правилах гарантирует, что эти два преобразования являются обратными друг другу.</p> - -<p>Например, атрибуту <code>data-abc-def</code> соответствует ключ <code>abcDef</code>.</p> - -<h3 id="Доступ_к_значениям">Доступ к значениям</h3> - -<ul> - <li>Атрибуты можно устанавливать и считывать по имени в camelCase (ключ) как свойство объекта dataset, например <em>element.</em>dataset.<em>keyname</em></li> - <li>Атрибуты также можно устанавливать и считывать с использованием доступа к свойствам объекта через квадратные скобки, например <em>element.</em>dataset[<em>keyname</em>]</li> - <li><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/in">Оператор in</a> может быть использован для проверки существования атрибута.</li> -</ul> - -<h2 id="Синтаксис">Синтаксис</h2> - -<ul> - <li><em>string</em> = <em>element</em>.<strong>dataset</strong>.<em>camelCasedName</em>;</li> - <li><em>element.</em><strong>dataset</strong>.<em>camelCasedName</em> = <em>string</em>;</li> - <br> - <li><em>string</em> = <em>element</em>.<strong>dataset</strong>[<em>camelCasedName</em>];</li> - <li><em>element</em>.<strong>dataset</strong>[<em>camelCasedName</em>] = <em>string</em>;</li> - <br> - <li><em>Custom data attributes can also be set directly on HTML elements, but attribute names must use the data- syntax above. </em></li> -</ul> - -<h2 id="Примеры">Примеры</h2> - -<pre class="brush: js notranslate"><div id="user" data-id="1234567890" data-user="johndoe" data-date-of-birth>John Doe</div> - -let el = document.querySelector('#user'); - -// el.id == 'user' -// el.dataset.id === '1234567890' -// el.dataset.user === 'johndoe' -// el.dataset.dateOfBirth === '' - -el.dataset.dateOfBirth = '1960-10-03'; // set the DOB. - -// 'someDataAttr' in el.dataset === false -el.dataset.someDataAttr = 'mydata'; -// 'someDataAttr' in el.dataset === true -</pre> - -<h2 id="Specifications">Specifications</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Specification</th> - <th scope="col">Status</th> - <th scope="col">Comment</th> - </tr> - <tr> - <td>{{SpecName('HTML WHATWG', "dom.html#dom-dataset", "HTMLElement.dataset")}}</td> - <td>{{Spec2('HTML WHATWG')}}</td> - <td>No change from latest snapshot, {{SpecName('HTML5.1')}}</td> - </tr> - <tr> - <td>{{SpecName('HTML5.1', "dom.html#dom-dataset", "HTMLElement.dataset")}}</td> - <td>{{Spec2('HTML5.1')}}</td> - <td>Snapshot of {{SpecName('HTML WHATWG')}}, no change from {{SpecName('HTML5 W3C')}}</td> - </tr> - <tr> - <td>{{SpecName('HTML5 W3C', "dom.html#dom-dataset", "HTMLElement.dataset")}}</td> - <td>{{Spec2('HTML5 W3C')}}</td> - <td>Snapshot of {{SpecName('HTML WHATWG')}}, initial definition.</td> - </tr> - </tbody> -</table> - -<h2 id="Совместимость_с_браузерами">Совместимость с браузерами</h2> - -<p>{{Compat("api.HTMLElement.dataset")}}</p> - -<h2 id="Смотрите_также">Смотрите также</h2> - -<ul> - <li>The HTML <a href="/en-US/docs/Web/HTML/Global_attributes/data-*"><strong>data-*</strong></a> class of global attributes.</li> - <li><a href="/en-US/docs/Learn/HTML/Howto/Use_data_attributes">Using data attributes</a></li> -</ul> diff --git a/files/ru/orphaned/web/api/htmlorforeignelement/tabindex/index.html b/files/ru/orphaned/web/api/htmlorforeignelement/tabindex/index.html deleted file mode 100644 index adc75c26ba..0000000000 --- a/files/ru/orphaned/web/api/htmlorforeignelement/tabindex/index.html +++ /dev/null @@ -1,87 +0,0 @@ ---- -title: HTMLElement.tabIndex -slug: orphaned/Web/API/HTMLOrForeignElement/tabIndex -translation_of: Web/API/HTMLOrForeignElement/tabIndex -original_slug: Web/API/HTMLOrForeignElement/tabIndex ---- -<div> -<div>{{ APIRef("HTML DOM") }}</div> -</div> - -<p>Свойство <code><strong>HTMLElement.tabIndex </strong>предоставляет</code> возможность вызова по кнопке Tab текущего элемента.</p> - -<div> -<div>Вызов по табуляции происходит в следующем порядке:</div> - -<ol> - <li><span style="font-size: 14px; line-height: 1.5;">элементы с положительным tabIndex. <span style="font-size: 14px; line-height: 1.5;">Элементы, имеющие одинаковое значение tabIndex вызываются в порядке появления в коде. <span style="font-size: 14px; line-height: 1.5;">Переход осуществляется от меньших tabIndex до больших tabIndex. </span></span></span></li> - <li><span style="font-size: 14px; line-height: 1.5;">Элементы, которые не поддерживают атрибут tabIndex или поддерживают но tabIndex установлен в "0", выбираются по Tab в порядке их появления в коде.</span></li> -</ol> - -<div>Элементы для которых установлена блокировка (disabled) не могут быть выбраны кнопкой Tab и не могут быть в фокусе.</div> - -<div> </div> - -<div><span style="font-size: 14px; line-height: 1.5;">Значения могут начинаться с любого числа, могут быть отрицательными и могут быть непоследовательными, однако разные браузеры могут неправильно сработать при очень больших значениях.</span></div> - -<div> </div> -</div> - -<h2 id="Syntax" name="Syntax">Синтаксис</h2> - -<pre class="syntaxbox"><em>elt</em>.tabIndex = <em>index</em>; -var <em>index</em> = <em>elt</em>.tabIndex; -</pre> - -<ul> - <li><em><var>index</var></em> - целое число</li> -</ul> - -<h2 id="Example" name="Example">Пример</h2> - -<pre class="brush:js">var b1 = document.getElementById("button1"); - -b1.tabIndex = 1; -</pre> - -<h2 id="Specification" name="Specification">Спецификация</h2> - -<p> </p> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Спецификация</th> - <th scope="col">Статус</th> - <th scope="col">Комментарии</th> - </tr> - </thead> - <tbody> - <tr> - <td>{{SpecName('HTML WHATWG', '#dom-tabindex', 'tabindex')}}</td> - <td>{{Spec2('HTML WHATWG')}}</td> - <td>Не было изменений с {{SpecName('DOM2 HTML')}}.</td> - </tr> - <tr> - <td>{{SpecName('DOM2 HTML', 'html.html#ID-40676705', 'tabindex')}}</td> - <td>{{Spec2('DOM2 HTML')}}</td> - <td>Не было изменений с {{SpecName('DOM1')}}.</td> - </tr> - <tr> - <td>{{SpecName('DOM1', 'level-one-html.html#ID-40676705', 'tabindex')}}</td> - <td>{{Spec2('DOM1')}}</td> - <td>Начальное определение</td> - </tr> - </tbody> -</table> - -<h2 id="Поддержка_в_браузерах">Поддержка в браузерах</h2> - -<p>{{Compat("api.HTMLElement.tabIndex")}}</p> - -<h2 id="Смотрите_также">Смотрите также</h2> - -<ul> - <li><a href="/en-US/docs/Accessibility/Keyboard-navigable_JavaScript_widgets" title="Accessibility/Keyboard-navigable_JavaScript_widgets">Accessibility of keyboard-navigable JavaScript widgets</a></li> - <li>The HTML <a href="/en-US/docs/Web/HTML/Global_attributes/tabindex"><strong>tabindex</strong></a> глобальный атрибут.</li> -</ul> diff --git a/files/ru/orphaned/web/api/indexeddb_api/basic_concepts_behind_indexeddb/index.html b/files/ru/orphaned/web/api/indexeddb_api/basic_concepts_behind_indexeddb/index.html deleted file mode 100644 index 0e9312398c..0000000000 --- a/files/ru/orphaned/web/api/indexeddb_api/basic_concepts_behind_indexeddb/index.html +++ /dev/null @@ -1,214 +0,0 @@ ---- -title: Basic concepts -slug: orphaned/Web/API/IndexedDB_API/Basic_Concepts_Behind_IndexedDB -translation_of: Web/API/IndexedDB_API/Basic_Concepts_Behind_IndexedDB -original_slug: Web/API/IndexedDB_API/Basic_Concepts_Behind_IndexedDB ---- -<p>{{DefaultAPISidebar("IndexedDB")}}</p> - -<div class="summary"> -<p><strong>IndexedDB</strong> обеспечивает возможность постоянного хранения данных посредством браузера пользователя. Поскольку это наделяет создаваемые web-приложения с расширенными возможностями независимостью от доступа к сети, такие приложения получают возможность работы как online, так и offline. <strong>IndexedDB</strong> полезна для приложений, хранящих большое количество данных (например, каталог DVD библиотеки проката) и не нуждающихся в постоянном подключении к Интернету (например, почтовые клиенты, перечни запланированного to-do и заметки на память).</p> -</div> - -<h2 id="Об_этом_документе">Об этом документе</h2> - -<p>В этом введении рассматриваются основные концепции и термины в IndexedDB. Оно содержит общую картину и объясняет ключевые понятия.</p> - -<p>Оно может стать полезным для:</p> - -<ul> - <li>Общего понимания дизайна и структуры IndexedDB, смотри <a href="#concepts">Big Concepts</a>.</li> - <li>Изучения большего о терминах в IndexedDB, смотри секцию <a href="#definitions">Definitions</a>.</li> - <li>Детального руководства как использовать API, смотри <a href="/en-US/docs/Web/API/IndexedDB_API/Using_IndexedDB" title="en/IndexedDB/IndexedDB primer">Using IndexedDB</a>.</li> - <li>Рекомендованной документации по IndexedDB API, ссылаясь на основные статьи по <a href="/en-US/docs/Web/API/IndexedDB_API">IndexedDB API</a> и его подстраницы, описывающие, какие типы объектов используются в IndexedDB.</li> - <li>Получения больше информации о том, как браузер управляет сохранением данных в фоновом режиме, читай <a href="/en-US/docs/Web/API/IndexedDB_API/Browser_storage_limits_and_eviction_criteria">Browser storage limits and eviction criteria</a>.</li> -</ul> - -<h2 id="Обзор_IndexedDB">Обзор IndexedDB</h2> - -<p>IndexedDB позволяет сохранять и извлекать объекты, проиндексированные с помощью "ключа". Все манипуляции над базой данных происходят при помощи транзакций. Как и большинство решений для web-хранилищ, IndexedDB следует <a class="external" href="http://www.w3.org/Security/wiki/Same_Origin_Policy" title="http://www.w3.org/Security/wiki/Same_Origin_Policy">same-origin policy</a>. Поэтому, если получить доступ к сохранённым данным в пределах домена можно, то вне его - нет.</p> - -<p>IndexedDB - <a href="/en/IndexedDB#Asynchronous_API" title="https://developer.mozilla.org/en/IndexedDB#Asynchronous_API">асинхронное</a> API, которое может быть использовано в большинстве контекстов, включая <a href="/ru/docs/Web/API/Web_Workers_API/Using_web_workers" title="https://developer.mozilla.org/En/Using_web_workers">Web Workers</a>. Раньше оно включало <a href="/en/IndexedDB#Synchronous_API" title="https://developer.mozilla.org/en/IndexedDB#Synchronous_API">синхронную</a> версию, для использования в web workers, но это было удалено из спецификации в связи с недостатком интереса внутри web-сообщества.</p> - -<p>Существует так же конкурирующая с IndexedDB спецификация, WebSQL Database, но W3C исключила её 18 ноября 2010. Хотя IndexedDB и WebSQL оба являются решением для хранилищ, они предоставляют различный функционал. WebSQL Database - реляционная система доступа к базам данных, когда IndexedDB - система индексированной таблицы.</p> - -<h2 id="concepts" name="concepts">Big concepts</h2> - -<p>Если у вас есть опыт работы с другими типами баз данных, то вы можете быть сбиты с толку в процессе работы с IndexedDB. Поэтому имейте в виду следующие важные понятия:</p> - -<ul> - <li> - <p><strong>IndexedDB databases store key-value pairs.</strong> The values can be complex structured objects, and keys can be properties of those objects. You can create indexes that use any property of the objects for quick searching, as well as sorted enumeration. Keys can be binary objects.</p> - </li> - <li> - <p><strong>IndexedDB is built on a transactional database model</strong>. Everything you do in IndexedDB always happens in the context of a <a href="#gloss_transaction">transaction</a>. The IndexedDB API provides lots of objects that represent indexes, tables, cursors, and so on, but each of these is tied to a particular transaction. Thus, you cannot execute commands or open cursors outside of a transaction. Transactions have a well-defined lifetime, so attempting to use a transaction after it has completed throws exceptions. Also, transactions auto-commit and cannot be committed manually.</p> - - <p>This transaction model is really useful when you consider what might happen if a user opened two instances of your web app in two different tabs simultaneously. Without transactional operations, the two instances could interfere with each other's modifications. If you are not familiar with transactions in a database, read the <a class="link-https" href="https://en.wikipedia.org/wiki/Database_transaction" title="https://secure.wikimedia.org/wikipedia/en/wiki/Database_transaction">Wikipedia article on transactions</a>. Also see <a href="#gloss_transaction">transaction</a> under the Definitions section.</p> - </li> - <li> - <p><strong>The IndexedDB API is mostly asynchronous.</strong> The API doesn't give you data by returning values; instead, you have to pass a callback function. You don't "store" a value into the database, or "retrieve" a value out of the database through synchronous means. Instead, you "request" that a database operation happens. You get notified by a DOM event when the operation finishes, and the type of event you get lets you know if the operation succeeded or failed. This sounds a little complicated at first, but there are sanity measures baked in. It's not that different from the way that <a href="/en/DOM/XMLHttpRequest" title="https://developer.mozilla.org/en/xmlhttprequest">XMLHttpRequest</a> works.</p> - </li> - <li> - <p><strong>IndexedDB uses a lot of requests. </strong>Requests are objects that receive the success or failure DOM events that were mentioned previously. They have <code style="font-size: 14px;">onsuccess</code> and <code style="font-size: 14px;">onerror</code> properties, and you can call <code style="font-size: 14px;">addEventListener()</code> and <code style="font-size: 14px;">removeEventListener()</code> on them. They also have <code style="font-size: 14px;">readyState</code>, <code style="font-size: 14px;">result</code>, and <code style="font-size: 14px;">errorCode</code> properties that tell you the status of the request. The <code style="font-size: 14px;">result</code> property is particularly magical, as it can be many different things, depending on how the request was generated (for example, an <code style="font-size: 14px;">IDBCursor</code> instance, or the key for a value that you just inserted into the database).</p> - </li> - <li> - <p><strong>IndexedDB uses DOM events to notify you when results are available.</strong> DOM events always have a <code style="font-size: 14px;">type</code> property (in IndexedDB, it is most commonly set to <code style="font-size: 14px;">"success"</code> or <code style="font-size: 14px;">"error"</code>). DOM events also have a <code style="font-size: 14px;">target</code> property that indicates where the event is headed. In most cases, the <code style="font-size: 14px;">target</code> of an event is the <code style="font-size: 14px;">IDBRequest</code> object that was generated as a result of doing some database operation. Success events don't bubble up and they can't be canceled. Error events, on the other hand, do bubble, and can be cancelled. This is quite important, as error events abort whatever transactions they're running in, unless they are cancelled.</p> - </li> - <li> - <p><strong>IndexedDB is object-oriented.</strong> IndexedDB is not a relational database with tables representing collections of rows and columns. This important and fundamental difference affects the way you design and build your applications.</p> - - <p>In a traditional relational data store, you would have a table that stores a collection of rows of data and columns of named types of data. IndexedDB, on the other hand, requires you to create an object store for a type of data and simply persist JavaScript objects to that store. Each object store can have a collection of indexes that makes it efficient to query and iterate across. If you are not familiar with object-oriented database management systems, read the <a class="external" href="https://en.wikipedia.org/wiki/Object_database" title="http://en.wikipedia.org/wiki/Object_database">Wikipedia article on object database</a>.</p> - </li> - <li> - <p><strong>IndexedDB does not use </strong><strong>Structured Query Language (<abbr>SQL</abbr>).</strong> It uses queries on an index that produces a cursor, which you use to iterate across the result set. If you are not familiar with NoSQL systems, read the <a class="external" href="https://en.wikipedia.org/wiki/NoSQL" title="http://en.wikipedia.org/wiki/NoSQL">Wikipedia article on NoSQL</a>.</p> - </li> - <li> - <p><a name="origin"><strong>IndexedDB adheres to a same-origin policy</strong></a>. An origin is the domain, application layer protocol, and port of a URL of the document where the script is being executed. Each origin has its own associated set of databases. Every database has a name that identifies it within an origin.</p> - - <p>The security boundary imposed on IndexedDB prevents applications from accessing data with a different origin. For example, while an app or a page in <a class="external" href="http://www.example.com/app/" rel="freelink">http://www.example.com/app/</a> can retrieve data from <a class="external" href="http://www.example.com/dir/" rel="freelink">http://www.example.com/dir/</a>, because they have the same origin, it cannot retrieve data from <a class="external" href="http://www.example.com:8080/dir/" rel="freelink">http://www.example.com:8080/dir/</a> (different port) or <a class="link-https" href="https://www.example.com/dir/" rel="freelink">https://www.example.com/dir/</a> (different protocol), because they have different origins.</p> - - <div class="note"><strong>Note</strong>: Third party window content (e.g. {{htmlelement("iframe")}} content) can access the IndexedDB store for the origin it is embedded into, unless the browser is set to <a href="https://support.mozilla.org/en-US/kb/disable-third-party-cookies">never accept third party cookies</a> (see {{bug("1147821")}}.)</div> - </li> -</ul> - -<h2 id="definitions" name="definitions">Definitions</h2> - -<p>This section defines and explains terms used in the IndexedDB API.</p> - -<h3 id="database" name="database">Database</h3> - -<dl> - <dt><a name="gloss_database">database</a></dt> - <dd>A repository of information, typically comprising one or more <a href="#gloss_object_store" title="#gloss_object_store"><em>object stores</em></a>. Each database must have the following: - <ul> - <li>Name. This identifies the database within a specific origin and stays constant throughout its lifetime. The name can be any string value (including an empty string).</li> - <li> - <p>Current <a href="#gloss_version"><em>version</em></a>. When a database is first created, its version is the integer 1 if not specified otherwise. Each database can have only one version at any given time.</p> - </li> - </ul> - </dd> - <dt><a name="durable">durable</a></dt> - <dd> - <p>In Firefox, IndexedDB used to be <strong>durable</strong>, meaning that in a readwrite transaction {{domxref("IDBTransaction.oncomplete")}} was fired only when all data was guaranteed to have been flushed to disk.</p> - - <p>As of Firefox 40, IndexedDB transactions have relaxed durability guarantees to increase performance (see {{Bug("1112702")}}), which is the same behaviour as other IndexedDB-supporting browsers. In this case the {{Event("complete")}} event is fired after the OS has been told to write the data but potentially before that data has actually been flushed to disk. The event may thus be delivered quicker than before, however, there exists a small chance that the entire transaction will be lost if the OS crashes or there is a loss of system power before the data is flushed to disk. Since such catastrophic events are rare, most consumers should not need to concern themselves further.</p> - - <div class="note"> - <p><strong>Note</strong>: In Firefox, if you wish to ensure durability for some reason (e.g. you're storing critical data that cannot be recomputed later) you can force a transaction to flush to disk before delivering the <code>complete</code> event by creating a transaction using the experimental (non-standard) <code>readwriteflush</code> mode (see {{domxref("IDBDatabase.transaction")}}.) This is currently experimental, and can only be used if the <code>dom.indexedDB.experimental</code> pref is set to <code>true</code> in <code>about:config</code>.</p> - </div> - </dd> - <dt><a name="gloss_object_store">object store</a></dt> - <dd> - <p>The mechanism by which data is stored in the database. The object store persistently holds records, which are key-value pairs. Records within an object store are sorted according to the <em><a href="#gloss_key">keys</a></em> in an ascending order.</p> - - <p>Every object store must have a name that is unique within its database. The object store can optionally have a <em><a href="#gloss_keygenerator">key generator</a></em> and a <em><a href="#gloss_keypath">key path</a></em>. If the object store has a key path, it is using <em><a href="#gloss_inline_key">in-line keys</a></em>; otherwise, it is using <em><a href="#gloss_outofline_key">out-of-line keys</a></em>.</p> - - <p>For the reference documentation on object store, see {{domxref("IDBObjectStore")}}.</p> - </dd> - <dt><a name="gloss_version">version</a></dt> - <dd>When a database is first created, its version is the integer 1. Each database has one version at a time; a database can't exist in multiple versions at once. The only way to change the version is by opening it with a greater version than the current one. This will start a <a href="/en-US/docs/Web/API/IDBVersionChangeRequest"><code>versionchange</code></a> <em>transaction</em> and fire an <a href="/en-US/docs/Web/Reference/Events/upgradeneeded_indexedDB"><code>upgradeneeded</code></a> event. The only place where the schema of the database can be updated is inside the handler of that event.</dd> - <dd>Note: This definition describes the <a class="external" href="http://dvcs.w3.org/hg/IndexedDB/raw-file/tip/Overview.html">most recent specification</a>, which is only implemented in up-to-date browsers. Old browsers implemented the now deprecated and removed <a href="/en-US/docs/IndexedDB/IDBDatabase#setVersion()" title="/en-US/docs/IndexedDB/IDBDatabase#setVersion()"><code>IDBDatabase.setVersion()</code></a> method.</dd> - <dt><a name="gloss_database_connection">database connection</a></dt> - <dd>An operation created by opening a <em><a href="#gloss_database">database</a></em>. A given database can have multiple connections at the same time.</dd> - <dt><a name="gloss_transaction">transaction</a></dt> - <dd> - <p>An atomic set of data-access and data-modification operations on a particular database. It is how you interact with the data in a database. In fact, any reading or changing of data in the database must happen in a transaction.</p> - - <p>A database connection can have several active transactions associated with it at a time, so long as the writing transactions do not have overlapping <a href="#scope"><em>scopes</em></a>. The scope of transactions, which is defined at creation, determines which object stores the transaction can interact with and remains constant for the lifetime of the transaction. So, for example, if a database connection already has a writing transaction with a scope that just covers the <code>flyingMonkey</code> object store, you can start a second transaction with a scope of the <code>unicornCentaur</code> and <code>unicornPegasus</code> object stores. As for reading transactions, you can have several of them — even overlapping ones.</p> - - <p>Transactions are expected to be short-lived, so the browser can terminate a transaction that takes too long, in order to free up storage resources that the long-running transaction has locked. You can abort the transaction, which rolls back the changes made to the database in the transaction. And you don't even have to wait for the transaction to start or be active to abort it.</p> - - <p>The three modes of transactions are: <code>readwrite</code>, <code>readonly</code>, and <code>versionchange</code>. The only way to create and delete object stores and indexes is by using a <a href="/en-US/docs/Web/Reference/Events/versionchange_indexedDB"><code>versionchange</code></a> transaction. To learn more about transaction types, see the reference article for <a href="/en/IndexedDB" title="https://developer.mozilla.org/en/IndexedDB">IndexedDB</a>.</p> - - <p>Because everything happens within a transaction, it is a very important concept in IndexedDB. To learn more about transactions, especially on how they relate to versioning, see {{domxref("IDBTransaction")}}, which also has reference documentation.</p> - </dd> - <dt><a name="gloss_request">request</a></dt> - <dd>The operation by which reading and writing on a database is done. Every request represents one read or write operation.</dd> - <dt><a name="gloss_index">index</a></dt> - <dd> - <p>An index is a specialized object store for looking up records in another object store, called the <em>referenced object store</em>. The index is a persistent key-value storage where the value part of its records is the key part of a record in the referenced object store. The records in an index are automatically populated whenever records in the referenced object store are inserted, updated, or deleted. Each record in an index can point to only one record in its referenced object store, but several indexes can reference the same object store. When the object store changes, all indexes that refer to the object store are automatically updated.</p> - - <p>Alternatively, you can also look up records in an object store using the <a href="#gloss_key"> key</a><em>.</em></p> - - <p>To learn more on using indexes, see <a href="/en/IndexedDB/Using_IndexedDB#Using_an_index" title="en/IndexedDB/Using_IndexedDB#Using_an_index">Using IndexedDB</a>. For the reference documentation on index, see <a href="../../../../en/IndexedDB/IDBKeyRange" rel="internal">IDBKeyRange</a>.</p> - </dd> -</dl> - -<h3 id="key" name="key">Key and value</h3> - -<dl> - <dt><a name="gloss_key">key</a></dt> - <dd> - <p>A data value by which stored values are organized and retrieved in the object store. The object store can derive the key from one of three sources: a <em><a href="#gloss_keygenerator">key generator</a></em>, a <em><a href="#gloss_keypath">key path</a></em>, or an explicitly specified value. The key must be of a data type that has a number that is greater than the one before it. Each record in an object store must have a key that is unique within the same store, so you cannot have multiple records with the same key in a given object store.</p> - - <p>A key can be one of the following types: <a href="/en/JavaScript/Reference/Global_Objects/String" title="https://developer.mozilla.org/en/JavaScript/Reference/Global_Objects/String">string</a>, <a href="/en/JavaScript/Reference/Global_Objects/Date" title="en/JavaScript/Reference/Global Objects/Date">date</a>, float, a binary blob, and <a href="/en/JavaScript/Reference/Global_Objects/Array" title="en/JavaScript/Reference/Global Objects/Array">array</a>. For arrays, the key can range from an empty value to infinity. And you can include an array within an array.</p> - - <p>Alternatively, you can also look up records in an object store using the <em><a href="#gloss_index">index</a>.</em></p> - </dd> - <dt><a name="gloss_keygenerator">key generator</a></dt> - <dd>A mechanism for producing new keys in an ordered sequence. If an object store does not have a key generator, then the application must provide keys for records being stored. Generators are not shared between stores. This is more a browser implementation detail, because in web development, you don't really create or access key generators.</dd> - <dt><a name="gloss_inline_key">in-line key</a></dt> - <dd>A key that is stored as part of the stored value. It is found using a <em>key path</em>. An in-line key can be generated using a generator. After the key has been generated, it can then be stored in the value using the key path or it can also be used as a key.</dd> - <dt><a name="gloss_outofline_key">out-of-line key</a></dt> - <dd>A key that is stored separately from the value being stored.</dd> - <dt><a name="gloss_keypath">key path</a></dt> - <dd>Defines where the browser should extract the key from in the object store or index. A valid key path can include one of the following: an empty string, a JavaScript identifier, or multiple JavaScript identifiers separated by periods or an array containing any of those. It cannot include spaces.</dd> - <dt><a name="gloss_value">value</a></dt> - <dd> - <p>Each record has a value, which could include anything that can be expressed in JavaScript, including <a href="/en/JavaScript/Reference/Global_Objects/Boolean" rel="internal" title="en/JavaScript/Reference/Global_Objects/Boolean">boolean</a>, <a href="/en/JavaScript/Reference/Global_Objects/Number" rel="internal" title="en/JavaScript/Reference/Global_Objects/Number">number</a>, <a href="/en/JavaScript/Reference/Global_Objects/String" title="https://developer.mozilla.org/en/JavaScript/Reference/Global_Objects/String">string</a>, <a href="/en/JavaScript/Reference/Global_Objects/Date" title="en/JavaScript/Reference/Global Objects/Date">date</a>, <a href="/en/JavaScript/Reference/Global_Objects/Object" title="en/JavaScript/Reference/Global Objects/Object">object</a>, <a href="/en/JavaScript/Reference/Global_Objects/Array" rel="internal" title="en/JavaScript/Reference/Global_Objects/Array">array</a>, <a href="/en/JavaScript/Reference/Global_Objects/RegExp" rel="internal" title="en/JavaScript/Reference/Global_Objects/RegExp">regexp</a>, <a href="/en/JavaScript/Reference/Global_Objects/undefined" title="en/JavaScript/Reference/Global_Objects/undefined">undefined</a>, and null.</p> - - <p>When an object or array is stored, the properties and values in that object or array can also be anything that is a valid value.</p> - - <p><a href="/en/DOM/Blob" title="en/DOM/Blob">Blobs</a> and files can be stored, cf. <a class="external" href="http://dvcs.w3.org/hg/IndexedDB/raw-file/tip/Overview.html">specification</a>.</p> - </dd> -</dl> - -<h3 id="range" name="range">Range and scope</h3> - -<dl> - <dt id="scope"><a id="gloss_scope" name="gloss_scope">scope</a></dt> - <dd>The set of object stores and indexes to which a transaction applies. The scopes of read-only transactions can overlap and execute at the same time. On the other hand, the scopes of writing transactions cannot overlap. You can still start several transactions with the same scope at the same time, but they just queue up and execute one after another.</dd> - <dt id="cursor"><a id="gloss_cursor" name="gloss_cursor">cursor</a></dt> - <dd>A mechanism for iterating over multiple records with a <em>key range</em>. The cursor has a source that indicates which index or object store it is iterating. It has a position within the range, and moves in a direction that is increasing or decreasing in the order of record keys. For the reference documentation on cursors, see {{domxref("IDBCursor")}}.</dd> - <dt id="key_range"><a id="gloss_keyrange" name="gloss_keyrange">key range</a></dt> - <dd> - <p>A continuous interval over some data type used for keys. Records can be retrieved from object stores and indexes using keys or a range of keys. You can limit or filter the range using lower and upper bounds. For example, you can iterate over all values of a key between x and y.</p> - - <p>For the reference documentation on key range, see {{domxref("IDBKeyRange")}}.</p> - </dd> -</dl> - -<h2 id="limitations" name="limitations">Limitations</h2> - -<p>IndexedDB is designed to cover most cases that need client-side storage. However, it is not designed for a few cases like the following:</p> - -<ul> - <li>Internationalized sorting. Not all languages sort strings in the same way, so internationalized sorting is not supported. While the database can't store data in a specific internationalized order, you can sort the data that you've read out of the database yourself. Note, however, that <a href="/en-US/docs/Web/API/IndexedDB_API/Using_IndexedDB#Locale-aware_sorting">locale-aware sorting</a> has been allowed with an experimental flag enabled (currently for Firefox only) since Firefox 43.</li> - <li>Synchronizing. The API is not designed to take care of synchronizing with a server-side database. You have to write code that synchronizes a client-side indexedDB database with a server-side database.</li> - <li>Full text searching. The API<span style="direction: ltr;"> does not have an</span><span style="direction: ltr;"> equivalent of the <code>LIKE</code> operator in SQL. </span></li> -</ul> - -<p>In addition, be aware that browsers can wipe out the database, such as in the following conditions:</p> - -<ul> - <li>The user requests a wipe out. Many browsers have settings that let users wipe all data stored for a given website, including cookies, bookmarks, stored passwords, and IndexedDB data.</li> - <li>The browser is in private browsing mode. Some browsers, have "private browsing" (Firefox) or "incognito" (Chrome) modes. At the end of the session, the browser wipes out the database.</li> - <li>The disk or quota limit has been reached.</li> - <li>The data is corrupt.</li> - <li>An incompatible change is made to the feature.</li> -</ul> - -<p>The exact circumstances and browser capabilities change over time, but the general philosophy of the browser vendors is to make the best effort to keep the data when possible.</p> - -<h2 id="next" name="next">Next steps</h2> - -<p>With these big concepts under our belts, we can get to more concrete stuff. For a tutorial on how to use the API, see <a href="/en/IndexedDB/Using_IndexedDB" title="en/IndexedDB/IndexedDB primer">Using IndexedDB</a>.</p> - -<h2 id="See_also">See also</h2> - -<ul> - <li><a href="http://www.w3.org/TR/IndexedDB/" title="http://www.w3.org/TR/IndexedDB/"><span style="direction: ltr;">Indexed Database API Specification</span></a></li> - <li><a href="/en/IndexedDB" title="https://developer.mozilla.org/en/IndexedDB">IndexedDB API Reference</a></li> - <li><a href="/en/IndexedDB/Using_IndexedDB" title="en/IndexedDB/IndexedDB primer">Using IndexedDB</a></li> - <li><a class="external" href="http://msdn.microsoft.com/en-us/scriptjunkie/gg679063.aspx" title="http://msdn.microsoft.com/en-us/scriptjunkie/gg679063.aspx">IndexedDB — The Store in Your Browser</a></li> -</ul> diff --git a/files/ru/orphaned/web/api/localmediastream/index.html b/files/ru/orphaned/web/api/localmediastream/index.html deleted file mode 100644 index 4349f96b4a..0000000000 --- a/files/ru/orphaned/web/api/localmediastream/index.html +++ /dev/null @@ -1,23 +0,0 @@ ---- -title: LocalMediaStream -slug: orphaned/Web/API/LocalMediaStream -translation_of: Web/API/LocalMediaStream -original_slug: Web/API/LocalMediaStream ---- -<div>{{APIRef("WebRTC")}} {{SeeCompatTable}}</div> - -<p>Интерфейс <strong><code>LocalMediaStream</code></strong><strong> </strong>представляет собой поток медиа-контента извлечённый из локального источника данных. Этот интерфейс возвращается из <code><a href="/en-US/docs/WebRTC/navigator.getUserMedia" title="/en-US/docs/WebRTC/navigator.getUserMedia">getUserMedia()</a></code>.</p> - -<h2 id="Methods">Methods</h2> - -<dl> - <dt>{{domxref("LocalMediaStream.stop()")}}</dt> - <dd>Останавливает поток. Когда источником потока является подключённое устройство (например, камера или микрофон), останавливает захват на устройстве. </dd> -</dl> - -<h2 id="See_Also">See Also</h2> - -<ul> - <li>Использование MediaStream API</li> - <li><a href="/en-US/docs/WebRTC/navigator.getUserMedia" title="/en-US/docs/WebRTC/navigator.getUserMedia">getUserMedia()</a></li> -</ul> diff --git a/files/ru/orphaned/web/api/node/getuserdata/index.html b/files/ru/orphaned/web/api/node/getuserdata/index.html deleted file mode 100644 index 949bc17fd7..0000000000 --- a/files/ru/orphaned/web/api/node/getuserdata/index.html +++ /dev/null @@ -1,64 +0,0 @@ ---- -title: Node.getUserData() -slug: orphaned/Web/API/Node/getUserData -translation_of: Web/API/Node/getUserData -original_slug: Web/API/Node/getUserData ---- -<p>{{APIRef("DOM")}}{{ obsolete_header() }}</p> - -<p>Метод <code><strong>Node.getUserData()</strong></code> возвращает любого пользователя {{domxref("DOMUserData")}} установленного предварительно на данном узле через {{domxref("Node.setUserData()")}}.</p> - -<div class="note"> -<p>Методы <code>Node.setUserData</code> и {{domxref("Node.getUserData")}} больше не доступны для веб-контента. {{domxref("Element.dataset")}} или <a href="/en-US/docs/JavaScript/Reference/Global_Objects/WeakMap"><code>WeakMap</code></a> могут быть использованы вместо него.</p> -</div> - -<h2 id="Синтаксис">Синтаксис</h2> - -<pre class="syntaxbox"><em>userData</em> = <em>someNode</em>.getUserData(<em>userKey</em>);</pre> - -<h3 id="Параметры">Параметры</h3> - -<ul> - <li><code>userKey</code> это ключ для выбора определённых данных искомых для данного узла. Больше чем один ключ может быть назначен для данного узла, содержащий своё собственное значение.</li> -</ul> - -<h2 id="Пример">Пример</h2> - -<pre class="brush: js">var d = document.setUserData('key', 15, null); -alert(document.getUserData('key')); // 15</pre> - -<h2 id="Спецификации">Спецификации</h2> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Спецификация</th> - <th scope="col">Статус</th> - <th scope="col">Комментарий</th> - </tr> - </thead> - <tbody> - <tr> - <td>{{SpecName('DOM WHATWG', '#interface-node', 'Node')}}</td> - <td>{{Spec2('DOM WHATWG')}}</td> - <td>Удалено из спецификации</td> - </tr> - <tr> - <td>{{SpecName('DOM3 Core', 'core.html#Node3-getUserData', 'Node.getUserData()')}}</td> - <td>{{Spec2('DOM3 Core')}}</td> - <td>Изначальное описание</td> - </tr> - </tbody> -</table> - -<h2 id="Совместимость_с_браузерами">Совместимость с браузерами</h2> - -<p>{{Compat("api.Node.getUserData")}}</p> - -<h2 id="Смотрите_также">Смотрите также</h2> - -<ul> - <li>{{domxref("Node.setUserData()")}}</li> - <li>{{domxref("UserDataHandler")}}</li> - <li>{{domxref("DOMUserData")}}</li> -</ul> diff --git a/files/ru/orphaned/web/api/notation/index.html b/files/ru/orphaned/web/api/notation/index.html deleted file mode 100644 index e5f51b30d7..0000000000 --- a/files/ru/orphaned/web/api/notation/index.html +++ /dev/null @@ -1,53 +0,0 @@ ---- -title: Нотация -slug: orphaned/Web/API/Notation -tags: - - Нотация -translation_of: Web/API/Notation -original_slug: Web/API/Notation ---- -<div>{{APIRef("DOM")}}{{draft}}{{obsolete_header}}</div> - -<p>Представляет нотацию DTD (только для чтения). Может объявлять формат неразобранного объекта или формально объявлять цели инструкции по обработке документа. Наследует методы и свойства от <a class="internal" href="/En/DOM/Node" title="En/DOM/Node"><code>Node</code></a>. Его <code><a class="internal" href="/En/DOM/Node/NodeName" title="En/DOM/Node/NodeName">nodeName</a></code> - это имя нотации. Не имеет родителя.</p> - -<h2 id="Свойства">Свойства</h2> - -<dl> - <dt>{{domxref("Notation.publicId")}} {{ReadOnlyInline}}</dt> - <dd>Это {{domxref("DOMString")}}.</dd> - <dt>{{domxref("Notation.systemId")}} {{ReadOnlyInline}}</dt> - <dd>Это {{domxref("DOMString")}}.</dd> -</dl> - -<h2 id="Спецификации">Спецификации</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th>Спецификация</th> - <th>Статус</th> - <th>Комментарии</th> - </tr> - <tr> - <td>{{SpecName("DOM3 Core", "core.html#ID-5431D1B9", "Notation")}}</td> - <td>{{Spec2("DOM3 Core")}}</td> - <td>Без изменений</td> - </tr> - <tr> - <td>{{SpecName("DOM2 Core", "core.html#ID-5431D1B9", "Notation")}}</td> - <td>{{Spec2("DOM2 Core")}}</td> - <td>Без изменений</td> - </tr> - <tr> - <td>{{SpecName('DOM1', 'level-one-core.html#ID-5431D1B9', 'Notation')}}</td> - <td>{{Spec2('DOM1')}}</td> - <td>Первое определение</td> - </tr> - </tbody> -</table> - -<h2 id="Поддержка_браузерами">Поддержка браузерами</h2> - - - -<p>{{Compat("api.Notation")}}</p> diff --git a/files/ru/orphaned/web/api/parentnode/append/index.html b/files/ru/orphaned/web/api/parentnode/append/index.html deleted file mode 100644 index e35894dd86..0000000000 --- a/files/ru/orphaned/web/api/parentnode/append/index.html +++ /dev/null @@ -1,135 +0,0 @@ ---- -title: ParentNode.append() -slug: orphaned/Web/API/ParentNode/append -translation_of: Web/API/ParentNode/append -original_slug: Web/API/ParentNode/append ---- -<div>{{APIRef("DOM")}} {{SeeCompatTable}}</div> - -<p>Метод <strong><code>ParentNode.append</code></strong> добавляет набор объектов {{domxref("Node")}} или {{domxref("DOMString")}} в конец (после последнего потомка) <code>ParentNode</code>. {{domxref("DOMString")}} объекты добавляются как {{domxref("Text")}}.</p> - -<p>Отличия от {{domxref("Node.appendChild()")}}:</p> - -<ul> - <li><code>ParentNode.append()</code> позволяет добавлять {{domxref("DOMString")}} объекты, в то время как <code>Node.appendChild()</code> принимает только {{domxref("Node")}}.</li> - <li><code>ParentNode.append()</code> ничего не возвращает, в то время как <code>Node.appendChild()</code> возвращает добавленный объект {{domxref("Node")}}.</li> - <li><code>ParentNode.append()</code> позволяет добавить несколько узлов (node) или строк, в то время как <code>Node.appendChild()</code> может добавить только один узел (node).</li> -</ul> - -<h2 id="Синтаксис">Синтаксис</h2> - -<pre class="syntaxbox">[Throws, Unscopable] -void ParentNode.append((Node или DOMString)... nodes); -</pre> - -<h3 id="Параметры">Параметры</h3> - -<dl> - <dt><code>nodes</code></dt> - <dd>Набор объектов {{domxref("Node")}} или {{domxref("DOMString")}}, которые будут добавлены.</dd> -</dl> - -<h3 id="Исключения">Исключения</h3> - -<ul> - <li>{{domxref("HierarchyRequestError")}}: Узел (node) не может быть вставлен в определённую точку в иерархии страницы.</li> -</ul> - -<h2 id="Примеры">Примеры</h2> - -<h3 id="Добавление_элемента">Добавление элемента</h3> - -<pre class="brush: js">var parent = document.createElement("div"); -var p = document.createElement("p"); -parent.append(p); - -console.log(parent.childNodes); // NodeList [ <p> ] -</pre> - -<h3 id="Добавление_строки">Добавление строки</h3> - -<pre class="brush: js">var parent = document.createElement("div"); -parent.append("Любой текст"); - -console.log(parent.textContent); // "Любой текст"</pre> - -<h3 id="Добавление_элемента_или_строки">Добавление элемента или строки</h3> - -<pre class="brush: js">var parent = document.createElement("div"); -var p = document.createElement("p"); -parent.append("Любой текст", p); - -console.log(parent.childNodes); // NodeList [ #text "Любой текст", <p> ]</pre> - -<h3 id="ParentNode.append_не_имеет_области_видимости"><code>ParentNode.append()</code> не имеет области видимости</h3> - -<p>Метод <code>append()</code> не имеет области видимости с директивой <code>with</code>. Больше информации в {{jsxref("Symbol.unscopables")}}.</p> - -<pre class="brush: js">var parent = document.createElement("div"); - -with(parent) { - append("foo"); -} -// ReferenceError: append is not defined </pre> - -<h2 id="Полифил">Полифил</h2> - -<p>Вы можете использовать полифил для <code>метода append()</code> в Internet Explorer 9 и выше:</p> - -<pre class="brush: js">// Источник: https://github.com/jserz/js_piece/blob/master/DOM/ParentNode/append()/append().md -(function (arr) { - arr.forEach(function (item) { - if (item.hasOwnProperty('append')) { - return; - } - Object.defineProperty(item, 'append', { - configurable: true, - enumerable: true, - writable: true, - value: function append() { - var argArr = Array.prototype.slice.call(arguments), - docFrag = document.createDocumentFragment(); - - argArr.forEach(function (argItem) { - var isNode = argItem instanceof Node; - docFrag.appendChild(isNode ? argItem : document.createTextNode(String(argItem))); - }); - - this.appendChild(docFrag); - } - }); - }); -})([Element.prototype, Document.prototype, DocumentFragment.prototype]);</pre> - -<h2 id="Спецификация">Спецификация</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Спецификация</th> - <th scope="col">Статус</th> - <th scope="col">Комментарий</th> - </tr> - <tr> - <td>{{SpecName('DOM WHATWG', '#dom-parentnode-append', 'ParentNode.append()')}}</td> - <td>{{Spec2('DOM WHATWG')}}</td> - <td>Initial definition.</td> - </tr> - </tbody> -</table> - -<h2 id="Поддержка_браузерами">Поддержка браузерами</h2> - - - -<p>{{Compat("api.ParentNode.append")}}</p> - -<h2 id="Смотрите_также">Смотрите также</h2> - -<ul> - <li>{{domxref("ParentNode")}} и {{domxref("ChildNode")}}</li> - <li>{{domxref("ParentNode.prepend()")}}</li> - <li>{{domxref("Node.appendChild()")}}</li> - <li>{{domxref("ChildNode.after()")}}</li> - <li>{{domxref("NodeList")}}</li> -</ul> diff --git a/files/ru/orphaned/web/api/parentnode/children/index.html b/files/ru/orphaned/web/api/parentnode/children/index.html deleted file mode 100644 index b380d55fde..0000000000 --- a/files/ru/orphaned/web/api/parentnode/children/index.html +++ /dev/null @@ -1,144 +0,0 @@ ---- -title: Node.children -slug: orphaned/Web/API/ParentNode/children -tags: - - API - - DOM - - ParentNode - - Property - - Reference -translation_of: Web/API/ParentNode/children -original_slug: Web/API/ParentNode/children ---- -<p>{{ APIRef("DOM") }}</p> - -<h2 id="Описание">Описание</h2> - -<p>Свойство <span class="seoSummary"><code><strong>children</strong></code> </span> {{domxref("ParentNode")}} является свойством только для чтения, которое возвращает {{domxref("HTMLCollection")}}, содержащее все дочерние {{domxref("Element", "elements")}} узла, на котором он был вызван.</p> - -<h2 id="Синтаксис">Синтаксис</h2> - -<pre class="syntaxbox">var <em>elList</em> = elementNodeReference.children; </pre> - -<p><var>В результате,</var><code><var> <strong>elList</strong> - </var></code><var>живая коллекция, состоящая из дочерних элементов узла</var><code><var> <strong>elementNodeReference</strong></var></code>, и стоит подметить, что если у узла детей нет, она будет пустой. Определить это можно, обратившись к свойству length, которое содержит в себе количество элементов в коллекции.</p> - -<h2 id="Пример">Пример</h2> - -<pre class="brush: js"><ul> - <li>1 пункт</li> - <li>2 пункт</li> -</ul> - -<script type="text/javascript"> - - var elementChildrens = document.querySelector("ul").children; - for (var i=0, child; child=elementChildrens[i]; i++) { - // elementChildrens - коллекция детей списка - // child - последовательно, каждый из элементов elementChildrens - alert(child.innerHTML); - } - -</script> - -</pre> - -<h2 id="Спецификация">Спецификация</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Спецификация</th> - <th scope="col">Статус</th> - <th scope="col">Комментарий</th> - </tr> - <tr> - <td>{{SpecName('DOM WHATWG', '#dom-parentnode-children', 'ParentNode.children')}}</td> - <td>{{Spec2('DOM WHATWG')}}</td> - <td>Начальное определение.</td> - </tr> - </tbody> -</table> - -<h2 id="Поддержка_браузерами">Поддержка браузерами</h2> - -<p>{{ CompatibilityTable() }}</p> - -<div id="compat-desktop"> -<table class="compat-table"> - <tbody> - <tr> - <th>Особенность</th> - <th>Chrome</th> - <th>Firefox (Gecko)</th> - <th>Internet Explorer</th> - <th>Opera</th> - <th>Safari</th> - </tr> - <tr> - <td>Базовая поддержка {{domxref("Element")}}</td> - <td>1.0</td> - <td>{{CompatGeckoDesktop("1.9.1")}}</td> - <td>9.0 [1]</td> - <td>10.0</td> - <td>4.0</td> - </tr> - <tr> - <td> - <p>Поддержка {{domxref("Document")}} и {{domxref("DocumentFragment")}} {{experimental_inline}}</p> - </td> - <td>29.0</td> - <td>{{CompatGeckoDesktop("25.0")}}</td> - <td>{{CompatNo}}</td> - <td>16.0</td> - <td>{{CompatNo}}</td> - </tr> - <tr> - <td>Поддержка {{domxref("SVGElement")}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatNo}}</td> - <td>{{CompatUnknown}}</td> - <td>{{CompatNo}}</td> - </tr> - </tbody> -</table> -</div> - -<div id="compat-mobile"> -<table class="compat-table"> - <tbody> - <tr> - <th>Особенность</th> - <th>Android</th> - <th>Firefox Mobile (Gecko)</th> - <th>IE Mobile</th> - <th>Opera Mobile</th> - <th>Safari Mobile</th> - </tr> - <tr> - <td>Базовая поддержка {{domxref("Element")}}</td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{CompatGeckoMobile("1.9.1")}}</td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatVersionUnknown() }}</td> - </tr> - <tr> - <td>Поддержка {{domxref("Document")}} и {{domxref("DocumentFragment")}} {{experimental_inline}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatGeckoMobile("25.0")}}</td> - <td>{{CompatNo}}</td> - <td>16.0</td> - <td>{{CompatNo}}</td> - </tr> - </tbody> -</table> -</div> - -<p>Internet Explorer 6, 7 и 8 поддерживают данное свойство, но ошибочно включают в коллекцию комментарии ({{domxref("Comment")}}) в HTML-коде.</p> - -<h2 id="Смотрите_также">Смотрите также</h2> - -<ul> - <li>Свойства {{domxref("ParentNode")}} и {{domxref("ChildNode")}}.</li> -</ul> diff --git a/files/ru/orphaned/web/api/parentnode/firstelementchild/index.html b/files/ru/orphaned/web/api/parentnode/firstelementchild/index.html deleted file mode 100644 index 21fb90f963..0000000000 --- a/files/ru/orphaned/web/api/parentnode/firstelementchild/index.html +++ /dev/null @@ -1,150 +0,0 @@ ---- -title: ParentNode.firstElementChild -slug: orphaned/Web/API/ParentNode/firstElementChild -tags: - - API - - DOM - - ParentNode - - Property - - Reference -translation_of: Web/API/ParentNode/firstElementChild -original_slug: Web/API/ParentNode/firstElementChild ---- -<p>{{ APIRef("DOM") }}</p> - -<p>Доступное только для чтения свойство <strong><code>ParentNode.firstElementChild</code></strong> возвращает первый дочерний элемент объекта ({{domxref("Element")}}) или <code>null</code> если дочерних элементов нет.</p> - -<div class="note"> -<p>This property was initially defined in the {{domxref("ElementTraversal")}} pure interface. As this interface contained two distinct set of properties, one aimed at {{domxref("Node")}} that have children, one at those that are children, they have been moved into two separate pure interfaces, {{domxref("ParentNode")}} and {{domxref("ChildNode")}}. In this case, <code>firstElementChild</code> moved to {{domxref("ParentNode")}}. This is a fairly technical change that shouldn't affect compatibility.</p> -</div> - -<h2 id="Syntax_and_values" name="Syntax_and_values">Синтаксис</h2> - -<pre class="syntaxbox">var <em>childNode</em> = elementNodeReference.firstElementChild; -</pre> - -<h2 id="Example" name="Example">Пример</h2> - -<pre class="brush: html"><p id="para-01"> - <span>First span</span> -</p> - -<script type="text/javascript"> - var p01 = document.getElementById('para-01'); - alert(p01.firstElementChild.nodeName) -</script></pre> - -<p>В этом примере alert показывает 'span', что является именем тега первого дочернего узла элемента p.</p> - -<h2 id="Polyfill_для_Internet_Explorer_8">Polyfill для Internet Explorer 8</h2> - -<p>Это свойство не поддерживается браузером Internet Explorer вплоть до 9 версии, поэтому следующий сниппет может быть использован для добавления поддержки IE8:</p> - -<pre class="brush: js">// Source: https://github.com/Alhadis/Snippets/blob/master/js/polyfills/IE8-child-elements.js -if(!("firstElementChild" in document.documentElement)){ - Object.defineProperty(Element.prototype, "firstElementChild", { - get: function(){ - for(var nodes = this.children, n, i = 0, l = nodes.length; i < l; ++i) - if(n = nodes[i], 1 === n.nodeType) return n; - return null; - } - }); -}</pre> - -<h2 id="Спецификация">Спецификация</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Спецификация</th> - <th scope="col">Статус</th> - <th scope="col">Комментарий</th> - </tr> - <tr> - <td>{{SpecName('DOM WHATWG', '#dom-parentnode-firstelementchild', 'ParentNode.firstElementChild')}}</td> - <td>{{Spec2('DOM WHATWG')}}</td> - <td>Splitted the <code>ElementTraversal</code> interface in {{domxref("ChildNode")}} and <code>ParentNode</code>. This method is now defined on the latter.<br> - The {{domxref("Document")}} and {{domxref("DocumentFragment")}} implemented the new interfaces.</td> - </tr> - <tr> - <td>{{SpecName('Element Traversal', '#attribute-firstElementChild', 'ElementTraversal.firstElementChild')}}</td> - <td>{{Spec2('Element Traversal')}}</td> - <td>Added its initial definition to the <code>ElementTraversal</code> pure interface and use it on {{domxref("Element")}}.</td> - </tr> - </tbody> -</table> - -<h2 id="Совместимость_с_браузерами">Совместимость с браузерами</h2> - -<p>{{ CompatibilityTable() }}</p> - -<div id="compat-desktop"> -<table class="compat-table"> - <tbody> - <tr> - <th>Feature</th> - <th>Chrome</th> - <th>Firefox (Gecko)</th> - <th>Internet Explorer</th> - <th>Opera</th> - <th>Safari</th> - </tr> - <tr> - <td>Базовая поддержка ({{domxref("Element")}})</td> - <td>1.0</td> - <td>{{CompatGeckoDesktop("1.9.1")}}</td> - <td>9.0</td> - <td>10.0</td> - <td>4.0</td> - </tr> - <tr> - <td>Поддержка {{domxref("Document")}} и {{domxref("DocumentFragment")}} {{experimental_inline}}</td> - <td>29.0</td> - <td>{{CompatGeckoDesktop("25.0")}}</td> - <td>{{CompatNo}}</td> - <td>16.0</td> - <td>{{CompatNo}}</td> - </tr> - </tbody> -</table> -</div> - -<div id="compat-mobile"> -<table class="compat-table"> - <tbody> - <tr> - <th>Feature</th> - <th>Android</th> - <th>Firefox Mobile (Gecko)</th> - <th>IE Mobile</th> - <th>Opera Mobile</th> - <th>Safari Mobile</th> - </tr> - <tr> - <td>Базовая поддержка ({{domxref("Element")}})</td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{CompatGeckoMobile("1.9.1")}}</td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatVersionUnknown() }}</td> - </tr> - <tr> - <td>Поддержка {{domxref("Document")}} и {{domxref("DocumentFragment")}} {{experimental_inline}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatGeckoMobile("25.0")}}</td> - <td>{{CompatNo}}</td> - <td>16.0</td> - <td>{{CompatNo}}</td> - </tr> - </tbody> -</table> -</div> - -<h2 id="Смотрите_также">Смотрите также</h2> - -<ul> - <li>{{domxref("ParentNode")}} и {{domxref("ChildNode")}}.</li> - <li> - <div class="syntaxbox">Типы объектов, имплементирующие данное свойство: {{domxref("Document")}}, {{domxref("Element")}}, и {{domxref("DocumentFragment")}}.</div> - </li> -</ul> diff --git a/files/ru/orphaned/web/api/parentnode/index.html b/files/ru/orphaned/web/api/parentnode/index.html deleted file mode 100644 index 1c4e7e2040..0000000000 --- a/files/ru/orphaned/web/api/parentnode/index.html +++ /dev/null @@ -1,91 +0,0 @@ ---- -title: ParentNode -slug: orphaned/Web/API/ParentNode -tags: - - API - - DOM - - NeedsTranslation - - Tab - - TopicStub -translation_of: Web/API/ParentNode -original_slug: Web/API/ParentNode ---- -<p>{{ APIRef("DOM") }}</p> - -<p>Интерфейс <code><strong>ParentNode</strong></code> содержит методы, которые относятся к {{domxref("Node")}} объектам , у которых могут быть потомки.</p> - -<p><code>ParentNode</code> является сырым интерфейсом и объекты с данным типом создать нельзя; данный интерфейс имеется у {{domxref("Element")}}, {{domxref("Document")}}, и {{domxref("DocumentFragment")}} объектов.</p> - -<h2 id="Свойства">Свойства</h2> - -<dl> - <dt>{{domxref("ParentNode.children")}} {{experimental_inline}} {{readonlyInline}}<br> - Возвращает живую {{domxref("HTMLCollection")}}, которая содержит все объекты типа {{domxref("Element")}}, которые являются потомками данного ParentNode.<br> - <br> - {{domxref("ParentNode.firstElementChild")}} {{experimental_inline}} {{readonlyInline}}<br> - Возвращает {{domxref("Element")}} , который является первым потомком данного ParentNode, или null, если таковой отсутствует.<br> - <br> - {{ domxref("ParentNode.lastElementChild") }} {{experimental_inline}} {{readonlyInline}}<br> - Возвращает {{domxref("Element")}}, который является последним из потомков данного ParentNode, или null, если таковой отсутствует.<br> - <br> - {{ domxref("ParentNode.childElementCount") }} {{experimental_inline}} {{readonlyInline}}<br> - Возвращает unsigned long с количеством потомков, которые есть у объекта.</dt> -</dl> - -<h2 id="Методы">Методы</h2> - -<dl> - <dt>{{domxref("ParentNode.append()")}} {{experimental_inline}}</dt> - <dd>Вставляет набор объектов типа {{domxref("Node")}} или {{domxref("DOMString")}} после последнего потомка <code>ParentNode</code>. {{domxref("DOMString")}} объекты вставлены как эквивалент {{domxref("Text")}} узлы.</dd> - <dt>{{domxref("ParentNode.prepend()")}} {{experimental_inline}}</dt> - <dd>Вставляет набор объектов типа {{domxref("Node")}} или {{domxref("DOMString")}} перед первым потомком <code>ParentNode</code>. {{domxref("DOMString")}} объекты вставлены как эквивалент {{domxref("Text")}} узлы.</dd> - <dt>{{domxref("ParentNode.querySelector()")}}</dt> - <dd>Возвращает первый {{domxref("Element")}} с текущим элементом в качестве источника, который совпадает с определённой группой селекторов.</dd> - <dt>{{domxref("ParentNode.querySelectorAll()")}}</dt> - <dd>Возвращает {{domxref("NodeList")}}, который представляет собой список элементов с текущим элементом в качестве источника, который совпадает с определённой группой селекторов.</dd> -</dl> - -<h2 id="Спецификация">Спецификация</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Спецификация</th> - <th scope="col">Статус</th> - <th scope="col">Комментарий</th> - </tr> - <tr> - <td>{{SpecName('DOM WHATWG', '#parentnode', 'ParentNode')}}</td> - <td>{{Spec2('DOM WHATWG')}}</td> - <td>Добавлены методы <code>append()</code> и <code>prepend()</code>.</td> - </tr> - <tr> - <td>{{SpecName('DOM WHATWG', '#dom-parentnode-firstelementchild', 'ParentNode.firstElementChild')}}</td> - <td>{{Spec2('DOM WHATWG')}}</td> - <td>Splitted the <code>ElementTraversal</code> interface in {{domxref("ChildNode")}} and <code>ParentNode</code>. The <code>firstElementChild</code>, <code>lastElementChild</code>, and <code>childElementCount</code> properties are now defined on the latter.<br> - The {{domxref("Document")}} and {{domxref("DocumentFragment")}} implemented the new interfaces.<br> - Added the <code>children</code> property.<br> - Added the <code>append()</code> and <code>prepend()</code> methods.</td> - </tr> - <tr> - <td>{{SpecName('Element Traversal', '#interface-elementTraversal', 'ElementTraversal')}}'</td> - <td>{{Spec2('Element Traversal')}}</td> - <td>Добавлено изначальное определение свойств в <code>ElementTraversal</code> чистый интерфейс и использование его в {{domxref("Element")}}.</td> - </tr> - </tbody> -</table> - -<h2 id="Совместимость_с_браузерами">Совместимость с браузерами</h2> - -<p>{{Compat("api.ParentNode")}}</p> - -<p> </p> - -<h2 id="Смотрите_также">Смотрите также</h2> - -<ul> - <li>Чистый интерфейс {{domxref("ChildNode")}}.</li> - <li> - <div class="syntaxbox">Типы объектов, которые имплементируют данный интерфейс: {{domxref("Document")}}, {{domxref("Element")}}, and {{domxref("DocumentFragment")}}.</div> - </li> -</ul> diff --git a/files/ru/orphaned/web/api/parentnode/lastelementchild/index.html b/files/ru/orphaned/web/api/parentnode/lastelementchild/index.html deleted file mode 100644 index 8df658ceb5..0000000000 --- a/files/ru/orphaned/web/api/parentnode/lastelementchild/index.html +++ /dev/null @@ -1,162 +0,0 @@ ---- -title: ParentNode.lastElementChild -slug: orphaned/Web/API/ParentNode/lastElementChild -tags: - - API - - DOM - - ParentNode - - Property - - Reference -translation_of: Web/API/ParentNode/lastElementChild -original_slug: Web/API/ParentNode/lastElementChild ---- -<p>{{ APIRef("DOM") }}</p> - -<p><code><strong>Свойство ParentNode.lastElementChild</strong></code> только для чтения. Возвращает последний дочерний элемент объекта или <code>null</code> если нет дочерних элементов.</p> - -<div class="note"> -<p>This property was initially defined in the {{domxref("ElementTraversal")}} pure interface. As this interface contained two distinct set of properties, one aimed at {{domxref("Node")}} that have children, one at those that are children, they have been moved into two separate pure interfaces, {{domxref("ParentNode")}} and {{domxref("ChildNode")}}. In this case, <code>lastElementChild</code> moved to {{domxref("ParentNode")}}. This is a fairly technical change that shouldn't affect compatibility.</p> -</div> - -<h2 id="Syntax_and_values" name="Syntax_and_values">Синтаксис</h2> - -<pre class="syntaxbox">var <em>element</em> = node.lastElementChild; </pre> - -<h2 id="Example" name="Example">Пример</h2> - -<pre class="brush: html"><ul id="foo"> - <li>First (1)</li> - <li>Second (2)</li> - <li>Third (3)</li> -</ul> - -<script> -var foo = document.getElementById('foo'); -// yields: Third (3) -console.log(foo.lastElementChild.textContent); -</script> -</pre> - -<h2 id="Polyfill_for_IE8_IE9_and_Safari">Polyfill for IE8, IE9 and Safari</h2> - -<pre class="brush: js">// Overwrites native 'lastElementChild' prototype. -// Adds Document & DocumentFragment support for IE9 & Safari. -// Returns array instead of HTMLCollection. -;(function(constructor) { - if (constructor && - constructor.prototype && - constructor.prototype.lastElementChild == null) { - Object.defineProperty(constructor.prototype, 'lastElementChild', { - get: function() { - var node, nodes = this.childNodes, i = nodes.length - 1; - while (node = nodes[i--]) { - if (node.nodeType === 1) { - return node; - } - } - return null; - } - }); - } -})(window.Node || window.Element); -</pre> - -<h2 id="Спецификация">Спецификация</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Specification</th> - <th scope="col">Status</th> - <th scope="col">Comment</th> - </tr> - <tr> - <td>{{SpecName('DOM WHATWG', '#dom-parentnode-lastelementchild', 'ParentNode.lastElementChild')}}</td> - <td>{{Spec2('DOM WHATWG')}}</td> - <td>Splitted the <code>ElementTraversal</code> interface in {{domxref("ChildNode")}} and <code>ParentNode</code>. This method is now defined on the latter.<br> - The {{domxref("Document")}} and {{domxref("DocumentFragment")}} implemented the new interfaces.</td> - </tr> - <tr> - <td>{{SpecName('Element Traversal', '#attribute-lastElementChild', 'ElementTraversal.lastElementChild')}}</td> - <td>{{Spec2('Element Traversal')}}</td> - <td>Added its initial definition to the <code>ElementTraversal</code> pure interface and use it on {{domxref("Element")}}.</td> - </tr> - </tbody> -</table> - -<h2 id="Совместимость_с_браузерами">Совместимость с браузерами</h2> - -<p>{{ CompatibilityTable() }}</p> - -<div id="compat-desktop"> -<table class="compat-table"> - <tbody> - <tr> - <th>Feature</th> - <th>Chrome</th> - <th>Firefox (Gecko)</th> - <th>Internet Explorer</th> - <th>Opera</th> - <th>Safari</th> - </tr> - <tr> - <td>Basic support (on {{domxref("Element")}})</td> - <td>1.0</td> - <td>{{CompatGeckoDesktop("1.9.1")}}</td> - <td>9.0</td> - <td>10.0</td> - <td>4.0</td> - </tr> - <tr> - <td>Support on {{domxref("Document")}} and {{domxref("DocumentFragment")}} {{experimental_inline}}</td> - <td>29.0</td> - <td>{{CompatGeckoDesktop("25.0")}}</td> - <td>{{CompatNo}}</td> - <td>16.0</td> - <td>{{CompatNo}}</td> - </tr> - </tbody> -</table> -</div> - -<div id="compat-mobile"> -<table class="compat-table"> - <tbody> - <tr> - <th>Feature</th> - <th>Android</th> - <th>Firefox Mobile (Gecko)</th> - <th>IE Mobile</th> - <th>Opera Mobile</th> - <th>Safari Mobile</th> - </tr> - <tr> - <td>Basic support (on {{domxref("Element")}})</td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{CompatGeckoMobile("1.9.1")}}</td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatVersionUnknown() }}</td> - <td>{{ CompatVersionUnknown() }}</td> - </tr> - <tr> - <td>Support on {{domxref("Document")}} and {{domxref("DocumentFragment")}} {{experimental_inline}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatGeckoMobile("25.0")}}</td> - <td>{{CompatNo}}</td> - <td>16.0</td> - <td>{{CompatNo}}</td> - </tr> - </tbody> -</table> -</div> - - - -<h2 id="Так_же_смотрите">Так же смотрите</h2> - -<ul> - <li>The {{domxref("ParentNode")}} and {{domxref("ChildNode")}} pure interfaces.</li> - <li> - <div class="syntaxbox">Object types implementing this pure interface: {{domxref("Document")}}, {{domxref("Element")}}, and {{domxref("DocumentFragment")}}.</div> - </li> -</ul> diff --git a/files/ru/orphaned/web/api/parentnode/prepend/index.html b/files/ru/orphaned/web/api/parentnode/prepend/index.html deleted file mode 100644 index 489d85a390..0000000000 --- a/files/ru/orphaned/web/api/parentnode/prepend/index.html +++ /dev/null @@ -1,134 +0,0 @@ ---- -title: ParentNode.prepend() -slug: orphaned/Web/API/ParentNode/prepend -translation_of: Web/API/ParentNode/prepend -original_slug: Web/API/ParentNode/prepend ---- -<div>{{APIRef("DOM")}}</div> - -<p>Метод <strong><code>ParentNode.prepend()</code></strong> вставляет множество объектов {{domxref("Node")}} или {{domxref("DOMString")}} в начало (перед первым потомком) {{domxref("ParentNode")}}. Объекты {{domxref("DOMString")}} вставляются как {{domxref("Text")}}.</p> - -<h2 id="Синтаксис">Синтаксис</h2> - -<pre class="syntaxbox"><em>ParentNode</em>.prepend(<em>...nodesToPrepend</em>); -</pre> - -<h3 id="Параметры">Параметры</h3> - -<dl> - <dt><code>nodesToPrepend</code></dt> - <dd>Один или болле узлов, которые вставляются перед первым дочерним узлом в <code>ParentNode</code>. Каждый узел может быть определён либо как {{domxref("Node")}} - объект, либо как строка; строки вставляются как новые узлы типа {{domxref("Text")}}.</dd> -</dl> - -<h3 id="Возвращаемое_значение">Возвращаемое значение</h3> - -<p><code>undefined</code>.</p> - -<h3 id="Исключения">Исключения</h3> - -<ul> - <li>{{domxref("HierarchyRequestError")}}: Узел не может быть вставлен в указанную позицию данной иерархии.</li> -</ul> - -<h2 id="Примеры">Примеры</h2> - -<h3 id="Добавление_элемента_в_начало">Добавление элемента в начало</h3> - -<pre class="brush: js">var parent = document.createElement("div"); -var p = document.createElement("p"); -var span = document.createElement("span"); -parent.append(p); -parent.prepend(span); - -console.log(parent.childNodes); // NodeList [ <span>, <p> ] -</pre> - -<h3 id="Добавление_текста_в_начало">Добавление текста в начало</h3> - -<pre class="brush: js">var parent = document.createElement("div"); -parent.append("Some text"); -parent.prepend("Headline: "); - -console.log(parent.textContent); // "Headline: Some text"</pre> - -<h3 id="Добавление_элемента_и_текста">Добавление элемента и текста</h3> - -<pre class="brush: js">var parent = document.createElement("div"); -var p = document.createElement("p"); -parent.prepend("Some text", p); - -console.log(parent.childNodes); // NodeList [ #text "Some text", <p> ]</pre> - -<h3 id="ParentNode.prepend_не_имеет_области_видимости"><code>ParentNode.prepend()</code> не имеет области видимости</h3> - -<p>Метод <code>prepend()</code> не входит в область видимости оператора <code>with</code>. Смотрите {{jsxref("Symbol.unscopables")}} для детальной информации.</p> - -<pre class="brush: js">var parent = document.createElement("div"); - -with(parent) { - prepend("foo"); -} -// ReferenceError: prepend is not defined </pre> - -<h2 id="Полифил">Полифил</h2> - -<p>Вы можете использовать полифил, если метод <code>prepend()</code> не доступный:</p> - -<pre class="brush: js">// Source: https://github.com/jserz/js_piece/blob/master/DOM/ParentNode/prepend()/prepend().md -(function (arr) { - arr.forEach(function (item) { - if (item.hasOwnProperty('prepend')) { - return; - } - Object.defineProperty(item, 'prepend', { - configurable: true, - enumerable: true, - writable: true, - value: function prepend() { - var argArr = Array.prototype.slice.call(arguments), - docFrag = document.createDocumentFragment(); - - argArr.forEach(function (argItem) { - var isNode = argItem instanceof Node; - docFrag.appendChild(isNode ? argItem : document.createTextNode(String(argItem))); - }); - - this.insertBefore(docFrag, this.firstChild); - } - }); - }); -})([Element.prototype, Document.prototype, DocumentFragment.prototype]);</pre> - -<h2 id="Спецификация">Спецификация</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Specification</th> - <th scope="col">Status</th> - <th scope="col">Comment</th> - </tr> - <tr> - <td>{{SpecName('DOM WHATWG', '#dom-parentnode-prepend', 'ParentNode.prepend()')}}</td> - <td>{{Spec2('DOM WHATWG')}}</td> - <td>Initial definition.</td> - </tr> - </tbody> -</table> - -<h2 id="Поддержка_браузерами">Поддержка браузерами</h2> - - - -<p>{{Compat("api.ParentNode.prepend")}}</p> - -<h2 id="Смотрите_также">Смотрите также</h2> - -<ul> - <li>{{domxref("ParentNode")}} and {{domxref("ChildNode")}}</li> - <li>{{domxref("ParentNode.append()")}}</li> - <li>{{domxref("Node.appendChild()")}}</li> - <li>{{domxref("Node.insertBefore()")}}</li> - <li>{{domxref("ChildNode.before()")}}</li> - <li>{{domxref("NodeList")}}</li> -</ul> diff --git a/files/ru/orphaned/web/api/rtcpeerconnection/getdefaulticeservers/index.html b/files/ru/orphaned/web/api/rtcpeerconnection/getdefaulticeservers/index.html deleted file mode 100644 index d02bdfae84..0000000000 --- a/files/ru/orphaned/web/api/rtcpeerconnection/getdefaulticeservers/index.html +++ /dev/null @@ -1,57 +0,0 @@ ---- -title: RTCPeerConnection.getDefaultIceServers() -slug: orphaned/Web/API/RTCPeerConnection/getDefaultIceServers -translation_of: Web/API/RTCPeerConnection/getDefaultIceServers -original_slug: Web/API/RTCPeerConnection/getDefaultIceServers ---- -<p>{{APIRef("WebRTC")}}{{SeeCompatTable}}</p> - -<p>Метод <code><strong>getDefaultIceServers()</strong></code> интерфейса {{domxref("RTCPeerConnection")}} , возвращает массив объектов {{domxref("RTCIceServer")}}, который указывает, какие серверы ICE браузер будет использовать по умолчанию, если они не указаны в параметре {{domxref("RTCConfiguration")}} конструктора {{domxref("RTCPeerConnection")}} </p> - -<h2 id="Синтаксис">Синтаксис</h2> - -<pre class="syntaxbox notranslate"> var <em>defaultIceServers</em> = <em>RTCPeerConnection</em>.getDefaultIceServers();</pre> - -<h3 id="Возвращаемое_значение">Возвращаемое значение</h3> - -<p>Массив ICE серверов, определяемые как объекты класса {{domxref("RTCIceServer")}} , которые браузер будет использовать для соединения, если иное не определено в параметре - объекте конфигурации конструктора {{domxref("RTCPeerConnection")}}. Если в браузере нет значений по умолчанию, массив будет пуст. Значение свойства не может быть <code>null</code>.</p> - -<h2 id="Пример">Пример</h2> - -<pre class="brush: js notranslate">var pc = new RTCPeerConnection(); -var iceServers = pc.getDefaultIceServers(); - -if (iceServers.length === 0) { - // Решить проблему отсутствия серверов ICE по умолчанию, возможно, используя наши собственные настройки по умолчанию.</pre> - -<h2 id="Спецификации">Спецификации</h2> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Спецификация</th> - <th scope="col">Статус</th> - <th scope="col">Комментарий</th> - </tr> - </thead> - <tbody> - <tr> - <td><a href="https://w3c.github.io/webrtc-extensions/#dom-rtcpeerconnection-getdefaulticeservers">WebRTC Extensions</a></td> - <td></td> - <td></td> - </tr> - </tbody> -</table> - -<h2 id="Совместимость_с_браузерами">Совместимость с браузерами</h2> - - - -<p>{{Compat("api.RTCPeerConnection.getDefaultIceServers")}}</p> - -<h2 id="Смотрите_также">Смотрите также</h2> - -<ul> - <li><a href="/en-US/docs/Web/Guide/API/WebRTC">WebRTC</a></li> - <li>{{domxref("RTCConfiguration")}}</li> -</ul> diff --git a/files/ru/orphaned/web/api/serviceworkerstate/index.html b/files/ru/orphaned/web/api/serviceworkerstate/index.html deleted file mode 100644 index 7b6b3f87c2..0000000000 --- a/files/ru/orphaned/web/api/serviceworkerstate/index.html +++ /dev/null @@ -1,47 +0,0 @@ ---- -title: ServiceWorkerState -slug: orphaned/Web/API/ServiceWorkerState -translation_of: Web/API/ServiceWorkerState -original_slug: Web/API/ServiceWorkerState ---- -<div>{{APIRef("Service Workers API")}}</div> - -<p><code><strong>ServiceWorkerState</strong></code> показывает состояние {{DOMxRef("ServiceWorker")}}'а.</p> - -<h2 id="Значения">Значения</h2> - -<dl> - <dt><code>installing</code></dt> - <dd>Service worker устанавливается. В этом состоянии, метод {{DOMxRef("ExtendableEvent.waitUntil()")}} может быть вызван в обработчике события <code>install</code> для продления установки до успешного завершения переданного промиса. Как правило, данный метод используется для того, чтобы избежать активации service worker'а до завершения настройки его кеша.</dd> - <dt><code>installed</code></dt> - <dd>Service worker находится в состоянии ожидания и будет активирован после закрытия всех страниц его источника, использующих предыдущую версию service worker'а.</dd> - <dt><code>activating</code></dt> - <dd>Service worker в данном состоянии считается активным. В этом состоянии, метод {{DOMxRef("ExtendableEvent.waitUntil()")}} может быть вызван в обработчике события <code>onactivate</code> для продления этапа активации до успешного завершения переданного промиса. Service worker не начнёт обрабатывать события до перехода в состояние <font face="consolas, Liberation Mono, courier, monospace"><span style="background-color: rgba(220, 220, 220, 0.5);">activated</span></font>.</dd> - <dt><code>activated</code></dt> - <dd>Service worker в данном состоянии активен и готов обрабатывать события.</dd> - <dt><code>redundant</code></dt> - <dd>Новый service worker заменяет данный либо service worker удаляется из-за ошибки при его установке.</dd> -</dl> - -<h2 id="Спецификации">Спецификации</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Спецификация</th> - <th scope="col">Статус</th> - <th scope="col">Комментарии</th> - </tr> - <tr> - <td>{{SpecName("Service Workers", "#service-worker-state-enum", "ServiceWorkerState")}}</td> - <td>{{Spec2("Service Workers")}}</td> - <td>Изначальное определение.</td> - </tr> - </tbody> -</table> - -<h2 id="Смотрите_также">Смотрите также</h2> - -<ul> - <li>{{DOMxRef("ServiceWorker.state")}}</li> -</ul> diff --git a/files/ru/orphaned/web/api/web_crypto_api/checking_authenticity_with_password/index.html b/files/ru/orphaned/web/api/web_crypto_api/checking_authenticity_with_password/index.html deleted file mode 100644 index 903e7cc7a2..0000000000 --- a/files/ru/orphaned/web/api/web_crypto_api/checking_authenticity_with_password/index.html +++ /dev/null @@ -1,34 +0,0 @@ ---- -title: Проверка подлинности данных с паролем -slug: orphaned/Web/API/Web_Crypto_API/Checking_authenticity_with_password -tags: - - HMAC - - Web Crypto -translation_of: Web/API/Web_Crypto_API/Checking_authenticity_with_password -original_slug: Web/API/Web_Crypto_API/Checking_authenticity_with_password ---- -<p>{{APIRef("Web Crypto API")}}{{draft}}</p> - -<p>Проверка подлинности данных может быть выполнена с помощью Web Crypto API. В этой статье мы покажем как создавать и управлять подписями, используя хэш-функцию и пароль.</p> - -<p>HMAC алгоритм генерирует хэш на основе передаваемых ключа и данных, которые нужно подписать. Позже, идентичный хэш может быть вычислен заново любым пользователем, у которого имеется ключ. Необходимость ключа позволяет хранить данные и хэш вместе: злоумышленник не сможет создать хэш для изменённых данных, не имея ключа.</p> - -<p>Стоит заметить, что алгоритм никак не связан с какой-либо другой информацией о владельце: знание ключа – необходимое и достаточное условие для изменения данных.</p> - -<p>Предположим, данные хранятся на компьютере. Чтобы получить доступ к записи или чтению, мы будем использовать <code>localforage.js</code> – библиотека-обёртка над хранилищами браузера. Эта библиотека необязательна и используется в качестве примера для удобства, чтобы сосредоточиться на криптографии.</p> - -<p>Данные, доступ к которым мы хотим получить, имеют следующую форму:</p> - -<p> </p> - -<p>где <code>data</code><em> </em>– данные для подписания и <code>signature</code> – подпись, информация для проверки подлинности.</p> - -<p>Криптографические ключи невозможно выучить наизусть, а обычные пароли недостаточно безопасны. Чтобы решить эту проблему, криптографы создали алгоритмы для создания криптографических ключей из паролей. Знание пароля позволяет воссоздать ключ и использовать его.</p> - -<p>Запрашиваем пароль у пользователя для генерации ключа:</p> - -<pre> </pre> - -<p>С этим ключом мы можем вычислить хэш данных.</p> - -<pre> </pre> diff --git a/files/ru/orphaned/web/css/image-set()/index.html b/files/ru/orphaned/web/css/image-set()/index.html deleted file mode 100644 index d17756359a..0000000000 --- a/files/ru/orphaned/web/css/image-set()/index.html +++ /dev/null @@ -1,79 +0,0 @@ ---- -title: image-set() -slug: orphaned/Web/CSS/image-set() -translation_of: Web/CSS/image-set() -original_slug: Web/CSS/image-set() ---- -<div>{{cssref}}</div> - -<p class="summary">CSS функция <code>image-set()</code> это способ позволить браузеру выбрать наиболее подходящее изображение CSS из заданного набора, в первую очередь для экранов с высокой плотностью пикселей.</p> - -<p>Разрешение экрана и пропускная способность могут отличаться в зависимости от устройства и доступа к сети. Функция <code>image-set()</code> обеспечивает наиболее подходящее разрешение изображения для устройства пользователя, предоставляя набор параметров изображения — каждый с соответствующим объявлением разрешения — из которых браузер выбирает наиболее подходящее для устройства и настроек. Разрешение может использоваться в качестве прокси для размера файла — клиент на медленном мобильном соединении с экраном высокого разрешения может предпочесть получать изображения с более низким разрешением, а не ждать загрузки изображения с более высоким разрешением.</p> - -<p><code>image-set()</code> позволяет автору предоставлять параметры, а не определять, что нужно каждому отдельному пользователю.</p> - -<h2 id="Синтаксис">Синтаксис</h2> - -<pre class="syntaxbox notranslate">image-set() = image-set( <image-set-option># ) -где <image-set-option> = [ <image> | <string> ] <resolution> и - <string> в качестве <url> -</pre> - -<h3 id="Значения">Значения</h3> - -<p>Чаще всего вы можете увидеть значение <code>url()</code> как <code><string></code>, но <code><a href="/en-US/docs/Web/CSS/image"><image></a></code> может быть любым типом изображения, кроме набора изображений. Функция <code>image-set()</code> не может быть вложена в другую функцию <code>image-set()</code>.</p> - -<p>Блоки <code><a href="/en-US/docs/Web/CSS/resolution"><resolution></a></code> включают в себя <code>x</code> или <code>ddpx,</code> для точек на пиксель, <code>dpi</code> для точек на дюйм, и <code>dpcm</code> для точек на сантиметр. Каждое изображение в наборе <code>image-set()</code> должно иметь уникальное разрешение.</p> - -<h2 id="Примеры">Примеры</h2> - -<pre class="brush: css notranslate">background-image: image-set( "cat.png" 1x, - "cat-2x.png" 2x, - "cat-print.png" 600dpi);</pre> - -<p>Этот пример демонстрирует использование <code><a class="css" href="https://drafts.csswg.org/css-images-4/#funcdef-image-set" id="ref-for-funcdef-image-set⑨">image-set()</a></code> для обеспечения двух альтернативных {{cssxref("background-image")}} свойств, из которых будет выбрано более подходящее по разрешению: обычная версия и версия с высоким разрешением.</p> - -<h2 id="Вопросы_доступности">Вопросы доступности</h2> - -<p>Браузеры не предоставляют никакой специальной информации о фоновых изображениях для вспомогательных технологий. Это важно прежде всего для экранных считывающих технологий, так как они не объявят о своём присутствии и поэтому ничего не передадут своим пользователям. Если изображение содержит информацию, критически важную для понимания общего назначения страницы, лучше описать её семантически в документе.</p> - -<ul> - <li><a href="https://developer.mozilla.org/en-US/docs/Web/Accessibility/Understanding_WCAG/Perceivable#Guideline_1.1_%E2%80%94_Providing_text_alternatives_for_non-text_content">MDN Understanding WCAG, Guideline 1.1 explanations</a></li> - <li><a class="external external-icon" href="https://www.w3.org/TR/2016/NOTE-UNDERSTANDING-WCAG20-20161007/text-equiv-all.html" rel="noopener">Understanding Success Criterion 1.1.1 | W3C Understanding WCAG 2.0</a></li> -</ul> - -<h2 id="Спецификации">Спецификации</h2> - -<table class="standard-table"> - <thead> - <tr> - <th>Спецификация</th> - <th>Статус</th> - <th>Комментарий</th> - </tr> - </thead> - <tbody> - <tr> - <td>{{SpecName('CSS4 Images', '#image-set-notation', 'The image-set() notation')}}</td> - <td>{{Spec2('CSS4 Images')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Browser_compatibility" name="Browser_compatibility">Поддержка браузерами</h2> - - - -<p>{{Compat("css.types.image.image-set")}}</p> - -<h2 id="See_also" name="See_also">Смотрите также</h2> - -<ul> - <li>{{cssxref("image")}}</li> - <li>{{cssxref("_image", "image()")}}</li> - <li>{{cssxref("element")}}</li> - <li>{{cssxref("url")}}</li> - <li>{{cssxref("<gradient>")}}</li> - <li>{{cssxref("cross-fade")}}</li> -</ul> diff --git a/files/ru/orphaned/web/css/linear-gradient()/index.html b/files/ru/orphaned/web/css/linear-gradient()/index.html deleted file mode 100644 index d2d6fd3bf9..0000000000 --- a/files/ru/orphaned/web/css/linear-gradient()/index.html +++ /dev/null @@ -1,213 +0,0 @@ ---- -title: linear-gradient() -slug: orphaned/Web/CSS/linear-gradient() -tags: - - Градиент - - Линейный градиент -translation_of: Web/CSS/linear-gradient() -original_slug: Web/CSS/linear-gradient() ---- -<div>{{CSSRef}}</div> - -<p><a href="/en-US/docs/Web/CSS">CSS</a>-функция <strong><code>linear-gradient()</code></strong> создаёт изображение, состоящее из постепенного перехода между двумя или более цветами вдоль прямой линии. Её результатом является объект типа данных {{CSSxRef("<gradient>")}}, являющийся особым видом {{CSSxRef("<image>")}}.</p> - -<div>{{EmbedInteractiveExample("pages/css/function-linear-gradient.html")}}</div> - -<div class="hidden">Исходник для этого интерактивного примера хранится в GitHub-репозитории. Если вы хотите внести свой вклад в проект интерактивных примеров, пожалуйста клонируйте <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> и отправьте нам запрос на извлечение.</div> - -<p>Как и в случае с любым градиентом, линейный градиент не имеет <a href="/en-US/docs/CSS/image#no_intrinsic">внутренних размеров</a>; т. е., он не имеет ни естественного или предпочтительного размера, ни предпочтительного соотношения сторон. Его фактический размер будет совпадать с размеров элемента, к которому он применён.</p> - -<p>Для создания линейного градиента, повторяющегося таким образом, что он заполняет содержащий его элемент, лучше используйте функцию {{CSSxRef("repeating-linear-gradient")}}.</p> - -<p>Так как <code><gradient></code>ы относятся к типу данных <code><image></code>, они могут использоваться только там, где может использоваться <code><image></code>. По этой причине, <code>linear-gradient()</code> не будет работать в качестве {{CSSxRef("background-color")}} и других свойств, использующих тип данных {{CSSxRef("<color>")}}.</p> - -<h2 id="Создание_линейного_градиента">Создание линейного градиента</h2> - -<p>Линейный градиент определяется осью — <em>линией градиента</em> — и двумя или более <em>точками остановки цвета</em>. Каждая точка на оси – это определённый цвет; для создания плавного градиента функция <code>linear-gradient()</code> рисует серию цветных линий, перпендикулярных линии градиента, каждая из них соответствует цвету точки, в которой она пересекает линию градиента.</p> - -<p><img alt="linear-gradient.png" src="/files/3537/linear-gradient.png" style="float: left; height: 383px; width: 309px;"></p> - -<p>Линия градиента определена центром блока, содержащего изображение градиента, и углом. Цвета градиента задаются двумя или более точками: начальной точкой, конечной точкой, и необязательными точками остановки цвета между ними.</p> - -<p><em>Начальная точка</em> – это место на линии градиента, где начинается первый цвет. <em>Конечная точка</em> – это точка, на которой заканчивается последний цвет. Каждая из этих двух точек определяется пересечением линии градиента с перпендикулярной линией, проходящей от угла, находящегося в том же квадранте блока. Конечную точку можно просто считать как точку, симметричную начальной точке. Эти несколько сложные определения приводят к интересному эффекту, иногда называемому <em>магическими углами</em>: углы, ближайшие к начальной и конечной точке, имеют те же цвета, что и соответствующая им начальная или конечная точка.</p> - -<h3 id="Настройка_градиентов">Настройка градиентов</h3> - -<p>Добавляя больше точек остановки цвета на линию градиента, вы можете точно задавать переходы между разными цветами. Позиции остановок цвета могут быть явно заданы использованием значений типа {{CSSxRef("<length>")}} или {{CSSxRef("<percentage>")}}. Если вы не определите расположение цвета, он будет расположен посередине между предыдущим и следующим цветом. Следующие два градиента эквивалентны.</p> - -<pre class="brush: css">linear-gradient(red, orange, yellow, green, blue); -linear-gradient(red 0%, orange 25%, yellow 50%, green 75%, blue 100%);</pre> - -<p>По умолчанию цвета переходят плавно от цвета на одной точке остановки до цвета на следующей точке остановки, по середине которого – точка, являющаяся половиной перехода от одного цвета к другому. Вы можете двигать эту среднюю точку в любую позицию между двумя точками остановки цвета, добавляя цветовую подсказку в виде значения в % между двумя цветами для того, чтобы обозначить, где должна находиться середина цветового перехода. В следующем примере показан чисто красный цвет от начала до отметки 10% и чисто синий от 90% до конца. Между 10% и 90% цвет переходит от красного до синего, однако середина цветового перехода находится на отметке 30%, а не на 50%, как было бы без добавления цветовой подсказки 30%.</p> - -<pre class="brush: css">linear-gradient(red 10%, 30%, blue 90%);</pre> - -<p>Если две или более точки остановки цвета находятся в одной и той же позиции, переход будет в виде чёткой линии между первым и последним цветом, объявленным на этой позиции.</p> - -<p>Точки остановки цвета должны быть перечислены в порядке возрастания. Соседние точки остановки цвета с меньшим значением переопределят значение предыдущей точки остановки цвета, создавая резкий переход. В примере ниже на позиции 30% происходит замена красного на жёлтый, и затем идёт переход от жёлтого до синего на протяжении 35% длины градиента.</p> - -<pre class="brush: css">linear-gradient(red 40%, yellow 30%, blue 65%); -</pre> - -<p>Допустимо использовать многопозиционную остановку цвета. Цвет может быть объявлен как две смежных точки остановки цвета, если включить его в обе позиции в CSS-объявлении. Следующие три градиента эквивалентны:</p> - -<pre class="brush: css">linear-gradient(red 0%, orange 10%, orange 30%, yellow 50%, yellow 70%, green 90%, green 100%); -linear-gradient(red, orange 10% 30%, yellow 50% 70%, green 90%); -linear-gradient(red 0%, orange 10% 30%, yellow 50% 70%, green 90% 100%);</pre> - -<p>По умолчанию, если на остановку 0% не задан цвет, то на этой точке будет располагаться первый объявленный цвет. Аналогично, последний цвет будет продолжаться до отметки 100%, или будет на отметке 100%, если на этой последней остановке не было объявлено никакой длины.</p> - -<h2 id="Синтаксис">Синтаксис</h2> - -<pre class="language-css" id="css">/* Градиент наклонён на 45 градусов, - начинается с синего, заканчивается красным */ -linear-gradient(45deg, blue, red); - -/* Градиент идёт от правого нижнего до левого верхнего угла, - от синего до красного */ -linear-gradient(to left top, blue, red); - -/* Остановка цвета: градиент идёт снизу вверх, - начинается синим, становится зелёным на 40% своей длины, - и заканчивается красным */ -linear-gradient(0deg, blue, green 40%, red); - -/* Цветовая подсказка: градиент идёт слева направо, - начинается с красного, достигает среднего цвета - на 10% пути длины градиента, - занимая оставшиеся 90% длины переходом в синий */ -linear-gradient(.25turn, red, 10%, blue); - -/* Многопозиционная остановка цвета: градиент повёрнут на 45 градусов, - с красной нижней левой половиной, синей верхней правой половиной, - с чёткой линией на месте перехода градиента из красного в синий */ -linear-gradient(45deg, red 0 50%, blue 50% 100%);</pre> - -<h3 id="Значения">Значения</h3> - -<dl> - <dt><code><side-or-corner></code></dt> - <dd>Позиция начальной точки линии градиента. Если указана, то должна состоять из слова <code>to</code> и максимум до двух ключевых слов включительно: одно обозначает горизонтальную сторону (<code>left</code> или <code>right</code>), а другое – вертикальную сторону (<code>top</code> или <code>bottom</code>). Порядок ключевых слов не важен. Если не определено, то принимает значение <code>to bottom</code>.</dd> - <dd>Значения <code>to top</code>, <code>to bottom</code>, <code>to left</code> и <code>to right</code> эквивалентны углам <code>0deg</code>, <code>180deg</code>, <code>270deg</code> и <code>90deg</code>, соответственно. Другие значения переводятся в значение угла.</dd> - <dt>{{CSSxRef("<angle>")}}</dt> - <dd>Угол направления линии градиента. Значение <code>0deg</code> эквивалентно <code>to top</code>; увеличение значения увеличивает угол поворота по часовой стрелке от этой позиции.</dd> - <dt><code><linear-color-stop></code></dt> - <dd>Значение точки остановки цвета {{CSSxRef("<color>")}}, с последующими одной или двумя необязательными точками остановки (имеющими значение типа {{CSSxRef("<percentage>")}} или {{CSSxRef("<length>")}} вдоль оси градиента).</dd> - <dt><code><color-hint></code></dt> - <dd>Цветовая подсказка – это подсказка для перехода, определяющая, как градиент продвигается между соседними точками остановки цвета. Длина определяет, на какой точке между двумя точками остановки цвет градиента должен достичь среднего значения цветового перехода. Если не указано, средней точкой цветового перехода будет середина между двумя точками остановки цвета.</dd> - <dd> - <div class="note"> - <p><strong>Примечание:</strong> Отрисовка <a href="#Gradient_with_multiple_color_stops">цветовых остановок в CSS-градиентах</a> следует тем же правилам, что и цветовые остановки в <a href="/en-US/docs/Web/SVG/Tutorial/Gradients">SVG-градиентах</a>.</p> - </div> - </dd> -</dl> - -<h3 id="Формальный_синтаксис">Формальный синтаксис</h3> - -<pre class="syntaxbox">linear-gradient( - [ <a href="/en-US/CSS/angle"><angle></a> | to <side-or-corner> ,]? <color-stop-list> ) - \---------------------------------/ \----------------------------/ - Определение линии градиента Список остановок цвета - -где <side-or-corner> = [ left | right ] || [ top | bottom ] - и <color-stop-list> = [ <linear-color-stop> [, <color-hint> ]? ]#, <linear-color-stop> - и <linear-color-stop> = <color> [ <color-stop-length> ]? - и <color-stop-length> = [ <percentage> | <length> ]{1,2} - и <color-hint> = [ <percentage> | <length> ]</pre> - -<h2 id="Примеры">Примеры</h2> - -<h3 id="Градиент_под_углом_45_градусов">Градиент под углом 45 градусов</h3> - -<div class="hidden"> -<pre class="brush: css">body { - width: 100vw; - height: 100vh; -}</pre> -</div> - -<pre class="brush: css">body { - background: linear-gradient(45deg, red, blue); -} -</pre> - -<p>{{EmbedLiveSample("Градиент_под_углом_45_градусов", 120, 120)}}</p> - -<h3 id="Градиент_начинающийся_на_60_линии_градиента">Градиент, начинающийся на 60% линии градиента</h3> - -<div class="hidden"> -<pre class="brush: css">body { - width: 100vw; - height: 100vh; -}</pre> -</div> - -<pre class="brush: css">body { - background: linear-gradient(135deg, orange, orange 60%, cyan); -}</pre> - -<p>{{EmbedLiveSample("Градиент_начинающийся_на_60_линии_градиента", 120, 120)}}</p> - -<h3 id="Градиент_с_многопозиционными_остановками_цвета">Градиент с многопозиционными остановками цвета</h3> - -<p>Этот пример использует многопозиционные остановки цвета, и со смежными цветами, имеющими те же точки остановки цвета, создаёт полосатый эффект.</p> - -<div class="hidden"> -<pre class="brush: css">body { - width: 100vw; - height: 100vh; -}</pre> -</div> - -<pre class="brush: css">body { - background: linear-gradient(to right, - red 20%, orange 20% 40%, yellow 40% 60%, green 60% 80%, blue 80%); -}</pre> - -<p>{{EmbedLiveSample("Градиент_с_многопозиционными_остановками_цвета", 120, 120)}}</p> - -<div class="note"> -<p><strong>Примечание:</strong> Больше примеров смотрите на странице <a href="/en-US/docs/Web/CSS/CSS_Images/Using_CSS_gradients">Использование CSS-градиентов</a>.</p> -</div> - -<h2 id="Спецификации">Спецификации</h2> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Спецификация</th> - <th scope="col">Статус</th> - <th scope="col">Комментарий</th> - </tr> - </thead> - <tbody> - <tr> - <td>{{SpecName('CSS4 Images', '#color-stop-syntax', 'Gradient Color-Stops')}}</td> - <td>{{Spec2('CSS4 Images')}}</td> - <td>Добавлены подсказки по переходам</td> - </tr> - <tr> - <td>{{SpecName('CSS3 Images', '#linear-gradients', 'linear-gradient()')}}</td> - <td>{{Spec2('CSS3 Images')}}</td> - <td>Первоначальное определение</td> - </tr> - </tbody> -</table> - -<h2 id="Совместимость_с_браузерами">Совместимость с браузерами</h2> - - - -<div>{{Compat("css.types.image.gradient.linear-gradient")}}</div> - -<h2 id="Смотрите_также">Смотрите также</h2> - -<ul> - <li><a href="/en-US/docs/Web/CSS/CSS_Images/Using_CSS_gradients">Использование CSS-градиентов</a></li> - <li>Другие градиентные функции: {{CSSxRef("repeating-linear-gradient")}}, {{CSSxRef("radial-gradient")}}, {{CSSxRef("repeating-radial-gradient")}}, {{CSSxRef("conic-gradient")}}, {{CSSxRef("repeating-conic-gradient")}}</li> - <li>{{CSSxRef("<image>")}}</li> - <li>{{cssxref("element()")}}</li> - <li>{{cssxref("_image","image()")}}</li> - <li>{{cssxref("image-set","image-set()")}}</li> - <li>{{cssxref("cross-fade")}}</li> -</ul> diff --git a/files/ru/orphaned/web/css/radial-gradient()/index.html b/files/ru/orphaned/web/css/radial-gradient()/index.html deleted file mode 100644 index 8af2698d29..0000000000 --- a/files/ru/orphaned/web/css/radial-gradient()/index.html +++ /dev/null @@ -1,170 +0,0 @@ ---- -title: radial-gradient() -slug: orphaned/Web/CSS/radial-gradient() -translation_of: Web/CSS/radial-gradient() -original_slug: Web/CSS/radial-gradient() ---- -<div>{{CSSRef}}</div> - -<p><a href="/en-US/docs/Web/CSS">CSS</a> функция <strong><code>radial-gradient()</code></strong> создаёт картинку состоящую из последовательных переходов между двумя и более цветами, которые исходят из заданного центра. Они могут принимать форму круга или эллипса. Результатом функции будет объект типа {{cssxref("<gradient>")}}, который является расширением типа {{cssxref("<image>")}}.</p> - -<div>{{EmbedInteractiveExample("pages/css/function-radial-gradient.html")}}</div> - - - -<p>Как и любой градиент, радиальный градиент не имеет <a href="https://developer.mozilla.org/en-US/docs/CSS/image#no_intrinsic">внутренних размеров</a>, то есть заданных или предпочитаемых размеров, как и заданного коэффициента соотношения сторон. Его итоговый размер будет соответствовать размеру элемента к которому он применён.</p> - -<p>Чтобы создать повторяющийся радиальный градиент, который будет заполнять контейнер, необходимо использовать функцию {{cssxref("repeating-radial-gradient")}}.</p> - -<p>Поскольку <code><gradient>ы</code> относятся к типу <code><image></code>, они могут быть использованы только там где используется тип <code><image></code>. По этой причине <code>radial-gradient()</code> не будет работать совместно с {{Cssxref("background-color")}} и другими свойствами, которые используют тип {{cssxref("<color>")}}.</p> - -<h2 id="Композиция_свойства">Композиция свойства</h2> - -<p><img alt="" src="/files/3795/radial%20gradient.png" style="float: left; height: 176px; width: 396px;">Радиальный градиент задаётся <em>позицией центра</em>, <em>конечной формой</em>, и двумя или более <em>точками изменения цвета</em>.</p> - -<p>Чтобы создать плавный градиент, функция <code>radial-gradient()</code> рисует серию концентрических форм исходящих из центра к краям формы градиента (и потенциально далее за его пределы). Конечная форма может быть как кругом так и эллипсом.</p> - -<p>Точки изменения цвета расположены на <em>виртуальном луче градиента</em>, который расширяется горизонтально направо. Позиция точек заданных в процентах рассчитывается относительно пересечения конечной формы таким лучом, что является <code>100%</code>. Цвет каждой такой формы задаётся цветом на пересечении луча градиента и этой формы.</p> - -<h2 id="Синтаксис">Синтаксис</h2> - -<pre class="brush: css no-line-numbers notranslate">/* Градиент в центре контейнера, - переход от красного к синему и после к зелёному */ -radial-gradient(circle at center, red 0, blue, green 100%)</pre> - -<h3 id="Параметры">Параметры</h3> - -<dl> - <dt>{{cssxref("<position>")}}</dt> - <dd>Позицию начала градиента можно рассматривать как {{cssxref("background-position")}} или {{cssxref("transform-origin")}}. По умолчанию позиция равна <code>center</code>.</dd> - <dt><code><shape></code></dt> - <dd>Форма градиента. Может принимать значение <code>circle</code> (подразумевается что формой является круг с постоянным радиусом) или <code>ellipse</code> (форма является эллипсом, выровненным по оси). По умолчанию имеет значение <code>ellipse</code>.</dd> - <dt><code><extent-keyword></code></dt> - <dd>Параметр определяющий размер конечной формы. Возможные значения:</dd> - <dd> - <table class="standard-table"> - <tbody> - <tr> - <th>Значение</th> - <th>Описание</th> - </tr> - <tr> - <td><code>closest-side</code></td> - <td>Конечная форма градиента соответствует стороне прямоугольника, ближайшей к его центру (для окружностей), или обеим вертикальным и горизонтальным сторонам, ближайшим к центру (для эллипсов).</td> - </tr> - <tr> - <td><code>closest-corner</code></td> - <td>Конечная форма градиента определяется таким образом, чтобы он точно соответствовал ближайшему углу окна от его центра.</td> - </tr> - <tr> - <td><code>farthest-side</code></td> - <td>Схоже с <code>closest-side</code>, кроме того что, размер формы определяется самой дальней стороной от своего центра (или вертикальных и горизонтальных сторон)</td> - </tr> - <tr> - <td><code>farthest-corner</code></td> - <td>Конечная форма градиента определяется таким образом, чтобы он точно соответствовал самому дальнему углу прямоугольника от его центра.</td> - </tr> - </tbody> - </table> - - <div class="note"> - <p><strong>Примечание:</strong> Ранние реализации этой функции включают в себя другие значения свойства (<code>cover</code> and <code>contain</code>) которые являются синонимами <span class="st"><code>farthest-corner</code></span> и <code>closest-side</code>, соответственно. Рекомендуется использовать только стандартные значения, так как некоторые реализации уже перестали использовать старые значения свойств.</p> - </div> - </dd> - <dt><code><color-stop></code></dt> - <dd>{{cssxref("<color>")}} значение цвета в точке изменения цвета за которым следует необязательный параметр позиции ({{cssxref("<percentage>")}} или {{cssxref("<length>")}} вдоль оси градиента). Значения <code>0%</code>, или <code>0</code> представляют центр градиента; значение <code>100%</code> представляет собой виртуальное пересечение конечной формы с виртуальным лучом градиента. Процентные значения будут линейно расположены на луче градиента.</dd> -</dl> - -<h3 id="Синтаксис_2">Синтаксис</h3> - -<pre class="syntaxbox notranslate"><code>radial-gradient( - [ [ circle || <a href="/en-US/docs/CSS/length"><length></a> ] [ at <a href="/en-US/docs/CSS/position_value"><position></a> ]? , | - [ ellipse || [ <a href="/en-US/docs/CSS/length"><length></a> | <a href="/en-US/docs/CSS/percentage"><percentage></a> ]{2} ] [ at <a href="/en-US/docs/CSS/position_value"><position></a> ]? , | - [ [ circle | ellipse ] || <extent-keyword> ] [ at <a href="/en-US/docs/CSS/position_value"><position></a> ]? , | - at <a href="/en-US/docs/CSS/position_value"><position></a> , - ]? - <color-stop> [ , <color-stop> ]+ -) -где <extent-keyword> = closest-corner | closest-side | farthest-corner | farthest-side - и<code> <color-stop> = <color> [ <percentage> | <length> ]?</code> -</code></pre> - -<h2 id="Примеры">Примеры</h2> - -<h3 id="Простой_градиент">Простой градиент</h3> - -<div class="hidden"> -<pre class="brush: html notranslate"><div class="radial-gradient"></div> -</pre> - -<pre class="brush: css notranslate">.radial-gradient { - width: 240px; - height: 120px; -}</pre> -</div> - -<pre class="brush: css notranslate">.radial-gradient { - background-image: radial-gradient(cyan 0%, transparent 20%, salmon 40%); -} </pre> - -<p>{{EmbedLiveSample('Простой_градиент', 120, 120)}}</p> - -<h3 id="Градиент_со_смещённым_центром">Градиент со смещённым центром</h3> - -<div class="hidden"> -<pre class="brush: html notranslate"><div class="radial-gradient"></div> -</pre> - -<pre class="brush: css notranslate">.radial-gradient { - width: 240px; - height: 120px; -}</pre> -</div> - -<pre class="brush: css notranslate">.radial-gradient { - background-image: radial-gradient(farthest-corner at 40px 40px, - #f35 0%, #43e 100%); -}</pre> - -<p>{{EmbedLiveSample('Градиент_со_смещённым_центром', 240, 120)}}</p> - -<div class="note"> -<p><strong>Примечание:</strong> Дополнительные примеры можно найти в <a href="/en-US/docs/Web/CSS/CSS_Images/Using_CSS_gradients">Использование CSS градиентов</a>.</p> -</div> - -<h2 id="Спецификация">Спецификация</h2> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Спецификация</th> - <th scope="col">Статус</th> - <th scope="col">Комментарии</th> - </tr> - </thead> - <tbody> - <tr> - <td>{{SpecName('CSS3 Images', '#radial-gradients', 'radial-gradients()')}}</td> - <td>{{Spec2('CSS3 Images')}}</td> - <td>Initial definition.</td> - </tr> - </tbody> -</table> - -<h2 id="Совместимость_с_браузерами">Совместимость с браузерами</h2> - -<p>{{Compat("css.types.image.gradient.radial-gradient")}}</p> -<h3 id="Сноски_к_Quantum_CSS">Сноски к Quantum CSS</h3> - -<ul> - <li>Gecko имеет долгоиграющий баг благодаря которому значения вроде <code>radial-gradient(circle gold,red)</code> будут работать, даже несмотря на то, что пропущена запятая между <code>circle</code> и <code>gold</code> ({{bug(1383323)}}). Новый parallel CSS движок от Firefox (также известный как <a href="https://wiki.mozilla.org/Quantum">Quantum CSS</a> или <a href="https://wiki.mozilla.org/Quantum/Stylo">Stylo</a>, планируемый к релизу в Firefox 57) исправляет этот баг.</li> - <li>Также в Gecko выражения с {{cssxref("calc")}} считаются недействительными — значение не валидно при использовании в radial-gradient() ({{bug(1376019)}}). Новый parallel CSS движок от Firefox (также известный как <a href="https://wiki.mozilla.org/Quantum">Quantum CSS</a> или <a href="https://wiki.mozilla.org/Quantum/Stylo">Stylo</a>, планируемый к релизу Firefox 57) исправляет этот баг.</li> -</ul> - -<h2 id="Смотрите_также">Смотрите также</h2> - -<ul> - <li><a href="/en-US/docs/CSS/Using_CSS_gradients">Использование CSS градиентов</a></li> - <li>Другие варианты градиентов: {{cssxref("repeating-radial-gradient")}}, {{cssxref("linear-gradient")}}, {{cssxref("repeating-linear-gradient")}}</li> - <li>{{cssxref("<image>")}}</li> -</ul> diff --git a/files/ru/orphaned/web/css/repeating-linear-gradient()/index.html b/files/ru/orphaned/web/css/repeating-linear-gradient()/index.html deleted file mode 100644 index 1e7a560ae3..0000000000 --- a/files/ru/orphaned/web/css/repeating-linear-gradient()/index.html +++ /dev/null @@ -1,135 +0,0 @@ ---- -title: repeating-linear-gradient() -slug: orphaned/Web/CSS/repeating-linear-gradient() -translation_of: Web/CSS/repeating-linear-gradient() -original_slug: Web/CSS/repeating-linear-gradient() ---- -<div>{{CSSRef}}</div> - -<p><a href="/en-US/docs/Web/CSS">CSS</a> функция <strong><code>repeating-linear-gradient()</code></strong> создаёт изображение состоящее из повторяющихся линейных градиентов. Она схожа с {{cssxref("linear-gradient")}} и принимает те же аргументы, но повторяет переходы цветов бесконечно во всех направлениях покрывая весь контейнер. Функция возвращает объект типа {{cssxref("<gradient>")}}, являющегося разновидностью типа данных {{cssxref("<image>")}}.</p> - -<pre class="brush: css no-line-numbers notranslate">/* Повторяющийся градиент с углом наклона 45 градусов, - начинающийся с синего и заканчивающийся красным цветом */ -repeating-linear-gradient(45deg, blue, red); - -/* Повторяющийся градиент идущий от нижнего правого угла к верхнему левому, - начинающийся с синего и заканчивающийся красным цветом */ -repeating-linear-gradient(to left top, blue, red); - -/* Повторяющийся градиент идущий от низа к верху, - начинающийся с синего, переходящего в зелёный на 40%, - и заканчивающийся красным цветом */ -repeating-linear-gradient(0deg, blue, green 40%, red); -</pre> - -<p>С каждым повтором позиции цветов сдвигаются на величину кратную длине базового градиента (расстояние от позиции последнего цвета до позиции первого). Таким образом что позиция каждого последнего цвета совпадает с позицией стартового цвета. И если цвета отличаются это приведёт к резкому визуальному переходу.</p> - -<p>Повторяющийся линейный градиент (как и любой прочий градиент) <a href="https://developer.mozilla.org/en-US/docs/CSS/image#no_intrinsic">не имеет размерностей по умолчанию</a>; т.е. у него нет предопределённого размера либо пропорции. Его размер будет совпадать с размерами элемента к которому он применён.</p> - -<div class="note"> -<p><strong>Примечание:</strong> Поскольку <code><gradient></code> относится к типу данных <code><image></code> , он может быть использован только там где применим тип <code><image></code>. По этой причине <code>repeating-linear-gradient()</code> не будет работать с {{Cssxref("background-color")}} и прочими свойствами использующими тип данных {{cssxref("<color>")}}.</p> -</div> - -<h2 id="Синтаксис">Синтаксис</h2> - -<h3 id="Значения">Значения</h3> - -<dl> - <dt><code><сторона-или-угол></code></dt> - <dd>Положение точки начала линии градиента. Начинается со слова <code>to</code> и максимум двух ключевых слов: одно определяет сторону по горизонтали (<code>left</code> или <code>right</code>), и другое сторону по вертикали (<code>top</code> или <code>bottom</code>). Порядок ключевых слов определяющих сторону не важен. Если они не определены, по умолчанию используется <code><span class="css">to</span></code><span class="css"> </span><code><span class="css">bottom</span></code>.</dd> - <dd>Значения <code>to top</code>, <code>to bottom</code>, <code>to left</code>, и <code>to right</code> эквивалентны углам <code>0deg</code>, <code>180deg</code>, <code>270deg</code>, и <code>90deg</code> соответственно. Прочие значения транслируются в угол.</dd> - <dt>{{cssxref("<angle>", "<угол>")}}</dt> - <dd>Угол наклона линии направления градиента. Значение <code>0deg</code> эквивалентно <code>to top</code>; увеличение значения приводит к повороту линии против часовой стрелки начиная от этой величины (<code>0deg</code>).</dd> - <dt><code><цвет-позиция></code></dt> - <dd>Значение {{cssxref("<color>", "<цвета>")}} с последующей (необязательной) его позицией (либо в {{cssxref("<percentage>", "<процентах>")}}, либо в единицах {{cssxref("<length>", "<длины>")}} вдоль оси градиента).</dd> - <dd> - <div class="note"> - <p><strong>Примечание:</strong> Рендер <a href="#Gradient_with_multiple_color_stops">перехода цветов в CSS градиентах</a> следует тем же правилам что и в <a href="/en-US/docs/Web/SVG/Tutorial/Gradients">SVG градиентах</a>.</p> - </div> - </dd> -</dl> - -<h3 id="Formal_syntax">Formal syntax</h3> - -<pre class="syntaxbox notranslate">repeating-linear-gradient( [ <a href="/en-US/CSS/angle"><угол></a> | to <сторона-или-угол> ,]? <цвет-позиция> [, <цвет-позиция>]+ ) - \---------------------------------/ \----------------------------/ - Определение линии градиента Список цветов и их позиций - -где <code><</code>сторона-или-угол<code>> = [left | right] || [top | bottom]</code> - и <code><</code>цвет-позиция<code>> = <цвет> [ <процент> | <длина> ]?</code> -</pre> - -<h2 id="Примеры">Примеры</h2> - -<h3 id="Полоски_зебры">Полоски зебры</h3> - -<div class="hidden"> -<pre class="brush: css notranslate">body { - width: 100vw; - height: 100vh; -}</pre> -</div> - -<pre class="brush: css notranslate">body { - background-image: repeating-linear-gradient(-45deg, - transparent, - transparent 20px, - black 20px, - black 40px); -} -</pre> - -<p>{{EmbedLiveSample('Полоски_зебры', 120, 120)}}</p> - -<h3 id="Повторяющиеся_горизонтальные_полосы">Повторяющиеся горизонтальные полосы</h3> - -<div class="hidden"> -<pre class="brush: css notranslate">body { - width: 100vw; - height: 100vh; -}</pre> -</div> - -<pre class="brush: css notranslate">body { - background-image: repeating-linear-gradient(to bottom, - rgb(26,198,204), - rgb(26,198,204) 7%, - rgb(100,100,100) 10%); -} -</pre> - -<p>{{EmbedLiveSample('Повторяющиеся_горизонтальные_полосы', 120, 120)}}</p> - -<div class="note"> -<p><strong>Примечание:</strong> Для дополнительных примеров пожалуйста обратитесь к статье <a href="/en-US/docs/Web/CSS/CSS_Images/Using_CSS_gradients">Using CSS gradients</a>.</p> -</div> - -<h2 id="Спецификации">Спецификации</h2> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Спецификация</th> - <th scope="col">Статус</th> - <th scope="col">Примечание</th> - </tr> - </thead> - <tbody> - <tr> - <td>{{SpecName('CSS3 Images', '#repeating-gradients', 'repeating-linear-gradient()')}}</td> - <td>{{Spec2('CSS3 Images')}}</td> - <td>Initial definition.</td> - </tr> - </tbody> -</table> - -<h2 id="Совместимость_с_браузерами">Совместимость с браузерами</h2> - -<div>{{Compat("css.types.image.gradient.repeating-linear-gradient")}}</div> - -<h2 id="Дополнительно">Дополнительно</h2> - -<ul> - <li><a href="/en/CSS/Using_CSS_gradients">Using CSS gradients</a></li> - <li>Другие функции градиентов: {{cssxref("linear-gradient")}}, {{cssxref("radial-gradient")}}, {{cssxref("repeating-radial-gradient")}}</li> -</ul> diff --git a/files/ru/orphaned/web/guide/ajax/с_чего_начать_question_/index.html b/files/ru/orphaned/web/guide/ajax/с_чего_начать_question_/index.html deleted file mode 100644 index 7fbfff4658..0000000000 --- a/files/ru/orphaned/web/guide/ajax/с_чего_начать_question_/index.html +++ /dev/null @@ -1,7 +0,0 @@ ---- -title: С чего начать? -slug: orphaned/Web/Guide/AJAX/С_чего_начать? -original_slug: Web/Guide/AJAX/С_чего_начать? ---- -<p>IKFIA -</p> diff --git a/files/ru/orphaned/web/guide/events/creating_and_triggering_events/index.html b/files/ru/orphaned/web/guide/events/creating_and_triggering_events/index.html deleted file mode 100644 index 8744c80e01..0000000000 --- a/files/ru/orphaned/web/guide/events/creating_and_triggering_events/index.html +++ /dev/null @@ -1,93 +0,0 @@ ---- -title: Создание и вызов событий -slug: orphaned/Web/Guide/Events/Creating_and_triggering_events -tags: - - DOM - - JavaScript - - events - - события -translation_of: Web/Guide/Events/Creating_and_triggering_events -original_slug: Web/Guide/Events/Creating_and_triggering_events ---- -<p>Эта статья демонстрирует, как создавать и вызывать пользовательские DOM-события. Такие события часто называют <strong>искусственными</strong> событиями, по отношению к событиям, производимым браузером.</p> - -<h2 id="Создание_собственных_событий">Создание собственных событий</h2> - -<p>События могут быть созданы с помощью конструктора <code><a href="/ru/docs/Web/API/Event">Event</a></code>:</p> - -<pre class="brush: js">var event = new Event('build'); - -// Подписываемся на событие -elem.addEventListener('build', function (e) { ... }, false); - -// Вызываем событие -elem.dispatchEvent(event);</pre> - -<p>Этот конструктор поддерживается во всех современных браузерах (кроме Internet Explorer). Более подробную информацию смотрите ниже <a href="#The_old-fashioned_way">"Старомодный способ"</a>.</p> - -<h3 id="Добавление_пользовательских_данных_–_CustomEvent()">Добавление пользовательских данных – CustomEvent()</h3> - -<p>Чтобы добавить больше данных к объекту event, существует интерфейс <a href="/ru/docs/Web/API/CustomEvent">CustomEvent</a>, и вы можете использовать свойство <u><strong>detail</strong></u>, чтобы передать собственные данные. Например, событие может быть создано так:</p> - -<pre class="brush: js">var event = new CustomEvent('build', { 'detail': elem.dataset.time });</pre> - -<p>Это позволит вам получить доступ к дополнительным данным в обработчике:</p> - -<pre class="brush: js">function eventHandler(e) { - log('The time is: ' + e.detail); -} -</pre> - -<h3 id="Старомодный_способ"><a id="The_old-fashioned_way" name="The_old-fashioned_way">Старомодный способ</a></h3> - -<p>Старый способ создать событие использует API в стиле Java. Пример:</p> - -<pre class="brush: js">// Создание события -var event = document.createEvent('Event'); - -// Назначить имя событию -event.initEvent('build', true, true); - -// Слушаем событие -document.addEventListener('build', function (e) { - // e.target соответствует объекту document -}, false); - -// target события может быть любой элемент -document.dispatchEvent(event); - -</pre> - -<h2 id="Вызов_встроенных_событий">Вызов встроенных событий</h2> - -<p>Этот пример показывает симуляцию клика (программно сгенерированное событие клика) по галочке чекбокса, используя DOM-методы. <a class="external" href="/samples/domref/dispatchEvent.html">Просмотр действующих примеров.</a></p> - -<pre class="brush: js">function simulateClick() { - var event = new MouseEvent('click', { - 'view': window, - 'bubbles': true, - 'cancelable': true - }); - var cb = document.getElementById('checkbox'); - var canceled = !cb.dispatchEvent(event); - if (canceled) { - // A handler called preventDefault. - alert("canceled"); - } else { - // None of the handlers called preventDefault. - alert("not canceled"); - } -}</pre> - -<h2 id="Browser_compatibility" name="Browser_compatibility" style="line-height: 30px; font-size: 2.14285714285714rem;">Совместимость с браузерами</h2> - -<p>{{Compat("api.Event.Event")}}</p> - -<h2 id="Смотрите_также">Смотрите также</h2> - -<ul> - <li>{{domxref("document.createEvent()")}}</li> - <li>{{domxref("Event.initEvent()")}}</li> - <li>{{domxref("EventTarget.dispatchEvent()")}}</li> - <li>{{domxref("EventTarget.addEventListener()")}}</li> -</ul> diff --git a/files/ru/orphaned/web/guide/events/event_handlers/index.html b/files/ru/orphaned/web/guide/events/event_handlers/index.html deleted file mode 100644 index c30df7b474..0000000000 --- a/files/ru/orphaned/web/guide/events/event_handlers/index.html +++ /dev/null @@ -1,167 +0,0 @@ ---- -title: DOM onevent handlers -slug: orphaned/Web/Guide/Events/Event_handlers -translation_of: Web/Guide/Events/Event_handlers -original_slug: Web/Guide/Events/Event_handlers ---- -<p>Веб-платформа предоставляет несколько способов получения уведомлений о событиях DOM. Два общих подхода - это {{domxref ("EventTarget.addEventListener", " addEventListener ()")}} и конкретные обработчики <span class="seoSummary"><code>on<em>event</em></code> </span> . Эта страница посвящена тому, как работают последние.</p> - -<h2 id="Регистрация_обработчиков_onevent">Регистрация обработчиков onevent</h2> - -<p>Обработчики <strong><code>on<em>event</em></code></strong> - это свойства определённых элементов DOM, позволяющие управлять тем, как этот элемент реагирует на события. Элементы могут быть интерактивными (ссылки, кнопки, изображения, формы и т. д.) или неинтерактивными (например, элемент base <body>). События - это такие действия, как:</p> - -<ul> - <li>Клик мышкой</li> - <li>Нажатие клавиш</li> - <li>Получение фокуса</li> -</ul> - -<p>Обработчик on-event обычно называется с именем события, на которое он реагирует, например <code>on<em>click</em></code> , <code>on<em>keypress</em></code> , <code>on<em>focus</em></code> и т. д.</p> - -<p>Вы можете указать обработчик событий on<...> для конкретного события (например, {{event("click")}}) для данного объекта различными способами:</p> - -<ul> - <li>Добавление HTML элемента {{Glossary("attribute")}} с событием <code>on<em><eventtype></em></code>:<br> - <code><button <strong>onclick="handleClick()"</strong>></code>,</li> - <li>Или установив соответствующий параметр {{Glossary("property/JavaScript", "property")}} из JavaScript:<br> - <code>document.querySelector("button")<strong>.onclick = function(event) { … }</strong></code>.</li> -</ul> - -<p>Свойство обработчика событий <code>on<em>event</em></code> служит своего рода заполнителем, которому может быть назначен один обработчик событий. Чтобы разрешить установку нескольких обработчиков для одного и того же события на данном объекте, вы можете вызвать метод {{domxref("EventTarget.addEventListener", " addEventListener ()")}} , который управляет списком обработчиков для данного события на объекте. Затем обработчик можно удалить из объекта, вызвав его функцию {{domxref ("EventTarget.removeEventListener", "removeEventListener()")}} .</p> - -<p>Когда происходит событие, которое применяется к элементу, каждый из его обработчиков событий вызывается, чтобы позволить им обрабатывать это событие один за другим. Вам не нужно вызывать их самостоятельно, хотя вы можете сделать это во многих случаях, чтобы легко имитировать происходящее событие. Например, учитывая объект кнопки <code>myButton</code> , вы можете сделать <code>myButton.onclick(myEventObject)</code> для прямого вызова обработчика событий. Если обработчик событий не имеет доступа к каким-либо данным из объекта event, вы можете пропустить это событие при вызове функции <code>onclick()</code> .</p> - -<p>This continues until every handler has been called, unless one of the event handlers explicitly halts the processing of the event by calling {{domxref("Event.stopPropagation", "stopPropagation()")}} on the event object itself.</p> - -<p>Это продолжается до тех пор, пока не будет вызван каждый обработчик, если только один из обработчиков событий явно не остановит обработку события, вызвав {{domxref("Event.stopPropagation", " stopPropagation ()")}} на самом объекте события.</p> - -<h3 id="Non-element_objects">Non-element objects</h3> - -<p>Event handlers can also be set with properties on non-element objects that generate events, like {{ domxref("window") }}, {{ domxref("document") }}, {{ domxref("XMLHttpRequest") }}, and others. For example, for the <code>progress</code> event on instances of <code>XMLHttpRequest</code>:</p> - -<pre class="brush: js">const xhr = new XMLHttpRequest(); -xhr.onprogress = function() { … };</pre> - -<h2 id="HTML_onevent_attributes">HTML onevent attributes</h2> - -<p>HTML elements have attributes named <code>on<em>event</em></code> which can be used to register a handler for an event directly within the HTML code. When the element is built from the HTML, the value of its <code>on<em>event</em></code> attributes are copied to the DOM object that represents the element, so that accessing the attributes' values using JavaScript will get the value set in the HTML.</p> - -<p>Further changes to the HTML attribute value can be done via the <a href="https://developer.mozilla.org/en-US/docs/Web/API/Element/setAttribute"><code>setAttribute</code> </a>method; Making changes to the JavaScript property will have no effect.</p> - -<h3 id="HTML">HTML</h3> - -<p>Given this HTML document:</p> - -<pre class="brush: html"><p>Demonstrating quirks of <code>on<em>event</em></code> HTML attributes on - <a onclick="log('Click!')">these three words</a>. -</p> - -<div></div></pre> - -<h3 id="JavaScript">JavaScript</h3> - -<p>Then this JavaScript demonstrates that the value of the HTML attribute is unaffected by changes to the JavaScript object's property.</p> - -<pre class="brush: js">let logElement = document.querySelector('div'); -let el = document.querySelector("a"); - -function log(msg) { logElement.innerHTML += `${msg}<br>` }; -function anchorOnClick(event) { log("Changed onclick handler") }; - -// Original Handler -log(`Element's onclick as a JavaScript property: <code> ${el.onclick.toString()} </code>`); - -//Changing handler using .onclick -log('<br>Changing onclick handler using <strong> onclick property </strong> '); - -el.onclick = anchorOnClick; - -log(`Changed the property to: <code> ${el.onclick.toString()} </code>`); -log(`But the HTML attribute is unchanged: <code> ${el.getAttribute("onclick")} </code><br>`); - -//Changing handler using .setAttribute -log('<hr/><br> Changing onclick handler using <strong> setAttribute method </strong> '); -el.setAttribute("onclick", 'anchorOnClick(event)'); - -log(`Changed the property to: <code> ${el.onclick.toString()} </code>`); -log(`Now even the HTML attribute has changed: <code> ${el.getAttribute("onclick")} </code><br>`);</pre> - -<h3 id="Result">Result</h3> - -<p>{{ EmbedLiveSample('HTML_onevent_attributes', '', '', '', 'Web/Guide/Events/Event_handlers') }}</p> - -<p>For historical reasons, some attributes/properties on the {{HTMLElement("body")}} and {{HTMLElement("frameset")}} elements instead set event handlers on their parent {{domxref("Window")}} object. (The HTML specification names these: <code><a href="/en-US/docs/Web/API/GlobalEventHandlers/onblur">onblur</a></code>, <code><a href="/en-US/docs/Web/API/GlobalEventHandlers/onerror">onerror</a></code>, <code><a href="/en-US/docs/Web/API/GlobalEventHandlers/onfocus">onfocus</a></code>, <code><a href="/en-US/docs/Web/API/GlobalEventHandlers/onload">onload</a></code>, and <code><a href="/en-US/docs/Web/API/GlobalEventHandlers/onscroll">onscroll</a></code>.)</p> - -<h3 id="Event_handlers_parameters_this_binding_and_the_return_value">Event handler's parameters, <code>this</code> binding, and the return value</h3> - -<p>When the event handler is specified as <strong>an HTML attribute</strong>, the specified code is wrapped into a function with <strong>the following parameters</strong>:</p> - -<ul> - <li><code>event</code> — for all event handlers except {{domxref("GlobalEventHandlers.onerror", "onerror")}}.</li> - <li><code>event</code>, <code>source</code>, <code>lineno</code>, <code>colno</code>, and <code>error</code> for the {{domxref("GlobalEventHandlers.onerror", "onerror")}} event handler. Note that the <code>event</code> parameter actually contains the error message as a string.</li> -</ul> - -<p>When the event handler is invoked, the <code>this</code> keyword inside the handler is set to the DOM element on which the handler is registered. For more details, see <a href="/en-US/docs/Web/JavaScript/Reference/Operators/this#In_an_inline_event_handler">the <code>this</code> keyword documentation</a>.</p> - -<p>The return value from the handler determines if the event is canceled. The specific handling of the return value depends on the kind of event; for details, see <a href="https://html.spec.whatwg.org/multipage/webappapis.html#the-event-handler-processing-algorithm">"The event handler processing algorithm" in the HTML specification</a>.</p> - -<h3 id="When_the_event_handler_is_invoked">When the event handler is invoked</h3> - -<div class="blockIndicator note"> -<p>TBD (non-capturing listener)</p> -</div> - -<h3 id="Terminology">Terminology</h3> - -<p>The term <strong>event handler</strong> may refer to:</p> - -<ul> - <li>Any function or object that is registered to be notified of events</li> - <li>Or more specifically, to the mechanism of registering event listeners via <code>on…</code> attributes in HTML or properties in Web APIs, such as <code><button onclick="alert(this)"></code> or <code>window.onload = function() { … }</code>.</li> -</ul> - -<p>When discussing the various methods of listening to events:</p> - -<ul> - <li><strong>Event listener</strong> refers to a function or object registered via {{domxref("EventTarget.addEventListener()")}}</li> - <li><strong>Event handler</strong> refers to a function registered via <code>on…</code> attributes or properties</li> -</ul> - -<h2 id="Specifications" name="Specifications">Specifications</h2> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Specification</th> - <th scope="col">Status</th> - <th scope="col">Comment</th> - </tr> - </thead> - <tbody> - <tr> - <td>{{SpecName('HTML WHATWG', 'webappapis.html#event-handler-attributes', 'event handlers')}}</td> - <td>{{Spec2('HTML WHATWG')}}</td> - <td></td> - </tr> - <tr> - <td>{{SpecName('HTML5 W3C', 'webappapis.html#event-handler-attributes', 'event handlers')}}</td> - <td>{{Spec2('HTML5 W3C')}}</td> - <td></td> - </tr> - </tbody> -</table> - -<h2 id="Browser_Compatibility" name="Browser_Compatibility">Browser compatibility</h2> - -<h4 id="Detecting_the_presence_of_event_handler_properties">Detecting the presence of event handler properties</h4> - -<p>You can detect the presence of an event handler property with the JavaScript <a href="/en-US/JavaScript/Reference/Operators/in" title="en/JavaScript/Reference/Operators/in"><code>in</code></a> operator. For example:</p> - -<pre class="brush: js">if ("onsomenewfeature" in window) { - /* do something amazing */ -} -</pre> - -<h4 id="Event_handlers_and_prototypes">Event handlers and prototypes</h4> - -<p>You can't set or access the values of any IDL-defined attributes on DOM prototype objects. That means you can't, for example, change <code>Window.prototype.onload</code>. In the past, event handlers (<code>onload</code>, etc.) weren't implemented as IDL attributes in Gecko, so you were able to do this for those. Now you can't. This improves compatibility.</p> diff --git a/files/ru/orphaned/web/guide/events/index.html b/files/ru/orphaned/web/guide/events/index.html deleted file mode 100644 index 955e0d2d21..0000000000 --- a/files/ru/orphaned/web/guide/events/index.html +++ /dev/null @@ -1,60 +0,0 @@ ---- -title: Руководство разработчика событий -slug: orphaned/Web/Guide/Events -tags: - - DOM - - Event - - Guide - - NeedsTranslation - - NeedsUpdate - - TopicStub -translation_of: Web/Guide/Events -original_slug: Web/Guide/Events ---- -<p>{{draft()}}</p> - -<p>События связаны с:</p> - -<ul> - <li>Шаблонами проектирования, использующимися для асинхронной обработки инцидентов, возникающих в жизненном цикле веб страницы</li> - <li>Именованием, характеризацией и использованием большого количества инцидентов различного типа</li> -</ul> - -<p>Статья <a href="/en-US/docs/Web/Guide/API/DOM/Events/Overview_of_Events_and_Handlers">Overview page</a> содержит в краткой манере описание шаблонов проектирования и типов определяемых современными браузерами инцидентов</p> - -<div></div> - -<p><a href="/en-US/docs/Web/Guide/API/DOM/Events/Creating_and_triggering_events">Custom events page</a> <span id="result_box" lang="ru"><span class="hps">описывает, как</span> <span class="hps">шаблон кода события</span> <span class="hps">может быть использован в</span> <span class="hps">пользовательском коде</span><span>, чтобы</span> <span class="hps">определить новые</span> <span class="hps">типы событий</span><span>, испускаемые от</span> <span class="hps">пользовательских объектов</span><span>, зарегистрируйтесь</span> <span class="hps">функции</span> <span class="hps">слушателя</span>для <span class="hps">обработки</span> <span class="hps">этих</span> <span class="hps">событий</span><span>,</span> <span class="hps">и вызова</span> <span class="hps">события</span> <span class="hps">в коде</span> <span class="hps">пользователя</span><span>.</span></span></p> - -<p><span id="result_box" lang="ru"><span class="hps">Остальные</span> <span class="hps">страницы описывают</span><span>, как использовать</span> <span class="hps">события разных</span> <span class="hps">видов</span><span>, определённых</span> <span class="hps">в веб-браузерах</span><span>.</span> <span class="hps">К сожалению,</span> <span class="hps">эти события</span> <span class="hps">были определены</span> <span class="hps">по частям</span><span>,</span> <span class="atn hps">веб-</span><span>браузеры</span> <span class="hps">развивались</span> <span class="hps">таким образом, что</span> <span class="hps">нет</span> <span class="hps">удовлетворения</span> <span class="hps">систематическим</span> <span class="hps">характеристикам</span> <span class="hps">событий</span> <span class="hps">встроенным</span> <span class="hps">или</span> <span class="hps">определённым</span> в <span class="atn hps">современных веб-</span><span>браузерах.</span></span></p> - -<p><span id="result_box" lang="ru"><span><strong>Устройство</strong>, на котором</span> <span class="atn hps">работа веб-</span><span>браузера</span> <span class="hps">может спровоцировать</span> <span class="hps">событие</span><span>, например</span> <span class="hps">связанное с</span> <span class="hps">изменением его</span> <span class="hps">положения и ориентации</span> <span class="hps">в реальном мире</span><span>,</span> <span class="hps">частично описано</span></span> <a href="/en-US/docs/Web/Guide/API/DOM/Events/Orientation_and_motion_data_explained">page on orientation coordinate systems</a> и <a href="/en-US/docs/Web/Guide/API/DOM/Events/Using_device_orientation_with_3D_transforms">page on the use of 3D transforms</a>. Они<span id="result_box" lang="ru"> <span class="hps">разные, но</span> <span class="hps">похожи</span><span>,</span> <span class="hps">с изменённой</span> <span class="hps">вертикальной ориентации</span> <span class="hps">устройства</span><span>.</span></span></p> - -<p><span id="result_box" lang="ru"><strong><span>Окно в котором</span> <span class="hps">отображается</span> <span class="hps">браузер</span></strong> <span class="hps">может вызвать</span> <span class="hps">события</span><span>, к примеру</span><span>,</span> <span class="hps">изменить размер</span><span>, если пользователь</span> <span class="hps">максимизирует</span> <span class="hps">окно или</span> <span class="hps">изменит его размер</span><span>.</span></span></p> - -<p><span id="result_box" lang="ru"><strong><span>Процесс загрузки</span></strong> <span class="hps">веб-страницы</span> <span class="hps">может вызвать</span> <span class="hps">ответное событие</span><span class="hps"> на завершение</span> <span class="hps">различных</span> <span class="hps">этапо</span><span class="hps">в</span> <span class="hps">загрузки,</span> анализирования <span class="hps">и перевода</span> <span class="hps">веб-страниц</span> <span class="hps">отображаемых пользователю</span><span>.</span></span></p> - -<p><span id="result_box" lang="ru"><span><strong>Взаимодействие пользователя</strong> с</span> <span class="hps">содержимым</span> <span class="hps">веб-страницы</span> <span class="hps">может вызвать</span> <span class="hps">события</span><span>.</span> <span class="hps">События</span><span>, вызванные</span> <span class="hps">взаимодействием</span> <span class="hps">пользователя</span> <span class="hps">развивались</span> <span class="hps">в первые годы</span> проектирования <span class="hps">браузера</span>, <span class="hps">и включают в себя</span> <span class="hps">сложную систему</span><span>, определяющую</span> <span class="hps">последовательность, в которой</span> <span class="hps">будет вызываться</span> <span class="hps">событие</span> <span class="hps">и</span> <span class="hps">манера, в которой</span> <span class="hps">эта последовательность</span> <span class="hps">может</span> <span class="hps">быть</span> <span class="hps">контролируемой</span><span>.</span> <span class="hps">Различные типы</span> <span class="hps">взаимодействия пользователя с</span> <span class="hps">управляемыми</span> <span class="hps">событиями:</span></span></p> - -<ul> - <li>обычное событие при нажатии,</li> - <li>событие, активированное мышью,</li> - <li><a href="/en-US/docs/Web/Guide/API/DOM/Events/Mouse_gesture_events">событие жеста мышью</a>,</li> - <li><a href="/en-US/docs/Web/Guide/API/DOM/Events/Touch_events">события нажатия на экран</a> и устаревшие <a href="/en-US/docs/Web/Guide/API/DOM/Events/Touch_events_(Mozilla_experimental)">экспериментальные события нажатия на экран (от Mozilla)</a>.</li> -</ul> - -<p><span id="result_box" lang="ru"><strong><span>Модификация</span> <span class="hps">в структуре веб-страницы</span> <span class="hps">или содержании</span></strong> <span class="hps">может быть</span> <span class="hps">вызвано некоторым</span> <span class="hps">событием</span><span>, </span> <span class="hps">описанным в</span></span> <a href="/en-US/docs/Web/Guide/API/DOM/Events/Mutation_events">mutation events page</a><span id="result_box" lang="ru"><span class="hps">, но</span> их<span class="hps"> использование </span> <span class="hps">устарело в</span> <span class="hps">пользу более </span><span class="hps">лёгкого</span></span> <a href="/en-US/docs/Web/API/MutationObserver">Mutation Observer</a> подхода.</p> - -<p><span id="result_box" lang="ru"><strong><span class="hps">Потоки</span> <span class="hps">Медиа</span></strong>, <span class="hps">встроенный</span> <span class="hps">в</span> <span class="hps">HTML</span> <span class="hps">документа,</span> <span class="hps">может</span> <span class="hps">вызвать некоторые</span> <span class="hps">события</span><span>,</span> <span class="hps">страница описания</span></span> <a href="/en-US/docs/Web/Guide/API/DOM/Events/Media_events">media events</a>.</p> - -<p><span id="result_box" lang="ru"><strong><span class="hps">Сетевые</span> </strong><span class="hps"><strong>запросы</strong>, сделанные</span> <span class="atn hps">веб-</span><span>страницей, могут</span> <span class="hps">вызвать некоторые</span> <span class="hps">события</span><span>.</span></span></p> - -<p><span id="result_box" lang="ru"><span class="hps">Есть</span> <span class="hps">много других источников</span> <span class="hps">событий, определённых</span> <span class="hps">в веб-браузере</span><span>,</span> <span class="hps">страницы которых</span> <span class="hps">пока не доступны</span> <span class="hps">в данном руководстве</span><span>.</span></span></p> - -<div class="note"> -<p><span id="result_box" lang="ru"><span class="hps">Примечание</span><span>:</span> <span class="hps">Это руководство</span> <span class="hps">событие</span> <span class="hps">Разработчик</span>а <span class="hps">нуждается в существенной</span> <span class="hps">работе</span><span>.</span><span>Структура должна</span> <span class="hps">быть</span> <span class="hps">реорганизована</span> <span class="hps">и страницы</span> <span class="hps">переписаны.</span> <span class="hps">Мы надеемся, что</span> <span class="hps">все, что вы</span><span class="hps"> знаете и должны знать</span> <span class="hps">о событиях</span> <span class="hps">будет опубликовано</span> <span class="hps">здесь.</span></span></p> -</div> - -<h2 id="Docs">Docs</h2> - -<p>{{LandingPageListSubpages}}</p> diff --git a/files/ru/orphaned/web/guide/events/media_events/index.html b/files/ru/orphaned/web/guide/events/media_events/index.html deleted file mode 100644 index 44116bc573..0000000000 --- a/files/ru/orphaned/web/guide/events/media_events/index.html +++ /dev/null @@ -1,270 +0,0 @@ ---- -title: События в медиа (audio, video) объектах -slug: orphaned/Web/Guide/Events/Media_events -tags: - - Видео - - Медиа - - аудио - - события -translation_of: Web/Guide/Events/Media_events -original_slug: Web/Guide/Events/Media_events ---- -<p>Встроенные с помощью HTML тегов {{ HTMLElement("audio") }} или {{ HTMLElement("video") }} медиа объекты генерируют различные события. В этом разделе приведён их список и описание.</p> - -<table class="standard-table"> - <tbody> - <tr> - <th>Название события</th> - <th>Описание</th> - </tr> - <tr> - <td><code>abort</code></td> - <td>Отправляется, когда воспроизведение прерывается; Например, если воспроизведение медиа прерывается и начинается с самого начала, это событие будет отправлено.</td> - </tr> - <tr> - <td><code>{{event("canplay")}}</code></td> - <td>Отправляется, когда доступно достаточно данных для того, что бы медиа могло воспроизвестись, по крайней мере, в течение нескольких кадров. Соответствует состоянию (readyState) HAVE_ENOUGH_DATA.</td> - </tr> - <tr> - <td><code>{{event("canplaythrough")}}</code></td> - <td>Отправляется, когда состояние готовности изменяется к CAN_PLAY_THROUGH. Указывает, что медиа может быть полностью воспроизведено без перерыва, предполагая, что скорость загрузки остаётся, по крайней мере на нынешнем уровне. Примечание: Ручная установка CURRENTTIME вызовет событие canplaythrough в Firefox. В других браузерах это может не произойти.</td> - </tr> - <tr> - <td><code>{{event("durationchange")}}</code></td> - <td>Метаданные были загружены или изменены, что указывает на изменение в продолжительности медиа. Может быть отправлено, например, когда медиа загружено достаточно для того, чтобы продолжительность уже была известна.</td> - </tr> - <tr> - <td><code>{{event("emptied")}}</code></td> - <td>Медиа стало пустым. Например, это событие отправляется, если медиа уже загружено (или частично загружено), и метод <a class="internal" href="/En/XPCOM_Interface_Reference/NsIDOMHTMLMediaElement" title="en/nsIDOMHTMLMediaElement"><code>load()</code></a> был вызван что бы его перезагрузить.</td> - </tr> - <tr> - <td>encrypted <span style="line-height: 1.5;">{{experimental_inline}}</span></td> - <td>The user agent has encountered initialization data in the media data.</td> - </tr> - <tr> - <td><code>ended</code></td> - <td>Отправляется, когда воспроизведение завершено.</td> - </tr> - <tr> - <td><code>error</code></td> - <td>Отправляется, когда произошла ошибка. Атрибут <code>error</code> медиа объекта содержит более подробную информацию об ошибке. Смотрите <a href="/en-US/docs/Web/Guide/HTML/Using_HTML5_audio_and_video#Error_handling">Error handling</a>, что бы узнать подробнее.</td> - </tr> - <tr> - <td><code>interruptbegin</code></td> - <td>Отправляется, когда воспроизведение на Firefox OS устройстве прервано по любой из причин - например, если приложение ушло в фон или аудио с большим приоритетом начало воспроизведение. См. <a href="/en-US/docs/Web/API/AudioChannels_API/Using_the_AudioChannels_API">Using the AudioChannels API</a>.</td> - </tr> - <tr> - <td><code>interruptend</code></td> - <td>Отправляется, когда ранее прерванное воспроизведение на Firefox OS устройстве продолжает воспроизведение. См. <a href="/en-US/docs/Web/API/AudioChannels_API/Using_the_AudioChannels_API">Using the AudioChannels API</a></td> - </tr> - <tr> - <td><code>{{event("loadeddata")}}</code></td> - <td>Завершена загрузка первого кадра (frame) медиа.</td> - </tr> - <tr> - <td><code>{{event("loadedmetadata")}}</code></td> - <td>Метаданные медиа были загружены; все атрибуты теперь содержат максимум информации.</td> - </tr> - <tr> - <td><code>{{event("loadstart")}}</code></td> - <td>Отправляется, когда начинается загрузка медиа.</td> - </tr> - <tr> - <td><code>mozaudioavailable</code></td> - <td>Sent when an audio buffer is provided to the audio layer for processing; the buffer contains raw audio samples that may or may not already have been played by the time you receive the event.</td> - </tr> - <tr> - <td><code>{{event("pause")}}</code></td> - <td>Отправляется, когда воспроизведение приостановлено.</td> - </tr> - <tr> - <td><code>{{event("play")}}</code></td> - <td>Отправляется, когда воспроизведение медиа начинается после того, как было приостановлено; то есть, когда воспроизведение возобновляется после паузы.</td> - </tr> - <tr> - <td><code>{{event("playing")}}</code></td> - <td>Отправляется, когда начинается воспроизведение медиа (в первый раз, после паузы или после перезапуска).</td> - </tr> - <tr> - <td><code>{{event("progress")}}</code></td> - <td>Отправляется периодически для информирования о прогрессе скачивания медиа файла. Информация об объёме загруженных данных доступна в атрибуте "buffered" элемента медиа.</td> - </tr> - <tr> - <td><code>{{event("ratechange")}}</code></td> - <td>Отправляется, когда изменяется скорость воспроизведения.</td> - </tr> - <tr> - <td><code>{{event("seeked")}}</code></td> - <td>Отправляется, когда операция поиска завершена.</td> - </tr> - <tr> - <td><code>{{event("seeking")}}</code></td> - <td>Отправляется, когда начинается операция поиска.</td> - </tr> - <tr> - <td><code>{{event("stalled")}}</code></td> - <td>Sent when the user agent is trying to fetch media data, but data is unexpectedly not forthcoming.</td> - </tr> - <tr> - <td><code>{{event("suspend")}}</code></td> - <td>Отправляется, когда загрузка медиа приостановлена. Это может произойти как потому, что загрузка была завершена, так и по другим причинам.</td> - </tr> - <tr> - <td><code>{{event("timeupdate")}}</code></td> - <td>Отправляется, когда изменяется значение атрибута <code>currentTime.</code></td> - </tr> - <tr> - <td><code>{{event("volumechange")}}</code></td> - <td>Отправляется, когда изменяется громкость звука (также когда звук включён или выключен).</td> - </tr> - <tr> - <td><code>{{event("waiting")}}</code></td> - <td>Отправляется, когда операция (напр. воспроизведение) была отложена до завершение другой операции (напр. поиск).</td> - </tr> - </tbody> -</table> - -<p>Вы можете легко следить за этими событиями, используя следующий код:</p> - -<pre class="brush: js">var v = document.getElementsByTagName("video")[0]; -v.addEventListener("seeked", function() { document.getElementsByTagName("video")[0].play(); }, true); -v.currentTime = 10.0; -</pre> - -<p>В этом примере первый элемент получает видео и вешает на него событие "seeked". Обработчик вызывает метод элемента play(), который начинает воспроизведение.</p> - -<p>Затем, в строке 3 примера, устанавливается атрибут currentTime элемента в значение 10.0, что инициирует переход к десятой секунде видео. Это приводит к отправлению события "seeking" после начала операции, и события "seeked" после её завершения.</p> - -<p>Другими словами, этот пример пытается перейти к 10-секундной видео, после чего начинает воспроизведение.</p> - -<h2 id="Совместимость">Совместимость</h2> - -<p>{{ CompatibilityTable() }}</p> - -<div id="compat-desktop"> -<table class="compat-table"> - <tbody> - <tr> - <th>Feature</th> - <th>Chrome</th> - <th>Firefox (Gecko)</th> - <th>Internet Explorer</th> - <th>Opera</th> - <th>Safari</th> - </tr> - <tr> - <td>Basic support</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatGeckoDesktop("1.9.1") }} (Prior to Gecko 2.0, media events bubbled.)</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - </tr> - <tr> - <td>encrypted</td> - <td> - <p class="p1">{{CompatChrome(42.0)}}</p> - </td> - <td><span style="font-size: 12px; line-height: 16.3636360168457px;">{{ CompatUnknown() }}</span></td> - <td><span style="font-size: 12px; line-height: 16.3636360168457px;">{{ CompatUnknown() }}</span></td> - <td><span style="font-size: 12px; line-height: 16.3636360168457px;">{{ CompatUnknown() }}</span></td> - <td><span style="font-size: 12px; line-height: 16.3636360168457px;">{{ CompatUnknown() }}</span></td> - </tr> - <tr> - <td>load</td> - <td>{{ CompatUnknown() }}</td> - <td>Removed in {{ CompatGeckoDesktop("1.9.2") }}</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - </tr> - <tr> - <td>mozaudioavailable {{ non-standard_inline() }}</td> - <td>{{ CompatNo() }}</td> - <td>{{ CompatGeckoDesktop("2.0") }}</td> - <td>{{ CompatNo() }}</td> - <td>{{ CompatNo() }}</td> - <td>{{ CompatNo() }}</td> - </tr> - <tr> - <td>suspend</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatGeckoDesktop("1.9.2") }}</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - </tr> - </tbody> -</table> -</div> - -<div id="compat-mobile"> -<table class="compat-table"> - <tbody> - <tr> - <th>Feature</th> - <th>Android</th> - <th>Android Webview</th> - <th>Firefox Mobile (Gecko)</th> - <th>IE Mobile</th> - <th>Opera Mobile</th> - <th>Safari Mobile</th> - <th>Chrome for Android</th> - </tr> - <tr> - <td>Basic support</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - <td><span style="font-size: 12px; line-height: 16.3636360168457px;">{{ CompatUnknown() }}</span></td> - </tr> - <tr> - <td>encrypted</td> - <td><span style="font-size: 12px; line-height: 16.3636360168457px;">{{ CompatNo }}</span></td> - <td>{{CompatChrome(43.0)}}</td> - <td><span style="font-size: 12px; line-height: 16.3636360168457px;">{{ CompatUnknown() }}</span></td> - <td><span style="font-size: 12px; line-height: 16.3636360168457px;">{{ CompatUnknown() }}</span></td> - <td><span style="font-size: 12px; line-height: 16.3636360168457px;">{{ CompatUnknown() }}</span></td> - <td><span style="font-size: 12px; line-height: 16.3636360168457px;">{{ CompatUnknown() }}</span></td> - <td> - <p class="p1">{{CompatChrome(42.0)}}</p> - </td> - </tr> - <tr> - <td>load</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - <td><span style="font-size: 12px; line-height: 16.3636360168457px;">{{ CompatUnknown() }}</span></td> - </tr> - <tr> - <td>mozaudioavailable {{ non-standard_inline() }}</td> - <td>{{ CompatNo() }}</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatGeckoMobile("2.0") }}</td> - <td>{{ CompatNo() }}</td> - <td>{{ CompatNo() }}</td> - <td>{{ CompatNo() }}</td> - <td><span style="font-size: 12px; line-height: 16.3636360168457px;">{{ CompatUnknown() }}</span></td> - </tr> - <tr> - <td>suspend</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - <td>{{ CompatUnknown() }}</td> - <td><span style="font-size: 12px; line-height: 16.3636360168457px;">{{ CompatUnknown() }}</span></td> - </tr> - </tbody> -</table> -</div> - -<p> </p> diff --git a/files/ru/orphaned/web/guide/events/overview_of_events_and_handlers/index.html b/files/ru/orphaned/web/guide/events/overview_of_events_and_handlers/index.html deleted file mode 100644 index ea9b25b46d..0000000000 --- a/files/ru/orphaned/web/guide/events/overview_of_events_and_handlers/index.html +++ /dev/null @@ -1,131 +0,0 @@ ---- -title: Обзор событий и обработчиков -slug: orphaned/Web/Guide/Events/Overview_of_Events_and_Handlers -translation_of: Web/Guide/Events/Overview_of_Events_and_Handlers -original_slug: Web/Guide/Events/Overview_of_Events_and_Handlers ---- -<div class="summary"> -<p>Эта обзорная статья о событиях и их обработчиках описывает шаблон проектирования кода, который используется для реагирования на события, возникающие, когда браузер получает доступ к web-странице, и содержит подборку типов подобных событий, которые современные браузеры могут обрабатывать.</p> -</div> - -<p>События и их обработчики представляют собой основную технику в JavaScript для реагирования на события, возникающие, когда браузер получает доступ к web-странице, включая события о подготовке страницы к отображению, взаимодействии с её содержимым, в зависимости от устройства, на котором браузер был запущен, и многие другие случаи, такие как воспроизведение потоковой медиа-информации или расчёт времени анимации.</p> - -<p>События и обработчики событий заняли центральное место в web-программировании с добавлением языка в браузеры, сопровождая смену архитектуры рендеринга от перехвата и загрузки страницы к управлению с помощью событий, основанном на перекомпоновке (reflow). Сначала браузер ожидает, пока он получит все ресурсы, связанные со страницей, чтобы проанализировать, обработать, отрисовать и предоставить страницу пользователю. Отрисованная страница остаётся неизменной, пока браузер не запросит новую. С изменением в подходе к рендерингу динамической страницы, браузер непрерывно зацикливается между обработкой, отрисовкой, представлением содержимого и ожиданием некоторого нового триггера события. Триггеры событий включают, например, завершение загрузки ресурса по сети<em>,</em> скачивание изображений, которые теперь могут быть отрисованы на экране, завершение браузером анализа ресурса, обработку HTML-содержимого страницы, взаимодействие пользователя с содержимым страницы<em>,</em> нажатия кнопок. Дуглас Крокфорд хорошо объясняет это изменение в нескольких лекциях, особенно своей речи <em>"Неудобные API: Теория DOM",</em> которая описывает изменения в потоке изначального потока браузера от управляемого событиями браузера.</p> - -<div style="margin: 0 auto; width: 68%;"><img alt="A comparison of the sequential and event-driven browser load sequences." src="https://mdn.mozillademos.org/files/6641/Browser_sequence_comparitive.svg" style="height: 454px; width: 1857px;"></div> - -<p>Второй подход изменяет последние шаги, переходя от простого потока к бесконечному циклу, где ожидание и обработка возникновения новых событий следует за отрисовкой. Введение динамического подхода позволяет странице быть частично отрендериной, даже когда браузер ещё не закончил извлечение всех ресурсов; это так же разрешено для действий, управляемыми событиями, которые JavaScript использует. (Речь доступна на нескольких ресурсах, включая <a href="http://www.youtube.com/watch?v=Y2Y0U-2qJMs">этот</a>.) На данный момент, все среды исполнения JavaScript используют события и их обработчики.</p> - -<h2 id="Шаблон_проектирования_событий">Шаблон проектирования событий</h2> - -<p>Система событий, по своей сути, простой программный шаблон проектирования. Он начинается с соглашения о виде события и:</p> - -<ul> - <li>имени-строки, используемой для события,</li> - <li>типа структуры данных, используемых для представления ключевых свойств события,</li> - <li>объекта JavaScript, который будет 'вызывать' это событие.</li> -</ul> - -<p>Шаблон реализуется с помощью:</p> - -<ul> - <li>определение JavaScript-функции, которая принимает в качестве аргумента структуру данных, которая была согласована ранее, и</li> - <li>регистрации функции с помощью имени-строки через объект, который будет вызывать событие.</li> -</ul> - -<p>Функция считается "обработчиком", где оба именами взаимозаменяемы. Этому шаблону можно легко следовать с использованием полностью пользовательского кода, как объяснено в <a href="/en-US/docs/Web/Guide/API/DOM/Events/Creating_and_triggering_events">статье о пользовательских событиях</a>. Шаблон так же используется современными web-браузерами, определяющими множество событий, которые вызываются в ответ на пользовательский ввод или активность браузера.</p> - -<p>Современные браузеры следуют событийному шаблону, используя стандартизированный подход. В качестве структуры данных для свойств события они применяют объект, полученный от объекта <code>EventPrototype</code>. Для регистратрации функции, которая будет обрабатывать эту структуру данных, используется метод, называемый <code>addEventListener</code>, который ожидает в качестве аргумента имя-строку, соответствующую типу события, и функцию-обработчика. В итоге, браузеры определяют огромное число объектов источников событий и широкое разнообразие типов событий, сформированных объектами.</p> - -<h2 id="Button_Event_Handler" name="Button_Event_Handler">Пример обработчика события кнопки</h2> - -<p>К примеру, браузерный элемент <code>button</code> предназначен для вызова события с именем <code>'click'</code> в ответ на нажатие кнопки мыши или прикосновение пальца к чувствительной части экрана. В HTML мы можем определить <code>button</code> как:</p> - -<pre class="brush: html"><button id="buttonOne">Click here to emit a 'click' event</button></pre> - -<p>и, в коде JavaScript, мы можем сначала определить функцию для обработки этого события <code>'click'</code> :</p> - -<pre class="brush: js">var example_click_handler = function (ev){ - var objKind = (ev instanceof Event) ? "EventPrototype" : "ObjectPrototype"; - alert("We got a click event at " + ev.timeStamp + " with an argument object derived from: " + objKind ); -};</pre> - -<p>и затем зарегистрировать свою функцию с помощью объекта <code>Button</code> или со стороны скрипта, используя представление DOM (Document Object Model) на HTML-странице:</p> - -<pre class="brush: js">var buttonDOMElement = document.querySelector('#buttonOne'); -buttonDOMElement.addEventListener('click', example_click_handler);</pre> - -<p>или на самой HTML-странице, добавив функцию как значение атрибута <code>'onclick'</code>, хотя этот вариант обычно используется на очень простых web-страницах.</p> - -<p>{{ EmbedLiveSample('Button_Event_Handler') }}</p> - -<p>Этот код полагается на соглашение о том, что существует некоторый вид события, называемый <code>'click'</code> , который вызовет все функции-обработчики (или 'обработчик') с объектом-аргументом <code>Event</code> (на данный момент, в этом случае производный от объекта <code>MouseEvent</code> ) и будет запущен после манипуляций пользователя с элементами <code>button</code> на HTML-странице. Код не имеет видимого воздействия, пока пользователь не использует кнопки, наводит указатель мыши на элемент HTML и нажимает на левую кнопку или устанавливает палец или стилус на некоторое место на экране, выше кнопки; когда это произойдёт, <code>buttonDOMElement</code> объекта JavaScript вызовет функцию <code>example_click_handler</code> с объектом <code>Event</code> в качестве аргумента. Функция, в свою очередь, исполнит любые действия, описанные программистом, в данном случае отрыв диалоговое окно HTML. Заметим, что обработчик имеет доступ к объекту <code>ev</code>, так как тот передаётся в качестве аргумента; объект содержит информацию о событие, в частности время его возникновения.</p> - -<p>Во втором варианте, интегрирован в web-страницу намного более современный JavaScript обёрнут в событийный вызов функции, чтобы убедиться, что код будет выполнен только тогда, когда HTML будет обработан и доступен для изменения или декорирования. Например, код может быть объявлен так:</p> - -<pre class="brush: js">var funcInit = function(){ - // user code goes here and can safely address all the HTML elements from the page - // since the document has successfully been 'loaded' -} -document.addEventListener('DOMContentLoaded', funcInit); -</pre> - -<p>так что этот код будет вызван только после того, как объект <code>document</code> вызовет событие <code>'DOMContentLoaded'</code>, потому что HTML был проанализирован и были созданы объекты Javasript, представляющие каждый узел HTML-документа. Заметим, что в этом примере, код даже не передаёт аргумент события в функцию, потому что тому никогда не понадобится использовать данные, описанные в нем; скорее, код всего лишь нужно подождать, пока не случится событие.</p> - -<p>Шаблон легко изучить и внедрить. Сложность с событиями возникает из-за необходимости изучить большое разнообразие событий, которые представлены в современных web-браузерах. Так же есть некоторая сложность в понимании, как писать обработчики, так как данный код работает асинхронно и потенциально может быть вызван несколько раз подряд, но в немного другой ситуации.</p> - -<h2 id="Важные_события">Важные события</h2> - -<p>Web-браузеры определяют большое число событий, поэтому не практично описывать их все. <a href="/en-US/docs/Web/Reference/Events">Event Reference</a> призван содержать список стандартных событий, используемых в современных браузерах.</p> - -<p>В общем случае, события различного вида выделяют, основываясь на объекте, который вызывает данное событие, включая:</p> - -<ul> - <li>объект <code>window</code>, на случай изменения размера браузера,</li> - <li>объект <code>window.screen</code>, на случай изменения положения устройства,</li> - <li>объект <code>document</code>, включая загрузку, модификацию, пользовательское взаимодействие и разгрузку страницы,</li> - <li>объект в DOM (объектная модель документа) дереве, включая пользовательское взаимодействие или изменения,</li> - <li>объект <code>XMLHttpRequest</code>, используемый для запросов сети, и</li> - <li>медиа-объекты, такие как <code>audio</code> и <code>video</code>, когда медиа-потоковые плееры изменяют состояние.</li> -</ul> - -<p>хотя этот список на данный момент неполный.</p> - -<p>Некоторые события, которые стоит отметить:</p> - -<div class="note"> -<p><strong>Примечание:</strong> Этот список событий будет нуждаться в доработке, чтобы соответствовать действительности; эта работа ожидает некоторой глобальной реорганизации в документе. Так же нужно найти хорошее объяснение событий, включая события во время загрузки страницы, таких, как частично описанных в <em><a href="http://ablogaboutcode.com/2011/06/14/how-javascript-loading-works-domcontentloaded-and-onload">этой статье</a> или <a href="http://stackoverflow.com/questions/1795438/load-and-execution-sequence-of-a-web-page">этом вопросе на Stack Overflow</a>. </em></p> -</div> - -<ul> - <li>глобальный объект <a href="/en-US/docs/Web/API/Window"><code>window</code></a> вызывает событие, называемое <a href="/en-US/docs/Web/Reference/Events/load_(ProgressEvent)"><code>'load'</code></a>, когда страница закончила рендеринг, подразумевая, что все ресурсы были скачаны и применены, так что скрипт был выполнен и изображения отображены,</li> - <li>глобальный объект <a href="/en-US/docs/Web/API/Window"><code>window</code></a> вызывает событие, называемое <a href="/en-US/docs/Web/Reference/Events/resize"><code>'resize'</code></a>, когда высота или ширина окна браузера была изменена пользователем,</li> - <li>объект DOM <a href="/en-US/docs/Web/API/Document"><code>document</code></a>, представляющий HTML-документ, вызывает событие, называемое <code><a href="/en-US/docs/Web/Reference/Events/DOMContentLoaded">'DOMContentLoaded'</a></code>, когда документ закончил загрузку,</li> - <li>объект узла DOM, такой как <a href="/en-US/docs/Web/HTML/Element/div"><code>div</code></a> или <a href="/en-US/docs/Web/HTML/Element/button"><code>button</code></a>, вызывающий событие, называемое <a href="/en-US/docs/Web/Reference/Events/click"><code>'click'</code></a>, когда пользователь нажимает кнопку мыши, пока её указатель находится поверх узла DOM на HTML-странице.</li> -</ul> - - - -<h2 id="Иерархия_объекта_событий">Иерархия объекта событий</h2> - -<p>Web-браузер определяет множество событий различного вида. Каждое описание включает, как структуру данных, передающуюся в обработчика, объект, который наследуется от объекта <code>EventPrototype</code>.</p> - -<p>Частичная диаграмма иерархии класса объекта событий:</p> - -<div class="note"> -<p><strong>Примечание:</strong> Эта диаграмма неполная.</p> -</div> - -<p><img alt="" src="https://mdn.mozillademos.org/files/6633/Js_Event_Object_Hierarchy.svg" style="height: 496px; width: 1417px;"></p> - -<p>Web API Документация содержит <a href="/en-US/docs/Web/API/Event">страницу, описывающую объект событий</a>, который так же включает известные события DOM, подклассы объекта <code>Event</code>.</p> - -<h2 id="Документации">Документации</h2> - -<p>Три ресурса на MDN (Mozilla Developer Network) частично полезные для программистов, желающих работать с событиями:</p> - -<ul> - <li><a href="/en-US/docs/Web/Guide/API/DOM/Events">Гайд по событиям</a>, который является частью <a href="/en-US/docs/Web/Guide">Web Developers' Guide</a>,</li> - <li><a href="/en-US/docs/Web/Reference/Events">Event Reference</a>,</li> - <li>Web API Документация по объекту <a href="/en-US/docs/Web/API/Event"><code>Event</code></a>.</li> -</ul> diff --git a/files/ru/orphaned/web/guide/html/html5/constraint_validation/index.html b/files/ru/orphaned/web/guide/html/html5/constraint_validation/index.html deleted file mode 100644 index 7d1f9fecd8..0000000000 --- a/files/ru/orphaned/web/guide/html/html5/constraint_validation/index.html +++ /dev/null @@ -1,342 +0,0 @@ ---- -title: Constraint validation -slug: orphaned/Web/Guide/HTML/HTML5/Constraint_validation -tags: - - Селекторы -translation_of: Web/Guide/HTML/HTML5/Constraint_validation -original_slug: Web/Guide/HTML/HTML5/Constraint_validation ---- -<p>Создание веб форм всегда было комплексной задачей. В то время как сама по себе разметка формы - задача не сложная, проверка каждого поля на валидность - сложнее, а информирование пользователя о проблеме - может стать головной болью. Стандарт <a href="/en-US/docs/Web/Guide/HTML/HTML5" title="en/HTML/HTML5">HTML5</a> предоставил новые механизмы для форм: были добавлены новые семантические типы для элемента {{ HTMLElement("input") }} и <em>обязательная валидация, </em>чтобы облегчить работу по проверке содержимого формы на стороне браузера. Проще говоря, обычная проверка может быть выполнена без JavaScript, простой установкой новых атрибутов; более сложные ограничения могут быть реализованы через HTML5 <a href="/en-US/docs/Web/Guide/HTML/Forms_in_HTML#Constraint_Validation_API" title="en/HTML/HTML5/Forms in HTML5#Constraint Validation API">Constraint Validation API</a>.</p> - -<div class="note"><strong>Внимание:</strong> HTML5 Constraint validation не отменяет валидацию <em>на стороне сервера</em>. Несмотря на то что на сервер будет отправляться меньше запросов с невалидными данными, такие запросы всё ещё могут быть отправлены менее "сговорчивыми" браузерами (например, браузерами без поддержки HTML5 и без JavaScript) или плохими парнями, пытающимися взломать ваше веб-приложение. Следовательно, как и в случае с HTML4, вам всё ещё нужно проверять ввод на стороне сервера, таким образом, чтобы это было согласовано с валидацией на стороне клиента.</div> - -<h2 id="Внутренние_и_базовые_ограничения">Внутренние и базовые ограничения</h2> - -<p>В HTML5, базовые ограничения описываются двумя способами:</p> - -<ul> - <li>Использованием наиболее семантически подходящего значения для {{ htmlattrxref("type", "input") }} атрибута элемента {{ HTMLElement("input") }}, например, выбор типа <span style="font-family: courier new;">email</span> автоматически создаёт ограничение, которое проверяет, является ли значение e-mail адресом.</li> - <li>Установкой значений для атрибутов, связанных с валидацией, описывая базовые ограничения без использования JavaScript.</li> -</ul> - -<h3 id="Семантические_типы_input-ов">Семантические типы input-ов</h3> - -<p>Атрибуты, присущие элементам {{ htmlattrxref("type", "input") }}:</p> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Input type</th> - <th scope="col">Определение ограничения</th> - <th scope="col">Связанное с этим нарушение</th> - </tr> - </thead> - <tbody> - <tr> - <td><span style="font-family: courier new;"><input type="URL"></span></td> - <td>Значение должно быть абсолютным URL, одним из: - <ul> - <li>валидным URI (как описано в <a class="external" href="http://www.ietf.org/rfc/rfc3986.txt" title="http://www.ietf.org/rfc/rfc3986.txt">RFC 3986</a>)</li> - <li>валидным IRI, без query компонента (как описано в <a class="external" href="http://www.ietf.org/rfc/rfc3987.txt" title="http://www.ietf.org/rfc/rfc3987.txt">RFC 3987</a>)</li> - <li>валидным IRI, без query компонента и без неэкранированных не-ASCII символов (как описано в <a class="external" href="http://www.ietf.org/rfc/rfc3987.txt" title="http://www.ietf.org/rfc/rfc3987.txt">RFC 3987</a>)</li> - <li>валидным IRI, при условии, что кодировка документа UTF-8 или UTF-16 (как описано в <a class="external" href="http://www.ietf.org/rfc/rfc3987.txt" title="http://www.ietf.org/rfc/rfc3987.txt">RFC 3987</a>)</li> - </ul> - </td> - <td><strong>Type mismatch </strong>constraint violation</td> - </tr> - <tr> - <td> <span style="font-family: courier new;"><input type="email"></span></td> - <td>Значение должно следовать <a class="external" href="http://www.ietf.org/rfc/std/std68.txt" title="http://www.ietf.org/rfc/std/std68.txt">ABNF</a>: <code>1*( atext / "." ) "@" ldh-str 1*( "." ldh-str )</code> где: - <ul> - <li><code>atext</code> (описан в <a class="external" href="http://tools.ietf.org/html/rfc5322" title="http://tools.ietf.org/html/rfc5322">RFC 5322</a>) - US-ASCII символ (<span style="font-family: courier new;">A</span> to <span style="font-family: courier new;">Z</span> and <span style="font-family: courier new;">a</span>-<span style="font-family: courier new;">z</span>), цифра (от <span style="font-family: courier new;">0</span> до <span style="font-family: courier new;">9</span>) или один из следующих: <br> - <span style="font-family: courier new;">! # $ % & ' * + - / = ? ` { } | ~ </span>специальных символов,</li> - <li><code>ldh-str</code> (описан в <a class="external" href="http://www.apps.ietf.org/rfc/rfc1034.html#sec-3.5" title="http://www.apps.ietf.org/rfc/rfc1034.html#sec-3.5">RFC 1034</a>) - US-ASCII символы, цифры и "<span style="font-family: courier new;">-"</span>, сгруппированы по словам и разделённые точкой (<span style="font-family: courier new;">.</span>).</li> - </ul> - - <div class="note"><strong>Внимание:</strong> если установлен атрибут {{ htmlattrxref("multiple", "input") }}, в поле могут быть вписаны несколько e-mail адресов, разделённых запятыми. Если любое из этих условий не выполнено, будет вызвано <strong>Type mismatch </strong>constraint violation.</div> - </td> - <td><strong>Type mismatch </strong>constraint violation</td> - </tr> - </tbody> -</table> - -<p>Следует учесть, что большинство типов input не имеют "нативных" ограничений, а некоторые из них просто лишены валидации или имеют автоматическую корректировку невалидных значений по умолчанию. </p> - -<h3 id="Атрибуты_валидации">Атрибуты валидации</h3> - -<p>Ниже перечислены атрибуты, которые описывают базовые ограничения:</p> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Атрибут</th> - <th scope="col">Типы input с поддержкой атрибута</th> - <th scope="col">Возможные значения</th> - <th scope="col">Описание ограничения</th> - <th scope="col">Связанное нарушение</th> - </tr> - </thead> - <tbody> - <tr> - <td>{{ htmlattrxref("pattern", "input") }}</td> - <td>text, search, url, tel, email, password</td> - <td><a href="/en-US/docs/Web/JavaScript/Guide/Regular_Expressions" title="https://developer.mozilla.org/en/JavaScript/Guide/Regular_Expressions">Регулярное выражение JavaScript</a> (по стандарту <a class="external" href="http://www.ecma-international.org/publications/standards/Ecma-262.htm" title="http://www.ecma-international.org/publications/standards/Ecma-262.htm">ECMAScript 5</a>, флаги <code title="">global</code>, <code title="">ignoreCase</code>, и <code title="">multiline</code> <em>отключены)</em></td> - <td>Значение должно подходить под паттерн</td> - <td><strong>Pattern mismatch</strong> constraint violation</td> - </tr> - <tr> - <td rowspan="3">{{ htmlattrxref("min", "input") }}</td> - <td>range, number</td> - <td>Валидное число</td> - <td rowspan="3">Значение поля должно быть больше или равно значению атрибута</td> - <td rowspan="3"><strong>Underflow</strong> constraint violation</td> - </tr> - <tr> - <td>date, month, week</td> - <td>Валидная дата</td> - </tr> - <tr> - <td>datetime, datetime-local, time</td> - <td>Валидная дата и время</td> - </tr> - <tr> - <td rowspan="3">{{ htmlattrxref("max", "input") }}</td> - <td>range, number</td> - <td>Валидное число</td> - <td rowspan="3">Значение поля должно быть меньше или равно значению атрибута</td> - <td rowspan="3"><strong>Overflow</strong> constraint violation</td> - </tr> - <tr> - <td>date, month, week</td> - <td>Валидная дата</td> - </tr> - <tr> - <td>datetime, datetime-local, time</td> - <td>Валидная дата и время</td> - </tr> - <tr> - <td>{{ htmlattrxref("required", "input") }}</td> - <td>text, search, url, tel, email, password, date, datetime, datetime-local, month, week, time, number, checkbox, radio, file; also on the {{ HTMLElement("select") }} and {{ HTMLElement("textarea") }} elements</td> - <td><em>никакое</em> так как это Boolean атрибут: его присутствие означает <em>true</em>, а отсутствие - <em>false</em></td> - <td>Значение должно быть не пустым (если установлено).</td> - <td><strong>Missing</strong> constraint violation</td> - </tr> - <tr> - <td rowspan="5">{{ htmlattrxref("step", "input") }}</td> - <td>date</td> - <td>Целое число дней</td> - <td rowspan="5">Пока в атрибут <code>step</code> не установлен <em>любой</em> литерал, значение может быть <strong>min</strong> + любое число, красное шагу.</td> - <td rowspan="5"><strong>Step mismatch </strong>constraint violation</td> - </tr> - <tr> - <td>month</td> - <td>Целое число месяцев</td> - </tr> - <tr> - <td>week</td> - <td>Целое число недель</td> - </tr> - <tr> - <td>datetime, datetime-local, time</td> - <td>Целое число секунд</td> - </tr> - <tr> - <td>range, number</td> - <td>Целое число</td> - </tr> - <tr> - <td>{{ htmlattrxref("maxlength", "input") }}</td> - <td>text, search, url, tel, email, password; также на элементе {{ HTMLElement("textarea") }}</td> - <td>Длина (целое число)</td> - <td>Количество символов (знаков) не должно превышать значение атрибута.</td> - <td><strong>Too long</strong> constraint violation</td> - </tr> - </tbody> -</table> - -<h2 id="Процесс_валидации_ограничений"><span class="author-g-by4vjwmiwjiydpj7">Процесс валидации ограничений</span></h2> - -<p>Constraint validation is done through the Constraint Validation API either on a single form element or at the form level, on the {{ HTMLElement("form") }} element itself. The constraint validation is done in the following ways:</p> - -<ul> - <li>By a call to the checkValidity() method of a form-related <a href="/en-US/docs/DOM" title="en/DOM">DOM</a> interface (<code><a href="/en-US/docs/Web/API/HTMLInputElement" title="en/DOM/HTMLInputElement">HTMLInputElement</a></code>, <code><a href="/en-US/docs/Web/API/HTMLSelectElement" title="en/DOM/HTMLSelectElement">HTMLSelectElement</a></code>, <code><a href="/en-US/docs/Web/API/HTMLButtonElement" title="en/DOM/HTMLButtonElement">HTMLButtonElement</a></code> or <code><a href="/en-US/docs/Web/API/HTMLTextAreaElement" title="en/DOM/HTMLTextAreaElement">HTMLTextAreaElement</a></code>), which evaluates the constraints only on this element, allowing a script to get this information. (This is typically done by the user-agent when determining which of the <a href="/en-US/docs/Web/CSS" title="en/CSS">CSS</a> pseudo-classes, {{ Cssxref(":valid") }} or {{ Cssxref(":invalid") }}, applies.)</li> - <li>By a call to the checkValidity() function on the <code><a href="/en-US/docs/Web/API/HTMLFormElement" title="en/DOM/HTMLFormElement">HTMLFormElement</a></code> interface, which is called <em>statically validating the constraints</em>.</li> - <li>By submitting the form itself, which is called <em>interactively validating the constraints</em>.</li> -</ul> - -<div class="note"><strong>Note: </strong> - -<ul> - <li>If the {{ htmlattrxref("novalidate", "form") }} attribute is set on the {{ HTMLElement("form") }} element, interactive validation of the constraints doesn't happen.</li> - <li>Calling the send() method on the <a href="/en/DOM/HTMLFormElement" title="en/DOM/HTMLFormElement">HTMLFormElement</a> interface doesn't trigger a constraint validation. In other words, this method sends the form data to the server even if doesn't satisfy the constraints.</li> -</ul> -</div> - -<h2 id="Complex_constraints_using_HTML5_Constraint_API"><span class="author-g-by4vjwmiwjiydpj7">Complex constraints using HTML5 Constraint API</span></h2> - -<p><span class="author-g-by4vjwmiwjiydpj7">Using JavaScript and the Constraint API, it is possible to implement more complex constraints, for example, constraints combining several fields, or constraints involving complex calculations.</span></p> - -<p><span class="author-g-by4vjwmiwjiydpj7">Basically, the idea is to trigger JavaScript on some form field event (like <strong>onchange</strong>) to calculate whether the constraint is violated, and then to use the method <code><em>field</em>.setCustomValidity()</code> to set the result of the validation: an empty string means the constraint is satisfied, and any other string means there is an error and this string is the error message to display to the user.</span></p> - -<h3 id="Constraint_combining_several_fields_Postal_code_validation">Constraint combining several fields: Postal code validation</h3> - -<p>The postal code format varies from one country to another. Not only do most countries allow an optional prefix with the country code (like <code>D-</code> in Germany, <code>F- </code> in France or Switzerland), but some countries have postal codes with only a fixed number of digits; others, like the UK, have more complex structures, allowing letters at some specific positions.</p> - -<div class="note"> -<p><strong>Note: </strong>This is not a comprehensive postal code validation library, but rather a demonstration of the key concepts. </p> -</div> - -<p><span style="line-height: 1.5;">As an example, we will add a script checking the constraint validation for this simple form:</span></p> - -<pre class="brush: html"><form> - <label for="ZIP">ZIP : </label> - <input type="text" id="ZIP"> - <label for="Country">Country : </label> - <select id="Country"> - <option value="ch">Switzerland</option> - <option value="fr">France</option> - <option value="de">Germany</option> - <option value="nl">The Netherlands</option> - </select> - <input type="submit" value="Validate"> -</form></pre> - -<p>This displays the following form: </p> - -<p><label>Postal Code: </label><input> <label>Country: </label><select><option value="ch">Switzerland</option><option value="fr">France</option><option value="de">Germany</option><option value="nl">The Netherlands</option></select></p> - -<p>First, we write a function checking the constraint itself:</p> - -<pre class="brush: js">function checkZIP() { - // For each country, defines the pattern that the ZIP has to follow - var constraints = { - ch : [ '^(CH-)?\\d{4}$', "Switzerland ZIPs must have exactly 4 digits: e.g. CH-1950 or 1950" ], - fr : [ '^(F-)?\\d{5}$' , "France ZIPs must have exactly 5 digits: e.g. F-75012 or 75012" ], - de : [ '^(D-)?\\d{5}$' , "Germany ZIPs must have exactly 5 digits: e.g. D-12345 or 12345" ], - nl : [ '^(NL-)?\\d{4}\\s*([A-RT-Z][A-Z]|S[BCE-RT-Z])$', - "Nederland ZIPs must have exactly 4 digits, followed by 2 letters except SA, SD and SS" ] - }; - - // Read the country id - var country = document.getElementById("Country").value; - - // Get the NPA field - var ZIPField = document.getElementById("ZIP"); - - // Build the constraint checker - var constraint = new RegExp(constraints[country][0], ""); - console.log(constraint); - - - // Check it! - if (constraint.test(ZIPField.value)) { - // The ZIP follows the constraint, we use the ConstraintAPI to tell it - ZIPField.setCustomValidity(""); - } - else { - // The ZIP doesn't follow the constraint, we use the ConstraintAPI to - // give a message about the format required for this country - ZIPField.setCustomValidity(constraints[country][1]); - } -} -</pre> - -<p>Then we link it to the <strong>onchange</strong> event for the {{ HTMLElement("select") }} and the <strong>oninput</strong> event for the {{ HTMLElement("input") }}:</p> - -<pre class="brush: js">window.onload = function () { - document.getElementById("Country").onchange = checkZIP; - document.getElementById("ZIP").oninput = checkZIP; -}</pre> - -<p>You can see a <a href="/@api/deki/files/4744/=constraint.html" title="https://developer.mozilla.org/@api/deki/files/4744/=constraint.html">live example</a> of the postal code validation. </p> - -<h3 id="Limiting_the_size_of_a_file_before_its_upload">Limiting the size of a file before its upload</h3> - -<p>Another common constraint is to limit the size of a file to be uploaded. Checking this on the client side before the file is transmitted to the server requires combining the Constraint API, and especially the field.setCustomValidity() method, with another JavaScript API, here the HTML5 File API.</p> - -<p>Here is the HTML part:</p> - -<pre class="brush: html"><label for="FS">Select a file smaller than 75 kB : </label> -<input type="file" id="FS"></pre> - -<p>This displays:</p> - -<p>{{EmbedLiveSample("Limiting_the_size_of_a_file_before_its_upload")}}</p> - -<p>The JavaScript reads the file selected, uses the File.size() method to get its size, compares it to the (hard coded) limit, and calls the Constraint API to inform the browser if there is a violation:</p> - -<pre class="brush: js">function checkFileSize() { - var FS = document.getElementById("FS"); - var files = FS.files; - - // If there is (at least) one file selected - if (files.length > 0) { - if (files[0].size > 75 * 1024) { // Check the constraint - FS.setCustomValidity("The selected file must not be larger than 75 kB"); - return; - } - } - // No custom constraint violation - FS.setCustomValidity(""); -}</pre> - -<p> </p> - -<p>Finally we hook the method with the correct event:</p> - -<pre class="brush: js">window.onload = function () { - document.getElementById("FS").onchange = checkFileSize; -}</pre> - -<p>You can see a <a href="/@api/deki/files/4745/=fileconstraint.html" title="https://developer.mozilla.org/@api/deki/files/4745/=fileconstraint.html">live example</a> of the File size constraint validation.</p> - -<h2 id="Visual_styling_of_constraint_validation"><span class="author-g-by4vjwmiwjiydpj7">Visual styling of constraint validation</span></h2> - -<p>Apart from setting constraints, web developers want to control what messages are displayed to the users and how they are styled.</p> - -<h3 id="Controlling_the_look_of_elements">Controlling the look of elements</h3> - -<p>The look of elements can be controlled via CSS pseudo-classes.</p> - -<h4 id="required_and_optional_CSS_pseudo-classes">:required and :optional CSS pseudo-classes</h4> - -<p>The <a href="/en-US/docs/Web/CSS/:required" title=":required"><code>:required</code></a> and <a href="/en-US/docs/Web/CSS/:optional" title=":optional"><code>:optional</code></a> <a href="/en-US/docs/Web/CSS/Pseudo-classes" title="Pseudo-classes">pseudo-classes</a> allow writing selectors that match form elements that have the {{ htmlattrxref("required") }} attribute, or that don't have it.</p> - - -<h4 id="-moz-placeholder_CSS_pseudo-class">:-moz-placeholder CSS pseudo-class</h4> - -<p>See <a href="/en-US/docs/Web/CSS/:-moz-placeholder" title="/en-US/docs/Web/CSS/:-moz-placeholder">:-moz-placeholder</a>.</p> - -<h4 id="valid_invalid_CSS_pseudo-classes">:valid :invalid CSS pseudo-classes</h4> - -<p>The <a href="/en-US/docs/Web/CSS/:valid" title="/en-US/docs/Web/CSS/:valid">:valid</a> and <a href="/en-US/docs/Web/CSS/:invalid" title="/en-US/docs/Web/CSS/:invalid?redirectlocale=en-US&redirectslug=CSS%2F%3Ainvalid">:invalid</a> <a href="/en-US/docs/Web/CSS/Pseudo-classes" title="/en-US/docs/Web/CSS/Pseudo-classes?redirectlocale=en-US&redirectslug=CSS%2FPseudo-classes">pseudo-classes</a> are used to represent <input> elements whose content validates and fails to validate respectively according to the input's type setting. These classes allow the user to style valid or invalid form elements to make it easier to identify elements that are either formatted correctly or incorrectly.</p> - -<h4 id="Default_styles">Default styles</h4> - -<h3 id="Controlling_the_text_of_constraints_violation">Controlling the text of constraints violation</h3> - -<h4 id="The_x-moz-errormessage_attribute">The x-moz-errormessage attribute</h4> - -<p>The x-moz-errormessage attribute is a Mozilla extension that allows you to specify the error message to display when a field does not successfully validate.</p> - -<div class="note"> -<p style="margin-left: 40px;">Note: This extension is non-standard.</p> -</div> - -<h4 id="Constraint_API's_element.setCustomValidity()">Constraint API's element.setCustomValidity()</h4> - -<p>The element.setCustomValidity(error) method is used to set a custom error message to be displayed when a form is submitted. The method works by taking a string parameter error. If error is a non-empty string, the method assumes validation was unsuccessful and displays error as an error message. If error is an empty string, the element is considered validated and resets the error message.</p> - -<h4 id="Constraint_API's_ValidityState_object"><span class="author-g-by4vjwmiwjiydpj7">Constraint API's ValidityState object</span></h4> - -<p>The DOM <a href="/en-US/docs/Web/API/ValidityState" title="/en-US/docs/Web/API/ValidityState"><code>ValidityState</code></a> interface represents the <em>validity states</em> that an element can be in, with respect to constraint validation. Together, they help explain why an element's value fails to validate, if it's not valid.</p> - -<h3 id="Examples_of_personalized_styling"><span class="author-g-by4vjwmiwjiydpj7">Examples of personalized styling</span></h3> - -<h3 id="HTML4_fallback"><span class="author-g-by4vjwmiwjiydpj7">HTML4 fallback</span></h3> - -<h4 id="Trivial_fallback"><span class="author-g-by4vjwmiwjiydpj7">Trivial fallback</span></h4> - -<h4 id="JS_fallback"><span class="author-g-by4vjwmiwjiydpj7">JS fallback</span></h4> - -<h2 id="Conclusion"><span class="author-g-by4vjwmiwjiydpj7">Conclusion</span></h2> diff --git a/files/ru/orphaned/web/guide/html/html5/index.html b/files/ru/orphaned/web/guide/html/html5/index.html deleted file mode 100644 index 41c9d4a443..0000000000 --- a/files/ru/orphaned/web/guide/html/html5/index.html +++ /dev/null @@ -1,172 +0,0 @@ ---- -title: HTML5 -slug: orphaned/Web/Guide/HTML/HTML5 -tags: - - HTML5 -translation_of: Web/Guide/HTML/HTML5 -original_slug: Web/Guide/HTML/HTML5 ---- -<p><span class="seoSummary"><strong>HTML5</strong> — последняя версия стандарта <a href="/en-US/docs/HTML" title="/en-US/docs/HTML">HTML</a>. </span>Термин имеет два определения:</p> - -<ul> - <li>Новая версия <em>языка</em> HTML, с новыми элементами, атрибутами и новым поведением.</li> - <li>Набор технологий, позволяющий создавать разнообразные сайты и Web-приложения.</li> -</ul> - -<p><span class="seoSummary">Эта страница создана в помощь всем разработчикам Open Web и ссылается на множество материалов, сгруппированных по функциям:</span></p> - -<ul> - <li><em>Семантика: </em>позволяет точнее описывать, что из себя представляет ваш контент;</li> - <li><em>Связь:</em> новые способы общения с сервером;</li> - <li><em>Офлайн и Хранилище:</em> методы, позволяющие сохранять информацию локально на стороне клиента;</li> - <li><em>Мультимедиа:</em>создание и взаимодействие с видео и звуком;</li> - <li><em>2D/3D Графика и эффекты:</em> способы значительно разнообразить представление;</li> - <li><em>Доступ к устройствам:</em> использование разных устройств для ввода и вывода информации;</li> - <li><em>Стилизация:</em> создание изощрённых и совершенных тем.</li> -</ul> - -<table class="topicpage-table"> - <tbody> - <tr> - <td> - <h2 id="СЕМАНТИКА" style="margin: 0 0 .25em; font: 200 24px/1 'Bebas Neue','League Gothic',Haettenschweiler,'Arial Narrow',sans-serif; letter-spacing: 1px; text-transform: uppercase; border: none;"><img alt="" src="/files/3827/HTML5_Semantics_512.png" style="height: 64px; padding-right: 0.5em; vertical-align: middle; width: 64px;">СЕМАНТИКА</h2> - - <dl> - <dt><a href="/en-US/docs/Sections_and_Outlines_of_an_HTML5_document" title="Sections and Outlines of an HTML5 document">Секции и контуры в HTML5</a></dt> - <dd>Контурные и секционные элементы в HTML5: {{ HTMLElement("section") }}, {{ HTMLElement("article") }}, {{ HTMLElement("nav") }}, {{ HTMLElement("header") }}, {{ HTMLElement("footer") }}, {{ HTMLElement("aside") }} and {{ HTMLElement("hgroup") }}.</dd> - <dt><a href="/ru/docs/HTML/%D0%98%D1%81%D0%BF%D0%BE%D0%BB%D1%8C%D0%B7%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5_HTML5_audio_and_video" title="Using_audio_and_video_in_Firefox">Использование HTML5 audio и video</a></dt> - <dd>{{ HTMLElement("audio") }} и {{ HTMLElement("video") }} элементы вставляют и позволяют управлять мультимедиа контентом.</dd> - <dt><a href="/en-US/docs/HTML/Forms_in_HTML" title="Forms in HTML5">Формы в HTML5</a></dt> - <dd>Взгляд на улучшение форм в HTML5: API валидации, несколько новых атрибутов, новые значения для атрибута {{ htmlattrxref("type", "input") }} тега {{ HTMLElement("input") }} и новый элемент {{ HTMLElement("output") }}.</dd> - <dt>Новые семантические элементы</dt> - <dd>Кроме секций, медиа и форм, множество новых тегов, такие как {{ HTMLElement("mark") }}, {{ HTMLElement("figure") }}, {{ HTMLElement("figcaption") }}, {{ HTMLElement("data") }}, {{ HTMLElement("time") }}, {{ HTMLElement("output") }}, {{ HTMLElement("progress") }} и {{ HTMLElement("meter") }}, увеличено количество <a href="/en-US/docs/HTML/HTML5/HTML5_element_list" title="/en-US/docs/HTML/HTML5/HTML5_element_list">валидных HTML5 элементов</a>.</dd> - <dt>Улучшение {{HTMLElement("iframe")}}</dt> - <dd>Использование атрибутов {{htmlattrxref("sandbox", "iframe")}}, {{htmlattrxref("seamless", "iframe")}}, and {{htmlattrxref("srcdoc", "iframe") }}, разработчики могут задать нужный уровень безопасности и осуществить рендеринг тега {{HTMLElement("iframe")}}.</dd> - <dt><a href="/en-US/docs/MathML" title="/en-US/docs/MathML">MathML</a></dt> - <dd>Позволяет вставлять математические формулы.</dd> - <dt><a href="/ru/docs/HTML/HTML5/%D0%92%D0%B2%D0%B5%D0%B4%D0%B5%D0%BD%D0%B8%D0%B5_%D0%B2_HTML5" title="/en-US/docs/HTML/HTML5/Introduction_to_HTML5">Введение в HTML5</a></dt> - <dd>Эта статья знакомит вас с тем, как указать на то, что вы используете HTML5 в вашем веб-дизайне или веб-приложении.</dd> - <dt><a href="/en-US/docs/HTML/HTML5/HTML5_Parser" title="HTML/HTML5/HTML5 parser">HTML5-совместимый парсер</a></dt> - <dd>Анализатор, который превращает байты HTML документа в DOM, был расширен и точно определяет поведение, чтобы даже в случае неверного HTML, исход был предсказуемым и одинаков во всех HTML5-совместимых браузерах.</dd> - <dt></dt> - </dl> - - <h2 id="СВЯЗЬ" style="margin: 0 0 .25em; font: 200 24px/1 'Bebas Neue','League Gothic',Haettenschweiler,'Arial Narrow',sans-serif; letter-spacing: 1px; text-transform: uppercase; border: none;"><img alt="" src="/files/3839/HTML5_Connectivity_512.png" style="height: 64px; padding-right: 0.5em; vertical-align: middle; width: 64px;">СВЯЗЬ</h2> - - <dl> - <dt><a href="/en-US/docs/WebSockets" title="WebSockets">Web Sockets</a></dt> - <dd>Позволяет создать постоянное соединение между страницей и сервером и обмениваться данными через него.</dd> - <dt><a href="/en-US/docs/Server-sent_events/Using_server-sent_events" title="/en-US/docs/Server-sent_events/Using_server-sent_events">Server-sent события</a></dt> - <dd>Позволяет серверу отправлять события клиенту, а не по классической парадигме, где сервер может передавать данные только в ответ на запрос клиента.</dd> - <dt><a href="/en-US/docs/WebRTC" title="/en-US/WebRTC">WebRTC</a></dt> - <dd>Эта технология, где RTC создаёт возможность общения в реальном времени, позволяет подключаться к другим людям и контролировать видеоконференции непосредственно в браузере, без необходимости плагинов и внешний приложений.</dd> - </dl> - - <h2 id="ОФФЛАЙН_И_ХРАНИЛИЩЕ" style="margin: 0 0 .25em; font: 200 24px/1 'Bebas Neue','League Gothic',Haettenschweiler,'Arial Narrow',sans-serif; letter-spacing: 1px; text-transform: uppercase; border: none;"><img alt="" src="/files/3833/HTML5_Offline_Storage_512.png" style="height: 64px; padding-right: 0.5em; vertical-align: middle; width: 64px;">ОФФЛАЙН И ХРАНИЛИЩЕ</h2> - - <dl> - <dt><a href="/en-US/docs/HTML/Using_the_application_cache" title="Offline_resources_in_Firefox">Офлайн-ресурсы: кеш приложения</a></dt> - <dd>Firefox полностью поддерживает спецификацию HTML5 по офлайн-ресурсам. Другие браузеры также имеют поддержку спецификации на должном уровне</dd> - <dt><a href="/en-US/docs/Online_and_offline_events" title="Online_and_offline_events">Online and offline events</a></dt> - <dd>Firefox 3 поддерживает WHATWG online и offline события, которые позволяют приложениям и расширениям обнаружить есть ли активное подключение к Интернет, а также определить, когда соединение портится или улучшается.</dd> - <dt><a href="/en-US/docs/DOM/Storage" title="DOM/Storage">WHATWG сессионное или постоянное хранилище (aka DOM Storage)</a></dt> - <dd>Постоянное или сессионное хранилище позволяет веб-приложениям хранить структурированные данные на стороне клиента.</dd> - <dt><a href="/en-US/docs/IndexedDB" title="/en-US/docs/IndexedDB">IndexedDB</a></dt> - <dd>Веб-стандарт для хранения значительных количеств структурированных данных в браузере и для быстрого их поиска, используя индексы.</dd> - <dt><a href="/en-US/docs/Using_files_from_web_applications" title="Using_files_from_web_applications">Using files from web applications</a></dt> - <dd>Поддержка HTML5 File API была добавлена в Gecko, сделав возможным веб-приложениям иметь доступ к файлам, выбираемых пользователем. Это включает поддержку множества файлов, используя <span style="font-family: monospace;">{{ HTMLElement("input") }} с</span> <a href="/en-US/docs/HTML/Element/Input#attr-type" title="HTML/Element/input#attr-type"><strong>типом</strong></a> <span style="font-family: courier new;">file</span>, имеющих атрибут <strong><a href="/en-US/docs/HTML/Element/Input#attr-multiple" title="HTML/Element/input#attr-multiple">multiple</a>.</strong> Ещё это <a href="/en-US/docs/DOM/FileReader" title="DOM/FileReader"><code>FileReader</code></a>.</dd> - </dl> - - <h2 id="МУЛЬТИМЕДИА" style="margin: 0 0 .25em; font: 200 24px/1 'Bebas Neue','League Gothic',Haettenschweiler,'Arial Narrow',sans-serif; letter-spacing: 1px; text-transform: uppercase; border: none;"><img alt="" src="/files/3835/HTML5_Multimedia_512.png" style="height: 64px; padding-right: 0.5em; vertical-align: middle; width: 64px;">МУЛЬТИМЕДИА</h2> - - <dl> - <dt><a href="/en-US/docs/Using_HTML5_audio_and_video" title="Using_audio_and_video_in_Firefox">Использование HTML5 audio и video</a></dt> - <dd>{{ HTMLElement("audio") }} и {{ HTMLElement("video") }} элементы вставляют и позволяют управлять мультимедиа контентом.</dd> - <dt><a href="/en-US/docs/WebRTC" title="/en-US/WebRTC">WebRTC</a></dt> - <dd>Эта технология, где RTC создаёт возможность общения в реальном времени, позволяет подключаться к другим людям и контролировать видеоконференции непосредственно в браузере, без необходимости плагинов и внешний приложений.</dd> - <dt><a href="/en-US/docs/DOM/Using_the_Camera_API" title="/en-US/docs/DOM/Using_the_Camera_API">Использование Camera API</a></dt> - <dd>Позволяет контролировать, манипулировать и хранить изображения с камеры устройства.</dd> - </dl> - - <h2 id="ГРАФИКА_И_ЭФФЕКТЫ" style="margin: 0 0 .25em; font: 200 24px/1 'Bebas Neue','League Gothic',Haettenschweiler,'Arial Narrow',sans-serif; letter-spacing: 1px; text-transform: uppercase; border: none;"><img alt="" src="/files/3841/HTML5_3D_Effects_512.png" style="height: 64px; padding-right: 0.5em; vertical-align: middle; width: 64px;">ГРАФИКА И ЭФФЕКТЫ</h2> - - <dl> - <dt><a href="/en-US/docs/Canvas_tutorial" title="Canvas tutorial">Canvas Tutorial</a></dt> - <dd><code>Узнайте о элементе {{ HTMLElement("canvas") }}</code> и узнайте, как рисовать графику и другие элементы в Firefox.</dd> - <dt><a href="/en-US/docs/Drawing_text_using_a_canvas" title="Drawing_text_using_a_canvas">HTML5 text API для <code><canvas></code></a></dt> - <dd>HTML5 text API сейчас поддерживается в {{ HTMLElement("canvas") }}.</dd> - <dt><a href="/en-US/docs/WebGL" title="WebGL">WebGL</a></dt> - <dd>WebGL приносит 3D в веб, соответствует OpenGL ES 2.0, может использоваться в HTML5 через {{ HTMLElement("canvas") }}.</dd> - <dt><a href="/en-US/docs/SVG" title="/en-US/docs/SVG">SVG</a></dt> - <dd>Основанный на XML формат векторных изображений, который может быть непосредственно вставлен в HTML.</dd> - </dl> - - <dl> - <dt></dt> - </dl> - </td> - <td> - <h2 id="производительность_и_интеграция" style="margin: 0 0 .25em; font: 200 24px/1 'Bebas Neue','League Gothic',Haettenschweiler,'Arial Narrow',sans-serif; letter-spacing: 1px; text-transform: uppercase; border: none;"><img alt="" src="/files/3831/HTML5_Performance_512.png" style="height: 64px; padding-right: 0.5em; vertical-align: middle; width: 64px;">производительность и интеграция</h2> - - <dl> - <dt><a href="/en-US/docs/DOM/Using_web_workers" title="Using web workers">Web Workers</a></dt> - <dd>Позволяет делегировать выполнение JavaScript в фоновые потоки, это позволит предотвратить замедление интерактивных событий.</dd> - <dt><code><a href="/en-US/docs/DOM/XMLHttpRequest" title="XMLHttpRequest">XMLHttpRequest</a></code> Level 2</dt> - <dd>Позволяет извлечь асинхронно некоторые части страницы, что позволяет отобразить динамический контент, изменяющейся время от времени или от действий пользователя. Это технология, лежащая в основе <a href="/en-US/docs/AJAX" title="/en-US/docs/AJAX">AJAX</a>.</dd> - <dt>JIT-компилирование движков JavaScript</dt> - <dd>Новое поколение движков JavaScript гораздо более мощных, приводящих к большей производительности.</dd> - <dt><a href="https://developer.mozilla.org/en-US/docs/DOM/Manipulating_the_browser_history" title="https://developer.mozilla.org/en-US/docs/DOM/Manipulating_the_browser_history">History API</a></dt> - <dd>Позволяет управлять историей браузера. Это особенно полезно страниц, интерактивно загружающих новую информацию.</dd> - <dt><a href="/en-US/docs/HTML/Content_Editable" title="HTML/Content Editable">contentEditable атрибут: трансформируйте свой сайт в википедию!</a></dt> - <dd>HTML5 стандартизировал атрибут contentEditable. Узнайте больше об этой фиче.</dd> - <dt><a href="/en-US/docs/DragDrop/Drag_and_Drop" title="DragDrop/Drag_and_Drop">Drag and drop</a></dt> - <dd>HTML5 drag and drop API позволяет перетаскивать элементы по сайту или на него. Также простейшее API для использования расширениями или иными приложениями.</dd> - <dt><a href="/en-US/docs/Focus_management_in_HTML" title="Focus_management_in_HTML">Управление фокусом в HTML</a></dt> - <dd>Поддержка новый атрибутов HTML5 <code>activeElement</code> and <code>hasFocus</code>.</dd> - <dt><a href="/en-US/docs/Web-based_protocol_handlers" title="Web-based_protocol_handlers">Обработчики протоколов для Web</a></dt> - <dd><code>Вы можете зарегистровать веб-приложения, как обработчики протоколов, используя метод navigator.registerProtocolHandler()</code>.</dd> - <dt><a href="/en-US/docs/DOM/window.requestAnimationFrame" title="/en-US/docs/DOM/window.requestAnimationFrame"><code>requestAnimationFrame</code></a></dt> - <dd>Контролирует анимации для обеспечения оптимальной производительности.</dd> - <dt><a href="/en-US/docs/DOM/Using_full-screen_mode" title="/en-US/docs/DOM/Using_full-screen_mode">Fullscreen API</a></dt> - <dd>Позволяет использовать весь экран для веб-приложения, без отображения UI браузера.</dd> - <dt><a href="/en-US/docs/API/Pointer_Lock_API" title="/en-US/docs/API/Pointer_Lock_API">Pointer Lock API</a></dt> - <dd>Позволяет блокировать курсор, так чтобы игры и подобные приложения не теряли фокус, когда указатель достигает предела окна.</dd> - <dt><a href="/en-US/docs/Online_and_offline_events" title="/en-US/docs/Online_and_offline_events">Online and offline events</a></dt> - <dd>Для того, чтобы построить хорошую офлайн-совместимые веб-приложения, вы должны знать, когда ваше приложение без сети. Также, вы должны знать, когда ваше приложение снова вернётся в сеть.</dd> - </dl> - - <h2 id="доступ_к_устройствам" style="margin: 0 0 .25em; font: 200 24px/1 'Bebas Neue','League Gothic',Haettenschweiler,'Arial Narrow',sans-serif; letter-spacing: 1px; text-transform: uppercase; border: none;"><img alt="" src="/files/3837/HTML5_Device_Access_512.png" style="height: 64px; padding-right: 0.5em; vertical-align: middle; width: 64px;">доступ к устройствам</h2> - - <dl> - <dt><a href="/en-US/docs/DOM/Using_the_Camera_API" title="/en-US/docs/DOM/Using_the_Camera_API">Использование Camera API</a></dt> - <dd>Позволяет контролировать, манипулировать и хранить изображения с камеры устройства.</dd> - <dt><a href="/en-US/docs/DOM/Touch_events" title="/en-US/docs/DOM/Touch_events">Touch события</a></dt> - <dd>Обрабатывает события, создаваемые нажатиями пользователя по тач скрину.</dd> - <dt><a href="/en-US/docs/Using_geolocation" title="Using geolocation">Геолокация</a></dt> - <dd>Позволяет браузерам получать местоположение пользователя.</dd> - <dt><a href="/en-US/docs/Detecting_device_orientation" title="/en-US/docs/Detecting_device_orientation">Определение ориентации устройства</a></dt> - <dd>Позволяет среагировать, когда устройство, на котором работает браузер, меняет ориентацию. Это может быть использовано в качестве устройства ввода (например, чтобы сделать игры, которые реагируют на положение устройства) или адаптировать компоновку страницы с ориентацией экрана (вертикальная или горизонтальная).</dd> - <dt><a href="/en-US/docs/API/Pointer_Lock_API" title="/en-US/docs/API/Pointer_Lock_API">Pointer Lock API</a></dt> - <dd>Позволяет блокировать курсор, так чтобы игры и подобные приложения не теряли фокус, когда указатель достигает предела окна.</dd> - </dl> - - <h2 id="стилизация" style="margin: 0 0 .25em; font: 200 24px/1 'Bebas Neue','League Gothic',Haettenschweiler,'Arial Narrow',sans-serif; letter-spacing: 1px; text-transform: uppercase; border: none;"><img alt="" src="/files/3829/HTML5_Styling_512.png" style="height: 64px; padding-right: 0.5em; vertical-align: middle; width: 64px;">стилизация</h2> - - <p><a href="/en-US/docs/CSS" title="/en-US/docs/CSS">CSS</a> был расширен, чтобы дать возможность стилизировать элементы наиболее оптимальным способом. Его часто называют CSS3, хотя CSS больше не является монолитной спецификацией и различные модули, не все на уровне 3: некоторые на уровне 1, а некоторые на уровне 4, с промежуточными уровнями.</p> - - <dl> - <dt>Новые способы стилизирования фона</dt> - <dd>Новая возможность задать тень элемента, используя {{ cssxref("box-shadow") }} или установление <a href="/en-US/docs/CSS/Multiple_backgrounds" title="/en-US/docs/CSS/Multiple_backgrounds">множественных фонов</a>.</dd> - <dt>Лучшие границы</dt> - <dd>Не только изображения можно использовать для стилизирования границы, используя {{ cssxref("border-image") }} или его длинные формы записи, а скруглить уголки можно свойством {{ cssxref("border-radius") }}.</dd> - <dt>Анимируйте свой стиль</dt> - <dd>Используйте <a href="/en-US/docs/CSS/Using_CSS_transitions" title="/en-US/docs/CSS/Using_CSS_transitions">CSS Переходы</a>, чтобы анимировать изменение состояния элемента или <a href="/en-US/docs/CSS/Using_CSS_animations" title="/en-US/docs/CSS/Using_CSS_animations">CSS Анимации</a> для анимации частей страницы без запуска событий, вы теперь можете контролировать мобильные элементы на вашей странице.</dd> - <dt>Улучшение типографии</dt> - <dd>Авторы могут лучше контролировать типографию. Например, они могут контролировать {{ cssxref("text-overflow") }} и <a href="/en-US/docs/CSS/hyphens" title="/en-US/docs/CSS/hyphens">перенос слов</a>, а также <a href="/en-US/docs/CSS/text-shadow" title="/en-US/docs/CSS/text-shadow">тень текста</a> и его <a href="/en-US/docs/CSS/text-decoration" title="/en-US/docs/SVG/Attribute/text-decoration">декорирование</a>. Могут загрузить и применить другой шрифт правилом {{ cssxref("@font-face") }}.</dd> - <dt>Новые презентационные макеты</dt> - <dd>Для того, чтобы улучшить гибкость дизайна, добавили: <a href="/en-US/docs/CSS/Using_CSS_multi-column_layouts" title="/en-US/docs/CSS/Using_CSS_multi-column_layouts">CSS мульти-колоночный макет</a> и <a href="/en-US/docs/CSS/Flexbox" title="/en-US/docs/CSS/Flexbox">CSS отзывчивый блочный макет</a>.</dd> - </dl> - </td> - </tr> - </tbody> -</table> diff --git a/files/ru/orphaned/web/guide/html/html5/introduction_to_html5/index.html b/files/ru/orphaned/web/guide/html/html5/introduction_to_html5/index.html deleted file mode 100644 index fc4bfc2bd9..0000000000 --- a/files/ru/orphaned/web/guide/html/html5/introduction_to_html5/index.html +++ /dev/null @@ -1,27 +0,0 @@ ---- -title: Введение в HTML5 -slug: orphaned/Web/Guide/HTML/HTML5/Introduction_to_HTML5 -tags: - - DOCTYPE - - HTML5 - - HTML5 парсер -translation_of: Web/Guide/HTML/HTML5/Introduction_to_HTML5 -original_slug: Web/Guide/HTML/HTML5/Introduction_to_HTML5 ---- -<p><a class="external" href="http://www.whatwg.org/specs/web-apps/current-work/" title="http://www.whatwg.org/specs/web-apps/current-work/">HTML5</a> - пятая редакция и самая новая версия стандарта HTML. Она предлагает новые возможности, которые предоставляют не только богатую поддержку медиа, но и также расширяет возможности для создания веб-приложений, которые могут взаимодействовать с пользователем, его локальными данными, и серверами проще и эффективнее, чем это было раньше.</p> -<p>Because HTML5 is still being developed, changes to the specifications are inevitable. Therefore, not all of its features are supported by all browsers yet. However, Gecko, and by extension, Firefox, has very good initial support for HTML5, and work continues toward supporting more of its features. Gecko began supporting some HTML5 features in version 1.8.1. You can find a list of all of the HTML5 features that Gecko currently supports on the <a href="/en/HTML/HTML5" title="en/HTML/HTML5">main HTML5 page</a>. For detailed information about multiple browsers' support of HTML5 features, refer to the <a class="external" href="http://caniuse.com/#cats=HTML5" title="http://caniuse.com/#cats=HTML5">CanIUse</a> website.</p> -<h2 id="Declaring_that_the_document_contains_HTML5_mark-up_with_the_HTML5_doctype">Declaring that the document contains HTML5 mark-up with the HTML5 doctype</h2> -<p>The doctype for HTML5 is very simple. To indicate that your HTML content uses HTML5, simply use:</p> -<pre class="brush:html;"><!DOCTYPE html> -</pre> -<p>Doing so will cause even browsers that don't presently support HTML5 to enter into standards mode, which means that they'll interpret the long-established parts of HTML in an HTML5-compliant way while ignoring the new features of HTML5 they don't support.</p> -<p>This is much simpler than the former doctypes, and shorter, making it easier to remember and reducing the amount of bytes that must be downloaded.</p> -<h2 id="Декларация_кодировки_с_помощью_<meta_charset>">Декларация кодировки с помощью <code><meta charset></code></h2> -<p>The first thing done on a page is usually indicating the character set that is used. In previous versions of HTML, it was done using a very complex {{HTMLElement("meta")}} element. Now, it is very simple:</p> -<pre class="brush:html;"><meta charset="UTF-8"></pre> -<p>Place this right after your {{HTMLElement("head") }}, as some browsers restart the parsing of an HTML document if the declared charset is different from what they had anticipated. Also, if you are not currently using UTF-8, it's recommended that you switch to it in your Web pages, as it simplifies character handling in documents using different scripts.</p> -<p>Note that HTML5 restricts the valid charset to that compatible with ASCII and using at least 8 bits. This was done to tighten security and prevent some types of attacks.</p> -<h2 id="Использование_нового_HTML5_парсера">Использование нового HTML5 парсера</h2> -<p>The parsing rule of HTML5, which analyzes the meaning of mark-up, has been more precisely defined in HTML5. Until the introduction of HTML5, only the meaning of <em>valid</em> mark-up was defined, meaning that as soon as one small error was made in the mark-up (most Web sites have at least one), the behavior was undefined. Essentially, it meant that all browsers behaved differently, which is no longer the case. Now, faced with errors in the mark-up, all compliant browsers must behave exactly in the same way.</p> -<p>This requirement helps Web developers quite a bit. While it is true that all modern browsers now use these HTML5 parsing rules, non-HTML5-compliant browsers are still used by some. Keep in mind that it's still highly recommended that one write valid mark-up, as such code is easier to read and maintain, and it greatly decreases the prominence of incompatibilities that exists in various older browsers.</p> -<p>Не волнуйтесь - вам не придётся ничего менять на вашем веб-сайте - разработчики веб-браузерах сделали все для вас!</p> diff --git a/files/ru/orphaned/web/guide/html/using_html_sections_and_outlines/index.html b/files/ru/orphaned/web/guide/html/using_html_sections_and_outlines/index.html deleted file mode 100644 index fc0c5e000f..0000000000 --- a/files/ru/orphaned/web/guide/html/using_html_sections_and_outlines/index.html +++ /dev/null @@ -1,374 +0,0 @@ ---- -title: Использование разделов и создание структуры HTML документа -slug: orphaned/Web/Guide/HTML/Using_HTML_sections_and_outlines -tags: - - HTML5 - - Веб - - Для опытных разработчиков - - Обзор - - Пример - - Разделы - - Руководство - - Структура -translation_of: Web/Guide/HTML/Using_HTML_sections_and_outlines -original_slug: Web/Guide/HTML/Using_HTML_sections_and_outlines ---- -<div class="warning"> -<p><strong>Важно</strong>: В настоящее время нет известных реализаций алгоритма построения структуры документа в графических браузерах или пользовательских приложениях, использующих реабилитационные технологии, хотя такой алгоритм внедрён в другие приложения, например, в средствах проверки соответствия спецификации. Поэтому алгоритм <a href="http://www.w3.org/TR/html5/sections.html#outline">построения структуры</a> нельзя использовать для передачи структуры документа пользователям. Авторы рекомендуют использовать для этой цели <a href="http://www.w3.org/TR/html5/sections.html#rank">степень важности</a> заголовков (<code><a href="http://www.w3.org/TR/html5/sections.html#the-h1,-h2,-h3,-h4,-h5,-and-h6-elements">h1</a></code>-<code><a href="http://www.w3.org/TR/html5/sections.html#the-h1,-h2,-h3,-h4,-h5,-and-h6-elements">h6</a></code>).</p> -</div> - -<p>Спецификация HTML5 предлагает разработчикам несколько новых элементов, позволяющих описывать структуру веб-документа с помощью стандартной семантики. В настоящей статье описываются эти элементы и способы их использования для создания требуемой структуры любого документа.</p> - -<h2 id="Структура_документа_в_HTML_4">Структура документа в HTML 4</h2> - -<p>Структура документа, т. е. семантическая структура контента, заключённого в теги <code><body></code> и <code></body></code>, является основой для представления страницы пользователю. HTML4 использует для описания структуры страницы разделы и подразделы. Раздел определяется элементом ({{HTMLElement("div")}}) с включёнными в него элементами заголовка ({{HTMLElement("h1")}}, {{HTMLElement("h2")}}, {{HTMLElement("h3")}}, {{HTMLElement("h4")}}, {{HTMLElement("h5")}} или {{HTMLElement("h6")}}), содержащими его название. Структура документа определяется отношениями между этими элементами.</p> - -<p>Так, следующая разметка:</p> - -<div style="overflow: hidden;"> -<pre class="brush:xml notranslate"><div class="section" id="forest-elephants" > - <h1>Лесные слоны</h1> - <p>В данном разделе мы поговорим о малоизвестных лесных слонах. - ...продолжение данного раздела... - <div class="subsection" id="forest-habitat" > - <h2>Среда обитания</h2> - <p>Лесные слоны живут не на деревьях, а под ними. - ...продолжение данного подраздела... - </div> -</div> -</pre> -</div> - -<p>обеспечивает следующую структуру:</p> - -<pre class="notranslate">1. Лесные слоны - 1.1 Среда обитания -</pre> - -<p>Для задания нового раздела не обязательно использовать элементы {{HTMLElement("div")}}. Для этого достаточно наличия элемента заголовка. Поэтому, разметка</p> - -<pre class="brush:xml notranslate"><h1>Лесные слоны</h1> - <p>В данном разделе мы поговорим о малоизвестных лесных слонах. - ...продолжение данного раздела... - <h2>Среда обитания</h2> - <p>Лесные слоны живут не на деревьях, а под ними. - ...продолжение данного подраздела... - <h2>Рацион</h2> -<h1>Монгольская песчанка</h1> -</pre> - -<p>обеспечивает следующую структуру:</p> - -<pre class="notranslate">1. Лесные слоны - 1.1 Среда обитания - 1.2 Рацион -2. Монгольская песчанка -</pre> - -<h2 id="Какие_проблемы_решает_HTML5">Какие проблемы решает HTML5</h2> - -<p>Определение структуры документа и неявный алгоритм создания структуры в HTML 4 не отличаются чёткостью, что порождает множество проблем:</p> - -<ol> - <li>Использование {{HTMLElement("div")}} для задания семантических разделов, без задания специальных значений для атрибутов <strong>class</strong> не позволяет автоматизировать алгоритм создания структуры («Является ли данный {{HTMLElement("div")}} частью структуры страницы, определяющим раздел или подраздел, или он используется исключительно для управления стилем?»). Другими словами, спецификация HTML4 не даёт точного определения разделу и чётких правил его определения. Автоматическое создание структуры имеет большое значение, особенно в случае с <a class="external" href="http://en.wikipedia.org/wiki/Assistive_technology" title="http://en.wikipedia.org/wiki/Assistive_technology">реабилитационными технологиями</a>, представляющими информацию пользователю в соответствии со структурой документа. HTML5 позволяет больше не использовать элементы {{HTMLElement("div")}} в алгоритме построения структуры благодаря добавлению нового элемента {{HTMLElement("section")}}.</li> - <li>Объединить несколько документов в один непросто: включение подчинённого документа в основной документ требует изменения уровня элементов заголовков для сохранения правильной структуры. В HTML5 эта проблема решена благодаря новым элементам задания разделов ({{HTMLElement("article")}}, {{HTMLElement("section")}}, {{HTMLElement("nav")}} и {{HTMLElement("aside")}}), которые всегда являются подразделами ближайшего родительского раздела, независимо от того, какие разделы создаются внутренними заголовками.</li> - <li>В HTML4 каждый раздел является частью структуры документа. Однако часто документы отличаются сложной, нелинейной структурой. Документ может включать специальные разделы, информация в которых не является частью основного контента, хотя и связана с ним, например, рекламный блок или поясняющая заметка. HTML5 добавляет элемент {{HTMLElement("aside")}}, позволяющий исключить такие разделы из основной структуры.</li> - <li>Опять же, поскольку в HTML4 каждый раздел является частью структуры документа, как быть с разделами, содержащими информацию, касающуюся не конкретного документа, а всего сайта, например, логотипы, оглавления или информация об авторских правах и правовые положения. В HTML5 для этих целей добавлено три новых элемента: {{HTMLElement("nav")}} для наборов ссылок, например, оглавления, {{HTMLElement("footer")}} и {{HTMLElement("header")}} для информации, касающейся всего сайта. Обратите внимание, что {{HTMLElement("header")}} и {{HTMLElement("footer")}} не создают разделы как {{HTMLElement("section")}}, а, скорее, обеспечивают семантическую разметку частей раздела.</li> -</ol> - -<p>В общем, HTML5 обеспечивает большую точность при задании разделов и оглавлений, позволяя строить более предсказуемую структуру документа, что даёт браузерам возможность более качественно обслуживать пользователей.</p> - -<h2 id="Алгоритм_создания_структуры_HTML5">Алгоритм создания структуры HTML5</h2> - -<h3 id="Задание_разделов_в_HTML5">Задание разделов в HTML5</h3> - -<p>Весь контент, находящийся внутри {{HTMLElement("body")}}, является частью раздела. Разделы в HTML5 могут быть вложенными. Помимо основного раздела, определяемого элементом {{HTMLElement("body")}}, границы разделов определяются явным или неявным образом. Явным образом заданные разделы – это контент внутри тегов {{HTMLElement("body")}}, {{HTMLElement("section")}}, {{HTMLElement("article")}}, {{HTMLElement("aside")}} и {{HTMLElement("nav")}}. </p> - -<div class="note"><strong>Note: </strong>Каждый раздел может иметь собственную иерархию заголовков. Следовательно, даже вложенный раздел может иметь {{HTMLElement("h1")}}. См. <a href="/en-US/docs/Sections_and_Outlines_of_an_HTML5_document#Defining_Headings_in_HTML5" title="en-US/docs/Sections_and_Outlines_of_an_HTML5_document#Defining_Headings_in_HTML5">«Задание заголовков в HTML5»</a>.</div> - -<p>Например:</p> - -<pre class="brush:xml notranslate"><section> - <h1>Лесные слоны</h1> - <section> - <h1>Введение</h1> - <p>В данном разделе мы поговорим о малоизвестных лесных слонах.</p> - </section> - <section> - <h1>Среда обитания</h1> - <p>Лесные слоны живут не на деревьях, а под ними.</p> - </section> - <aside> - <p>рекламный блок</p> - </aside> -</section> -<footer> - <p>(c) 2010 The Example company</p> -</footer></pre> - -<p>Данный фрагмент HTML задаёт раздел верхнего уровня:</p> - -<pre class="notranslate"><span style="color: red;"><section> - <h1>Лесные слоны</h1> - <section> - <h1>Введение</h1> - <p>В данном разделе мы поговорим о малоизвестных лесных слонах.</p> - </section> - <section> - <h1>Среда обитания</h1> - <p>Лесные слоны живут не на деревьях, а под ними.</p> - </section> - <aside> - <p>рекламный блок</p> - </aside> -</section></span> -<footer> - <p>(c) 2010 The Example company</p> -</footer></pre> - -<p>Данный раздел имеет три подраздела:</p> - -<pre class="notranslate"><section> - <h1>Лесные слоны</h1> - - <span style="color: red;"><section> - <h1>Введение</h1> - <p>В данном разделе мы поговорим о малоизвестных лесных слонах.</p> - </section></span> - - <span style="color: green;"><section> - <h1>Среда обитания</h1> - <p>Лесные слоны живут не на деревьях, а под ними.</p> - </section></span> - - <span style="color: blue;"><aside> - <p>рекламный блок</p> - </aside></span> -</section> - -<footer> - <p>(c) 2010 The Example company</p> -</footer></pre> - -<p>В результате получаем следующую структуру:</p> - -<pre class="notranslate">1. Лесные слоны - 1.1 Введение - 1.2 Среда обитания -</pre> - -<h3 id="Задание_заголовков_в_HTML5">Задание заголовков в HTML5</h3> - -<p>Хотя структура определяется элементами задания структуры, она будет практически бесполезна без заголовка. Основное правило очень простой: первый элемент заголовка (это может быть {{HTMLElement("h1")}}, {{HTMLElement("h2")}}, {{HTMLElement("h3")}}, {{HTMLElement("h4")}}, {{HTMLElement("h5")}}, {{HTMLElement("h6")}}) задаёт заголовок текущего раздела.</p> - -<p>Элемент заголовка имеет определённую <em>степень важности,</em> определяемую цифрой в его названии, таким образом, {{HTMLElement("h1")}} имеет <em>максимальную</em> степень важности, а {{HTMLElement("h6")}} <em>минимальную</em>. Соотношение степеней важности имеет смысл только внутри раздела; структура документа определяется структурами разделов, а не степенью важности заголовков разделов. Например, данный код:</p> - -<pre class="brush:xml notranslate"><section> - <h1>Лесные слоны</h1> - <p>В данном разделе мы поговорим о малоизвестных лесных слонах. - ...продолжение данного раздела... - <section> - <h2>Среда обитания</h2> - <p>Лесные слоны живут не на деревьях, а под ними. - ...продолжение данного подраздела... - </section> -</section> -<section> - <h3>Монгольская песчанка</h3> - <p>В данном разделе мы расскажем о монгольской песчанке. - ...продолжение данного раздела... -</section></pre> - -<p>приводит к следующей структуре:</p> - -<pre class="notranslate">1. Лесные слоны - 1.1 Среда обитания -2. Монгольская песчанка</pre> - -<p>Обратите внимание, что степень важности элемента заголовка (в данном примере {{HTMLElement("h1")}} для первого раздела верхнего уровня, {{HTMLElement("h2")}} для подраздела {{HTMLElement("h3")}} для второго раздела верхнего уровня) роли не играет. (В качестве заголовка явно заданного раздела может использоваться заголовок с любой степенью важности, хотя такая практика и не рекомендуется.)</p> - -<h3 id="Неявное_задание_разделов">Неявное задание разделов</h3> - -<p>Поскольку элементы задания разделов HTML5 Sectioning Elements не являются обязательными для задания структуры, можно задавать разделы и не используя их, чтобы обеспечить совместимость с веб-сайтами, созданными на HTML4. Это называется <em>неявным заданием разделов</em>.</p> - -<p>Элементы заголовков ({{HTMLElement("h1")}} — {{HTMLElement("h6")}}) задают новый, неявный раздел, когда не являются первым заголовком своего родительского, явно заданного раздела. То, как этот неявно заданный раздел располагается в структуре документа, определяется отношением важности его заголовка в важности предыдущего заголовка в родительском разделе. Если его степень важности ниже, чем у предыдущего заголовка, он открывает неявно заданный подраздел раздела. Следующий код:</p> - -<pre class="brush:xml notranslate"><section> - <h1>Лесные слоны</h1> - <p>В данном разделе мы поговорим о малоизвестных лесных слонах. - ...продолжение данного раздела... - <h3 class="implicit subsection">Среда обитания</h3> - <p>Лесные слоны живут не на деревьях, а под ними. - ...продолжение данного подраздела... -</section></pre> - -<p>приводит к следующей структуре:</p> - -<pre class="notranslate">1. Лесные слоны - 1.1 Среда обитания <em>(неявно задано элементом h3)</em> -</pre> - -<p>Если степень важности такого заголовка совпадает со степенью важности предыдущего заголовка, он закрывает предыдущий раздел (который мог быть задан неявно!) и открывает новый неявно заданный раздел на том же уровне: </p> - -<pre class="brush:xml notranslate"><section> - <h1>Лесные слоны</h1> - <p>В данном разделе мы поговорим о малоизвестных лесных слонах. - ...продолжение данного раздела... - <h1 class="implicit section">Монгольская песчанка</h1> - <p>Монгольская песчанка – это небольшое симпатичное млекопитающее. - ...продолжение данного раздела... -</section></pre> - -<p>приводит к следующей структуре:</p> - -<pre class="notranslate">1. Лесные слоны -2. Монгольская песчанка <em>(неявно задано элементом h1, который одновременно закрывает предыдущий раздел)</em> -</pre> - -<p>Если степень важности такого заголовка выше, чем у предыдущего заголовка, он закрывает предыдущий раздел и открывает новый неявно заданный раздел на более высоком уровне:</p> - -<pre class="brush:xml notranslate"><body> - <h1>Млекопитающие</h1> - <h2>Киты</h2> - <p>В данном разделе мы поговорим о китах. - ...продолжение данного раздела... - <section> - <h3>Лесные слоны</h3> - <p>В данном разделе мы поговорим о малоизвестных лесных слонах. - ...продолжение данного раздела... - <h3>Монгольская песчанка</h3> - <p>Песчанки распространились далеко за пределы Монголии. - ...продолжение данного подраздела... - <h2>Рептилии</h2> - <p>Рептилии – это холоднокровные животные. - ...продолжение данного раздела... - </section> -</body></pre> - -<p>приводит к следующей структуре:</p> - -<pre class="notranslate">1. Млекопитающие - 1.1 <em>Киты (неявно задаётся элементом h2)</em> - 1.2 Лесные слоны <em>(явным образом задаётся элементом раздела)</em> - 1.3 Монгольская песчанка <em>(неявно задаётся элементом h3, который одновременно закрывает предыдущий раздел)</em> -2. <em>Рептилии (неявно задаётся элементом h2, который одновременно закрывает предыдущий раздел)</em> -</pre> - -<p>Эта не та структура, которую можно было бы ожидать, бегло просмотрев теги заголовков. Чтобы разметка стала понятна человеку, а также чтобы степень важности заголовка соответствовала уровню вложенности раздела, рекомендуется использовать наглядные теги для открытия и закрытия разделов. Однако спецификация HTML5 этого не требует. Поэтому, если браузеры отображают структуру документа не так, как ожидалось, проверьте, нет ли в документе разделов, не явно закрытых элементами заголовков.</p> - -<p>Исключение из общего правила соответствия степени важности тега уровню вложенности раздела делается для разделов, которые могут использоваться в нескольких документах. Например, раздел может храниться в системе управления контентом и добавляться в документы при их генерировании. В этом случае рекомендуется начинать с {{HTMLElement("h1")}} в качестве главного заголовка многократно используемого раздела. Уровень вложенности многократно используемого раздела будет определяться иерархией разделов документа, в который он добавляется. Теги для явного задания разделов по-прежнему останутся полезными и в этом конкретном случае.</p> - -<h3 id="Корни_задания_разделов"><a name="sectioning_root">Корни задания разделов</a></h3> - -<p> <a id="sectioning root" name="sectioning root">Корень задания разделов</a> – это элемент HTML, который может иметь собственную структуру, однако входящие в неё разделы и заголовки, не входят в структуру его родительского элемента. Помимо {{HTMLElement("body")}}, который является логическим корнем задания разделов документа, такими элементами часто являются элементы, добавляющие внешний контент на страницу: {{HTMLElement("blockquote")}}, {{HTMLElement("details")}}, {{HTMLElement("fieldset")}}, {{HTMLElement("figure")}} и {{HTMLElement("td")}}.</p> - -<p>Например:</p> - -<pre class="brush:xml notranslate"><section> - <h1>Лесные слоны</h1> - <section> - <h2>Введение</h2> - <p>В данном разделе мы поговорим о малоизвестных лесных слонах</p> - </section> - <section> - <h2>Среда обитания</h2> - <p>Лесные слоны живут не на деревьях, а под ними. Давайте рассмотрим, что говорят учёные в «<cite>Лесной слон на Борнео</cite>»:</p> - <blockquote> - <h1>Борнео</h1> - <p>Лесной слон живёт на Борнео...</p> - </blockquote> - </section> -</section> -</pre> - -<p>Данный пример приводит к следующей структуре:</p> - -<pre class="notranslate">1. Лесные слоны - 1.1 Введение - 1.2 Среда обитания</pre> - -<p>Данная структура не включает внутреннюю структуру элемента {{HTMLElement("blockquote")}}, который, будучи внешней цитатой, является корнем задания разделов и изолирует свою внутреннюю структуру.</p> - -<h3 id="Разделы_не_входящие_в_структуру">Разделы, не входящие в структуру</h3> - -<p> HTML5 вводит два новых элемента, позволяющих задавать разделы, не входящие в основную структуру веб-документа:</p> - -<ol> - <li>Элемент вспомогательного раздела {{HTMLElement("aside")}} задаёт раздел, который, хотя и связан с основным элементом, не принадлежит к основной структуре, например, поясняющая заметка или реклама. Он имеет собственную структуру, однако не входит в основную структуру страницы.</li> - <li>Элемент навигационного раздела {{HTMLElement("nav")}} задаёт раздел, содержащий навигационные ссылки. Таких элементов в документе может быть несколько, например, один со внутренними ссылками на страницу, например, оглавление, а другой – с ссылками для навигации по сайту. Такие ссылки не являются частью основной структуры документа и как правило пропускаются экранными дикторами.</li> -</ol> - -<h3 id="Шапки_и_подвалы">Шапки и подвалы</h3> - -<p>HTML5 также добавляет два новых элемента, которые могут использоваться для разметки верхнего и нижнего колонтитулов страниц:</p> - -<ol> - <li>Элемент шапки {{HTMLElement("header")}} задаёт шапку страницы (как правило, логотип и название сайта, а также горизонтальное меню, если имеется) или раздела (которая может включать заголовок раздела, имя автора и т.д.).{{HTMLElement("article")}}, {{HTMLElement("section")}}, {{HTMLElement("aside")}}, и {{HTMLElement("nav")}} могут иметь собственный {{HTMLElement("header")}}. Несмотря на название, этот элемент не обязательно располагается в начале страницы или раздела.</li> - <li>Элемент подвала ({{HTMLElement("footer")}}) задаёт нижний колонтитул страницы (как правило включающий уведомления об авторских правах и другую правовую информацию, а иногда также содержащий какие-либо ссылки) или раздела (может включать дату публикации, информацию о лицензии и т.п. {{HTMLElement("article")}}, {{HTMLElement("section")}}, {{HTMLElement("aside")}} и {{HTMLElement("nav")}} могут иметь собственный {{HTMLElement("footer")}}. Несмотря на название, этот элемент не обязательно располагается в конце страницы или раздела.</li> -</ol> - -<p>Эти элементы не создают новые разделы в структуре, а скорее используются для разметки контента внутри разделов страницы.</p> - -<h2 id="Адреса_в_элементах_задания_разделов">Адреса в элементах задания разделов</h2> - -<p>Автор документа часто хочет опубликовать свою контактную информацию, например, имя и адрес. HTML4 позволял сделать это с помощью элемента {{HTMLElement("address")}}, расширенного в HTML5.</p> - -<p>Документ может включать несколько разделов, принадлежащих разным авторам. Если раздел создаётся не автором основной страницы, для задания используется элемент {{HTMLElement("article")}}. В результате элемент {{HTMLElement("address")}} теперь связан с ближайшим родительским {{HTMLElement("body")}} или {{HTMLElement("article")}}.</p> - -<h2 id="Использование_элементов_HTML5_в_браузерах_не_поддерживающих_HTML5">Использование элементов HTML5 в браузерах, не поддерживающих HTML5</h2> - -<p>Элементы разделов и заголовков должны работать в большинстве браузеров, не поддерживающих HTML5. Хотя они и не поддерживаются, они не требуют специального интерфейса DOM, им требуется лишь особый стиль CSS, поскольку к неизвестным элементам по умолчанию применяется стиль <code>display:inline</code>:</p> - -<pre class="brush: css notranslate">section, article, aside, footer, header, nav, hgroup { - display:block; -} -</pre> - -<p>Конечно, веб-разработчик может применить к ним любой другой стиль, однако следует помнить в браузерах, не поддерживающих HTML5, по умолчанию используется не тот стиль, который требуется для таких элементов. Также обратите внимание на отсутствие в перечне элемента {{HTMLElement("time")}}, поскольку по умолчанию к нему применяется одинаковый стиль как в браузерах, не поддерживающих HTML5, так и в браузерах, совместимых с HTML5.</p> - -<p>Данный способ не универсален, поскольку некоторые браузеры не позволяют применять стили к неподдерживаемым элементам. Например, Internet Explorer (версии 8 и более ранней), для которого требуется специальный скрипт:</p> - -<pre class="brush:xml notranslate"><!--[if lt IE 9]> - <script> - document.createElement("header" ); - document.createElement("footer" ); - document.createElement("section"); - document.createElement("aside" ); - document.createElement("nav" ); - document.createElement("article"); - document.createElement("hgroup" ); - document.createElement("time" ); - </script> -<![endif]--></pre> - -<p>Этот скрипт запускается в Internet Explorer (8 и более ранней версии), однако требует включённой поддержки скриптов для правильного отображения элементов задания разделов и заголовок HTML5. Если поддержка скриптов выключена, это может стать проблемой, поскольку данные элементы, скорее всего, определяют структуру всей страницы. Поэтому необходимо добавить элемент {{HTMLElement("noscript")}}:</p> - -<pre class="brush:xml notranslate"><noscript> - <strong>Внимание!</strong> - Поскольку ваш браузер не поддерживает HTML5, некоторые элементы воспроизводятся с помощью JScript. - Однако в вашем браузере скрипты отключены, пожалуйста, включите их, чтобы браузер смог отобразить данную страницу. -</noscript></pre> - -<p>This leads to the following code to allow the support of the HTML5 sections and headings elements in non-HTML5 browsers, even for Internet Explorer (8 and older), with a proper fallback for the case where this latter browser is configured not to use scripting:</p> - -<pre class="brush:xml notranslate"><!--[if lt IE 9]> - <script> - document.createElement("header" ); - document.createElement("footer" ); - document.createElement("section"); - document.createElement("aside" ); - document.createElement("nav" ); - document.createElement("article"); - document.createElement("hgroup" ); - document.createElement("time" ); - </script> - <noscript> - <strong>Внимание!</strong> - Поскольку ваш браузер не поддерживает HTML5, некоторые элементы воспроизводятся с помощью JScript. - Однако в вашем браузере скрипты отключены, пожалуйста, включите их, чтобы браузер смог отобразить данную страницу. - </noscript> -<![endif]--></pre> - -<h2 id="Заключение">Заключение</h2> - -<p>Новые семантические элементы, добавленные в HTML5, обеспечивают стандартизацию описания структуры веб-документа. Они облегчают жизнь пользователям с ограниченными возможностями, просты в использовании, могут без особых проблем поддерживаться в старых браузерах и поэтому настоятельно рекомендуются к применению.</p> diff --git a/files/ru/orphaned/web/guide/localizations_and_character_encodings/index.html b/files/ru/orphaned/web/guide/localizations_and_character_encodings/index.html deleted file mode 100644 index e40c707ea0..0000000000 --- a/files/ru/orphaned/web/guide/localizations_and_character_encodings/index.html +++ /dev/null @@ -1,58 +0,0 @@ ---- -title: Локализация и кодировка символов -slug: orphaned/Web/Guide/Localizations_and_character_encodings -translation_of: Web/Guide/Localizations_and_character_encodings -original_slug: Web/Guide/Localizations_and_character_encodings ---- -<p>По умолчанию браузер обрабатывает текст в кодировке Юникод (Unicode). При этом, при передаче информации через сеть (network) к браузеру символы кодируются байтами (см. <a href="https://en.wikipedia.org/wiki/Character_encoding">кодирование символов</a>). <a href="http://www.whatwg.org/specs/web-apps/current-work/multipage/semantics.html#charset" title="http://www.whatwg.org/specs/web-apps/current-work/multipage/semantics.html#charset">Стандартом HTML</a> рекомендуется использовать кодировку UTF-8 (which can represent all of Unicode) and regardless of the encoding used requires Web content to declare what encoding was used.</p> - -<p>The {{HTMLElement("meta")}} element's {{htmlattrxref("charset", "meta")}} attribute is used to specify the page's character encoding. It <strong>must</strong> be used within a {{HTMLElement("head")}} block.</p> - -<p>To specify that a page is using, for example, the UTF-8 character encoding (as per the recommendation), simply place the following line in the {{HTMLElement("head")}} block:</p> - -<pre class="brush: html notranslate"><meta charset="utf-8"> -</pre> - -<h2 id="Details_and_browser_internals">Details and browser internals</h2> - -<p>When the encoding is declared by Web content like the HTML specification requires, Firefox will use that encoding for turning the bytes into the internal representation. Unfortunately, using UTF-8 and declaring that UTF-8 was used was not always the prevalent way of offering Web content. In the 1990s, it was common to leave the encoding undeclared and to use a region-specific encoding that wasn't able to represent all of Unicode.</p> - -<p>Firefox needs a fallback encoding that it uses for non-conforming legacy content that doesn't declare its encoding. For most locales, the fallback encoding is windows-1252 (often called ISO-8859-1), which was the encoding emitted by most Windows applications in the 1990s and a superset of the encoding emitted by most UNIX applications in the 1990s as a deployed in the America has and in Western Europe. However, there are locales where Web publishing was common already in the 1990s but the windows-1252 encoding was not suitable for the local language. In these locales, legacy content that doesn't declare its encoding is typically encoded using a legacy encoding other than windows-1252. In order to work with legacy content, some Firefox localizations need a non-windows-1252 fallback encoding.</p> - -<p>Unfortunately, this means that the Web-exposed functionality of Firefox differs by locale and it is hard to read legacy content across locales with different fallback encodings. To avoid introducing this problem in locales where Web publishing took off after the adoption of UTF-8, locales that don't have a non-windows-1252 legacy encoding arising from the practices of the 1990s, should leave the fallback encoding at windows-1252 to facilitate reading content cross-locale from the old locales whose fallback encoding is windows-1252. New-authored locale-native UTF-8 content is expected to declare its encoding, in which case the fallback encoding does not participate in the processing of content.</p> - -<p>Additionally, there is a small number of locales where in the 1990s there wasn't an obvious single region-specific encoding and heuristic detection among multiple legacy encodings was introduced to Web browsers. This has then had the effect that Web authors have depended on heuristic detection being present, so Firefox still has heuristic detection in these locales.</p> - -<h2 id="Finding_canonical_encoding_names">Finding canonical encoding names</h2> - -<p>The text below refers to canonical names of encodings. The canonical names are the values to the right of the equals sign in <a href="https://mxr.mozilla.org/mozilla-central/source/intl/locale/unix/unixcharset.properties" title="https://mxr.mozilla.org/mozilla-central/source/intl/locale/unix/unixcharset.properties">unixcharset.properties</a>.</p> - -<h2 id="Specifying_the_fallback_encoding">Specifying the fallback encoding</h2> - -<p><strong>As of Firefox 28, this section is obsolete, since the preference <code>intl.charset.default</code> no longer exists. The mapping from locales onto fallback encodings is now built into Gecko itself.</strong></p> - -<p>The fallback encoding is specified by the preference <code>intl.charset.default</code> in <code>intl.properties</code>. It should be set to the canonical name of the legacy encoding that users of the localizations are most likely to encounter when browsing non-conforming legacy Web content that doesn't declare its encoding. Note that the fallback encoding as defined by the previous sentence does not necessarily need to be able to represent the characters needed for the language of the localization!</p> - -<p>The fallback encoding should be left to windows-1252 for Western European locales, North, Central and South American locales, African locales, Central Asian locales and Oceanian locales. It typically needs to be set to something other than windows-1252 for Central and Eastern European locales, Middle Eastern locales and East Asian locales.</p> - -<p>In order to avoid the problem of Web authors creating new UTF-8 content without declaring that the content uses UTF-8 and in order to maximize the ability of users to read content cross-locale, <em>do not</em> set the fallback encoding to UTF-8 for any newly-introduced localization. Note that Firefox no longer sends the <code>Accept-Charset</code> HTTP header, so there is no need to consider what gets advertised in <code>Accept-Charset</code> when setting the fallback encoding.</p> - -<p>For locales where the fallback encoding is currently ISO-8859-1, it should be changed to windows-1252. ISO-8859-1 is decoded in the exact same way as windows-1252, but Firefox is moving to treating windows-1252 as the preferred label for this encoding in accordance with the <a href="http://encoding.spec.whatwg.org/" title="http://encoding.spec.whatwg.org/">Encoding Standard</a>.</p> - -<p>For locales where Internet Explorer has more market share than Firefox, the fallback encoding should typically be set to the same value as in Internet Explorer. You can see the fallback encoding a particular browser has by loading a <a href="http://hsivonen.iki.fi/test/moz/check-charset.htm" title="http://hsivonen.iki.fi/test/moz/check-charset.htm">test page</a>. (Be sure to use a browser installation that has its settings left to the defaults when investigating!)</p> - -<p>For locales where Firefox has more market share than Internet Explorer, it's probably best not to change the fallback encoding even if it doesn't follow the guidance given above. (For example, the fallback encoding for the Polish, Hungarian and Czech locales should probably continue to be ISO-8859-2 even though IE has a different fallback encoding.)</p> - -<p>When in doubt, use windows-1252 as the fallback encoding.</p> - -<h2 id="Specifying_the_heuristic_detection_mode">Specifying the heuristic detection mode</h2> - -<p>The heuristic detection mode is specified by the preference <code>intl.charset.detector</code> in <code>intl.properties</code>. The setting <em>must</em> be left blank for all locales other than Russian, Ukrainian and Japanese. Do not under any circumstances specify the "universal" detector. It is <em>not actually universal</em> despite its name!</p> - -<h2 id="Exception_for_minority_languages">Exception for minority languages</h2> - -<p>If the localization is for minority language and the users are typically literate in the majority language of the region and read Web content written in the majority language very often, it is appropriate to specify the fallback encoding and the heuristic detection mode to be the same as for the localization for the majority language of the region. For example, for a localization for minority language in Russia, it is appropriate to copy the settings from the Russian localization.</p> - -<h2 id="Setting_some_encodings_to_be_more_easily_selectable_from_the_character_encoding_menu">Setting some encodings to be more easily selectable from the character encoding menu</h2> - -<p>The preference <code>intl.charsetmenu.browser.static</code> in <code>intl.properties</code> makes some character encodings more easily available in the Character Encoding menu in the browser. The value should be a comma-separated list of canonical encoding names. The list should include at least the fallback encoding, windows-1252 and UTF-8. For locales where there are multiple common legacy encodings, all those encodings should be included. For example, the fallback encoding for Japanese is Shift_JIS, but there are other legacy encodings: ISO-2022-JP and EUC-JP. Therefore, it makes sense for the list to be Shift_JIS, EUC-JP, ISO-2022-JP, windows-1252, UTF-8.</p> diff --git a/files/ru/orphaned/web/html/element/element/index.html b/files/ru/orphaned/web/html/element/element/index.html deleted file mode 100644 index aab57c9a94..0000000000 --- a/files/ru/orphaned/web/html/element/element/index.html +++ /dev/null @@ -1,113 +0,0 @@ ---- -title: <element> -slug: orphaned/Web/HTML/Element/element -translation_of: Web/HTML/Element/element -original_slug: Web/HTML/Element/element ---- -<p>{{obsolete_header}}</p> - -<div class="note"> -<p><strong>Примечание:</strong> Этот элемент удалён из спецификации. Смотри <a href="http://lists.w3.org/Archives/Public/public-webapps/2013JulSep/0287.html">здесь </a>больше дополнительной информации от редактора спецификации.</p> -</div> - -<h2 id="Summary" name="Summary">Краткая информация</h2> - -<p><strong>HTML <code><element></code> element</strong> <span id="result_box" lang="ru"><span>используется для определения новых пользовательских элементов DOM</span></span>.</p> - -<table class="properties"> - <tbody> - <tr> - <th scope="row"><a href="/en-US/docs/Web/HTML/Content_categories" title="HTML/Content_categories">Категория контента</a></th> - <td><a href="/en-US/docs/Web/HTML/Content_categories#Transparent_content">Прозрачный контент</a>.</td> - </tr> - <tr> - <th scope="row">Разрешённый контент</th> - <td>???</td> - </tr> - <tr> - <th scope="row">Недопустимые теги</th> - <td>{{no_tag_omission}}</td> - </tr> - <tr> - <th scope="row"><span class="short_text" id="result_box" lang="ru"><span>Разрешённые родительские элементы</span></span></th> - <td>???</td> - </tr> - <tr> - <th scope="row">DOM интерфейс</th> - <td>{{domxref("HTMLElement")}}</td> - </tr> - </tbody> -</table> - -<h2 id="Attributes" name="Attributes">Атрибуты</h2> - -<p>Этот элемент включает <a href="/en-US/docs/Web/HTML/Global_attributes">глобальные атрибуты</a>.</p> - -<h2 id="Examples" name="Examples">Примеры</h2> - -<p>Текст здесь.</p> - -<pre class="brush: html">Больше текста здесь. -</pre> - -<h2 id="Specifications" name="Specifications">Характеристики</h2> - -<p><code>Элемент <element></code> <span id="result_box" lang="ru"><span>ранее был в черновике спецификации</span></span> <a href="http://w3c.github.io/webcomponents/spec/custom/">Настраиваемых Элементов</a>, но был удалён.</p> - -<h2 id="Browser_compatibility" name="Browser_compatibility">Совместимость с браузером</h2> - -<p>{{CompatibilityTable}}</p> - -<div id="compat-desktop"> -<table class="compat-table"> - <tbody> - <tr> - <th>Feature</th> - <th>Chrome</th> - <th>Firefox (Gecko)</th> - <th>Internet Explorer</th> - <th>Opera</th> - <th>Safari (WebKit)</th> - </tr> - <tr> - <td>Базовая поддержка</td> - <td>{{CompatUnknown}}</td> - <td>{{CompatUnknown}}</td> - <td>{{CompatUnknown}}</td> - <td>{{CompatUnknown}}</td> - <td>{{CompatUnknown}}</td> - </tr> - </tbody> -</table> -</div> - -<div id="compat-mobile"> -<table class="compat-table"> - <tbody> - <tr> - <th>Feature</th> - <th>Android</th> - <th>Firefox Mobile (Gecko)</th> - <th>IE Phone</th> - <th>Opera Mobile</th> - <th>Safari Mobile</th> - </tr> - <tr> - <td>Базовая поддержка</td> - <td>{{CompatUnknown}}</td> - <td>{{CompatUnknown}}</td> - <td>{{CompatUnknown}}</td> - <td>{{CompatUnknown}}</td> - <td>{{CompatUnknown}}</td> - </tr> - </tbody> -</table> -</div> - -<h2 id="See_also" name="See_also">Смотрите также</h2> - -<ul> - <li>Web-компоненты: {{HTMLElement("content")}}, {{HTMLElement("shadow")}}, {{HTMLElement("template")}}</li> -</ul> - -<div>{{HTMLRef}}</div> diff --git a/files/ru/orphaned/web/html/global_attributes/dropzone/index.html b/files/ru/orphaned/web/html/global_attributes/dropzone/index.html deleted file mode 100644 index 354ff7e37f..0000000000 --- a/files/ru/orphaned/web/html/global_attributes/dropzone/index.html +++ /dev/null @@ -1,41 +0,0 @@ ---- -title: dropzone -slug: orphaned/Web/HTML/Global_attributes/dropzone -translation_of: Web/HTML/Global_attributes/dropzone -original_slug: Web/HTML/Global_attributes/dropzone ---- -<p>{{HTMLSidebar("Global_attributes")}}{{SeeCompatTable}}</p> - -<p><a href="/en-US/docs/Web/HTML/Global_attributes">Глобальный атрибут</a> <code>dropzone</code> является перечисляемым атрибутом, указывающем, какие типы содержимого могут быть опущены в элементе, используя {{domxref("HTML_Drag_and_Drop_API","HTML Drag and Drop API")}}. Может иметь следующие значения:</p> - -<ul> - <li><code>copy</code>, которая указывает что сброс создаёт копию перетаскиваемого элемента.</li> - <li><code>move</code>, которое указывает, что перетаскиваемы элемент будет перемещён в новое местоположение.</li> - <li><code>link</code>, которая создаёт ссылку на перетаскиваемые данные.</li> -</ul> - -<h2 id="Спецификации">Спецификации</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Спецификация</th> - <th scope="col">Статус</th> - <th scope="col">Комментарий</th> - </tr> - <tr> - <td>{{SpecName('HTML5.1', "editing.html#the-dropzone-attribute", "dropzone")}}</td> - <td>{{Spec2('HTML5.1')}}</td> - <td>Снимок {{SpecName('HTML WHATWG')}}, начальное определение</td> - </tr> - </tbody> -</table> - -<h2 id="Поддержка_браузерами">Поддержка браузерами</h2> -<p>{{Compat("html.global_attributes.dropzone")}}</p> - -<h2 id="Смотрите_также">Смотрите также</h2> - -<ul> - <li>Все <a href="/en-US/docs/Web/HTML/Global_attributes">глобальные атрибуты</a>.</li> -</ul> diff --git a/files/ru/orphaned/web/html/preloading_content/index.html b/files/ru/orphaned/web/html/preloading_content/index.html deleted file mode 100644 index b5acc487a6..0000000000 --- a/files/ru/orphaned/web/html/preloading_content/index.html +++ /dev/null @@ -1,241 +0,0 @@ ---- -title: Предзагрузчик контента - rel="preload" -slug: orphaned/Web/HTML/Preloading_content -translation_of: Web/HTML/Preloading_content -original_slug: Web/HTML/Preloading_content ---- -<p class="summary">Значение <code>preload</code> атрибута {{htmlattrxref("rel", "link")}} в элементе {{htmlelement("link")}} позволяет вам запросить данные через {{htmlelement("head")}} вашего HTML, указав необходимые вашей странице ресурсы ещё в начале её жизненного цикла, - до того, как сработает основной механизм отрисовки браузера. Это гарантирует, что предзагрузчик нужных ресурсов с меньшей вероятностью заблокирует отрисовку страницы, тем самым улучшая её производительность.</p> - -<p class="summary">В этой статье приведено основное руководство про работе с <code><link rel="preload"></code>.</p> - -<h2 id="Основы">Основы</h2> - -<p>Чаще всего вы используете простой <code><link></code> элемент, когда загружаете CSS файлы со стилем вашей страницы:</p> - -<pre class="brush: html notranslate"><link rel="stylesheet" href="styles/main.css"></pre> - -<p>Однако, здесь мы будем использовать значение <code>preload</code> для атрибута <code>rel</code>, которое превратит тег <code><link></code> в предзагрузчик для любого ресурса, который мы пожелаем. Для этого необходимо будет указать:</p> - -<ul> - <li>Адрес пути к ресурсу в атрибуте {{htmlattrxref("href", "link")}};</li> - <li>Тип ресурса в атрибуте {{htmlattrxref("as", "link")}}.</li> -</ul> - -<p>Простой пример может выглядеть так: (смотрите наш <a href="https://github.com/mdn/html-examples/tree/master/link-rel-preload/js-and-css">JS и CSS пример из источника</a>, и <a href="https://mdn.github.io/html-examples/link-rel-preload/js-and-css/">живой пример</a>):</p> - -<pre class="brush: html notranslate"><head> - <meta charset="utf-8"> - <title>Пример пред-загрузки JS и CSS</title> - - <link rel="preload" href="style.css" as="style"> - <link rel="preload" href="main.js" as="script"> - - <link rel="stylesheet" href="style.css"> -</head> - -<body> - <h1>прыгающие шарики</h1> - <canvas></canvas> - - <script src="main.js"></script> -</body></pre> - -<p>Мы сделали предзагрузку наших файлов CSS и JavaScript, чтобы они стали доступны для рендеринга страницы сразу же, как это потребуется. Этот пример отчасти банален, поскольку браузер, вероятнее всего, обнаружит элементы <code><link rel="stylesheet"></code> и <code><script></code> в одном чанке (блоке) с основным HTML, но преимущества более явно проявятся, если далее по странице будут обнаружены более объёмные ресурсы. Это могут быть:</p> - -<ul> - <li>Ресурсы, на которые ссылаются стили из CSS (шрифты, изображения);</li> - <li>Ресурсы, затребованные из JavaScript (например JSON, динамически подгружаемые скрипты, воркеры);</li> - <li>Огромных размеров изображения, видео.</li> -</ul> - -<p><code>preload</code> имеет и другие преимущества. Использование атрибута <code>as</code> для указания типа содержимого пред-загрузки позволит браузеру:</p> - -<ul> - <li>Точнее расставить приоритеты при загрузке ресурсов.</li> - <li>Сохранить в кеше затребованный ресурс для его повторного использования в случае необходимости.</li> - <li>Применять корректную <a href="/ru/docs/Web/HTTP/CSP">политику безопасности содержимого (content security policy)</a> для ресурсов.</li> - <li>Правильно устанавливать заголовки {{HTTPHeader("Accept")}} для выбранного запроса.</li> -</ul> - -<h3 id="Какие_типы_контента_могут_быть_предзагружены">Какие типы контента могут быть предзагружены?</h3> - -<p>Разного типа контент можно предзагрузить. Вот основные атрибуты значения <code>as</code>:</p> - -<ul> - <li><code>audio</code>: Аудио файлы.</li> - <li><code>document</code>: HTML документ для {{htmlelement("frame")}} или {{htmlelement("iframe")}}.</li> - <li><code>embed</code>: Ресурс, встроенный в {{htmlelement("embed")}} элемент.</li> - <li><code>fetch</code>: Ресурс с доступом к запросу выборки или XHR, подобие файлу ArrayBuffer или JSON.</li> - <li><code>font</code>: Шрифты.</li> - <li><code>image</code>: Картинки.</li> - <li><code>object</code>: Ресурс встроенный в {{htmlelement("object")}} элемент.</li> - <li><code>script</code>: JavaScript.</li> - <li><code>style</code>: CSS таблица стилей.</li> - <li><code>track</code>: WebVTT.</li> - <li><code>worker</code>: A JavaScript веб-worker и общий worker.</li> - <li><code>video</code>: Видео.</li> -</ul> - -<div class="note"> -<p><strong>Примечание</strong>: вы можете прочитать немного больше об этих значениях и веб-функциях, которыми они будут пользоваться, в спецификации Предзагрузка — <a href="https://w3c.github.io/preload/#link-element-extensions">расширения элементов ссылок</a>. Также обратите внимание, что полный список значений атрибут <code>as</code> может принимать в зависимости от определений в спецификации Fetch — <a href="https://fetch.spec.whatwg.org/#concept-request-destination">запрос направления</a>.</p> -</div> - -<h2 id="Включение_MIME-типов">Включение MIME-типов</h2> - -<p>Элементы <code><link></code> могут принимать атрибут {{htmlattrxref("type", "link")}}, содержащий MIME-тип ресурса целевого элемента. Это особенно полезно при пред-загрузке ресурсов. Браузер использует значение атрибута <code>type</code> и начнёт его загрузку, если поддержка ресурса определена, иначе проигнорирует его.</p> - -<p>См. <a href="https://github.com/mdn/html-examples/tree/master/link-rel-preload/video">полный исходный код</a>, (а также <a href="https://mdn.github.io/html-examples/link-rel-preload/video/">пример живой версии видео</a>).</p> - -<pre class="brush: html notranslate"><head> - <meta charset="utf-8"> - <title>Пример пред-загрузки видео</title> - - <link rel="preload" href="sintel-short.mp4" as="video" type="video/mp4"> -</head> -<body> - <video controls> - <source src="sintel-short.mp4" type="video/mp4"> - <source src="sintel-short.webm" type="video/webm"> - <p> Ваш браузер не поддерживает видео в формате HTML5. - Взамен - <a href="sintel-short.mp4"> ссылка на видео </a>.</p> - </video> -</body></pre> - -<p>В этом случае браузеры, поддерживающие MP4, будут пред-загружать и использовать MP4, что, как мы надеемся, сделает видеоплеер плавное/отзывчивее для пользователей. Браузеры, не поддерживающие MP4, могут загружать версию WebM, при этом не получая преимуществ пред-загрузки. Это показывает, как пред-загрузка контента может сочетаться с философией прогрессивного улучшения.</p> - -<h2 id="Выборки_из_разных_источников">Выборки из разных источников</h2> - -<p>Если настройки CORS ваших сайтов правильные, вы можете успешно пред-загрузить ресурсы разных источников, установив атрибут {{htmlattrxref("crossorigin", "link")}} в элементе <code><link></code>.</p> - -<p>Один из интересных случаев, когда это применимо, даже если выборка не из разных источников, - это файлы шрифтов. По разным причинам они должны быть получены с использованием анонимного режима CORS (см. <a href="https://drafts.csswg.org/css-fonts/#font-fetching-requirements">Требования к выборке шрифтов</a>, если вас заинтересуют все подробности).</p> - -<p>Используем этот случай в качестве примера, во-первых, загрузка шрифтов - действительно хороший вариант использования пред-загрузки, а во-вторых, - это проще, чем настраивать пример запроса с перекрёстным источником. Полный пример исходного кода <a href="https://github.com/mdn/html-examples/tree/master/link-rel-preload/fonts">есть на GitHub</a> (<a href="https://mdn.github.io/html-examples/link-rel-preload/fonts/">также смотрите его вживую</a>):</p> - -<pre class="brush: html notranslate"><head> - <meta charset="utf-8"> - <title>Примеры веб-шрифтов</title> - - <link rel="preload" href="fonts/cicle_fina-webfont.eot" as="font" type="application/vnd.ms-fontobject" crossorigin="anonymous"> - <link rel="preload" href="fonts/cicle_fina-webfont.woff2" as="font" type="font/woff2" crossorigin="anonymous"> - <link rel="preload" href="fonts/cicle_fina-webfont.woff" as="font" type="font/woff" crossorigin="anonymous"> - <link rel="preload" href="fonts/cicle_fina-webfont.ttf" as="font" type="font/ttf" crossorigin="anonymous"> - <link rel="preload" href="fonts/cicle_fina-webfont.svg" as="font" type="image/svg+xml" crossorigin="anonymous"> - - <link rel="preload" href="fonts/zantroke-webfont.eot" as="font" type="application/vnd.ms-fontobject" crossorigin="anonymous"> - <link rel="preload" href="fonts/zantroke-webfont.woff2" as="font" type="font/woff2" crossorigin="anonymous"> - <link rel="preload" href="fonts/zantroke-webfont.woff" as="font" type="font/woff" crossorigin="anonymous"> - <link rel="preload" href="fonts/zantroke-webfont.ttf" as="font" type="font/ttf" crossorigin="anonymous"> - <link rel="preload" href="fonts/zantroke-webfont.svg" as="font" type="image/svg+xml" crossorigin="anonymous"> - - <link href="style.css" rel="stylesheet" type="text/css"> -</head> -<body> - ... -</body></pre> - -<p>Легко узреть, что мы не только предоставляем подсказки типа MIME в атрибутах типа, но также предоставляем атрибут <code>crossorigin</code> для решения проблемы CORS.</p> - -<h2 id="Including_media">Including media</h2> - -<p>One nice feature of <code><link></code> elements is their ability to accept {{htmlattrxref("media", "link")}} attributes. These can accept <a href="/en-US/docs/Web/CSS/@media#Media_types">media types</a> or full-blown <a href="/en-US/docs/Web/CSS/Media_Queries/Using_media_queries">media queries</a>, allowing you to do responsive preloading!</p> - -<p>Давайте посмотрим на очень простой пример (см. его на GitHub - <a href="https://github.com/mdn/html-examples/tree/master/link-rel-preload/media">исходный код</a> и <a href="https://mdn.github.io/html-examples/link-rel-preload/media/">живой пример</a>):</p> - -<pre class="brush: html notranslate"><head> - <meta charset="utf-8"> - <title>Пример адаптивной предзагрузки</title> - - <link rel="preload" href="bg-image-narrow.png" as="image" media="(max-width: 600px)"> - <link rel="preload" href="bg-image-wide.png" as="image" media="(min-width: 601px)"> - - <link rel="stylesheet" href="main.css"> -</head> -<body> - <header> - <h1>Мой сайт</h1> - </header> - - <script> - var mediaQueryList = window.matchMedia("(max-width: 600px)"); - var header = document.querySelector('header'); - - if(mediaQueryList.matches) { - header.style.backgroundImage = 'url(bg-image-narrow.png)'; - } else { - header.style.backgroundImage = 'url(bg-image-wide.png)'; - } - </script> -</body></pre> - -<p>Вы видите, что мы включаем <code>media</code>-атрибуты в наши элементы <code><link></code> так, чтобы узкое изображение пред-загружалось на устройство пользователя с узким экраном, а более широкое - на устройство с более широким экраном. Чтобы изображение к заголовку было в зависимости от результата - мы используем {{domxref("Window.matchMedia")}} / {{domxref("MediaQueryList")}} (подробности см. в разделе <a href="/en-US/docs/Web/CSS/Media_Queries/Testing_media_queries">Тест медиавыражений</a>).</p> - -<p>Это увеличивает вероятность того, что шрифт будет доступен к моменту завершения рендеринга страницы, что сокращает количество проблем с FOUT (вспышка нестилизованного текста).</p> - -<p>Обратите внимание, что это не должно ограничиваться изображениями или даже файлами одного типа - думайте масштабно! Возможно, вы могли бы предварительно загрузить, а затем отобразить простую диаграмму SVG, если пользователь находится на узком экране, где пропускная способность и ЦП потенциально более ограничены, или предзагрузить сложный фрагмент JavaScript, а затем использовать его для рендеринга интерактивной 3D-модели, если ресурсы пользователя более многочисленны.</p> - -<h2 id="Скрипты_и_предзагрузки">Скрипты и предзагрузки</h2> - -<p>Ещё одна полезная вещь в этих предзагрузках, это то, что вы можете выполнять их полностью со скриптами, если необходимо. Например, мы сейчас создаём экземпляр {{domxref("HTMLLinkElement")}}, затем включим её в DOM:</p> - -<pre class="brush: js notranslate"><code class="language-javascript"><span class="keyword token">var</span> preloadLink <span class="operator token">=</span> document<span class="punctuation token">.</span><span class="function token">createElement</span><span class="punctuation token">(</span><span class="string token">"link"</span><span class="punctuation token">)</span><span class="punctuation token">;</span> -preloadLink<span class="punctuation token">.</span>href <span class="operator token">=</span> <span class="string token">"myscript.js"</span><span class="punctuation token">;</span> -preloadLink<span class="punctuation token">.</span>rel <span class="operator token">=</span> <span class="string token">"preload"</span><span class="punctuation token">;</span> -preloadLink<span class="punctuation token">.</span><span class="keyword token">as</span> <span class="operator token">=</span> <span class="string token">"script"</span><span class="punctuation token">;</span> -document<span class="punctuation token">.</span>head<span class="punctuation token">.</span><span class="function token">appendChild</span><span class="punctuation token">(</span>preloadLink<span class="punctuation token">)</span><span class="punctuation token">;</span> -</code></pre> - -<p>Подразумевается, что браузер загрузит JavaScript файл, но, пока не будет его применять.</p> - -<p>Чтобы выполнить его, вы можете использовать следующую конструкцию:</p> - -<pre class="brush: js notranslate"><code class="language-javascript"><span class="keyword token">var</span> preloadedScript <span class="operator token">=</span> document<span class="punctuation token">.</span><span class="function token">createElement</span><span class="punctuation token">(</span><span class="string token">"script"</span><span class="punctuation token">)</span><span class="punctuation token">;</span> -preloadedScript<span class="punctuation token">.</span>src <span class="operator token">=</span> <span class="string token">"myscript.js"</span><span class="punctuation token">;</span> -document<span class="punctuation token">.</span>body<span class="punctuation token">.</span><span class="function token">appendChild</span><span class="punctuation token">(</span>preloadedScript<span class="punctuation token">)</span><span class="punctuation token">;</span> -</code></pre> - -<p>Это полезно, когда вы хотите загрузить скрипт в кеш, но применять его только тогда, когда это необходимо.</p> - -<h2 id="Другие_механизмы_предзагрузки_ресурсов">Другие механизмы предзагрузки ресурсов</h2> - -<p>Существуют и другие функции предварительной загрузки, но ни одна из них не подходит так, как <code><link rel="preload"></code>:</p> - -<ul> - <li><code><link rel="prefetch"></code> давно поддерживается в браузерах, но предназначен для предварительной загрузки ресурсов, которые будут использоваться при следующей навигации/загрузке страницы (например, когда вы переходите на следующую страницу). Это нормально, но бесполезно для текущей страницы! Кроме того, браузеры будут отдавать ресурсам предварительной загрузки более низкий приоритет, чем ресурсам <code>предзагрузки</code> - текущая страница важнее следующей. См. <a href="/en-US/docs/Web/HTTP/Link_prefetching_FAQ">Предвыборку ссылок FAQ</a> для подробностей.</li> - <li><code><link rel = "subresource"></code> некоторое время назад поддерживался в Chrome и предназначался для решения проблемы предзагрузки ресурсов для текущей навигации/загрузки страницы, но у него была проблема - не было возможности определить приоритет для получения элементов. (<code>as</code> тогда не существовало), поэтому все они в конечном итоге были извлечены с довольно низким приоритетом, что не помогло ситуации.</li> - <li>Существует ряд загрузчиков ресурсов на основе сценариев, но они не имеют никакой власти над очередью приоритетов выборки браузера и подвержены тем же проблемам с производительностью.</li> -</ul> - -<h2 id="Specifications" name="Specifications">Характеристики</h2> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Specification</th> - <th scope="col">Status</th> - <th scope="col">Comment</th> - </tr> - </thead> - <tbody> - <tr> - <td>{{SpecName('Preload','#x2.link-type-preload','preload')}}</td> - <td>{{Spec2('Preload')}}</td> - <td>Further details of <code>preload</code>.</td> - </tr> - <tr> - <td>{{SpecName('HTML WHATWG', 'link-type-preload', 'rel=preload')}}</td> - <td>{{Spec2('HTML WHATWG')}}</td> - <td>Definition of <code>rel=preload</code>.</td> - </tr> - </tbody> -</table> - -<h2 id="Совместимость_с_браузером">Совместимость с браузером</h2> -<p>{{Compat("html.elements.link.rel.preload")}}</p> - -<h2 id="Смотрите_также">Смотрите также</h2> - -<ul> - <li><a href="https://www.smashingmagazine.com/2016/02/preload-what-is-it-good-for/">Preload: What Is It Good For?</a> by Yoav Weiss</li> -</ul> - -<p>{{QuickLinksWithSubpages("/en-US/docs/Web/HTML")}}</p> diff --git a/files/ru/orphaned/web/javascript/guide/об_этом_руководстве/index.html b/files/ru/orphaned/web/javascript/guide/об_этом_руководстве/index.html deleted file mode 100644 index 68ff635c0b..0000000000 --- a/files/ru/orphaned/web/javascript/guide/об_этом_руководстве/index.html +++ /dev/null @@ -1,69 +0,0 @@ ---- -title: Об этом руководстве -slug: orphaned/Web/JavaScript/Guide/Об_этом_руководстве -original_slug: Web/JavaScript/Guide/Об_этом_руководстве ---- -<p> </p> -<p><span id="result_box" lang="ru"><span class="hps">JavaScript</span> <span class="hps">является</span> <span class="hps">кросс-платформенным,</span> <span class="hps">объектно-ориентированный</span> <span class="hps">язык сценариев.</span> <span class="hps">Это руководство</span> <span class="hps">объясняет</span> <span class="hps">все, что нужно</span> <span class="hps">знать об использовании</span> <span class="hps">JavaScript.</span></span></p> -<h2 id="Новые_возможности_в_версиях_JavaScript"><span class="short_text" id="result_box" lang="ru"><span class="hps">Новые возможности в</span> <span class="hps">версиях</span> <span class="hps">JavaScript</span></span></h2> -<pre class="script" style="font-size: 16px;">/* Note: To add a link to new JavaScript version description -add version number to versionList variable below. The page linked to -must reside in /en/JavaScript/New_in_JavaScript/N, where N is version number. */ - -var versionList = ["1.5", "1.6", "1.7", "1.8", "1.8.1", "1.8.5"]; -var s = ""; -<ul> - foreach (var i in versionList){ - let s = "/en/JavaScript/New_in_JavaScript/" .. i; - <li>web.link(s, wiki.getPage(s).title)</li>; - } -</ul>; -</pre> -<h2 id="То_что_вы_должны_уже_знать"><span class="short_text" id="result_box" lang="ru"><span class="hps">То, что вы</span> <span class="hps">должны уже знать</span></span></h2> -<p>This guide assumes you have the following basic background:</p> -<ul> <li><span id="result_box" lang="ru"><span>Общее представление о</span> <span class="hps">сети Интернет и</span> <span class="hps atn">World Wide Web (</span><span>WWW).</span></span></li> <li><span id="result_box" lang="ru"><span class="hps">Хорошие</span> <span class="hps">знания</span> <span class="hps">языка</span> <span class="hps">гипертекстовой разметки</span> <span class="hps">(HTML).</span></span></li> -</ul> -<p><span id="result_box" lang="ru"><span class="hps">Некоторый опыт программирования</span> <span class="hps">на языках</span><span>, таких как</span> <span class="hps">C</span> <span class="hps">или</span> <span class="hps">Visual Basic,</span> <span class="hps">полезен,</span> <span class="hps">но не обязателен.</span></span></p> -<h2 id="Версии_JavaScript">Версии JavaScript</h2> -<table class="standard-table"> <caption>Таблица №1 версии JavaScript и веб-браузера Navigator</caption> <thead> <tr> <th scope="col">JavaScript version</th> <th scope="col">Navigator version</th> </tr> </thead> <tbody> <tr> <td>JavaScript 1.0</td> <td>Navigator 2.0</td> </tr> <tr> <td>JavaScript 1.1</td> <td>Navigator 3.0</td> </tr> <tr> <td>JavaScript 1.2</td> <td>Navigator 4.0-4.05</td> </tr> <tr> <td>JavaScript 1.3</td> <td>Navigator 4.06-4.7x</td> </tr> <tr> <td>JavaScript 1.4</td> <td> </td> </tr> <tr> <td>JavaScript 1.5</td> <td>Navigator 6.0<br> <span class="short_text" id="result_box" lang="ru"><span class="hps atn">Mozilla (</span><span>браузер с открытым</span> <span class="hps">исходным кодом)</span></span></td> </tr> <tr> <td>JavaScript 1.6</td> <td><a href="/en/Firefox_1.5_for_developers" title="en/Firefox_1.5_for_developers">Firefox 1.5</a>, other Mozilla 1.8-based products</td> </tr> <tr> <td>JavaScript 1.7</td> <td><a href="/en/Firefox_2_for_developers" title="en/Firefox_2_for_developers">Firefox 2</a>, other Mozilla 1.8.1-based products</td> </tr> <tr> <td>JavaScript 1.8</td> <td><a href="/en/Firefox_3_for_developers" title="en/Firefox_3_for_developers">Firefox 3</a>, other Gecko 1.9-based products</td> </tr> </tbody> -</table> -<p> </p> -<div class="almost_half_cell" id="gt-res-content"> <div dir="ltr" style="zoom: 1;"><span id="result_box" lang="ru"><span class="hps">Каждая версия</span> <span class="hps">Netscape</span> <span class="hps">Enterprise Server,</span> <span class="hps">также поддерживает</span> <span class="hps">различные версии</span> <span class="hps">JavaScript.</span> <span class="hps">Чтобы помочь вам</span> <span class="hps">писать сценарии</span><span>, которые совместимы</span> <span class="hps">с несколькими версиями</span> <span class="hps">Enterprise Server</span><span>, это руководство</span> <span class="hps">использует</span> <span class="hps">аббревиатуру</span> <span class="hps">для обозначения</span> <span class="hps">версии сервера</span><span>, в котором каждая</span> <span class="hps">функция была реализована</span><span>.</span></span></div> -</div> -<table class="standard-table"> <caption>Таблица №2 Аббревиатуры в версиях Netscape Enterprise Server</caption> <thead> <tr> <th scope="col">Аббревиатура</th> <th scope="col">Версия Server Enterprise</th> </tr> </thead> <tbody> <tr> <td>NES 2.0</td> <td>Netscape Enterprise Server 2.0</td> </tr> <tr> <td>NES 3.0</td> <td>Netscape Enterprise Server 3.0</td> </tr> </tbody> -</table> -<h2 id="Где_найти_информацию_о_JavaScript">Где найти информацию о JavaScript</h2> -<p><span id="result_box" lang="ru"><span class="hps">JavaScript</span> <span class="hps">документация включает в себя</span> <span class="hps">следующие книги:</span></span></p> -<ul> <li><a href="/en/JavaScript/Guide" title="en/Core_JavaScript_1.5_Guide">JavaScript Guide</a> <span id="result_box" lang="ru"><span class="hps atn">(</span><span>это руководство</span><span>) предоставляет информацию о</span> <span class="hps">языке</span> <span class="hps">JavaScript</span> <span class="hps">и его объектах.</span></span></li> <li><a href="/en/JavaScript/Reference" title="en/JavaScript/Reference">JavaScript Reference</a> <span class="short_text" id="result_box" lang="ru"><span class="hps">содержит справочный материал о</span> <span class="hps">языке</span> <span class="hps">JavaScript.</span></span></li> -</ul> -<p><span id="result_box" lang="ru"><span class="hps">Если</span> <span class="hps">вы новичок в</span> <span class="hps">JavaScript</span><span>, начните с</span></span> <a href="/en/JavaScript/Guide" title="en/Core_JavaScript_1.5_Guide"><span id="result_box" lang="ru"><span class="hps">руководства</span> <span class="hps">JavaScript.</span></span></a> <span id="result_box" lang="ru"><span class="hps">Если у вас есть</span> <span class="hps">твёрдое понимание</span> <span class="hps">основы</span><span>, вы можете использовать</span></span> <a href="/en/JavaScript/Reference" title="en/JavaScript/Reference">Справочник по JavaScript</a> <span id="result_box" lang="ru"><span>чтобы получить</span> <span class="hps">более подробную информацию</span> <span class="hps">на отдельных</span> <span class="hps">объектах и операторах.</span></span></p> -<h2 id="Советы_для_изучения_JavaScript"><span class="short_text" id="result_box" lang="ru"><span class="hps">Советы</span> <span class="hps">для изучения</span> <span class="hps">JavaScript</span></span></h2> -<p><span id="result_box" lang="ru"><span class="hps">Начало работы с</span> <span class="hps">JavaScript</span> <span class="hps">очень просто:</span> <span class="hps">все, что вам</span> <span class="hps">нужно, это</span> <span class="hps">современный</span> <span class="hps">веб-браузер.</span> <span class="hps">Это руководство</span> <span class="hps">включает в себя некоторые</span> <span class="hps">функции</span> <span class="hps">JavaScript</span><span>, которые только</span> <span class="hps">в настоящее время</span> <span class="hps">доступна в последней</span> <span class="hps">версии</span> <span class="hps atn">Firefox (</span><span>и других</span> браузеров с движком Gecko<span class="hps">)</span><span>, поэтому </span></span><span id="result_box" lang="ru"><span class="hps">рекомендуется</span></span><span id="result_box" lang="ru"><span> использование</span> <span class="hps">самых</span> <span class="hps">последних версий</span> <span class="hps">Firefox</span><span class="hps">.</span></span></p> -<h3 id="Интерактивный_интерпретатор"><span class="short_text" id="result_box" lang="ru"><span>Интерактивный интерпретатор</span></span></h3> -<p>Диалоговый JavaScript незамедлительно - неоценимая помощь изучению языка, так как это предоставляет вам возможность пробовать вещи в интерактивном режиме без необходимости сохранить файл и обновить страницу. Ошибочная Консоль Firefox, доступная через меню Инструменты, обеспечивает простой путь пробовать диалоговый JavaScript: Только вводят линию кода и щёлкают кнопку "Evaluate".</p> -<p><img alt="Image:ErrorConsole.png" class="internal" src="/@api/deki/files/192/=ErrorConsole.png"></p> -<h3 id="Firebug">Firebug</h3> -<p>Более передовой диалоговый незамедлительно - доступный использующий <a class="external" href="http://www.getfirebug.com/">Firebug</a>, дополнение к Firefox. Выражения, которые вы печатаете, интерпретируются как объекты <span id="result_box" lang="ru"><span class="hps">и</span> <span class="hps">связанные с</span> <span class="hps">другими частями</span> <span class="hps">Firebug.</span></span> <span id="result_box" lang="ru"><span class="hps">Например, вы</span> <span class="hps">можете добавить</span> <span class="hps">5 плюс</span> <span class="hps">5,</span> <span class="hps">изменять регистр</span> <span class="hps">строки</span><span>,</span></span> get a clickable link to the document, or get a link to an element:</p> -<p><img alt="" class="internal" src="/@api/deki/files/5188/=FirebugCommandLine.PNG" style="width: 728px; height: 281px;"></p> -<p><span id="result_box" lang="ru"><span class="hps">Использование</span> <span class="hps">стрелки на</span> <span class="hps">правом нижнем углу</span> <span class="hps">даёт</span> <span class="hps">команду</span> <span class="hps">редактор для</span> <span class="hps">многострочного</span> <span class="hps">сценариев.</span></span></p> -<p>Firebug also provides an advanced DOM inspector, a JavaScript debugger, a profiling tool and various other utilities. JavaScript code running in a Web page can call, <code>console.log()</code>, a function that prints its arguments to the Firebug console.</p> -<p>Many of the examples in this guide use <code>alert()</code> to show messages as they execute. If you have Firebug installed you can use <code>console.log()</code> in place of <code>alert()</code> when running these examples.</p> -<h2 id="Document_conventions">Document conventions</h2> -<p>JavaScript applications run on many operating systems; the information in this book applies to all versions. File and directory paths are given in Windows format (with backslashes separating directory names). For Unix versions, the directory paths are the same, except that you use slashes instead of backslashes to separate directories.</p> -<p>This guide uses uniform resource locators (URLs) of the following form:</p> -<p><code>http://<em>server</em>.<em>domain</em>/<em>path</em>/<em>file</em>.html</code></p> -<p>In these URLs, <em>server</em> represents the name of the server on which you run your application, such as <code>research1</code> or <code>www</code>; <em>domain</em> represents your Internet domain name, such as <code>netscape.com</code> or <code>uiuc.edu</code>; <em>path</em> represents the directory structure on the server; and <em>file</em><code>.html</code> represents an individual file name. In general, items in italics in URLs are placeholders and items in normal monospace font are literals. If your server has Secure Sockets Layer (SSL) enabled, you would use <code>https</code> instead of <code>http</code> in the URL.</p> -<p>This guide uses the following font conventions:</p> -<ul> <li><code>The monospace font</code> is used for sample code and code listings, API and language elements (such as method names and property names), file names, path names, directory names, HTML tags, and any text that must be typed on the screen. (<code><em>Monospace italic font</em></code> is used for placeholders embedded in code.)</li> <li><em>Italic type</em> is used for book titles, emphasis, variables and placeholders, and words used in the literal sense.</li> <li><strong>Boldface</strong> type is used for glossary terms.</li> -</ul> -<pre class="script" style="font-size: 16px;">autoPreviousNext("JSGChapters"); -wiki.languages({ - "zh-tw": "zh_tw/Core_JavaScript_1.5_教學/關於", - "es": "es/Gu\u00eda_JavaScript_1.5/Acerca_de_esta_gu\u00eda", - "fr": "fr/Guide_JavaScript_1.5/\u00c0_propos", - "ja": "ja/Core_JavaScript_1.5_Guide/About", - "ko": "ko/Core_JavaScript_1.5_Guide/About", - "pl": "pl/Przewodnik_po_j\u0119zyku_JavaScript_1.5/O_tym_przewodniku", - "zh-cn": "cn/Core_JavaScript_1.5_Guide/\u5173\u4e8e" -}) -</pre> diff --git a/files/ru/orphaned/web/javascript/reference/errors/typed_array_invalid_arguments/index.html b/files/ru/orphaned/web/javascript/reference/errors/typed_array_invalid_arguments/index.html deleted file mode 100644 index ab6bcf3748..0000000000 --- a/files/ru/orphaned/web/javascript/reference/errors/typed_array_invalid_arguments/index.html +++ /dev/null @@ -1,79 +0,0 @@ ---- -title: 'TypeError: invalid arguments' -slug: orphaned/Web/JavaScript/Reference/Errors/Typed_array_invalid_arguments -tags: - - Error - - Errors - - JavaScript - - TypeError - - Ошибки -translation_of: Web/JavaScript/Reference/Errors/Typed_array_invalid_arguments -original_slug: Web/JavaScript/Reference/Errors/Typed_array_invalid_arguments ---- -<div>{{jsSidebar("Errors")}}</div> - -<h2 id="Сообщение">Сообщение</h2> - -<pre class="syntaxbox">TypeError: invalid arguments (Firefox)</pre> - -<h2 id="Тип_ошибки">Тип ошибки</h2> - -<p>{{jsxref("TypeError")}}</p> - -<h2 id="Что_не_так">Что не так?</h2> - -<p>Конструкторы <a href="/ru/docs/Web/JavaScript/Typed_arrays">типизированных массивов</a> требуют либо</p> - -<ul> - <li>длину,</li> - <li>другой типизированный массив,</li> - <li>массивоподобные объекты,</li> - <li>итерируемые объекты либо</li> - <li>объект {{jsxref("ArrayBuffer")}}</li> -</ul> - -<p>чтобы создать новый типизированный массив. Другие аргументы конструктора не создают допустимый типизированный массив.</p> - -<h2 id="Примеры">Примеры</h2> - -<p>Типизированные массивы, например {{jsxref("Uint8Array")}}, не могут быть построены из строки. На самом деле строки вообще не могут быть в типизированных массивах.</p> - -<pre class="brush: js example-bad">var ta = new Uint8Array("nope"); -// TypeError: invalid arguments -</pre> - -<p>Различные способы создания допустимого {{jsxref("Uint8Array")}}:</p> - -<pre class="brush: js example-good"> // From a length -var uint8 = new Uint8Array(2); -uint8[0] = 42; -console.log(uint8[0]); // 42 -console.log(uint8.length); // 2 -console.log(uint8.BYTES_PER_ELEMENT); // 1 - -// From an array -var arr = new Uint8Array([21,31]); -console.log(arr[1]); // 31 - -// From another TypedArray -var x = new Uint8Array([21, 31]); -var y = new Uint8Array(x); -console.log(y[0]); // 21 - -// From an ArrayBuffer -var buffer = new ArrayBuffer(8); -var z = new Uint8Array(buffer, 1, 4); - -// From an iterable -var iterable = function*(){ yield* [1,2,3]; }(); -var uint8 = new Uint8Array(iterable); -// Uint8Array[1, 2, 3] -</pre> - -<h2 id="Смотрите_также">Смотрите также</h2> - -<ul> - <li><a href="/ru/docs/Web/JavaScript/Typed_arrays">Типизированные массивы</a></li> - <li>{{jsxref("ArrayBuffer")}}</li> - <li>{{jsxref("Uint8Array")}}</li> -</ul> diff --git a/files/ru/orphaned/web/javascript/reference/global_objects/array/prototype/index.html b/files/ru/orphaned/web/javascript/reference/global_objects/array/prototype/index.html deleted file mode 100644 index 01e209e17e..0000000000 --- a/files/ru/orphaned/web/javascript/reference/global_objects/array/prototype/index.html +++ /dev/null @@ -1,168 +0,0 @@ ---- -title: Array.prototype -slug: orphaned/Web/JavaScript/Reference/Global_Objects/Array/prototype -tags: - - Array - - JavaScript - - Property - - Reference -translation_of: Web/JavaScript/Reference/Global_Objects/Array/prototype -original_slug: Web/JavaScript/Reference/Global_Objects/Array/prototype ---- -<div>{{JSRef("Global_Objects", "Array")}}</div> - -<h2 id="Summary" name="Summary">Сводка</h2> - -<p>Свойство <strong><code>Array.prototype</code></strong> представляет прототип для конструктора {{jsxref("Global_Objects/Array", "Array", "массива")}}.</p> - -<div>{{js_property_attributes(0, 0, 0)}}</div> - -<h2 id="Description" name="Description">Описание</h2> - -<p>Экземпляры <span class="internal"><code>Array</code></span> наследуются от <code>Array.prototype</code>. Как и с остальными конструкторами, вы можете изменять прототип конструктора объекта для применения изменений ко всем экземплярам класса <code>Array</code>.</p> - -<p>Небольшой факт: <code>Array.prototype</code> сам является экземпляром <code>Array</code>:</p> - -<pre class="brush: js">Array.isArray(Array.prototype); // true</pre> - -<h2 id="Properties" name="Properties">Свойства</h2> - -<dl> - <dt><code>Array.prototype.constructor</code></dt> - <dd>Определяет функцию, создающую прототип объекта.</dd> - <dt>{{jsxref("Array.prototype.length")}}</dt> - <dd>Отражает количество элементов в массиве.</dd> -</dl> - -<h2 id="Methods" name="Methods">Методы</h2> - -<h3 id="Mutator_methods" name="Mutator_methods">Методы изменения</h3> - -<p>Эти методы изменяют массив:</p> - -<dl> - <dt>{{jsxref("Array.prototype.copyWithin()")}} {{experimental_inline}}</dt> - <dd>Копирует последовательность элементов массива внутри массива.</dd> - <dt>{{jsxref("Array.prototype.fill()")}} {{experimental_inline}}</dt> - <dd>Заполняет все элементы массива от начального индекса до конечного индекса указанным значением.</dd> - <dt>{{jsxref("Array.prototype.pop()")}}</dt> - <dd>Удаляет последний элемент из массива и возвращает его.</dd> - <dt>{{jsxref("Array.prototype.push()")}}</dt> - <dd>Добавляет один или более элементов в конец массива и возвращает новую длину массива.</dd> - <dt>{{jsxref("Array.prototype.reverse()")}}</dt> - <dd>Переворачивает порядок элементов в массиве — первый элемент становится последним, а последний — первым.</dd> - <dt>{{jsxref("Array.prototype.shift()")}}</dt> - <dd>Удаляет первый элемент из массива и возвращает его.</dd> - <dt>{{jsxref("Array.prototype.sort()")}}</dt> - <dd>Сортирует элементы массива на месте и возвращает отсортированный массив.</dd> - <dt>{{jsxref("Array.prototype.splice()")}}</dt> - <dd>Добавляет и/или удаляет элементы из массива.</dd> - <dt>{{jsxref("Array.prototype.unshift()")}}</dt> - <dd>Добавляет один или более элементов в начало массива и возвращает новую длину массива.</dd> -</dl> - -<h3 id="Accessor_methods" name="Accessor_methods">Методы доступа</h3> - -<p>Эти методы не изменяют массив, а просто возвращают его в ином представлении.</p> - -<dl> - <dt>{{jsxref("Array.prototype.concat()")}}</dt> - <dd>Возвращает новый массив, состоящий из данного массива, соединённого с другим массивом и/или значением (списком массивов/значений).</dd> - <dt>{{jsxref("Array.prototype.includes()")}} {{experimental_inline}}</dt> - <dd>Определяет, содержится ли в массиве указанный элемент, возвращая, соответственно, <code>true</code> или <code>false</code>.</dd> - <dt>{{jsxref("Array.prototype.join()")}}</dt> - <dd>Объединяет все элементы массива в строку.</dd> - <dt>{{jsxref("Array.prototype.slice()")}}</dt> - <dd>Извлекает диапазон значений и возвращает его в виде нового массива.</dd> - <dt>{{jsxref("Array.prototype.toSource()")}} {{non-standard_inline}}</dt> - <dd>Возвращает литеральное представление указанного массива; вы можете использовать это значение для создания нового массива. Переопределяет метод {{jsxref("Object.prototype.toSource()")}}.</dd> - <dt>{{jsxref("Array.prototype.toString()")}}</dt> - <dd>Возвращает строковое представление массива и его элементов. Переопределяет метод {{jsxref("Object.prototype.toString()")}}.</dd> - <dt>{{jsxref("Array.prototype.toLocaleString()")}}</dt> - <dd>Возвращает локализованное строковое представление массива и его элементов. Переопределяет метод {{jsxref("Object.prototype.toLocaleString()")}}.</dd> - <dt>{{jsxref("Array.prototype.indexOf()")}}</dt> - <dd>Возвращает первый (наименьший) индекс элемента внутри массива, равный указанному значению; или -1, если значение не найдено.</dd> - <dt>{{jsxref("Array.prototype.lastIndexOf()")}}</dt> - <dd>Возвращает последний (наибольший) индекс элемента внутри массива, равный указанному значению; или -1, если значение не найдено.</dd> -</dl> - -<h3 id="Iteration_methods" name="Iteration_methods">Методы обхода</h3> - -<p>Некоторые методы принимают в качестве аргументов функции, вызываемые при обработке массива. Когда вызываются эти методы, достаётся длина массива, и любой элемент, добавленный свыше этой длины изнутри колбэк-функции не посещается. Другие изменения в массиве (установка значения или удаление элемента) могут повлиять на результаты операции, если изменённый элемент метод посещает после изменения. Хотя специфическое поведение этих методов в таких случаях хорошо определено, вы не должны на него полагаться, чтобы не запутывать других людей, читающих ваш код. Если вам нужно изменить массив, лучше вместо этого скопируйте его в новый массив.</p> - -<dl> - <dt>{{jsxref("Array.prototype.forEach()")}}</dt> - <dd>Вызывает функцию для каждого элемента в массиве.</dd> - <dt>{{jsxref("Array.prototype.entries()")}} {{experimental_inline}}</dt> - <dd>Возвращает новый объект итератора массива <code>Array Iterator</code>, содержащий пары ключ / значение для каждого индекса в массиве.</dd> - <dt>{{jsxref("Array.prototype.every()")}}</dt> - <dd>Возвращает <code>true</code>, если каждый элемент в массиве удовлетворяет условию проверяющей функции.</dd> - <dt>{{jsxref("Array.prototype.some()")}}</dt> - <dd>Возвращает <code>true</code>, если хотя бы один элемент в массиве удовлетворяет условию проверяющей функции.</dd> - <dt>{{jsxref("Array.prototype.filter()")}}</dt> - <dd>Создаёт новый массив со всеми элементами этого массива, для которых функция фильтрации возвращает <code>true</code>.</dd> - <dt>{{jsxref("Array.prototype.find()")}} {{experimental_inline}}</dt> - <dd>Возвращает искомое значение в массиве, если элемент в массиве удовлетворяет условию проверяющей функции или {{jsxref("Global_Objects/undefined", "undefined")}}, если такое значение не найдено.</dd> - <dt>{{jsxref("Array.prototype.findIndex()")}} {{experimental_inline}}</dt> - <dd>Возвращает искомый индекс в массиве, если элемент в массиве удовлетворяет условию проверяющей функции или -1, если такое значение не найдено.</dd> - <dt>{{jsxref("Array.prototype.keys()")}} {{experimental_inline}}</dt> - <dd>Возвращает новый итератор массива, содержащий ключи каждого индекса в массиве.</dd> - <dt>{{jsxref("Array.prototype.map()")}}</dt> - <dd>Создаёт новый массив с результатами вызова указанной функции на каждом элементе данного массива.</dd> - <dt>{{jsxref("Array.prototype.reduce()")}}</dt> - <dd>Применяет функцию к аккумулятору и каждому значению массива (слева-направо), сводя его к одному значению.</dd> - <dt>{{jsxref("Array.prototype.reduceRight()")}}</dt> - <dd>Применяет функцию к аккумулятору и каждому значению массива (справа-налево), сводя его к одному значению.</dd> - <dt>{{jsxref("Array.prototype.values()")}} {{experimental_inline}}</dt> - <dd>Возвращает новый объект итератора массива <code>Array Iterator</code>, содержащий значения для каждого индекса в массиве.</dd> - <dt>{{jsxref("Array.prototype.@@iterator()", "Array.prototype[@@iterator]()")}} {{experimental_inline}}</dt> - <dd>Возвращает новый объект итератора массива <code>Array Iterator</code>, содержащий значения для каждого индекса в массиве.</dd> -</dl> - -<h3 id="Generic_methods" name="Generic_methods">Общие методы</h3> - -<p>Многие методы JavaScript-массива спроектированы таким образом, чтобы иметь возможность применяться ко всем объектам, «выглядящим похоже» на массивы. То есть, они могут использоваться на любом объекте, имеющим свойство <code>length</code> и к элементам которого можно получить доступ через числовые имена свойств (как при индексации: <code>array[5]</code>). <span class="comment">TODO: предоставить примеры с Array.prototype.forEach.call и добавлением методов к объекту, как сделано для {{jsxref("Global_Objects/JavaArray", "JavaArray")}} или {{jsxref("Global_Objects/String", "String")}}.</span> Некоторые методы, например {{jsxref("Array.join", "join")}}, только читают свойство <code>length</code> и числовые свойства объекта, на котором они вызываются. Другие, вроде {{jsxref("Array.reverse", "reverse")}} требуют, чтобы числовые свойства и свойство <code>length</code> объекта были изменяемыми; эти методы не могут вызываться на объектах вроде {{jsxref("Global_Objects/String", "String")}}, которые не позволяют установку своего свойства <code>length</code> или синтезирование числовых свойств.</p> - -<h2 id="Specifications" name="Specifications">Спецификации</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Спецификация</th> - <th scope="col">Статус</th> - <th scope="col">Комментарий</th> - </tr> - <tr> - <td>ECMAScript 1-е издание.</td> - <td>Стандарт</td> - <td>Изначальное определение.</td> - </tr> - <tr> - <td>{{SpecName('ES5.1', '#sec-15.4.3.1', 'Array.prototype')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-array.prototype', 'Array.prototype')}}</td> - <td>{{Spec2('ES6')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Browser_compatibility" name="Browser_compatibility">Совместимость с браузерами</h2> - -<p> </p> - -<p>{{Compat("javascript.builtins.Array.prototype")}}</p> - -<p> </p> - -<div> </div> - -<h2 id="See_also" name="See_also">Смотрите также</h2> - -<ul> - <li>{{jsxref("Global_Objects/Array", "Array")}}</li> - <li>{{jsxref("Function.prototype")}}</li> -</ul> diff --git a/files/ru/orphaned/web/javascript/reference/global_objects/asyncfunction/prototype/index.html b/files/ru/orphaned/web/javascript/reference/global_objects/asyncfunction/prototype/index.html deleted file mode 100644 index 5a3e01d354..0000000000 --- a/files/ru/orphaned/web/javascript/reference/global_objects/asyncfunction/prototype/index.html +++ /dev/null @@ -1,56 +0,0 @@ ---- -title: AsyncFunction.prototype -slug: orphaned/Web/JavaScript/Reference/Global_Objects/AsyncFunction/prototype -translation_of: Web/JavaScript/Reference/Global_Objects/AsyncFunction/prototype -original_slug: Web/JavaScript/Reference/Global_Objects/AsyncFunction/prototype ---- -<div>{{JSRef}}</div> - -<p>Свойство <code><strong>AsyncFunction.prototype</strong></code> представляет прототип объекта {{jsxref("AsyncFunction")}} .</p> - -<h2 id="Описание">Описание</h2> - -<p>Объект {{jsxref("AsyncFunction")}} наследуется от <code>AsyncFunction.prototype</code>. <code>AsyncFunction.prototype</code> не может быть модифицирован.</p> - -<h2 id="Свойства">Свойства</h2> - -<dl> - <dt><code><strong>AsyncFunction.constructor</strong></code></dt> - <dd>Начальное значение {{jsxref("AsyncFunction")}}.</dd> - <dt><code><strong>AsyncFunction.prototype[@@toStringTag]</strong></code></dt> - <dd>Возвращает "AsyncFunction".</dd> -</dl> - -<h2 id="Specifications">Specifications</h2> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Specification</th> - <th scope="col">Status</th> - <th scope="col">Comment</th> - </tr> - </thead> - <tbody> - <tr> - <td>{{SpecName('ESDraft', '#sec-async-function-constructor-prototype', 'AsyncFunction.prototype')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td>Initial definition in ES2017.</td> - </tr> - </tbody> -</table> - -<h2 id="Browser_compatibility">Browser compatibility</h2> - -<div> - - -<p>{{Compat("javascript.builtins.AsyncFunction.prototype")}}</p> -</div> - -<h2 id="See_also">See also</h2> - -<ul> - <li>{{jsxref("AsyncFunction")}}</li> - <li>{{jsxref("Function")}}</li> -</ul> diff --git a/files/ru/orphaned/web/javascript/reference/global_objects/map/@@species/index.html b/files/ru/orphaned/web/javascript/reference/global_objects/map/@@species/index.html deleted file mode 100644 index fb101362a7..0000000000 --- a/files/ru/orphaned/web/javascript/reference/global_objects/map/@@species/index.html +++ /dev/null @@ -1,64 +0,0 @@ ---- -title: get Map[@@species] -slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/@@species -translation_of: Web/JavaScript/Reference/Global_Objects/Map/@@species -original_slug: Web/JavaScript/Reference/Global_Objects/Map/@@species ---- -<div>{{JSRef}}</div> - -<p>Акцессор свойства <code><strong>Map[@@species]</strong></code> возвращает <code>Map</code> конструктор.</p> - -<h2 id="Синтаксис">Синтаксис</h2> - -<pre class="syntaxbox">Map[Symbol.species] -</pre> - -<h2 id="Описание">Описание</h2> - -<p>Акцессор свойства species, возвращает конструктор по умолчанию для <code>Map</code> объектов. Конструкторы подклассов могут переопределить его, чтобы изменить поведение конструктора.</p> - -<h2 id="Примеры">Примеры</h2> - -<p>Свойство species возвращает конструктор по умолчанию, который является конструктором <code>Map</code> для <code>Map</code> объектов:</p> - -<pre class="brush: js">Map[Symbol.species]; // функция Map()</pre> - -<p>В производном объекте коллекции (например, ваша пользовательская карта <code>MyMap</code>), <code>MyMap</code> species является <code>MyMap</code> конструктором. Однако, вы можете захотеть переопределить это, что бы вернуть родительский <code>Map</code> в методах вашего производного класса:</p> - -<pre class="brush: js">class MyMap extends Map { - // Перезаписываем MyMap species на родительский Map конструктор - static get [Symbol.species]() { return Map; } -}</pre> - -<h2 id="Спецификации">Спецификации</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Спецификация</th> - <th scope="col">Статус</th> - <th scope="col">Комментарий</th> - </tr> - <tr> - <td>{{SpecName('ES2015', '#sec-get-map-@@species', 'get Map [ @@species ]')}}</td> - <td>{{Spec2('ES2015')}}</td> - <td>Исходное определение.</td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-get-map-@@species', 'get Map [ @@species ]')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Поддержка_браузерами">Поддержка браузерами</h2> - -<p>{{Compat}}</p> - -<h2 id="Смотрите_также">Смотрите также</h2> - -<ul> - <li>{{jsxref("Map")}}</li> - <li>{{jsxref("Symbol.species")}}</li> -</ul> diff --git a/files/ru/orphaned/web/javascript/reference/global_objects/map/clear/index.html b/files/ru/orphaned/web/javascript/reference/global_objects/map/clear/index.html deleted file mode 100644 index 5d9c518a05..0000000000 --- a/files/ru/orphaned/web/javascript/reference/global_objects/map/clear/index.html +++ /dev/null @@ -1,72 +0,0 @@ ---- -title: Map.prototype.clear() -slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/clear -tags: - - ECMAScript6 - - JavaScript - - Map - - Method - - Prototype -translation_of: Web/JavaScript/Reference/Global_Objects/Map/clear -original_slug: Web/JavaScript/Reference/Global_Objects/Map/clear ---- -<div>{{JSRef}}</div> - -<p><code><font face="Open Sans, arial, sans-serif">Метод </font><strong>clear()</strong></code> удаляет все элементы из объекта <code>Map</code>.</p> - -<h2 id="Синтаксис">Синтаксис</h2> - -<pre class="syntaxbox"><code><em>myMap</em>.clear();</code></pre> - -<h3 id="Возвращаемое_значение">Возвращаемое значение</h3> - -<p>{{jsxref("undefined")}}.</p> - -<h2 id="Примеры">Примеры</h2> - -<h3 id="Использование_метода_clear">Использование метода <code>clear</code></h3> - -<pre class="brush: js">var myMap = new Map(); -myMap.set('bar', 'baz'); -myMap.set(1, 'foo'); - -myMap.size; // 2 -myMap.has('bar'); // true - -myMap.clear(); - -myMap.size; // 0 -myMap.has('bar') // false -</pre> - -<h2 id="Спецификации">Спецификации</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Спецификация</th> - <th scope="col">Статус</th> - <th scope="col">Комментарий</th> - </tr> - <tr> - <td>{{SpecName('ES2015', '#sec-map.prototype.clear', 'Map.prototype.clear')}}</td> - <td>{{Spec2('ES2015')}}</td> - <td>Изначальное определение.</td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-map.prototype.clear', 'Map.prototype.clear')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Совместимость_с_браузерами">Совместимость с браузерами</h2> - -<p>{{Compat}}</p> - -<h2 id="Смотрите_также">Смотрите также</h2> - -<ul> - <li>{{jsxref("Map")}}</li> -</ul> diff --git a/files/ru/orphaned/web/javascript/reference/global_objects/map/delete/index.html b/files/ru/orphaned/web/javascript/reference/global_objects/map/delete/index.html deleted file mode 100644 index 7f52de0c89..0000000000 --- a/files/ru/orphaned/web/javascript/reference/global_objects/map/delete/index.html +++ /dev/null @@ -1,77 +0,0 @@ ---- -title: Map.prototype.delete() -slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/delete -tags: - - ECMAScript 2015 - - JavaScript - - Map - - Ссылка - - метод - - прототип -translation_of: Web/JavaScript/Reference/Global_Objects/Map/delete -original_slug: Web/JavaScript/Reference/Global_Objects/Map/delete ---- -<div>{{JSRef}}</div> - -<p>Метод <code><strong>delete()</strong></code> удаляет указанный элемент из объекта {{jsxref("Map")}}.</p> - -<div>{{EmbedInteractiveExample("pages/js/map-prototype-delete.html")}}</div> - -<p class="hidden">Исходники данного интерактивного примера хранятся в репозитории GitHub. Если вы хотите внести свой склад в проект интерактивных примеров - пожалуйста, клонируйте <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> и пришлите нам пулреквест.</p> - -<h2 id="Синтаксис">Синтаксис</h2> - -<pre class="brush: js">myMap.delete(key);</pre> - -<h3 id="Параметры">Параметры</h3> - -<dl> - <dt>key</dt> - <dd>Ключ элемента удаляемого из объекта {{jsxref("Map")}}</dd> -</dl> - -<h3 id="Возвращаемое_значение">Возвращаемое значение</h3> - -<p><code>true</code> если элемент существовал в {{jsxref("Map")}} и он был удалён или <code>false</code> если элемента с таким ключом не было.</p> - -<h2 id="Примеры">Примеры</h2> - -<h3 id="Использование_метода_delete">Использование метода <code>delete</code></h3> - -<pre class="brush: js">var myMap = new Map(); -myMap.set('bar', 'foo'); - -myMap.delete("bar"); // Возвращает true. Успешно удалён. -myMap.has("bar"); // Возвращает false. Элемента "bar" больше нет. -</pre> - -<h2 id="Спецификации">Спецификации</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Спецификация</th> - <th scope="col">Статус</th> - <th scope="col">Комментарий</th> - </tr> - <tr> - <td>{{SpecName('ES2015', '#sec-map.prototype.delete', 'Map.prototype.delete')}}</td> - <td>{{Spec2('ES2015')}}</td> - <td>Изначальное определение.</td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-map.prototype.delete', 'Map.prototype.delete')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td></td> - </tr> - </tbody> -</table> - -<h2 id="Совместимость_с_браузерами">Совместимость с браузерами</h2> -<p>{{Compat("javascript.builtins.Map.delete")}}</p> - -<h2 id="Смотрите_также">Смотрите также</h2> - -<ul> - <li>{{jsxref("Map")}}</li> -</ul> diff --git a/files/ru/orphaned/web/javascript/reference/global_objects/map/entries/index.html b/files/ru/orphaned/web/javascript/reference/global_objects/map/entries/index.html deleted file mode 100644 index c1d3faf3d3..0000000000 --- a/files/ru/orphaned/web/javascript/reference/global_objects/map/entries/index.html +++ /dev/null @@ -1,76 +0,0 @@ ---- -title: Map.prototype.entries() -slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/entries -translation_of: Web/JavaScript/Reference/Global_Objects/Map/entries -original_slug: Web/JavaScript/Reference/Global_Objects/Map/entries ---- -<div>{{JSRef}}</div> - -<p>Метод <code><strong>entries()</strong></code> возвращает новый <strong><a href="/en-US/docs/Web/JavaScript/Guide/Iterators_and_Generators">Итератор</a></strong>, содержащий пары <code>[key, value]</code> для каждого элемента объекта {{jsxref("Map")}} в том порядке, в котором они были заведены.</p> - -<p>Исходный код всех примеров для {{jsxref("Map")}} сохранён на GitHub <a href="https://github.com/mdn/interactive-examples/tree/master/live-examples/js-examples/map">https://github.com/mdn/interactive-examples/tree/master/live-examples/js-examples/map</a>.</p> - -<p>Вы можете внести свой вклад, для этого: </p> - -<p>1. Клонируйте <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a></p> - -<p>2. Ознакомьтесь с руководством <a href="https://github.com/mdn/interactive-examples/blob/master/CONTRIBUTING.md">https://github.com/mdn/interactive-examples/blob/master/CONTRIBUTING.md</a></p> - -<p>3. Напишите свой пример и отправьте нам запрос на извлечение.</p> - -<h2 id="Синтаксис">Синтаксис</h2> - -<pre class="syntaxbox"><code><em>myMap</em>.entries()</code></pre> - -<h3 id="Возвращаемое_значение">Возвращаемое значение</h3> - -<p>Новый итератор объекта {{jsxref("Map")}}.</p> - -<h2 id="Примеры">Примеры</h2> - -<h3 id="Использование_entries">Использование <code>entries()</code></h3> - -<pre class="brush:js">var myMap = new Map(); -myMap.set('0', 'foo'); -myMap.set(1, 'bar'); -myMap.set({}, 'baz'); - -var mapIter = myMap.entries(); - -console.log(mapIter.next().value); // ["0", "foo"] -console.log(mapIter.next().value); // [1, "bar"] -console.log(mapIter.next().value); // [Object, "baz"] -</pre> - -<h2 id="Спецификации">Спецификации</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Спецификация</th> - <th scope="col">Статус</th> - <th scope="col">Комментарий</th> - </tr> - <tr> - <td>{{SpecName('ES2015', '#sec-map.prototype.entries', 'Map.prototype.entries')}}</td> - <td>{{Spec2('ES2015')}}</td> - <td>Initial definition.</td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-map.prototype.entries', 'Map.prototype.entries')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td></td> - </tr> - </tbody> -</table> - -<h2 id="Поддержка_браузерами">Поддержка браузерами</h2> - -<p>{{Compat}}</p> - -<h2 id="Смотрите_также">Смотрите также</h2> - -<ul> - <li>{{jsxref("Map.prototype.keys()")}}</li> - <li>{{jsxref("Map.prototype.values()")}}</li> -</ul> diff --git a/files/ru/orphaned/web/javascript/reference/global_objects/map/foreach/index.html b/files/ru/orphaned/web/javascript/reference/global_objects/map/foreach/index.html deleted file mode 100644 index b2f99f9f47..0000000000 --- a/files/ru/orphaned/web/javascript/reference/global_objects/map/foreach/index.html +++ /dev/null @@ -1,95 +0,0 @@ ---- -title: Map.prototype.forEach() -slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/forEach -translation_of: Web/JavaScript/Reference/Global_Objects/Map/forEach -original_slug: Web/JavaScript/Reference/Global_Objects/Map/forEach ---- -<div>{{JSRef}}</div> - -<p>Метод <code><strong>forEach()</strong></code><strong> </strong>выполняет переданную функцию единожды для каждой пары ключ/значение объекта <code>Map</code> в порядке их вставки.</p> - -<div>{{EmbedInteractiveExample("pages/js/map-prototype-foreach.html")}}</div> - -<h2 id="Синтаксис">Синтаксис</h2> - -<pre class="syntaxbox"><code><em>myMap</em>.forEach(<em>callback</em>[, <em>thisArg</em>])</code></pre> - -<h3 id="Параметры">Параметры</h3> - -<dl> - <dt><code>callback</code></dt> - <dd>Функция, которая будет выполнена для каждого элемента.</dd> - <dt><code>thisArg</code></dt> - <dd>Значение, которое будет использовано в качестве текущего при выполнении callback.</dd> -</dl> - -<h3 id="Возвращаемое_значение">Возвращаемое значение</h3> - -<p>{{jsxref("undefined")}}.</p> - -<h2 id="Описание">Описание</h2> - -<p>Метод <code>forEach</code> выполняет переданный ему <code>callback</code> по разу для каждого фактически существующего ключа в наборе. <code>Callback</code> не вызывается для ключей, которые были удалены. Однако, он выполняется для элементов со значением <code>undefined</code>.</p> - -<p>При вызове <code>callback</code> используются <strong>три аргумента</strong>:</p> - -<ul> - <li><strong>значение элемента</strong></li> - <li><strong>ключ элемента</strong></li> - <li><strong>объект</strong> <strong><code>Map</code>, по которому осуществляется проход</strong></li> -</ul> - -<p>Если аргумент <code>thisArg</code> указан для <code>forEach</code>, то при вызове <code>callback</code> он будет передан в качестве значения <code>this</code>. В противном случае для <code>this</code> будет передано <code>undefined</code>. Значение <code>this</code>, в конечном итоге наблюдаемое в функции <code>callback</code>, определяется в соответствии c <a href="/ru/docs/Web/JavaScript/Reference/Operators/this">обычными правилами определения <code>this</code> в функции.</a></p> - -<p>Каждое значение посещается один раз, за исключением случая, когда оно было удалено и добавлено снова до завершения <code>forEach</code>. <code>callback</code> не вызывается для значений, удалённых до их посещения. Новые значения будут посещены, если они добавлены до завершения <code>forEach</code>.</p> - -<p><code>forEach</code> исполняет функцию <code>callback</code> один раз для каждого элемента в объекте <code>Map</code>; не возвращает значение.</p> - -<h2 id="Примеры">Примеры</h2> - -<h3 id="Вывод_содержимого_объекта_Map">Вывод содержимого объекта <code>Map</code></h3> - -<p>Следующий код выводит в консоль строку для каждого элемента в объекте <code>Map</code>:</p> - -<pre class="brush:js">function logMapElements(value, key, map) { - console.log("m[" + key + "] = " + value); -} -new Map([["foo", 3], ["bar", {}], ["baz", undefined]]).forEach(logMapElements); -// logs: -// "m[foo] = 3" -// "m[bar] = [object Object]" -// "m[baz] = undefined" -</pre> - -<h2 id="Спецификации">Спецификации</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Спецификация</th> - <th scope="col">Статус</th> - <th scope="col">Комментарий</th> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-map.prototype.foreach', 'Map.prototype.forEach')}}</td> - <td>{{Spec2('ES6')}}</td> - <td>Initial definition.</td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-map.prototype.foreach', 'Map.prototype.forEach')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Совместимость_с_браузерами">Совместимость с браузерами</h2> - -<p>{{Compat("javascript.builtins.Map.forEach")}}</p> - -<h2 id="Смотрите_также">Смотрите также</h2> - -<ul> - <li>{{jsxref("Array.prototype.forEach()")}}</li> - <li>{{jsxref("Set.prototype.forEach()")}}</li> -</ul> diff --git a/files/ru/orphaned/web/javascript/reference/global_objects/map/get/index.html b/files/ru/orphaned/web/javascript/reference/global_objects/map/get/index.html deleted file mode 100644 index 8f91194549..0000000000 --- a/files/ru/orphaned/web/javascript/reference/global_objects/map/get/index.html +++ /dev/null @@ -1,69 +0,0 @@ ---- -title: Map.prototype.get() -slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/get -translation_of: Web/JavaScript/Reference/Global_Objects/Map/get -original_slug: Web/JavaScript/Reference/Global_Objects/Map/get ---- -<div>{{JSRef}}</div> - -<p>Метод <code><strong>get()</strong></code> возвращает указанный элемент объекта {{jsxref("Map")}}.</p> - -<h2 id="Синтаксис">Синтаксис</h2> - -<pre class="syntaxbox notranslate"><code><em>myMap</em>.get(key);</code></pre> - -<h3 id="Параметры">Параметры</h3> - -<dl> - <dt>key</dt> - <dd>Обязательный. Ключ элемента объекта {{jsxref("Map")}}.</dd> -</dl> - -<h3 id="Возвращаемое_значение">Возвращаемое значение</h3> - -<p>Возвращает элемент связанный с указанным ключом или <code>undefined</code>, если ключ не был найден в объекте {{jsxref("Map")}}.</p> - -<h2 id="Примеры">Примеры</h2> - -<h3 id="Использование_метода_get">Использование метода <code>get</code>()</h3> - -<pre class="brush: js notranslate">var myMap = new Map(); -myMap.set('bar', 'foo'); - -myMap.get('bar'); // Вернёт "foo". -myMap.get('baz'); // Вернёт undefined. -</pre> - -<h2 id="Спецификации">Спецификации</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Спецификация</th> - <th scope="col">Статус</th> - <th scope="col">Комментарий</th> - </tr> - <tr> - <td>{{SpecName('ES2015', '#sec-map.prototype.get', 'Map.prototype.get')}}</td> - <td>{{Spec2('ES2015')}}</td> - <td>Initial definition.</td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-map.prototype.get', 'Map.prototype.get')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td></td> - </tr> - </tbody> -</table> - -<h2 id="Поддержка_браузерами">Поддержка браузерами</h2> - -<p>{{Compat("javascript.builtins.Map.get")}}</p> - -<h2 id="Смотрите_также">Смотрите также</h2> - -<ul> - <li>{{jsxref("Map")}}</li> - <li>{{jsxref("Map.prototype.set()")}}</li> - <li>{{jsxref("Map.prototype.has()")}}</li> -</ul> diff --git a/files/ru/orphaned/web/javascript/reference/global_objects/map/has/index.html b/files/ru/orphaned/web/javascript/reference/global_objects/map/has/index.html deleted file mode 100644 index ce4cae29b7..0000000000 --- a/files/ru/orphaned/web/javascript/reference/global_objects/map/has/index.html +++ /dev/null @@ -1,72 +0,0 @@ ---- -title: Map.prototype.has() -slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/has -translation_of: Web/JavaScript/Reference/Global_Objects/Map/has -original_slug: Web/JavaScript/Reference/Global_Objects/Map/has ---- -<div>{{JSRef}}</div> - -<p>Метод <code><strong>has()</strong></code> возвращает тип Boolean, указывающий существует ли элемент с указанным ключом или нет.</p> - -<h2 id="Синтаксис">Синтаксис</h2> - -<pre class="syntaxbox"><code><em>myMap</em>.has(key);</code></pre> - -<h3 id="Параметры">Параметры</h3> - -<dl> - <dt>key</dt> - <dd>Обязательный параметр. Ключ элемента для проверки существования в объекте <code>Map.</code></dd> -</dl> - -<h3 id="Возвращаемое_значение">Возвращаемое значение</h3> - -<dl> - <dt>Boolean</dt> - <dd>Возвращает <code>true,</code> если элемент с указанным ключом существует в объекте <code>Map</code>; в противном случае возвращает <code>false</code>.</dd> -</dl> - -<h2 id="Примеры">Примеры</h2> - -<h3 id="Использование_метода_has">Использование метода <code>has</code></h3> - -<pre class="brush: js">var myMap = new Map(); -myMap.set('bar', "foo"); - -myMap.has('bar'); // возвращает true -myMap.has('baz'); // возвращает false -</pre> - -<h2 id="Спецификации">Спецификации</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Спецификация</th> - <th scope="col">Статус</th> - <th scope="col">Комментарий</th> - </tr> - <tr> - <td>{{SpecName('ES2015', '#sec-map.prototype.has', 'Map.prototype.has')}}</td> - <td>{{Spec2('ES2015')}}</td> - <td>Первоначальное определение.</td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-map.prototype.has', 'Map.prototype.has')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Browser_compatibility" name="Browser_compatibility">Совместимость с браузерами</h2> - -<p>{{Compat}}</p> - -<h2 id="Смотрите_также">Смотрите также</h2> - -<ul> - <li>{{jsxref("Map")}}</li> - <li>{{jsxref("Map.prototype.set()")}}</li> - <li>{{jsxref("Map.prototype.get()")}}</li> -</ul> diff --git a/files/ru/orphaned/web/javascript/reference/global_objects/map/index.html b/files/ru/orphaned/web/javascript/reference/global_objects/map/index.html deleted file mode 100644 index 4ea24c2ad6..0000000000 --- a/files/ru/orphaned/web/javascript/reference/global_objects/map/index.html +++ /dev/null @@ -1,286 +0,0 @@ ---- -title: Map -slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map -tags: - - ECMAScript 2015 - - JavaScript - - Map -translation_of: Web/JavaScript/Reference/Global_Objects/Map -original_slug: Web/JavaScript/Reference/Global_Objects/Map ---- -<div>{{JSRef}}</div> - -<p><span class="seoSummary">Объект <strong><code>Map</code></strong> содержит пары ключ-значение и сохраняет порядок вставки.</span> Любое значение (как объекты, так и {{Glossary("Primitive", "примитивы")}}) могут быть использованы в качестве ключей.</p> - -<h2 id="Синтаксис">Синтаксис</h2> - -<pre class="syntaxbox">new Map([<em>iterable</em>])</pre> - -<h3 id="Параметры">Параметры</h3> - -<dl> - <dt><code>iterable</code></dt> - <dd>Массив или любой другой <a href="/ru/docs/Web/JavaScript/Reference/Iteration_protocols">итерируемый</a> объект чьими элементами являются пары ключ-значение (массивы из двух элементов, например <code>[[ 1, 'one' ],[ 2, 'two' ]]</code>). Все пары ключ-значение будут добавлены в новый экземпляр <code>Map</code>; <code>null</code> расценивается как <code>undefined</code>.</dd> -</dl> - -<h2 id="Описание">Описание</h2> - -<p>Объект <code>Map</code> итерируется в порядке вставки его элементов — цикл {{jsxref("Statements/for...of", "for...of")}} будет возвращать массив <code>[key, value]</code> на каждой итерации.</p> - -<h3 id="Key_equality">Key equality</h3> - -<p>Сравнение ключей основано на алгоритме "{{Glossary("SameValueZero", "SameValueZero")}}": <code>NaN</code> равно <code>NaN</code> (несмотря на то, что <code>NaN !== NaN</code>), все другие значения рассматриваются равными исходя из семантики оператора строгого равенства <code>===</code>. В текущей спецификации ECMAScript <code>-0</code> и <code>+0</code> принимаются равными, но в ранних версиях обсуждения это было не так (см. "Value equality for -0 and 0" в таблице <a href="#Browser_compatibility">совместимости с браузерами</a>).</p> - -<h3 id="Сравнение_Объектов_и_Map">Сравнение Объектов и Map</h3> - -<p>Объекты похожи на <code>Map</code> в том, что оба позволяют устанавливать значения по ключам, получать эти значения, удалять ключи и проверять их наличие. В связи с этим (и потому, что не было встроенных альтернатив), {{jsxref("Object", "Объекты")}} исторически использовались как <code>Map</code>. Однако, у них есть ряд отличий, который даёт преимущества <code>Map</code> в ряде случаев:</p> - -<ul> - <li>Ключами {{jsxref("Object", "Объекта")}} выступают {{jsxref("String", "Строки")}} и {{jsxref("Symbol", "Символы")}}, в то время как любое значение может быть ключом <code>Map</code>, включая {{jsxref("Function", "функции")}}, {{jsxref("Object", "объекты")}} и {{Glossary("Primitive", "примитивы")}}.</li> - <li>В отличие от {{jsxref("Object", "Объектов")}}, ключи в <code>Map</code> упорядочены. Таким образом, во время итерации <code>Map</code>, ключи возвращаются в порядке вставки.</li> - <li>Вы легко можете получить количество элементов в <code>Map</code> с помощью свойства <code>size</code>, в то время как количество элементов {{jsxref("Object", "Объекта")}} может быть определено только вручную.</li> - <li><code>Map</code> - <a href="/en-US/docs/Web/JavaScript/Guide/iterable">итерируемый</a> объект и может быть итерирован напрямую, в то время как {{jsxref("Object", "Объект")}} требует ручного получения списка ключей и их итерации.</li> - <li>{{jsxref("Object", "Объект")}} имеет прототип и поэтому имеет стандартный набор ключей, который, при неосторожности, может пересекаться с вашими ключами. С момента выхода ES5 это может быть изменено с помощью <code>map = Object.create(null)</code>.</li> - <li><code>Map</code> может иметь более высокую производительность в случаях частого добавления или удаления ключей.</li> -</ul> - -<h2 id="Свойства">Свойства</h2> - -<dl> - <dt><code>Map.length</code></dt> - <dd>Значение свойства <code>length</code> всегда равно 0.</dd> - <dd>Чтобы узнать количество элементов в <code>Map</code> - используйте {{jsxref("Map.prototype.size")}}.</dd> - <dt>{{jsxref("Map.@@species", "get Map[@@species]")}}</dt> - <dd>Функция-конструктор которая используется для создания производных объектов.</dd> - <dt>{{jsxref("Map.prototype")}}</dt> - <dd>Представляет прототип конструктора <code>Map</code>. Позволяет добавлять свойства всем объектам типа <code>Map</code>.</dd> -</dl> - -<h2 id="Экземпляры_Map">Экземпляры <code>Map</code></h2> - -<p>Все экземпляры <code>Map</code> наследуются от {{jsxref("Map.prototype")}}.</p> - -<h3 id="Свойства_2">Свойства</h3> - -<dl> - <dt><code>Map.prototype.constructor</code></dt> - <dd>Возвращает функцию, которая создала прототип экземпляра. Это функция <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Map" title="The Map object holds key-value pairs and remembers the original insertion order of the keys."><code>Map</code></a> по умолчанию.</dd> - <dt><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Map/size" title="The size accessor property returns the number of elements in a Map object."><code>Map.prototype.size</code></a></dt> - <dd>Возвращает количество пар ключ/значение в объекте <code>Map</code>.</dd> -</dl> - -<h3 id="Методы">Методы</h3> - -<dl> - <dt><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Map/clear" title="The clear() method removes all elements from a Map object."><code>Map.prototype.clear()</code></a></dt> - <dd>Удаляет все пары ключ / значение из объекта <code>Map</code>.</dd> - <dt><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Map/delete" title="The delete() method removes the specified element from a Map object by key."><code>Map.prototype.delete(key)</code></a></dt> - <dd>Возвращает <code>true</code>, если элемент в объекте <code>Map</code> существовал и был удалён, или false, если элемент не существует. <code>Map.prototype.has(key)</code> вернёт <code>false</code> позже.</dd> - <dt><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Map/entries" title="The entries() method returns a new Iterator object that contains the [key, value] pairs for each element in the Map object in insertion order."><code>Map.prototype.entries()</code></a></dt> - <dd>Возвращает новый объект <code>Iterator</code> который содержит <strong>массив</strong> <strong><code>[key, value]</code></strong> для каждого элемента в объекте <code>Map</code> в порядке вставки.</dd> - <dt><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Map/forEach" title="The forEach() method executes a provided function once per each key/value pair in the Map object, in insertion order."><code>Map.prototype.forEach(callbackFn[, thisArg])</code></a></dt> - <dd>Вызывает callbackFn один раз для каждой пары ключ-значение, присутствующей в объекте <code>Map</code>, в порядке вставки. Если для thisArg предоставляется параметр для forEach, он будет использоваться как значение this для каждого колбэка.</dd> - <dt><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Map/get" title="The get() method returns a specified element from a Map object."><code>Map.prototype.get(key)</code></a></dt> - <dd>Возвращает значение связанное с <code>key</code>, или <code>undefined</code> если его нет.</dd> - <dt><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Map/has" title="The has() method returns a boolean indicating whether an element with the specified key exists or not."><code>Map.prototype.has(key)</code></a></dt> - <dd>Возвращает логическое значение, подтверждающее, было ли значение связано с <code>key</code> в объекте <code>Map</code> или нет.</dd> - <dt><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Map/keys" title="The keys() method returns a new Iterator object that contains the keys for each element in the Map object in insertion order."><code>Map.prototype.keys()</code></a></dt> - <dd>Возвращает новый объект <code>Iterator</code> содержащий ключи для каждого элемента в объекте <code>Map</code> в порядке вставки.</dd> - <dt><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Map/set" title="The set() method adds or updates an element with a specified key and a value to a Map object."><code>Map.prototype.set(key, value)</code></a></dt> - <dd>Устанавливает значение для <code>key</code> в объекте <code>Map</code>. Возвращает объект <code>Map</code>.</dd> - <dt><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Map/values" title="The values() method returns a new Iterator object that contains the values for each element in the Map object in insertion order."><code>Map.prototype.values()</code></a></dt> - <dd>Возвращает новый объект <code>Iterator</code> который содержит значения для каждого элемента в объекте <code>Map</code> в порядке вставки.</dd> - <dt><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Map/@@iterator" title="The initial value of the @@iterator property is the same function object as the initial value of the entries method."><code>Map.prototype[@@iterator]()</code></a></dt> - <dd>Возвращает новый объект <code>Iterator</code> который содержит массив<strong> <code>[key, value]</code></strong> для каждого элемента в объекте <code>Map</code> в порядке вставки.</dd> -</dl> - -<h2 id="Примеры">Примеры</h2> - -<h3 id="Использование_объекта_Map">Использование объекта <code>Map</code></h3> - -<pre class="brush: js">const myMap = new Map(); - -const keyObj = {}, - keyFunc = function () {}, - keyString = 'a string'; - -// задание значений -myMap.set(keyString, 'value associated with “a string”'); -myMap.set(keyObj, 'value associated with keyObj'); -myMap.set(keyFunc, 'value associated with keyFunc'); - -myMap.size; // 3 - -// получение значений -myMap.get(keyString); // value associated with “a string” -myMap.get(keyObj); // value associated with keyObj -myMap.get(keyFunc); // value associated with keyFunc - -myMap.get('a string'); // "value associated with 'a string'" - // потому что keyString === 'a string' -myMap.get({}); // undefined, потому что <span style="font-size: 1rem;">keyObj !== {} ({} — это литеральная нотация конструктора класса Object)</span> -myMap.get(function() {}) // undefined, потому что <span style="font-size: 1rem;">keyFunc !== function () {}</span> -</pre> - -<h3 id="Использование_NaN_в_качестве_ключей_Map">Использование <code>NaN</code> в качестве ключей <code>Map</code></h3> - -<p><code>NaN</code> может быть использован в качестве ключа. Несмотря на то, что <code>NaN</code> не равен самому себе (<code>NaN !== NaN</code> вернёт true), следующий пример работает, потому что <code>NaN</code> обрабатывается особым образом:</p> - -<pre class="brush: js">const myMap = new Map(); -myMap.set(NaN, 'not a number'); - -myMap.get(NaN); // not a number - -const otherNaN = Number('foo'); -myMap.get(otherNaN); // not a number -</pre> - -<h3 id="Итерация_Map_при_помощи_for..of">Итерация <code>Map</code> при помощи <code>for..of</code></h3> - -<p><code>Map</code> может быть итерирован с помощью <code>for..of</code>:</p> - -<pre class="brush: js">const myMap = new Map(); -myMap.set(0, 'zero'); -myMap.set(1, 'one'); -for (var [key, value] of myMap) { - console.log(key + ' = ' + value); -} -// 0 = zero -// 1 = one - -for (var key of myMap.keys()) { - console.log(key); -} -// 0 -// 1 - -for (var value of myMap.values()) { - console.log(value); -} -// zero -// one - -for (var [key, value] of myMap.entries()) { - console.log(key + ' = ' + value); -} -// 0 = zero -// 1 = one -</pre> - -<h3 id="Итерация_Map_при_помощи_forEach">Итерация <code>Map</code> при помощи <code>forEach()</code></h3> - -<p><code>Map</code> может быть итерирован с помощью метода <code>forEach()</code>:</p> - -<pre class="brush: js">myMap.forEach(function(value, key) { - console.log(`${key} => ${value}`); -}); -// 0 => zero -// 1 => one -</pre> - -<h3 id="Взаимоотношения_с_объектом_Array">Взаимоотношения с объектом <code>Array</code></h3> - -<pre class="brush: js">const kvArray = [['key1', 'value1'], ['key2', 'value2']]; - -// Используйте конструктор Map для преобразования двумерных массивов в Map -const myMap = new Map(kvArray); - -myMap.get('key1'); // вернёт “value1” - -// Используйте функцию Array.from для трансформации Map в двумерный key-value массив -console.log(Array.from(myMap)); // Выведет точно такой же массив как kvArray - -// Или используйте итераторы keys или values чтобы преобразовать ключи или значения в массивы -console.log(Array.from(myMap.keys())); // Выведет ['key1', 'key2'] -</pre> - -<h3 id="Клонирование_и_слияние_Map">Клонирование и слияние <code>Map</code></h3> - -<p> Равно как и {{jsxref("Array", "Массивы")}}, <code>Map</code> могут быть клонированы:</p> - -<pre class="brush: js">const original = new Map([ - [1, 'one'] -]); - -const clone = new Map(original); - -console.log(clone.get(1)); // one -console.log(original === clone); // false.</pre> - -<p>Следует помнить, что <em>данные</em> не клонируются.</p> - -<p><code>Map</code> могут быть слиты, с сохранением уникальности ключей:</p> - -<pre class="brush: js">const first = new Map([ - [1, 'one'], - [2, 'two'], - [3, 'three'], -]); - -const second = new Map([ - [1, 'uno'], - [2, 'dos'] -]); - -// Слияние двух Map. Взят будет последний повторившийся ключ. -// Оператор Spread по сути преобразует Map в массив -const merged = new Map([...first, ...second]); - -console.log(merged.get(1)); // uno -console.log(merged.get(2)); // dos -console.log(merged.get(3)); // three</pre> - -<p>Map могут быть слиты и с {{jsxref("Array", "Массивами")}}:</p> - -<pre class="brush: js">const first = new Map([ - [1, 'one'], - [2, 'two'], - [3, 'three'], -]); - -const second = new Map([ - [1, 'uno'], - [2, 'dos'] -]); - -// Слияние Map и массива. Как и при слиянии двух Map - взят будет последний повторившийся ключ. -const merged = new Map([...first, ...second, [1, 'eins']]); - -console.log(merged.get(1)); // eins -console.log(merged.get(2)); // dos -console.log(merged.get(3)); // three</pre> - -<h2 id="Спецификации">Спецификации</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Спецификация</th> - <th scope="col">Статус</th> - <th scope="col">Комментарий</th> - </tr> - <tr> - <td>{{SpecName('ES2015', '#sec-map-objects', 'Map')}}</td> - <td>{{Spec2('ES2015')}}</td> - <td>Initial definition.</td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-map-objects', 'Map')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td></td> - </tr> - </tbody> -</table> - -<h2 id="Совместимость_с_браузерами">Совместимость с браузерами</h2> -<p>{{Compat("javascript.builtins.Map")}}</p> - -<h2 id="Смотрите_также">Смотрите также</h2> - -<ul> - <li><a class="link-https" href="https://bugzilla.mozilla.org/show_bug.cgi?id=697479">Map и Set баг в Mozilla</a></li> - <li><a class="external" href="http://wiki.ecmascript.org/doku.php?id=harmony:simple_maps_and_sets">Предложение ECMAScript Harmony</a></li> - <li>{{jsxref("Set")}}</li> - <li>{{jsxref("WeakMap")}}</li> - <li>{{jsxref("WeakSet")}}</li> -</ul> diff --git a/files/ru/orphaned/web/javascript/reference/global_objects/map/keys/index.html b/files/ru/orphaned/web/javascript/reference/global_objects/map/keys/index.html deleted file mode 100644 index aeb0f7f568..0000000000 --- a/files/ru/orphaned/web/javascript/reference/global_objects/map/keys/index.html +++ /dev/null @@ -1,66 +0,0 @@ ---- -title: Map.prototype.keys() -slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/keys -translation_of: Web/JavaScript/Reference/Global_Objects/Map/keys -original_slug: Web/JavaScript/Reference/Global_Objects/Map/keys ---- -<div>{{JSRef}}</div> - -<p>Метод <code><strong>keys()</strong></code> возвращает новый <strong><a href="/ru/docs/Web/JavaScript/Guide/Iterators_and_Generators">Итератор</a></strong>, содержащий ключи каждого элемента объекта {{jsxref("Map")}} в том порядке, в котором они были заведены.</p> - -<h2 id="Синтаксис">Синтаксис</h2> - -<pre class="syntaxbox"><code><em>myMap</em>.keys()</code></pre> - -<h3 id="Возвращаемое_значение">Возвращаемое значение</h3> - -<p>Новый итератор объекта {{jsxref("Map")}}.</p> - -<h2 id="Примеры">Примеры</h2> - -<h3 id="Использование_метода_keys()">Использование метода <code>keys()</code></h3> - -<pre class="brush:js">var myMap = new Map(); -myMap.set('0', 'foo'); -myMap.set(1, 'bar'); -myMap.set({}, 'baz'); - -var mapIter = myMap.keys(); - -console.log(mapIter.next().value); // "0" -console.log(mapIter.next().value); // 1 -console.log(mapIter.next().value); // Object -</pre> - -<h2 id="Спецификации">Спецификации</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Спецификация</th> - <th scope="col">Статус</th> - <th scope="col">Комментарий</th> - </tr> - <tr> - <td>{{SpecName('ES2015', '#sec-map.prototype.keys', 'Map.prototype.keys')}}</td> - <td>{{Spec2('ES2015')}}</td> - <td>Initial definition.</td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-map.prototype.keys', 'Map.prototype.keys')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Поддержка_браузерами">Поддержка браузерами</h2> - -<p>{{Compat}}</p> - -<h2 id="Смотрите_также">Смотрите также</h2> - -<ul> - <li>{{jsxref("Map.prototype.entries()")}}</li> - <li>{{jsxref("Map.prototype.values()")}}</li> -</ul> diff --git a/files/ru/orphaned/web/javascript/reference/global_objects/map/set/index.html b/files/ru/orphaned/web/javascript/reference/global_objects/map/set/index.html deleted file mode 100644 index ae605adefd..0000000000 --- a/files/ru/orphaned/web/javascript/reference/global_objects/map/set/index.html +++ /dev/null @@ -1,89 +0,0 @@ ---- -title: Map.prototype.set() -slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/set -translation_of: Web/JavaScript/Reference/Global_Objects/Map/set -original_slug: Web/JavaScript/Reference/Global_Objects/Map/set ---- -<div>{{JSRef}}</div> - -<p>Метод <code><strong>set()</strong></code> добавляет объекту {{jsxref("Map")}} новый элемент или обновляет существующий с указанными значениями <code>key</code> и <code>value</code>.</p> - -<h2 id="Синтаксис">Синтаксис</h2> - -<pre class="syntaxbox"><code><em>myMap</em>.set(key, value);</code></pre> - -<h3 id="Параметры">Параметры</h3> - -<dl> - <dt>key</dt> - <dd>Ключ добавляемого элемента.</dd> - <dt>value</dt> - <dd>Значение добавляемого элемента.</dd> -</dl> - -<h3 id="Возвращаемое_значение">Возвращаемое значение</h3> - -<p>Объект {{jsxref("Map")}}.</p> - -<h2 id="Примеры">Примеры</h2> - -<h3 id="Использование_метода_set()">Использование метода <code>set()</code></h3> - -<pre class="brush: js">var myMap = new Map(); - -// Добавление нового элемента объекту Map -myMap.set('bar', 'foo'); -myMap.set(1, 'foobar'); - -// Обновление существующего элемента -myMap.set('bar', 'baz'); -</pre> - -<h3 id="Последовательное_использование_метода_set()">Последовательное использование метода <code>set()</code></h3> - -<p>Так как метод <code>set()</code> возвращает объект <code>Map</code>, вы можете последовательно применять метод <code>set()</code> как в примере ниже:</p> - -<pre class="brush: js"><code>// Последовательно добавляет новые элементы в myMap: -myMap.set('bar', 'foo') - .set(1, 'foobar') - .set(2, 'baz');</code></pre> - -<h2 id="Спецификации">Спецификации</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Спецификация</th> - <th scope="col">Статус</th> - <th scope="col">Комментарий</th> - </tr> - <tr> - <td>{{SpecName('ES2015', '#sec-map.prototype.set', 'Map.prototype.set')}}</td> - <td>{{Spec2('ES2015')}}</td> - <td>Initial definition.</td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-map.prototype.set', 'Map.prototype.set')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td></td> - </tr> - </tbody> -</table> - -<h2 id="Поддержка_браузерами">Поддержка браузерами</h2> - -<p>{{Compat}}</p> - -<h2 id="Примечание_к_поддержке_браузерами">Примечание к поддержке браузерами</h2> - -<ul> - <li>В Firefox 33 {{geckoRelease("33")}} и более ранних версиях <code>Map.prototype.set</code> возвращал <code>undefined</code> и не был доступен вызов его в цепочке. Это было поправлено ({{bug(1031632)}}). Данное поведение было также обнаружено в Chrome/v8 (<a href="https://code.google.com/p/v8/issues/detail?id=3410">issue</a>) и IE11.</li> -</ul> - -<h2 id="Смотрите_также">Смотрите также</h2> - -<ul> - <li>{{jsxref("Map")}}</li> - <li>{{jsxref("Map.prototype.get()")}}</li> - <li>{{jsxref("Map.prototype.has()")}}</li> -</ul> diff --git a/files/ru/orphaned/web/javascript/reference/global_objects/map/size/index.html b/files/ru/orphaned/web/javascript/reference/global_objects/map/size/index.html deleted file mode 100644 index 243f05f282..0000000000 --- a/files/ru/orphaned/web/javascript/reference/global_objects/map/size/index.html +++ /dev/null @@ -1,65 +0,0 @@ ---- -title: Map.prototype.size -slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/size -translation_of: Web/JavaScript/Reference/Global_Objects/Map/size -original_slug: Web/JavaScript/Reference/Global_Objects/Map/size ---- -<div>{{JSRef}}</div> - -<p>Геттер <code>size</code> возвращает количество элементов в объекте {{jsxref("Map")}}.</p> - -<p>{{EmbedInteractiveExample("pages/js/map-prototype-size.html")}}</p> - -<h2 id="Описание">Описание</h2> - -<p>Значение <code>size</code> - целое число, описывающее, сколько элементов имеет объект Map. У свойства <code>size</code> не определён сеттер: переопределить его нельзя.</p> - -<h2 id="Примеры">Примеры</h2> - -<h3 id="Использование_size">Использование <code>size</code></h3> - -<pre class="brush:js notranslate">var myMap = new Map(); -myMap.set("a", "альфа"); -myMap.set("b", "бета"); -myMap.set("g", "гамма"); - -myMap.size // 3 -</pre> - -<h2 id="Спецификации">Спецификации</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Specification</th> - <th scope="col">Status</th> - <th scope="col">Comment</th> - </tr> - <tr> - <td>{{SpecName('ES2015', '#sec-get-map.prototype.size', 'Map.prototype.size')}}</td> - <td>{{Spec2('ES2015')}}</td> - <td>Первое определение</td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-get-map.prototype.size', 'Map.prototype.size')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td></td> - </tr> - </tbody> -</table> - -<h2 id="Совместимость_с_браузерами">Совместимость с браузерами</h2> - -<p>{{Compat}}</p> - -<h2 id="Замечания_для_Gecko">Замечания для Gecko</h2> - -<ul> - <li>С версии Gecko 13 {{geckoRelease("13")}} до Gecko 18 {{geckoRelease("18")}} свойство <font face="consolas, Liberation Mono, courier, monospace"><span style="background-color: rgba(220, 220, 220, 0.5);">size</span></font> было методом <code>Map.prototype.size</code>, но это было изменено в поздних версиях чтобы соответствовать спецификации ECMAScript 2015 ({{bug("807001")}}).</li> -</ul> - -<h2 id="Смотрите_также">Смотрите также</h2> - -<ul> - <li>{{jsxref("Map")}}</li> -</ul> diff --git a/files/ru/orphaned/web/javascript/reference/global_objects/map/values/index.html b/files/ru/orphaned/web/javascript/reference/global_objects/map/values/index.html deleted file mode 100644 index 0cdf90c670..0000000000 --- a/files/ru/orphaned/web/javascript/reference/global_objects/map/values/index.html +++ /dev/null @@ -1,65 +0,0 @@ ---- -title: Map.prototype.values() -slug: orphaned/Web/JavaScript/Reference/Global_Objects/Map/values -translation_of: Web/JavaScript/Reference/Global_Objects/Map/values -original_slug: Web/JavaScript/Reference/Global_Objects/Map/values ---- -<div>{{JSRef}}</div> - -<p>Метод <code><strong>values()</strong></code> возвращает новый <strong><a href="/ru/docs/Web/JavaScript/Guide/Iterators_and_Generators">Итератор</a></strong>, содержащий значения каждого элемента в объекте {{jsxref("Map")}} в том порядке, в котором они были заведены.</p> - -<h2 id="Синтаксис">Синтаксис</h2> - -<pre class="syntaxbox"><code><em>myMap</em>.values()</code></pre> - -<h3 id="Возвращаемое_значение">Возвращаемое значение</h3> - -<p>Новый итератор объекта {{jsxref("Map")}}.</p> - -<h2 id="Примеры">Примеры</h2> - -<h3 id="Использование_values()">Использование <code>values()</code></h3> - -<pre class="brush:js">var myMap = new Map(); -myMap.set('0', 'foo'); -myMap.set(1, 'bar'); -myMap.set({}, 'baz'); - -var mapIter = myMap.values(); - -console.log(mapIter.next().value); // "foo" -console.log(mapIter.next().value); // "bar" -console.log(mapIter.next().value); // "baz"</pre> - -<h2 id="Спецификации">Спецификации</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Спецификация</th> - <th scope="col">Статус</th> - <th scope="col">Комментарий</th> - </tr> - <tr> - <td>{{SpecName('ES2015', '#sec-map.prototype.values', 'Map.prototype.values')}}</td> - <td>{{Spec2('ES2015')}}</td> - <td>Initial definition.</td> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-map.prototype.values', 'Map.prototype.values')}}</td> - <td>{{Spec2('ESDraft')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Поддержка_браузерами">Поддержка браузерами</h2> - -<p>{{Compat}}</p> - -<h2 id="Смотрите_также">Смотрите также</h2> - -<ul> - <li>{{jsxref("Map.prototype.entries()")}}</li> - <li>{{jsxref("Map.prototype.keys()")}}</li> -</ul> diff --git a/files/ru/orphaned/web/javascript/reference/global_objects/math/метод_math.max()_/index.html b/files/ru/orphaned/web/javascript/reference/global_objects/math/метод_math.max()_/index.html deleted file mode 100644 index 56c70fde75..0000000000 --- a/files/ru/orphaned/web/javascript/reference/global_objects/math/метод_math.max()_/index.html +++ /dev/null @@ -1,137 +0,0 @@ ---- -title: Метод Math.max() -slug: orphaned/Web/JavaScript/Reference/Global_Objects/Math/Метод_Math.max()_ -tags: - - JavaScript - - Math - - Method - - Reference -original_slug: Web/JavaScript/Reference/Global_Objects/Math/Метод_Math.max()_ ---- -<div>{{JSRef("Global_Objects", "Math")}}</div> - -<div> </div> - -<h2 id="Summary" name="Summary">Сводка</h2> - -<p>Метод <strong><code>Math.max()</code></strong> возвращает наибольшее из нуля или более чисел.</p> - -<h2 id="Syntax" name="Syntax">Синтаксис</h2> - -<pre class="syntaxbox"><code>Math.max([<var>value1</var>[, <var>value2</var>[, ...]]])</code></pre> - -<h3 id="Parameters" name="Parameters">Параметры</h3> - -<dl> - <dt><code>value1, value2, ...</code></dt> - <dd>Числа.</dd> -</dl> - -<h2 id="Description" name="Description">Описание</h2> - -<p>Поскольку метод <code>max()</code> является статическим методом объекта <code>Math</code>, вы всегда должны использовать его как <code>Math.max()</code>, а не пытаться вызывать метод на созданном экземпляре объекта <code>Math</code> (поскольку объект <code>Math</code> не является конструктором).</p> - -<p>При вызове без аргументов результатом вызова будет значение -{{jsxref("Global_Objects/Infinity", "Infinity")}}.</p> - -<p>Если хотя бы один из аргументов не может быть преобразован в число, результатом будет {{jsxref("Global_Objects/NaN", "NaN")}}.</p> - -<h2 id="Examples" name="Examples">Примеры</h2> - -<h3 id="Example:_Using_Math.max" name="Example:_Using_Math.max">Пример: использование метода <code>Math.max()</code></h3> - -<pre class="brush: js">Math.max(10, 20); // 20 -Math.max(-10, -20); // -10 -Math.max(-10, 20); // 20 -</pre> - -<p>Следующая функция использует метод {{jsxref("Function.prototype.apply()")}} для нахождения максимального элемента в числовом массиве. Вызов <code>getMaxOfArray([1, 2, 3])</code> эквивалентен вызову <code>Math.max(1, 2, 3)</code>, однако вы можете использовать функцию <code>getMaxOfArray()</code> вместе с программно сконструированными массивами любого размера.</p> - -<pre class="brush: js">function getMaxOfArray(numArray) { - return Math.max.apply(null, numArray); -} -</pre> - -<h2 id="Specifications" name="Specifications">Спецификации</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Спецификация</th> - <th scope="col">Статус</th> - <th scope="col">Комментарии</th> - </tr> - <tr> - <td>ECMAScript 1-е издание.</td> - <td>Стандарт</td> - <td>Изначальное определение. Реализована в JavaScript 1.0.</td> - </tr> - <tr> - <td>{{SpecName('ES5.1', '#sec-15.8.2.11', 'Math.max')}}</td> - <td>{{Spec2('ES5.1')}}</td> - <td> </td> - </tr> - <tr> - <td>{{SpecName('ES6', '#sec-math.max', 'Math.max')}}</td> - <td>{{Spec2('ES6')}}</td> - <td> </td> - </tr> - </tbody> -</table> - -<h2 id="Browser_compatibility" name="Browser_compatibility">Совместимость с браузерами</h2> - -<div>{{CompatibilityTable}}</div> - -<div id="compat-desktop"> -<table class="compat-table"> - <tbody> - <tr> - <th>Возможность</th> - <th>Chrome</th> - <th>Firefox (Gecko)</th> - <th>Internet Explorer</th> - <th>Opera</th> - <th>Safari</th> - </tr> - <tr> - <td>Базовая поддержка</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - </tr> - </tbody> -</table> -</div> - -<div id="compat-mobile"> -<table class="compat-table"> - <tbody> - <tr> - <th>Возможность</th> - <th>Android</th> - <th>Chrome для Android</th> - <th>Firefox Mobile (Gecko)</th> - <th>IE Mobile</th> - <th>Opera Mobile</th> - <th>Safari Mobile</th> - </tr> - <tr> - <td>Базовая поддержка</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - <td>{{CompatVersionUnknown}}</td> - </tr> - </tbody> -</table> -</div> - -<h2 id="See_also" name="See_also">Смотрите также</h2> - -<ul> - <li>{{jsxref("Math.min()")}}</li> -</ul> diff --git a/files/ru/orphaned/web/javascript/reference/operators/pipeline_operator/index.html b/files/ru/orphaned/web/javascript/reference/operators/pipeline_operator/index.html deleted file mode 100644 index 808573314a..0000000000 --- a/files/ru/orphaned/web/javascript/reference/operators/pipeline_operator/index.html +++ /dev/null @@ -1,78 +0,0 @@ ---- -title: Конвейерный оператор -slug: orphaned/Web/JavaScript/Reference/Operators/Pipeline_operator -tags: - - Experimental - - JavaScript - - Operator - - Оператор - - Экспериментальный -translation_of: Web/JavaScript/Reference/Operators/Pipeline_operator -original_slug: Web/JavaScript/Reference/Operators/Pipeline_operator ---- -<div>{{jsSidebar("Operators")}} {{SeeCompatTable}}</div> - -<p>Экспериментальный конвейерный оператор <code>|></code> (в настоящее время на этапе 1) позволяет создавать читаемые цепочки вызовов функций. В основном, конвейерный оператор предоставляет возможность вызова функции с одним аргументом, и позволяет написать:</p> - -<pre class="brush: js"><code>let url = "%21" |> decodeURI;</code> -</pre> - -<p>Эквивалентный вызов в традиционном синтаксисе выглядит следующим образом:</p> - -<pre class="brush: js"><code>let url = decodeURI("%21");</code> -</pre> - -<h2 id="Синтаксис">Синтаксис</h2> - -<pre class="syntaxbox"><em>выражение</em> |> <em>функция</em></pre> - -<p>Значение указанного <code>выражения</code> передаётся в <code>функцию</code> в качестве единственного параметра.</p> - -<h2 id="Примеры">Примеры</h2> - -<h3 id="Цепочки_вызовов_функций">Цепочки вызовов функций</h3> - -<p>Конвейерный оператор позволяет улучшить читаемость кода, в случае когда встречается цепочка из нескольких функций.</p> - -<pre class="brush: js">const double = (n) => n * 2; -const increment = (n) => n + 1; - -// без конвейерного оператора -double(increment(double(double(5)))); // 42 - -// с конвейерным оператором -5 |> double |> double |> increment |> double; // 42 -</pre> - -<h2 id="Спецификации">Спецификации</h2> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Спецификация</th> - <th scope="col">Статус</th> - <th scope="col">Comment</th> - </tr> - </thead> - <tbody> - <tr> - <td><a href="http://tc39.github.io/proposal-pipeline-operator/">Pipeline operator draft</a></td> - <td>Этап 1</td> - <td>Ещё не включён в спецификацию ECMAScript.</td> - </tr> - </tbody> -</table> - -<h2 id="Совместимость_с_браузерами">Совместимость с браузерами</h2> - -<div> - - -<p>{{Compat("javascript.operators.pipeline")}}</p> -</div> - -<h2 id="Смотрите_также">Смотрите также</h2> - -<ul> - <li><a href="https://github.com/tc39/proposals">TC39 proposals</a></li> -</ul> diff --git a/files/ru/orphaned/web/manifest/serviceworker/index.html b/files/ru/orphaned/web/manifest/serviceworker/index.html deleted file mode 100644 index 6a106855f1..0000000000 --- a/files/ru/orphaned/web/manifest/serviceworker/index.html +++ /dev/null @@ -1,88 +0,0 @@ ---- -title: serviceworker -slug: orphaned/Web/Manifest/serviceworker -tags: - - Manifest - - ServiceWorker - - Web -translation_of: Web/Manifest/serviceworker -original_slug: Web/Manifest/serviceworker ---- -<div>{{QuickLinksWithSubpages("/ru/docs/Web/Manifest")}}</div> - -<div>{{obsolete_header}}</div> - -<table class="properties"> - <tbody> - <tr> - <th scope="row">Type</th> - <td><code>Object</code></td> - </tr> - <tr> - <th scope="row">Mandatory</th> - <td>No</td> - </tr> - <tr> - <th scope="row">Example</th> - <td> - <pre class="brush: json no-line-numbers"> -"serviceworker": { - "src": "./serviceworker.js" -}</pre> - </td> - </tr> - </tbody> -</table> - -<p><dfn><code>serviceworker</code></dfn> описывает {{domxref('Service_Worker_API', 'рабочий сервис')}}, который разработчик намеревается установить для управления PWA.</p> - -<h2 id="Examples">Examples</h2> - -<pre class="brush: json">"serviceworker": { - "src": "./serviceworker.js", - "scope": "/app", - "type": "", - "update_via_cache": "none" -} -</pre> - -<h2 id="Значения">Значения</h2> - -<p>Сервисный работник может содержать следующие значения (требуется только src):</p> - -<table class="fullwidth-table standard-table"> - <thead> - <tr> - <th scope="col">Параметр</th> - <th scope="col">Описание</th> - </tr> - </thead> - <tbody> - <tr> - <td><code>src</code></td> - <td> - <p>URL-адрес для загрузки сценария рабочего сервиса. Это единственный обязательный параметр для <code>serviceworker</code>.</p> - </td> - </tr> - <tr> - <td><code>scope</code></td> - <td> - <p>Строка, представляющая URL, который определяет область регистрации рабочего сервиса; то есть, какой диапазон URL-адресов может контролировать рабочий сервис. Обычно это относительный URL-адрес, относительно базового URL-адреса приложения. По умолчанию в качестве области действия для регистрации рабочего сервиса задан каталог, в котором находится сценарий рабочий сервис.</p> - </td> - </tr> - <tr> - <td><code>type</code></td> - <td>?</td> - </tr> - <tr> - <td><code>update_via_cache</code></td> - <td> - <p>Нужно ли обходить кеш пользовательского агента при получении рабочего сервиса.</p> - </td> - </tr> - </tbody> -</table> - -<h2 id="Browser_compatibility">Browser compatibility</h2> - -<p>{{Compat("html.manifest.serviceworker")}}</p> diff --git a/files/ru/orphaned/web/mathml/element/mglyph/index.html b/files/ru/orphaned/web/mathml/element/mglyph/index.html deleted file mode 100644 index 1ebf808bba..0000000000 --- a/files/ru/orphaned/web/mathml/element/mglyph/index.html +++ /dev/null @@ -1,72 +0,0 @@ ---- -title: <mglyph> -slug: orphaned/Web/MathML/Element/mglyph -tags: - - MathML - - MathML:Element - - Глиф - - Символ -translation_of: Web/MathML/Element/mglyph -original_slug: Web/MathML/Element/mglyph ---- -<div>{{MathMLRef}}</div> - -<p class="summary">Элемент <code><mglyph></code> разметки MathML используется для отображения нестандартных символов там, где существующих символы Unicode недоступны. Его можно использовать в <a href="/en-US/docs/tag/MathML:Token%20Elements">элементах-токенах</a>.</p> - -<h2 id="Атрибуты">Атрибуты</h2> - -<dl> - <dt id="attr-alt">alt</dt> - <dd>Этот атрибут определяет альтернативный текст, описывающий изображение. Пользователи увидят этот текст, если URL адрес изображения неправильный, изображение не в одном из <a href="/ru/docs/Web/HTML/Element/img#Поддерживаемые_форматы_изображений">поддерживаемых форматов</a> или пока изображение не будет загружено.</dd> - <dt id="attr-class-id-style">class, id, style</dt> - <dd>Предусмотрено для использования с <a href="/ru/docs/Web/CSS">таблицами стилей</a>.</dd> - <dt id="attr-height">height</dt> - <dd>Высота изображения.</dd> - <dt id="attr-href">href</dt> - <dd>Используется для установки гиперссылки на указанный URI.</dd> - <dt id="attr-mathbackground">mathbackground</dt> - <dd>Цвет фона (если изображение имеет прозрачность). Вы можете использовать <code>#rgb</code>, <code>#rrggbb</code> и <a href="/ru/docs/Web/CSS/color_value">имена цветов HTML</a>.</dd> - <dt id="attr-src">src</dt> - <dd>URL изображения.</dd> - <dt id="attr-valign">valign</dt> - <dd>Задаёт вертикальное выравнивание относительно текущей базовой линии.</dd> - <dt id="attr-width">width</dt> - <dd>Ширина изображения.</dd> -</dl> - -<h2 id="Пример">Пример</h2> - -<pre class="brush: html notranslate"><math> - <mi><mglyph src="my-glyph.png" alt="my glyph"/></mi> -</math> -</pre> - -<h2 id="Спецификации">Спецификации</h2> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Спецификация</th> - <th scope="col">Статус</th> - <th scope="col">Комментарий</th> - </tr> - </thead> - <tbody> - <tr> - <td>{{ SpecName('MathML3', 'chapter3.html#presm.mglyph', 'mglyph') }}</td> - <td>{{ Spec2('MathML3') }}</td> - <td>Текущая спецификация</td> - </tr> - <tr> - <td>{{ SpecName('MathML2', 'chapter3.html#presm.mglyph', 'mglyph') }}</td> - <td>{{ Spec2('MathML2') }}</td> - <td>Начальная спецификация</td> - </tr> - </tbody> -</table> - -<h2 id="Совместимость_с_браузерами">Совместимость с браузерами</h2> - - - -<p>{{Compat("mathml.elements.mglyph")}}</p> diff --git a/files/ru/orphaned/web/reference/api/index.html b/files/ru/orphaned/web/reference/api/index.html deleted file mode 100644 index 8546d57b3c..0000000000 --- a/files/ru/orphaned/web/reference/api/index.html +++ /dev/null @@ -1,66 +0,0 @@ ---- -title: Руководство Web API -slug: orphaned/Web/Reference/API -tags: - - API - - Web - - Руководство - - Справка -translation_of: Web/Reference/API -original_slug: Web/Reference/API ---- -<p><span class="seoSummary">Веб предлагает широкий спектр интерфейсов для выполнения различных полезных задач. Они могут быть доступны с помощью кода JavaScript, и путём внесения незначительных корректив в объекты {{domxref("window")}} или {{domxref("element")}}. Для создания сложной графики и аудио эффектов используются такие интерфейсы как <a href="/ru/docs/Web/WebGL">WebGL</a> и <a href="/ru/docs/Web_Audio_API">Web Audio</a>.</span></p> - -<p><a href="/ru/docs/Web/API">Описание всех интерфейсов (APIs).</a></p> - -<p><a href="/ru/docs/Web/Reference/Events">Описание доступных событий (events).</a></p> - -<div class="cleared topicpage-table"> -<div class="section"> -<dl> - <dt><a href="/ru/docs/DOM">Объектная модель документа (DOM).</a></dt> - <dd>DOM имеет интерфейс (API) который предоставляет возможность доступа к любой части документа. Эта модель позволяет осуществлять манипуляции над целыми разделами документа {{domxref("Node")}} и отдельными элементами {{domxref("Element")}}. Такие форматы как: HTML, XML и SVG используют её для решения своих специфических задач.</dd> - <dt>Аппаратные интерфейсы</dt> - <dd>Этот набор методов позволяет получить доступ из веб-страницы или приложения к различным датчикам устройства. Например: <a href="/ru/docs/WebAPI/Using_Light_Events">Ambient Light Sensor API</a>, <a href="/ru/docs/WebAPI/Battery_Status" title="WebAPI/Battery_Status">Battery Status API</a>, <a href="/ru/docs/Using_geolocation" title="Using_geolocation">Geolocation API</a>, <a href="/ru/docs/WebAPI/Pointer_Lock" title="API/Pointer_Lock_API">Pointer Lock API</a>, <a href="/ru/docs/WebAPI/Proximity" title="WebAPI/Proximity">Proximity API</a>, <a href="/ru/docs/WebAPI/Detecting_device_orientation" title="WebAPI/Detecting_device_orientation">Device Orientation API</a>, <a href="/ru/docs/WebAPI/Managing_screen_orientation" title="WebAPI/Detecting_device_orientation">Screen Orientation API</a>, <a href="/ru/docs/WebAPI/Vibration" title="WebAPI/WebBluetooth">Vibration API</a>.</dd> - <dt>Интерфейсы связи</dt> - <dd>Эти интерфейсы обеспечивают коммуникацию между веб-страницами и приложениями с другими страницами или устройствами. Такие как, <a href="/ru/docs/WebAPI/Network_Information" title="WebAPI/Network_Information">Network Information API</a>, <a href="/ru/docs/WebAPI/Using_Web_Notifications" title="/ru/docs/WebAPI/Using_Web_Notifications">Web Notifications</a>, <a href="/ru/docs/WebAPI/Simple_Push" title="WebAPI/Push_Notifications">Simple Push API</a>.</dd> - <dt id="Data_management_APIs">Интерфейсы управления данными</dt> - <dd>Пользовательские данные могут храниться и управляться этими интерфейсами. Например, <a href="/ru/docs/WebAPI/FileHandle_API" title="WebAPI/FileHandle_API">FileHandle API</a>, <a href="/ru/docs/IndexedDB" title="IndexedDB">IndexedDB</a>.</dd> -</dl> - -<p>В дополнение к описанным возможностям, которые доступны для любого веб-сайта или приложения, существует более мощная функциональность Mozilla, доступная для привилегированных и сертифицированных приложений.</p> - -<dl> - <dt>Привилегированные интерфейсы</dt> - <dd>При установке приложения от пользователя потребуется дать приложению специфичные права. Включают в себя: <a href="/ru/docs/WebAPI/TCP_Socket" title="WebAPI/TCP_Socket">TCP Socket API</a>, <a href="/ru/docs/WebAPI/Contacts" title="WebAPI/Contacts">Contacts API</a>, <a href="/ru/docs/WebAPI/Device_Storage_API" title="WebAPI/Device_Storage_API">Device Storage API</a>, <a href="/ru/docs/DOM/Using_the_Browser_API" title="DOM/Using_the_Browser_API">Browser API</a>, <a href="/ru/docs/WebAPI/Camera" title="WebAPI/Camera">Camera API</a>.</dd> -</dl> - -<dl> - <dt>Сертифицированная функциональность</dt> - <dd>Сертифицированное приложение является приложением низкого уровня выполнения критических операций на операционной системе как Firefox OS. Менее привилегированные взаимодействуют с приложениями использующими <a href="/ru/docs/WebAPI/Web_Activities" title="WebAPI/Web_Activities">Web Activities</a>. Сертифицированные API, включают в себя:<a href="/ru/docs/WebAPI/WebBluetooth" title="WebAPI/WebBluetooth"> Bluetooth API</a>, <a href="/ru/docs/WebAPI/Mobile_Connection" title="WebAPI/Mobile_Connection">Mobile Connection API</a>, <a href="/ru/docs/WebAPI/Network_Stats" title="WebAPI/Network_Stats">Network Stats API</a>, <a href="/ru/docs/WebAPI/WebTelephony" title="WebAPI/WebTelephony">Telephony</a>, <a href="/ru/docs/WebAPI/WebSMS" title="WebAPI/WebSMS">WebSMS</a>, <a href="/ru/docs/WebAPI/WiFi_Information" title="WebAPI/WiFi_Information">WiFi Information API</a>, <a href="/ru/docs/WebAPI/Camera" title="WebAPI/Camera">Camera API</a>, <a href="/ru/docs/WebAPI/Power_Management" title="WebAPI/Power_Management">Power Management API</a>, <a href="/ru/docs/WebAPI/Settings" title="WebAPI/Settings">Settings API</a>, <a href="/ru/docs/WebAPI/Idle" title="WebAPI/Device_Storage_API">Idle API</a>, <a href="/ru/docs/WebAPI/Permissions" title="WebAPI/Permissions">Permissions API</a>, <a href="/ru/docs/WebAPI/Time_and_Clock" title="WebAPI/Time_and_Clock">Time/Clock API</a>.</dd> -</dl> -</div> - -<div class="section"> -<h2 class="Community" id="Сообщество">Сообщество</h2> - -<p>Присоединяйтесь к Web API сообществу в нашем списке рассылки или группе новостей:</p> - -<ul> - <li><a class="external" href="https://lists.mozilla.org/listinfo/dev-webapi">список рассылки</a></li> - <li><a href="news://news.mozilla.org/mozilla.dev.webapi">группа новостей</a></li> - <li><a class="external" href="http://groups.google.com/group/mozilla.dev.webapi">Google Groups</a></li> - <li><a class="external" href="http://groups.google.com/group/mozilla.dev.webapi/feeds">Веб лента новостей</a></li> -</ul> - -<p>Кроме того, убедитесь, что участвуете в живой дискуссии в <a href="irc://irc.mozilla.org/webapi">#webapi</a> направление <a class="external" href="https://wiki.mozilla.org/IRC">IRC</a>.</p> - -<h2 class="Related_Topics" id="Связанные_темы">Связанные темы</h2> - -<p>Эти темы также могут вас заинтересовать:</p> - -<ul> - <li><a href="/ru/docs/Web/API">Список всех Веб-интерфейсов</a></li> -</ul> -</div> -</div> diff --git a/files/ru/orphaned/web/reference/index.html b/files/ru/orphaned/web/reference/index.html deleted file mode 100644 index a0526e8ca1..0000000000 --- a/files/ru/orphaned/web/reference/index.html +++ /dev/null @@ -1,41 +0,0 @@ ---- -title: Справочник по веб-технологиям -slug: orphaned/Web/Reference -tags: - - Русский -translation_of: Web/Reference -original_slug: Web/Reference ---- -<p>{{draft()}}</p> - -<p><span id="result_box" lang="ru"><span>Открытая сеть построена с использованием ряда технологий.</span> <span>Ниже вы найдёте ссылки на наши справочные материалы по каждому из них.</span></span></p> - -<div class="row topicpage-table"> -<div class="section"> -<h2 class="Documentation" id="Docs_for_add-on_developers" name="Docs_for_add-on_developers"><span class="short_text" id="result_box" lang="ru"><span>Основные веб-технологии</span></span></h2> - -<dl> - <dt><a href="/en-US/docs/Web/API">Ссылка на веб-интерфейс API</a></dt> - <dd><span id="result_box" lang="ru"><span>Справочные материалы для каждого из интерфейсов, которые составляют API-интерфейсы Интернета, включая DOM и все связанные API и интерфейсы, которые вы можете использовать для создания веб-контента и приложений.</span> <span>Этот список охватывает все интерфейсы, расположенные в алфавитном порядке.</span></span></dd> - <dt><a href="/en-US/docs/Web/Reference/API" title="/en-US/docs/Web/Reference/API">Web APIs</a></dt> - <dd>Список различных интерфейсов и набора технологий,<br> - которые составляют общий Веб API.</dd> - <dt><a href="/en-US/docs/Web/HTML" title="/en-US/docs/Web/HTML">HTML</a></dt> - <dd>Язык гипертекстовой разметки — это язык, используемый для определения структуры и описания содержания веб-страницы в структурированной форме.</dd> - <dt><a href="/en-US/docs/Web/CSS" title="/en-US/docs/Web/CSS">CSS</a></dt> - <dd>Каскадные таблицы стилей используются для описания внешнего вида веб-контента.</dd> - <dt><a href="/en-US/docs/Web/SVG" title="/en-US/docs/Web/SVG">SVG</a></dt> - <dd>Масштабируемая векторная графика позволяет вам описать изображение как набор векторов (линий) и фигур, что позволяет масштабировать такую графику плавно независимо от размеров, в которых она нарисована без потерь качества.</dd> - <dt><a href="/en-US/docs/Web/MathML" title="/en-US/docs/Web/MathML">MathML</a></dt> - <dd><span id="result_box" lang="ru"><span>Математический язык разметки позволяет отображать сложные математические уравнения и синтаксис.</span></span></dd> -</dl> -</div> - -<div class="section"> -<h2 class="Documentation" id="Docs_for_add-on_developers" name="Docs_for_add-on_developers"><span class="short_text" id="result_box" lang="ru"><span>Другие технологии</span></span></h2> - -<p><span class="short_text" id="result_box" lang="ru"><span>Скоро будет завершено...</span></span></p> -</div> -</div> - -<p> </p> diff --git a/files/ru/orphaned/web/security/information_security_basics/index.html b/files/ru/orphaned/web/security/information_security_basics/index.html deleted file mode 100644 index b958b29047..0000000000 --- a/files/ru/orphaned/web/security/information_security_basics/index.html +++ /dev/null @@ -1,31 +0,0 @@ ---- -title: Основы по информационной безопасности -slug: orphaned/Web/Security/Information_Security_Basics -translation_of: Web/Security/Information_Security_Basics -original_slug: Web/Security/Information_Security_Basics ---- -<p><span class="seoSummary">Базовое понимание информационной безопасности, поможет обезопасить ваше программное обеспечение и сайты от уязвимостей открывающим доступ к финансовым махинациям и прочим противоправным действиям. Из этих статей вы сможете узнать всё что для этого необходимо.</span> Вооружившись этой информацией, вы поймёте роль и важность безопасности начиная от цикла веб-разработки вплоть до размещения вашего контента. </p> - -<dl> - <dt><a href="/en-US/docs/Web/Security/Information_Security_Basics/Confidentiality,_Integrity,_and_Availability">Конфиденциальность, целостность и доступность</a></dt> - <dd>Статья описывает фундаментальные понятия по главным задачам безопасности</dd> - <dt><a href="/en-US/docs/Web/Security/Information_Security_Basics/Vulnerabilities">Уязвимости</a></dt> - <dd>Определяет основные категории уязвимостей и рассказывает о их существовании в программном обеспечении</dd> - <dt><a href="/en-US/docs/Web/Security/Information_Security_Basics/Threats">Угрозы</a></dt> - <dd>Вкратце знакомит с основными принципами угроз</dd> - <dt><a href="/en-US/docs/Web/Security/Information_Security_Basics/Security_Controls">Контроль безопасности</a> </dt> - <dd>Определяет основные категории контроля безопасности и рассказывает о их потенциальных слабостях</dd> - <dt><a href="/en-US/docs/Web/Security/Information_Security_Basics/TCP_IP_Security">Безопасность TCP/IP</a></dt> - <dd>Обзор TCP/IP модели, с упором на вопросы безопасности для SSL</dd> -</dl> - -<h2 id="Смотрите_также">Смотрите также</h2> - -<ul> - <li><a href="/en-US/docs/Mozilla/Security">Браузерная безопасность</a></li> - <li><a href="/en-US/docs/Web/Security">Сетевая безопасность</a></li> - <li><a href="/en-US/docs/Web/Security/Securing_your_site">Безопасность вашего сайта</a></li> - <li><a href="/en-US/docs/Security/Firefox_Security_Basics_For_Developers">Основы безопасности в Firefox для Разработчиков</a></li> -</ul> - -<p>{{QuickLinksWithSubpages("/en-US/docs/Web/Security")}}</p> diff --git a/files/ru/orphaned/web/svg/attribute/onload/index.html b/files/ru/orphaned/web/svg/attribute/onload/index.html deleted file mode 100644 index 8c73972cde..0000000000 --- a/files/ru/orphaned/web/svg/attribute/onload/index.html +++ /dev/null @@ -1,6 +0,0 @@ ---- -title: onload -slug: orphaned/Web/SVG/Attribute/onload -original_slug: Web/SVG/Attribute/onload ---- -<p>Link not exist</p> diff --git a/files/ru/orphaned/xml_in_mozilla/index.html b/files/ru/orphaned/xml_in_mozilla/index.html deleted file mode 100644 index 513994d558..0000000000 --- a/files/ru/orphaned/xml_in_mozilla/index.html +++ /dev/null @@ -1,57 +0,0 @@ ---- -title: XML in Mozilla -slug: orphaned/XML_in_Mozilla -original_slug: XML_in_Mozilla ---- -<p>Поведение метода length объекта XML в браузерах IE и Mozilla</p> -<p>Непредвиденное поведение метода определяющего количество элементов в коллекции в браузере Mozilla.</p> -<p>Имеем XML документ с разным количеством вложенных элементов, пример:</p> -<p><root></p> -<br> -<p> <books></p> -<br> -<p> <title></title></p> -<br> -<p> <aftor></aftor></p> -<br> -<p> <page></page></p> -<br> -<p> <note></p> -<br> -<p> <first></first></p> -<br> -<p> <second></second></p> -<br> -<p> </note></p> -<br> -<p> <note></p> -<br> -<p> <first></first></p> -<br> -<p> <second></second></p> -<br> -<p> </note></p> -<br> -<p> </books></p> -<br> -<p> <books></p> -<br> -<p> <title></title></p> -<br> -<p> <aftor></aftor></p> -<br> -<p> <page></page></p> -<br> -<p> <note></p> -<br> -<p> <first></first></p> -<br> -<p> <second></second></p> -<br> -<p> </note></p> -<br> -<p> </books></p> -<br> -<p></root></p> -<p> </p> -<p>Казалось, при определении количества дочерних элементов у элемента <root> должны получить - 2, а получаем вместо этого количество вложений элементов в XML файле - 5, причём в IE данный метод (length) ведёт себя корректно. Ищу пути решения образовавшегося вопроса, если у кого-то есть предложения, буду рад узнать. Заранее спасибо.</p> diff --git a/files/ru/orphaned/xpcnativewrapper/index.html b/files/ru/orphaned/xpcnativewrapper/index.html deleted file mode 100644 index bd4a4ec19f..0000000000 --- a/files/ru/orphaned/xpcnativewrapper/index.html +++ /dev/null @@ -1,109 +0,0 @@ ---- -title: XPCNativeWrapper -slug: orphaned/XPCNativeWrapper -tags: - - DOM - - XPCNativeWrapper - - Безопасность - - Расширения -original_slug: XPCNativeWrapper ---- -<p> </p> -<p><code>XPCNativeWrapper</code> позволяет так обернуть объект, чтобы доступ к нему был <a href="/en/Safely_accessing_content_DOM_from_chrome">безопасен для привилегированного кода</a>. Эта обёртка может быть использована во всех версиях, хотя её поведение слегка изменилось начиная с <span>Firefox 1.5</span> (<span>Gecko 1.8</span>). Информацию о поведении <code>XPCNativeWrapper</code> в <span>Firefox</span> версий младше 1.5 можно получить из <a class="external" href="http://kb.mozillazine.org/XPCNativeWrapper">статьи о <code>XPCNativeWrapper</code> в <span>MozillaZine KnowledgeBase</span></a>. Эта же статья посвящена <code>XPCNativeWrapper</code> в <span>Firefox</span> версий 1.5 и выше.</p> -<h3 id=".D0.A7.D1.82.D0.BE_.D0.B4.D0.B5.D0.BB.D0.B0.D0.B5.D1.82_XPCNativeWrapper" name=".D0.A7.D1.82.D0.BE_.D0.B4.D0.B5.D0.BB.D0.B0.D0.B5.D1.82_XPCNativeWrapper">Что делает <code>XPCNativeWrapper</code></h3> -<p>An <code>XPCNativeWrapper</code> limits access to the properties and methods of the object it wraps. The only properties and methods accessible through an <code>XPCNativeWrapper</code> are those that are defined in IDL or defined by DOM Level 0 (though some DOM Level 0 properties and methods <a href="#Limitations_of_XPCNativeWrapper">do not work on an <code>XPCNativeWrapper</code></a>). In particular, properties added to an object via JavaScript are not exposed by an <code>XPCNativeWrapper</code> for this object, and nor are getters and setters defined with <code>__defineGetter__</code> and <code>__defineSetter__</code>. The intent is to allow safe access to the IDL-defined methods of the object.</p> -<p>Please make sure to read the <a href="#Known_Bugs">known bugs</a> section, especially when writing code targeted at a range of 1.5.0.x Firefox releases.</p> -<h3 id=".D0.A2.D0.B8.D0.BF.D1.8B_XPCNativeWrapper" name=".D0.A2.D0.B8.D0.BF.D1.8B_XPCNativeWrapper">Типы <code>XPCNativeWrapper</code></h3> -<p>There are three different types of <code>XPCNativeWrapper</code> in Firefox 1.5. All three types wrap a possibly-unsafe object and <a href="#What_XPCNativeWrapper_does">provide safe access to its properties and methods</a>.</p> -<p>The differences in behavior between the three types of <code>XPCNativeWrapper</code> are determined by two characteristics an <code>XPCNativeWrapper</code> wrapper can have. An <code>XPCNativeWrapper</code> can be <a href="#Explicit_vs._Implicit"><em>explicit</em></a> (or the opposite, <em>implicit</em>) and can be <a href="#Deep_vs._Shallow"><em>deep</em></a> (or the opposite, <em>shallow</em>). The type of wrapper created is determined by <a href="#Creating_XPCNativeWrapper_objects">the way it was created</a> as follows:</p> -<table> <tbody> <tr> <th>Created by</th> <th>Explicit/Implicit</th> <th>Deep/Shallow</th> </tr> <tr> <th><a href="#Protected_script_accessing_an_untrusted_object">Protected script accessing an untrusted object</a></th> <td>Implicit</td> <td>Deep</td> </tr> <tr> <th><a href="#XPCNativeWrapper_constructor_call_with_string_arguments">Constructor called with string arguments</a></th> <td>Explicit</td> <td>Shallow</td> </tr> <tr> <th><a href="#XPCNativeWrapper_constructor_call_with_no_string_arguments">Constructor called with no string arguments</a></th> <td>Explicit</td> <td>Deep</td> </tr> </tbody> -</table> -<h4 id="Explicit_vs._Implicit" name="Explicit_vs._Implicit">Explicit vs. Implicit</h4> -<p>The difference in behavior between explicit and implicit <code>XPCNativeWrapper</code> is that a property access on an implicit <code>XPCNativeWrapper</code> from script that is not <a href="#What_is_a_protected_script.3F">protected</a> is NOT safe. The property access will be forwarded through to the <code>wrappedJSObject</code> of the <code>XPCNativeWrapper</code>.</p> -<p>This means that scripts that are not <a href="#What_is_a_protected_script.3F">protected</a> don't need to worry about bugs arising because other code hands them an implicit <code>XPCNativeWrapper</code>. On the other hand, such scripts do need to watch out for unsafe object access.</p> -<p>Property access on an explicit <code>XPCNativeWrapper</code> is safe no matter whether the caller is <a href="#What_is_a_protected_script.3F">protected</a>.</p> -<h4 id="Deep_vs._Shallow" name="Deep_vs._Shallow">Deep vs. Shallow</h4> -<p>The difference in behavior between deep and shallow <code>XPCNativeWrapper</code> is that when a property is accessed or a function is called on a deep wrapper the return value will be wrapped in a <code>XPCNativeWrapper</code> of its own. The new <code>XPCNativeWrapper</code> will also be deep and it will be <a href="#Explicit_vs._Implicit">explicit</a> if and only if the <code>XPCNativeWrapper</code> whose property is accessed was explicit. By contrast, when a property is accessed or a function is called on a shallow wrapper, the return value may be an unsafe object.</p> -<p>For example, say we are given three instances of <code>XPCNativeWrapper</code> for the same window object. Let us call them <code>deepExplicitWindow</code>, <code>deepImplicitWindow</code> and <code>shallowWindow</code>. Then we have:</p> -<pre class="eval">var doc1 = deepExplicitWindow.document; -// doc1 is now a deep explicit <code>XPCNativeWrapper</code> for -// the document object. Accessing doc1.open(), say, is safe. -</pre> -<pre class="eval">var doc2 = deepImplicitWindow.document; -// If the caller has xpcnativewrappers=yes set, doc2 is now a deep -// implicit <code>XPCNativeWrapper</code> for the document object. -// Otherwise doc2 is now the unsafe document object, since the -// property access was simply passed along to the unsafe window object. -</pre> -<pre class="eval">var doc3 = shallowWindow.document; -// doc3 is now the unsafe document object. -</pre> -<h3 id=".D0.A1.D0.BE.D0.B7.D0.B4.D0.B0.D0.BD.D0.B8.D0.B5_.D0.BE.D0.B1.D1.8A.D0.B5.D0.BA.D1.82.D0.BE.D0.B2_XPCNativeWrapper" name=".D0.A1.D0.BE.D0.B7.D0.B4.D0.B0.D0.BD.D0.B8.D0.B5_.D0.BE.D0.B1.D1.8A.D0.B5.D0.BA.D1.82.D0.BE.D0.B2_XPCNativeWrapper">Создание объектов <code>XPCNativeWrapper</code></h3> -<p>Существует три различных способа создания объекта <code>XPCNativeWrapper</code>; по одному способу на каждый из трёх типов.</p> -<h4 id="Protected_script_accessing_an_untrusted_object" name="Protected_script_accessing_an_untrusted_object">Protected script accessing an untrusted object</h4> -<p>Any time a <a href="#What_is_a_protected_script.3F">protected script</a> accesses an <a href="#What_is_an_untrusted_object.3F">untrusted object</a> it will get back an <a href="#Explicit_vs._Implicit">implicit</a> <a href="#Deep_vs._Shallow">deep</a> <code>XPCNativeWrapper</code>. Accessing properties of this <code>XPCNativeWrapper</code> is safe from <a href="#What_is_a_protected_script.3F">protected scripts</a>.</p> -<p>A wrapper created in this way will stick around as long as the object being wrapped does and accessing an object twice in a row will give the same <code>XPCNativeWrapper</code>.</p> -<h5 id="What_is_a_protected_script.3F" name="What_is_a_protected_script.3F">What is a protected script?</h5> -<p>In Firefox versions 1.5 through 1.5.0.5, a script is protected or not protected based solely on its URI. A script is protected only if its URI starts with a known protected prefix; scripts not loaded by URI (e.g. JavaScript-implemented components) are not protected. The protected prefixes in Firefox 1.5 are determined by the Chrome Registry.</p> -<p>By default, <strong>all content packages are protected</strong>. This means that all URIs that start "<code>chrome://<package name>/content/</code>" (for any package) are protected. Individual packages can <a href="/ru/Chrome_Registration#xpcnativewrappers" title="ru/Chrome_Registration#xpcnativewrappers">override this using a flag</a> in their chrome manifest file.</p> -<p>Starting with Firefox 1.5.0.6, JavaScript-implemented components are protected scripts. So a script is protected if it's either loaded from a URI which starts with a protected prefix or is a JavaScript-implemented component.</p> -<h5 id="What_is_an_untrusted_object.3F" name="What_is_an_untrusted_object.3F">What is an untrusted object?</h5> -<p>All objects are either trusted or untrusted. An object is trusted if any of the following hold:</p> -<ol> <li>Its parent (<code>__parent__</code> property in JavaScript) is a trusted object.</li> <li>It is the root scope object for a JavaScript component.</li> <li>It is the window object for a <a href="#What_is_a_trusted_window.3F">trusted window</a>.</li> -</ol> -<p>Since all DOM objects in a window have the window on their <code>__parent__</code> chain, they will be trusted if and only if their window is trusted.</p> -<h5 id="What_is_a_trusted_window.3F" name="What_is_a_trusted_window.3F">What is a trusted window?</h5> -<p>Whether a window is trusted depends on its container. A window is trusted if any of the following holds:</p> -<ol> <li>It is a top-level window (e.g. <code><xul:window></code>, <code><xul:dialog></code>, or some URI passed to the <code>-chrome</code> command-line flag).</li> <li>Its parent is trusted, and one of the following three options holds: <ol> <li>It is not loaded in a <code><xul:iframe></code> or <code><xul:browser></code>.</li> <li>The <code><xul:iframe></code> or <code><xul:browser></code> loading it doesn't have a "type" attribute.</li> <li>The value of the "type" attribute of the <code><xul:iframe></code> or <code><xul:browser></code> loading it is not "content" and does not start with "content-".</li> </ol> </li> -</ol> -<p>Note that whether a window is trusted does <strong>not</strong> depend on the URI loaded in the window. So for example, the following would create trusted windows when used inside a document whose window is already trusted:</p> -<ul> <li><code><xul:browser></code></li> <li><code><xul:browser type="chrome"></code></li> <li><code><xul:browser type="rabid_dog"></code></li> <li><code><xul:iframe type="foofy"></code></li> <li><code><html:iframe></code></li> <li><code><html:iframe type="content"></code></li> -</ul> -<p>The following would not create trusted windows:</p> -<ul> <li><code><xul:browser type="content"></code></li> <li><code><xul:iframe type="content-primary"></code></li> -</ul> -<p>Further note that any child window of an untrusted window is automatically untrusted.</p> -<h5 id="What_happens_when_a_script_accesses_an_object.3F" name="What_happens_when_a_script_accesses_an_object.3F">What happens when a script accesses an object?</h5> -<p>The table below describes what happens when a script accesses an object, and how the wrapper is involved.</p> -<table> <tbody> <tr> <th>Script</th> <th>Object</th> <th>Effects</th> </tr> <tr> <td>Protected</td> <td>Trusted</td> <td>No wrapper is created and therefore the script gets full access to the object.</td> </tr> <tr> <td>Protected</td> <td>Untrusted</td> <td>An <a href="#Explicit_vs._Implicit">implicit</a> <a href="#Deep_vs._Shallow">deep</a> <code>XPCNativeWrapper</code> is created.</td> </tr> <tr> <td>Unprotected</td> <td>Trusted</td> <td>No wrapper is created, just as in the protected/trusted case.</td> </tr> <tr> <td>Unprotected</td> <td>Untrusted</td> <td>No wrapper is created, just as in the protected/trusted case.</td> </tr> </tbody> -</table> -<h4 id="XPCNativeWrapper_constructor_call_with_string_arguments" name="XPCNativeWrapper_constructor_call_with_string_arguments"><code>XPCNativeWrapper</code> constructor call with string arguments</h4> -<p>For example:</p> -<pre class="eval">var contentWinWrapper = new XPCNativeWrapper(content, - "document"); -</pre> -<p>This creates an <a href="#Explicit_vs._Implicit">explicit</a> <a href="#Deep_vs._Shallow">shallow</a> <code>XPCNativeWrapper</code>. This syntax has been kept for compatibility with versions prior to Firefox 1.5. While all properties of the <code>contentWinWrapper</code> object can now be safely accessed, the return values of these properties are NOT safe to access (just like in versions prior to Firefox 1.5), since the <code>XPCNativeWrapper</code> is <a href="#Deep_vs._Shallow">shallow</a>. So to compare the content document title to the current content selection, one must do:</p> -<pre class="eval">var winWrapper = new XPCNativeWrapper(content, "document", - "getSelection()"); -var docWrapper = new XPCNativeWrapper(winWrapper.document, - "title"); -return docWrapper.title == winWrapper.getSelection(); -</pre> -<p>just like in versions before Firefox 1.5. Note that the <code>"getSelection()"</code> argument is not strictly needed here; if the code is not intended for use with Firefox versions before 1.5 it can be removed. A single string argument after the object being wrapped is all that is required for Firefox 1.5 to create this type of <code>XPCNativeWrapper</code>.</p> -<h4 id="XPCNativeWrapper_constructor_call_with_no_string_arguments" name="XPCNativeWrapper_constructor_call_with_no_string_arguments"><code>XPCNativeWrapper</code> constructor call with no string arguments</h4> -<p>For example:</p> -<pre class="eval">var contentWinWrapper = new XPCNativeWrapper(content); -</pre> -<p>This creates an <a href="#Explicit_vs._Implicit">explicit</a> <a href="#Deep_vs._Shallow">deep</a> <code>XPCNativeWrapper</code>. Accessing properties of this <code>XPCNativeWrapper</code> is safe, and the return values will also be wrapped in <a href="#Explicit_vs._Implicit">explicit</a> <a href="#Deep_vs._Shallow">deep</a> <code>XPCNativeWrapper</code> objects.</p> -<h3 id="Setting_.22expando.22_properties_on_XPCNativeWrapper" name="Setting_.22expando.22_properties_on_XPCNativeWrapper">Setting "expando" properties on <code>XPCNativeWrapper</code></h3> -<p>It is possible to set "expando" properties (properties with names that don't correspond to IDL-defined properties) on <code>XPCNativeWrapper</code> objects. If this is done, then chrome will be able to see these expando properties, but content will not be able to. <strong>There is no safe way to set an expando property from chrome and have it be readable from content.</strong></p> -<h3 id="XPCNativeWrapper_lifetime" name="XPCNativeWrapper_lifetime"><code>XPCNativeWrapper</code> lifetime</h3> -<p>Explicit <code>XPCNativeWrapper</code> objects exist while they are referenced. Creating a new explicit <code>XPCNativeWrapper</code> for the same possibly-unsafe object will create a new wrapper object; something to watch out for when <a href="#Setting_.22expando.22_properties_on_XPCNativeWrapper">setting "expando" properties</a></p> -<p>Implicit <code>XPCNativeWrapper</code> objects have the same lifetime as the object they're wrapping.</p> -<h3 id="Accessing_unsafe_properties" name="Accessing_unsafe_properties">Accessing unsafe properties</h3> -<p>If unsafe access to a property is required for some reason, this can be accomplished via the <code>wrappedJSObject</code> property of the wrapper. For example, if <code>docWrapper</code> is a wrapper for <code>doc</code>, then</p> -<pre class="eval">docWrapper.wrappedJSObject.prop -</pre> -<p>is the same as</p> -<pre class="eval">doc.prop -</pre> -<h3 id=".D0.98.D0.B7.D0.B2.D0.B5.D1.81.D1.82.D0.BD.D1.8B.D0.B5_.D0.BE.D1.88.D0.B8.D0.B1.D0.BA.D0.B8" name=".D0.98.D0.B7.D0.B2.D0.B5.D1.81.D1.82.D0.BD.D1.8B.D0.B5_.D0.BE.D1.88.D0.B8.D0.B1.D0.BA.D0.B8">Известные ошибки</h3> -<p>Известны две ошибки реализации <code>XPCNativeWrapper</code> в версиях 1.5.0.x:</p> -<ol> <li>Firefox с версии 1.5 по версию 1.5.0.4 содержит {{ Bug(337095) }}, в результате чего в некоторых случаях для защищённых скриптов не создаются обёртки. А именно, если из защищённого скрипта происходит обращение к свойству или вызов функции, которые возвращают недоверенный (<span>untrusted</span>) объект, обёртка будет создана. Однако, если функция в защищённом скрипте вызывается из C++, и в качестве аргумента этой функции передаётся недоверенный объект, обёртка <em>не</em> будет создана. Поэтому функции, которые могут быть вызваны подобным образом, <a href="#XPCNativeWrapper_constructor_call_with_no_string_arguments">должны сами производить обёртывание</a>. Эта ошибка исправлена в Firefox версии 1.5.0.5 и выше.</li> <li>Firefox с версии 1.5 по версию 1.5.0.5 содержит {{ Bug(345991) }}, в результате чего компоненты написанные на JavaScript не могут быть защищёнными скриптами. Эта ошибка исправлена в Firefox версии 1.5.0.6 и выше.</li> -</ol> -<h3 id="Limitations_of_XPCNativeWrapper" name="Limitations_of_XPCNativeWrapper">Limitations of <code>XPCNativeWrapper</code></h3> -<p>There are some commonly used properties and coding styles that cannot be used with <code>XPCNativeWrapper</code>. Specifically:</p> -<ol> <li>Assigning to or reading an <code>on*</code> property on an <code>XPCNativeWrapper</code> of a DOM node or Window object will throw an exception. (Use addEventListener instead, and use "event.preventDefault();" in your handler if you used "return false;" before.)</li> <li>Access to frames by window name (e.g. <code>window.frameName</code>) does not work on an <code>XPCNativeWrapper</code></li> <li><code>document.all</code> does not work on an <code>XPCNativeWrapper</code> for a document.</li> <li>Access to named items by name does not work on an <code>XPCNativeWrapper</code> for an HTML document. For example, if you have a <code><form name="foo"></code> and <code>docWrapper</code> is a wrapper for the HTML document <code>doc</code> then <code>doc.foo</code> is an <code>HTMLFormElement</code> while <code>docWrapper.foo</code> is <code>undefined</code>. Code that wishes to do this could use <code>docWrapper.forms.namedItem("foo")</code> instead.</li> <li>Access to nodes by id doesn't work on an <code>XPCNativeWrapper</code> for an HTML document. <code>getElementById</code> should be used instead.</li> <li>Access to inputs by name doesn't work on an <code>XPCNativeWrapper</code> for an HTML form. Code that wishes to do this should use <code>form.elements.namedItem("inputname")</code>.</li> <li>Access to elements by name doesn't work on an <code>XPCNativeWrapper</code> for an <code>HTMLCollection</code>. Code that wishes to do this should use the <code>namedItem()</code> method. Note that <code>namedItem</code> only returns the first input element with the name, even if there are multiple elements (e.g. radio buttons) with the same name in the form.</li> <li>Calling methods implemented by NPAPI plugins through the <code>XPCNativeWrapper</code> for the corresponding node does not work.</li> <li>Getting or setting properties implemented by NPAPI plugins though the <code>XPCNativeWrapper</code> for the corresponding node does not work.</li> <li>Calling methods implemented via XBL bindings attached to a node through an <code>XPCNativeWrapper</code> for that node does not work.</li> <li>Getting or setting properties implemented via XBL bindings attached to a node through an <code>XPCNativeWrapper</code> for that node does not work.</li> <li>Enumerating the properties of an <code>XPCNativeWrapper</code> via "<code>for (var p in wrapper)</code>" does not enumerate the IDL-defined properties.</li> <li>Object.prototype is not on the prototype chain of an <code>XPCNativeWrapper</code>. As a result, various <code>Object.prototype</code> properties are undefined on an <code>XPCNativeWrapper</code> (to be precise, these are <code>__proto__</code>, <code>__parent__</code>, <code>__count__</code>, <code>toSource</code>, <code>toLocaleString</code>, <code>valueOf</code>, <code>watch</code>, <code>unwatch</code>, <code>hasOwnProperty</code>, <code>isPrototypeOf</code>, <code>propertyIsEnumerable</code>, <code>__defineGetter__</code>, <code>__defineSetter__</code>, <code>__lookupGetter__</code>, and <code>__lookupSetter__</code>).</li> <li>There is no support for the <code>importXPCNative</code> method the old <code>XPCNativeWrapper</code> implementation used to have.</li> <li>Accessing standard classes (such as <code>Function</code>) through an XPCNativeWrapper will not work. To create functions and objects with a particular window's parent, use that window's <code>eval</code> function.</li> -</ol> -<p><a class="external" href="http://oreillynet.com/pub/a/network/2005/11/01/avoid-common-greasemonkey-pitfalls.html?page=3">Avoid Common Pitfalls in Greasemonkey</a> has an elaborate explanation for some of these limitations (in context of Greasemonkey scripts).</p> -<p>{{ languages( { "en": "en/XPCNativeWrapper", "fr": "fr/XPCNativeWrapper", "it": "it/XPCNativeWrapper" } ) }}</p> diff --git a/files/ru/orphaned/xpcom/index.html b/files/ru/orphaned/xpcom/index.html deleted file mode 100644 index c2db3696b1..0000000000 --- a/files/ru/orphaned/xpcom/index.html +++ /dev/null @@ -1,17 +0,0 @@ ---- -title: XPCOM -slug: orphaned/XPCOM -tags: - - XPCOM -original_slug: XPCOM ---- -<div class="callout-box"><strong>Введение в XPCOM</strong><br> -<p>Перевод статей с портала <a class="external" href="http://www.ibm.com/developerworks/">IBM developerWorks</a>: <a class="external" href="http://caiiiycuk.info/introduction-to-xpcom/" title="http://caiiiycuk.info/introduction-to-xpcom/">Part I</a>, <a class="external" href="http://caiiiycuk.info/xpcom-components-basics/" title="http://caiiiycuk.info/xpcom-components-basics/">Part II</a>, <a class="external" href="http://caiiiycuk.info/xpcom-environment/" title="http://caiiiycuk.info/xpcom-environment/">Part III</a>, <a class=" external" href="http://caiiiycuk.info/xpcom-component-development/" title="http://caiiiycuk.info/xpcom-component-development/">Part IV & V</a></p> -</div> -<p>XPCOM это кросс-платформенный компонент объектной модели, похожий на Microsoft COM. Он имеет несколько <a class="internal" href="/ru/XPCOM/Language_Bindings" title="ru/XPCOM/Language Bindings">привязок языка</a>, позволяя XPCOM компонентам быть использованным и реализованным на JavaScript, Java, Python и в дополнениях к С++. Интерфейсы в XPCOM определены в IDL диалекте и называются XPIDL.<br> -<br> -XPCOM сама обеспечивает набор базовых компонентов и классов, например, файлов и управления памятью, потоков, базовых структур данных (строки, массивы, варианты) и т.д. Большинство компонентов XPCOM не являются частью этого базового набора и предоставляются другим частям платформ (например, Gecko или Necko) или приложения или даже расширения.</p> -<p><span>Categories</span></p> -<p><span>Interwiki Language Links</span></p> -<p> </p> -<p>{{ languages( { "en": "en/XPCOM", "es": "es/XPCOM", "fr": "fr/XPCOM", "it": "it/XPCOM", "ja": "ja/XPCOM", "ko": "ko/XPCOM", "pl": "pl/XPCOM", "zh-cn": "cn/XPCOM" } ) }}</p> diff --git a/files/ru/orphaned/веб-стандарты/index.html b/files/ru/orphaned/веб-стандарты/index.html deleted file mode 100644 index befc8b983e..0000000000 --- a/files/ru/orphaned/веб-стандарты/index.html +++ /dev/null @@ -1,15 +0,0 @@ ---- -title: Веб-стандарты -slug: orphaned/Веб-стандарты -original_slug: Веб-стандарты ---- -<p style="text-align: justify;">Веб-стандарты, как следует из их названия, являются стандартами в области веб-технологий. Эти стандарты являются рекомендациями для разработчиков программного обеспечения и для веб-мастеров. Служат веб-стандарты для того, чтобы, с одной стороны, пользователи ПО без проблем и неудобств могли пользоваться сетью интернет, а с другой стороны, для того, чтобы разработчики программного обеспечения или веб-мастера были уверены в работоспособности своих продуктов.</p> -<p style="text-align: justify;">Исторически сложилось так, что в начале 90-х годов XX века развязалась так называемая "война браузеров" между компанией Netscape и Microsoft. Суть войны заключалась в том, что разработчики веб-браузеров стремились привнести в продукты своих разработок собственные новые функции, но при этом совершенно не заботились о совместимости технологий и не согласовывали свои действия с разработчиками конкурирующей компании. По этой причине начало возрастать недовольство как среди людей, создающих сайты, так и среди людей, пользующихся сетью интернет - ведь сайты, которые были написаны специально для Netscape Navigator крайне плохо работали в Microsoft Intrnet Explorer и наоборот посредством Internet Explorer почти невозможно было просматривать сайт, написанный для Netscape Navigator.</p> -<p style="text-align: justify;">В 1994 году в Массачусетском технологическом институте при поддержке CERN, DARPA и Европейской Комиссии появилась организация <strong>World Wide Web Consortcium</strong> или, сокращённо, <strong>W3C</strong>. Целью консорциума по сей день является упорядочивание всех веб-технологий для того, чтобы обеспечить их доступность как можно большему числу людей всего мира.</p> -<p style="text-align: justify;">Начиная, примерно, с 2000 года все крупные производители программного обеспечения для сети интернет стараются придерживаться стандартов W3C для того, чтобы обеспечить своим продуктам максимальную эффективность и совместимость с большинством веб-ресурсов. Результат работы консорциума по стандартизации веб-технологий на сегодняшний день очень значителен и выражается в том, что веб-технологии получают все большее распространение в нашем мире и упрощают многим жизнь.</p> -<h1 id="Ссылки">Ссылки</h1> -<p>Официальный сайт W3C (англ.): <a class=" external" href="http://www.w3.org" rel="freelink">http://www.w3.org</a></p> -<p>Официальные учебные пособия W3C (англ.): <a class=" external" href="http://www.w3schools.com/" rel="freelink">http://www.w3schools.com/</a></p> -<p>Web Standards Group: <a class=" external" href="http://webstandardsgroup.org/" rel="freelink">http://webstandardsgroup.org/</a></p> -<p>Российское крыло Web Standards Group: <a class=" external" href="http://web-standards.ru/" rel="freelink">http://web-standards.ru/</a> </p> -<p>Web Standards Project: <a class=" external" href="http://www.webstandards.org/" rel="freelink">http://www.webstandards.org/</a></p> diff --git a/files/ru/orphaned/вопросы_без_ответов/index.html b/files/ru/orphaned/вопросы_без_ответов/index.html deleted file mode 100644 index 327822e640..0000000000 --- a/files/ru/orphaned/вопросы_без_ответов/index.html +++ /dev/null @@ -1,9 +0,0 @@ ---- -title: Вопросы без ответов -slug: orphaned/Вопросы_без_ответов -tags: - - Оставить вопрос - - Список вопросов -original_slug: Вопросы_без_ответов ---- -<p>Здесь вы можете оставить свой вопрос, на который вы не нашли ответа. После того, как мы найдём на него ответ, вопрос будет перемещён на страницу <a>Часто Задаваемых Вопросов</a>.</p> diff --git a/files/ru/orphaned/динамически_изменяемый_пользовательский_интерфейс_на_xul/index.html b/files/ru/orphaned/динамически_изменяемый_пользовательский_интерфейс_на_xul/index.html deleted file mode 100644 index db1cc40b23..0000000000 --- a/files/ru/orphaned/динамически_изменяемый_пользовательский_интерфейс_на_xul/index.html +++ /dev/null @@ -1,69 +0,0 @@ ---- -title: Динамически изменяемый пользовательский интерфейс на XUL -slug: orphaned/Динамически_изменяемый_пользовательский_интерфейс_на_XUL -tags: - - DOM - - Extensions - - XUL -original_slug: Динамически_изменяемый_пользовательский_интерфейс_на_XUL ---- -<p>В этой статье обсуждается управление <a href="/ru/XUL" title="ru/XUL">XUL</a> интерфейсами с использованием <a href="/ru/DOM" title="ru/DOM">DOM</a> и других API. Здесь объясняется принцип <em>документов</em> DOM, приводится несколько простых примеров использования вызовов DOM для выполнения простейших манипуляций с документом, после чего приводится пример, демонстрирующий работу с <em>анонимным <a href="/ru/XBL" title="ru/XBL">XBL</a> содержимым</em> с использованием методов, специфичных для Mozilla.</p> -<p>Эта статья написана как для начинающих, так и для разработчиков среднего уровня подготовки. Предполагается, что у читателя есть базовые знания по XUL и JavaScript. Возможно вы захотите прочитать некоторые вводные документы по DOM, такие как статья <a href="/ru/Об_объектной_модели_документа" title="ru/Об_объектной_модели_документа">Об объектной модели документа</a> или <a href="/ru/Gecko_DOM_Reference/Introduction" title="ru/Gecko_DOM_Reference/Introduction">вводная страница</a> <a href="/ru/Gecko_DOM_Reference" title="ru/Gecko_DOM_Reference">Gecko DOM Reference</a>.</p> -<h3 id=".D0.92.D0.B2.D0.B5.D0.B4.D0.B5.D0.BD.D0.B8.D0.B5" name=".D0.92.D0.B2.D0.B5.D0.B4.D0.B5.D0.BD.D0.B8.D0.B5">Введение</h3> -<p>Как вы знаете, <a href="/ru/XUL" title="ru/XUL">XUL</a> — это язык, основанный на <a href="/ru/XML" title="ru/XML">XML</a>, который использовался в различных приложениях, основанных на Mozilla, таких как Firefox и Thunderbird, для описания пользовательского интерфейса. В XUL приложениях <a href="/ru/JavaScript" title="ru/JavaScript">JavaScript</a> объявляет поведение, используя <a href="/ru/Gecko_DOM_Reference" title="ru/Gecko_DOM_Reference">DOM APIs</a> для доступа к XUL документу.</p> -<p>Так что же такое <strong>D</strong>ocument <strong>O</strong>bject <strong>M</strong>odel APIs?</p> -<p>Это интерфейсы, которые используются при любом взаимодействии скрипта и документа. Если вы когда-либо писали скрипт, который взаимодействует с XUL (или HTML) документом, то вы уже использовали DOM-вызовы. Пожалуй, наиболее известным DOM методом является <code><a href="/ru/DOM/document.getElementById" title="ru/DOM/document.getElementById">document.getElementById()</a></code>, который возвращает элемент с заданным <code>id</code>. Возможно, вы использовали и другие DOM-вызовы, такие как <code><a href="/ru/DOM/element.setAttribute" title="ru/DOM/element.setAttribute">element.setAttribute()</a></code>, или, если вы писали расширения, метод <code><a href="/ru/DOM/element.addEventListener" title="ru/DOM/element.addEventListener">addEventListener()</a></code>. Все они объявлены в DOM.</p> -<p>Существуют также DOM-методы, которые создают, перемещают или удаляют элементы из документа. Они будут продемонстрированы позже в этом параграфе. А сейчас давайте поймём, что такое <em>document</em>.</p> -<h3 id=".D0.A7.D1.82.D0.BE_.D1.82.D0.B0.D0.BA.D0.BE.D0.B5_document.3F" name=".D0.A7.D1.82.D0.BE_.D1.82.D0.B0.D0.BA.D0.BE.D0.B5_document.3F">Что такое document?</h3> -<p>Document — это структура данных, которой можно управлять через DOM APIs. Логической структурой каждого объекта document является дерево с узлами-элементами, атрибутами, комментариями и т.д. Используйте инструмент <a href="/ru/DOM_Inspector" title="ru/DOM_Inspector">DOM Inspector</a>, чтобы увидеть древовидное представление любого объекта document.</p> -<p>Можно считать, что document — это представление в памяти правильного HTML или хорошо сформированного XML, как, например, xhtml или XUL.</p> -<p>Важно запомнить, что разные страницы (и даже различные экземпляры одной страницы) соответствуют разным документам. Каждое XUL-окно имеет имеет свой собственный отдельный document. Более того, в одном окне может быть несколько различных объектов document, если используется <code><a href="/ru/XUL/iframe" title="ru/XUL/iframe"><iframe></a></code>, <code><a href="/ru/XUL/browser" title="ru/XUL/browser"><browser></a></code> или <code><a href="/ru/XUL/tabbrowser" title="ru/XUL/tabbrowser"><tabbrowser></a></code>. Вы должны быть уверены, что все время управляете именно тем (а не иным) объектом document (больше информации можно найти в разделе <a href="/ru/Working_with_windows_in_chrome_code" title="ru/Working_with_windows_in_chrome_code">Working with windows in chrome code</a>). Если ваш скрипт подключается с использованием тэга <code><a href="/ru/XUL/script" title="ru/XUL/script"><script></a></code>, то свойство <code>document</code> ссылается на DOM document, который содержит скрипт.</p> -<h3 id=".D0.9F.D1.80.D0.B8.D0.BC.D0.B5.D1.80:_.D0.98.D1.81.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_.D0.BC.D0.B5.D1.82.D0.BE.D0.B4.D0.BE.D0.B2_DOM" name=".D0.9F.D1.80.D0.B8.D0.BC.D0.B5.D1.80:_.D0.98.D1.81.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_.D0.BC.D0.B5.D1.82.D0.BE.D0.B4.D0.BE.D0.B2_DOM">Пример: Использование методов DOM</h3> -<p>Этот параграф демонстрирует использование DOM-методов <code><a href="/ru/DOM/element.appendChild" title="ru/DOM/element.appendChild">appendChild()</a></code>, <code><a href="/ru/DOM/document.createElement" title="ru/DOM/document.createElement">createElement()</a></code>, <code><a href="/ru/DOM/element.insertBefore" title="ru/DOM/element.insertBefore">insertBefore()</a></code>, и <code><a href="/ru/DOM/element.removeChild" title="ru/DOM/element.removeChild">removeChild()</a></code>.</p> -<h4 id=".D0.A3.D0.B4.D0.B0.D0.BB.D0.B5.D0.BD.D0.B8.D0.B5_.D0.B2.D1.81.D0.B5.D1.85_.D0.B4.D0.BE.D1.87.D0.B5.D1.80.D0.BD.D0.B8.D1.85_.D1.8D.D0.BB.D0.B5.D0.BC.D0.B5.D0.BD.D1.82.D0.BE.D0.B2" name=".D0.A3.D0.B4.D0.B0.D0.BB.D0.B5.D0.BD.D0.B8.D0.B5_.D0.B2.D1.81.D0.B5.D1.85_.D0.B4.D0.BE.D1.87.D0.B5.D1.80.D0.BD.D0.B8.D1.85_.D1.8D.D0.BB.D0.B5.D0.BC.D0.B5.D0.BD.D1.82.D0.BE.D0.B2">Удаление всех дочерних элементов</h4> -<p>Этот пример удаляет все элементы, дочерние для элемента с id=<code>someElement</code> из текущего document, с использованием метода <code><a href="/ru/DOM/element.removeChild" title="ru/DOM/element.removeChild">removeChild()</a></code> который удаляет первый дочерний элемент до тех пор, пока их не останется совсем.</p> -<p>Заметьте, что <code><a href="/ru/DOM/element.hasChildNodes" title="ru/DOM/element.hasChildNodes">hasChildNodes()</a></code> и <code><a href="/ru/DOM/element.firstChild" title="ru/DOM/element.firstChild">firstChild</a></code> являются также частью DOM API.</p> -<pre class="eval">var element = document.getElementById("someElement"); - while(element.hasChildNodes()){ - element.removeChild(element.firstChild); - } -</pre> -<h4 id=".D0.92.D1.81.D1.82.D0.B0.D0.B2.D0.BA.D0.B0_.D1.8D.D0.BB.D0.B5.D0.BC.D0.B5.D0.BD.D1.82.D0.BE.D0.B2_.D0.B2_.D0.BC.D0.B5.D0.BD.D1.8E" name=".D0.92.D1.81.D1.82.D0.B0.D0.B2.D0.BA.D0.B0_.D1.8D.D0.BB.D0.B5.D0.BC.D0.B5.D0.BD.D1.82.D0.BE.D0.B2_.D0.B2_.D0.BC.D0.B5.D0.BD.D1.8E">Вставка элементов в меню</h4> -<p>Этот пример добавляет два новых элемента меню к <code><a href="/ru/XUL/menupopup" title="ru/XUL/menupopup"><menupopup></a></code>: в начало и в конец. Здесь используется метод <code><a href="/ru/DOM/document.createElementNS" title="ru/DOM/document.createElementNS">document.createElementNS()</a></code> для создания элементов и <code><a href="/ru/DOM/element.insertBefore" title="ru/DOM/element.insertBefore">insertBefore()</a></code> с <code><a href="/ru/DOM/element.appendChild" title="ru/DOM/element.appendChild">appendChild()</a></code> для вставки созданных xml элементов в документ.</p> -<p>Замечания:</p> -<ul> - <li><code><a href="/ru/DOM/document.createElementNS" title="ru/DOM/document.createElementNS">document.createElementNS()</a></code> создаёт элемент, но не добавляет ничего в document. Необходимо воспользоваться другим DOM-методом, таким как <code><a href="/ru/DOM/element.appendChild" title="ru/DOM/element.appendChild">appendChild()</a></code> для вставки только что созданного элемента в document.</li> - <li><code><a href="/ru/DOM/element.appendChild" title="ru/DOM/element.appendChild">appendChild()</a></code> добавляет узел после других узлов, а <code><a href="/ru/DOM/element.insertBefore" title="ru/DOM/element.insertBefore">insertBefore()</a></code> вставляет узел перед узлом, указанным во втором параметре.</li> -</ul> -<pre class="eval">function createMenuItem(aLabel) { - const XUL_NS = "<span class="nowiki">http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul</span>"; - var item = document.createElementNS(XUL_NS, "menuitem"); // Создаём новый элемент меню XUL - item.setAttribute("label", aLabel); - return item; -} -var popup = document.getElementById("myPopup"); // элемент <menupopup> -var first = createMenuItem("First item"); -var last = createMenuItem("Last item"); -popup.insertBefore(first, popup.firstChild); -popup.appendChild(last); -</pre> -<p>Вы также можете использовать <code><a href="/ru/DOM/element.appendChild" title="ru/DOM/element.appendChild">appendChild()</a></code> и <code><a href="/ru/DOM/element.insertBefore" title="ru/DOM/element.insertBefore">insertBefore()</a></code> для передвигания существующих элементов. Например, вы можете подвинуть элемент "First item" в конец popup'а, добавив эту строчку последней:</p> -<pre class="eval">popup.appendChild(first); -</pre> -<p>Этот оператор удалит узел из его текущего места и заново вставит его в конец popup'а.</p> -<h3 id=".D0.90.D0.BD.D0.BE.D0.BD.D0.B8.D0.BC.D0.BD.D0.BE.D0.B5_.D1.81.D0.BE.D0.B4.D0.B5.D1.80.D0.B6.D0.B8.D0.BC.D0.BE.D0.B5_.28XBL.29" name=".D0.90.D0.BD.D0.BE.D0.BD.D0.B8.D0.BC.D0.BD.D0.BE.D0.B5_.D1.81.D0.BE.D0.B4.D0.B5.D1.80.D0.B6.D0.B8.D0.BC.D0.BE.D0.B5_.28XBL.29">Анонимное содержимое (XBL)</h3> -<p><a href="/ru/XBL" title="ru/XBL">XBL</a> — это язык, используемый в Mozilla для объявления новых виджетов. Виджеты, объявленные в XBL можно выбирать для объявления некоторого содержимого, объединённого в связку с помощью граничного элемента. Такое содержимое называется <em>анонимное содержимое</em> и оно не доступно через обычную модель DOM. <span class="comment">(подкорректируйте, я не понял смысла</span>).</p> -<p>Вместо этого вам необходимо использовать методы интерфейса <code><a href="/ru/NsIDOMDocumentXBL" title="ru/NsIDOMDocumentXBL">nsIDOMDocumentXBL</a></code>. Например:</p> -<pre class="eval">// Выбирает первый анонимный дочерний элемент для заданного -document.getAnonymousNodes(node)[0]; - -// Возвращает NodeList анонимных элементов с атрибутом anonid равным el1 -document.getAnonymousElementByAttribute(node, "anonid", "el1"); -</pre> -<p>См. <a href="/ru/XBL/XBL_1.0_Reference/DOM_Interfaces#getAnonymousNodes" title="ru/XBL/XBL_1.0_Reference/DOM_Interfaces#getAnonymousNodes">getAnonymousNodes</a> и <a href="/ru/XBL/XBL_1.0_Reference/DOM_Interfaces#getAnonymousElementByAttribute" title="ru/XBL/XBL_1.0_Reference/DOM_Interfaces#getAnonymousElementByAttribute">getAnonymousElementByAttribute</a> в XBL-справочнике.</p> -<p>Если вы достали анонимный узел, то дальше можно использовать обычные DOM-методы для работы с остальными элементами этой связки.</p> -<h3 id=".D0.A1.D0.BC.D0.BE.D1.82.D1.80.D0.B8_.D1.82.D0.B0.D0.BA.D0.B6.D0.B5" name=".D0.A1.D0.BC.D0.BE.D1.82.D1.80.D0.B8_.D1.82.D0.B0.D0.BA.D0.B6.D0.B5">Смотрите также</h3> -<ul> - <li><a href="/ru/XUL_Tutorial/Document_Object_Model" title="ru/XUL_Tutorial/Document_Object_Model">A related chapter on DOM</a></li> - <li><a href="/ru/XUL_Tutorial/Modifying_a_XUL_Interface" title="ru/XUL_Tutorial/Modifying_a_XUL_Interface">XUL Tutorial:Modifying a XUL Interface</a></li> -</ul> diff --git a/files/ru/orphaned/доступность/index.html b/files/ru/orphaned/доступность/index.html deleted file mode 100644 index 23e0e8af0c..0000000000 --- a/files/ru/orphaned/доступность/index.html +++ /dev/null @@ -1,19 +0,0 @@ ---- -title: Доступность -slug: orphaned/Доступность -tags: - - Accessibility -original_slug: Доступность ---- -<p> </p> -<div> -<p>"Доступность чаще всего используется, чтобы описать средства обслуживания или удобства, чтобы помочь людям с неполными способностями (инвалидам). Это может быть Шрифт Брайля (обозначения для слепых), скаты для инвалидного кресла, звуковые сигналы в пешеходных переходах, контурах прохода, дизайн веб-сайта, и так далее..." {{ Ref(1) }}</p> -</div> -<table class="topicpage-table"> <tbody> <tr> <td> <h4 id=".D0.94.D0.BE.D0.BA.D1.83.D0.BC.D0.B5.D0.BD.D1.82.D0.B0.D1.86.D0.B8.D1.8F" name=".D0.94.D0.BE.D0.BA.D1.83.D0.BC.D0.B5.D0.BD.D1.82.D0.B0.D1.86.D0.B8.D1.8F"><a href="/Special:Tags?tag=%D0%94%D0%BE%D1%81%D1%82%D1%83%D0%BF%D0%BD%D0%BE%D1%81%D1%82%D1%8C&language=ru" title="Special:Tags?tag=Доступность&language=ru">Документация</a></h4> <h5 id=".D0.92.D0.B2.D0.B5.D0.B4.D0.B5.D0.BD.D0.B8.D0.B5" name=".D0.92.D0.B2.D0.B5.D0.B4.D0.B5.D0.BD.D0.B8.D0.B5">Введение</h5> <dl><dt> <a class="external" href="http://www.mozilla.org/access/today">Software Accessibility Today</a> </dt><dd> <small>Доступность программного обеспечения прошла значительные усовершенствования за прошлые два десятилетия. Эта статья рассматривает продвижение и технологию, как оно развивалось.</small> </dd></dl> <dl><dt> <a class="external" href="http://diveintoaccessibility.org/">Dive into Accessibility</a> </dt><dd> <small>Эта книга отвечает на два вопроса. Первый - "Почему я должен делать мой сайт более доступным?" Второй - "Как я могу сделать мой сайт более доступным?"</small> </dd></dl> <dl><dt> <a class="external" href="http://www-306.ibm.com/able/guidelines/web/accessweb.html">Accessible Web Page Authoring</a> </dt><dd> <small>Хорошая статья о "Доступности для веб-сайта", от IBM.</small> </dd></dl> <h5 id="Guidelines" name="Guidelines">Guidelines</h5> <dl><dt> <a href="/ru/Accessibility/Architecture" title="ru/Accessibility/Architecture">Accessibility:Architecture</a> </dt><dd> <small>Как иерархия доступности выполнена в Mozilla</small> </dd></dl> <dl><dt> <a href="/ru/Building_accessible_custom_components_in_XUL" title="ru/Building_accessible_custom_components_in_XUL">Building accessible custom components in XUL</a> </dt><dd> <small>Как использовать Технику доступности DHTML чтобы сделать ваши XUL компоненты доступными.</small> </dd></dl> <dl><dt> <a href="/ru/Accessible_XUL_Authoring_Guidelines" title="ru/Accessible_XUL_Authoring_Guidelines">Accessible XUL Authoring Guidelines</a> </dt><dd> <small>When authored according to these guidelines, XUL is capable of generating accessible user interfaces. Coders, reviewers, designers and QA engineers should be familiar with these guidelines.</small> </dd></dl> <dl><dt> <a class="external" href="http://www.mozilla.org/access/keyboard/tabindex.html">Key-navigable custom DHTML widgets, in Mozilla and IE</a> </dt><dd> <small>Until now, web developers who want to make their styled <code><div></code> and <code><span></code> based widgets keyboard accessible have lacked the proper techniques. Keyboard accessibility is part of the minimum accessibility requirements of which any web developer should be aware.</small> </dd></dl> <dl><dt> <a href="/ru/Building_XULRunner_with_Python" title="ru/Building_XULRunner_with_Python">Building XULRunner with Python</a> </dt><dd> <small>How to build XULRunner with Python on Windows. Then comtypes gives access to MSAA and IAccessible2</small> </dd></dl> <h5 id="References" name="References">References</h5> <dl><dt> <a href="/ru/Accessibility/AT-APIs" title="ru/Accessibility/AT-APIs">AT APIs Implementation by Gecko</a> </dt><dd> <small>Shows how Gecko handles ATK, IAccessible2, MSAA and Universal Access API</small> </dd></dl> <dl><dt> <a href="/ru/ARIA/Accessible_Rich_Internet_Applications" title="ru/ARIA/Accessible_Rich_Internet_Applications">ARIA: Accessible Rich Internet Applications</a> </dt><dd> <small>ARIA, formerly known as DHTML accessibility, allows desktop-style widgets such as tree views, menu bars and spreadsheets which are accessible both with the keyboard and assistive technologies such as screen readers, screen magnifiers and alternative input devices. It also allows authors describe live changes on a web page, to help screen readers know when to announce those changes. See also the report on upcoming support for <a href="/ru/AJAX/WAI_ARIA_Live_Regions" title="ru/AJAX/WAI_ARIA_Live_Regions">AJAX:WAI ARIA Live Regions</a>.</small> </dd></dl> <dl><dt> <a href="/ru/Accessibility/XForms" title="ru/Accessibility/XForms">Accessibility XForms References</a> </dt><dd> <small>Shows how XForms controls are mapped to accessible tree</small> </dd></dl> <p><span class="alllinks"><a href="/Special:Tags?tag=Accessibility&language=ru" title="Special:Tags?tag=Accessibility&language=ru">View All...</a></span></p> </td> <td> <h4 id="Community" name="Community">Community</h4> <ul> <li>View Mozilla forums...</li> </ul> <p>{{ DiscussionList("support-accessibility", "mozilla.support.accessibility") }}</p> <ul> <li><a class="external" href="http://www.w3.org/WAI/IG/">WAI Interest Group</a></li> <li><a href="/ru/Accessibility/Community" title="ru/Accessibility/Community">Other community links...</a></li> </ul> <h4 id="Tools" name="Tools">Tools</h4> <ul> <li><a class="external" href="http://www.mozilla.org/quality/embed/plans/accessibility/nsIAccessibleTestPlan.html">Automated Accessibility Tests</a></li> <li><a class="external" href="http://www.standards-schmandards.com/index.php?show/fangs">Fangs Screen Reader Emulator</a></li> </ul> <p><span class="alllinks"><a href="/Special:Tags?tag=Accessibility:Tools&language=ru" title="Special:Tags?tag=Accessibility:Tools&language=ru">View All...</a></span></p> <h4 id="Related_Topics" name="Related_Topics">Related Topics</h4> <dl><dd> <a href="/ru/Web_Development" title="ru/Web_Development">Web Development</a>, <a href="/ru/Web_Standards" title="ru/Web_Standards">Web Standards</a>, <a href="/ru/XUL" title="ru/XUL">XUL</a> </dd></dl></td> </tr> </tbody> -</table> -<hr> -<p><small> {{ Note(1) }} <a class="external" href="http://en.wikipedia.org/wiki/Accessibility">Wikipedia entry for Accessibility</a> </small></p> -<p><span class="comment">Categories</span></p> -<p><span class="comment">Interwiki Language Links</span></p> -<p> </p> -<p>{{ languages( { "es": "es/Accesibilidad", "fr": "fr/Accessibilit\u00e9", "ja": "ja/Accessibility", "pl": "pl/Dost\u0119pno\u015b\u0107" } ) }}</p> diff --git a/files/ru/orphaned/контроль_качества/index.html b/files/ru/orphaned/контроль_качества/index.html deleted file mode 100644 index d9a09f4b91..0000000000 --- a/files/ru/orphaned/контроль_качества/index.html +++ /dev/null @@ -1,7 +0,0 @@ ---- -title: Контроль качества -slug: orphaned/Контроль_качества -original_slug: Контроль_качества ---- -<p><span class="short_text" id="result_box"><span class="hps" title="Нажмите, чтобы увидеть альтернативный перевод"><br> -</span></span>Эта страница не содержит текста. Измените MDN добавив статью.</p> diff --git a/files/ru/orphaned/локализация/index.html b/files/ru/orphaned/локализация/index.html deleted file mode 100644 index 4a5900ce30..0000000000 --- a/files/ru/orphaned/локализация/index.html +++ /dev/null @@ -1,6 +0,0 @@ ---- -title: Локализация -slug: orphaned/Локализация -original_slug: Локализация ---- -<p><span style="font-weight: bold;">Локализация </span>- это процесс перевода пользовательского интерфейса программного обеспечения с одного языка на другой и адаптации в соответствии с особенностями иностранной культуры. Данный ресурс расскажет о создании базирующихся на технологиях Mozilla локализованных приложений и расширений.</p> diff --git a/files/ru/orphaned/настройка_среды_разработки_расширений/index.html b/files/ru/orphaned/настройка_среды_разработки_расширений/index.html deleted file mode 100644 index cd7e585cb9..0000000000 --- a/files/ru/orphaned/настройка_среды_разработки_расширений/index.html +++ /dev/null @@ -1,82 +0,0 @@ ---- -title: Настройка среды разработки расширений -slug: orphaned/Настройка_среды_разработки_расширений -tags: - - Расширения -original_slug: Настройка_среды_разработки_расширений ---- -<p>В этой статье приводится несколько советов о том, как настроить ваше приложение Mozilla для удобной работы над расширениями.</p> - -<h3 id=".D0.9F.D1.80.D0.BE.D1.84.D0.B8.D0.BB.D1.8C_.D0.B4.D0.BB.D1.8F_.D1.80.D0.B0.D0.B7.D1.80.D0.B0.D0.B1.D0.BE.D1.82.D0.BA.D0.B8" name=".D0.9F.D1.80.D0.BE.D1.84.D0.B8.D0.BB.D1.8C_.D0.B4.D0.BB.D1.8F_.D1.80.D0.B0.D0.B7.D1.80.D0.B0.D0.B1.D0.BE.D1.82.D0.BA.D0.B8">Профиль для разработки</h3> - -<p>Чтобы избежать возможных потерь личных данных при разработке собственных расширений, рекомендуется создать отдельный профиль и проводить в нем все тестирования.</p> - -<p>Для того, чтобы создать новый профиль в Firefox, достаточно запустить его с ключом <code>"-ProfileManager"</code>, т.е.</p> - -<pre class="eval">firefox -ProfileManager -</pre> - -<p>для Linux или</p> - -<pre class="eval">Win+R (или Пуск->Выполнить) -start "" "%ProgramFiles%\Mozilla Firefox\firefox.exe" -ProfileManager -</pre> - -<p>для Windows.</p> - -<p>После создания профиля (назовём его <code>myDevProfile</code>) можно запустить Firefox, указав ключ <code>"-P myDevProfile"</code>. Профиль по умолчанию называется <code>"default"</code>. Таким образом, для удобства запуска можно создать 2 ярлыка (символические ссылки) на Firefox с ключами <code>"-P <profileName>"</code>.</p> - -<p>Однако обычно нельзя запустить 2 копии Firefox с разными профилями. Чтобы сделать это укажите при запуске дополнительно ключ <code>"-no-remote"</code>.</p> - -<h3 id=".D0.9D.D0.B0.D1.81.D1.82.D1.80.D0.BE.D0.B9.D0.BA.D0.B8_Firefox_.D0.B4.D0.BB.D1.8F_.D1.80.D0.B0.D0.B7.D1.80.D0.B0.D0.B1.D0.BE.D1.82.D0.BA.D0.B8" name=".D0.9D.D0.B0.D1.81.D1.82.D1.80.D0.BE.D0.B9.D0.BA.D0.B8_Firefox_.D0.B4.D0.BB.D1.8F_.D1.80.D0.B0.D0.B7.D1.80.D0.B0.D0.B1.D0.BE.D1.82.D0.BA.D0.B8">Настройки Firefox для разработки</h3> - -<p>Наверно, вы знаете о возможности настроить Firefox детально с помощью <code>about:config</code>. Если нет, рекомендуем вам прочитать статью <a class="external" href="/http://www.mozilla.org/support/firefox/edit%7CРедактирование" title="http://www.mozilla.org/support/firefox/edit|Редактирование">конфигурационных файлов</a>.</p> - -<p>Итак, вот настройки, которые облегчат разработку расширений под Firefox.</p> - -<ul> - <li><code><strong>javascript.options.showInConsole = true</strong></code>. Вывод ошибок в файлах chrome в консоль ошибок.</li> -</ul> - -<p><span class="comment">при редактировании здесь учтите также номер предлагаемой опции в последней секции</span></p> - -<ul> - <li><code><strong>nglayout.debug.disable_xul_cache = true</strong></code>. Отключение кеширования XUL. Вы сможете видеть изменения в интерфейсе окон и диалогов без перезагрузки браузера (к оверлеям не относится). Чтобы это заработало, вы должны <a href="#.D0.98.D1.81.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_.D0.BF.D0.B0.D0.BF.D0.BE.D0.BA.2C_.D0.B0_.D0.BD.D0.B5_JAR.27.D0.BE.D0.B2"> использовать папки, а не jar'ы</a>.</li> - <li><code><strong>browser.dom.window.dump.enabled = true</strong></code>. Позволяет использовать <code><a href="/en/DOM/window.dump">dump</a>("string")</code> для вывода в стандартную консоль. Можно также использовать <code><a href="/en/nsIConsoleService">en:nsIConsoleService</a></code> из привилегированного скрипта.</li> - <li><code><strong>javascript.options.strict = true</strong></code>. Обеспечит вывод предупреждений JavaScript в консоль ошибок. Учтите, что, так как большинство разработчиков отключают эту опцию, вы будете видеть предупреждения о проблемах в коде других скриптов вдобавок к своим. Можете попробовать использовать <a class="link-https" href="https://addons.mozilla.org/en-US/firefox/addon/1815">Console<sup>2</sup></a>.</li> - <li><code><strong>extensions.logging.enabled = true</strong></code>. Вывод более детальной информации о проблемах установки и обновления расширения.</li> -</ul> - -<h3 id=".D0.A0.D0.B0.D1.81.D1.88.D0.B8.D1.80.D0.B5.D0.BD.D0.B8.D1.8F_.D0.B4.D0.BB.D1.8F_.D1.80.D0.B0.D0.B7.D1.80.D0.B0.D0.B1.D0.BE.D1.82.D0.BA.D0.B8" name=".D0.A0.D0.B0.D1.81.D1.88.D0.B8.D1.80.D0.B5.D0.BD.D0.B8.D1.8F_.D0.B4.D0.BB.D1.8F_.D1.80.D0.B0.D0.B7.D1.80.D0.B0.D0.B1.D0.BE.D1.82.D0.BA.D0.B8">Расширения для разработки</h3> - -<ul> - <li><a href="/en/DOM_Inspector">en:DOM Inspector</a></li> - <li><a class="link-https" href="https://addons.mozilla.org/firefox/addon/216">Venkman</a>, отладчик JavaScript.</li> - <li><a class="external" href="http://ted.mielczarek.org/code/mozilla/extensiondev/">Extension Developer's Extension</a></li> - <li><a class="link-https" href="https://addons.mozilla.org/firefox/addon/1815">Console<sup>2</sup></a></li> - <li><a class="link-https" href="https://addons.mozilla.org/firefox/addon/4453">Chrome List</a></li> - <li><a class="link-https" href="https://addons.mozilla.org/firefox/addon/1843">Firebug</a></li> - <li><a class="link-https" href="https://addons.mozilla.org/firefox/addon/1729">Execute JS</a></li> - <li><a class="external" href="http://xpcomviewer.mozdev.org">XPCOMViewer</a>, инспектор XPCOM</li> -</ul> - -<h3 id=".D0.9E.D1.82.D0.B4.D0.B5.D0.BB.D1.8C.D0.BD.D0.BE.D0.B5_.D1.85.D1.80.D0.B0.D0.BD.D0.B5.D0.BD.D0.B8.D0.B5_.D0.BA.D0.BE.D0.B4.D0.B0_.D1.80.D0.B0.D1.81.D1.88.D0.B8.D1.80.D0.B5.D0.BD.D0.B8.D1.8F" name=".D0.9E.D1.82.D0.B4.D0.B5.D0.BB.D1.8C.D0.BD.D0.BE.D0.B5_.D1.85.D1.80.D0.B0.D0.BD.D0.B5.D0.BD.D0.B8.D0.B5_.D0.BA.D0.BE.D0.B4.D0.B0_.D1.80.D0.B0.D1.81.D1.88.D0.B8.D1.80.D0.B5.D0.BD.D0.B8.D1.8F">Отдельное хранение кода расширения</h3> - -<p>Чтобы не переустанавливать расширение при каждом изменении и не опасаться случайного удаления кода при его деинсталляции, можно поместить ваш код в отдельное место.</p> - -<ol> - <li>Найдите папку с вашим профилем. Если вы не создавали его специально, браузер использует профиль по умолчанию. <a class="external" href="http://kb.mozillazine.org/Profile_folder">Как найти папку с профилем.</a></li> - <li>Откройте папку <code>extensions</code>. Если её нет, создайте её.</li> - <li>Создайте новый текстовый файл и поместите в него лишь путь к вашему расширению (напр., <code>C:\extensions\my_extension\</code> для Windows или <code>~/extensions/my_extension/</code> для Unix/Linux). Сохраните файл под именем, одинаковым с <code>id</code> вашего расширения.</li> -</ol> - -<p><strong>Примечания:</strong></p> - -<ul> - <li>Не забудьте конечный слеш.</li> - <li>Возможно возникновение проблем из-за знаков нижнего подчёркивания в названии; если так вышло, измените его.</li> -</ul> - -<h3 id=".D0.98.D1.81.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_.D0.BF.D0.B0.D0.BF.D0.BE.D0.BA.2C_.D0.B0_.D0.BD.D0.B5_JAR.27.D0.BE.D0.B2" name=".D0.98.D1.81.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_.D0.BF.D0.B0.D0.BF.D0.BE.D0.BA.2C_.D0.B0_.D0.BD.D0.B5_JAR.27.D0.BE.D0.B2">Использование папок, а не JAR'ов</h3> - -<p>Учитывая предыдущий пункт, можно, поместив свой код в отдельное место, не упаковывать его. Это облегчит разработку вообще и позволит воспользоваться 2-й опцией в <a href="#.D0.9D.D0.B0.D1.81.D1.82.D1.80.D0.BE.D0.B9.D0.BA.D0.B8_Firefox_.D0.B4.D0.BB.D1.8F_.D1.80.D0.B0.D0.B7.D1.80.D0.B0.D0.B1.D0.BE.D1.82.D0.BA.D0.B8"> предлагаемых настройках</a>.</p> diff --git a/files/ru/orphaned/переход_с_internet_explorer_на_mozilla/index.html b/files/ru/orphaned/переход_с_internet_explorer_на_mozilla/index.html deleted file mode 100644 index e17b95e6ca..0000000000 --- a/files/ru/orphaned/переход_с_internet_explorer_на_mozilla/index.html +++ /dev/null @@ -1,11 +0,0 @@ ---- -title: Переход с Internet Explorer на Mozilla -slug: orphaned/Переход_с_Internet_Explorer_на_Mozilla -original_slug: Переход_с_Internet_Explorer_на_Mozilla ---- -<h3 id=".D0.92.D0.B2.D0.B5.D0.B4.D0.B5.D0.BD.D0.B8.D0.B5">Введение</h3> -<p>Когда Netscape запустила броузер Mozilla, было решено поддерживать стандарт W3C. В результате, Mozilla не полностью совместима с Netscape Navigator 4.x и Microsoft Internet Explorer; например, Mozilla не поддерживает <code><layer></code>, я расскажу об этом позже. Броузеры, такие как Internet Explorer 4, были разработаны до утверждения стандарта W3C, и имеют много индивидуальных особенностей. В этом ключе, я опишу особенности Mozilla, с поддержкой строгого стиля HTML в сочетании с Internet Explorer и другими используемыми броузерами.</p> -<p>Впрочем я опишу как нестандартизированные технологии, такие как XMLHttpRequest, так и богатые возможности представления текста, которые Mozilla поддерживает согласно стандарту W3C. Они включают:</p> -<ul> <li>HTML 4.01, XHTML 1.0 и XHTML 1.1</li> <li>Каскадные таблицы стилей (CSS): CSS 1, CSS 2.1 и частично CSS 3</li> <li>Объектная модель документа (DOM): DOM 1, DOM 2 и частично DOM 3</li> <li>Математический язык разметки: MathML 2.0</li> <li>Расширяемый язык разметки (XML): XML 1.0, Пространство имён в XML, Associating Style Sheets with XML Documents 1.0, Fragment Identifier for XML</li> <li>XSL Традиционно: XSLT 1.0</li> <li>XML Часть языка: XPath 1.0</li> <li>Resource Description Framework: RDF</li> <li>Simple Object Access Protocol: SOAP 1.1</li> <li>ECMA-262, revision 3 (JavaScript 1.5): ECMA-262</li> -</ul> -<p> </p> diff --git a/files/ru/orphaned/сборка_и_установка/index.html b/files/ru/orphaned/сборка_и_установка/index.html deleted file mode 100644 index fe7486f500..0000000000 --- a/files/ru/orphaned/сборка_и_установка/index.html +++ /dev/null @@ -1,35 +0,0 @@ ---- -title: Сборка и установка -slug: orphaned/Сборка_и_установка -original_slug: Сборка_и_установка ---- -<div class="note"><strong>Важно:</strong> Не начинайте сборку без предварительной конфигурации!</div> -<h3 id="Сборка">Сборка</h3> -<p>Для сборки продуктов Mozilla вам потребуется программный пакет GNU make. Никакой другой компилятор типа "make" не подходит для решения задачи компиляции продуктов Mozilla. На операционных системах Windows, MacOS X и GNU/Linux используйте "make" для запуска компилятора GNU make, на других non-GNU UNIX-подобных используйте "gmake".</p> -<p>После того, как вы скачали исходный код Mozilla, убедитесь в том, что вы сконфигурировали его для сборки так, как описано на странице Конфигурация параметров сборки.</p> -<p>Для того, чтобы приступить к компиляции, на ОС Windows, MacOS X или GNU/Linux, убедитесь, что вы находитесь в самой верхней директории исходного кода Mozilla, после чего выполните команду:</p> -<pre class="eval">make -f client.mk build</pre> -<div class="note"><strong>Важно:</strong> в MacOS X, путь к директории с исходным кодом Mozilla, не должен содержать пробелов в именах папок!</div> -<p>Для запуска компиляции на большинстве non-GNU UNIX-подобных операционных системах, выполните команду:</p> -<pre>gmake -f client.mk build -</pre> -<p>Если вы хотите собрать программу не в автоматическом режиме, а вручную, то перейдите в Вашу объектную директорию и выполните последовательно команды:</p> -<pre>./configure - -make #для Windows, MacOS X или Linux - -gmake #для non-GNU UNIX-подобных ОС -</pre> -<h3 id="Запуск_новой_сборки">Запуск новой сборки</h3> -<p>Теперь вы можете запустить свою сборку непосредственно из директории, где она была скомпилирована. Для этого, перейдите в директорию:</p> -<pre>@OBJDIR@/dist/bin # -</pre> -<p>И запустите на выполнение:</p> -<pre>firefox #для Linux это скрипт запуска -firefox.exe #для Windows -</pre> -<h3 id="Сборка_пакета_или_инсталлятора">Сборка пакета или инсталлятора</h3> -<p>Поскольку запуск программы из директории с исходным кодом и скомпилированными модулями и объектами не очень удобен. Да и перенести исполняемый файл, не потеряв его работоспособность нельзя. Для того, чтобы собрать инсталлятор для OS Windows или пакет для UNIX-подобных операционных систем, выполните в объектной директории команду:</p> -<pre>make package #для Linux, MacOS X b UNIX-ов -make installer #для OS Windows -</pre> diff --git a/files/ru/orphaned/создание_расширения/index.html b/files/ru/orphaned/создание_расширения/index.html deleted file mode 100644 index 90197c6d9a..0000000000 --- a/files/ru/orphaned/создание_расширения/index.html +++ /dev/null @@ -1,275 +0,0 @@ ---- -title: Создание расширения -slug: orphaned/Создание_расширения -tags: - - Extensions -original_slug: Создание_расширения ---- -<h3 id=".D0.92.D0.B2.D0.B5.D0.B4.D0.B5.D0.BD.D0.B8.D0.B5" name=".D0.92.D0.B2.D0.B5.D0.B4.D0.B5.D0.BD.D0.B8.D0.B5">Введение</h3> - -<p>Этот краткий курс касается построения простейшего расширения для Firefox, которое будет добавлять в строку статуса надпись <em>"Hello, World!"</em>.</p> - -<div class="note"><strong>Примечание:</strong> Расширение создаваемое в этой статье не будет работать в версиях Firefox в которых нет статичной строки состояния (Firefox 4 и выше). Более релевантную статью вы можете найти в руководстве <a href="/ru/docs/XUL_School">Школьный учебник по XUL</a> в разделе <a href="/ru/docs/XUL_School/Getting_Started_with_Firefox_Extensions">Приступая к работе с расширениями Firefox</a>.</div> - -<h4 id=".D0.A7.D1.82.D0.BE_.D0.BD.D1.83.D0.B6.D0.BD.D0.BE_.D0.B7.D0.BD.D0.B0.D1.82.D1.8C_.D0.B4.D0.BB.D1.8F_.D0.BD.D0.B0.D1.87.D0.B0.D0.BB.D0.B0_.D1.80.D0.B0.D0.B1.D0.BE.D1.82.D1.8B" name=".D0.A7.D1.82.D0.BE_.D0.BD.D1.83.D0.B6.D0.BD.D0.BE_.D0.B7.D0.BD.D0.B0.D1.82.D1.8C_.D0.B4.D0.BB.D1.8F_.D0.BD.D0.B0.D1.87.D0.B0.D0.BB.D0.B0_.D1.80.D0.B0.D0.B1.D0.BE.D1.82.D1.8B">Что нужно знать для начала работы</h4> - -<p>Система разработки расширений спроектирована таким образом, что для начала разработки собственного расширения не требуется быть профессиональным программистом. Как бы то ни было, это программирование, поэтому желательно иметь некое представление о принципах работы компьютерных программ вообще и, в частности, быть знакомым с XML. Вообще желательно знание также JavaScript и CSS, однако в этой статье оно вам не понадобится.</p> - -<h3 id=".D0.A1.D0.BE.D0.B7.D0.B4.D0.B0.D0.BD.D0.B8.D0.B5_.D0.BF.D1.80.D0.BE.D0.B5.D0.BA.D1.82.D0.B0_.D1.80.D0.B0.D1.81.D1.88.D0.B8.D1.80.D0.B5.D0.BD.D0.B8.D1.8F" name=".D0.A1.D0.BE.D0.B7.D0.B4.D0.B0.D0.BD.D0.B8.D0.B5_.D0.BF.D1.80.D0.BE.D0.B5.D0.BA.D1.82.D0.B0_.D1.80.D0.B0.D1.81.D1.88.D0.B8.D1.80.D0.B5.D0.BD.D0.B8.D1.8F">Создание проекта расширения</h3> - -<p>Расширения состоят из нескольких файлов и для корректной его работы необходимо придерживаться определённых правил их расположения в директориях. Вот структура типичного расширения:</p> - -<pre class="eval">/myExtension: - /install.rdf - /components/* - /defaults/ - /defaults/preferences/*.js - /plugins/* - /chrome.manifest - /chrome/icons/default/* - /chrome/ - /chrome/content/ -</pre> - -<p>Впрочем, в вашем расширении необязательно должны быть все эти папки. Сейчас мы создадим схожий каркас для нашего расширения. Для начала создадим папку для его хранения (напр. <code>C:\extensions\my_extension\</code> для Windows или <code>~/extensions/my_extension/ для Unix/Linux</code>). Эта папка будет корневой. Создайте в ней подпапку chrome, а в последней - папку content.</p> - -<p>Теперь создайте в корневой папке 2 пустых файла: chrome.manifest и install.rdf.</p> - -<p>Итак, сейчас мы имеем такую структуру расширения:</p> - -<pre><ext path>/ - install.rdf - chrome.manifest - chrome/ - content/ -</pre> - -<p>Для облегчения дальнейшей разработки и тестирования рекомендуем <a href="/en/Setting_up_extension_development_environment">настроить Firefox для разработки расширения</a>.</p> - -<h3 id=".D0.A1.D0.BE.D0.B7.D0.B4.D0.B0.D0.BD.D0.B8.D0.B5_.D1.81.D0.BA.D1.80.D0.B8.D0.BF.D1.82.D0.B0_.28.22.D0.BC.D0.B0.D0.BD.D0.B8.D1.84.D0.B5.D1.81.D1.82.D0.B0.22.29_.D1.83.D1.81.D1.82.D0.B0.D0.BD.D0.BE.D0.B2.D0.BA.D0.B8" name=".D0.A1.D0.BE.D0.B7.D0.B4.D0.B0.D0.BD.D0.B8.D0.B5_.D1.81.D0.BA.D1.80.D0.B8.D0.BF.D1.82.D0.B0_.28.22.D0.BC.D0.B0.D0.BD.D0.B8.D1.84.D0.B5.D1.81.D1.82.D0.B0.22.29_.D1.83.D1.81.D1.82.D0.B0.D0.BD.D0.BE.D0.B2.D0.BA.D0.B8">Создание скрипта ("манифеста") установки</h3> - -<p>Откройте файл <code><a href="/en/Install_Manifests">install.rdf</a></code> в текстовом редакторе и поместите в него следующее:</p> - -<pre class="eval"><?xml version="1.0"?> - -<RDF xmlns="<span class="nowiki">http://www.w3.org/1999/02/22-rdf-syntax-ns#</span>" - xmlns:em="<span class="nowiki">http://www.mozilla.org/2004/em-rdf#</span>"> - - <Description about="urn:mozilla:install-manifest"> - <em:id><strong><a class="link-mailto" href="mailto:sample@example.net" rel="freelink">sample@example.net</a></strong></em:id> - <em:version><strong>1.0</strong></em:version> - <em:type>2</em:type> - - <!-- Target Application this extension can install into, - with minimum and maximum supported versions. --> - <em:targetApplication> - <Description> - <em:id><strong>{ec8030f7-c20a-464f-9b0e-13a3a9e97384}</strong></em:id> - <em:minVersion><strong>1.5</strong></em:minVersion> - <em:maxVersion><strong>2.0.0.*</strong></em:maxVersion> - </Description> - </em:targetApplication> - - <!-- Front End MetaData --> - <em:name><strong>sample</strong></em:name> - <em:description><strong>A test extension</strong></em:description> - <em:creator><strong>Your Name Here</strong></em:creator> - <em:homepageURL><strong><span class="nowiki">http://www.example.com/</span></strong></em:homepageURL> - </Description> -</RDF> -</pre> - -<p>Как видите, этот файл имеет вид XML-файла. Полное описание необходимых и возможных параметров есть <a href="/en/Install_Manifests">здесь</a>, сейчас же отметим лишь, что этот файл предназначен для общего описания расширения, например, уникальный идентификатор расширения, его версию, имя, автора, информацию о совместимости и т.п. Назначение многих параметров понятно из их названия. Что необходимо знать сейчас:</p> - -<ul> - <li><strong><a class="link-mailto" href="mailto:sample@example.net" rel="freelink">sample@example.net</a></strong> - уникальный идентификатор вашего расширения. Это может быть адрес электронной почты (как здесь) или GUID. Обратите внимание, что адрес может быть несуществующим, главное, чтобы он был уникальным.</li> -</ul> - -<ul> - <li><strong>2</strong> - указывает, что это именно расширение (связано с тем, что такие же манифесты создаются для тем и плагинов).</li> -</ul> - -<ul> - <li><strong>{ec8030f7-c20a-464f-9b0e-13a3a9e97384}</strong> - идентификатор Firefox (конечно, он одинаковый для всех расширений).</li> -</ul> - -<ul> - <li><strong>1.5</strong> - минимальная версия Firefox, с которой будет работать ваше приложение. Обратите внимание, что указать здесь какой-либо номер не значит автоматически сделать расширение работающим с этой версией. Это лишь означает, что вы, как разработчик, утверждаете, что расширение будет работать с ней, а вот будет ли так, зависит только от вас.</li> -</ul> - -<ul> - <li><strong>2.0.0.*</strong> - максимальный номер версии Firefox. * означает, что включаются все версии, имеющие вид 2.0.0.x, где x - любое число.</li> -</ul> - -<h3 id=".D0.A0.D0.B0.D1.81.D1.88.D0.B8.D1.80.D0.B5.D0.BD.D0.B8.D0.B5_.D0.B1.D1.80.D0.B0.D1.83.D0.B7.D0.B5.D1.80.D0.B0_.D1.81_.D0.BF.D0.BE.D0.BC.D0.BE.D1.89.D1.8C.D1.8E_XUL" name=".D0.A0.D0.B0.D1.81.D1.88.D0.B8.D1.80.D0.B5.D0.BD.D0.B8.D0.B5_.D0.B1.D1.80.D0.B0.D1.83.D0.B7.D0.B5.D1.80.D0.B0_.D1.81_.D0.BF.D0.BE.D0.BC.D0.BE.D1.89.D1.8C.D1.8E_XUL">Расширение браузера с помощью XUL</h3> - -<p>Интерфейс Firefox написан на XUL и JavaScript. <a href="/ru/XUL" title="ru/XUL">XUL</a> - это язык, основанный на XML. Он отвечает за визуальную часть интерфейса. JavaScript реализует функциональность через привязку к действиям пользователя.</p> - -<p>Так как визуально браузер строится на XUL, то, следовательно, он весь представляется в виде XML-файла. Вы можете посмотреть на него (это будет полезно для чёткого понимания своих дальнейших действий). Зайдите в папку установки Firefox, откройте там папку chrome. В ней будет <code>browser.jar</code>. Несмотря на расширение, этот файл - обычный zip-архив. Внутри него вы найдёте файл <code>content/browser/browser.xul</code>. Открыв его, можно полюбоваться на общую структуру визуальной части браузера. Пусть вас не смущает большое количество непонятных пока строк - во всем разберётесь позже. Собственно, корневым узлом этого XML-файла является элемент <code>window</code>, содержащиеся в нем узлы - это отдельные элементы интерфейса. Например, вы можете найти кнопку обновления страницы (поищите узел с <code>id="reload-button"</code>) или пункт меню "Правка" (<code>id="edit-menu"</code>).</p> - -<p>Так вот, суть расширения интерфейса браузера состоит в том, что мы берём некий узел из браузера, описываем его в своём файле с необходимыми нам изменениями, например, добавляя к нему новые дочерние узлы. Таким образом можно добавить новые кнопки в панель инструментов (или создать новую панель и поместить её в нужное место), добавить новый пункт меню (как рядом со "Справкой" так и в подменю, скажем, "Инструменты" (Tools)). Это технология называется <a href="/en/XUL_Overlays">en:XUL Overlays</a>.</p> - -<p>В нашем случае мы добавим новый элемент в строку статуса. В файле <code>browser.xul</code> можно найти узел с <code>id="status-bar"</code>. Это и есть строка статуса. В этом узле есть несколько дочерних узлов. Добавим к ним наш, который будет описывать новую панель. Создайте файл, назовите его, скажем, <code><strong>sample.xul</strong></code> и поместите в папку <code>chrome/content</code>. Внесите туда такой код:</p> - -<pre class="eval"><?xml version="1.0"?> -<overlay id="sample" - xmlns="<span class="nowiki">http://www.mozilla.org/keymaster/gatekeeper/there.is.only.xul</span>"> - <statusbar id="<strong>status-bar</strong>"> - <statusbarpanel id="my-panel" label="Hello, World"/> - </statusbar> -</overlay> -</pre> - -<p>Здесь <code><statusbar></code> с <code>id="status-bar"</code> является "точкой склейки" (merge point), т.е. узлом, который мы намереваемся изменить. <code><statusbarpanel></code> - новый виджет, который мы добавляем в <code><statusbar></code>.</p> - -<h3 id="URI_Chrome" name="URI_Chrome">URI Chrome</h3> - -<p>XUL-файлы (вроде того, который мы только что создали) загружаются через URI протокола chrome://. Вместо того, чтобы каждый раз определять место установки Firefox и загружать файлы через <code>file://</code>, можно загружать их через <code>chrome://</code>, не беспокоясь об их истинном положении на диске.</p> - -<p>Так, окно браузера, которое мы недавно просматривали, находится по адресу <code><a class="external" rel="freelink">chrome://browser/content/browser.xul</a></code>. Можете попробовать ввести его в адресную строку и посмотреть на результат.</p> - -<p>URI хрома состоит из нескольких частей:</p> - -<ul> - <li>протокол <code>chrome</code> говорит, что необходимо классифицировать и обработать содержимое файла как хром.</li> - <li>название пакета (в данном случае, это <code>browser</code>), указывающий на "свёрток" (bundle) компонентов интерфейса. Это название уникально для каждого приложения/расширения.</li> - <li>тип запрашиваемых данных. Есть три типа: <code>content</code> (XUL, JavaScript, XBL Bindings и др., т.е. компоненты, формирующие вид и поведение интерфейса), <code>locale</code> (DTD, файлы propeties и т.п., производящие локализацию интерфейса) и <code>skin</code> (CSS и изображения для формирования темы интерфейса).</li> - <li>файл для загрузки.</li> -</ul> - -<p>Так, например, <code><a class="external" rel="freelink">chrome://foo/skin/bar.png</a></code> загружает файл <code>bar.png</code> из секции <code>skin</code> пакета <code>foo</code>.</p> - -<h3 id=".D0.A1.D0.BE.D0.B7.D0.B4.D0.B0.D0.BD.D0.B8.D0.B5_.D0.BC.D0.B0.D0.BD.D0.B8.D1.84.D0.B5.D1.81.D1.82.D0.B0_chrome" name=".D0.A1.D0.BE.D0.B7.D0.B4.D0.B0.D0.BD.D0.B8.D0.B5_.D0.BC.D0.B0.D0.BD.D0.B8.D1.84.D0.B5.D1.81.D1.82.D0.B0_chrome">Создание манифеста chrome</h3> - -<p>Для хорошего понимания манифеста просмотрите статью <a href="/en/Chrome_Manifest">en:Chrome Manifest</a></p> - -<p>Откройте <code>chrome.manifest</code>, созданный нами ранее и добавьте в него следующее:</p> - -<pre class="eval">content sample chrome/content/ -</pre> - -<p><strong>Не забудьте завершающий слеш.</strong></p> - -<p>Эта строка объявляет</p> - -<ol> - <li>тип данных в пакете chrome,</li> - <li>название пакета (используйте лишь строчные буквы),</li> - <li>путь к файлам пакета.</li> -</ol> - -<p>Таким образом, здесь мы говорим, что файлы типа <code>content</code> для пакета <code>sample</code> можно найти в <code>chrome/content</code> (путь относительно местоположения <code>chrome.manifest</code>).</p> - -<p>Сохраните файл. Позже, при запуске Firefox, пакет <code>chrome</code> вашего расширения будет зарегистрирован с помощью этого файла.</p> - -<h3 id=".D0.A0.D0.B5.D0.B3.D0.B8.D1.81.D1.82.D1.80.D0.B0.D1.86.D0.B8.D1.8F_.D0.BE.D0.B2.D0.B5.D1.80.D0.BB.D0.B5.D1.8F" name=".D0.A0.D0.B5.D0.B3.D0.B8.D1.81.D1.82.D1.80.D0.B0.D1.86.D0.B8.D1.8F_.D0.BE.D0.B2.D0.B5.D1.80.D0.BB.D0.B5.D1.8F">Регистрация оверлея</h3> - -<p>Для того, чтобы Firefox понял, что у нас есть оверлей и мы хотим наложить его на окно браузера, необходимо зарегистрировать оверлей через все тот же chrome.manifest. Добавляем в него строку</p> - -<pre class="eval">overlay <a class="external" rel="freelink">chrome://browser/content/browser.xul</a> <a class="external" rel="freelink">chrome://sample/content/sample.xul</a> -</pre> - -<p>Это говорит Firefox, что нужно объединить <code>sample.xul</code> и <code>browser.xul</code></p> - -<h3 id=".D0.A2.D0.B5.D1.81.D1.82.D0.B8.D1.80.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5" name=".D0.A2.D0.B5.D1.81.D1.82.D0.B8.D1.80.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5">Тестирование</h3> - -<p>Для начала необходимо уведомить Firefox о нашем расширении. Раньше (ещё во времена Firefox 1.0) необходимо было упаковать расширение как <a href="/en/XPI">en:XPI</a> и установить через интерфейс браузера. Теперь же достаточно просто указать Firefox, где находится папка с вашим расширением - и он будет подключать его каждый раз при загрузке.</p> - -<p>Итак, ваши действия:</p> - -<ol> - <li>Найдите папку с вашим профилем. Если вы не создавали его специально, браузер использует профиль по умолчанию.<br> - <a class="external" href="http://kb.mozillazine.org/Profile_folder">Как найти папку с профилем.</a></li> - <li>Откройте папку <code>extensions</code>. Если её нет, создайте её.</li> - <li>Создайте новый текстовый файл и поместите в него лишь путь к вашему расширению (напр., <code>C:\extensions\my_extension\</code> для Windows или <code>~/extensions/my_extension/</code> для Unix/Linux). Сохраните файл под именем, одинаковым с <code>id</code> вашего расширения.</li> -</ol> - -<p><strong>Примечания:</strong></p> - -<ul> - <li>Не забудьте завершающий слеш.</li> - <li>Возможно возникновение проблем из-за знаков нижнего подчёркивания в названии; если так вышло измените его.</li> -</ul> - -<p>Теперь вы готовы к тестированию вашего расширения. Запустите Firefox. Он увидит ссылку к вашему расширению и установит его. Если все прошло успешно, вы увидите надпись "Hello, World!" в строке статуса справа. Для внесения изменений достаточно править <code>xul</code>-файлы и перезапустить Firefox.</p> - -<h3 id=".D0.A3.D0.BF.D0.B0.D0.BA.D0.BE.D0.B2.D0.BA.D0.B0_.D1.80.D0.B0.D1.81.D1.88.D0.B8.D1.80.D0.B5.D0.BD.D0.B8.D1.8F" name=".D0.A3.D0.BF.D0.B0.D0.BA.D0.BE.D0.B2.D0.BA.D0.B0_.D1.80.D0.B0.D1.81.D1.88.D0.B8.D1.80.D0.B5.D0.BD.D0.B8.D1.8F">Упаковка расширения</h3> - -<p>Теперь можно упаковать расширение для его дальнейшего распространения и установки.</p> - -<p>Создайте zip-архив из содержания корневой папки вашего расширения (но не архивируйте саму папку). Переименуйте файл, чтобы он имел расширение <code>".xpi"</code>. Вот и все. Для установки достаточно перетащить файл на окно браузера.</p> - -<h4 id=".D0.A3.D1.81.D1.82.D0.B0.D0.BD.D0.BE.D0.B2.D0.BA.D0.B0_.D1.81_.D0.B2.D0.B5.D0.B1-.D1.81.D1.82.D1.80.D0.B0.D0.BD.D0.B8.D1.86.D1.8B" name=".D0.A3.D1.81.D1.82.D0.B0.D0.BD.D0.BE.D0.B2.D0.BA.D0.B0_.D1.81_.D0.B2.D0.B5.D0.B1-.D1.81.D1.82.D1.80.D0.B0.D0.BD.D0.B8.D1.86.D1.8B">Установка с веб-страницы</h4> - -<p>Есть несколько способов это сделать. Можно разместить прямую ссылку на <code>xpi</code>-файл. Однако предпочтительным является <a href="/en/Installing_Extensions_and_Themes_From_Web_Pages">InstallTrigger method</a>, как более удобный для пользователей.</p> - -<h4 id=".D0.A1.D0.B0.D0.B9.D1.82_.D1.80.D0.B0.D1.81.D1.88.D0.B8.D1.80.D0.B5.D0.BD.D0.B8.D0.B9_addons.mozilla.org" name=".D0.A1.D0.B0.D0.B9.D1.82_.D1.80.D0.B0.D1.81.D1.88.D0.B8.D1.80.D0.B5.D0.BD.D0.B8.D0.B9_addons.mozilla.org">Сайт расширений addons.mozilla.org</h4> - -<p>Сайт расширений Mozilla (<a class="external" href="http://addons.mozilla.org" rel="freelink">http://addons.mozilla.org</a>) является местом, где вы можете бесплатно разместить своё расширение. Сайт является надёжным и удобным местом для распространения своих расширений: достаточно лишь зарегистрироваться - и вы сможете загружать свои файлы на сервер.</p> - -<h4 id=".D0.A0.D0.B5.D0.B3.D0.B8.D1.81.D1.82.D1.80.D0.B8.D1.80.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_.D1.80.D0.B0.D1.81.D1.88.D0.B8.D1.80.D0.B5.D0.BD.D0.B8.D1.8F_.D0.B2_.D1.80.D0.B5.D0.B5.D1.81.D1.82.D1.80.D0.B5_Windows" name=".D0.A0.D0.B5.D0.B3.D0.B8.D1.81.D1.82.D1.80.D0.B8.D1.80.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_.D1.80.D0.B0.D1.81.D1.88.D0.B8.D1.80.D0.B5.D0.BD.D0.B8.D1.8F_.D0.B2_.D1.80.D0.B5.D0.B5.D1.81.D1.82.D1.80.D0.B5_Windows">Регистрирование расширения в реестре Windows</h4> - -<p>В Windows информация о расширении может быть добавлена в реестр. Это даёт дополнительный возможности при установке расширений. Подробнее об этом читайте здесь.</p> - -<h3 id=".D0.A3.D0.B7.D0.BD.D0.B0.D0.B9.D1.82.D0.B5_.D0.B1.D0.BE.D0.BB.D1.8C.D1.88.D0.B5_.D0.BE.D0.B1_.D0.BE.D0.B2.D0.B5.D1.80.D0.BB.D0.B5.D1.8F.D1.85_XUL" name=".D0.A3.D0.B7.D0.BD.D0.B0.D0.B9.D1.82.D0.B5_.D0.B1.D0.BE.D0.BB.D1.8C.D1.88.D0.B5_.D0.BE.D0.B1_.D0.BE.D0.B2.D0.B5.D1.80.D0.BB.D0.B5.D1.8F.D1.85_XUL">Узнайте больше об оверлеях XUL</h3> - -<p>В настоящем руководстве была затронута лишь крохотная часть всех возможностей модифицирования интерфейса с помощью XUL. Чтобы узнать больше, смотрите <a href="/ru/XUL" title="ru/XUL"> документацию XUL</a>.</p> - -<h3 id=".D0.9B.D0.BE.D0.BA.D0.B0.D0.BB.D0.B8.D0.B7.D0.B0.D1.86.D0.B8.D1.8F" name=".D0.9B.D0.BE.D0.BA.D0.B0.D0.BB.D0.B8.D0.B7.D0.B0.D1.86.D0.B8.D1.8F">Локализация</h3> - -<p>Для поддержки более чем одного языка необходимо отделить локализуемые строки от основного содержания с помощью сущностей (entities) и "свёртков строк" (string bundles). Гораздо проще делать это в течение разработки расширения, чем после.</p> - -<p>Информация о локализации хранится в подпапке <code>locale</code> папки chrome (т.е. рядом с папкой <code>content</code>). В этой папке необходимо разместить столько папок, сколько локализаций вы намерены сделать. Обычной практикой является называть папки стандартными названиями локалей: скажем, папку с английской локализацией - <code>en-US</code>, русской - <code>ru-RU</code> и т.п., что, впрочем, не является обязательным. Теперь создайте в каждой из папок файл <code>somename.ent</code> (или <code>anothername.dtd</code>) (<em>имя одинаково во всех папках локализаций</em>) и заполните его соответствующим образом (показано ниже).</p> - -<p>Локализуем наше расширение на русский и английский языки. После создания 2 папок (назовём их <code>ru-RU</code> и <code>en-US</code>), создаём в каждой из них файл (пусть <code>myStatusBar.ent</code>) Поместите в тот файл, который в папке с английской локализацией, следующую строку:</p> - -<pre class="eval"><!ENTITY statusbarpanel.label "Hello, World!"> -</pre> - -<p>А в тот, который будет локализовать на русский язык, соответственно</p> - -<pre class="eval"><!ENTITY statusbarpanel.label "Привет, мир!"> -</pre> - -<p>Сохраните оба файла. Теперь необходимо зарегистрировать локализации. Для этого добавим в <code>chrome.manifest</code> следующие строки:</p> - -<pre class="eval">locale sample en-US chrome/locale/en-US/ -locale sample ru-RU chrome/locale/ru-RU/ -</pre> - -<p>Теперь для использования локализации достаточно добавить в начало (однако после <code>xml</code>-объявления) <code>xul</code>-файла строку</p> - -<pre class="eval"><!DOCTYPE window SYSTEM "<a class="external" rel="freelink">chrome://sample/locale/myStatusBar.ent</a>"> -</pre> - -<p>где <code>window</code> - это названия корневого элемента <code>xul</code>-документа (в нашем случае это <code>overlay</code>).</p> - -<p>Для использования сущностей измените ваш <code>xul</code>-файл так, чтобы атрибут <code>label</code> у новой <code>statusbarpanel</code> был равен <code>"&statusbarpanel.label;"</code>.</p> - -<h3 id=".D0.98.D1.81.D1.81.D0.BB.D0.B5.D0.B4.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_.D0.B1.D1.80.D0.B0.D1.83.D0.B7.D0.B5.D1.80.D0.B0" name=".D0.98.D1.81.D1.81.D0.BB.D0.B5.D0.B4.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_.D0.B1.D1.80.D0.B0.D1.83.D0.B7.D0.B5.D1.80.D0.B0">Исследование браузера</h3> - -<p>Гораздо более простым (и эффективным) способом исследования браузера является использование <em>DOM Inspector'а</em>. Он позволяет полностью изучить структуру документа, загруженного в браузер. Так, например, можно загрузить вышеописанным способом <code>browser.xul</code>, просмотреть все его узлы и найти подходящий для наложения оверлея. Или же можно просматривать структуру своего расширения.</p> - -<h3 id=".D0.9E.D1.82.D0.BB.D0.B0.D0.B4.D0.BA.D0.B0_.D1.80.D0.B0.D1.81.D1.88.D0.B8.D1.80.D0.B5.D0.BD.D0.B8.D0.B9" name=".D0.9E.D1.82.D0.BB.D0.B0.D0.B4.D0.BA.D0.B0_.D1.80.D0.B0.D1.81.D1.88.D0.B8.D1.80.D0.B5.D0.BD.D0.B8.D0.B9">Отладка расширений</h3> - -<p><strong>Инструменты для анализа расширений</strong></p> - -<ul> - <li><a href="/en/DOM_Inspector">en:DOM Inspector</a></li> - <li><a href="/en/Venkman">en:Venkman</a> - установка точек прерываний и просмотр стеков вызова</li> - <li><code><a href="/en/Core_JavaScript_1.5_Reference/Objects/Function/arguments/callee">arguments.callee</a>.<a href="/en/Core_JavaScript_1.5_Reference/Objects/Function/caller">caller</a></code> в JavaScript - доступ к стеку функций</li> -</ul> - -<p><strong>Отладочная распечатка</strong></p> - -<ul> - <li><code><a href="/en/DOM/window.dump">dump</a>("string")</code></li> - <li><code><a href="/en/nsIConsoleService">en:nsIConsoleService</a></code></li> -</ul> - -<h3 id=".D0.94.D0.BE.D0.BF.D0.BE.D0.BB.D0.BD.D0.B8.D1.82.D0.B5.D0.BB.D1.8C.D0.BD.D0.B0.D1.8F_.D0.B8.D0.BD.D1.84.D0.BE.D1.80.D0.BC.D0.B0.D1.86.D0.B8.D1.8F" name=".D0.94.D0.BE.D0.BF.D0.BE.D0.BB.D0.BD.D0.B8.D1.82.D0.B5.D0.BB.D1.8C.D0.BD.D0.B0.D1.8F_.D0.B8.D0.BD.D1.84.D0.BE.D1.80.D0.BC.D0.B0.D1.86.D0.B8.D1.8F">Дополнительная информация</h3> - -<ul> - <li><a href="/en/Extension_FAQ">en:Extension FAQ</a></li> - <li><a href="/ru/Расширения" title="ru/Расширения">Extensions</a></li> -</ul> diff --git a/files/ru/orphaned/создание_расширения/настройка_firefox_для_разработки/index.html b/files/ru/orphaned/создание_расширения/настройка_firefox_для_разработки/index.html deleted file mode 100644 index 05155b96e9..0000000000 --- a/files/ru/orphaned/создание_расширения/настройка_firefox_для_разработки/index.html +++ /dev/null @@ -1,26 +0,0 @@ ---- -title: Настройка Firefox для разработки -slug: orphaned/Создание_расширения/Настройка_Firefox_для_разработки -original_slug: Создание_расширения/Настройка_Firefox_для_разработки ---- -<p style="text-align: justify;">Перед созданием собственного расширения рекомендуется для этого настроить Firefox. Нужно это для того, чтобы не потерять важные данные и не сбить настройки на повседневном профиле браузера из-за неудачного опыта с расширением.</p> -<h2 id="Создание_экспериментального_профиля">Создание экспериментального профиля</h2> -<p>В Firefox имеется очень удобный менеджер профилей. С его помощью мы и создадим экспериментальный профиль на котором будем испытывать наши расширения.</p> -<p>Для того, чтобы вызвать менеджер профилей:</p> -<ul> <li>В Microsoft Windows:</li> -</ul> -<ol> <li>Нажмите кнопку "Пуск".</li> <li>Выберите пункт "Выполнить".</li> <li>Введите в строку "firefox -p" (без кавычек).</li> -</ol> -<ul> <li>В Linux:</li> -</ul> -<ol> <li>Откройте терминал.</li> <li>Введите "firefox -p".</li> -</ol> -<p style="text-align: justify;">В открывшемся окне менеджера профилей нажмите кнопку "Создать". Далее следуйте инструкциям в менеджере. Он вам предложит ввести для нового профиля название, для нашего пусть будет "Develop" (это уже на ваше усмотрение), а так же предложит выбрать папку, где будет наш профиль храниться. Для папки экспериментального профиля подойдёт открытое и, главное, доступное место, потому что может потребоваться в нем что-нибудь изменить руками или добавить какой-нибудь файл.</p> -<p style="text-align: justify;">После того, как профиль создан, нажимаем на "Запуск Firefox". После запуска браузера вводим в адресную строку "about:config" и нажимаем Enter. На это браузер нам выдаст окно с предупреждением о возможности испортить программу, мы пообещаем ему быть осторожными.</p> -<p style="text-align: justify;">В открывшемся меню вы увидите множество строк с настройками браузера. Но в настройках "по умолчанию" вписаны не все нужные нам строки - ведь в повседневной жизни они не нужны. Для полноценной настройки экспериментального профиля Firefox следует добавить в настройки некоторые параметры. Для этого достаточно нажать правую кнопку мыши в любом месте списка и выбрать из контекстного меню пункт "Создать" --> "Логичкеское".</p> -<ul> <li><strong>javascript.options.showInConsole = true </strong>- запись ошибок в файлах chrome в <a href="/en/Error_Console" title="en/Error_Console">консоль ошибок (англ.)</a>.</li> <li><strong>nglayout.debug.disable_xul_cache = true </strong>- выключение кеширования xul-объектов. При внесении изменений в окна и диалоги не потребуется перезапуск браузера. Однако, работает только при использовании простых папок, а не jar-архивов. Внесение же изменений в xul-оверлеи все таки потребует перезапуска браузера.</li> <li><strong>browser.dom.window.dump.enabled = true </strong>- позволяет выводить в стандартную консоль состояние дампа. Для получения информации смотри <a href="/en/DOM/window.dump">window.dump (англ.)</a></li> <li><strong>javascript.options.strict = true</strong> - принудительный вывод в консоль всех предупреждений JavaScript.</li> <li><strong>extensions.logging.enabled = true</strong> - вывод информации об инсталляции и обновлении в консоль ошибок.</li> -</ul> -<h2 id="Расширения_разработчика">Расширения разработчика</h2> -<p style="text-align: justify;">При создании собственных расширений могут быть очень полезными следующие дополнения для Firefox:</p> -<ul> <li><a class=" link-https" href="https://addons.mozilla.org/ru/firefox/addon/6622">DOM Inspector</a></li> <li><a class=" link-https" href="https://addons.mozilla.org/ru/firefox/addon/216">JavaScript Debugger</a></li> <li><a class=" link-https" href="https://addons.mozilla.org/ru/firefox/addon/7434">Extension Developer</a></li> <li><a class=" link-https" href="https://addons.mozilla.org/ru/firefox/addon/1815">Console<sup>2</sup></a></li> <li><a class=" link-https" href="https://addons.mozilla.org/ru/firefox/addon/4453">Chrome List</a></li> <li><a class=" link-https" href="https://addons.mozilla.org/ru/firefox/addon/1843">Firebug</a></li> <li><a class=" link-https" href="https://addons.mozilla.org/ru/firefox/addon/1729">Execute JS</a></li> <li><a class=" external" href="http://xpcomviewer.mozdev.org/">XPCOM Viewer</a></li> -</ul> diff --git a/files/ru/orphaned/создание_расширения/настройка_firefox_для_разработки_расширений/index.html b/files/ru/orphaned/создание_расширения/настройка_firefox_для_разработки_расширений/index.html deleted file mode 100644 index d3ea9e3902..0000000000 --- a/files/ru/orphaned/создание_расширения/настройка_firefox_для_разработки_расширений/index.html +++ /dev/null @@ -1,16 +0,0 @@ ---- -title: Настройка Firefox для разработки расширений -slug: orphaned/Создание_расширения/Настройка_Firefox_для_разработки_расширений -original_slug: Создание_расширения/Настройка_Firefox_для_разработки_расширений ---- -<p>Прежде чем начать разработку расширения, желательно настроить для этого Firefox. Нужно это для того, чтобы не потерять нужные данные и не сбить настройки в повседневном профиле Firefox.</p> -<h2 id="Создание_экспериментального_профиля_Firefox">Создание экспериментального профиля Firefox</h2> -<p style="text-align: justify;">Firefox хранит свои настройки в так называемом профиле. Профиль это папка, содержащая файлы в которых и хранятся настройки программы, файлы расширений, локальный кеш браузера, информация о сессиях, файлы пользовательских закладок и прочее.</p> -<p style="text-align: justify;">Для того, чтобы не пришлось восстанавливать свои настройки после неудачного эксперимента с расширением, предлагается (на ваше усмотрение, конечно) сделать профиль, который будет служить специально для разработки расширений и в нем будут внесён ряд небольших, но полезных изменений в глобальных настройках браузера.</p> -<p>Для создания профиля в Microsoft Windows сделайте следующее:</p> -<ul> <li>Закройте все окна Firefox</li> <li>Нажмите кнопку "Пуск"</li> <li>Выберите меню "Выполнить"</li> <li>Впишите в строку "Путь_к_папке\с_программой\firefox.exe -no-remote -P имя_профиля"</li> -</ul> -<p>Для создания профиля в Linux сделайте следующее:</p> -<ul> <li>Откройте терминал</li> <li>Введите там следующее "firefox -no-remote -p имя_профиля"</li> -</ul> -<p>Это должно запустить программу уже с новым профилем. По умолчанию в нем ничего не установлено и все настройки находятся в состоянии "по умолчанию".</p> diff --git a/files/ru/orphaned/создание_расширения_для_firefox_с_использованием_mozilla_build_system/index.html b/files/ru/orphaned/создание_расширения_для_firefox_с_использованием_mozilla_build_system/index.html deleted file mode 100644 index 41af48f7e2..0000000000 --- a/files/ru/orphaned/создание_расширения_для_firefox_с_использованием_mozilla_build_system/index.html +++ /dev/null @@ -1,7 +0,0 @@ ---- -title: Создание расширения для Firefox с использованием Mozilla Build System -slug: orphaned/Создание_расширения_для_Firefox_с_использованием_Mozilla_Build_System -original_slug: Создание_расширения_для_Firefox_с_использованием_Mozilla_Build_System ---- -<p>Существует специальное расширение для создания новых расширений для Firefox. -</p>{{ languages( { "en": "en/Creating_Custom_Firefox_Extensions_with_the_Mozilla_Build_System", "it": "it/Creare_Estensioni_personalizzate_per_Firefox_con_il_sistema_di_sviluppo_di_Mozilla", "ja": "ja/Creating_Custom_Firefox_Extensions_with_the_Mozilla_Build_System" } ) }} diff --git a/files/ru/orphaned/справочная_информация_по_gecko_dom/index.html b/files/ru/orphaned/справочная_информация_по_gecko_dom/index.html deleted file mode 100644 index a86e2fa2dc..0000000000 --- a/files/ru/orphaned/справочная_информация_по_gecko_dom/index.html +++ /dev/null @@ -1,82 +0,0 @@ ---- -title: Справочная информация по Gecko DOM -slug: orphaned/Справочная_информация_по_Gecko_DOM -tags: - - NeedsTechnicalReview - - Справочная_информация_по_Gecko_DOM -original_slug: Справочная_информация_по_Gecko_DOM ---- -<p>Содержание справочной информации по <a href="ru/Gecko">Gecko</a> <a href="ru/DOM">DOM</a>. -</p> -<h4 id=".D0.9F.D1.80.D0.B5.D0.B4.D0.B8.D1.81.D0.BB.D0.BE.D0.B2.D0.B8.D0.B5"> <a href="ru/%d0%a1%d0%bf%d1%80%d0%b0%d0%b2%d0%be%d1%87%d0%bd%d0%b0%d1%8f_%d0%b8%d0%bd%d1%84%d0%be%d1%80%d0%bc%d0%b0%d1%86%d0%b8%d1%8f_%d0%bf%d0%be_Gecko_DOM/%d0%9f%d1%80%d0%b5%d0%b4%d0%b8%d1%81%d0%bb%d0%be%d0%b2%d0%b8%d0%b5">Предисловие</a> </h4> -<ul><li> <a href="ru/%d0%a1%d0%bf%d1%80%d0%b0%d0%b2%d0%be%d1%87%d0%bd%d0%b0%d1%8f_%d0%b8%d0%bd%d1%84%d0%be%d1%80%d0%bc%d0%b0%d1%86%d0%b8%d1%8f_%d0%bf%d0%be_Gecko_DOM/%d0%9f%d1%80%d0%b5%d0%b4%d0%b8%d1%81%d0%bb%d0%be%d0%b2%d0%b8%d0%b5#.D0.9E_.D0.BF.D1.80.D0.B5.D0.B4.D0.B8.D1.81.D0.BB.D0.BE.D0.B2.D0.B8.D0.B8">О предисловии</a> -</li><li> <a href="ru/%d0%a1%d0%bf%d1%80%d0%b0%d0%b2%d0%be%d1%87%d0%bd%d0%b0%d1%8f_%d0%b8%d0%bd%d1%84%d0%be%d1%80%d0%bc%d0%b0%d1%86%d0%b8%d1%8f_%d0%bf%d0%be_Gecko_DOM/%d0%9f%d1%80%d0%b5%d0%b4%d0%b8%d1%81%d0%bb%d0%be%d0%b2%d0%b8%d0%b5#.D0.94.D0.BB.D1.8F_.D0.BA.D0.BE.D0.B3.D0.BE_.D1.8D.D1.82.D0.B0_.D1.81.D1.82.D0.B0.D1.82.D1.8C.D1.8F">Для кого эта статья</a> -</li><li> <a href="ru/%d0%a1%d0%bf%d1%80%d0%b0%d0%b2%d0%be%d1%87%d0%bd%d0%b0%d1%8f_%d0%b8%d0%bd%d1%84%d0%be%d1%80%d0%bc%d0%b0%d1%86%d0%b8%d1%8f_%d0%bf%d0%be_Gecko_DOM/%d0%9f%d1%80%d0%b5%d0%b4%d0%b8%d1%81%d0%bb%d0%be%d0%b2%d0%b8%d0%b5#.D0.A7.D1.82.D0.BE_.D1.82.D0.B0.D0.BA.D0.BE.D0.B5_Gecko.3F">Что такое Gecko?</a> -</li><li> <a href="ru/%d0%a1%d0%bf%d1%80%d0%b0%d0%b2%d0%be%d1%87%d0%bd%d0%b0%d1%8f_%d0%b8%d0%bd%d1%84%d0%be%d1%80%d0%bc%d0%b0%d1%86%d0%b8%d1%8f_%d0%bf%d0%be_Gecko_DOM/%d0%9f%d1%80%d0%b5%d0%b4%d0%b8%d1%81%d0%bb%d0%be%d0%b2%d0%b8%d0%b5#.D0.A1.D0.B8.D0.BD.D1.82.D0.BA.D1.81.D0.B8.D1.81_API">Синтаксис API</a> -</li><li> <a href="ru/%d0%a1%d0%bf%d1%80%d0%b0%d0%b2%d0%be%d1%87%d0%bd%d0%b0%d1%8f_%d0%b8%d0%bd%d1%84%d0%be%d1%80%d0%bc%d0%b0%d1%86%d0%b8%d1%8f_%d0%bf%d0%be_Gecko_DOM/%d0%9f%d1%80%d0%b5%d0%b4%d0%b8%d1%81%d0%bb%d0%be%d0%b2%d0%b8%d0%b5#.D0.98.D1.81.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_.D0.BF.D1.80.D0.B8.D0.BC.D0.B5.D1.80.D0.BE.D0.B2">Использование примеров</a> -</li></ul> -<h4 id=".D0.92.D0.B2.D0.B5.D0.B4.D0.B5.D0.BD.D0.B8.D0.B5"> <a href="ru/%d0%a1%d0%bf%d1%80%d0%b0%d0%b2%d0%be%d1%87%d0%bd%d0%b0%d1%8f_%d0%b8%d0%bd%d1%84%d0%be%d1%80%d0%bc%d0%b0%d1%86%d0%b8%d1%8f_%d0%bf%d0%be_Gecko_DOM/%d0%92%d0%b2%d0%b5%d0%b4%d0%b5%d0%bd%d0%b8%d0%b5">Введение</a> </h4> -<ul><li> <a href="ru/%d0%a1%d0%bf%d1%80%d0%b0%d0%b2%d0%be%d1%87%d0%bd%d0%b0%d1%8f_%d0%b8%d0%bd%d1%84%d0%be%d1%80%d0%bc%d0%b0%d1%86%d0%b8%d1%8f_%d0%bf%d0%be_Gecko_DOM/%d0%92%d0%b2%d0%b5%d0%b4%d0%b5%d0%bd%d0%b8%d0%b5#.D0.A7.D1.82.D0.BE_.D1.82.D0.B0.D0.BA.D0.BE.D0.B5_DOM.3F">Что такое DOM?</a> -</li><li> <a href="ru/%d0%a1%d0%bf%d1%80%d0%b0%d0%b2%d0%be%d1%87%d0%bd%d0%b0%d1%8f_%d0%b8%d0%bd%d1%84%d0%be%d1%80%d0%bc%d0%b0%d1%86%d0%b8%d1%8f_%d0%bf%d0%be_Gecko_DOM/%d0%92%d0%b2%d0%b5%d0%b4%d0%b5%d0%bd%d0%b8%d0%b5#DOM_.D0.B8_JavaScript">DOM и JavaScript</a> -</li><li> <a href="ru/%d0%a1%d0%bf%d1%80%d0%b0%d0%b2%d0%be%d1%87%d0%bd%d0%b0%d1%8f_%d0%b8%d0%bd%d1%84%d0%be%d1%80%d0%bc%d0%b0%d1%86%d0%b8%d1%8f_%d0%bf%d0%be_Gecko_DOM/%d0%92%d0%b2%d0%b5%d0%b4%d0%b5%d0%bd%d0%b8%d0%b5#.D0.9A.D0.B0.D0.BA_.D0.BF.D0.BE.D0.BB.D1.83.D1.87.D0.B8.D1.82.D1.8C_.D0.B4.D0.BE.D1.81.D1.82.D1.83.D0.BF_.D0.BA_DOM.3F">Как получить доступ к DOM?</a> -</li><li> <a href="ru/%d0%a1%d0%bf%d1%80%d0%b0%d0%b2%d0%be%d1%87%d0%bd%d0%b0%d1%8f_%d0%b8%d0%bd%d1%84%d0%be%d1%80%d0%bc%d0%b0%d1%86%d0%b8%d1%8f_%d0%bf%d0%be_Gecko_DOM/%d0%92%d0%b2%d0%b5%d0%b4%d0%b5%d0%bd%d0%b8%d0%b5#.D0.92.D0.B0.D0.B6.D0.BD.D1.8B.D0.B5_.D1.82.D0.B8.D0.BF.D1.8B_.D0.B4.D0.B0.D0.BD.D0.BD.D1.8B.D1.85">Важные типы данных</a> -</li><li> <a href="ru/%d0%a1%d0%bf%d1%80%d0%b0%d0%b2%d0%be%d1%87%d0%bd%d0%b0%d1%8f_%d0%b8%d0%bd%d1%84%d0%be%d1%80%d0%bc%d0%b0%d1%86%d0%b8%d1%8f_%d0%bf%d0%be_Gecko_DOM/%d0%92%d0%b2%d0%b5%d0%b4%d0%b5%d0%bd%d0%b8%d0%b5#.D0.98.D0.BD.D1.82.D0.B5.D1.80.D1.84.D0.B5.D0.B9.D1.81.D1.8B_DOM">Интерфейсы DOM</a> -</li><li> <a href="ru/%d0%a1%d0%bf%d1%80%d0%b0%d0%b2%d0%be%d1%87%d0%bd%d0%b0%d1%8f_%d0%b8%d0%bd%d1%84%d0%be%d1%80%d0%bc%d0%b0%d1%86%d0%b8%d1%8f_%d0%bf%d0%be_Gecko_DOM/%d0%92%d0%b2%d0%b5%d0%b4%d0%b5%d0%bd%d0%b8%d0%b5#.D0.A2.D0.B5.D1.81.D1.82.D0.B8.D1.80.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_DOM_API">Тестирование DOM API</a> -</li></ul> -<h4 id=".D0.A1.D0.BF.D1.80.D0.B0.D0.B2.D0.BE.D1.87.D0.BD.D0.B0.D1.8F_.D0.B8.D0.BD.D1.84.D0.BE.D1.80.D0.BC.D0.B0.D1.86.D0.B8.D1.8F_.D0.BF.D0.BE_DOM_element"> <a href="ru/DOM/element">Справочная информация по DOM element</a> </h4> -<ul><li> <a href="ru/DOM/element#.D0.92.D0.B2.D0.B5.D0.B4.D0.B5.D0.BD.D0.B8.D0.B5">Введение</a> -</li><li> <a href="ru/DOM/element#.D0.A1.D0.B2.D0.BE.D0.B9.D1.81.D1.82.D0.B2.D0.B0">Свойства</a> -</li><li> <a href="ru/DOM/element#.D0.9C.D0.B5.D1.82.D0.BE.D0.B4.D1.8B">Методы</a> -</li><li> <a href="ru/DOM/element#.D0.9E.D0.B1.D1.80.D0.B0.D0.B1.D0.BE.D1.82.D1.87.D0.B8.D0.BA.D0.B8_.D1.81.D0.BE.D0.B1.D1.8B.D1.82.D0.B8.D0.B9">Обработчики событий</a> -</li></ul> -<h4 id=".D0.A1.D0.BF.D1.80.D0.B0.D0.B2.D0.BE.D1.87.D0.BD.D0.B0.D1.8F_.D0.B8.D0.BD.D1.84.D0.BE.D1.80.D0.BC.D0.B0.D1.86.D0.B8.D1.8F_.D0.BF.D0.BE_DOM_window"> <a href="ru/DOM/window">Справочная информация по DOM window</a> </h4> -<ul><li> <a href="ru/DOM/window#.D0.92.D0.B2.D0.B5.D0.B4.D0.B5.D0.BD.D0.B8.D0.B5">Введение</a> -</li><li> <a href="ru/DOM/window#.D0.A1.D0.B2.D0.BE.D0.B9.D1.81.D1.82.D0.B2.D0.B0">Свойства</a> -</li><li> <a href="ru/DOM/window#.D0.9C.D0.B5.D1.82.D0.BE.D0.B4.D1.8B">Методы</a> -</li><li> <a href="ru/DOM/window#.D0.9E.D0.B1.D1.80.D0.B0.D0.B1.D0.BE.D1.82.D1.87.D0.B8.D0.BA.D0.B8_.D1.81.D0.BE.D0.B1.D1.8B.D1.82.D0.B8.D0.B9">Обработчики событий</a> -</li></ul> -<h4 id=".D0.A1.D0.BF.D1.80.D0.B0.D0.B2.D0.BE.D1.87.D0.BD.D0.B0.D1.8F_.D0.B8.D0.BD.D1.84.D0.BE.D1.80.D0.BC.D0.B0.D1.86.D0.B8.D1.8F_.D0.BF.D0.BE_DOM_document"> <a href="ru/DOM/document">Справочная информация по DOM document</a> </h4> -<ul><li> <a href="ru/DOM/document#.D0.92.D0.B2.D0.B5.D0.B4.D0.B5.D0.BD.D0.B8.D0.B5">Введение</a> -</li><li> <a href="ru/DOM/document#.D0.A1.D0.B2.D0.BE.D0.B9.D1.81.D1.82.D0.B2.D0.B0">Свойства</a> -</li><li> <a href="ru/DOM/document#.D0.9C.D0.B5.D1.82.D0.BE.D0.B4.D1.8B">Методы</a> -</li></ul> -<h4 id=".D0.A1.D0.BF.D1.80.D0.B0.D0.B2.D0.BE.D1.87.D0.BD.D0.B0.D1.8F_.D0.B8.D0.BD.D1.84.D0.BE.D1.80.D0.BC.D0.B0.D1.86.D0.B8.D1.8F_.D0.BF.D0.BE_DOM_event"> <a href="ru/DOM/event">Справочная информация по DOM event</a> </h4> -<ul><li> <a href="ru/DOM/event#.D0.92.D0.B2.D0.B5.D0.B4.D0.B5.D0.BD.D0.B8.D0.B5">Введение</a> -</li><li> <a href="ru/DOM/event#.D0.A1.D0.B2.D0.BE.D0.B9.D1.81.D1.82.D0.B2.D0.B0">Свойства</a> -</li><li> <a href="ru/DOM/event#.D0.9C.D0.B5.D1.82.D0.BE.D0.B4.D1.8B">Методы</a> -</li></ul> -<h4 id=".D0.A1.D0.BF.D1.80.D0.B0.D0.B2.D0.BE.D1.87.D0.BD.D0.B0.D1.8F_.D0.B8.D0.BD.D1.84.D0.BE.D1.80.D0.BC.D0.B0.D1.86.D0.B8.D1.8F_.D0.BF.D0.BE_DOM_style"> <a href="ru/DOM/style">Справочная информация по DOM style</a> </h4> -<ul><li> <a href="ru/DOM/style#.D0.97.D0.B0.D0.BC.D0.B5.D1.87.D0.B0.D0.BD.D0.B8.D1.8F">Замечания</a> -</li><li> <a href="ru/DOM/style#.D0.9C.D0.B0.D1.82.D0.B5.D1.80.D0.B8.D0.B0.D0.BB.D1.8B.2C_.D0.BA.D0.BE.D1.82.D0.BE.D1.80.D1.8B.D0.B5_.D0.BD.D1.83.D0.B6.D0.BD.D0.BE_.D0.BF.D0.B5.D1.80.D0.B5.D0.BD.D0.B5.D1.81.D1.82.D0.B8">Материалы, которые нужно перенести</a> -</li></ul> -<h4 id=".D0.A1.D0.BF.D1.80.D0.B0.D0.B2.D0.BE.D1.87.D0.BD.D0.B0.D1.8F_.D0.B8.D0.BD.D1.84.D0.BE.D1.80.D0.BC.D0.B0.D1.86.D0.B8.D1.8F_.D0.BF.D0.BE_DOM_range"> <a href="ru/DOM/range">Справочная информация по DOM range</a> </h4> -<ul><li> <a href="ru/DOM/range#.D0.92.D0.B2.D0.B5.D0.B4.D0.B5.D0.BD.D0.B8.D0.B5">Введение</a> -</li><li> <a href="ru/DOM/range#.D0.A1.D0.B2.D0.BE.D0.B9.D1.81.D1.82.D0.B2.D0.B0">Свойства</a> -</li><li> <a href="ru/DOM/range#.D0.9C.D0.B5.D1.82.D0.BE.D0.B4.D1.8B">Методы</a> -</li></ul> -<h4 id=".D0.A1.D0.BF.D1.80.D0.B0.D0.B2.D0.BE.D1.87.D0.BD.D0.B0.D1.8F_.D0.B8.D0.BD.D1.84.D0.BE.D1.80.D0.BC.D0.B0.D1.86.D0.B8.D1.8F_.D0.BF.D0.BE_DOM_selection"> <a href="ru/DOM/selection">Справочная информация по DOM selection</a> </h4> -<ul><li> <a href="ru/DOM/selection#.D0.92.D0.B2.D0.B5.D0.B4.D0.B5.D0.BD.D0.B8.D0.B5">Введение</a> -</li><li> <a href="ru/DOM/selection#.D0.A1.D0.B2.D0.BE.D0.B9.D1.81.D1.82.D0.B2.D0.B0">Свойства</a> -</li><li> <a href="ru/DOM/selection#.D0.9C.D0.B5.D1.82.D0.BE.D0.B4.D1.8B">Методы</a> -</li></ul> -<h4 id=".D0.98.D0.BD.D1.82.D0.B5.D1.80.D1.84.D0.B5.D0.B9.D1.81_.D1.8D.D0.BB.D0.B5.D0.BC.D0.B5.D0.BD.D1.82.D0.B0_HTML_Form"> <a href="ru/DOM/form">Интерфейс элемента HTML Form</a> </h4> -<ul><li> <a href="ru/DOM/form#.D0.98.D0.BD.D1.82.D0.B5.D1.80.D1.84.D0.B5.D0.B9.D1.81_.D1.8D.D0.BB.D0.B5.D0.BC.D0.B5.D0.BD.D1.82.D0.B0_HTML_Form">Интерфейс элемента HTML Form</a> -</li><li> <a href="ru/DOM/form#.D0.A1.D0.B2.D0.BE.D0.B9.D1.81.D1.82.D0.B2.D0.B0">Свойства</a> -</li><li> <a href="ru/DOM/form#.D0.9C.D0.B5.D1.82.D0.BE.D0.B4.D1.8B">Методы</a> -</li></ul> -<h4 id=".D0.98.D0.BD.D1.82.D0.B5.D1.80.D1.84.D0.B5.D0.B9.D1.81_.D1.8D.D0.BB.D0.B5.D0.BC.D0.B5.D0.BD.D1.82.D0.B0_HTML_Table"> <a href="ru/DOM/table">Интерфейс элемента HTML Table</a> </h4> -<ul><li> <a href="ru/DOM/table#.D0.98.D0.BD.D1.82.D0.B5.D1.80.D1.84.D0.B5.D0.B9.D1.81_.D1.8D.D0.BB.D0.B5.D0.BC.D0.B5.D0.BD.D1.82.D0.B0_HTML_Table">Интерфейс элемента HTML Table</a> -</li><li> <a href="ru/DOM/table#.D0.A1.D0.B2.D0.BE.D0.B9.D1.81.D1.82.D0.B2.D0.B0">Свойства</a> -</li><li> <a href="ru/DOM/table#.D0.9C.D0.B5.D1.82.D0.BE.D0.B4.D1.8B">Методы</a> -</li></ul> -<h4 id=".D0.9F.D1.80.D0.B8.D0.BC.D0.B5.D1.80.D1.8B_.D0.B8.D1.81.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D1.8F_DOM"> <a href="ru/%d0%a1%d0%bf%d1%80%d0%b0%d0%b2%d0%be%d1%87%d0%bd%d0%b0%d1%8f_%d0%b8%d0%bd%d1%84%d0%be%d1%80%d0%bc%d0%b0%d1%86%d0%b8%d1%8f_%d0%bf%d0%be_Gecko_DOM/%d0%9f%d1%80%d0%b8%d0%bc%d0%b5%d1%80%d1%8b">Примеры использования DOM </a> </h4> -<ul><li> <a href="ru/%d0%a1%d0%bf%d1%80%d0%b0%d0%b2%d0%be%d1%87%d0%bd%d0%b0%d1%8f_%d0%b8%d0%bd%d1%84%d0%be%d1%80%d0%bc%d0%b0%d1%86%d0%b8%d1%8f_%d0%bf%d0%be_Gecko_DOM/%d0%9f%d1%80%d0%b8%d0%bc%d0%b5%d1%80%d1%8b#.D0.9F.D1.80.D0.B8.D0.BC.D0.B5.D1.80_1:_height_.D0.B8_width">Пример 1: height и width</a> -</li><li> <a href="ru/%d0%a1%d0%bf%d1%80%d0%b0%d0%b2%d0%be%d1%87%d0%bd%d0%b0%d1%8f_%d0%b8%d0%bd%d1%84%d0%be%d1%80%d0%bc%d0%b0%d1%86%d0%b8%d1%8f_%d0%bf%d0%be_Gecko_DOM/%d0%9f%d1%80%d0%b8%d0%bc%d0%b5%d1%80%d1%8b#.D0.9F.D1.80.D0.B8.D0.BC.D0.B5.D1.80_2:_.D0.90.D1.82.D1.80.D0.B8.D0.B1.D1.83.D1.82.D1.8B_.D0.B8.D0.B7.D0.BE.D0.B1.D1.80.D0.B0.D0.B6.D0.B5.D0.BD.D0.B8.D1.8F">Пример 2: Атрибуты изображения</a> -</li><li> <a href="ru/%d0%a1%d0%bf%d1%80%d0%b0%d0%b2%d0%be%d1%87%d0%bd%d0%b0%d1%8f_%d0%b8%d0%bd%d1%84%d0%be%d1%80%d0%bc%d0%b0%d1%86%d0%b8%d1%8f_%d0%bf%d0%be_Gecko_DOM/%d0%9f%d1%80%d0%b8%d0%bc%d0%b5%d1%80%d1%8b#.D0.9F.D1.80.D0.B8.D0.BC.D0.B5.D1.80_3:_.D0.A0.D0.B0.D0.B1.D0.BE.D1.82.D0.B0_.D1.81.D0.BE_.D1.81.D1.82.D0.B8.D0.BB.D1.8F.D0.BC.D0.B8">Пример 3: Работа со стилями</a> -</li><li> <a href="ru/%d0%a1%d0%bf%d1%80%d0%b0%d0%b2%d0%be%d1%87%d0%bd%d0%b0%d1%8f_%d0%b8%d0%bd%d1%84%d0%be%d1%80%d0%bc%d0%b0%d1%86%d0%b8%d1%8f_%d0%bf%d0%be_Gecko_DOM/%d0%9f%d1%80%d0%b8%d0%bc%d0%b5%d1%80%d1%8b#.D0.9F.D1.80.D0.B8.D0.BC.D0.B5.D1.80_4:_.D0.98.D1.81.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_.D1.82.D0.B0.D0.B1.D0.BB.D0.B8.D1.86_.D1.81.D1.82.D0.B8.D0.BB.D0.B5.D0.B9">Пример 4: Использование таблиц стилей</a> -</li><li> <a href="ru/%d0%a1%d0%bf%d1%80%d0%b0%d0%b2%d0%be%d1%87%d0%bd%d0%b0%d1%8f_%d0%b8%d0%bd%d1%84%d0%be%d1%80%d0%bc%d0%b0%d1%86%d0%b8%d1%8f_%d0%bf%d0%be_Gecko_DOM/%d0%9f%d1%80%d0%b8%d0%bc%d0%b5%d1%80%d1%8b#.D0.9F.D1.80.D0.B8.D0.BC.D0.B5.D1.80_5:_.D0.A0.D0.B0.D1.81.D0.BF.D1.80.D0.BE.D1.81.D1.82.D1.80.D0.B0.D0.BD.D0.B5.D0.BD.D0.B8.D0.B5_.D1.81.D0.BE.D0.B1.D1.8B.D1.82.D0.B8.D0.B9">Пример 5: Распространение событий</a> -</li><li> <a href="ru/%d0%a1%d0%bf%d1%80%d0%b0%d0%b2%d0%be%d1%87%d0%bd%d0%b0%d1%8f_%d0%b8%d0%bd%d1%84%d0%be%d1%80%d0%bc%d0%b0%d1%86%d0%b8%d1%8f_%d0%bf%d0%be_Gecko_DOM/%d0%9f%d1%80%d0%b8%d0%bc%d0%b5%d1%80%d1%8b#.D0.9F.D1.80.D0.B8.D0.BC.D0.B5.D1.80_6:_getComputedStyle">Пример 6: getComputedStyle</a> -</li><li> <a href="ru/%d0%a1%d0%bf%d1%80%d0%b0%d0%b2%d0%be%d1%87%d0%bd%d0%b0%d1%8f_%d0%b8%d0%bd%d1%84%d0%be%d1%80%d0%bc%d0%b0%d1%86%d0%b8%d1%8f_%d0%bf%d0%be_Gecko_DOM/%d0%9f%d1%80%d0%b8%d0%bc%d0%b5%d1%80%d1%8b#.D0.9F.D1.80.D0.B8.D0.BC.D0.B5.D1.80_7:_.D0.92.D1.8B.D0.B2.D0.BE.D0.B4_.D0.BD.D0.B0_.D1.8D.D0.BA.D1.80.D0.B0.D0.BD_.D1.81.D0.B2.D0.BE.D0.B9.D1.81.D1.82.D0.B2_.D0.BE.D0.B1.D1.8A.D0.B5.D0.BA.D1.82.D0.B0_Event">Пример 7: Вывод на экран свойств объекта Event</a> -</li><li> <a href="ru/%d0%a1%d0%bf%d1%80%d0%b0%d0%b2%d0%be%d1%87%d0%bd%d0%b0%d1%8f_%d0%b8%d0%bd%d1%84%d0%be%d1%80%d0%bc%d0%b0%d1%86%d0%b8%d1%8f_%d0%bf%d0%be_Gecko_DOM/%d0%9f%d1%80%d0%b8%d0%bc%d0%b5%d1%80%d1%8b#.D0.9F.D1.80.D0.B8.D0.BC.D0.B5.D1.80_8:_.D0.98.D1.81.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_.D0.B8.D0.BD.D1.82.D0.B5.D1.80.D1.84.D0.B5.D0.B9.D1.81.D0.B0_DOM_.D0.B4.D0.BB.D1.8F_.D1.80.D0.B0.D0.B1.D0.BE.D1.82.D1.8B_.D1.81_.D1.82.D0.B0.D0.B1.D0.BB.D0.B8.D1.86.D0.B0.D0.BC.D0.B8">Пример 8: Использование интерфейса DOM для работы с таблицами</a> -</li></ul> -{{ languages( { "fr": "fr/Reference_du_DOM_Gecko", "ja": "ja/\u0421\u043f\u0440\u0430\u0432\u043e\u0447\u043d\u0430\u044f_\u0438\u043d\u0444\u043e\u0440\u043c\u0430\u0446\u0438\u044f_\u043f\u043e_Gecko_DOM", "ko": "ko/\u0421\u043f\u0440\u0430\u0432\u043e\u0447\u043d\u0430\u044f_\u0438\u043d\u0444\u043e\u0440\u043c\u0430\u0446\u0438\u044f_\u043f\u043e_Gecko_DOM", "pl": "pl/Dokumentacja_Gecko_DOM", "zh-cn": "cn/Gecko_DOM_??" } ) }} diff --git a/files/ru/orphaned/справочная_информация_по_gecko_dom/введение/index.html b/files/ru/orphaned/справочная_информация_по_gecko_dom/введение/index.html deleted file mode 100644 index dbf30ffcbd..0000000000 --- a/files/ru/orphaned/справочная_информация_по_gecko_dom/введение/index.html +++ /dev/null @@ -1,225 +0,0 @@ ---- -title: Введение -slug: orphaned/Справочная_информация_по_Gecko_DOM/Введение -original_slug: Справочная_информация_по_Gecko_DOM/Введение ---- -<p><span id="result_box" lang="ru"><span>В этом разделе представлено краткое концептуальное введение в </span></span><a href="/en-US/docs/DOM" title="DOM">DOM</a><span lang="ru"><span>: что это такое, как он предоставляет структуру для </span></span> <a href="/en-US/docs/HTML" title="HTML">HTML</a><span lang="ru"><span> и </span></span><a href="/en-US/docs/XML" title="XML">XML</a><span lang="ru"><span>-документов, как вы можете получить к нему доступ, и как этот API представляет справочную информацию и примеры.</span></span></p> - -<h2 id="What_is_the_DOM" name="What_is_the_DOM">Что такое DOM?</h2> - -<p><span id="result_box" lang="ru"><span>Document Object Model (DOM) - это программный интерфейс для HTML и XML-документов.</span> <span>Он представляет страницу, чтобы программы могли изменять структуру, стиль и содержание документа.</span> <span>DOM отображает страницу в виде узлов и объектов.</span> <span>Таким образом, языки программирования могут взаимодействовать со страницей.</span></span></p> - -<p>Веб-страница - это документ<span id="result_box" lang="ru"><span>. Этот документ можно либо отобразить в окне браузера, либо в качестве источника HTML</span></span><span id="result_box" lang="ru"><span>.</span> <span>Но в обоих случаях это один и тот же документ.</span></span> <span id="result_box" lang="ru"><span>Объектная модель документа (DOM) представляет этот же документ, таким образом, чтобы им можно было манипулировать.</span> <span>DOM представляет собой объектно-ориентированное представление веб-страницы, которое может быть модифицировано с помощью скриптовых языков, таких как JavaScript.</span></span></p> - -<p><span id="result_box" lang="ru"><span>Стандарты </span></span><a class="external" href="http://www.w3.org/DOM/">W3C DOM</a><span lang="ru"><span> и </span></span><a class="external" href="https://dom.spec.whatwg.org">WHATWG DOM</a><span lang="ru"><span> реализованы в большинстве современных браузеров.</span> <span>Многие браузеры расширяют стандарт, поэтому следует проявлять осторожность при использовании их в Интернете, где к документам могут обращаться различные браузеры с различными DOM.</span></span></p> - -<p>Например, стандарт DOM указывает, что метод <code>getElementsByTagName</code> в коде ниже должен возвращать список всех <code><p></code> элементов в документе:</p> - -<pre class="brush: js">var paragraphs = document.getElementsByTagName("P"); -// paragraphs[0] первый <p>-элемент -// paragraphs[1] второй <p>-элемент и т.д. -alert(paragraphs[0].nodeName); -</pre> - -<p>Все свойства, методы и события, доступные для управления и создания веб-страниц, организованы в объекты (например, объект документа, который представляет сам документ (<code>document</code>), объект таблица (<code>table</code>), который реализует специальный интерфейс DOM <code>HTMLTableElement</code> для доступа к таблицам HTML и т. д. ). Эта документация предоставляет пообъектную справку по DOM, реализованную в браузерах на базе Gecko.</p> - -<h2 id="DOM_and_JavaScript" name="DOM_and_JavaScript">DOM и JavaScript</h2> - -<p><span id="result_box" lang="ru"><span>Краткий пример выше, как и почти все примеры в этом руководстве, - это </span></span><a href="/en-US/docs/JavaScript" title="JavaScript">JavaScript</a>. <span lang="ru"><span>То есть, он <em>написан</em> на JavaScript, но он использует DOM для доступа к документу и его элементам.</span> <span>DOM не является языком программирования, но без него язык JavaScript не имел бы никаких моделей или понятия о веб-страницах, HTML и XML документах, и об их составных частях (например, элементах).</span> <span>Каждый элемент в документе - документ в целом, секция документа head, таблицы внутри документа, заголовки таблиц, текст внутри ячеек таблицы - являются частью объектной модели документа для этого документа, поэтому к ним можно получить доступ и манипулировать ним с помощью</span> <span>DOM и скриптового языка, такого как JavaScript.</span></span></p> - -<p>В начале JavaScript и DOM <span id="result_box" lang="ru"><span>были тесно переплетены, но в конечном итоге они превратились в отдельные сущности.</span> <span>Содержимое страницы хранится в DOM и может быть доступно и обработано через JavaScript, так что мы можем написать приблизительно такое уравнение</span></span>:</p> - -<p>API (HTML или XML страницы) = DOM + JS (скриптовый язык)</p> - -<p><span id="result_box" lang="ru"><span>DOM был разработан, чтобы быть независимым от любого конкретного языка программирования, делая структурное представление документа доступным из единого согласованного API.</span> <span>Хотя мы ориентируемся исключительно на JavaScript в этой справочной документации, реализации DOM могут быть созданы для любого языка, как демонстрирует этот пример Python:</span></span></p> - -<pre class="brush: python"># Python DOM example -import xml.dom.minidom as m -doc = m.parse("C:\\Projects\\Py\\chap1.xml"); -doc.nodeName # DOM property of document object; -p_list = doc.getElementsByTagName("para"); -</pre> - -<p><span id="result_box" lang="ru"><span>Для получения дополнительной информации о том, какие технологии используются для написания JavaScript в Интернете, см.</span></span> <a href="/en-US/docs/Web/JavaScript/JavaScript_technologies_overview">обзор технологий JavaScript</a>.</p> - -<h2 id="How_Do_I_Access_the_DOM.3F" name="How_Do_I_Access_the_DOM.3F">Как получить доступ к DOM?</h2> - -<p><span id="result_box" lang="ru"><span>Вам не нужно делать что-то особенное, чтобы начать использовать DOM.</span> <span>Различные браузеры имеют различные реализации DOM, и эти реализации демонстрируют различную степень соответствия действующему стандарту DOM (тема, которую мы пытаемся избежать в этой документации), но каждый веб-браузер использует некоторую объектную модель документа, чтобы сделать веб-страницы доступными для скрипта</span></span>.</p> - -<p>Когда вы создаёте код, <span id="result_box" lang="ru"><span>независимо от того, встроен ли он в элемент<code> <script></code> или включён в веб-страницу с помощью инструкции по загрузке скрипта извне, вы можете сразу начать использовать API для элементов</span></span> <code><a href="/en-US/docs/DOM/document" title="DOM/document">document</a></code> или <code><a href="/en-US/docs/DOM/window" title="DOM/window">window</a></code> для <span id="result_box" lang="ru"><span>манипулирования самим документом или получить</span> его дочерние элементы<span>, которые являются различными элементами веб-страницы.</span></span> ваше программирование DOM может быть достаточно простым, как, например, следующий код, который выводит предупреждающее сообщение используя функцию <code><a href="/en-US/docs/DOM/window.alert" title="DOM/window.alert">alert()</a></code> из объекта <code><a href="/en-US/docs/DOM/window" title="DOM/window">window</a></code>, <span id="result_box" lang="ru"><span>или может использовать более сложные методы DOM для создания нового контента, как в более длинном примере ниже</span></span>.</p> - -<p>Следующий пример<span id="result_box" lang="ru"><span> кода JavaScript буде выводить предупреждение, когда загрузка документа завершена (и когда весь DOM доступен для использования).</span></span></p> - -<pre class="brush: html"><body onload="window.alert('Welcome to my home page!');"> -</pre> - -<p>Эта функция создаёт новый элемент H1, добавляет в него текст и, затем, добавляет <code>H1</code> в дерево данного документа:</p> - -<pre class="brush: html"><html> - <head> - <script> - // запускает эту функцию, когда документ загружен - window.onload = function() { - - // создаёт пару элементов на пустой веб-странице - var heading = document.createElement("h1"); - var heading_text = document.createTextNode("Big Head!"); - heading.appendChild(heading_text); - document.body.appendChild(heading); - } - </script> - </head> - <body> - </body> -</html> -</pre> - -<h2 id="Important_Data_Types" name="Important_Data_Types">Важные типы данных</h2> - -<p><span id="result_box" lang="ru"><span>Эта руководство пытается описать различные объекты и типы данных как можно проще.</span> <span>Но есть много различных типов данных, которые передаются через API, о которых вы должны знать.</span> <span>Для простоты, примеры синтаксиса в этом руководстве по API обычно называют узловые элементы - элементами</span></span> <code>element</code>, массивам узлов, такие как <code>nodeList</code>, - также элементами <code>element</code>, а атрибуты узлов <code>attribute</code> именуются просто атрибутам.</p> - -<p>Следующая таблица кратко описывает эти типы данных.</p> - -<table class="standard-table"> - <tbody> - <tr> - <td><code>document</code></td> - <td>Когда элемент возвращает объект типа <code>document</code> (например, свойство элемента <strong><code>ownerDocument</code></strong> возвращает <code>document</code>, к которому он принадлежит), этот элемент является корневым объектом документа <code>document</code>. Глава <a href="/en-US/docs/DOM/document" title="DOM/document">Руководство по DOM <code>document</code></a> описывает объект <code>document</code>.</td> - </tr> - <tr> - <td><code>element</code></td> - <td><code>element</code> refers to an element or a node of type <code>element</code> returned by a member of the DOM API. Rather than saying, for example, that the <a href="/en-US/docs/Web/API/Document/createElement">document.createElement()</a> method returns an object reference to a <code>node</code>, we just say that this method returns the <code>element</code> that has just been created in the DOM. <code>element</code> objects implement the DOM <code>Element</code> interface and also the more basic <code>Node</code> interface, both of which are included together in this reference.</td> - </tr> - <tr> - <td><code>nodeList</code></td> - <td>A <code>nodeList</code> is an array of elements, like the kind that is returned by the method <a href="/en-US/docs/Web/API/Document/getElementsByTagName">document.getElementsByTagName()</a>. Items in a <code>nodeList</code> are accessed by index in either of two ways: - <ul> - <li>list.item(1)</li> - <li>list[1]</li> - </ul> - These two are equivalent. In the first, <strong><code>item()</code></strong> is the single method on the <code>nodeList</code> object. The latter uses the typical array syntax to fetch the second item in the list.</td> - </tr> - <tr> - <td><code>attribute</code></td> - <td>When an <code>attribute</code> is returned by a member (e.g., by the <strong><code>createAttribute()</code></strong> method), it is an object reference that exposes a special (albeit small) interface for attributes. Attributes are nodes in the DOM just like elements are, though you may rarely use them as such.</td> - </tr> - <tr> - <td><code>namedNodeMap</code></td> - <td>A <code>namedNodeMap</code> is like an array, but the items are accessed by name or index, though this latter case is merely a convenience for enumeration, as they are in no particular order in the list. A <code>namedNodeMap</code> has an item() method for this purpose, and you can also add and remove items from a <code>namedNodeMap</code>.</td> - </tr> - </tbody> -</table> - -<h2 id="DOM_interfaces" name="DOM_interfaces">Интерфейсы DOM</h2> - -<p>This guide is about the objects and the actual <em>things</em> you can use to manipulate the DOM hierarchy. There are many points where understanding how these work can be confusing. For example, the object representing the <code>HTML form</code> element gets its <strong><code>name</code></strong> property from the <code>HTMLFormElement</code> interface but its <strong><code>className</code></strong> property from the <code>HTMLElement</code> interface. In both cases, the property you want is simply in that form object.</p> - -<p><span id="result_box" lang="ru"><span>Но взаимосвязь между объектами и интерфейсами, которые они реализуют в DOM, может сбить с толку, и поэтому этот раздел пытается немного рассказать о реальных интерфейсах в спецификации DOM и о том, как они становятся доступными.</span></span></p> - -<h3 id="Interfaces_and_Objects" name="Interfaces_and_Objects">Интерфейсы и Объекты</h3> - -<p>Many objects borrow from several different interfaces. The table object, for example, implements a specialized <a href="/en-US/docs/DOM/HTMLTableElement" title="DOM/table">HTML Table Element Interface</a>, which includes such methods as <code>createCaption</code> and <code>insertRow</code>. But since it's also an HTML element, <code>table</code> implements the <code>Element</code> interface described in the <a href="/en-US/docs/DOM/element" title="DOM/element">DOM <code>element</code> Reference</a> chapter. And finally, since an HTML element is also, as far as the DOM is concerned, a node in the tree of nodes that make up the object model for an HTML or XML page, the table object also implements the more basic <code>Node</code> interface, from which <code>Element</code> derives.</p> - -<p>When you get a reference to a <code>table</code> object, as in the following example, you routinely use all three of these interfaces interchangeably on the object, perhaps without knowing it.</p> - -<pre class="brush: js">var table = document.getElementById("table"); -var tableAttrs = table.attributes; // Node/Element interface -for (var i = 0; i < tableAttrs.length; i++) { - // HTMLTableElement interface: border attribute - if(tableAttrs[i].nodeName.toLowerCase() == "border") - table.border = "1"; -} -// HTMLTableElement interface: summary attribute -table.summary = "note: increased border"; -</pre> - -<h3 id="Core_Interfaces_in_the_DOM" name="Core_Interfaces_in_the_DOM">Ключевые Интерфейсы в DOM</h3> - -<p>This section lists some of the most commonly-used interfaces in the DOM. The idea is not to describe what these APIs do here but to give you an idea of the sorts of methods and properties you will see very often as you use the DOM. These common APIs are used in the longer examples in the <a href="/en-US/docs/Gecko_DOM_Reference/Examples" title="Gecko_DOM_Reference/Examples">DOM Examples</a> chapter at the end of this book.</p> - -<p><code>Document</code> и <code>window</code> объекты <span id="result_box" lang="ru"><span>являются объектами, интерфейсы которых наиболее часто используются при программировании DOM.</span></span> Простыми словами, объект <code>window</code> представляет собой что-то вроде браузера, а объект <code>document</code> корень самого документа. <code>Element</code> наследуется от общего интерфейса <code>Node</code>, <span id="result_box" lang="ru"><span>и вместе эти два интерфейса предоставляют множество методов и свойств, которые вы используете для отдельных элементов</span></span>. <span id="result_box" lang="ru"><span>Эти элементы также могут иметь определённые интерфейсы для обработки данных, которые хранятся в этих элементах, как в примере объекта </span></span><code>table</code><span lang="ru"><span>в предыдущем разделе.</span></span></p> - -<p><span id="result_box" lang="ru"><span>Ниже приведён краткий список общих API-интерфейсов в сценариях веб-страниц и XML-страниц с использованием DOM.</span></span></p> - -<ul> - <li><code><a href="/en-US/docs/DOM/document.getElementById" title="DOM/document.getElementById">document.getElementById</a>(id)</code></li> - <li><code>document.<a href="/en-US/docs/Web/API/Element.getElementsByTagName" title="DOM/element.getElementsByTagName">getElementsByTagName</a>(name)</code></li> - <li><code><a href="/en-US/docs/DOM/document.createElement" title="DOM/document.createElement">document.createElement</a>(name)</code></li> - <li><code>parentNode.<a href="/en-US/docs/DOM/Node.appendChild" title="DOM/Node.appendChild">appendChild</a>(node)</code></li> - <li><code>element.<a href="/en-US/docs/DOM/element.innerHTML" title="DOM/element.innerHTML">innerHTML</a></code></li> - <li><code>element.<a href="/en-US/docs/DOM/element.style" title="DOM/element.style">style</a>.left</code></li> - <li><code>element.<a href="/en-US/docs/DOM/element.setAttribute" title="DOM/element.setAttribute">setAttribute</a>()</code></li> - <li><code>element.<a href="/en-US/docs/DOM/element.getAttribute" title="DOM/element.getAttribute">getAttribute</a>()</code></li> - <li><code>element.<a href="/en-US/docs/DOM/element.addEventListener" title="DOM/element.addEventListener">addEventListener</a>()</code></li> - <li><code><a href="/en-US/docs/DOM/window.content" title="DOM/window.content">window.content</a></code></li> - <li><code><a href="/en-US/docs/DOM/window.onload" title="DOM/window.onload">window.onload</a></code></li> - <li><code><a href="/en-US/docs/DOM/window.dump" title="DOM/window.dump">window.dump</a>()</code></li> - <li><code><a href="/en-US/docs/DOM/window.scrollTo" title="DOM/window.scrollTo">window.scrollTo</a>()</code></li> -</ul> - -<h2 id="Testing_the_DOM_API" name="Testing_the_DOM_API">Тестирование DOM API</h2> - -<p>This document provides samples for every interface that you can use in your own web development. In some cases, the samples are complete HTML pages, with the DOM access in a <code><script></code> element, the interface (e.g, buttons) necessary to fire up the script in a form, and the HTML elements upon which the DOM operates listed as well. When this is the case, you can cut and paste the example into a new HTML document, save it, and run the example from the browser.</p> - -<p>There are some cases, however, when the examples are more concise. To run examples that only demonstrate the basic relationship of the interface to the HTML elements, you may want to set up a test page in which interfaces can be easily accessed from scripts. The following very simple web page provides a <code><script></code> element in the header in which you can place functions that test the interface, a few HTML elements with attributes that you can retrieve, set, or otherwise manipulate, and the web user interface necessary to call those functions from the browser.</p> - -<p>You can use this test page or create a similar one to test the DOM interfaces you are interested in and see how they work on the browser platform. You can update the contents of the <code>test()</code> function as needed, create more buttons, or add elements as necessary.</p> - -<pre class="brush: html"><html> - <head> - <title>DOM Tests</title> - <script type="application/javascript"> - function setBodyAttr(attr, value){ - if (document.body) eval('document.body.'+attr+'="'+value+'"'); - else notSupported(); - } - </script> - </head> - <body> - <div style="margin: .5in; height: 400;"> - <p><b><tt>text</tt></b></p> - <form> - <select onChange="setBodyAttr('text', - this.options[this.selectedIndex].value);"> - <option value="black">black - <option value="darkblue">darkblue - </select> - <p><b><tt>bgColor</tt></b></p> - <select onChange="setBodyAttr('bgColor', - this.options[this.selectedIndex].value);"> - <option value="white">white - <option value="lightgrey">gray - </select> - <p><b><tt>link</tt></b></p> - <select onChange="setBodyAttr('link', - this.options[this.selectedIndex].value);"> - <option value="blue">blue - <option value="green">green - </select> <small> - <a href="http://www.brownhen.com/dom_api_top.html" id="sample"> - (sample link)</a></small><br> - </form> - <form> - <input type="button" value="version" onclick="ver()" /> - </form> - </div> - </body> -</html> -</pre> - -<p>To test a lot of interfaces in a single page-for example, a "suite" of properties that affect the colors of a web page-you can create a similar test page with a whole console of buttons, textfields, and other HTML elements. The following screenshot gives you some idea of how interfaces can be grouped together for testing.</p> - -<figure> -<figcaption>Схема 0.1 Sample DOM Test Page</figcaption> -<img alt="Image:DOM_Ref_Introduction_to_the_DOM.gif" class="internal" src="/@api/deki/files/173/=DOM_Ref_Introduction_to_the_DOM.gif"></figure> - -<p>In this example, the dropdown menus dynamically update such DOM-accessible aspects of the web page as its background color (<code>bgColor</code>), the color of the hyperlinks (<code>aLink</code>), and color of the text (<code>text</code>). However you design your test pages, testing the interfaces as you read about them is an important part of learning how to use the DOM effectively.</p> - -<h2 id="Subnav">Subnav</h2> - -<ul> - <li><a href="/en-US/docs/Web/API/Document_Object_Model">DOM Reference</a></li> - <li><a href="/en-US/docs/Web/API/Document_Object_Model/Introduction">Introduction to the DOM</a></li> - <li><a href="/en-US/docs/Web/API/Document_Object_Model/Events">Events and the DOM</a></li> - <li><a href="/en-US/docs/Web/API/Document_Object_Model/Examples">Examples</a></li> -</ul> diff --git a/files/ru/orphaned/справочная_информация_по_gecko_dom/предисловие/index.html b/files/ru/orphaned/справочная_информация_по_gecko_dom/предисловие/index.html deleted file mode 100644 index 1a364396b0..0000000000 --- a/files/ru/orphaned/справочная_информация_по_gecko_dom/предисловие/index.html +++ /dev/null @@ -1,65 +0,0 @@ ---- -title: Предисловие -slug: orphaned/Справочная_информация_по_Gecko_DOM/Предисловие -original_slug: Справочная_информация_по_Gecko_DOM/Предисловие ---- -<p> </p> - -<h3 id=".D0.9E_.D0.BF.D1.80.D0.B5.D0.B4.D0.B8.D1.81.D0.BB.D0.BE.D0.B2.D0.B8.D0.B8" name=".D0.9E_.D0.BF.D1.80.D0.B5.D0.B4.D0.B8.D1.81.D0.BB.D0.BE.D0.B2.D0.B8.D0.B8">О предисловии</h3> - -<p>В этом параграфе описывается руководство в целом: для кого оно, как представлена информация, и как вы можете использовать примеры статьи в своих собственных разработках.</p> - -<p>Заметьте, что этот документ находится на стадии разработки и на данный момент не является полным списком всех DOM-методов и свойств доступных в Gecko. Тем не менее, каждый параграф документа является полным для описываемого объекта. Как только справочная информация к различным API станет доступной, она будет добавлена.</p> - -<h3 id=".D0.94.D0.BB.D1.8F_.D0.BA.D0.BE.D0.B3.D0.BE_.D1.8D.D1.82.D0.B0_.D1.81.D1.82.D0.B0.D1.82.D1.8C.D1.8F" name=".D0.94.D0.BB.D1.8F_.D0.BA.D0.BE.D0.B3.D0.BE_.D1.8D.D1.82.D0.B0_.D1.81.D1.82.D0.B0.D1.82.D1.8C.D1.8F">Для кого эта статья</h3> - -<p>Читатель должен быть веб-разработчиком или продвинутым веб-пользователем и иметь представление об устройстве веб-страниц. Эта статья не предполагает знакомства читателя с DOM, <a href="ru/XML">XML</a>, веб-сервисами, веб-стандартами и даже с <a href="ru/JavaScript">JavaScript</a>, языком, через который DOM доступен читателю. Но подразумевается знакомство с <a href="ru/HTML">HTML</a>, разметкой, базовой структурой веб-страниц, браузерами и таблицами стилей.</p> - -<p>Здесь представлен вводный материал с большим количеством примеров и хорошо организованными объяснениями, который должен пригодиться начинающим и продвинутым разработчикам. Эта статья является не только руководством для начинающих. В основном этот документ является справочным руководством по API.</p> - -<h3 id=".D0.A7.D1.82.D0.BE_.D1.82.D0.B0.D0.BA.D0.BE.D0.B5_Gecko.3F" name=".D0.A7.D1.82.D0.BE_.D1.82.D0.B0.D0.BA.D0.BE.D0.B5_Gecko.3F">Что такое Gecko?</h3> - -<p>Mozilla, Firefox, Netscape 6+ и другие основанные на Mozilla браузеры имеют одинаковые реализации DOM, поскольку все они основаны на одном движке. <span class="comment">naturally, it applies only to products based on the same version of Gecko, but it's tricky to explain</span></p> - -<p>Gecko — программный компонент всех этих браузеров, который отвечает за синтаксический разбор HTML, внешний вид страниц, объектную модель документа и даже рендеринг интерфейсов приложений. Gecko является быстрым, совместимым со стандартами движком рендеринга, который обеспечивает поддержку стандартов W3C DOM и похожую на DOM (но не стандартизированную) модель документа браузера в контексте веб-страницы и интерфейса приложения.</p> - -<p>Хотя интерфейс приложения и содержимое, отображаемое браузером во многом различны, DOM обрабатывает их одинаково, как иерархию узлов.<span class="comment">(commenting this incomplete sentence out for now...) The tree structure of the DOM (which in its application to the user</span></p> - -<h3 id=".D0.A1.D0.B8.D0.BD.D1.82.D0.B0.D0.BA.D1.81.D0.B8.D1.81_API" name=".D0.A1.D0.B8.D0.BD.D1.82.D0.B0.D0.BA.D1.81.D0.B8.D1.81_API">Синтаксис API</h3> - -<p>Каждое описание в справочнике по API включает синтаксис, входные и выходные данные, пример использования, дополнительные замечания и ссылку на соответствующую спецификацию.</p> - -<p>Как правило атрибуты только-для-чтения имеют однострочный синтаксис, поскольку им нельзя присвоить значения и они могут быть только прочитаны. Пример использования атрибута только-для-чтения <code>availHeight</code> объекта <code>screen</code> выглядит примерно так:</p> - -<div><img alt="Image:Preface2.gif"></div> - -<p>Это означает, что вы можете использовать свойство только в правой части операции присваивания; атрибуты, которым можно присвоить значение, приведены в примере:</p> - -<div><img alt="Image:Prefacea.gif"></div> - -<p>В основном, данные и методы описываемых объектов, будут приводиться в примерах в контексте простых типов, таких как <code>element</code> для всех элементов, <code>document</code> для объектов верхнего уровня, table для объекта <code>TABLE</code> и т.д. (см. <a href="ru/%d0%a1%d0%bf%d1%80%d0%b0%d0%b2%d0%be%d1%87%d0%bd%d0%b0%d1%8f_%d0%b8%d0%bd%d1%84%d0%be%d1%80%d0%bc%d0%b0%d1%86%d0%b8%d1%8f_%d0%bf%d0%be_Gecko_DOM/%d0%92%d0%b2%d0%b5%d0%b4%d0%b5%d0%bd%d0%b8%d0%b5#.D0.92.D0.B0.D0.B6.D0.BD.D1.8B.D0.B5_.D1.82.D0.B8.D0.BF.D1.8B_.D0.B4.D0.B0.D0.BD.D0.BD.D1.8B.D1.85">Важные типы данных</a> для информации о типах данных).</p> - -<h3 id=".D0.98.D1.81.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_.D0.BF.D1.80.D0.B8.D0.BC.D0.B5.D1.80.D0.BE.D0.B2" name=".D0.98.D1.81.D0.BF.D0.BE.D0.BB.D1.8C.D0.B7.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_.D0.BF.D1.80.D0.B8.D0.BC.D0.B5.D1.80.D0.BE.D0.B2">Использование примеров</h3> - -<p>Большинство примеров в этом справочнике являются самодостаточными файлами, которые можно использовать просто копируя и вставляя их в новый файл, а затем открывая в браузере. Другие же являются фрагментами кода. Их вы сможете запустить только поместив в функции. Например свойство <a href="ru/DOM/window.document">window.document</a> может быть получено в теле функции, которая вызывается нажатием соответствующей кнопки:</p> - -<pre><html> - -<script> -function testWinDoc() { - - doc= window.document; - - alert(doc.title); - -} -</script> - -<button onclick="testWinDoc();">test document property</button> - -</html> -</pre> - -<p>Похожие функции и страницы можно сделать для методов и свойств объектов, которые ещё недоступны к использованию. См. параграф <a href="ru/%d0%a1%d0%bf%d1%80%d0%b0%d0%b2%d0%be%d1%87%d0%bd%d0%b0%d1%8f_%d0%b8%d0%bd%d1%84%d0%be%d1%80%d0%bc%d0%b0%d1%86%d0%b8%d1%8f_%d0%bf%d0%be_Gecko_DOM/%d0%92%d0%b2%d0%b5%d0%b4%d0%b5%d0%bd%d0%b8%d0%b5#.D0.A2.D0.B5.D1.81.D1.82.D0.B8.D1.80.D0.BE.D0.B2.D0.B0.D0.BD.D0.B8.D0.B5_DOM_API">Тестирование DOM API</a> для введения в средства тестирования, которые вы можете использовать для большого количества различных API.</p> - -<p>{{ languages( { "fr": "fr/R\u00e9f\u00e9rence_du_DOM_Gecko/Pr\u00e9face", "ja": "ja/Gecko_DOM_Reference/Preface", "ko": "ko/Gecko_DOM_Reference/Preface", "pl": "pl/Dokumentacja_Gecko_DOM/Przedmowa", "zh-cn": "cn/Gecko_DOM_\u53c2\u8003/Preface" } ) }}</p> diff --git a/files/ru/orphaned/справочная_информация_по_gecko_dom/примеры/index.html b/files/ru/orphaned/справочная_информация_по_gecko_dom/примеры/index.html deleted file mode 100644 index f030f68c04..0000000000 --- a/files/ru/orphaned/справочная_информация_по_gecko_dom/примеры/index.html +++ /dev/null @@ -1,6 +0,0 @@ ---- -title: Примеры -slug: orphaned/Справочная_информация_по_Gecko_DOM/Примеры -original_slug: Справочная_информация_по_Gecko_DOM/Примеры ---- -<p>This page has no content. Enrich MDC by contributing.</p> diff --git a/files/ru/orphaned/темы/index.html b/files/ru/orphaned/темы/index.html deleted file mode 100644 index 71bc2a0b19..0000000000 --- a/files/ru/orphaned/темы/index.html +++ /dev/null @@ -1,15 +0,0 @@ ---- -title: Темы -slug: orphaned/Темы -original_slug: Темы ---- -<p> </p> -<div class="callout-box"><strong><a href="/en/Creating_a_Skin_for_Firefox" title="en/Creating_a_Skin_for_Firefox">Введение</a></strong><br> -Введение в разработку тем для Firefox.</div> -<div><strong>Темы </strong>представляют из себя "шкурки" для различных приложений Mozilla. Они позволяют быстро изменить вид пользовательского интерфейса и персонализировать его на ваш вкус. Тема поможет легко изменить цвет пользовательского интерфейса или внешний вид в целом. </div> -<table class="topicpage-table"> <tbody> <tr> <td> <h4 id="Documentation"><a href="/Special:Tags" title="Site Tags">Documentation</a></h4> <dl><dt> <a href="/en/Creating_a_Skin_for_Firefox" title="en/Creating_a_Skin_for_Firefox">Creating a Skin for Firefox</a> </dt><dd> <small>An introduction to creating new themes for Firefox.</small> </dd></dl> <dl><dt> <a href="/en/Making_Sure_Your_Theme_Works_with_RTL_Locales" title="en/Making_Sure_Your_Theme_Works_with_RTL_Locales">Making Sure Your Theme Works with RTL Locales</a> </dt><dd> <small>How to make sure your theme will look right with Hebrew, Arabic, Persian and Urdu locales.</small> </dd></dl> <dl><dt> <a href="/en/Theme_Packaging" title="en/Theme_Packaging">Theme Packaging</a> </dt><dd> <small>How to package themes for Firefox and Thunderbird.</small> </dd></dl> <dl><dt> <br> </dt><dt> <a class="internal" href="/En/Theme_changes_in_Firefox_3.1" title="en/Theme changes in Firefox 3.1"> Theme changes between Firefox 3.0 and 3.1</a> </dt></dl> <dl><dt><a href="/en/Theme_changes_in_Firefox_3" title="en/Theme_changes_in_Firefox_3"> Theme changes between Firefox 2.0 and 3.0</a> </dt></dl> <dl><dt> <a href="/en/Theme_changes_in_Firefox_2" title="en/Theme_changes_in_Firefox_2"> Theme changes between Firefox 1.5 and 2.0</a> </dt><dd> <small>A comprehensive list of theme changes between the 1.5 and 2.0 releases of Firefox</small> </dd></dl> <dl><dt> <a class="external" href="http://forums.mozillazine.org/viewtopic.php?t=197434">Theme changes from Firefox 1.0 to 1.5 (forum post)</a> </dt><dd> <small>A forum post at <a class="external" href="http://www.mozillazine.org">MozillaZine</a> outlining the basic theme-related changes between Firefox 1.0 and 1.5.</small> </dd></dl> <dl><dt> <a class="external" href="http://cheeaun.phoenity.com/weblog/2004/12/first-steps-in-theme-design.html">First steps in theme design</a> </dt><dd> <small>A somewhat aged article discussing theme design for Firefox.</small> </dd></dl> <p><span class="alllinks"><a href="/Special:Tags" title="Site Tags">View All...</a></span></p> </td> <td> <h4 id="Community">Community</h4> <ul> <li>View Mozilla forums...</li> </ul> <p>{{ DiscussionList("dev-themes", "mozilla.dev.themes") }}</p> <ul> <li><a class="link-irc" href="irc://irc.mozilla.org/#themedev">#themedev IRC channel</a></li> <li><a class="external" href="http://forums.mozillazine.org/viewforum.php?f=18">MozillaZine Themes forum</a></li> </ul> <h4 id="Tools">Tools</h4> <ul> <li><a href="/en/DOM_Inspector" title="en/DOM_Inspector">DOM Inspector</a></li> <li><a class="link-https" href="https://addons.mozilla.org/firefox/63/">InspectorWidget</a></li> <li><a class="external" href="http://www.extensionsmirror.nl/index.php?showtopic=21">ChromeEdit extension</a></li> <li><a class="link-https" href="https://addons.mozilla.org/firefox/7438">Force RTL</a>: Test for RTL compatibility</li> </ul> <p><span class="alllinks"><a href="/Special:Tags" title="Site Tags">View All...</a></span></p> <h4 id="Related_Topics">Related Topics</h4> <dl><dd> <a href="/en/CSS" title="en/CSS">CSS</a> </dd></dl></td> </tr> </tbody> -</table> -<p><span class="comment">Categories</span></p> -<p><span class="comment">Interwiki Language Links</span></p> -<p> </p> -<p>{{ languages( { "de": "de/Themes", "es": "es/Temas", "fr": "fr/Th\u00e8mes", "ja": "ja/Themes", "pl": "pl/Motywy", "zh-cn": "cn/\u4e3b\u9898", "zh-tw": "zh_tw/\u4f48\u666f\u4e3b\u984c" } ) }}</p> |