diff options
Diffstat (limited to 'files/my')
23 files changed, 0 insertions, 3016 deletions
diff --git a/files/my/_redirects.txt b/files/my/_redirects.txt deleted file mode 100644 index 2cffca4f69..0000000000 --- a/files/my/_redirects.txt +++ /dev/null @@ -1,6 +0,0 @@ -# FROM-URL TO-URL -/my/docs/Learn/CSS/CSS-မိတ်ဆက် /en-US/docs/Learn/CSS/First_steps -/my/docs/Learn/HTML/Forms /my/docs/Learn/Forms -/my/docs/Learn/HTML/Forms/HTML5_input_types /my/docs/Learn/Forms/HTML5_input_types -/my/docs/Learn/HTML/Forms/Your_first_form /my/docs/Learn/Forms/Your_first_form -/my/docs/Web/Guide/HTML /my/docs/Learn/HTML diff --git a/files/my/_wikihistory.json b/files/my/_wikihistory.json deleted file mode 100644 index b9672c7b5f..0000000000 --- a/files/my/_wikihistory.json +++ /dev/null @@ -1,141 +0,0 @@ -{ - "Learn": { - "modified": "2020-07-16T22:43:45.027Z", - "contributors": [ - "SphinxKnight", - "vonabbas", - "Ko.Kyaw.Zin.Htet", - "wuthmone", - "SetKyarWaLar" - ] - }, - "Learn/CSS": { - "modified": "2020-07-16T22:25:35.633Z", - "contributors": [ - "Ko.Kyaw.Zin.Htet", - "josh-wong" - ] - }, - "Learn/CSS/CSS_layout": { - "modified": "2020-08-17T12:09:16.635Z", - "contributors": [ - "chrisdavidmills" - ] - }, - "Learn/CSS/CSS_layout/Flexbox": { - "modified": "2020-08-17T12:09:18.877Z", - "contributors": [ - "sithuyannaing558" - ] - }, - "Learn/HTML": { - "modified": "2020-07-16T22:22:20.967Z", - "contributors": [ - "Ko.Kyaw.Zin.Htet", - "waizinnaing" - ] - }, - "Learn/JavaScript": { - "modified": "2020-07-16T22:29:42.023Z", - "contributors": [ - "SphinxKnight" - ] - }, - "Mozilla": { - "modified": "2020-12-14T11:30:04.310Z", - "contributors": [ - "jsx" - ] - }, - "Web": { - "modified": "2019-03-23T22:51:40.029Z", - "contributors": [ - "Ko.Kyaw.Zin.Htet", - "Yhaza", - "royhowie" - ] - }, - "Web/CSS": { - "modified": "2019-09-11T03:20:08.570Z", - "contributors": [ - "SphinxKnight" - ] - }, - "Web/CSS/@font-face": { - "modified": "2020-10-15T22:32:44.803Z", - "contributors": [ - "nainglinoo.mm127" - ] - }, - "Web/CSS/CSS_Transitions": { - "modified": "2019-05-23T03:26:30.898Z", - "contributors": [ - "SphinxKnight" - ] - }, - "Web/Guide": { - "modified": "2019-03-23T22:48:31.803Z", - "contributors": [ - "teoli" - ] - }, - "Web/HTTP": { - "modified": "2020-10-13T11:14:22.959Z", - "contributors": [ - "SphinxKnight" - ] - }, - "Web/HTTP/Connection_management_in_HTTP_1.x": { - "modified": "2020-10-14T02:51:32.014Z", - "contributors": [ - "SphinxKnight", - "suran0425" - ] - }, - "Web/JavaScript": { - "modified": "2020-03-12T19:42:07.096Z", - "contributors": [ - "csdal", - "SphinxKnight", - "SetKyarWaLar", - "SuThaw", - "Markus Prokott" - ] - }, - "Web/JavaScript/Reference": { - "modified": "2020-07-22T11:39:39.861Z", - "contributors": [ - "fscholz" - ] - }, - "Web/JavaScript/Reference/Statements": { - "modified": "2020-10-15T22:32:02.841Z", - "contributors": [ - "wbamberg" - ] - }, - "Web/JavaScript/Reference/Statements/function*": { - "modified": "2020-10-15T22:32:02.196Z", - "contributors": [ - "wilsunluk" - ] - }, - "Learn/Forms/HTML5_input_types": { - "modified": "2020-07-16T22:22:06.907Z", - "contributors": [ - "wesleydanbury69" - ] - }, - "Learn/Forms": { - "modified": "2020-07-16T22:21:00.247Z", - "contributors": [ - "Jeffrey_Yang" - ] - }, - "Learn/Forms/Your_first_form": { - "modified": "2020-08-24T11:21:29.703Z", - "contributors": [ - "robertaungzinpyae" - ] - } -}
\ No newline at end of file diff --git a/files/my/learn/css/css_layout/flexbox/index.html b/files/my/learn/css/css_layout/flexbox/index.html deleted file mode 100644 index 03bc087105..0000000000 --- a/files/my/learn/css/css_layout/flexbox/index.html +++ /dev/null @@ -1,339 +0,0 @@ ---- -title: Flexbox -slug: Learn/CSS/CSS_layout/Flexbox -translation_of: Learn/CSS/CSS_layout/Flexbox ---- -<div>{{LearnSidebar}}</div> - -<div>{{PreviousMenuNext("LearnSS_layout/Normal_Flow", "Learn/CSS/CSS_layout/Grids", "Learn/CSS/CSS_layout")}}</div> - -<p class="summary"><a href="/en-US/docs/Web/CSS/CSS_Flexible_Box_Layout">Flexbox</a> is a one-dimensional layout method for laying out items in rows or columns. Items flex to fill additional space and shrink to fit into smaller spaces. This article explains all the fundamentals.</p> - -<table class="learn-box standard-table"> - <tbody> - <tr> - <th scope="row">Prerequisites:</th> - <td>HTML basics (study <a href="/en-US/docs/Learn/HTML/Introduction_to_HTML">Introduction to HTML</a>), and an idea of how CSS works (study <a href="/en-US/docs/Learn/CSS/Introduction_to_CSS">Introduction to CSS</a>.)</td> - </tr> - <tr> - <th scope="row">Objective:</th> - <td>To learn how to use the Flexbox layout system to create web layouts.</td> - </tr> - </tbody> -</table> - -<h2 id="Why_Flexbox">Why Flexbox?</h2> - -<p>For a long time, the only reliable cross browser-compatible tools available for creating CSS layouts were things like <a href="/en-US/docs/Learn/CSS/CSS_layout/Floats">floats</a> and <a href="/en-US/docs/Learn/CSS/CSS_layout/Positioning">positioning</a>. These are fine and they work, but in some ways they are also rather limiting and frustrating.</p> - -<p>The following simple layout requirements are either difficult or impossible to achieve with such tools, in any kind of convenient, flexible way:</p> - -<ul> - <li>Vertically centering a block of content inside its parent.</li> - <li>Making all the children of a container take up an equal amount of the available width/height, regardless of how much width/height is available.</li> - <li>Making all columns in a multiple column layout adopt the same height even if they contain a different amount of content.</li> -</ul> - -<p>As you'll see in subsequent sections, flexbox makes a lot of layout tasks much easier. Let's dig in!</p> - -<h2 id="Introducing_a_simple_example">Introducing a simple example</h2> - -<p>In this article we are going to get you to work through a series of exercises to help you understand how flexbox works. To get started, you should make a local copy of the first starter file — <a href="https://github.com/mdn/learning-area/blob/master/css/css-layout/flexbox/flexbox0.html">flexbox0.html</a> from our github repo — load it in a modern browser (like Firefox or Chrome), and have a look at the code in your code editor. You can <a href="http://mdn.github.io/learning-area/css/css-layout/flexbox/flexbox0.html">see it live here</a> also.</p> - -<p>You'll see that we have a {{htmlelement("header")}} element with a top level heading inside it, and a {{htmlelement("section")}} element containing three {{htmlelement("article")}}s. We are going to use these to create a fairly standard three column layout.</p> - -<p><img alt="" src="https://mdn.mozillademos.org/files/13406/flexbox-example1.png" style="border-style: solid; border-width: 1px; display: block; height: 324px; margin: 0px auto; width: 800px;"></p> - -<h2 id="Specifying_what_elements_to_lay_out_as_flexible_boxes">Specifying what elements to lay out as flexible boxes</h2> - -<p>To start with, we need to select which elements are to be laid out as flexible boxes. To do this, we set a special value of {{cssxref("display")}} on the parent element of the elements you want to affect. In this case we want to lay out the {{htmlelement("article")}} elements, so we set this on the {{htmlelement("section")}}:</p> - -<pre class="brush: css notranslate">section { - display: flex; -}</pre> - -<p>This causes the <section> element to become a <strong>flex container</strong>, and its children to become <strong>flex items</strong>. The result of this should be something like so:</p> - -<p><img alt="" src="https://mdn.mozillademos.org/files/13408/flexbox-example2.png" style="border-style: solid; border-width: 1px; display: block; height: 348px; margin: 0px auto; width: 800px;"></p> - -<p>So, this single declaration gives us everything we need — incredible, right? We have our multiple column layout with equal sized columns, and the columns are all the same height. This is because the default values given to flex items (the children of the flex container) are set up to solve common problems such as this.</p> - -<p>To be clear, let's reiterate what is happening here. The element we've given a {{cssxref("display")}} value of <code>flex</code> to is acting like a block-level element in terms of how it interacts with the rest of the page, but its children are being laid out as flex items — the next section will explain in more detail what this means. Note also that you can use a <code>display</code> value of <code>inline-flex</code> if you wish to lay out an element's children as flex items, but have that element behave like an inline element.</p> - -<h2 id="The_flex_model">The flex model</h2> - -<p>When elements are laid out as flex items, they are laid out along two axes:</p> - -<p><img alt="flex_terms.png" class="default internal" src="/files/3739/flex_terms.png" style="display: block; margin: 0px auto;"></p> - -<ul> - <li>The <strong>main axis</strong> is the axis running in the direction the flex items are being laid out in (e.g. as rows across the page, or columns down the page.) The start and end of this axis are called the <strong>main start</strong> and <strong>main end</strong>.</li> - <li>The <strong>cross axis</strong> is the axis running perpendicular to the direction the flex items are being laid out in. The start and end of this axis are called the <strong>cross start</strong> and <strong>cross end</strong>.</li> - <li>The parent element that has <code>display: flex</code> set on it (the {{htmlelement("section")}} in our example) is called the <strong>flex container</strong>.</li> - <li>The items being laid out as flexible boxes inside the flex container are called <strong>flex items</strong> (the {{htmlelement("article")}} elements in our example).</li> -</ul> - -<p>Bear this terminology in mind as you go through subsequent sections. You can always refer back to it if you get confused about any of the terms being used.</p> - -<h2 id="Columns_or_rows">Columns or rows?</h2> - -<p>Flexbox provides a property called {{cssxref("flex-direction")}} that specifies what direction the main axis runs in (what direction the flexbox children are laid out in) — by default this is set to <code>row</code>, which causes them to be laid out in a row in the direction your browser's default language works in (left to right, in the case of an English browser).</p> - -<p>Try adding the following declaration to your {{htmlelement("section")}} rule:</p> - -<pre class="brush: css notranslate">flex-direction: column;</pre> - -<p>You'll see that this puts the items back in a column layout, much like they were before we added any CSS. Before you move on, delete this declaration from your example.</p> - -<div class="note"> -<p><strong>Note</strong>: You can also lay out flex items in a reverse direction using the <code>row-reverse</code> and <code>column-reverse</code> values. Experiment with these values too!</p> -</div> - -<h2 id="Wrapping">Wrapping</h2> - -<p>One issue that arises when you have a fixed amount of width or height in your layout is that eventually your flexbox children will overflow their container, breaking the layout. Have a look at our <a href="https://github.com/mdn/learning-area/blob/master/css/css-layout/flexbox/flexbox-wrap0.html">flexbox-wrap0.html</a> example, and try <a href="http://mdn.github.io/learning-area/css/css-layout/flexbox/flexbox-wrap0.html">viewing it live</a> (take a local copy of this file now if you want to follow along with this example):</p> - -<p><img alt="" src="https://mdn.mozillademos.org/files/13410/flexbox-example3.png" style="display: block; height: 646px; margin: 0px auto; width: 800px;"></p> - -<p>Here we see that the children are indeed breaking out of their container. One way in which you can fix this is to add the following declaration to your {{htmlelement("section")}} rule:</p> - -<pre class="brush: css notranslate">flex-wrap: wrap;</pre> - -<p>Also, add the following declaration to your {{htmlelement("article")}} rule:</p> - -<pre class="brush: css notranslate">flex: 200px;</pre> - -<p>Try this now; you'll see that the layout looks much better with this included:</p> - -<p><img alt="" src="https://mdn.mozillademos.org/files/13412/flexbox-example4.png" style="display: block; height: 646px; margin: 0px auto; width: 800px;">We now have multiple rows — as many flexbox children are fitted onto each row as makes sense, and any overflow is moved down to the next line. The <code>flex: 200px</code> declaration set on the articles means that each will be at least 200px wide; we'll discuss this property in more detail later on. You might also notice that the last few children on the last row are each made wider so that the entire row is still filled.</p> - -<p>But there's more we can do here. First of all, try changing your {{cssxref("flex-direction")}} property value to <code>row-reverse</code> — now you'll see that you still have your multiple row layout, but it starts from the opposite corner of the browser window and flows in reverse.</p> - -<h2 id="flex-flow_shorthand">flex-flow shorthand</h2> - -<p>At this point it is worth noting that a shorthand exists for {{cssxref("flex-direction")}} and {{cssxref("flex-wrap")}} — {{cssxref("flex-flow")}}. So for example, you can replace</p> - -<pre class="brush: css notranslate">flex-direction: row; -flex-wrap: wrap;</pre> - -<p>with</p> - -<pre class="brush: css notranslate">flex-flow: row wrap;</pre> - -<h2 id="Flexible_sizing_of_flex_items">Flexible sizing of flex items</h2> - -<p>Let's now return to our first example, and look at how we can control what proportion of space flex items take up compared to the other flex items. Fire up your local copy of <a href="https://github.com/mdn/learning-area/blob/master/css/css-layout/flexbox/flexbox0.html">flexbox0.html</a>, or take a copy of <a href="https://github.com/mdn/learning-area/blob/master/css/css-layout/flexbox/flexbox1.html">flexbox1.html</a> as a new starting point (<a href="http://mdn.github.io/learning-area/css/css-layout/flexbox/flexbox1.html">see it live</a>).</p> - -<p>First, add the following rule to the bottom of your CSS:</p> - -<pre class="brush: css notranslate">article { - flex: 1; -}</pre> - -<p>This is a unitless proportion value that dictates how much of the available space along the main axis each flex item will take up compared to other flex items. In this case, we are giving each {{htmlelement("article")}} element the same value (a value of 1), which means they will all take up an equal amount of the spare space left after things like padding and margin have been set. It is relative to other flex items, meaning that giving each flex item a value of 400000 would have exactly the same effect.</p> - -<p>Now add the following rule below the previous one:</p> - -<pre class="brush: css notranslate">article:nth-of-type(3) { - flex: 2; -}</pre> - -<p>Now when you refresh, you'll see that the third {{htmlelement("article")}} takes up twice as much of the available width as the other two — there are now four proportion units available in total (since 1 + 1 + 2 = 4). The first two flex items have one unit each so they take 1/4 of the available space each. The third one has two units, so it takes up 2/4 of the available space (or one-half).</p> - -<p>You can also specify a minimum size value inside the flex value. Try updating your existing article rules like so:</p> - -<pre class="brush: css notranslate">article { - flex: 1 200px; -} - -article:nth-of-type(3) { - flex: 2 200px; -}</pre> - -<p>This basically states "Each flex item will first be given 200px of the available space. After that, the rest of the available space will be shared out according to the proportion units." Try refreshing and you'll see a difference in how the space is shared out.</p> - -<p><img alt="" src="https://mdn.mozillademos.org/files/13406/flexbox-example1.png" style="border-style: solid; border-width: 1px; display: block; height: 324px; margin: 0px auto; width: 800px;"></p> - -<p>The real value of flexbox can be seen in its flexibility/responsiveness — if you resize the browser window, or add another {{htmlelement("article")}} element, the layout continues to work just fine.</p> - -<h2 id="flex_shorthand_versus_longhand">flex: shorthand versus longhand</h2> - -<p>{{cssxref("flex")}} is a shorthand property that can specify up to three different values:</p> - -<ul> - <li>The unitless proportion value we discussed above. This can be specified individually using the {{cssxref("flex-grow")}} longhand property.</li> - <li>A second unitless proportion value — {{cssxref("flex-shrink")}} — that comes into play when the flex items are overflowing their container. This specifies how much of the overflowing amount is taken away from each flex item's size, to stop them overflowing their container. This is quite an advanced flexbox feature, and we won't be covering it any further in this article.</li> - <li>The minimum size value we discussed above. This can be specified individually using the {{cssxref("flex-basis")}} longhand value.</li> -</ul> - -<p>We'd advise against using the longhand flex properties unless you really have to (for example, to override something previously set). They lead to a lot of extra code being written, and they can be somewhat confusing.</p> - -<h2 id="Horizontal_and_vertical_alignment">Horizontal and vertical alignment</h2> - -<p>You can also use flexbox features to align flex items along the main or cross axis. Let's explore this by looking at a new example — <a href="https://github.com/mdn/learning-area/blob/master/css/css-layout/flexbox/flex-align0.html">flex-align0.html</a> (<a href="http://mdn.github.io/learning-area/css/css-layout/flexbox/flex-align0.html">see it live also</a>) — which we are going to turn into a neat, flexible button/toolbar. At the moment you'll see a horizontal menu bar, with some buttons jammed into the top left hand corner.</p> - -<p><img alt="" src="https://mdn.mozillademos.org/files/13414/flexbox-example5.png" style="display: block; height: 77px; margin: 0px auto; width: 600px;"></p> - -<p>First, take a local copy of this example.</p> - -<p>Now, add the following to the bottom of the example's CSS:</p> - -<pre class="brush: css notranslate">div { - display: flex; - align-items: center; - justify-content: space-around; -}</pre> - -<p><img alt="" src="https://mdn.mozillademos.org/files/17210/flexbox_center_space-around.png" style="height: 209px; width: 1217px;"></p> - -<p>Refresh the page and you'll see that the buttons are now nicely centered, horizontally and vertically. We've done this via two new properties.</p> - -<p>{{cssxref("align-items")}} controls where the flex items sit on the cross axis.</p> - -<ul> - <li>By default, the value is <code>stretch</code>, which stretches all flex items to fill the parent in the direction of the cross axis. If the parent hasn't got a fixed width in the cross axis direction, then all flex items will become as long as the longest flex items. This is how our first example got equal height columns by default.</li> - <li>The <code>center</code> value that we used in our above code causes the items to maintain their intrinsic dimensions, but be centered along the cross axis. This is why our current example's buttons are centered vertically.</li> - <li>You can also have values like <code>flex-start</code> and <code>flex-end</code>, which will align all items at the start and end of the cross axis respectively. See {{cssxref("align-items")}} for the full details.</li> -</ul> - -<p>You can override the {{cssxref("align-items")}} behavior for individual flex items by applying the {{cssxref("align-self")}} property to them. For example, try adding the following to your CSS:</p> - -<pre class="brush: css notranslate">button:first-child { - align-self: flex-end; -}</pre> - -<p><img alt="" src="https://mdn.mozillademos.org/files/17211/flexbox_first-child_flex-end.png" style="height: 217px; width: 1219px;"></p> - -<p>Have a look at what effect this has, and remove it again when you've finished.</p> - -<p>{{cssxref("justify-content")}} controls where the flex items sit on the main axis.</p> - -<ul> - <li>The default value is <code>flex-start</code>, which makes all the items sit at the start of the main axis.</li> - <li>You can use <code>flex-end</code> to make them sit at the end.</li> - <li><code>center</code> is also a value for <code>justify-content</code>, and will make the flex items sit in the center of the main axis.</li> - <li>The value we've used above, <code>space-around</code>, is useful — it distributes all the items evenly along the main axis, with a bit of space left at either end.</li> - <li>There is another value, <code>space-between</code>, which is very similar to <code>space-around</code> except that it doesn't leave any space at either end.</li> -</ul> - -<p>We'd like to encourage you to play with these values to see how they work before you continue.</p> - -<h2 id="Ordering_flex_items">Ordering flex items</h2> - -<p>Flexbox also has a feature for changing the layout order of flex items, without affecting the source order. This is another thing that is impossible to do with traditional layout methods.</p> - -<p>The code for this is simple: try adding the following CSS to your button bar example code:</p> - -<pre class="brush: css notranslate">button:first-child { - order: 1; -}</pre> - -<p>Refresh, and you'll now see that the "Smile" button has moved to the end of the main axis. Let's talk about how this works in a bit more detail:</p> - -<ul> - <li>By default, all flex items have an {{cssxref("order")}} value of 0.</li> - <li>Flex items with higher order values set on them will appear later in the display order than items with lower order values.</li> - <li>Flex items with the same order value will appear in their source order. So if you have four items with order values of 2, 1, 1, and 0 set on them respectively, their display order would be 4th, 2nd, 3rd, then 1st.</li> - <li>The 3rd item appears after the 2nd because it has the same order value and is after it in the source order.</li> -</ul> - -<p>You can set negative order values to make items appear earlier than items with 0 set. For example, you could make the "Blush" button appear at the start of the main axis using the following rule:</p> - -<pre class="brush: css notranslate">button:last-child { - order: -1; -}</pre> - -<h2 id="Nested_flex_boxes">Nested flex boxes</h2> - -<p>It is possible to create some pretty complex layouts with flexbox. It is perfectly ok to set a flex item to also be a flex container, so that its children are also laid out like flexible boxes. Have a look at <a href="https://github.com/mdn/learning-area/blob/master/css/css-layout/flexbox/complex-flexbox.html">complex-flexbox.html</a> (<a href="http://mdn.github.io/learning-area/css/css-layout/flexbox/complex-flexbox.html">see it live also</a>).</p> - -<p><img alt="" src="https://mdn.mozillademos.org/files/13418/flexbox-example7.png" style="border-style: solid; border-width: 1px; display: block; margin: 0px auto;"></p> - -<p>The HTML for this is fairly simple. We've got a {{htmlelement("section")}} element containing three {{htmlelement("article")}}s. The third {{htmlelement("article")}} contains three {{htmlelement("div")}}s. :</p> - -<pre class="notranslate">section - article - article - article - div - button - div button - div button - button - button</pre> - -<p>Let's look at the code we've used for the layout.</p> - -<p>First of all, we set the children of the {{htmlelement("section")}} to be laid out as flexible boxes.</p> - -<pre class="brush: css notranslate">section { - display: flex; -}</pre> - -<p>Next, we set some flex values on the {{htmlelement("article")}}s themselves. Take special note of the 2nd rule here — we are setting the third {{htmlelement("article")}} to have its children laid out like flex items too, but this time we are laying them out like a column.</p> - -<pre class="brush: css notranslate">article { - flex: 1 200px; -} - -article:nth-of-type(3) { - flex: 3 200px; - display: flex; - flex-flow: column; -} -</pre> - -<p>Next, we select the first {{htmlelement("div")}}. We first use <code>flex:1 100px;</code> to effectively give it a minimum height of 100px, then we set its children (the {{htmlelement("button")}} elements) to also be laid out like flex items. Here we lay them out in a wrapping row, and align them in the center of the available space like we did in the individual button example we saw earlier.</p> - -<pre class="brush: css notranslate">article:nth-of-type(3) div:first-child { - flex:1 100px; - display: flex; - flex-flow: row wrap; - align-items: center; - justify-content: space-around; -}</pre> - -<p>Finally, we set some sizing on the button, but more interestingly we give it a flex value of 1 auto. This has a very interesting effect, which you'll see if you try resizing your browser window width. The buttons will take up as much space as they can and sit as many on the same line as they can, but when they can no longer fit comfortably on the same line, they'll drop down to create new lines.</p> - -<pre class="brush: css notranslate">button { - flex: 1 auto; - margin: 5px; - font-size: 18px; - line-height: 1.5; -}</pre> - -<h2 id="Cross_browser_compatibility">Cross browser compatibility</h2> - -<p>Flexbox support is available in most new browsers — Firefox, Chrome, Opera, Microsoft Edge and IE 11, newer versions of Android/iOS, etc. However you should be aware that there are still older browsers in use that don't support Flexbox (or do, but support a really old, out-of-date version of it.)</p> - -<p>While you are just learning and experimenting, this doesn't matter too much; however if you are considering using flexbox in a real website you need to do testing and make sure that your user experience is still acceptable in as many browsers as possible.</p> - -<p>Flexbox is a bit trickier than some CSS features. For example, if a browser is missing a CSS drop shadow, then the site will likely still be usable. Not supporting flexbox features however will probably break a layout completely, making it unusable.</p> - -<p>We discuss strategies for overcoming cross browser support issues in our <a href="/en-US/docs/Learn/Tools_and_testing/Cross_browser_testing">Cross browser testing</a> module.</p> - -<h2 id="Test_your_skills!">Test your skills!</h2> - -<p>We have covered a lot in this article, but can you remember the most important information? You can find some further tests to verify that you've retained this information before you move on — see <a href="/en-US/docs/Learn/CSS/CSS_layout/Flexbox_skills">Test your skills: Flexbox</a>.</p> - -<h2 id="Summary">Summary</h2> - -<p>That concludes our tour of the basics of flexbox. We hope you had fun, and will have a good play around with it as you travel forward with your learning. Next we'll have a look at another important aspect of CSS layouts — CSS Grids.</p> - -<div>{{PreviousMenuNext("Learn/CSS/CSS_layout/Normal_Flow", "Learn/CSS/CSS_layout/Grids", "Learn/CSS/CSS_layout")}}</div> - -<div> -<h2 id="In_this_module">In this module</h2> - -<ul> - <li><a href="/en-US/docs/Learn/CSS/CSS_layout/Introduction">Introduction to CSS layout</a></li> - <li><a href="/en-US/docs/Learn/CSS/CSS_layout/Normal_Flow">Normal flow</a></li> - <li><a href="/en-US/docs/Learn/CSS/CSS_layout/Flexbox">Flexbox</a></li> - <li><a href="/en-US/docs/Learn/CSS/CSS_layout/Grids">Grid</a></li> - <li><a href="/en-US/docs/Learn/CSS/CSS_layout/Floats">Floats</a></li> - <li><a href="/en-US/docs/Learn/CSS/CSS_layout/Positioning">Positioning</a></li> - <li><a href="/en-US/docs/Learn/CSS/CSS_layout/Multiple-column_Layout">Multiple-column layout</a></li> - <li><a href="/en-US/docs/Learn/CSS/CSS_layout/Responsive_Design">Responsive design</a></li> - <li><a href="/en-US/docs/Learn/CSS/CSS_layout/Media_queries">Beginner's guide to media queries</a></li> - <li><a href="/en-US/docs/Learn/CSS/CSS_layout/Legacy_Layout_Methods">Legacy layout methods</a></li> - <li><a href="/en-US/docs/Learn/CSS/CSS_layout/Supporting_Older_Browsers">Supporting older browsers</a></li> - <li><a href="/en-US/docs/Learn/CSS/CSS_layout/Fundamental_Layout_Comprehension">Fundamental layout comprehension assessment</a></li> -</ul> -</div> diff --git a/files/my/learn/css/css_layout/index.html b/files/my/learn/css/css_layout/index.html deleted file mode 100644 index 0268f74856..0000000000 --- a/files/my/learn/css/css_layout/index.html +++ /dev/null @@ -1,88 +0,0 @@ ---- -title: CSS layout -slug: Learn/CSS/CSS_layout -tags: - - Beginner - - CSS - - Floating - - Grids - - Guide - - Landing - - Layout - - Learn - - Module - - Multiple column - - NeedsTranslation - - Positioning - - TopicStub - - alignment - - flexbox - - float - - table -translation_of: Learn/CSS/CSS_layout ---- -<div>{{LearnSidebar}}</div> - -<p class="summary">At this point we've already looked at CSS fundamentals, how to style text, and how to style and manipulate the boxes that your content sits inside. Now it's time to look at how to place your boxes in the right place in relation to the viewport, and one another. We have covered the necessary prerequisites so we can now dive deep into CSS layout, looking at different display settings, modern layout tools like flexbox, CSS grid, and positioning, and some of the legacy techniques you might still want to know about.</p> - -<div class="callout"> -<h3 id="Looking_to_become_a_front-end_web_developer">Looking to become a front-end web developer?</h3> - -<p>We have put together a course that includes all the essential information you need to work towards your goal.</p> - -<p><a class="cta primary" href="/docs/Learn/Front-end_web_developer">Get started</a></p> -</div> - -<h2 id="Prerequisites">Prerequisites</h2> - -<p>Before starting this module, you should already:</p> - -<ol> - <li>Have basic familiarity with HTML, as discussed in the <a href="/en-US/docs/Learn/HTML/Introduction_to_HTML">Introduction to HTML</a> module.</li> - <li>Be comfortable with CSS fundamentals, as discussed in <a href="/en-US/docs/Learn/CSS/Introduction_to_CSS">Introduction to CSS</a>.</li> - <li>Understand how to <a href="/en-US/docs/Learn/CSS/Styling_boxes">style boxes</a>.</li> -</ol> - -<div class="note"> -<p><strong>Note</strong>: If you are working on a computer/tablet/other device where you don't have the ability to create your own files, you could try out (most of) the code examples in an online coding program such as <a href="http://jsbin.com/">JSBin</a> or <a href="https://glitch.com/">Glitch</a>.</p> -</div> - -<h2 id="Guides">Guides</h2> - -<p>These articles will provide instruction on the fundamental layout tools and techniques available in CSS. At the end of the lessons is an assessment to help you check your understanding of layout methods, by laying out a webpage.</p> - -<dl> - <dt><a href="/en-US/docs/Learn/CSS/CSS_layout/Introduction">Introduction to CSS layout</a></dt> - <dd>This article will recap some of the CSS layout features we've already touched upon in previous modules — such as different {{cssxref("display")}} values — and introduce some of the concepts we'll be covering throughout this module.</dd> - <dt><a href="/en-US/docs/Learn/CSS/CSS_layout/Normal_Flow">Normal flow</a></dt> - <dd>Elements on webpages lay themselves out according to <em>normal flow</em> - until we do something to change that. This article explains the basics of normal flow as a grounding for learning how to change it.</dd> - <dt><a href="/en-US/docs/Learn/CSS/CSS_layout/Flexbox">Flexbox</a></dt> - <dd><a href="/en-US/docs/Web/CSS/CSS_Flexible_Box_Layout/Using_flexbox_to_lay_out_web_applications">Flexbox</a> is a one-dimensional layout method for laying out items in rows or columns. Items flex to fill additional space and shrink to fit into smaller spaces. This article explains all the fundamentals. After studying this guide you can <a href="/en-US/docs/Learn/CSS/CSS_layout/Flexbox_skills">test your flexbox skills</a> to check your understanding before moving on.</dd> - <dt><a href="/en-US/docs/Learn/CSS/CSS_layout/Grids">Grids</a></dt> - <dd>CSS Grid Layout is a two-dimensional layout system for the web. It lets you lay content out in rows and columns, and has many features that make building complex layouts straightforward. This article will give you all you need to know to get started with page layout, then <a href="/en-US/docs/Learn/CSS/CSS_layout/Grid_skills">test your grid skills</a> before moving on.</dd> - <dt><a href="/en-US/docs/Learn/CSS/CSS_layout/Floats">Floats</a></dt> - <dd>Originally for floating images inside blocks of text, the {{cssxref("float")}} property became one of the most commonly used tools for creating multiple column layouts on webpages. With the advent of Flexbox and Grid it has now returned to its original purpose, as this article explains.</dd> - <dt><a href="/en-US/docs/Learn/CSS/CSS_layout/Positioning">Positioning</a></dt> - <dd>Positioning allows you to take elements out of the normal document layout flow, and make them behave differently, for example sitting on top of one another, or always remaining in the same place inside the browser viewport. This article explains the different {{cssxref("position")}} values, and how to use them.</dd> - <dt><a href="/en-US/docs/Learn/CSS/CSS_layout/Multiple-column_Layout">Multiple-column layout</a></dt> - <dd>The multiple-column layout specification gives you a method of laying content out in columns, as you might see in a newspaper. This article explains how to use this feature.</dd> - <dt><a href="/en-US/docs/Learn/CSS/CSS_layout/Responsive_Design">Responsive design</a></dt> - <dd>As more diverse screen sizes have appeared on web-enabled devices, the concept of responsive web design (RWD) has appeared: a set of practices that allows web pages to alter their layout and appearance to suit different screen widths, resolutions, etc. It is an idea that changed the way we design for a multi-device web, and in this article we'll help you understand the main techniques you need to know to master it.</dd> - <dt><a href="/en-US/docs/Learn/CSS/CSS_layout/Media_queries">Beginner's guide to media queries</a></dt> - <dd>The <strong>CSS Media Query</strong> gives you a way to apply CSS only when the browser and device environment matches a rule that you specify, for example "viewport is wider than 480 pixels". Media queries are a key part of responsive web design, as they allow you to create different layouts depending on the size of the viewport, but they can also be used to detect other things about the environment your site is running on, for example whether the user is using a touchscreen rather than a mouse. In this lesson you will first learn about the syntax used in media queries, and then move on to use them in a worked example showing how a simple design might be made responsive.</dd> - <dt><a href="/en-US/docs/Learn/CSS/CSS_layout/Legacy_Layout_Methods">Legacy layout methods</a></dt> - <dd>Grid systems are a very common feature used in CSS layouts, and before CSS Grid Layout they tended to be implemented using floats or other layout features. You imagine your layout as a set number of columns (e.g. 4, 6, or 12), and then fit your content columns inside these imaginary columns. In this article we'll explore how these older methods work, in order that you understand how they were used if you work on an older project.</dd> - <dt><a href="/en-US/docs/Learn/CSS/CSS_layout/Supporting_Older_Browsers">Supporting older browsers</a></dt> - <dd> - <p>In this module we recommend using Flexbox and Grid as the main layout methods for your designs. However there will be visitors to your site who use older browsers, or browsers which do not support the methods you have used. This will always be the case on the web — as new features are developed, different browsers will prioritise different things. This article explains how to use modern web techniques without locking out users of older technology.</p> - </dd> - <dt><a href="/en-US/docs/Learn/CSS/CSS_layout/Fundamental_Layout_Comprehension">Assessment: Fundamental layout comprehension</a></dt> - <dd>An assessment to test your knowledge of different layout methods by laying out a webpage.</dd> -</dl> - -<h2 id="See_also">See also</h2> - -<dl> - <dt><a href="/en-US/docs/Learn/CSS/CSS_layout/Practical_positioning_examples">Practical positioning examples</a></dt> - <dd>This article shows how to build some real world examples to illustrate what kinds of things you can do with positioning.</dd> -</dl> diff --git a/files/my/learn/css/index.html b/files/my/learn/css/index.html deleted file mode 100644 index 781ea7fb45..0000000000 --- a/files/my/learn/css/index.html +++ /dev/null @@ -1,67 +0,0 @@ ---- -title: CSS နင့် HTML အား အသွင်ပောင်းခင်း -slug: Learn/CSS -tags: - - Beginner - - CSS - - CodingScripting - - Debugging - - Landing - - NeedsContent - - NeedsTranslation - - Style - - Topic - - TopicStub - - length - - specificity -translation_of: Learn/CSS ---- -<div>{{LearnSidebar}}</div> - -<p class="summary">Cascading Stylesheets — or {{glossary("CSS")}} — is the first technology you should start learning after {{glossary("HTML")}}. While HTML is used to define the structure and semantics of your content, CSS is used to style it and lay it out. For example, you can use CSS to alter the font, color, size, and spacing of your content, split it into multiple columns, or add animations and other decorative features.</p> - -<h2 id="သင်ယူမုဆိုင်ရာ_လမ်းေကာင်း">သင်ယူမုဆိုင်ရာ လမ်းေကာင်း</h2> - -<p>You should learn the basics of HTML before attempting any CSS. We recommend that you work through our <a href="/en-US/docs/Learn/HTML/Introduction_to_HTML">Introduction to HTML</a> module first. In that module, you will learn about:</p> - -<ul> - <li>CSS, starting with the <a href="/en-US/docs/Learn/CSS/Introduction_to_CSS">Introduction to CSS</a> module</li> - <li>More advanced <a href="/en-US/docs/Learn/HTML#Modules">HTML modules</a></li> - <li><a href="/en-US/docs/Learn/JavaScript">JavaScript</a>, and how to use it to add dynamic functionality to web pages</li> -</ul> - -<p>Once you understand the fundamentals of HTML, we recommend that you learn HTML and CSS at the same time, moving back and forth between the two topics. This is because HTML is far more interesting and much more fun to learn when you apply CSS, and you can't really learn CSS without knowing HTML.</p> - -<p>Before starting this topic, you should also be familiar with using computers and using the web passively (i.e., just looking at it, consuming the content). You should have a basic work environment set up as detailed in <a href="/en-US/docs/Learn/Getting_started_with_the_web/Installing_basic_software">Installing basic software</a> and understand how to create and manage files, as detailed in <a href="/en-US/docs/Learn/Getting_started_with_the_web/Dealing_with_files">Dealing with files</a> — both of which are parts of our <a href="/en-US/docs/Learn/Getting_started_with_the_web">Getting started with the web</a> complete beginner's module.</p> - -<p>It is recommended that you work through <a href="/en-US/docs/Learn/Getting_started_with_the_web">Getting started with the web</a> before proceeding with this topic. However, doing so isn't absolutely necessary as much of what is covered in the CSS basics article is also covered in our <a href="/en-US/docs/Learn/CSS/Introduction_to_CSS">Introduction to CSS</a> module, albeit in a lot more detail.</p> - -<h2 id="သင်ရိုး">သင်ရိုး</h2> - -<p>This topic contains the following modules, in a suggested order for working through them. You should definitely start with the first one.</p> - -<dl> - <dt><a href="/en-US/docs/Learn/CSS/Introduction_to_CSS">Introduction to CSS</a></dt> - <dd>This module gets you started with the basics of how CSS works, including using selectors and properties; writing CSS rules; applying CSS to HTML; specifying length, color, and other units in CSS; controlling cascade and inheritance; understanding box model basics; and debugging CSS.</dd> - <dt><a href="/en-US/docs/Learn/CSS/Styling_text">Styling text</a></dt> - <dd>Here, we look at text-styling fundamentals, including setting font, boldness, and italics; line and letter spacing; and drop shadows and other text features. We round off the module by looking at applying custom fonts to your page and styling lists and links.</dd> - <dt><a href="/en-US/docs/Learn/CSS/Styling_boxes">Styling boxes</a></dt> - <dd>Next up, we look at styling boxes, one of the fundamental steps towards laying out a web page. In this module, we recap the box model, then look at controlling box layouts by setting padding, borders and margins, setting custom background colors, images, and fancy features such as drop shadows and filters on boxes.</dd> - <dt><a href="/en-US/docs/Learn/CSS/CSS_layout">CSS layout</a></dt> - <dd>At this point, we've already looked at CSS fundamentals, how to style text, and how to style and manipulate the boxes that your content sits inside. Now, it's time to look at how to place your boxes in the right place in relation to the viewport, and one another. We have covered the necessary prerequisites so we can now dive deep into CSS layout, looking at different display settings, modern layout tools like flexbox, CSS grid, and positioning, and some of the legacy techniques you might still want to know about.</dd> - <dt>Responsive design (TBD)</dt> - <dd>With so many different types of devices able to browse the web these days, <a href="/en-US/docs/Web/Guide/Responsive_design">responsive web design</a> (RWD) has become a core web development skill. This module will cover the basic principles and tools of RWD; explain how to apply different CSS to a document depending on device features like screen width, orientation, and resolution; and explore the technologies available for serving different videos and images depending on such features.</dd> -</dl> - -<h2 id="CSS_ဆိုင်ရာ_ပသနာများဖေရင်းခင်း">CSS ဆိုင်ရာ ပသနာများဖေရင်းခင်း</h2> - -<p><a href="/en-US/docs/Learn/CSS/Howto">Use CSS to solve common problems</a> provides links to sections of content explaining how to use CSS to solve very common problems when creating a web page.</p> - -<p>From the beginning, you'll primarily apply colors to HTML elements and their backgrounds; change the size, shape, and position of elements; and add and define borders on elements. But there's not much you can't do once you have a solid understanding of even the basics of CSS. One of the best things about learning CSS is that once you know the fundamentals, usually you have a pretty good feel for what can and can't be done, even if you don't actually know how to do it yet!</p> - -<h2 id="ပိုမိုလေ့လာရန်">ပိုမိုလေ့လာရန်</h2> - -<dl> - <dt><a href="/en-US/docs/Web/CSS">CSS on MDN</a></dt> - <dd>The main entry point for CSS documentation on MDN, where you'll find detailed reference documentation for all features of the CSS language. Want to know all the values a property can take? This is a good place to go.</dd> -</dl> diff --git a/files/my/learn/forms/html5_input_types/index.html b/files/my/learn/forms/html5_input_types/index.html deleted file mode 100644 index 1e3a209b8c..0000000000 --- a/files/my/learn/forms/html5_input_types/index.html +++ /dev/null @@ -1,277 +0,0 @@ ---- -title: The HTML5 input types -slug: Learn/Forms/HTML5_input_types -translation_of: Learn/Forms/HTML5_input_types -original_slug: Learn/HTML/Forms/HTML5_input_types ---- -<div>{{LearnSidebar}}</div> - -<div>{{PreviousMenuNext("Learn/Forms/Basic_native_form_controls", "Learn/Forms/Other_form_controls", "Learn/Forms")}}</div> - -<p class="summary">In the <a href="/en-US/docs/Learn/Forms/Basic_native_form_controls">previous article</a> we looked at the {{htmlelement("input")}} element, covering the original values of the <code>type</code> attribute available since the early days of HTML. Now we'll look at the functionality of newer form controls in detail, including some new input types, which were added in HTML5 to allow collection of specific types of data.</p> - -<table class="learn-box standard-table"> - <tbody> - <tr> - <th scope="row">Prerequisites:</th> - <td>Basic computer literacy, and a basic <a href="/en-US/docs/Learn/HTML/Introduction_to_HTML">understanding of HTML</a>.</td> - </tr> - <tr> - <th scope="row">Objective:</th> - <td>To understand the newer input type values available to create native form controls, and how to implement them using HTML.</td> - </tr> - </tbody> -</table> - -<div class="blockIndicator note"> -<p><strong>Note</strong>: Most of the features discussed in this article have wide support across browsers. We'll note any exceptions. If you want more detail on browser support, you should consult our <a href="https://developer.mozilla.org/en-US/docs/Web/HTML/Element#Forms">HTML forms element reference</a>, and in particular our extensive <a href="/en-US/docs/Web/HTML/Element/input"><input> types</a> reference.</p> -</div> - -<p>Because HTML form control appearance may be quite different from a designer's specifications, web developers sometimes build their own custom form controls. We cover this in an advanced tutorial — <a href="/en-US/docs/Learn/Forms/How_to_build_custom_form_widgets">How to build custom form widgets</a>.</p> - -<h2 id="E-mail_address_field">E-mail address field</h2> - -<p>This type of field is set using the value <code>email</code> for the {{htmlattrxref("type","input")}} attribute:</p> - -<pre class="brush: html"><input type="email" id="email" name="email"></pre> - -<p>When this {{htmlattrxref("type","input")}} is used, the user is required to type a valid email address into the field. Any other content causes the browser to display an error when the form is submitted. You can see this in action in the below screenshot.</p> - -<p><img alt='An invalid email input showing the message "Please enter an email address."' src="https://mdn.mozillademos.org/files/17027/email_address_invalid.png" style="display: block; height: 224px; margin: 0 auto; width: 369px;"></p> - -<p>You can also use the <a href="/en-US/docs/Web/HTML/Attributes/multiple"><code>multiple</code></a> attribute in combination with the <code>email</code> input type to allow several email addresses to be entered in the same input (separated by commas):</p> - -<pre class="brush: html"><input type="email" id="email" name="email" multiple></pre> - -<p>On some devices — notably, touch devices with dynamic keyboards like smart phones — a different virtual keypad might be presented that is more suitable for entering email addresses, including the <code>@</code> key. See the Firefox for Android keyboard screenshot below for an example:</p> - -<p><img alt="firefox for android email keyboard, with ampersand displayed by default." src="https://mdn.mozillademos.org/files/17054/fx-android-email-type-keyboard.jpg" style="border-style: solid; border-width: 1px; display: block; height: 324px; margin: 0 auto; width: 400px;"></p> - -<div class="blockIndicator note"> -<p><strong>Note</strong>: You can find examples of the basic text input types at <a href="https://mdn.github.io/learning-area/html/forms/basic-input-examples/">basic input examples</a> (see the <a href="https://github.com/mdn/learning-area/blob/master/html/forms/basic-input-examples/index.html">source code</a> also).</p> -</div> - -<p>This is another good reason for using these newer input types — improving the user experience for users of these devices.</p> - -<h3 id="Client-side_validation">Client-side validation</h3> - -<p>As you can see above, <code>email</code>, along with other newer <code>input</code> types, provides built-in <em>client-side</em> error validation — performed by the browser before the data gets sent to the server. It <em>is</em> a helpful aid to guide users to fill out a form accurately, and it can save time — it is useful to know that your data is not correct immediately, rather than having to wait for a round trip to the server.</p> - -<p>But it <em>should not be considered </em>an exhaustive security measure! Your apps should always perform security checks on any form-submitted data on the <em>server-side</em> as well as the client-side, because client-side validation is too easy to turn off, so malicious users can still easily send bad data through to your server. Read <a href="/en-US/docs/Learn/Server-side/First_steps/Website_security">Website security</a> for an idea of what <em>could</em> happen; implementing server-side validation is somewhat beyond the scope of this module, but you should bear it in mind.</p> - -<p>Note that <code>a@b</code> is a valid email address according to the default provided constraints. This is because the <code>email</code> input type allows intranet email addresses by default. To implement different validation behavior, you can use the <code><a href="/en-US/docs/Web/HTML/Attributes/pattern">pattern</a></code> attribute, and you can also custom the error messages; we'll talk how to use these features in the <a href="/en-US/docs/Learn/Forms/Form_validation">Client-side form validation</a> article later on.</p> - -<div class="note"> -<p><strong>Note</strong>: If the data entered is not an email address, the {{cssxref(':invalid')}} pseudo-class will match, and the {{domxref('validityState.typeMismatch')}} property will return <code>true</code>.</p> -</div> - -<h2 id="Search_field">Search field</h2> - -<p>Search fields are intended to be used to create search boxes on pages and apps. This type of field is set by using the value <code>search</code> for the {{htmlattrxref("type","input")}} attribute:</p> - -<pre class="brush: html"><input type="search" id="search" name="search"></pre> - -<p>The main difference between a <code>text</code> field and a <code>search</code> field is how the browser styles its appearance. Often, <code>search</code> fields are rendered with rounded corners; they also sometimes display an "Ⓧ", which clears the field of any value when clicked). Additionally, on devices with dynamic keyboards, the keyboard's enter key may read "<strong>search</strong>", or display a magnifying glass icon.</p> - -<p>The below screenshots show a non-empty search field in Firefox 71, Safari 13, and Chrome 79 on macOS, and Edge 18 and Chrome 79 on Windows 10. Note the clear icon only appears if the field has a value, and, apart from Safari, it is only displayed when the field is focused.</p> - -<p><img alt="Screenshots of search fields on several platforms." src="https://mdn.mozillademos.org/files/17028/search_focus.png" style="height: 179px; width: 549px;"></p> - -<p>Another feature worth noting is that the values of a <code>search</code> field can be automatically saved and re-used to offer auto-completion across multiple pages of the same website. This tends to happen automatically in most modern browsers.</p> - -<h2 id="Phone_number_field">Phone number field</h2> - -<p>A special field for filling in phone numbers can be created using <code>tel</code> as the value of the {{htmlattrxref("type","input")}} attribute:</p> - -<pre class="brush: html"><input type="tel" id="tel" name="tel"></pre> - -<p>When accessed via a touch device with a dynamic keyboard, most devices will display a numeric keypad when <code>type="tel"</code> is encountered, meaning this type is useful whenever a numeric keypad is useful, and doesn't just have to be used for telephone numbers.</p> - -<p>The following Firefox for Android keyboard screenshot provides an example:</p> - -<p><img alt="firefox for android email keyboard, with ampersand displayed by default." src="https://mdn.mozillademos.org/files/17056/fx-android-tel-type-keyboard.jpg" style="border-style: solid; border-width: 1px; display: block; height: 276px; margin: 0px auto; width: 400px;"></p> - -<p>Due to the wide variety of phone number formats around the world, this type of field does not enforce any constraints on the value entered by a user. (This means it may include letters, etc.).</p> - -<p>As we mentioned earlier, The <code><a href="/en-US/docs/Web/HTML/Attributes/pattern">pattern</a></code> attribute can be used to enforce constraints, which you'll learn about in <a href="/en-US/docs/Learn/Forms/Form_validation">Client-side form validation</a>.</p> - -<h2 id="URL_field">URL field</h2> - -<p>A special type of field for entering URLs can be created using the value <code>url</code> for the {{htmlattrxref("type","input")}} attribute:</p> - -<pre class="brush: html"><input type="url" id="url" name="url"></pre> - -<p>It adds special validation constraints to the field. The browser will report an error if no protocol (such as <code>http:</code>) is entered, or if the URL is otherwise malformed. On devices with dynamic keyboards, the default keyboard will often display some or all of the colon, period, and forward slash as default keys.</p> - -<p>See below for an example (taken on Fireox for Android):</p> - -<p><img alt="firefox for android email keyboard, with ampersand displayed by default." src="https://mdn.mozillademos.org/files/17057/fx-android-url-type-keyboard.jpg" style="border-style: solid; border-width: 1px; display: block; height: 325px; margin: 0px auto; width: 400px;"></p> - -<div class="note"><strong>Note:</strong> Just because the URL is well-formed doesn't necessarily mean that it refers to a location that actually exists!</div> - -<h2 id="Numeric_field">Numeric field</h2> - -<p>Controls for entering numbers can be created with an {{HTMLElement("input")}} {{htmlattrxref("type","input")}} of <code>number</code>. This control looks like a text field but allows only floating-point numbers, and usually provides buttons in the form of a spinner to increase and decrease the value of the control. On devices with dynamic keyboards, the numeric keyboard is generally displayed.</p> - -<p>The following screenshot (from Firefox for Android) provides an example:</p> - -<p><img alt="firefox for android email keyboard, with ampersand displayed by default." src="https://mdn.mozillademos.org/files/17055/fx-android-number-type-keyboard.jpg" style="border-style: solid; border-width: 1px; display: block; height: 275px; margin: 0px auto; width: 400px;"></p> - -<p>With the <code>number</code> input type, you can constrain the minimum and maximum values allowed by setting the {{htmlattrxref("min","input")}} and {{htmlattrxref("max","input")}} attributes.</p> - -<p>You can also use the <code>step</code> attribute to set the increment increase and decrease caused by pressing the spinner buttons. By default, the number input type only validates if the number is an integer. To allow float numbers, specify <code><a href="/en-US/docs/Web/HTML/Attributes/step">step="any"</a></code>. If omitted, the <code>step</code> value defaults to <code>1</code>, meaning only whole numbers are valid.</p> - -<p>Let's look at some examples. The first one below creates a number control whose value is restricted to any value between <code>1</code> and <code>10</code>, and whose increase and decrease buttons change its value by <code>2</code>.</p> - -<pre class="brush: html"><input type="number" name="age" id="age" min="1" max="10" step="2"></pre> - -<p>The second one creates a number control whose value is restricted to any value between <code>0</code> and <code>1</code> inclusive, and whose increase and decrease buttons change its value by <code>0.01</code>.</p> - -<pre class="brush: html"><input type="number" name="change" id="pennies" min="0" max="1" step="0.01"></pre> - -<p>The <code>number</code> input type makes sense when the range of valid values is limited, for example a person's age or height. If the range is too large for incremental increases to make sense (such as USA ZIP codes, which range from <code>00001</code> to <code>99999</code>), the <code>tel</code> type might be a better option; it provides the numeric keypad while forgoing the number's spinner UI feature.</p> - -<div class="blockIndicator note"> -<p><strong>Note</strong>: <code>number</code> inputs are not supported in versions of Internet Explorer below 10.</p> -</div> - -<h2 id="Slider_controls">Slider controls</h2> - -<p>Another way to pick a number is to use a <strong>slider</strong>. You see these quite often on sites like housebuying sites where you want to set a maximum property price to filter by. Let's look at a live example to illustrate this:</p> - -<p>{{EmbedGHLiveSample("learning-area/html/forms/range-example/index.html", '100%', 200)}}</p> - -<p>Usage-wise, sliders are less accurate than text fields. Therefore, they are used to pick a number whose <em>precise</em> value is not necessarily important.</p> - -<p>A slider is created using the {{HTMLElement("input")}} with its {{htmlattrxref("type","input")}} attribute set to the value <code>range</code>. The slider-thumb can be moved via mouse or touch, or with the arrows of the keypad.</p> - -<p>It's important to properly configure your slider. To that end, it's highly recommended that you set the <code><a href="/en-US/docs/Web/HTML/Attributes/min">min</a></code>, <code><a href="/en-US/docs/Web/HTML/Attributes/max">max</a></code>, and <code><a href="/en-US/docs/Web/HTML/Attributes/step">step</a></code> attributes which set the minimum, maximum and increment values, respectively.</p> - -<p>Let's look at the code behind the above example, so you can see how its done. First of all, the basic HTML:</p> - -<pre class="brush: html"><label for="price">Choose a maximum house price: </label> -<input type="range" name="price" id="price" min="50000" max="500000" step="100" value="250000"> -<output class="price-output" for="price"></output></pre> - -<p>This example creates a slider whose value may range between <code>50000</code> and <code>500000</code>, which increments/decrements by 100 at a time. We've given it default value of <code>250000</code>, using the <code>value</code> attribute.</p> - -<p>One problem with sliders is that they don't offer any kind of visual feedback as to what the current value is. This is why we've included an {{htmlelement("output")}} element — to contain the current value (we'll also look at this element in the next article). You could display an input value or the output of a calculation inside any element, but <code><output></code> is special — like <code><label></code>, it can take a <code>for</code> attribute that allows you to associate it with the element or elements that the output value came from.</p> - -<p>To actually display the current value, and update it as it changed, you must use JavaScript, but this is relatively easy to do:</p> - -<pre class="brush: js">const price = document.querySelector('#price') -const output = document.querySelector('.price-output') - -output.textContent = price.value - -price.addEventListener('input', function() { - output.textContent = price.value -});</pre> - -<p>Here we store references to the <code>range</code> input and the <code>output</code> in two variables. Then we immediately set the <code>output</code>'s <code><a href="/en-US/docs/Web/API/Node/textContent">textContent</a></code> to the current <code>value</code> of the input. Finally, an event listener is set to ensure that whenever the range slider is moved, the <code>output</code>'s <code>textContent</code> is updated to the new value.</p> - -<div class="blockIndicator note"> -<p><strong>Note</strong>: <code>range</code> inputs are not supported in versions of Internet Explorer below 10.</p> -</div> - -<h2 id="Date_and_time_pickers">Date and time pickers</h2> - -<p>Gathering date and time values has traditionally been a nightmare for web developers. For good user experience, it is important to provide a calendar selection UI, enabling users to select dates without necessating context switching to a native calendar application or potentially entering them in differing formats that are hard to parse. The last minute of the previous millenium can be expressed in the following different ways, for example: 1999/12/31, 23:59 or 12/31/99T11:59PM.</p> - -<p>HTML date controls are available to handle this specific kind of data, providing calendar widgets and making the data uniform.</p> - -<p>A date and time control is created using the {{HTMLElement("input")}} element and an appropriate value for the {{htmlattrxref("type","input")}} attribute, depending on whether you wish to collect dates, times, or both. Here's a live example that falls back to {{htmlelement("select")}} elements in non-supporting browsers:</p> - -<p>{{EmbedGHLiveSample("learning-area/html/forms/datetime-local-picker-fallback/index.html", '100%', 200)}}</p> - -<p>Let's look at the different available types in brief. Note that the usage of these types is quite complex, especially considering browser support (see below); to find out the full details, follow the links below to the reference pages for each type, including detailed examples.</p> - -<h3 id="datetime-local"><code>datetime-local</code></h3> - -<p><code><a href="/en-US/docs/Web/HTML/Element/input/datetime-local"><input type="datetime-local"></a></code> creates a widget to display and pick a date with time with no specific time zone information.</p> - -<pre class="brush: html"><input type="datetime-local" name="datetime" id="datetime"></pre> - -<h3 id="month"><code>month</code></h3> - -<p><code><a href="/en-US/docs/Web/HTML/Element/input/month"><input type="month"></a></code> creates a widget to display and pick a month with a year.</p> - -<pre class="brush: html"><input type="month" name="month" id="month"></pre> - -<h3 id="time"><code>time</code></h3> - -<p><code><a href="/en-US/docs/Web/HTML/Element/input/time"><input type="time"></a></code> creates a widget to display and pick a time value. While time may <em>display</em> in 12-hour format, the <em>value returned</em> is in 24-hour format.</p> - -<pre class="brush: html"><input type="time" name="time" id="time"></pre> - -<h3 id="week"><code>week</code></h3> - -<p><code><a href="/en-US/docs/Web/HTML/Element/input/week"><input type="week"></a></code> creates a widget to display and pick a week number and its year.</p> - -<p>Weeks start on Monday and run to Sunday. Additionally, the first week 1 of each year contains the first Thursday of that year—which may not include the first day of the year, or may include the last few days of the previous year.</p> - -<pre class="brush: html"><input type="week" name="week" id="week"></pre> - -<h3 id="Constraining_datetime_values">Constraining date/time values</h3> - -<p>All date and time controls can be constrained using the <code><a href="/en-US/docs/Web/HTML/Attributes/min">min</a></code> and <code><a href="/en-US/docs/Web/HTML/Attributes/max">max</a></code> attributes, with further constraining possible via the <code><a href="/en-US/docs/Web/HTML/Attributes/step">step</a></code> attribute (whose value is given in seconds).</p> - -<pre class="brush: html"><label for="myDate">When are you available this summer?</label> -<input type="date" name="myDate" min="2013-06-01" max="2013-08-31" step="3600" id="myDate"></pre> - -<h3 id="Browser_support_for_datetime_inputs">Browser support for date/time inputs</h3> - -<p>You should be warned that the date and time widgets don't have the best browser support. At the moment, Chrome, Edge, and Opera support them well, but there is no support in Internet Explorer, Safari has some mobile support (but no desktop support), and Firefox supports <code>time</code> and <code>date</code> only.</p> - -<p>The reference pages linked to above provide suggestions on how to program fallbacks for non-supporting browsers; another option is to consider using a JavaScript library to provide a date picker. Most modern frameworks have good components available to provide this functionality, and there are standalone libraries available to (see <a href="https://flatlogic.com/blog/best-javascript-date-picker-libraries/">Top date picker javascript plugins and libraries</a> for some suggestions).</p> - -<h2 id="Color_picker_control">Color picker control</h2> - -<p>Colors are always a bit difficult to handle. There are many ways to express them: RGB values (decimal or hexadecimal), HSL values, keywords, etc.</p> - -<p>A <code>color</code> control can be created using the {{HTMLElement("input")}} element with its {{htmlattrxref("type","input")}} attribute set to the value <code>color</code>:</p> - -<pre class="brush: html"><input type="color" name="color" id="color"></pre> - -<p>When supported, clicking a color control will tend to display the operating system's default color picking functionality for you to actually make your choice with. The following screenshot taken on Firefox for macOS provides an example:</p> - -<p><img alt="firefox for android email keyboard, with ampersand displayed by default." src="https://mdn.mozillademos.org/files/17058/fx-macos-color.jpg" style="border-style: solid; border-width: 1px; display: block; height: 412px; margin: 0px auto; width: 700px;"></p> - -<p>And here is a live example for you to try out:</p> - -<p>{{EmbedGHLiveSample("learning-area/html/forms/color-example/index.html", '100%', 200)}}</p> - -<p>The value returned is always a lowercase 6-value hexidecimal color.</p> - -<div class="blockIndicator note"> -<p><strong>Note</strong>: <code>color</code> inputs are not supported in Internet Explorer.</p> -</div> - -<h2 id="Summary">Summary</h2> - -<p>That brings us to the end of our tour of the HTML5 form input types. There are a few other control types that cannot be easily grouped together due to their very specific behaviors, but which are still essential to know about. We cover those in the next article.</p> - -<p>{{PreviousMenuNext("Learn/Forms/Basic_native_form_controls", "Learn/Forms/Other_form_controls", "Learn/Forms")}}</p> - -<h2 id="In_this_module">In this module</h2> - -<ul> - <li><a href="/en-US/docs/Learn/Forms/Your_first_form">Your first form</a></li> - <li><a href="/en-US/docs/Learn/Forms/How_to_structure_a_web_form">How to structure a web form</a></li> - <li><a href="/en-US/docs/Learn/Forms/Basic_native_form_controls">Basic native form controls</a></li> - <li><a href="/en-US/docs/Learn/Forms/HTML5_input_types">The HTML5 input types</a></li> - <li><a href="/en-US/docs/Learn/Forms/Other_form_controls">Other form controls</a></li> - <li><a href="/en-US/docs/Learn/Forms/Styling_web_forms">Styling web forms</a></li> - <li><a href="/en-US/docs/Learn/Forms/Advanced_form_styling">Advanced form styling</a></li> - <li><a href="/en-US/docs/Learn/Forms/UI_pseudo-classes">UI pseudo-classes</a></li> - <li><a href="/en-US/docs/Learn/Forms/Form_validation">Client-side form validation</a></li> - <li><a href="/en-US/docs/Learn/Forms/Sending_and_retrieving_form_data">Sending form data</a></li> -</ul> - -<h3 id="Advanced_Topics">Advanced Topics</h3> - -<ul> - <li><a href="/en-US/docs/Learn/Forms/How_to_build_custom_form_controls">How to build custom form controls</a></li> - <li><a href="/en-US/docs/Learn/Forms/Sending_forms_through_JavaScript">Sending forms through JavaScript</a></li> - <li><a href="/en-US/docs/Learn/Forms/Property_compatibility_table_for_form_widgets">Property compatibility table for form widgets</a></li> -</ul> diff --git a/files/my/learn/forms/index.html b/files/my/learn/forms/index.html deleted file mode 100644 index 03f1ed316c..0000000000 --- a/files/my/learn/forms/index.html +++ /dev/null @@ -1,84 +0,0 @@ ---- -title: HTML forms -slug: Learn/Forms -tags: - - Beginner - - Featured - - Forms - - Guide - - HTML - - Landing - - Learn - - NeedsTranslation - - TopicStub - - Web -translation_of: Learn/Forms -original_slug: Learn/HTML/Forms ---- -<div>{{LearnSidebar}}</div> - -<p class="summary">This module provides a series of articles that will help you master HTML forms. HTML forms are a very powerful tool for interacting with users; however, for historical and technical reasons, it's not always obvious how to use them to their full potential. In this guide, we'll cover all aspects of HTML forms, from structure to styling, from data handling to custom widgets.</p> - -<h2 id="Prerequisites">Prerequisites</h2> - -<p>Before starting this module, you should at least work through our <a href="/en-US/docs/Learn/HTML/Introduction_to_HTML">Introduction to HTML</a>. At this point you should find the {{anch("Basic guides")}} easy to understand, and also be able to make use of our <a href="/en-US/docs/Learn/HTML/Forms/The_native_form_widgets">Native form widgets</a> guide.</p> - -<p>The rest of the module however is a bit more advanced — it is easy to put form widgets on a page, but you can't actually do much with them without using some advanced form features, CSS, and JavaScript. Therefore, before you look at the other sections we'd recommend that you go away and learn some <a href="/en-US/docs/Learn/CSS">CSS</a> and <a href="/en-US/docs/Learn/JavaScript">JavaScript</a> first.</p> - -<div class="note"> -<p><strong>Note</strong>: If you are working on a computer/tablet/other device where you don't have the ability to create your own files, you could try out (most of) the code examples in an online coding program such as <a href="http://jsbin.com/">JSBin</a> or <a href="https://thimble.mozilla.org/">Thimble</a>.</p> -</div> - -<h2 id="Basic_guides">Basic guides</h2> - -<dl> - <dt><a href="/en-US/docs/Learn/HTML/Forms/Your_first_HTML_form">Your first HTML form</a></dt> - <dd>The first article in our series provides your very first experience of creating an HTML form, including designing a simple form, implementing it using the right HTML elements, adding some very simple styling via CSS, and how data is sent to a server.</dd> - <dt><a href="/en-US/docs/Learn/HTML/Forms/How_to_structure_an_HTML_form">How to structure an HTML form</a></dt> - <dd>With the basics out of the way, we now look in more detail at the elements used to provide structure and meaning to the different parts of a form.</dd> -</dl> - -<h2 id="What_form_widgets_are_available">What form widgets are available?</h2> - -<dl> - <dt><a href="/en-US/docs/Learn/HTML/Forms/The_native_form_widgets">The native form widgets</a></dt> - <dd>We now look at the functionality of the different form widgets in detail, looking at what options are available to collect different types of data.</dd> -</dl> - -<h2 id="Validating_and_submitting_form_data">Validating and submitting form data</h2> - -<dl> - <dt><a href="/en-US/docs/Learn/HTML/Forms/Sending_and_retrieving_form_data">Sending form data</a></dt> - <dd>This article looks at what happens when a user submits a form — where does the data go, and how do we handle it when it gets there? We also look at some of the security concerns associated with sending form data.</dd> - <dt><a href="/en-US/docs/Learn/HTML/Forms/Form_validation">Form data validation</a></dt> - <dd>Sending data is not enough — we also need to make sure that the data users fill out in forms is in the correct format we need to process it successfully, and that it won't break our applications. We also want to help our users to fill out our forms correctly and don't get frustrated when trying to use our apps. Form validation helps us achieve these goals — this article tells you what you need to know.</dd> -</dl> - -<h2 id="Advanced_guides">Advanced guides</h2> - -<dl> - <dt><a href="/en-US/docs/Learn/HTML/Forms/How_to_build_custom_form_widgets">How to build custom form widgets</a></dt> - <dd>You'll come across some cases where the native form widgets just don't provide what you need, e.g. because of styling or functionality. In such cases, you may need to build your own form widget out of raw HTML. This article explains how you'd do this and the considerations you need to be aware of when doing so, with a practical case study.</dd> - <dt><a href="/en-US/docs/Learn/HTML/Forms/Sending_forms_through_JavaScript">Sending forms through JavaScript</a></dt> - <dd>This article looks at ways to use a form to assemble an HTTP request and send it via custom JavaScript, rather than standard form submission. It also looks at why you'd want to do this, and the implications of doing so. (See also Using FormData objects.)</dd> - <dt><a href="/en-US/docs/Learn/HTML/Forms/HTML_forms_in_legacy_browsers">HTML forms in legacy browsers</a></dt> - <dd>Article covering feature detection, etc. This should be redirected to the cross browser testing module, as the same stuff is covered better there.</dd> -</dl> - -<h2 id="Form_styling_guides">Form styling guides</h2> - -<dl> - <dt><a href="/en-US/docs/Learn/HTML/Forms/Styling_HTML_forms">Styling HTML forms</a></dt> - <dd>This article provides an introduction to styling forms with CSS, including all the basics you might need to know for basic styling tasks.</dd> - <dt><a href="/en-US/docs/Learn/HTML/Forms/Advanced_styling_for_HTML_forms">Advanced styling for HTML forms</a></dt> - <dd>Here we look at some more advanced form styling techniques that need to be used when trying to deal with some of the more difficult-to-style elements.</dd> - <dt><a href="/en-US/docs/Learn/HTML/Forms/Property_compatibility_table_for_form_widgets">Property compatibility table for form widgets</a></dt> - <dd>This last article provides a handy reference allowing you to look up what CSS properties are compatible with what form elements.</dd> -</dl> - -<h2 id="See_also">See also</h2> - -<ul> - <li><a href="/en-US/docs/Web/HTML/Element#Forms">HTML forms element reference</a></li> - <li><a href="/en-US/docs/Web/HTML/Element/input">HTML <input> types reference</a></li> -</ul> diff --git a/files/my/learn/forms/your_first_form/index.html b/files/my/learn/forms/your_first_form/index.html deleted file mode 100644 index ec562f30b2..0000000000 --- a/files/my/learn/forms/your_first_form/index.html +++ /dev/null @@ -1,299 +0,0 @@ ---- -title: ပထမဆုံး Form -slug: Learn/Forms/Your_first_form -translation_of: Learn/Forms/Your_first_form -original_slug: Learn/HTML/Forms/Your_first_form ---- -<div>{{LearnSidebar}}{{NextMenu("Learn/Forms/How_to_structure_a_web_form", "Learn/Forms")}}</div> - -<p class="summary">Web form တစ်ခုဖန်တီးဖို့အတွက် ပထမဆုံးအတွေ့အကြုံကို ဆောင်းပါးစီးရီးရဲ့ ပထမဦးဆုံးသော ဒီဆောင်းပါးမှာ ရရှိမှာပါ။, HTML form controls တွေနဲ့ အခြား HTML elements တွေကိုမှန်ကန်စွာအသုံးချပြီး ရိုးရိုး form တစ်ခုကို ဒီဇိုင်းပုံဖော်ခြင်းနဲ့ လက်တွေ့ရေးဆွဲရပါမယ်။ CSS ကိုသုံးပြီး အဲဒီ Form ကို ရိုးရိုးလေး အလှဆင်တာနည်းနည်းလုပ်ရမယ်။ ဆာဗာကို ဒေတာတွေဘယ်လိုပို့သလဲဆိုတာလည်း လေ့လာရပါမယ်။ အပေါ်မှာပြောခဲ့တာတွေ တစ်ခုချင်းစီကို နောက်ပိုင်းမှာ နည်းနည်းပိုပြီးအသေးစိတ်ရှင်းပြပေးသွားပါမယ်။</p> - -<table class="learn-box standard-table"> - <tbody> - <tr> - <th scope="row">Prerequisites:</th> - <td>Basic computer literacy, and a basic <a href="/en-US/docs/Learn/HTML/Introduction_to_HTML">understanding of HTML</a>.</td> - </tr> - <tr> - <th scope="row">Objective:</th> - <td>To gain familiarity with what web forms are, what they are used for, how to think about designing them, and the basic HTML elements you'll need for simple cases.</td> - </tr> - </tbody> -</table> - -<h2 id="What_are_web_forms">What are web forms?</h2> - -<p><strong>Web forms</strong> are one of the main points of interaction between a user and a web site or application. Forms allow users to enter data, which is generally sent to a web server for processing and storage (see <a href="/en-US/docs/Learn/Forms/Sending_and_retrieving_form_data">Sending form data</a> later in the module), or used on the client-side to immediately update the interface in some way (for example, add another item to a list, or show or hide a UI feature).</p> - -<p>A<strong> </strong>web form's HTML is made up of one or more <strong>form controls</strong> (sometimes called <strong>widgets</strong>), plus some additional elements to help structure the overall form — they are often referred to as <strong>HTML forms</strong>. The controls can be single or multi-line text fields, dropdown boxes, buttons, checkboxes, or radio buttons, and are mostly created using the {{htmlelement("input")}} element, although there are some other elements to learn about too.</p> - -<p>Form controls can also be programmed to enforce specific formats or values to be entered (<strong>form validation</strong>), and paired with text labels that describe their purpose to both sighted and blind users.</p> - -<h2 id="Designing_your_form">Designing your form</h2> - -<p>Before starting to code, it's always better to step back and take the time to think about your form. Designing a quick mockup will help you to define the right set of data you want to ask your user to enter. From a user experience (UX) point of view, it's important to remember that the bigger your form, the more you risk frustrating people and losing users. Keep it simple and stay focused: ask only for the data you absolutely need.</p> - -<p>Designing forms is an important step when you are building a site or application. It's beyond the scope of this article to cover the user experience of forms, but if you want to dig into that topic you should read the following articles:</p> - -<ul> - <li>Smashing Magazine has some <a href="https://www.smashingmagazine.com/2018/08/ux-html5-mobile-form-part-1/" rel="external" title="http://uxdesign.smashingmagazine.com/tag/forms/">good articles about forms UX</a>, including an older but still relevant <a href="https://www.smashingmagazine.com/2011/11/extensive-guide-web-form-usability/" rel="external" title="http://uxdesign.smashingmagazine.com/2011/11/08/extensive-guide-web-form-usability/">Extensive Guide To Web Form Usability</a> article.</li> - <li>UXMatters is also a very thoughtful resource with good advice from <a href="http://www.uxmatters.com/mt/archives/2012/05/7-basic-best-practices-for-buttons.php" rel="external" title="http://www.uxmatters.com/mt/archives/2012/05/7-basic-best-practices-for-buttons.php">basic best practices</a> to complex concerns such as <a href="http://www.uxmatters.com/mt/archives/2010/03/pagination-in-web-forms-evaluating-the-effectiveness-of-web-forms.php" title="http://www.uxmatters.com/mt/archives/2010/03/pagination-in-web-forms-evaluating-the-effectiveness-of-web-forms.php">multi-page forms</a>.</li> -</ul> - -<p>In this article, we'll build a simple contact form. Let's make a rough sketch.</p> - -<p><img alt="The form to build, roughly sketch" src="/files/4579/form-sketch-low.jpg" style="border-style: solid; border-width: 1px; display: block; height: 352px; margin: 0px auto; width: 400px;"></p> - -<p>Our form will contain three text fields and one button. We are asking the user for their name, their e-mail and the message they want to send. Hitting the button will send their data to a web server.</p> - -<h2 id="Active_learning_Implementing_our_form_HTML">Active learning: Implementing our form HTML</h2> - -<p>Ok, let's have a go at creating the HTML for our form. We will use the following HTML elements: {{HTMLelement("form")}}, {{HTMLelement("label")}}, {{HTMLelement("input")}}, {{HTMLelement("textarea")}}, and {{HTMLelement("button")}}.</p> - -<p>Before you go any further, make a local copy of our <a href="https://github.com/mdn/learning-area/blob/master/html/introduction-to-html/getting-started/index.html">simple HTML template</a> — you'll enter your form HTML into here.</p> - -<h3 id="The_HTMLelementform_element">The {{HTMLelement("form")}} element</h3> - -<p>All forms start with a {{HTMLelement("form")}} element, like this:</p> - -<pre class="brush:html; notranslate"><form action="/my-handling-form-page" method="post"> - -</form></pre> - -<p>This element formally defines a form. It's a container element like a {{HTMLelement("section")}} or {{HTMLelement("footer")}} element, but specifically for containing forms; it also supports some specific attributes to configure the way the form behaves. All of its attributes are optional, but it's standard practice to always set at least the <a href="/en-US/docs/Web/HTML/Attributes/action"><code>action</code></a> and <a href="/en-US/docs/Web/HTML/Attributes/method"><code>method</code></a> attributes:</p> - -<ul> - <li>The <code>action</code> attribute defines the location (URL) where the form's collected data should be sent when it is submitted.</li> - <li>The <code>method</code> attribute defines which HTTP method to send the data with (usually <code>get</code> or <code>post</code>).</li> -</ul> - -<div class="note"> -<p><strong>Note</strong>: We'll look at how those attributes work in our <a href="/en-US/docs/Learn/HTML/Forms/Sending_and_retrieving_form_data" title="/en-US/docs/HTML/Forms/Sending_and_retrieving_form_data">Sending form data</a> article later on.</p> -</div> - -<p>For now, add the above {{htmlelement("form")}} element into your HTML {{htmlelement("body")}}.</p> - -<h3 id="The_HTMLelementlabel_HTMLelementinput_and_HTMLelementtextarea_elements">The {{HTMLelement("label")}}, {{HTMLelement("input")}}, and {{HTMLelement("textarea")}} elements</h3> - -<p>Our contact form is not complex: the data entry portion contains three text fields, each with a corresponding {{HTMLelement("label")}}:</p> - -<ul> - <li>The input field for the name is a {{HTMLelement("input/text", "single-line text field")}}.</li> - <li>The input field for the e-mail is an {{HTMLelement("input/email", "input of type email")}}: a single-line text field that accepts only e-mail addresses.</li> - <li>The input field for the message is a {{HTMLelement("textarea")}}; a multiline text field.</li> -</ul> - -<p>In terms of HTML code we need something like the following to implement these form widgets:</p> - -<pre class="brush:html; notranslate" dir="rtl"><form action="/my-handling-form-page" method="post"> - <ul> - <li> - <label for="name">Name:</label> - <input type="text" id="name" name="user_name"> - </li> - <li> - <label for="mail">E-mail:</label> - <input type="email" id="mail" name="user_email"> - </li> - <li> - <label for="msg">Message:</label> - <textarea id="msg" name="user_message"></textarea> - </li> - </ul> -</form></pre> - -<p>Update your form code to look like the above.</p> - -<p>The {{HTMLelement("li")}} elements are there to conveniently structure our code and make styling easier (see later in the article). For usability and accessibility, we include an explicit label for each form control. Note the use of the<a href="/en-US/docs/Web/HTML/Attributes/for"> <code>for</code> </a>attribute on all {{HTMLelement("label")}} elements, which takes as its value the <a href="/en-US/docs/Web/HTML/Attributes/id"><code>id</code></a> of the form control with which it is associated — this is how you associate a form control with its label.</p> - -<p>There is great benefit to doing this — it associates the label with the form control, enabling mouse, trackpad, and touch device users to click on the label to activate the corresponding control, and it also provides an accessible name for screen readers to read out to their users. You'll find further details of form labels in <a href="/en-US/docs/Learn/Forms/How_to_structure_a_web_form">How to structure a web form</a>.</p> - -<p>On the {{HTMLelement("input")}} element, the most important attribute is the <code>type</code> attribute. This attribute is extremely important because it defines the way the {{HTMLelement("input")}} element appears and behaves. You'll find more about this in the <a href="/en-US/docs/Learn/Forms/Basic_native_form_controls">Basic native form controls</a> article later on.</p> - -<ul> - <li>In our simple example, we use the value {{HTMLelement("input/text")}} for the first input — the default value for this attribute. It represents a basic single-line text field that accepts any kind of text input.</li> - <li>For the second input, we use the value {{HTMLelement("input/email")}}, which defines a single-line text field that only accepts a well-formed e-mail address. This turns a basic text field into a kind of "intelligent" field that will perform some validation checks on the data typed by the user. It also causes a more appropriate keyboard layout for entering email addresses (e.g. with an @ symbol by default) to appear on devices with dynamic keyboards, like smartphones. You'll find out more about form validation in the <a href="/en-US/docs/Learn/Forms/Form_validation">client-side form validation</a> article later on.</li> -</ul> - -<p>Last but not least, note the syntax of <code><input></code> vs. <code><textarea></textarea></code>. This is one of the oddities of HTML. The <code><input></code> tag is an empty element, meaning that it doesn't need a closing tag. {{HTMLElement("textarea")}} is not an empty element, meaning it should be closed with the proper ending tag. This has an impact on a specific feature of forms: the way you define the default value. To define the default value of an {{HTMLElement("input")}} element you have to use the <a href="/en-US/docs/Web/HTML/Attributes/value"><code>value</code></a> attribute like this:</p> - -<pre class="brush:html; notranslate"><input type="text" value="by default this element is filled with this text"></pre> - -<p>On the other hand, if you want to define a default value for a {{HTMLElement("textarea")}}, you put it between the opening and closing tags of the {{HTMLElement("textarea")}} element, like this:</p> - -<pre class="brush:html; notranslate"><textarea> -by default this element is filled with this text -</textarea></pre> - -<h3 id="The_HTMLelementbutton_element">The {{HTMLelement("button")}} element</h3> - -<p>The markup for our form is almost complete; we just need to add a button to allow the user to send, or "submit", their data once they have filled out the form. This is done by using the {{HTMLelement("button")}} element; add the following just above the closing <code></ul></code> tag:</p> - -<pre class="brush:html; notranslate"><li class="button"> - <button type="submit">Send your message</button> -</li></pre> - -<p>The {{htmlelement("button")}} element also accepts a <code>type</code> attribute — this accepts one of three values: <code>submit</code>, <code>reset</code>, or <code>button</code>.</p> - -<ul> - <li>A click on a <code>submit</code> button (the default value) sends the form's data to the web page defined by the <code>action</code> attribute of the {{HTMLelement("form")}} element.</li> - <li>A click on a <code>reset</code> button resets all the form widgets to their default value immediately. From a UX point of view, this is considered bad practice, so you should avoid using this type of button unless you really have a good reason to include one.</li> - <li>A click on a <code>button</code> button does... nothing! That sounds silly, but it's amazingly useful for building custom buttons — you can define their chosen functionality with JavaScript.</li> -</ul> - -<div class="note"> -<p><strong>Note</strong>: You can also use the {{HTMLElement("input")}} element with the corresponding <code>type</code> to produce a button, for example <code><input type="submit"></code>. The main advantage of the {{HTMLelement("button")}} element is that the {{HTMLelement("input")}} element only allows plain text in its label whereas the {{HTMLelement("button")}} element allows full HTML content, allowing more complex, creative button content.</p> -</div> - -<h2 id="Basic_form_styling">Basic form styling</h2> - -<p>Now that you have finished writing your form's HTML code, try saving it and looking at it in a browser. At the moment, you'll see that it looks rather ugly.</p> - -<div class="note"> -<p><strong>Note</strong>: If you don't think you've got the HTML code right, try comparing it with our finished example — see <a href="https://github.com/mdn/learning-area/blob/master/html/forms/your-first-HTML-form/first-form.html">first-form.html</a> (<a href="https://mdn.github.io/learning-area/html/forms/your-first-HTML-form/first-form.html">also see it live</a>).</p> -</div> - -<p>Forms are notoriously tricky to style nicely. It is beyond the scope of this article to teach you form styling in detail, so for the moment we will just get you to add some CSS to make it look OK.</p> - -<p>First of all, add a {{htmlelement("style")}} element to your page, inside your HTML head. It should look like so:</p> - -<pre class="brush: html notranslate"><style> - -</style></pre> - -<p>Inside the <code>style</code> tags, add the following CSS:</p> - -<pre class="brush:css; notranslate">form { - /* Center the form on the page */ - margin: 0 auto; - width: 400px; - /* Form outline */ - padding: 1em; - border: 1px solid #CCC; - border-radius: 1em; -} - -ul { - list-style: none; - padding: 0; - margin: 0; -} - -form li + li { - margin-top: 1em; -} - -label { - /* Uniform size & alignment */ - display: inline-block; - width: 90px; - text-align: right; -} - -input, -textarea { - /* To make sure that all text fields have the same font settings - By default, textareas have a monospace font */ - font: 1em sans-serif; - - /* Uniform text field size */ - width: 300px; - box-sizing: border-box; - - /* Match form field borders */ - border: 1px solid #999; -} - -input:focus, -textarea:focus { - /* Additional highlight for focused elements */ - border-color: #000; -} - -textarea { - /* Align multiline text fields with their labels */ - vertical-align: top; - - /* Provide space to type some text */ - height: 5em; -} - -.button { - /* Align buttons with the text fields */ - padding-left: 90px; /* same size as the label elements */ -} - -button { - /* This extra margin represent roughly the same space as the space - between the labels and their text fields */ - margin-left: .5em; -}</pre> - -<p>Save and reload, and you'll see that your form should look much less ugly.</p> - -<div class="note"> -<p><strong>Note</strong>: You can find our version on GitHub at <a href="https://github.com/mdn/learning-area/blob/master/html/forms/your-first-HTML-form/first-form-styled.html">first-form-styled.html</a> (<a href="https://mdn.github.io/learning-area/html/forms/your-first-HTML-form/first-form-styled.html">also see it live</a>).</p> -</div> - -<h2 id="Sending_form_data_to_your_web_server">Sending form data to your web server</h2> - -<p>The last part, and perhaps the trickiest, is to handle form data on the server side. The {{HTMLelement("form")}} element defines where and how to send the data thanks to the <a href="/en-US/docs/Web/HTML/Attributes/action"><code>action</code></a> and <a href="/en-US/docs/Web/HTML/Attributes/method"><code>method</code></a> attributes.</p> - -<p>We provide a <a href="/en-US/docs/Web/HTML/Attributes/name"><code>name</code></a> to each form control. The names are important on both the client- and server-side; they tell the browser which name to give each piece of data and, on the server side, they let the server handle each piece of data by name. The form data is sent to the server as name/value pairs.</p> - -<p>To name the data in a form you need to use the <code>name</code> attribute on each form widget that will collect a specific piece of data. Let's look at some of our form code again:</p> - -<pre class="brush:html; notranslate"><form action="/my-handling-form-page" method="post"> - <ul> - <li> - <label for="name">Name:</label> - <input type="text" id="name" name="user_name" /> - </li> - <li> - <label for="mail">E-mail:</label> - <input type="email" id="mail" name="user_email" /> - </li> - <li> - <label for="msg">Message:</label> - <textarea id="msg" name="user_message"></textarea> - </li> - - ... -</pre> - -<p>In our example, the form will send 3 pieces of data named "<code>user_name</code>", "<code>user_email</code>", and "<code>user_message</code>". That data will be sent to the URL "<code>/my-handling-form-page</code>" using the <a href="/en-US/docs/Web/HTTP/Methods/POST">HTTP <code>POST</code></a> method.</p> - -<p>On the server side, the script at the URL "<code>/my-handling-form-page</code>" will receive the data as a list of 3 key/value items contained in the HTTP request. The way this script will handle that data is up to you. Each server-side language (PHP, Python, Ruby, Java, C#, etc.) has its own mechanism of handling form data. It's beyond the scope of this guide to go deeply into that subject, but if you want to know more, we have provided some examples in our <a href="/en-US/docs/Learn/HTML/Forms/Sending_and_retrieving_form_data" title="/en-US/docs/HTML/Forms/Sending_and_retrieving_form_data"><span>Sending form data</span></a> article later on.</p> - -<h2 id="Summary">Summary</h2> - -<p>Congratulations, you've built your first web form. It looks like this live:</p> - -<p>{{ EmbedLiveSample('A_simple_form', '100%', '240', '', 'Learn/Forms/Your_first_form/Example') }}</p> - -<p>That's only the beginning, however — now it's time to take a deeper look. Forms have way more power than what we saw here and the other articles in this module will help you to master the rest.</p> - -<p>{{NextMenu("Learn/Forms/How_to_structure_a_web_form", "Learn/Forms")}}</p> - -<h2 id="In_this_module">In this module</h2> - -<ul> - <li><a href="/en-US/docs/Learn/Forms/Your_first_form">Your first form</a></li> - <li><a href="/en-US/docs/Learn/Forms/How_to_structure_a_web_form">How to structure a web form</a></li> - <li><a href="/en-US/docs/Learn/Forms/Basic_native_form_controls">Basic native form controls</a></li> - <li><a href="/en-US/docs/Learn/Forms/HTML5_input_types">The HTML5 input types</a></li> - <li><a href="/en-US/docs/Learn/Forms/Other_form_controls">Other form controls</a></li> - <li><a href="/en-US/docs/Learn/Forms/Styling_web_forms">Styling web forms</a></li> - <li><a href="/en-US/docs/Learn/Forms/Advanced_form_styling">Advanced form styling</a></li> - <li><a href="/en-US/docs/Learn/Forms/UI_pseudo-classes">UI pseudo-classes</a></li> - <li><a href="/en-US/docs/Learn/Forms/Form_validation">Client-side form validation</a></li> - <li><a href="/en-US/docs/Learn/Forms/Sending_and_retrieving_form_data">Sending form data</a></li> -</ul> - -<h3 id="Advanced_Topics">Advanced Topics</h3> - -<ul> - <li><a href="/en-US/docs/Learn/Forms/How_to_build_custom_form_controls">How to build custom form controls</a></li> - <li><a href="/en-US/docs/Learn/Forms/Sending_forms_through_JavaScript">Sending forms through JavaScript</a></li> - <li><a href="/en-US/docs/Learn/Forms/Property_compatibility_table_for_form_widgets">Property compatibility table for form widgets</a></li> -</ul> diff --git a/files/my/learn/html/index.html b/files/my/learn/html/index.html deleted file mode 100644 index efe1fad267..0000000000 --- a/files/my/learn/html/index.html +++ /dev/null @@ -1,52 +0,0 @@ ---- -title: HTML -slug: Learn/HTML -translation_of: Learn/HTML ---- -<div>{{LearnSidebar}}</div> - -<p class="summary">To build websites, you should know about {{Glossary('HTML')}} — the fundamental technology used to define the structure of a webpage. HTML is used to specify whether your web content should be recognized as a paragraph, list, heading, link, image, multimedia player, form, or one of many other available elements or even a new element that you define.</p> - -<h2 id="သင်ယူမုဆိုင်ရာ_လမ်းေကာင်း">သင်ယူမုဆိုင်ရာ လမ်းေကာင်း</h2> - -<p>Ideally you should start your learning journey by learning HTML. Start by reading <a href="/en-US/docs/Web/Guide/HTML/Introduction">Introduction to HTML</a>. You may then move on to learning about more advanced topics such as:</p> - -<ul> - <li><a href="/en-US/docs/Learn/CSS">CSS</a>, and how to use it to style HTML (for example alter your text size and fonts used, add borders and drop shadows, layout your page with multiple columns, add animations and other visual effects.)</li> - <li><a href="/en-US/docs/Learn/JavaScript">JavaScript</a>, and how to use it to add dynamic functionality to web pages (for example find your location and plot it on a map, make UI elements appear/disappear when you toggle a button, save users' data locally on their computers, and much much more.)</li> -</ul> - -<dl> -</dl> - -<p>Before starting this topic, you should have at least basic familiarity with using computers, and using the web passively (i.e. just looking at it, consuming the content). You should have a basic work environment set up as detailed in <a href="/en-US/docs/Learn/Getting_started_with_the_web/Installing_basic_software">Installing basic software</a>, and understand how to create and manage files, as detailed in <a href="/en-US/docs/Learn/Getting_started_with_the_web/Dealing_with_files">Dealing with files</a> — both are parts of our <a href="/en-US/docs/Learn/Getting_started_with_the_web">Getting started with the web</a> complete beginner's module.</p> - -<p>It is recommended that you work through <a href="/en-US/docs/Learn/Getting_started_with_the_web">Getting started with the web </a>before attempting this topic, however it isn't absolutely necessary; much of what is covered in the <a href="/en-US/docs/Learn/Getting_started_with_the_web/HTML_basics">HTML basics</a> article is also covered in our <a href="/en-US/docs/Learn/HTML/Introduction_to_HTML">Introduction to HTML</a> module, albeit in a lot more detail.</p> - -<h2 id="သင်ရိုး">သင်ရိုး</h2> - -<p>This topic contains the following modules, in a suggested order for working through them. You should definitely start with the first one.</p> - -<dl> - <dt><a href="/en-US/docs/Learn/HTML/Introduction_to_HTML">Introduction to HTML</a></dt> - <dd>This module sets the stage, getting you used to important concepts and syntax, looking at applying HTML to text, how to create hyperlinks, and how to use HTML to structure a webpage.</dd> - <dt><a href="/en-US/docs/Learn/HTML/Multimedia_and_embedding">Multimedia and embedding</a></dt> - <dd>This module explores how to use HTML to include multimedia in your web pages, including the different ways that images can be included, and how to embed video, audio, and even entire other webpages.</dd> - <dt><a href="/en-US/docs/Learn/HTML/Tables">HTML Tables</a></dt> - <dd>Representing tabular data on a webpage in an understandable, {{glossary("Accessibility", "accessible")}} way can be a challenge. This module covers basic table markup, along with more complex features such as implementing captions and summaries.</dd> - <dt><a href="/en-US/docs/Learn/HTML/Forms">HTML Forms</a></dt> - <dd>Forms are a very important part of the Web — these provide much of the functionality you need for interacting with web sites, e.g. registering and logging in, sending feedback, buying products, and more. This module gets you started with creating the client-side parts of forms.</dd> -</dl> - -<h2 id="HTML_ပသနာများ_ေဖရင်းခင်း"> HTML ပသနာများ ေဖရင်းခင်း</h2> - -<p><a href="/en-US/docs/Learn/HTML/Howto">Use HTML to solve common problems</a> provides links to sections of content explaining how to use HTML to solve very common problems when creating a webpage: dealing with titles, adding images or videos, emphasizing content, creating a basic form, etc.</p> - -<h2 id="ပိုမိုလေ့လာရန်">ပိုမိုလေ့လာရန်</h2> - -<div class="document-head" id="wiki-document-head"> -<dl> - <dt><a href="/en-US/docs/Web/HTML">HTML (HyperText Markup Language)</a> on MDN</dt> - <dd>The main entry point for HTML documentation on MDN, including detailed element and attribute references — if you want to know what attributes an element has or what values an attribute has, for example, this is a great place to start.</dd> -</dl> -</div> diff --git a/files/my/learn/index.html b/files/my/learn/index.html deleted file mode 100644 index 367d375f74..0000000000 --- a/files/my/learn/index.html +++ /dev/null @@ -1,89 +0,0 @@ ---- -title: Web developement အကြောင်းလေ့လာခြင်း -slug: Learn -tags: - - Beginner - - Index - - Landing - - Learn - - Web -translation_of: Learn ---- -<div class="summary"> -<p>vbnကိုယ်တိုင် website တစ်ခု ဒါမှမဟုတ် web app တခုဖန်တီးချင်တယ်ဟုတ်။ ဒီနေရာကသင့်ကိုစောင့်နေပါတယ်။</p> -</div> - -<p>web design နဲ့ development အတွက် သင်ယူစရာတွေများပပြားလှပါတယ်။ ဒါပေမဲ့ စိတ်မပူပါနဲ့ ။ ကျွန်တော်တို့ သင့်ကို professional web developer တယောက်အဖြစ်ရပ်တည်နိုင်လာအောင် ကူညီလမ်းပြပေးမှာပါ။</p> - -<h2 id="ဘယ်နေအစပြုချင်လဲ">ဘယ်နေအစပြုချင်လဲ</h2> - -<p>ခင်ဗျားနဲ့ ကျွန်တော်တို့တော့ ဆုံကြပြီ၊ ဘယ်အကြောင်းအရာကိုခင်ဗျားလေ့လာချင်ပါသလဲ။</p> - -<ul class="card-grid"> - <li><span>ကျွန်တော် သင်ယူစ တစ်ယောက်ပါ</span><span style='font-family: "Open Sans",arial,x-locale-body,sans-serif;'> </span><a href="/en-US/Learn/Getting_started_with_the_web" style='font-family: "Open Sans", arial, x-locale-body, sans-serif;'>"Getting started with the Web"</a><span style='font-family: "Open Sans",arial,x-locale-body,sans-serif;'> ကြိုစိုပါတယ်။ web developement ရဲ့ အခြခံသိစရာအဖြာဖြာ ကို ထောက်ပ့ပေးထားတဲ့ ဆောင်းပါး အတွဲဆက်က သင့်ကို ကူညီပေးမှာပါ။</span></li> - <li> - <p>Very good! In that case, we suggest you dig deeper into the technologies at the heart of the Web: <a href="/en-US/docs/Learn/HTML">HTML</a>, <a href="/en-US/docs/Learn/CSS">CSS</a>, and <a href="/en-US/docs/Learn/JavaScript">JavaScript</a></p> - </li> - <li><span>web နဲ့ပတ်သက်ပြီးအထူးကျွမ်းကြင်ပြီးသားပါ</span> - <p>Amazing!တယ်ဟုတ်ပါလား၊ ဒါဆို ခင်ဗျား အဆင့်မြင့် သင်ခန်းစာနဲ့ ၊လမ်းညွန်မှုတွေကို လေ့လာဖို့ စိတ်ဝင်စစိတ် casားcယ်asားမe, you may be interested in exploring our advanced <a href="/en-US/docs/Web/Guide">Guides</a> and <a href="/en-US/docs/Web/Tutorials">Tutorials</a>. You should also consider <a href="/en-US/Learn/How_to_contribute">contributing to the Learning Area</a>. ;)ကျ်ျွကျ်ျ</p> - </li> -</ul> - -<div class="note"> -<p><strong>Note</strong>: In the future, we're planning to publish more learning pathways, for example for experienced coders learning specific advanced techniques, native developers who are new to the Web, or people who want to learn design techniques.</p> -</div> - -<p>{{LearnBox({"title":"Quick learning: Vocabulary"})}}</p> - -<h2 id="Learning_with_other_people">Learning with other people</h2> - -<p>If you have a question or are still wondering where to go, Mozilla is a global community of Web enthusiasts, including mentors and teachers who are glad to help you. Get in touch with them through WebMaker:</p> - -<ul> - <li>Meet and talk with mentors and teachers at the <a href="http://discourse.webmaker.org/" rel="external">discourse forum</a>.</li> - <li><a href="https://events.webmaker.org/">Find events</a> and learn the web with awesome folks.</li> -</ul> - -<h2 id="Sharing_knowledge">Sharing knowledge</h2> - -<p>This whole Learning Area is built by our contributors. We need you in our team whether you are a beginner, a teacher, or a skilled web developer. If you're interested, take a look at <a href="/en-US/Learn/How_to_contribute">how you can help</a>, and we encourage you to chat with us on our <a href="/en-US/docs/MDN/Community#Join_our_mailing_lists">mailing lists</a> or <a href="/en-US/docs/MDN/Community#Get_into_IRC">IRC channel</a>. :)</p> - -<h2 id="Subnav">Subnav</h2> - -<ol> - <li>Web နှင့်အစပြုကြရအောင်</li> - <li>Web အကြောင်းသိကောင်းစရာ - <ol> - <li><a href="https://webmaker.org/en-US/literacy" rel="external">Web Literacy Map</a></li> - <li><a href="/en-US/Learn/Web_Mechanics">Web mechanics</a></li> - <li><a href="/en-US/Learn/Infrastructure">Infrastructure</a></li> - <li><a href="/en-US/Learn/Coding-Scripting">Coding & Scripting</a></li> - <li><a href="/en-US/Learn/Design_and_Accessibility">Design & Accessibility</a></li> - <li><a href="/en-US/Learn/Composing_for_the_web">Writing & planning</a></li> - </ol> - </li> - <li>နည်းပညာများ လေ့လာမယ် - <ol> - <li><a href="/en-US/Learn/HTML">HTML</a></li> - <li><a href="/en-US/Learn/CSS">CSS</a></li> - <li><a href="/en-US/Learn/JavaScript">JavaScript</a></li> - <li><a href="/en-US/Learn/Python">Python</a></li> - </ol> - </li> - <li>သင်ခန်းစာများနှင့် လေ့လာမယ် - <ol> - <li>Website တစ်ခုဘယ်လိုတည်ဆောက်မလဲ</li> - <li><a href="/en-US/Learn/tutorial/Information_Security_Basics">Information security </a>အခြေခံ</li> - </ol> - </li> - <li>သင်ယူမှုအရင်းအမြစ်များရယူရန်</li> - <li>အကူအညီရယူရန် - <ol> - <li><a href="/en-US/Learn/FAQ">FAQ</a></li> - <li><a href="/en-US/docs/Glossary">Glossary</a></li> - <li><a href="http://discourse.webmakerprototypes.org/" rel="external">Ask your questions</a></li> - <li><a href="https://events.webmaker.org/" rel="external">Meet teachers and mentors</a></li> - </ol> - </li> - <li>ကျွန်တော်တို့ကို ကူညီ ထောက်ပံပါ</li> -</ol> diff --git a/files/my/learn/javascript/index.html b/files/my/learn/javascript/index.html deleted file mode 100644 index 2e6649a258..0000000000 --- a/files/my/learn/javascript/index.html +++ /dev/null @@ -1,66 +0,0 @@ ---- -title: JavaScript -slug: Learn/JavaScript -tags: - - Beginner - - CodingScripting - - JavaScript - - JavaScripting beginner - - Landing - - Module - - NeedsTranslation - - Topic - - TopicStub - - 'l10n:priority' -translation_of: Learn/JavaScript ---- -<div>{{LearnSidebar}}</div> - -<p class="summary">{{Glossary("JavaScript")}} is a programming language that allows you to implement complex things on web pages. Every time a web page does more than just sit there and display static information for you to look at — displaying timely content updates, or interactive maps, or animated 2D/3D graphics, or scrolling video jukeboxes, and so on — you can bet that JavaScript is probably involved.</p> - -<h2 id="Learning_pathway">Learning pathway</h2> - -<p>JavaScript is arguably more difficult to learn than related technologies such as <a href="/en-US/docs/Learn/HTML">HTML</a> and <a href="/en-US/docs/Learn/CSS">CSS</a>. Before attempting to learn JavaScript, you are strongly advised to get familiar with at least these two technologies first, and perhaps others as well. Start by working through the following modules:</p> - -<ul> - <li><a href="/en-US/docs/Learn/Getting_started_with_the_web">Getting started with the Web</a></li> - <li><a href="/en-US/docs/Web/Guide/HTML/Introduction">Introduction to HTML</a></li> - <li><a href="/en-US/docs/Learn/CSS/Introduction_to_CSS">Introduction to CSS</a></li> -</ul> - -<p>Having previous experience with other programming languages might also help.</p> - -<p>After getting familiar with the basics of JavaScript, you should be in a position to learn about more advanced topics, for example:</p> - -<ul> - <li>JavaScript in depth, as taught in our <a href="/en-US/docs/Web/JavaScript/Guide">JavaScript guide</a></li> - <li><a href="/en-US/docs/Web/API">Web APIs</a></li> -</ul> - -<h2 id="Modules">Modules</h2> - -<p>This topic contains the following modules, in a suggested order for working through them.</p> - -<dl> - <dt><a href="/en-US/docs/Learn/JavaScript/First_steps">JavaScript first steps</a></dt> - <dd>In our first JavaScript module, we first answer some fundamental questions such as "what is JavaScript?", "what does it look like?", and "what can it do?", before moving on to taking you through your first practical experience of writing JavaScript. After that, we discuss some key JavaScript features in detail, such as variables, strings, numbers and arrays.</dd> - <dt><a href="/en-US/docs/Learn/JavaScript/Building_blocks">JavaScript building blocks</a></dt> - <dd>In this module, we continue our coverage of all JavaScript's key fundamental features, turning our attention to commonly-encountered types of code block such as conditional statements, loops, functions, and events. You've seen this stuff already in the course, but only in passing — here we'll discuss it all explicitly.</dd> - <dt><a href="/en-US/docs/Learn/JavaScript/Objects">Introducing JavaScript objects</a></dt> - <dd>In JavaScript, most things are objects, from core JavaScript features like strings and arrays to the browser APIs built on top of JavaScript. You can even create your own objects to encapsulate related functions and variables into efficient packages. The object-oriented nature of JavaScript is important to understand if you want to go further with your knowledge of the language and write more efficient code, therefore we've provided this module to help you. Here we teach object theory and syntax in detail, look at how to create your own objects, and explain what JSON data is and how to work with it.</dd> - <dt><a href="/en-US/docs/Learn/JavaScript/Client-side_web_APIs">Client-side web APIs</a></dt> - <dd>When writing client-side JavaScript for web sites or applications, you won't go very far before you start to use APIs — interfaces for manipulating different aspects of the browser and operating system the site is running on, or even data from other web sites or services. In this module we will explore what APIs are, and how to use some of the most common APIs you'll come across often in your development work. </dd> -</dl> - -<h2 id="Solving_common_JavaScript_problems">Solving common JavaScript problems</h2> - -<p><a href="/en-US/docs/Learn/JavaScript/Howto">Use JavaScript to solve common problems</a> provides links to sections of content explaining how to use JavaScript to solve very common problems when creating a webpage.</p> - -<h2 id="See_also">See also</h2> - -<dl> - <dt><a href="/en-US/docs/Web/JavaScript">JavaScript on MDN</a></dt> - <dd>The main entry point for core JavaScript documentation on MDN — this is where you'll find extensive reference docs on all aspects of the JavaScript language, and some advanced tutorials aimed at experienced JavaScripters.</dd> - <dt><a href="https://www.youtube.com/user/codingmath">Coding math</a></dt> - <dd>An excellent series of video tutorials to teach the math you need to understand to be an effective programmer, by <a href="https://twitter.com/bit101">Keith Peters</a>.</dd> -</dl> diff --git a/files/my/mozilla/index.html b/files/my/mozilla/index.html deleted file mode 100644 index ddb9a6605f..0000000000 --- a/files/my/mozilla/index.html +++ /dev/null @@ -1,12 +0,0 @@ ---- -title: Mozilla -slug: Mozilla -tags: - - Landing - - Mozilla - - NeedsTranslation - - TopicStub -translation_of: Mozilla ---- -<p>The articles below include content about downloading and building Mozilla code. In addition, you'll find helpful articles about how the code works, how to build add-ons for Mozilla applications and the like.</p> -<p>{{LandingPageListSubpages}}</p> diff --git a/files/my/web/css/@font-face/index.html b/files/my/web/css/@font-face/index.html deleted file mode 100644 index d834a0a44c..0000000000 --- a/files/my/web/css/@font-face/index.html +++ /dev/null @@ -1,196 +0,0 @@ ---- -title: '@font-face' -slug: Web/CSS/@font-face -translation_of: Web/CSS/@font-face ---- -<div>{{CSSRef}}</div> - -<p><span class="seoSummary">The <strong><code>@font-face</code></strong> <a href="/en-US/docs/CSS">CSS</a> <a href="/en-US/docs/CSS/At-rule">at-rule</a> specifies a custom font with which to display text; the font can be loaded from either a remote server or a locally-installed font on the user's own computer.</span></p> - -<h2 id="Syntax">Syntax</h2> - -<pre class="brush: css no-line-numbers notranslate">@font-face { - font-family: "Open Sans"; - src: url("/fonts/OpenSans-Regular-webfont.woff2") format("woff2"), - url("/fonts/OpenSans-Regular-webfont.woff") format("woff"); -}</pre> - -<h3 id="Descriptors">Descriptors</h3> - -<dl> - <dt>{{cssxref("@font-face/font-display", "font-display")}}</dt> - <dd>Determines how a font face is displayed based on whether and when it is downloaded and ready to use.</dd> - <dt>{{cssxref("@font-face/font-family", "font-family")}}</dt> - <dd>Specifies a name that will be used as the font face value for font properties.</dd> - <dt>{{cssxref("@font-face/font-stretch", "font-stretch")}}</dt> - <dd>A {{cssxref("font-stretch")}} value. Since Firefox 61 (and in other modern browsers) this also accepts two values to specify a range that is supported by a font-face, for example <code>font-stretch: 50% 200%;</code></dd> - <dt>{{cssxref("@font-face/font-style", "font-style")}}</dt> - <dd>A {{cssxref("font-style")}} value. Since Firefox 61 (and in other modern browsers) this also accepts two values to specify a range that is supported by a font-face, for example <code>font-style: oblique 20deg 50deg;</code></dd> - <dt>{{cssxref("@font-face/font-weight", "font-weight")}}</dt> - <dd>A {{cssxref("font-weight")}} value. Since Firefox 61 (and in other modern browsers) this also accepts two values to specify a range that is supported by a font-face, for example <code>font-weight: 100 400;</code></dd> - <dt>{{cssxref("@font-face/font-variant", "font-variant")}}</dt> - <dd>A {{cssxref("font-variant")}} value.</dd> - <dt>{{cssxref("font-feature-settings", "font-feature-settings")}}</dt> - <dd>Allows control over advanced typographic features in OpenType fonts.</dd> - <dt>{{cssxref("@font-face/font-variation-settings", "font-variation-settings")}}</dt> - <dd>Allows low-level control over OpenType or TrueType font variations, by specifying the four letter axis names of the features to vary, along with their variation values.</dd> - <dt>{{cssxref("@font-face/src", "src")}}</dt> - <dd> - <p>Specifies the resource containing the font data. This can be a URL to a remote font file location or the name of a font on the user's computer.</p> - - <p>To provide the browser with a hint as to what format a font resource is — so it can select a suitable one — it is possible to include a format type inside a <code>format()</code> function:</p> - - <pre class="brush: css notranslate">src: url(ideal-sans-serif.woff) <strong>format("woff")</strong>, - url(basic-sans-serif.ttf) <strong>format("truetype")</strong>;</pre> - - <p>The available types are: <code>"woff"</code>, <code>"woff2"</code>, <code>"truetype"</code>, <code>"opentype"</code>, <code>"embedded-opentype"</code>, and <code>"svg"</code>.</p> - </dd> - <dt>{{cssxref("@font-face/unicode-range", "unicode-range")}}</dt> - <dd>The range of Unicode code points to be used from the font.</dd> -</dl> - -<h2 id="Description">Description</h2> - -<p>If the <code>local()</code> function is provided, specifying a font name to look for on the user's computer, and the {{Glossary("user agent")}} finds a match, that local font is used. Otherwise, the font resource specified using the <code>url()</code> function is downloaded and used.</p> - -<p>By allowing authors to provide their own fonts, <code>@font-face</code> makes it possible to design content without being limited to the so-called "web-safe" fonts (that is, the fonts which are so common that they're considered to be universally available). The ability to specify the name of a locally-installed font to look for and use makes it possible to customize the font beyond the basics while making it possible to do so without relying on an Internet connection.</p> - -<p>It's common to use both <code>url()</code> and <code>local()</code> together, so that the user's installed copy of the font is used if available, falling back to downloading a copy of the font if it's not found on the user's device.</p> - -<p>The <code>@font-face</code> at-rule may be used not only at the top level of a CSS, but also inside any <a href="/en-US/docs/Web/CSS/At-rule#Conditional_group_rules">CSS conditional-group at-rule</a>.</p> - -<h3 id="Font_MIME_Types">Font MIME Types</h3> - -<table> - <thead> - <tr> - <th>Format</th> - <th>MIME type</th> - </tr> - </thead> - <tbody> - <tr> - <td>TrueType</td> - <td><code>font/ttf</code></td> - </tr> - <tr> - <td>OpenType</td> - <td><code>font/otf</code></td> - </tr> - <tr> - <td>Web Open Font Format</td> - <td><code>font/woff</code></td> - </tr> - <tr> - <td>Web Open Font Format 2</td> - <td><code>font/woff2</code></td> - </tr> - </tbody> -</table> - -<h3 id="Notes">Notes</h3> - -<ul> - <li>Web fonts are subject to the same domain restriction (font files must be on the same domain as the page using them), unless <a href="/en-US/docs/HTTP_access_control">HTTP access controls</a> are used to relax this restriction.</li> - <li><code>@font-face</code> cannot be declared within a CSS selector. For example, the following will not work: - <pre class="brush: css; example-bad notranslate">.className { - @font-face { - font-family: MyHelvetica; - src: local("Helvetica Neue Bold"), - local("HelveticaNeue-Bold"), - url(MgOpenModernaBold.ttf); - font-weight: bold; - } -}</pre> - </li> -</ul> - -<h2 id="Formal_syntax">Formal syntax</h2> - -{{csssyntax}} - -<h2 id="Examples">Examples</h2> - -<h3 id="Specifying_a_downloadable_font">Specifying a downloadable font</h3> - -<p>This example simply specifies a downloadable font to use, applying it to the entire body of the document:</p> - -<p><a href="https://mdn.mozillademos.org/files/7775/webfont-sample.html">View the live example</a></p> - -<pre class="brush: html notranslate"><html> -<head> - <title>Web Font Sample</title> - <style type="text/css" media="screen, print"> - @font-face { - font-family: "Bitstream Vera Serif Bold"; - src: url("https://mdn.mozillademos.org/files/2468/VeraSeBd.ttf"); - } - - body { font-family: "Bitstream Vera Serif Bold", serif } - </style> -</head> -<body> - This is Bitstream Vera Serif Bold. -</body> -</html> -</pre> - -<p>In this example, the user's local copy of "Helvetica Neue Bold" is used; if the user does not have that font installed (two different names are tried), then the downloadable font named "MgOpenModernaBold.ttf" is used instead:</p> - -<pre class="brush: css notranslate">@font-face { - font-family: MyHelvetica; - src: local("Helvetica Neue Bold"), - local("HelveticaNeue-Bold"), - url(MgOpenModernaBold.ttf); - font-weight: bold; -} -</pre> - -<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('WOFF2.0', '', 'WOFF2 font format')}}</td> - <td>{{Spec2('WOFF2.0')}}</td> - <td>Font format specification with new compression algorithm</td> - </tr> - <tr> - <td>{{SpecName('WOFF1.0', '', 'WOFF font format')}}</td> - <td>{{Spec2('WOFF1.0')}}</td> - <td>Font format specification</td> - </tr> - <tr> - <td>{{SpecName('CSS3 Fonts', '#font-face-rule', '@font-face')}}</td> - <td>{{Spec2('CSS3 Fonts')}}</td> - <td>Initial definition</td> - </tr> - </tbody> -</table> - -<h2 id="Browser_compatibility">Browser compatibility</h2> - - - -<p>{{Compat("css.at-rules.font-face")}}</p> - -<h2 id="See_also">See also</h2> - -<ul> - <li><a href="/en-US/docs/WOFF">About WOFF</a></li> - <li><a href="https://everythingfonts.com/font-face">Everythingfonts font-face generator</a></li> - <li><a class="external" href="http://www.fontsquirrel.com/fontface/generator">FontSquirrel @font-face generator</a></li> - <li><a class="external" href="http://hacks.mozilla.org/2009/06/beautiful-fonts-with-font-face/">Beautiful fonts with @font-face</a></li> - <li><a class="external" href="http://openfontlibrary.org/">Open Font Library</a></li> - <li><a class="external" href="http://caniuse.com/woff">When can I use WOFF?</a></li> - <li><a class="external" href="http://caniuse.com/svg-fonts">When can I use SVG Fonts?</a></li> - <li><a href="https://coolfont.org">Free Fancy Cool Fonts</a></li> - <li><a href="https://nicknames.name/">Best Nicknames</a></li> -</ul> diff --git a/files/my/web/css/css_transitions/index.html b/files/my/web/css/css_transitions/index.html deleted file mode 100644 index 6f134a503b..0000000000 --- a/files/my/web/css/css_transitions/index.html +++ /dev/null @@ -1,59 +0,0 @@ ---- -title: CSS Transitions -slug: Web/CSS/CSS_Transitions -tags: - - CSS - - CSS Transitions - - Overview - - Reference -translation_of: Web/CSS/CSS_Transitions ---- -<p>{{CSSRef}}</p> - -<p><strong>အသွင်ကူးပြောင်းမှု CSS ကိုကိုကို</strong> နျသနျသရငျညြတိကျတဲ့ဂုဏ်သတ္တိများ၏ CSS ကိုတန်ဖိုးများမွားထဲတွင်အကိုကိုကှားတဖြည်းဖြည်းအသွင်ကူးပြောင်းမှု ဖန်တီးပေးနိုင်ပါတယ်ဒါကတော့ CSS ကိုကိုတစ် module တစ်ခုတစ်ခုဖြစ်ပါတယ်။ အဲဒီအသွင်ကူးပြောင်းမှုများ၏အပြုအမူသူတို့ရဲ့ function ကိုကိုအချိန်ကိုက်, ကြာချိန်နှင့်အခြား attribute ကိုတွေသတ်မှတ်ခြင်းကထိန်းချုပ်ထားနိုင်ပါတယ်။</p> - -<h2 id="အညွှန်း">အညွှန်း</h2> - -<h3 id="ဂုဏ်သတ္တိများကို">ဂုဏ်သတ္တိများကို</h3> - -<div class="index"> -<ul> - <li>{{Cssxref("အကူးအပြောင်း")}}</li> - <li>{{Cssxref("အကူးအပြောင်း - နှောင့်နှေး")}}</li> - <li>{{Cssxref("အကူးအပြောင်း - ကြာချိန်")}}</li> - <li>{{Cssxref("အကူးအပြောင်း - အိမ်ခြံမြေ")}}</li> - <li>{{Cssxref("အကူးအပြောင်း - အချိန်ကိုက် -Function ကို")}}</li> -</ul> -</div> - -<h2 id="လမ်းညွှန်များ">လမ်းညွှန်များ</h2> - -<dl> - <dt><a href="/en-US/docs/Web/Guide/CSS/Using_CSS_transitions">CSS ကိုကိုအကူးအပြောင်းကိုအသုံးပြုခြင်း</a></dt> - <dd>Step-by-step CSS ကိုကိုသုံးပြီးအသွင်ကူးပြောင်းမှုကိုဖန်တီးရန်ဘယ်လိုသင်ခန်းစာ။ ဆောင်းပါးသည်တစြဤဦးချင်းစီကိုကို သက်ဆိုင်ရာ CSS ကိုပိုင်ဆိုင်မှုဖော်ပြထားသည်မွားကိုကိုနှငျ့သူတို့ကတစြ ဦးချင်းစီကတခြားတွေနဲ့အပြန်အလှန်ဘယ်လိုရှင်းပြ ။</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>{{SpecName('CSS3 Transitions')}}</td> - <td>{{Spec2('CSS3 Transitions')}}</td> - <td>ကနဦးချက်နှင့်အဓိပ္ပါယ်။</td> - </tr> - </tbody> -</table> - -<h2 id="ကိုလည်းကြည့်ပါ">ကိုလည်းကြည့်ပါ</h2> - -<ul> - <li>CSS ကိုကိုကူးအပြောင်းကာလမှ Related, <a href="/en-US/docs/Web/CSS/CSS_Animations">CSS ကို Animation ရဲ့ကိုကို</a> ကာတွန်းဂုဏ်သတ္တိများကျော်အသေးစိတ်ထိန်းချုပ်ပေးရန်။</li> -</ul> diff --git a/files/my/web/css/index.html b/files/my/web/css/index.html deleted file mode 100644 index eb5e30fc56..0000000000 --- a/files/my/web/css/index.html +++ /dev/null @@ -1,110 +0,0 @@ ---- -title: 'CSS: Cascading Style Sheets' -slug: Web/CSS -tags: - - CSS - - Cascading Style Sheets - - Design - - Landing - - Layout - - NeedsTranslation - - Reference - - Style Sheets - - Styles - - Stylesheets - - TopicStub - - 'l10n:priority' -translation_of: Web/CSS ---- -<div>{{CSSRef}}</div> - -<p class="summary"><span class="seoSummary"><strong>Cascading Style Sheets</strong> (<strong>CSS</strong>) is a <a href="/en-US/docs/DOM/stylesheet">stylesheet</a> language used to describe the presentation of a document written in <a href="/en-US/docs/Web/HTML" title="HyperText Markup Language">HTML</a></span> or <a href="/en-US/docs/XML_introduction">XML</a> (including XML dialects such as <a href="/en-US/docs/Web/SVG">SVG</a>, <a href="/en-US/docs/Web/MathML">MathML</a> or {{Glossary("XHTML", "", 1)}}). CSS describes how elements should be rendered on screen, on paper, in speech, or on other media.</p> - -<p>CSS is one of the core languages of the <strong>open Web</strong> and is standardized across Web browsers according to the <a class="external" href="http://w3.org/Style/CSS/#specs">W3C specification</a>. Developed in levels, CSS1 is now obsolete, CSS2.1 is a recommendation, and <a href="/en-US/docs/Web/CSS/CSS3" title="CSS3">CSS3</a>, now split into smaller modules, is progressing on the standardization track.</p> - -<section id="sect1"> -<ul class="card-grid"> - <li><span>CSS Introduction</span> - - <p>If you're new to web development, be sure to read our <a href="/en-US/docs/Learn/Getting_started_with_the_web/CSS_basics">CSS basics</a> article to learn what CSS is and how to use it.</p> - </li> - <li><span>CSS Tutorials</span> - <p>Our <a href="/en-US/docs/Learn/CSS">CSS learning area</a> contains a wealth of tutorials to take you from beginner level to proficiency, covering all the fundamentals.</p> - </li> - <li><span>CSS Reference</span> - <p>Our <a href="/en-US/docs/Web/CSS/Reference">exhaustive CSS reference</a> for seasoned Web developers describes every property and concept of CSS.</p> - </li> -</ul> - -<div class="row topicpage-table"> -<div class="section"> -<h2 class="Documentation" id="Tutorials">Tutorials</h2> - -<p>Our <a href="/en-US/docs/Learn/CSS">CSS Learning Area</a> features multiple modules that teach CSS from the ground up — no previous knowledge required.</p> - -<dl> - <dt><a href="/en-US/docs/Learn/CSS/Introduction_to_CSS">Introduction to CSS</a></dt> - <dd>This module starts with the basics of how CSS works, including selectors and properties, writing CSS rules, applying CSS to HTML, how to specify length, color, and other units in CSS, cascade and inheritance, box model basics, and debugging CSS.</dd> - <dt><a href="/en-US/docs/Learn/CSS/Styling_text">Styling text</a></dt> - <dd>This module discusses text styling fundamentals, including setting fonts, boldness, italics, line and letter spacing, text drop shadows, and other text properties. This module finishes with applying custom fonts to your page, and styling lists and links.</dd> - <dt><a href="/en-US/docs/Learn/CSS/Styling_boxes">Styling boxes</a></dt> - <dd>This module looks at styling boxes, one of the fundamental steps towards laying out a web page. In this module we recap the box model, then look at controlling box layouts by setting margins, borders, and padding, custom background colors, images and other features, and fancy features such as drop shadows and filters on boxes.</dd> - <dt><a href="/en-US/docs/Learn/CSS/CSS_layout">CSS layout</a></dt> - <dd>At this point we've already looked at CSS fundamentals, how to style text, and how to style and manipulate the boxes that your content sits inside. Now it's time to look at how to place your boxes in the right place in relation to the viewport, and one another. We have covered the necessary prerequisites so you can now dive deep into CSS layout, looking at different display settings, traditional layout methods involving float and positioning, and newfangled layout tools like flexbox.</dd> -</dl> -</div> - -<div class="section"> -<h2 class="Tools" id="Reference">Reference</h2> - -<ul> - <li><a href="/en-US/docs/Web/CSS/Reference">CSS reference</a>: This exhaustive reference for seasoned Web developers describes every property and concept of CSS.</li> - <li>CSS key concepts: - <ul> - <li>The <a href="/en-US/docs/Web/CSS/Syntax">syntax and forms of the language</a></li> - <li><a href="/en-US/docs/Web/CSS/Specificity">Specificity</a>, <a href="/en-US/docs/Web/CSS/Inheritance">inheritance</a> and <a href="/en-US/docs/Web/CSS/Cascade">the Cascade</a></li> - <li><a href="/en-US/docs/Web/CSS/CSS_Values_and_Units">CSS units and values</a></li> - <li><a href="/en-US/docs/Web/CSS/box_model">Box model</a> and <a href="/en-US/docs/Web/CSS/margin_collapsing">margin collapse</a></li> - <li>The <a href="/en-US/docs/Web/CSS/All_About_The_Containing_Block">containing block</a></li> - <li><a href="/en-US/docs/Web/CSS/CSS_Positioning/Understanding_z_index/The_stacking_context" title="The stacking context">Stacking</a> and <a href="/en-US/docs/Web/CSS/block_formatting_context" title="block formatting context">block-formatting</a> contexts</li> - <li><a href="/en-US/docs/Web/CSS/initial_value">Initial</a>, <a href="/en-US/docs/Web/CSS/computed_value">computed</a>, <a href="/en-US/docs/Web/CSS/used_value">used</a>, and <a href="/en-US/docs/Web/CSS/actual_value">actual</a> values</li> - <li><a href="/en-US/docs/Web/CSS/Shorthand_properties">CSS shorthand properties</a></li> - <li><a href="/en-US/docs/Web/CSS/CSS_Flexible_Box_Layout">CSS Flexible Box Layout</a></li> - <li><a href="/en-US/docs/Web/CSS/CSS_Grid_Layout">CSS Grid Layout</a></li> - <li><a href="/en-US/docs/Web/CSS/Media_Queries">Media queries</a></li> - <li><a href="/en-US/docs/Web/CSS/animation">Animation</a></li> - </ul> - </li> -</ul> - -<h2 class="Tools" id="Cookbook">Cookbook</h2> - -<p>The <a href="/en-US/docs/Web/CSS/Layout_cookbook">CSS layout cookbook</a> aims to bring together recipes for common layout patterns, things you might need to implement in your own sites. In addition to providing code you can use as a starting point in your projects, these recipes highlight the different ways layout specifications can be used, and the choices you can make as a developer.</p> - -<h2 class="Tools" id="Tools_for_CSS_development">Tools for CSS development</h2> - -<ul> - <li>You can use the <a class="external" href="https://jigsaw.w3.org/css-validator/">W3C CSS Validation Service</a> to check if your CSS is valid. This is an invaluable debugging tool.</li> - <li><a href="/en-US/docs/Tools">Firefox Developer Tools</a> lets you view and edit a page's live CSS via the <a href="/en-US/docs/Tools/Page_Inspector">Inspector</a> and <a href="/en-US/docs/Tools/Style_Editor">Style Editor</a> tools.</li> - <li>The <a class="link-https" href="https://addons.mozilla.org/en-US/firefox/addon/web-developer/">Web Developer extension</a> for Firefox lets you track and edit live CSS on watched sites.</li> - <li>The Web community has created various other <a href="/en-US/docs/Web/CSS/Tools">miscellaneous CSS tools</a> for you to use.</li> -</ul> - -<h2 id="Meta_bugs">Meta bugs</h2> - -<ul> - <li>Firefox: {{bug(1323667)}}</li> -</ul> -</div> -</div> -</section> - -<h2 id="See_also">See also</h2> - -<ul> - <li><a href="/en-US/docs/Web/Demos_of_open_web_technologies#CSS">CSS demos</a>: Get a creative boost by exploring examples of the latest CSS technologies in action.</li> - <li>Web languages to which CSS is often applied: <a href="/en-US/docs/Web/HTML">HTML</a>, <a href="/en-US/docs/Web/SVG">SVG</a>, <a href="/en-US/docs/Web/MathML">MathML</a>, {{Glossary("XHTML", "", 1)}}, and <a href="/en-US/docs/XML_introduction">XML</a>.</li> - <li>Mozilla technologies that make extensive use of CSS: <a href="/en-US/docs/Mozilla/Tech/XUL">XUL</a>, <a href="/en-US/docs/Mozilla/Firefox">Firefox</a>, and <a href="/en-US/docs/Mozilla/Thunderbird">Thunderbird</a> <a href="/en-US/docs/Mozilla/Add-ons">extensions</a> and <a href="/en-US/docs/Mozilla/Add-ons/Themes">themes</a>.</li> - <li><a href="https://lists.mozilla.org/listinfo/dev-tech-layout">Mozilla mailing list</a></li> - <li><a href="Stack Overflow|http://stackoverflow.com/questions/tagged/css">Stack Overflow questions about CSS</a></li> -</ul> diff --git a/files/my/web/guide/index.html b/files/my/web/guide/index.html deleted file mode 100644 index 56e0fa9e82..0000000000 --- a/files/my/web/guide/index.html +++ /dev/null @@ -1,67 +0,0 @@ ---- -title: Web developer guide -slug: Web/Guide -tags: - - Guide - - Landing - - NeedsTranslation - - TopicStub - - Web -translation_of: Web/Guide ---- -<p><strong>These articles provide how-to information to help you make use of specific technologies and APIs.</strong></p> - -<div> -<div> -<div class="row topicpage-table"> -<div class="section"> -<dl> - <dt class="landingPageList"><a href="https://developer.mozilla.org/en-US/docs/Web/Guide/CSS">CSS developer guide</a></dt> - <dd class="landingPageList">Cascading Style Sheets (CSS) is a stylesheet language used to describe the presentation of a document written in HTML</dd> - <dt class="landingPageList"><a href="https://developer.mozilla.org/en-US/docs/Web/Guide/Events">Event developer guide</a></dt> - <dd class="landingPageList">Events refers both to a design pattern used for the asynchronous handling of various incidents which occur in the lifetime of a web page and to the naming, characterization, and use of a large number of incidents of different types.</dd> - <dt class="landingPageList"><a href="https://developer.mozilla.org/en-US/docs/Web/Guide/Graphics">Graphics on the Web</a></dt> - <dd class="landingPageList">Modern Web sites and applications often need to present graphics.</dd> - <dt class="landingPageList"><a href="https://developer.mozilla.org/en-US/docs/Web/Guide/API">Guide to Web APIs</a></dt> - <dd class="landingPageList">List all Web APIs and what they are doing</dd> - <dt class="landingPageList"><a href="https://developer.mozilla.org/en-US/docs/Web/Guide/HTML">HTML developer guide</a></dt> - <dd class="landingPageList"><strong>HyperText Markup Language (HTML)</strong> is the core language of nearly all Web content. Most of what you see on screen in your browser is described, fundamentally, using HTML.</dd> - <dt><a href="https://developer.mozilla.org/en-US/docs/JavaScript" title="/en-US/docs/JavaScript">JavaScript</a></dt> - <dd>JavaScript is the powerful scripting language used to create applications for the Web.</dd> - <dt class="landingPageList"><a href="https://developer.mozilla.org/en-US/docs/Localizations_and_character_encodings">Localizations and character encodings</a></dt> - <dd class="landingPageList">Browsers process text as Unicode internally. However, a way of representing characters in terms of bytes (character encoding) is used for transferring text over the network to the browser. The <a class="external external-icon" 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 specification recommends</a> the use of the UTF-8 encoding (which can represent all of Unicode) and regardless of the encoding used requires Web content to declare what encoding was used.</dd> - <dt class="landingPageList"><a href="https://developer.mozilla.org/en-US/docs/Web/Guide/Mobile">Mobile Web Development</a></dt> - <dd class="landingPageList">This page provides an overview of some of the main techniques needed to design web sites that work well on mobile devices. If you're looking for information on Mozilla's Firefox OS project, see the <a href="https://developer.mozilla.org/en/Mozilla/Firefox_OS" title="Boot to Gecko">Firefox OS</a> page. Or you might be interested in details about <a href="https://developer.mozilla.org/en/Mozilla/Firefox_for_Android" title="Firefox for Android">Firefox for Android</a>.</dd> -</dl> - -<dl> -</dl> -</div> - -<div class="section"> -<dl> - <dt class="landingPageList"><a href="https://developer.mozilla.org/en-US/docs/Web/Guide/Performance">Optimization and performance</a></dt> - <dd class="landingPageList">When building modern Web apps and sites, it's important to make your content perform well. That is, to make it work quickly and efficiently. This lets it work effectively both for users of powerful desktop systems as well as for handheld devices with less power.</dd> - <dt class="landingPageList"><a href="https://developer.mozilla.org/en-US/docs/Web/Guide/Parsing_and_serializing_XML">Parsing and serializing XML</a></dt> - <dd class="landingPageList">The Web platform provides the following objects for parsing and serializing XML:</dd> - <dt class="landingPageList"><a href="https://developer.mozilla.org/en-US/docs/Web/Guide/SVG-in-OpenType">SVG-in-OpenType</a></dt> - <dd class="landingPageList">The SVG-in-OpenType work is currently in the hands of the <a class="external external-icon" href="http://mpeg.chiariglione.org/">MPEG group</a>. Once we're ready for wider adoption the information from <a class="external external-icon" href="https://wiki.mozilla.org/SVGOpenTypeFonts">wiki.mozilla.org</a> will be moved here, updated and expanded.</dd> - <dt class="landingPageList"><a href="https://developer.mozilla.org/en-US/docs/Web/Guide/WOFF">The Web Open Font Format (WOFF)</a></dt> - <dd class="landingPageList"><strong>WOFF</strong> (the <strong>Web Open Font Format</strong>) is a web font format developed by Mozilla in concert with Type Supply, LettError, and other organizations. It</dd> - <dt class="landingPageList"><a href="https://developer.mozilla.org/en-US/docs/Web/Guide/User_experience">User experience</a></dt> - <dd class="landingPageList">Making the user experience of your Web site or app a pleasant one for your users is important if you want users to come back and use it again and again. Here you'll find articles that may help you along.</dd> - <dt class="landingPageList"><a href="https://developer.mozilla.org/en-US/docs/Web/Guide/Using_FormData_Objects">Using FormData Objects</a></dt> - <dd class="landingPageList">The <a href="https://developer.mozilla.org/en/DOM/XMLHttpRequest/FormData" title="en/DOM/XMLHttpRequest/FormData"><code>FormData</code></a> object lets you compile a set of key/value pairs to send using <code>XMLHttpRequest</code>. Its primarily intended for use in sending form data, but can be used independently from forms in order to transmit keyed data. The transmitted data is in the same format that the form's <code>submit()</code> method would use to send the data if the form's encoding type were set to "multipart/form-data".</dd> - <dt class="landingPageList"><a href="/en-US/docs/Glossary">Glossary</a></dt> - <dd class="landingPageList">Defines numerous technical terms related to the Web and Internet.</dd> -</dl> -</div> -</div> -</div> -</div> - -<h2 id="See_also">See also</h2> - -<ul> - <li><a href="/en-US/docs/Web/Reference" title="/en-US/docs/Web/Reference">Web Developer Reference</a></li> -</ul> diff --git a/files/my/web/http/connection_management_in_http_1.x/index.html b/files/my/web/http/connection_management_in_http_1.x/index.html deleted file mode 100644 index 201f93a64c..0000000000 --- a/files/my/web/http/connection_management_in_http_1.x/index.html +++ /dev/null @@ -1,86 +0,0 @@ ---- -title: Connection management in HTTP/1.x -slug: Web/HTTP/Connection_management_in_HTTP_1.x -translation_of: Web/HTTP/Connection_management_in_HTTP_1.x ---- -<div>{{HTTPSidebar}}</div> - -<p class="summary">การจัดการการเชื่อมต่อเป็นหัวข้อสำคัญใน HTTP: การเปิดและรักษาการเชื่อมต่อส่วนใหญ่มีผลต่อประสิทธิภาพของเว็บไซต์และแอปพลิเคชันเว็บ ใน HTTP / 1.x มีหลายโมเดล: <em>การเชื่อมต่อสั้น ๆ</em> , <em>การเชื่อมต่อแบบถาวร</em>และ<em>HTTP pipelining</em></p> - -<p>HTTP ส่วนใหญ่อาศัย TCP สำหรับโปรโตคอลการขนส่งโดยให้การเชื่อมต่อระหว่างไคลเอนต์และเซิร์ฟเวอร์ ในวัยเด็ก HTTP ใช้แบบจำลองเดียวเพื่อจัดการการเชื่อมต่อดังกล่าว การเชื่อมต่อเหล่านี้มีอายุการใช้งานสั้น: การเชื่อมต่อใหม่ที่สร้างขึ้นทุกครั้งที่จำเป็นต้องส่งคำขอและจะปิดเมื่อได้รับคำตอบ</p> - -<p>โมเดลที่เรียบง่ายนี้มีข้อ จำกัด ด้านประสิทธิภาพโดยธรรมชาติ: การเปิดการเชื่อมต่อ TCP แต่ละครั้งเป็นการดำเนินการที่ใช้ทรัพยากรมาก ต้องแลกเปลี่ยนข้อความหลายข้อความระหว่างไคลเอนต์และเซิร์ฟเวอร์ เวลาในการตอบสนองของเครือข่ายและแบนด์วิดท์มีผลต่อประสิทธิภาพเมื่อคำขอต้องการส่ง หน้าเว็บสมัยใหม่ต้องการคำขอจำนวนมาก (ตั้งแต่หนึ่งโหลขึ้นไป) เพื่อให้บริการข้อมูลตามจำนวนที่ต้องการซึ่งพิสูจน์ได้ว่ารุ่นก่อนหน้านี้ไม่มีประสิทธิภาพ</p> - -<p>รุ่นใหม่กว่าสองรุ่นถูกสร้างขึ้นใน HTTP / 1.1 โมเดลการเชื่อมต่อแบบต่อเนื่องช่วยให้การเชื่อมต่อเปิดระหว่างคำขอที่ต่อเนื่องลดเวลาที่ต้องใช้ในการเปิดการเชื่อมต่อใหม่ รูปแบบการไปป์ไลน์ HTTP ก้าวไปอีกขั้นด้วยการส่งคำขอต่อเนื่องหลายรายการโดยไม่ต้องรอคำตอบช่วยลดเวลาแฝงในเครือข่ายได้มาก</p> - -<p><img alt="Compares the performance of the three HTTP/1.x connection models: short-lived connections, persistent connections, and HTTP pipelining." src="https://mdn.mozillademos.org/files/13727/HTTP1_x_Connections.png" style="height: 538px; width: 813px;"></p> - -<div class="note"> -<p>HTTP / 2 เพิ่มโมเดลเพิ่มเติมสำหรับการจัดการการเชื่อมต่อ</p> -</div> - -<p>It's important point to note that connection management in HTTP applies to the connection between two consecutive nodes, which is <a href="/en-US/docs/Web/HTTP/Headers#hbh">hop-by-hop</a> and not <a href="/en-US/docs/Web/HTTP/Headers#e2e">end-to-end</a>. The model used in connections between a client and its first proxy may differ from the model between a proxy and the destination server (or any intermediate proxies). The HTTP headers involved in defining the connection model, like {{HTTPHeader("Connection")}} and {{HTTPHeader("Keep-Alive")}}, are <a href="/en-US/docs/Web/HTTP/Headers#hbh">hop-by-hop</a> headers with their values able to be changed by intermediary nodes.</p> - -<p>A related topic is the concept of HTTP connection upgrades, wherein an HTTP/1.1 connection is upgraded to a different protocol, such as TLS/1.0, WebSocket, or even HTTP/2 in cleartext. This <a href="/en-US/docs/Web/HTTP/Protocol_upgrade_mechanism">protocol upgrade mechanism</a> is documented in more detail elsewhere.</p> - -<h2 id="Short-lived_connections">Short-lived connections</h2> - -<p>The original model of HTTP, and the default one in HTTP/1.0, is <em>short-lived connections</em>. Each HTTP request is completed on its own connection; this means a TCP handshake happens before each HTTP request, and these are serialized.</p> - -<p>The TCP handshake itself is time-consuming, but a TCP connection adapts to its load, becoming more efficient with more sustained (or warm) connections. Short-lived connections do not make use of this efficiency feature of TCP, and performance degrades from optimum by persisting to transmit over a new, cold connection.</p> - -<p>This model is the default model used in HTTP/1.0 (if there is no {{HTTPHeader("Connection")}} header, or if its value is set to <code>close</code>). In HTTP/1.1, this model is only used when the {{HTTPHeader("Connection")}} header is sent with a value of <code>close</code>.</p> - -<div class="note"> -<p>Unless dealing with a very old system, which doesn't support a persistent connection, there is no compelling reason to use this model.</p> -</div> - -<h2 id="Persistent_connections">Persistent connections</h2> - -<p>Short-lived connections have two major hitches: the time taken to establish a new connection is significant, and performance of the underlying TCP connection gets better only when this connection has been in use for some time (warm connection). To ease these problems, the concept of a <em>persistent connection</em> has been designed, even prior to HTTP/1.1. Alternatively this may be called a <em>keep-alive connection</em>.</p> - -<p>A persistent connection is one which remains open for a period of time, and can be reused for several requests, saving the need for a new TCP handshake, and utilizing TCP's performance enhancing capabilities. This connection will not stay open forever: idle connections are closed after some time (a server may use the {{HTTPHeader("Keep-Alive")}} header to specify a minimum time the connection should be kept open).</p> - -<p>Persistent connections also have drawbacks; even when idling they consume server resources, and under heavy load, {{glossary("DoS attack", "DoS attacks")}} can be conducted. In such cases, using non-persistent connections, which are closed as soon as they are idle, can provide better performance.</p> - -<p>HTTP/1.0 connections are not persistent by default. Setting {{HTTPHeader("Connection")}} to anything other than <code>close</code>, usually <code>retry-after</code>, will make them persistent.</p> - -<p>In HTTP/1.1, persistence is the default, and the header is no longer needed (but it is often added as a defensive measure against cases requiring a fallback to HTTP/1.0).</p> - -<h2 id="HTTP_pipelining">HTTP pipelining</h2> - -<div class="note"> -<p>HTTP pipelining is not activated by default in modern browsers:</p> - -<ul> - <li>Buggy <a href="https://en.wikipedia.org/wiki/Proxy_server">proxies</a> are still common and these lead to strange and erratic behaviors that Web developers cannot foresee and diagnose easily.</li> - <li>Pipelining is complex to implement correctly: the size of the resource being transferred, the effective <a href="https://en.wikipedia.org/wiki/Round-trip_delay_time">RTT</a> that will be used, as well as the effective bandwidth, have a direct incidence on the improvement provided by the pipeline. Without knowing these, important messages may be delayed behind unimportant ones. The notion of important even evolves during page layout! HTTP pipelining therefore brings a marginal improvement in most cases only.</li> - <li>Pipelining is subject to the <a href="https://en.wikipedia.org/wiki/Head-of-line_blocking">HOL</a> problem.</li> -</ul> - -<p>For these reasons, pipelining has been superseded by a better algorithm, <em>multiplexing</em>, that is used by HTTP/2.</p> -</div> - -<p>By default, <a href="/en-US/docs/Web/HTTP" title="en/HTTP">HTTP</a> requests are issued sequentially. The next request is only issued once the response to the current request has been received. As they are affected by network latencies and bandwidth limitations, this can result in significant delay before the next request is <em>seen</em> by the server.</p> - -<p>Pipelining is the process to send successive requests, over the same persistent connection, without waiting for the answer. This avoids latency of the connection. Theoretically, performance could also be improved if two HTTP requests were to be packed into the same TCP message. The typical <a href="https://en.wikipedia.org/wiki/Maximum_segment_size">MSS</a> (Maximum Segment Size), is big enough to contain several simple requests, although the demand in size of HTTP requests continues to grow.</p> - -<p>Not all types of HTTP requests can be pipelined: only {{glossary("idempotent")}} methods, that is {{HTTPMethod("GET")}}, {{HTTPMethod("HEAD")}}, {{HTTPMethod("PUT")}} and {{HTTPMethod("DELETE")}}, can be replayed safely: should a failure happen, the pipeline content can simply be repeated.</p> - -<p>Today, every HTTP/1.1-compliant proxy and server should support pipelining, though many have limitations in practice: a significant reason no modern browser activates this feature by default.</p> - -<h2 id="Domain_sharding">Domain sharding</h2> - -<div class="note"> -<p>Unless you have a very specific immediate need, don't use this deprecated technique; switch to HTTP/2 instead. In HTTP/2, domain sharding is no longer useful: the HTTP/2 connection is able to handle parallel unprioritized requests very well. Domain sharding is even detrimental to performance. Most HTTP/2 implementations use a technique called <a href="https://daniel.haxx.se/blog/2016/08/18/http2-connection-coalescing/">connection coalescing</a> to revert eventual domain sharding.</p> -</div> - -<p>As an HTTP/1.x connection is serializing requests, even without any ordering, it can't be optimal without large enough available bandwidth. As a solution, browsers open several connections to each domain, sending parallel requests. Default was once 2 to 3 connections, but this has now increased to a more common use of 6 parallel connections. There is a risk of triggering <a href="/en-US/docs/Glossary/DOS_attack">DoS</a> protection on the server side if attempting more than this number.</p> - -<p>หากเซิร์ฟเวอร์ต้องการให้เว็บไซต์หรือแอปพลิเคชันตอบสนองเร็วขึ้นเซิร์ฟเวอร์อาจบังคับให้เปิดการเชื่อมต่อเพิ่มเติม ตัวอย่างเช่นแทนที่จะมีทรัพยากรทั้งหมดในโดเมนเดียวกันพูดก็อาจแบ่งมากกว่าหลายโดเมน,<code>www.example.com</code> , , แต่ละโดเมนเหล่านี้แก้ไขไปยังเซิร์ฟเวอร์<em>เดียวกัน</em>และเว็บเบราว์เซอร์จะเปิดการเชื่อมต่อ 6 รายการให้กับแต่ละโดเมน(ในตัวอย่างของเราเพิ่มการเชื่อมต่อเป็น 18) เทคนิคนี้เรียกว่าsharding<em> โดเมน</em><code>www1.example.com</code><code>www2.example.com</code><code>www3.example.com</code></p> - -<p><img alt="" src="https://mdn.mozillademos.org/files/13783/HTTPSharding.png" style="height: 727px; width: 463px;"></p> - -<h2 id="สรุป">สรุป</h2> - -<p>การจัดการการเชื่อมต่อที่ได้รับการปรับปรุงช่วยเพิ่มประสิทธิภาพใน HTTP ได้มาก ด้วย HTTP / 1.1 หรือ HTTP / 1.0 การใช้การเชื่อมต่อแบบต่อเนื่องอย่างน้อยก็จนกว่าจะไม่มีการใช้งานจะนำไปสู่ประสิทธิภาพที่ดีที่สุด อย่างไรก็ตามความล้มเหลวของการวางท่อนำไปสู่การออกแบบรูปแบบการจัดการการเชื่อมต่อที่เหนือกว่าซึ่งรวมอยู่ใน HTTP / 2</p> diff --git a/files/my/web/http/index.html b/files/my/web/http/index.html deleted file mode 100644 index 6e893c3ced..0000000000 --- a/files/my/web/http/index.html +++ /dev/null @@ -1,90 +0,0 @@ ---- -title: HTTP -slug: Web/HTTP -tags: - - HTTP - - Hypertext - - NeedsTranslation - - Reference - - TCP/IP - - TopicStub - - Web - - Web Development - - 'l10n:priority' -translation_of: Web/HTTP ---- -<div>{{HTTPSidebar}}</div> - -<p class="summary"><strong><dfn>Hypertext Transfer Protocol (HTTP)</dfn></strong> is an <a href="https://en.wikipedia.org/wiki/Application_Layer">application-layer</a> protocol for transmitting hypermedia documents, such as HTML. It was designed for communication between web browsers and web servers, but it can also be used for other purposes. HTTP follows a classical <a href="https://en.wikipedia.org/wiki/Client%E2%80%93server_model">client-server model</a>, with a client opening a connection to make a request, then waiting until it receives a response. HTTP is a <a href="https://en.wikipedia.org/wiki/Stateless_protocol">stateless protocol</a>, meaning that the server does not keep any data (state) between two requests. Though often based on a TCP/IP layer, it can be used on any reliable <a href="https://en.wikipedia.org/wiki/Transport_Layer">transport layer</a>, that is, a protocol that doesn't lose messages silently like UDP does. <a href="https://en.wikipedia.org/wiki/Reliable_User_Datagram_Protocol">RUDP</a> — the reliable update of UDP — is a suitable alternative.</p> - -<div class="column-container"> -<div class="column-half"> -<h2 id="Tutorials">Tutorials</h2> - -<p>Learn how to use HTTP with guides and tutorials.</p> - -<dl> - <dt><a href="/en-US/docs/Web/HTTP/Overview">Overview of HTTP</a></dt> - <dd>The basic features of the client-server protocol: what it can do and its intended uses.</dd> - <dt><a href="/en-US/docs/Web/HTTP/Caching">HTTP Cache</a></dt> - <dd>Caching is very important for fast Web sites. This article describes different methods of caching and how to use HTTP Headers to control them.</dd> - <dt><a href="/en-US/docs/Web/HTTP/Cookies">HTTP Cookies</a></dt> - <dd>How cookies work is defined by <a href="https://tools.ietf.org/html/rfc6265">RFC 6265</a>. When serving an HTTP request, a server can send a <code>Set-Cookie</code> HTTP header with the response. The client then returns the cookie's value with every request to the same server in the form of a <code>Cookie</code> request header. The cookie can also be set to expire on a certain date, or restricted to a specific domain and path.</dd> - <dt><a href="/en-US/docs/Web/HTTP/CORS">Cross-Origin Resource Sharing (CORS)</a></dt> - <dd><strong>Cross-site HTTP requests</strong> are HTTP requests for resources from a <strong>different domain</strong> than the domain of the resource making the request. For instance, an HTML page from Domain A (<code>http://domaina.example/</code>) makes a request for an image on Domain B (<code>http://domainb.foo/image.jpg</code>) via the <code>img</code> element. Web pages today very commonly load cross-site resources, including CSS stylesheets, images, scripts, and other resources. CORS allows web developers to control how their site reacts to cross-site requests.</dd> -</dl> - -<dl> - <dt><a href="/en-US/docs/Web/HTTP/Basics_of_HTTP/Evolution_of_HTTP">Evolution of HTTP</a></dt> - <dd>A brief description of the changes between the early versions of HTTP, to the modern HTTP/2, the emergent HTTP/3 and beyond.</dd> - <dt><a href="https://wiki.mozilla.org/Security/Guidelines/Web_Security">Mozilla web security guidelines</a></dt> - <dd>A collection of tips to help operational teams with creating secure web applications.</dd> -</dl> - -<dl> - <dt><a href="/en-US/docs/Web/HTTP/Messages">HTTP Messages</a></dt> - <dd>Describes the type and structure of the different kind of messages of HTTP/1.x and HTTP/2.</dd> - <dt><a href="/en-US/docs/Web/HTTP/Session">A typical HTTP session</a></dt> - <dd>Shows and explains the flow of a usual HTTP session.</dd> - <dt><a href="/en-US/docs/Web/HTTP/Connection_management_in_HTTP_1.x">Connection management in HTTP/1.x</a></dt> - <dd>Describes the three connection management models available in HTTP/1.x, their strengths, and their weaknesses.</dd> -</dl> -</div> - -<div class="column-half"> -<h2 id="Reference">Reference</h2> - -<p>Browse through detailed HTTP reference documentation.</p> - -<dl> - <dt><a href="/en-US/docs/Web/HTTP/Headers">HTTP Headers</a></dt> - <dd>HTTP message headers are used to describe a resource, or the behavior of the server or the client. Custom proprietary headers can be added using the <code>X-</code> prefix; others in an <a href="https://www.iana.org/assignments/message-headers/message-headers.xhtml#perm-headers">IANA registry</a>, whose original content was defined in <a href="https://tools.ietf.org/html/rfc4229">RFC 4229</a>. IANA also maintains a <a href="https://www.iana.org/assignments/message-headers/message-headers.xhtml#prov-headers">registry of proposed new HTTP message headers</a>.</dd> - <dt><a href="/en-US/docs/Web/HTTP/Methods">HTTP Request Methods</a></dt> - <dd>The different operations that can be done with HTTP: {{HTTPMethod("GET")}}, {{HTTPMethod("POST")}}, and also less common requests like {{HTTPMethod("OPTIONS")}}, {{HTTPMethod("DELETE")}}, or {{HTTPMethod("TRACE")}}.</dd> - <dt><a href="/en-US/docs/Web/HTTP/Response_codes">HTTP Status Response Codes</a></dt> - <dd>HTTP response codes indicate whether a specific HTTP request has been successfully completed. Responses are grouped in five classes: informational responses, successful responses, redirections, client errors, and servers errors.</dd> -</dl> - -<dl> - <dt><a href="/en-US/docs/Web/HTTP/Headers/Content-Security-Policy">CSP directives</a></dt> - <dd>The {{HTTPHeader("Content-Security-Policy")}} response header fields allows web site administrators to control resources the user agent is allowed to load for a given page. With a few exceptions, policies mostly involve specifying server origins and script endpoints.</dd> -</dl> - -<h2 id="Tools_resources">Tools & resources</h2> - -<p>Helpful tools and resources for understanding and debugging HTTP.</p> - -<dl> - <dt><a href="/en-US/docs/Tools">Firefox Developer Tools</a></dt> - <dd><a href="/en-US/docs/Tools/Network_Monitor">Network monitor</a></dd> - <dt><a href="https://observatory.mozilla.org/">Mozilla Observatory</a></dt> - <dd> - <p>A project designed to help developers, system administrators, and security professionals configure their sites safely and securely.</p> - </dd> - <dt><a class="external" href="https://redbot.org/">RedBot</a></dt> - <dd>Tools to check your cache-related headers</dd> - <dt><a href="https://www.html5rocks.com/en/tutorials/internals/howbrowserswork/">How Browsers Work</a></dt> - <dd>A very comprehensive article on browser internals and request flow through HTTP protocol. A MUST-READ for any web developer.</dd> -</dl> -</div> -</div> diff --git a/files/my/web/index.html b/files/my/web/index.html deleted file mode 100644 index 3b55338e60..0000000000 --- a/files/my/web/index.html +++ /dev/null @@ -1,90 +0,0 @@ ---- -title: Web developers နင့္ နည္းပညာ မျာ -slug: Web -tags: - - Landing - - NeedsTranslation - - TopicStub - - Web -translation_of: Web ---- -<p>The open Web presents incredible opportunities for developers. To take full advantage of these technologies, you need to know how to use them. Below you'll find the links to MDN's documentation on Web technologies.</p> - -<p> </p> - -<p>လွတ်လပ်စ</p> - -<p> </p> - -<p> </p> - -<div class="row topicpage-table"> -<div class="section"> -<h2 class="Documentation" id="Web_နည်းပညာများ">Web နည်းပညာများ</h2> - -<h3 id="အခြေခံ">အခြေခံ</h3> - -<dl> - <dt><a href="/en-US/docs/Web/HTML">HTML</a></dt> - <dd>၀ဘ်စာမျက်နာတစ်ခုတွင် ပါ၀င်သောအကြောင်းအရာများအား စနစ်ကျတဲ့ ဖွဲ့စည်းပုံ ကို သက်မတ်ရန် အသုံးပြုသောနည်းပညာ တစ်ခုဖြစ်ပါသည။</dd> - <dt><a href="/en-US/docs/Web/CSS">CSS</a></dt> - <dd> ၀ဘ်စာမျက်နာပါအကြောင်းအရာများရဲ့ အသွင်အပြင်ကို ဖော်ပြဖို့အတွက်သုံးသည်။</dd> -</dl> - -<h3 id="Scripting">Scripting</h3> - -<dl> - <dt><a href="/en-US/docs/Web/JavaScript">JavaScript</a></dt> - <dd>JavaScript is the programming language that runs in the browser, which is used to build advanced user interactive Web sites and applications.</dd> - <dt><a href="/en-US/docs/Web/Reference/API">Web APIs</a></dt> - <dd>Reference material for each of the individual APIs that comprise the Web's powerful scriptability, including the <a href="/en-US/docs/DOM">DOM</a> and all of the related APIs and interfaces you can use to build Web content and apps. - <ul> - <li><a href="/en-US/docs/Web/API" title="/en-US/docs/Web/API">Web API interface reference</a> - all interfaces, arranged alphabetically.</li> - <li><a href="/en-US/docs/WebAPI">WebAPI</a> page lists device access APIs and other APIs useful for applications.</li> - </ul> - </dd> -</dl> - -<h3 id="Graphics">Graphics</h3> - -<dl> - <dt><a href="/en-US/docs/SVG">SVG</a></dt> - <dd>Scalable Vector Graphics let you describe images as sets of vectors (lines) and shapes in order to allow them to scale smoothly regardless of the size at which they're drawn.</dd> - <dt><a href="/en-US/docs/Web/WebGL" title="/en-US/docs/Web/WebGL">WebGL</a></dt> - <dd>WebGL brings 3D graphics to the Web by introducing an API that closely conforms to OpenGL ES 2.0, and which can be used in HTML {{HTMLElement("canvas")}} elements.</dd> -</dl> - -<h3 id="Other">Other</h3> - -<dl> - <dt><a href="/en-US/docs/Web/MathML">MathML</a></dt> - <dd>The Mathematical Markup Language makes it possible to display complex mathematical equations and syntax.</dd> -</dl> -</div> - -<div class="section"> -<h2 class="Documentation" id="Documentation_by_type">Documentation by type</h2> - -<dl> - <dt><a href="/en-US/docs/Web/Guide">Web Developer Guide</a></dt> - <dd>The Web Developer Guide provides useful how-to content to help you actually use Web technologies to do what you want or need to do.</dd> - <dt><a href="/en-US/docs/Web/Tutorials">Tutorials for Web developers</a></dt> - <dd>A list of tutorials to take you step-by-step through learning APIs, technologies, or broad topic areas.</dd> - <dt><a href="/en-US/docs/Web/Reference">References</a></dt> - <dd><em>This page will offer links to all reference information on MDN, but for now use one of the technology links in the left section.</em></dd> -</dl> - -<h2 id="Other_topics">Other topics</h2> - -<dl> - <dt><a href="/en-US/docs/Web/Apps">Developing Web applications</a></dt> - <dd>Documentation for Web application developers; Web apps are true write-once, deploy anywhere apps for mobile, desktop, and Firefox OS.</dd> - <dt><a href="/en-US/docs/Web/Accessibility">Accessibility</a></dt> - <dd>Accessibility in Web development means enabling as many people as possible to use Web sites, even when those people's abilities are limited in some way. Here we provide information on developing Web content to be accessible.</dd> - <dt><a href="/en-US/docs/Web/Security">Security</a></dt> - <dd>Ensuring that your Web site or open Web app is secure is critical.</dd> -</dl> -</div> -</div> - -<p><span class="alllinks"><a href="/en-US/docs/tag/Web">View All...</a></span></p> diff --git a/files/my/web/javascript/index.html b/files/my/web/javascript/index.html deleted file mode 100644 index d26ea34fb6..0000000000 --- a/files/my/web/javascript/index.html +++ /dev/null @@ -1,104 +0,0 @@ ---- -title: JavaScript -slug: Web/JavaScript -tags: - - JavaScript - - Landing - - NeedsTranslation - - TopicStub -translation_of: Web/JavaScript ---- -<div>{{JsSidebar}}</div> - -<p class="summary"><strong>JavaScript</strong><sup>®</sup> (အတိုကောက် <strong>JS</strong>) ဆိုတာ <a href="https://en.wikipedia.org/wiki/First-class_functions" title="https://en.wikipedia.org/wiki/First-class_functions">first-class functions </a> နှင့်တည်ဆောက်ထား တဲ့a lightweight, interpreted, object-oriented language တစ်ခုဖြစ်ပါတယ်။အများက သိတာကတော့ web pages တွေအတွက် browser ကိုအခြေ ခံထားတဲ့ scripting language တစ်ခုအနေနဲ့သိကြတယ် ဒါပေမဲ့ browser ကိုအခြေခံ မထားတဲ့ <a class="external" href="https://en.wikipedia.org/wiki/JavaScript#Uses_outside_web_pages">နေရာ</a> တွေဖြစ်တဲ့ <a class="external" href="https://nodejs.org/">node.js</a> ဒါမှမဟုတ် <a href="https://couchdb.apache.org/">Apache CouchDB</a> တွေမှာလဲအသုံးပြု ပါတယ်. Javascript ဟာ <a class="mw-redirect" href="https://en.wikipedia.org/wiki/Prototype-based_programming" title="Prototype-based">prototype-based</a>, multi-paradigm scripting language ဖြစ်ပါတယ်၊ ဆိုလိုတာက dynamic ဖြစ်သလို object-oriented, imperative, and functional programming ရေးသားနည်းပုံစံနဲ့လည်း ထောက်ပံပေးပါတယ်။ အသေးစိတ်ကိုတော့ <a href="/en-US/docs/Web/JavaScript/About_JavaScript">JavaScript</a> အကြောင်း ပိုမို ဖတ်ရှုကြည့်ပါ။</p> - -<p>JavaScript စံသတ်မှတ်ချက်ကို <a href="/en-US/docs/JavaScript/Language_Resources">ECMAScript</a> လို့ခေါ်ပါတယ်။ ၂၀၁၂ မှာ modern browsers တွေအကုန်လုံးက ECMAScript 5.1 ကို အပြည့်အဝ support ပေးနေပါပြီ။ Browsers အဟောင်းတွေက အနည်းဆုံး ECMAScript 3 ကို support ပေးပါတယ်။ ဇွန်လ ၁၇ ရက် ၂၀၁၅ မှာ ခြောက်ကြိမ်မြောက် ECMAScript ကို ကြေငြာပြဌာန်းလိုက်ပါတယ်။ အဲ့ဒီ့ version ကို ECMAScript 2015 လို့တရားဝင်ခေါ်ပါတယ်၊ ဒါပေမယ့်လည်း ECMAScript 6 ဒါမှမဟုတ် ES6 ဆိုပြီးလည်းခေါ်ပါတယ်။</p> - -<p> ဒီဝက်စာမျက်နှာမှာတော့ JavaScript အကြောင်းကိုပဲ ပြောပြသွားမှာဖြစ်ပါတယ်။Web Pages နဲ့ ဆက်စပ်ပြီးသုံးတဲ့ ဒါမှမဟုတ် တစ်ခြားသော Host Environment နဲ့ စပ်ဆက်ပြီးသုံးတဲ့ အကြောင်းကို ပြောမှ မဟုတ်ပါဘူး။. Web pages နဲ့ စပ်ဆက်ပြီး အသုံးပြုတဲ့ {{Glossary("API","APIs")}} ကို လေ့လာချင်တဲ့ဆိုရင်တော့ <a href="/en-US/docs/Web/API">Web APIs</a> နဲ့ <a href="/en-US/docs/Glossary/DOM">DOM</a> မှာ သွားရောက် လေ့လာလို့ရပါတယ်။</p> - -<p>JavaScript ကို <a href="https://en.wikipedia.org/wiki/Java_(programming_language)">Java programming language</a> နဲ့ မတူဘူးဆိုတာ သိထားဖို့လိုပါမယ်။ Java ဆိုတာ U.S. နဲ့ အခြားသောနိုင်ငံတွေမှာ Oracle က မူပိုင်တင်ထားပါတယ်။</p> - -<div class="column-container"> -<div class="column-half"> -<h2 id="နည်းပြသင်ခန်းစာများ">နည်းပြသင်ခန်းစာများ</h2> - -<p>ကျွန်တော်တို့ရဲ့ နည်းပြသင်ခန်းစာများနဲ့ လေ့ကျင့်ခန်းများမှတစ်ဆင့် JavaScript နဲ့ဘယ်လို program လုပ်မလဲဆိုတာလေ့လာပါ။</p> - -<h3 id="နိဒါန်း">နိဒါန်း</h3> - -<dl> - <dt><a href="/my/docs/Web/JavaScript/Guide">JavaScript လမ်းညွှန်</a></dt> - <dd>သင်က JavaScript ကိုအခုမှစတင်လေ့လာမယ့်သူဆိုရင် ဒီလမ်းညွှန်ကသင့်ကိုအထောက်အကူပြုပါလိမ့်မယ်။ </dd> - <dt></dt> - <dt><a href="/en-US/docs/Web/JavaScript/JavaScript_technologies_overview">JavaScript နည်းပညာချုံငုံသုံးသပ်ချက်</a></dt> - <dd>Web browser နဲ့ JavaScript landscape မိတ်ဆက်။</dd> - <dt><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Introduction_to_Object-Oriented_JavaScript">Object Oriented JavaScript မိတ်ဆက်</a></dt> - <dd>Introduction to the concepts of object oriented programming in JavaScript.</dd> -</dl> - -<h3 id="Intermediate">Intermediate</h3> - -<dl> - <dt><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/A_re-introduction_to_JavaScript">A re-introduction to JavaScript</a></dt> - <dd>An overview for those who <em>think</em> they know about JavaScript.</dd> -</dl> - -<dl> - <dt><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures">JavaScript data structures</a></dt> - <dd>Overview of available data structures in JavaScript.</dd> - <dt><a href="/en-US/docs/Web/JavaScript/Equality_comparisons_and_sameness">Equality comparisons and sameness</a></dt> - <dd>JavaScript provides three different value-comparison operations: strict equality using <code>===</code>, loose equality using <code>==</code>, and the {{jsxref("Global_Objects/Object/is", "Object.is()")}} method.</dd> -</dl> - -<h3 id="Advanced">Advanced</h3> - -<dl> - <dt><a href="/en-US/docs/Web/JavaScript/Inheritance_and_the_prototype_chain">Inheritance and the prototype chain</a></dt> - <dd>Explanation of the widely misunderstood and under-estimated prototype-based inheritance.</dd> - <dt><a href="/en-US/docs/Web/JavaScript/Reference/Strict_mode">Strict mode</a></dt> - <dd>A restricted variant of JavaScript.</dd> - <dt><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Typed_arrays">JavaScript typed arrays</a></dt> - <dd>JavaScript typed arrays provide a mechanism for accessing raw binary data.</dd> - <dt><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Memory_Management">Memory Management</a></dt> - <dd>Memory life cycle and garbage collection in JavaScript.</dd> -</dl> -</div> - -<div class="column-half"> -<h2 id="အညွှန်း">အညွှန်း</h2> - -<p>Browse the complete <a href="/en-US/docs/Web/JavaScript/Reference">JavaScript reference</a> documentation. </p> - -<dl> - <dt><a href="/en-US/docs/Web/JavaScript/Reference/Global_Objects">Standard objects</a></dt> - <dd>Get to know standard built-in objects <code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array" title="The JavaScript Array global object is a constructor for arrays, which are high-level, list-like objects."><code>Array</code></a></code>, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Boolean" title="The Boolean object is an object wrapper for a boolean value."><code>Boolean</code></a>, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date" title="Creates a JavaScript Date instance that represents a single moment in time. Date objects are based on a time value that is the number of milliseconds since 1 January, 1970 UTC."><code>Date</code></a>, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error" title="The Error constructor creates an error object. Instances of Error objects are thrown when runtime errors occur. The Error object can also be used as a base objects for user-defined exceptions. See below for standard built-in error types."><code>Error</code></a>, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function" title="The Function constructor creates a new Function object. In JavaScript every function is actually a Function object."><code>Function</code></a>, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON" title="The JSON object contains methods for parsing JavaScript Object Notation (JSON) and converting values to JSON. It can't be called or constructed, and aside from its two method properties it has no interesting functionality of its own."><code>JSON</code></a>, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Math" title="Math is a built-in object that has properties and methods for mathematical constants and functions. Not a function object."><code>Math</code></a>, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number" title="The Number JavaScript object is a wrapper object allowing you to work with numerical values. A Number object is created using the Number() constructor."><code>Number</code></a>, <a href="/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object"><code>Object</code></a>, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/RegExp" title="The RegExp constructor creates a regular expression object for matching text with a pattern."><code>RegExp</code></a>, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String" title="The String global object is a constructor for strings, or a sequence of characters."><code>String</code></a>, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Map" title="The Map object is a simple key/value map. Any value (both objects and primitive values) may be used as either a key or a value."><code>Map</code></a>, <code><a href="/en-US/docs/Web/JavaScript/Reference/Global_Objects/Set">Set</a></code>, <code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/WeakMap" title="The WeakMap object is a collection of key/value pairs in which the keys are objects and the values can be arbitrary values."><code>WeakMap</code></a></code>, <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/WeakSet" title="The WeakSet object lets you store weakly held objects in a collection."><code>WeakSet</code></a>, and others.</dd> - <dt><a href="/en-US/docs/Web/JavaScript/Reference/Operators">Expressions and operators</a></dt> - <dd>Learn more about the behavior of JavaScript's operators <code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/instanceof">instanceof</a></code>, <code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/typeof">typeof</a></code>, <code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/new">new</a></code>, <code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/this">this</a></code>, the <a href="/en-US/docs/Web/JavaScript/Reference/Operators/Operator_Precedence">operator precedence</a>, and more.</dd> - <dt><a href="/en-US/docs/Web/JavaScript/Reference/Statements">Statements and declarations</a></dt> - <dd>Learn how <code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/do...while">do-while</a></code>, <code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/for...in">for-in</a></code>, <code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/for...of">for-of</a></code>, <code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/try...catch">try-catch</a></code>, <code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/let">let</a></code>, <code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/var">var</a></code>, <code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/const">const</a></code>, <code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/if...else">if-else</a></code>, <code><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/switch">switch</a></code>, and more JavaScript statements and keywords work.</dd> - <dt><a href="/en-US/docs/Web/JavaScript/Reference/Functions">Functions</a></dt> - <dd>Learn how to work with JavaS functions to develop your applications.</dd> -</dl> - -<h2 id="Tools_resources">Tools & resources</h2> - -<p>Helpful tools while writing and debugging your JavaScript code.</p> - -<dl> - <dt><a href="/en-US/docs/Tools">Firefox Developer Tools</a></dt> - <dd><a href="/en-US/docs/Tools/Scratchpad">Scratchpad</a>, <a href="/en-US/docs/Tools/Web_Console">Web Console</a>, <a href="/en-US/docs/Tools/Profiler">JavaScript Profiler</a>, <a href="/en-US/docs/Tools/Debugger">Debugger</a>, and more.</dd> - <dt><a class="external" href="http://www.getfirebug.com/">Firebug</a></dt> - <dd>Edit, debug, and monitor CSS, HTML, and JavaScript live in any web page.</dd> - <dt><a href="/en-US/docs/Web/JavaScript/Shells">JavaScript Shells</a></dt> - <dd>A JavaScript shell allows you to quickly test snippets of JavaScript code.</dd> - <dt><a href="https://togetherjs.com/">TogetherJS</a></dt> - <dd> - <p class="hero-header-text large">Collaboration made easy.</p> - </dd> - <dt><a href="http://stackoverflow.com/questions/tagged/javascript">Stack Overflow</a></dt> - <dd>Stack Overflow questions tagged with "JavaScript".</dd> - <dt><a href="/en-US/docs/Web/JavaScript/New_in_JavaScript">JavaScript versions and release notes</a></dt> - <dd>Browse JavaScript's feature history and implementation status.</dd> -</dl> -</div> -</div> diff --git a/files/my/web/javascript/reference/index.html b/files/my/web/javascript/reference/index.html deleted file mode 100644 index 1345585f85..0000000000 --- a/files/my/web/javascript/reference/index.html +++ /dev/null @@ -1,312 +0,0 @@ ---- -title: JavaScript reference -slug: Web/JavaScript/Reference -tags: - - Code - - ECMAScript - - ECMAScript6 - - ES6 - - JS - - JavaScript - - Landing page - - NeedsTranslation - - Reference - - TopicStub - - es - - 'l10n:priority' - - programming -translation_of: Web/JavaScript/Reference ---- -<div>{{JsSidebar}}</div> - -<p>This part of the JavaScript section on MDN serves as a repository of facts about the JavaScript language. Read more <a href="/en-US/docs/Web/JavaScript/Reference/About">about this reference</a>.</p> - -<h2 id="Built-ins">Built-ins</h2> - -<p><a href="/en-US/docs/Web/JavaScript/Reference/Global_Objects">JavaScript standard built-in objects</a>, along with their methods and properties.</p> - -<ul class="card-grid"> - <li><span>Value properties</span> - - <p>{{JSxRef("Infinity")}}<br> - {{JSxRef("NaN")}}<br> - {{JSxRef("undefined")}}<br> - {{JSxRef("globalThis")}}</p> - </li> - <li><span>Function properties</span> - <p>{{JSxRef("Global_Objects/eval", "eval()")}}<br> - {{JSxRef("Global_Objects/isFinite", "isFinite()")}}<br> - {{JSxRef("Global_Objects/isNaN", "isNaN()")}}<br> - {{JSxRef("Global_Objects/parseFloat", "parseFloat()")}}<br> - {{JSxRef("Global_Objects/parseInt", "parseInt()")}}<br> - {{JSxRef("Global_Objects/decodeURI", "decodeURI()")}}<br> - {{JSxRef("Global_Objects/decodeURIComponent", "decodeURIComponent()")}}<br> - {{JSxRef("Global_Objects/encodeURI", "encodeURI()")}}<br> - {{JSxRef("Global_Objects/encodeURIComponent", "encodeURIComponent()")}}</p> - </li> - <li><span>Fundamental objects</span> - <p>{{JSxRef("Object")}}<br> - {{JSxRef("Function")}}<br> - {{JSxRef("Boolean")}}<br> - {{JSxRef("Symbol")}}</p> - </li> - <li><span>Error objects</span> - <p>{{JSxRef("Error")}}<br> - {{JSxRef("AggregateError")}}<br> - {{JSxRef("EvalError")}}<br> - {{JSxRef("InternalError")}}<br> - {{JSxRef("RangeError")}}<br> - {{JSxRef("ReferenceError")}}<br> - {{JSxRef("SyntaxError")}}<br> - {{JSxRef("TypeError")}}<br> - {{JSxRef("URIError")}}</p> - </li> -</ul> - -<ul class="card-grid"> - <li><span>Numbers & dates</span> - - <p>{{JSxRef("Number")}}<br> - {{JSxRef("BigInt")}}<br> - {{JSxRef("Math")}}<br> - {{JSxRef("Date")}}</p> - </li> - <li><span>Text processing</span> - <p>{{JSxRef("String")}}<br> - {{JSxRef("RegExp")}}</p> - </li> - <li><span>Indexed Collections</span><a href="/en-US/docs/Web/JavaScript/Guide/Numbers_and_dates#Numbers"> </a>{{JSxRef("Array")}}<br> - {{JSxRef("Int8Array")}}<br> - {{JSxRef("Uint8Array")}}<br> - {{JSxRef("Uint8ClampedArray")}}<br> - {{JSxRef("Int16Array")}}<br> - {{JSxRef("Uint16Array")}}<br> - {{JSxRef("Int32Array")}}<br> - {{JSxRef("Uint32Array")}}<br> - {{JSxRef("Float32Array")}}<br> - {{JSxRef("Float64Array")}}<br> - {{JSxRef("BigInt64Array")}}<br> - {{JSxRef("BigUint64Array")}}</li> - <li><span>Keyed collections</span> - <p>{{JSxRef("Map")}}<br> - {{JSxRef("Set")}}<br> - {{JSxRef("WeakMap")}}<br> - {{JSxRef("WeakSet")}}</p> - </li> -</ul> - -<ul class="card-grid"> - <li><span>Structured data</span> - - <p>{{JSxRef("ArrayBuffer")}}<br> - {{JSxRef("SharedArrayBuffer")}}<br> - {{JSxRef("Atomics")}}<br> - {{JSxRef("DataView")}}<br> - {{JSxRef("JSON")}}</p> - </li> - <li><span>Control abstraction</span> - <p>{{JSxRef("Promise")}}<br> - {{JSxRef("Generator")}}<br> - {{JSxRef("GeneratorFunction")}}<br> - {{JSxRef("AsyncFunction")}}</p> - </li> - <li><span>Reflection</span> - <p>{{JSxRef("Reflect")}}<br> - {{JSxRef("Proxy")}}</p> - </li> - <li><span>Internationalization</span> - <p>{{JSxRef("Intl")}}<br> - {{JSxRef("Global_Objects/Intl/Collator", "Intl.Collator")}}<br> - {{JSxRef("Global_Objects/Intl/DateTimeFormat", "Intl.DateTimeFormat")}}<br> - {{JSxRef("Global_Objects/Intl/DisplayNames", "Intl.DisplayNames")}}<br> - {{JSxRef("Global_Objects/Intl/ListFormat", "Intl.ListFormat")}}<br> - {{JSxRef("Global_Objects/Intl/Locale", "Intl.Locale")}}<br> - {{JSxRef("Global_Objects/Intl/NumberFormat", "Intl.NumberFormat")}}<br> - {{JSxRef("Global_Objects/Intl/PluralRules", "Intl.PluralRules")}}<br> - {{JSxRef("Global_Objects/Intl/RelativeTimeFormat", "Intl.RelativeTimeFormat")}}</p> - </li> -</ul> - -<ul class="card-grid"> - <li><span>WebAssembly</span> - - <p>{{JSxRef("WebAssembly")}}<br> - {{JSxRef("WebAssembly.Module")}}<br> - {{JSxRef("WebAssembly.Instance")}}<br> - {{JSxRef("WebAssembly.Memory")}}<br> - {{JSxRef("WebAssembly.Table")}}<br> - {{JSxRef("WebAssembly.CompileError")}}<br> - {{JSxRef("WebAssembly.LinkError")}}<br> - {{JSxRef("WebAssembly.RuntimeError")}}</p> - </li> -</ul> - -<h2 id="Statements">Statements</h2> - -<p><a href="/en-US/docs/Web/JavaScript/Reference/Statements">JavaScript statements and declarations</a></p> - -<ul class="card-grid"> - <li><span>Control flow</span>{{jsxref("Statements/block", "Block")}}<br> - {{jsxref("Statements/break", "break")}}<br> - {{jsxref("Statements/continue", "continue")}}<br> - {{jsxref("Statements/Empty", "Empty")}}<br> - {{jsxref("Statements/if...else", "if...else")}}<br> - {{jsxref("Statements/switch", "switch")}}<br> - {{jsxref("Statements/throw", "throw")}}<br> - {{jsxref("Statements/try...catch", "try...catch")}}</li> - <li><span>Declarations</span> - <p>{{jsxref("Statements/var", "var")}}<br> - {{jsxref("Statements/let", "let")}}<br> - {{jsxref("Statements/const", "const")}}</p> - </li> - <li><span>Functions and classes</span> - <p>{{jsxref("Statements/function", "function")}}<br> - {{jsxref("Statements/function*", "function*")}}<br> - {{jsxref("Statements/async_function", "async function")}}<br> - {{jsxref("Statements/return", "return")}}<br> - {{jsxref("Statements/class", "class")}}</p> - </li> - <li><span>Iterations</span> - <p>{{jsxref("Statements/do...while", "do...while")}}<br> - {{jsxref("Statements/for", "for")}}<br> - {{jsxref("Statements/for_each...in", "for each...in")}}<br> - {{jsxref("Statements/for...in", "for...in")}}<br> - {{jsxref("Statements/for...of", "for...of")}}<br> - {{jsxref("Statements/for-await...of", "for await...of")}}<br> - {{jsxref("Statements/while", "while")}}</p> - </li> -</ul> - -<ul class="card-grid"> - <li><span>Other</span> - - <p>{{jsxref("Statements/debugger", "debugger")}}<br> - {{jsxref("Statements/import", "import")}}<br> - {{jsxref("Statements/label", "label")}}<br> - {{jsxref("Statements/with", "with")}}</p> - </li> -</ul> - -<h2 id="Expressions_and_operators">Expressions and operators</h2> - -<p><a href="/en-US/docs/Web/JavaScript/Reference/Operators">JavaScript expressions and operators</a>. </p> - -<div> -<ul class="card-grid"> - <li><span>Primary expressions</span>{{JSxRef("Operators/this", "this")}}<br> - {{JSxRef("Operators/function", "function")}}<br> - {{JSxRef("Operators/class", "class")}}<br> - {{JSxRef("Operators/function*", "function*")}}<br> - {{JSxRef("Operators/yield", "yield")}}<br> - {{JSxRef("Operators/yield*", "yield*")}}<br> - {{JSxRef("Operators/async_function", "async function")}}<br> - {{JSxRef("Operators/await", "await")}}<br> - {{JSxRef("Global_Objects/Array", "[]")}}<br> - {{JSxRef("Operators/Object_initializer", "{}")}}<br> - {{JSxRef("Global_Objects/RegExp", "/ab+c/i")}}<br> - {{JSxRef("Operators/Grouping", "( )")}}<br> - {{JSxRef("null")}}</li> - <li><span>Left-hand-side expressions</span> - <p>{{JSxRef("Operators/Property_accessors", "Property accessors", "", 1)}}<br> - {{JSxRef("Operators/new", "new")}}<br> - {{JSxRef("Operators/new%2Etarget", "new.target")}}<br> - {{JSxRef("Operators/super", "super")}}<br> - {{JSxRef("Operators/Spread_syntax", "...obj")}}</p> - </li> - <li><span>Increment & decrement</span> - <p>{{JSxRef("Operators/Arithmetic_Operators", "A++", "#Increment")}}<br> - {{JSxRef("Operators/Arithmetic_Operators", "A--", "#Decrement")}}<br> - {{JSxRef("Operators/Arithmetic_Operators", "++A", "#Increment")}}<br> - {{JSxRef("Operators/Arithmetic_Operators", "--A", "#Decrement")}}</p> - </li> - <li><span>Unary operators</span> - <p>{{JSxRef("Operators/delete", "delete")}}<br> - {{JSxRef("Operators/void", "void")}}<br> - {{JSxRef("Operators/typeof", "typeof")}}<br> - {{JSxRef("Operators/Arithmetic_Operators", "+", "#Unary_plus")}}<br> - {{JSxRef("Operators/Arithmetic_Operators", "-", "#Unary_negation")}}<br> - {{JSxRef("Operators/Bitwise_Operators", "~", "#Bitwise_NOT")}}<br> - {{JSxRef("Operators/Logical_Operators", "!", "#Logical_NOT")}}</p> - </li> -</ul> - -<ul class="card-grid"> - <li><span>Arithmetic operators</span> - - <p>{{JSxRef("Operators/Arithmetic_Operators", "+", "#Addition")}}<br> - {{JSxRef("Operators/Arithmetic_Operators", "-", "#Subtraction")}}<br> - {{JSxRef("Operators/Arithmetic_Operators", "/", "#Division")}}<br> - {{JSxRef("Operators/Arithmetic_Operators", "*", "#Multiplication")}}<br> - {{JSxRef("Operators/Arithmetic_Operators", "%", "#Remainder")}}<br> - {{JSxRef("Operators/Arithmetic_Operators", "**", "#Exponentiation")}}</p> - </li> - <li><span>Relational operators</span> - <p>{{JSxRef("Operators/in", "in")}}<br> - {{JSxRef("Operators/instanceof", "instanceof")}}<br> - {{JSxRef("Operators/Comparison_Operators", "<", "#Less_than_operator")}}<br> - {{JSxRef("Operators/Comparison_Operators", ">", "#Greater_than_operator")}}<br> - {{JSxRef("Operators/Comparison_Operators", "<=", "#Less_than_or_equal_operator")}}<br> - {{JSxRef("Operators/Comparison_Operators", ">=", "#Greater_than_or_equal_operator")}}</p> - </li> - <li><span>Equality operators</span> - <p>{{JSxRef("Operators/Comparison_Operators", "==", "#Equality")}}<br> - {{JSxRef("Operators/Comparison_Operators", "!=", "#Inequality")}}<br> - {{JSxRef("Operators/Comparison_Operators", "===", "#Identity")}}<br> - {{JSxRef("Operators/Comparison_Operators", "!==", "#Nonidentity")}}</p> - </li> - <li><span>Bitwise shift operators</span> - <p>{{JSxRef("Operators/Bitwise_Operators", "<<", "#Left_shift")}}<br> - {{JSxRef("Operators/Bitwise_Operators", ">>", "#Right_shift")}}<br> - {{JSxRef("Operators/Bitwise_Operators", ">>>", "#Unsigned_right_shift")}}</p> - </li> -</ul> - -<ul class="card-grid"> - <li><span>Binary bitwise operators</span>{{JSxRef("Operators/Bitwise_Operators", "&", "#Bitwise_AND")}}<br> - {{JSxRef("Operators/Bitwise_Operators", "|", "#Bitwise_OR")}}<br> - {{JSxRef("Operators/Bitwise_Operators", "^", "#Bitwise_XOR")}}</li> - <li><span>Binary logical operators</span> - <p>{{JSxRef("Operators/Logical_Operators", "&&", "#Logical_AND")}}<br> - {{JSxRef("Operators/Logical_Operators", "||", "#Logical_OR")}}</p> - </li> - <li><span>Conditional (ternary) operator</span> - <p>{{JSxRef("Operators/Conditional_Operator", "(condition ? ifTrue : ifFalse)")}}</p> - </li> - <li><span>Assignment operators</span> - <p>{{JSxRef("Operators/Assignment_Operators", "=", "#Assignment")}}<br> - {{JSxRef("Operators/Assignment_Operators", "*=", "#Multiplication_assignment")}}<br> - {{JSxRef("Operators/Assignment_Operators", "/=", "#Division_assignment")}}<br> - {{JSxRef("Operators/Assignment_Operators", "%=", "#Remainder_assignment")}}<br> - {{JSxRef("Operators/Assignment_Operators", "+=", "#Addition_assignment")}}<br> - {{JSxRef("Operators/Assignment_Operators", "-=", "#Subtraction_assignment")}}<br> - {{JSxRef("Operators/Assignment_Operators", "<<=", "#Left_shift_assignment")}}<br> - {{JSxRef("Operators/Assignment_Operators", ">>=", "#Right_shift_assignment")}}<br> - {{JSxRef("Operators/Assignment_Operators", ">>>=", "#Unsigned_right_shift_assignment")}}<br> - {{JSxRef("Operators/Assignment_Operators", "&=", "#Bitwise_AND_assignment")}}<br> - {{JSxRef("Operators/Assignment_Operators", "^=", "#Bitwise_XOR_assignment")}}<br> - {{JSxRef("Operators/Assignment_Operators", "|=", "#Bitwise_OR_assignment")}}<br> - {{JSxRef("Operators/Destructuring_assignment", "[a, b] = [1, 2]")}}<br> - {{JSxRef("Operators/Destructuring_assignment", "{a, b} = {a:1, b:2}")}}</p> - </li> -</ul> -</div> - -<h2 id="Functions">Functions</h2> - -<p>This chapter documents how to work with <a href="/en-US/docs/Web/JavaScript/Reference/Functions">JavaScript functions</a> to develop your applications.</p> - -<ul> - <li><a href="/en-US/docs/Web/JavaScript/Reference/Functions/arguments"><code>arguments</code></a></li> - <li><a href="/en-US/docs/Web/JavaScript/Reference/Functions/Arrow_functions">Arrow functions</a></li> - <li><a href="/en-US/docs/Web/JavaScript/Reference/Functions/Default_parameters">Default parameters</a></li> - <li><a href="/en-US/docs/Web/JavaScript/Reference/Functions/rest_parameters">Rest parameters</a></li> -</ul> - -<h2 id="Additional_reference_pages">Additional reference pages</h2> - -<ul> - <li><a href="/en-US/docs/Web/JavaScript/Reference/Lexical_grammar">Lexical grammar</a></li> - <li><a href="/en-US/docs/Web/JavaScript/Data_structures">Data types and data structures</a></li> - <li><a href="/en-US/docs/Web/JavaScript/Reference/Strict_mode">Strict mode</a></li> - <li><a href="/en-US/docs/Web/JavaScript/Reference/Deprecated_and_obsolete_features">Deprecated features</a></li> -</ul> diff --git a/files/my/web/javascript/reference/statements/function_star_/index.html b/files/my/web/javascript/reference/statements/function_star_/index.html deleted file mode 100644 index 414d5f4d63..0000000000 --- a/files/my/web/javascript/reference/statements/function_star_/index.html +++ /dev/null @@ -1,252 +0,0 @@ ---- -title: function* -slug: Web/JavaScript/Reference/Statements/function* -translation_of: Web/JavaScript/Reference/Statements/function* ---- -<div dir="rtl">{{jsSidebar("Statements")}}</div> - -<p>The <code><strong>function*</strong></code> declaration (<code>function</code> keyword followed by an asterisk) defines a <em>generator function</em>, which returns a {{jsxref("Global_Objects/Generator","Generator")}} object.</p> - -<div>{{EmbedInteractiveExample("pages/js/statement-functionasterisk.html")}}</div> - - - -<p>You can also define generator functions using the {{jsxref("GeneratorFunction")}} constructor, or the function expression syntax.</p> - -<h2 id="Syntax">Syntax</h2> - -<pre class="syntaxbox notranslate">function* <var>name</var>([<var>param</var>[, <var>param</var>[, ... <var>param</var>]]]) { - <var>statements</var> -} -</pre> - -<dl> - <dt><code><var>name</var></code></dt> - <dd>The function name.</dd> - <dt><code><var>param</var></code> {{optional_inline}}</dt> - <dd>The name of a formal parameter for the function.</dd> - <dt><code><var>statements</var></code></dt> - <dd>The statements comprising the body of the function.</dd> -</dl> - -<h2 id="Description">Description</h2> - -<p>Generators are functions that can be exited and later re-entered. Their context (variable bindings) will be saved across re-entrances.</p> - -<p>Generators in JavaScript -- especially when combined with Promises -- are a very powerful tool for asynchronous programming as they mitigate -- if not entirely eliminate -- the problems with callbacks, such as <a href="http://callbackhell.com/">Callback Hell</a> and <a href="https://frontendmasters.com/courses/rethinking-async-js/callback-problems-inversion-of-control/">Inversion of Control</a>. However, an even simpler solution to these problems can be achieved with {{jsxref("Statements/async_function", "async functions")}}.</p> - -<p>Calling a generator function does not execute its body immediately; an <a href="/en-US/docs/Web/JavaScript/Reference/Iteration_protocols#iterator">iterator</a> object for the function is returned instead. When the iterator's <code>next()</code> method is called, the generator function's body is executed until the first {{jsxref("Operators/yield", "yield")}} expression, which specifies the value to be returned from the iterator or, with {{jsxref("Operators/yield*", "yield*")}}, delegates to another generator function. The <code>next()</code> method returns an object with a <code>value</code> property containing the yielded value and a <code>done</code> property which indicates whether the generator has yielded its last value, as a boolean. Calling the <code>next()</code> method with an argument will resume the generator function execution, replacing the <code>yield</code> expression where an execution was paused with the argument from <code>next()</code>.</p> - -<p>A <code>return</code> statement in a generator, when executed, will make the generator finish (i.e. the <code>done</code> property of the object returned by it will be set to <code>true</code>). If a value is returned, it will be set as the <code>value</code> property of the object returned by the generator.<br> - Much like a <code>return</code> statement, an error is thrown inside the generator will make the generator finished -- unless caught within the generator's body.<br> - When a generator is finished, subsequent <code>next()</code> calls will not execute any of that generator's code, they will just return an object of this form: <code>{value: undefined, done: true}</code>.</p> - -<h2 id="Examples">Examples</h2> - -<h3 id="Simple_example">Simple example</h3> - -<pre class="brush: js notranslate">function* idMaker() { - var index = 0; - while (true) - yield index++; -} - -var gen = idMaker(); - -console.log(gen.next().value); // 0 -console.log(gen.next().value); // 1 -console.log(gen.next().value); // 2 -console.log(gen.next().value); // 3 -// ...</pre> - -<h3 id="Example_with_yield*">Example with yield*</h3> - -<pre class="brush: js notranslate">function* anotherGenerator(i) { - yield i + 1; - yield i + 2; - yield i + 3; -} - -function* generator(i) { - yield i; - yield* anotherGenerator(i); - yield i + 10; -} - -var gen = generator(10); - -console.log(gen.next().value); // 10 -console.log(gen.next().value); // 11 -console.log(gen.next().value); // 12 -console.log(gen.next().value); // 13 -console.log(gen.next().value); // 20 -</pre> - -<h3 id="Passing_arguments_into_Generators">Passing arguments into Generators</h3> - -<pre class="brush: js notranslate">function* logGenerator() { - console.log(0); - console.log(1, yield); - console.log(2, yield); - console.log(3, yield); -} - -var gen = logGenerator(); - -// the first call of next executes from the start of the function -// until the first yield statement -gen.next(); // 0 -gen.next('pretzel'); // 1 pretzel -gen.next('california'); // 2 california -gen.next('mayonnaise'); // 3 mayonnaise -</pre> - -<h3 id="Return_statement_in_a_generator">Return statement in a generator</h3> - -<pre class="brush: js notranslate">function* yieldAndReturn() { - yield "Y"; - return "R"; - yield "unreachable"; -} - -var gen = yieldAndReturn() -console.log(gen.next()); // { value: "Y", done: false } -console.log(gen.next()); // { value: "R", done: true } -console.log(gen.next()); // { value: undefined, done: true } -</pre> - -<h3 id="Generator_as_an_object_property">Generator as an object property</h3> - -<pre class="brush: js notranslate">const someObj = { - *generator () { - yield 'a'; - yield 'b'; - } -} - -const gen = someObj.generator() - -console.log(gen.next()); // { value: 'a', done: false } -console.log(gen.next()); // { value: 'b', done: false } -console.log(gen.next()); // { value: undefined, done: true } -</pre> - -<h3 id="Generator_as_an_object_method">Generator as an object method</h3> - -<pre class="brush: js notranslate">class Foo { - *generator () { - yield 1; - yield 2; - yield 3; - } -} - -const f = new Foo (); -const gen = f.generator(); - -console.log(gen.next()); // { value: 1, done: false } -console.log(gen.next()); // { value: 2, done: false } -console.log(gen.next()); // { value: 3, done: false } -console.log(gen.next()); // { value: undefined, done: true } -</pre> - -<h3 id="Generator_as_a_computed_property">Generator as a computed property</h3> - -<pre class="brush: js notranslate">class Foo { - *[Symbol.iterator] () { - yield 1; - yield 2; - } -} - -const SomeObj = { - *[Symbol.iterator] () { - yield 'a'; - yield 'b'; - } -} - -console.log(Array.from(new Foo)); // [ 1, 2 ] -console.log(Array.from(SomeObj)); // [ 'a', 'b' ] -</pre> - -<h3 id="Generators_are_not_constructable">Generators are not constructable</h3> - -<pre class="brush: js notranslate">function* f() {} -var obj = new f; // throws "TypeError: f is not a constructor -</pre> - -<h3 id="Generator_defined_in_an_expression">Generator defined in an expression</h3> - -<pre class="brush: js notranslate">const foo = function* () { - yield 10; - yield 20; -}; - -const bar = foo(); -console.log(bar.next()); // {value: 10, done: false}</pre> - -<h3 id="Generator_example">Generator example</h3> - -<pre class="syntaxbox notranslate">function* powers(n){ - //endless loop to generate - for(let current =n;; current *= n){ - yield current; - } -} - -for(let power of powers(2)){ - //controlling generator - if(power > 32) break; - console.log(power) - //2 - //4 - //8 - //16 - //32 -}</pre> - -<h2 id="Specifications">Specifications</h2> - -<table class="standard-table"> - <thead> - <tr> - <th scope="col">Specification</th> - </tr> - </thead> - <tbody> - <tr> - <td>{{SpecName('ESDraft', '#sec-generator-function-definitions', 'function*')}}</td> - </tr> - </tbody> -</table> - -<h2 id="Browser_compatibility">Browser compatibility</h2> - -<div> - - -<p>{{Compat("javascript.statements.generator_function")}}</p> -</div> - -<h2 id="See_also">See also</h2> - -<ul> - <li>{{jsxref("Operators/function*", "function* expression")}}</li> - <li>{{jsxref("GeneratorFunction")}} object</li> - <li><a href="/en-US/docs/Web/JavaScript/Reference/Iteration_protocols">Iteration protocols</a></li> - <li>{{jsxref("Operators/yield", "yield")}}</li> - <li>{{jsxref("Operators/yield*", "yield*")}}</li> - <li>{{jsxref("Function")}} object</li> - <li>{{jsxref("Statements/function", "function declaration")}}</li> - <li>{{jsxref("Operators/function", "function expression")}}</li> - <li>{{jsxref("Functions_and_function_scope", "Functions and function scope")}}</li> - <li>Other web resources: - <ul> - <li><a href="http://facebook.github.io/regenerator/">Regenerator</a> an ES2015 generator compiler to ES5</li> - <li><a href="http://www.youtube.com/watch?v=qbKWsbJ76-s">Forbes Lindesay: Promises and Generators: control flow utopia -- JSConf EU 2013</a></li> - <li><a href="https://github.com/mozilla/task.js">Task.js</a></li> - <li><a href="https://github.com/getify/You-Dont-Know-JS/blob/1st-ed/async%20%26%20performance/ch4.md#iterating-generators-asynchronously">Iterating generators asynchronously</a></li> - </ul> - </li> -</ul> diff --git a/files/my/web/javascript/reference/statements/index.html b/files/my/web/javascript/reference/statements/index.html deleted file mode 100644 index b5f4f3d5e0..0000000000 --- a/files/my/web/javascript/reference/statements/index.html +++ /dev/null @@ -1,130 +0,0 @@ ---- -title: Statements and declarations -slug: Web/JavaScript/Reference/Statements -tags: - - JavaScript - - Landing page - - NeedsTranslation - - Reference - - TopicStub - - statements -translation_of: Web/JavaScript/Reference/Statements ---- -<div>{{jsSidebar("Statements")}}</div> - -<p>JavaScript applications consist of statements with an appropriate syntax. A single statement may span multiple lines. Multiple statements may occur on a single line if each statement is separated by a semicolon. This isn't a keyword, but a group of keywords.</p> - -<h2 id="Statements_and_declarations_by_category">Statements and declarations by category</h2> - -<p>For an alphabetical listing see the sidebar on the left.</p> - -<h3 id="Control_flow">Control flow</h3> - -<dl> - <dt>{{jsxref("Statements/block", "Block")}}</dt> - <dd>A block statement is used to group zero or more statements. The block is delimited by a pair of curly brackets.</dd> - <dt>{{jsxref("Statements/break", "break")}}</dt> - <dd>Terminates the current loop, switch, or label statement and transfers program control to the statement following the terminated statement.</dd> - <dt>{{jsxref("Statements/continue", "continue")}}</dt> - <dd>Terminates execution of the statements in the current iteration of the current or labeled loop, and continues execution of the loop with the next iteration.</dd> - <dt>{{jsxref("Statements/Empty", "Empty")}}</dt> - <dd>An empty statement is used to provide no statement, although the JavaScript syntax would expect one.</dd> - <dt>{{jsxref("Statements/if...else", "if...else")}}</dt> - <dd>Executes a statement if a specified condition is true. If the condition is false, another statement can be executed.</dd> - <dt>{{jsxref("Statements/switch", "switch")}}</dt> - <dd>Evaluates an expression, matching the expression's value to a case clause, and executes statements associated with that case.</dd> - <dt>{{jsxref("Statements/throw", "throw")}}</dt> - <dd>Throws a user-defined exception.</dd> - <dt>{{jsxref("Statements/try...catch", "try...catch")}}</dt> - <dd>Marks a block of statements to try, and specifies a response, should an exception be thrown.</dd> -</dl> - -<h3 id="Declarations">Declarations</h3> - -<dl> - <dt>{{jsxref("Statements/var", "var")}}</dt> - <dd>Declares a variable, optionally initializing it to a value.</dd> - <dt>{{jsxref("Statements/let", "let")}}</dt> - <dd>Declares a block scope local variable, optionally initializing it to a value.</dd> - <dt>{{jsxref("Statements/const", "const")}}</dt> - <dd>Declares a read-only named constant.</dd> -</dl> - -<h3 id="Functions_and_classes">Functions and classes</h3> - -<dl> - <dt>{{jsxref("Statements/function", "function")}}</dt> - <dd>Declares a function with the specified parameters.</dd> - <dt>{{jsxref("Statements/function*", "function*")}}</dt> - <dd>Generator Functions enable writing <a href="/en-US/docs/Web/JavaScript/Guide/The_Iterator_protocol">iterators</a> more easily.</dd> - <dt>{{jsxref("Statements/async_function", "async function")}}</dt> - <dd>Declares an async function with the specified parameters.</dd> - <dt>{{jsxref("Statements/return", "return")}}</dt> - <dd>Specifies the value to be returned by a function.</dd> - <dt>{{jsxref("Statements/class", "class")}}</dt> - <dd>Declares a class.</dd> -</dl> - -<h3 id="Iterations">Iterations</h3> - -<dl> - <dt>{{jsxref("Statements/do...while", "do...while")}}</dt> - <dd>Creates a loop that executes a specified statement until the test condition evaluates to false. The condition is evaluated after executing the statement, resulting in the specified statement executing at least once.</dd> - <dt>{{jsxref("Statements/for", "for")}}</dt> - <dd>Creates a loop that consists of three optional expressions, enclosed in parentheses and separated by semicolons, followed by a statement executed in the loop.</dd> - <dt>{{jsxref("Statements/for_each...in", "for each...in")}} </dt> - <dd>Iterates a specified variable over all values of object's properties. For each distinct property, a specified statement is executed.</dd> - <dt>{{jsxref("Statements/for...in", "for...in")}}</dt> - <dd>Iterates over the enumerable properties of an object, in arbitrary order. For each distinct property, statements can be executed.</dd> - <dt>{{jsxref("Statements/for...of", "for...of")}}</dt> - <dd>Iterates over iterable objects (including {{jsxref("Global_Objects/Array","arrays","","true")}}, array-like objects, <a href="/en-US/docs/JavaScript/Guide/Iterators_and_Generators">iterators and generators</a>), invoking a custom iteration hook with statements to be executed for the value of each distinct property.</dd> - <dt>{{jsxref("Statements/for-await...of", "for await...of")}}</dt> - <dd>Iterates over async iterable objects, array-like objects, <a href="/en-US/docs/JavaScript/Guide/Iterators_and_Generators">iterators and generators</a>, invoking a custom iteration hook with statements to be executed for the value of each distinct property.</dd> - <dt>{{jsxref("Statements/while", "while")}}</dt> - <dd>Creates a loop that executes a specified statement as long as the test condition evaluates to true. The condition is evaluated before executing the statement.</dd> -</dl> - -<h3 id="Others">Others</h3> - -<dl> - <dt>{{jsxref("Statements/debugger", "debugger")}}</dt> - <dd>Invokes any available debugging functionality. If no debugging functionality is available, this statement has no effect.</dd> - <dt>{{jsxref("Statements/export", "export")}}</dt> - <dd>Used to export functions to make them available for imports in external modules, and other scripts.</dd> - <dt>{{jsxref("Statements/import", "import")}}</dt> - <dd>Used to import functions exported from an external module, another script.</dd> - <dt><a href="/en-US/docs/Web/JavaScript/Reference/Statements/import.meta"><code>import.meta</code></a></dt> - <dd>An object exposing context-specific metadata to a JavaScript module.</dd> - <dt>{{jsxref("Statements/label", "label")}}</dt> - <dd>Provides a statement with an identifier that you can refer to using a <code>break</code> or <code>continue</code> statement.</dd> -</dl> - -<dl> - <dt>{{jsxref("Statements/with", "with")}} </dt> - <dd>Extends the scope chain for a statement.</dd> -</dl> - -<h2 id="Specifications">Specifications</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Specification</th> - </tr> - <tr> - <td>{{SpecName('ESDraft', '#sec-ecmascript-language-statements-and-declarations', 'ECMAScript Language: Statements and Declarations')}}</td> - </tr> - </tbody> -</table> - -<h2 id="Browser_compatibility">Browser compatibility</h2> - - - -<p>{{Compat("javascript.statements")}}</p> - -<h2 id="See_also">See also</h2> - -<ul> - <li><a href="/en-US/docs/Web/JavaScript/Reference/Operators">Operators</a></li> -</ul> |