initial commit

1 files changed, 128 insertions, 0 deletions

diff --git a/files/pl/web/html/element/section/index.html b/files/pl/web/html/element/section/index.html
new file mode 100644
index 0000000000..4985fba6d6
--- /dev/null
+++ b/files/pl/web/html/element/section/index.html
@@ -0,0 +1,128 @@
+---
+title: <section>
+slug: Web/HTML/Element/section
+translation_of: Web/HTML/Element/section
+---
+<p>{{HTMLRef}}</p>
+
+<p>Element <strong><code>&lt;section&gt;</code> </strong>stanowi samodzielną sekcję tworzącą dokument HTML, której nie można przedstawić za pomocą bardziej szczegółowej semantycznie sekcji. Element &lt;section&gt; zazwyczaj posiada nagłówek.</p>
+
+<p>Przykładowo, część nawigacyjna powinna być objęta elementem {{htmlelement("nav")}}, ale lista wyników wyszukiwania albo wyświetlana mapa i jej sterowanie nie mają dla siebie szczegółowego elementu, więc powinny zostać umieszczone w <code>&lt;section&gt;</code>.</p>
+
+<table class="properties">
+ <tbody>
+  <tr>
+   <th scope="row"><a href="/en-US/docs/Web/HTML/Content_categories">Content categories</a></th>
+   <td><a href="/en-US/docs/Web/HTML/Content_categories#Flow_content">Flow content</a>, <a href="/en-US/docs/Web/HTML/Content_categories#Sectioning_content">Sectioning content</a>, palpable content.</td>
+  </tr>
+  <tr>
+   <th scope="row">Permitted content</th>
+   <td><a href="/en-US/docs/Web/HTML/Content_categories#Flow_content">Flow content</a>.</td>
+  </tr>
+  <tr>
+   <th scope="row">Tag omission</th>
+   <td>{{no_tag_omission}}</td>
+  </tr>
+  <tr>
+   <th scope="row">Permitted parents</th>
+   <td>Any element that accepts <a href="/en-US/docs/Web/HTML/Content_categories#Flow_content">flow content</a>. Note that a {{HTMLElement("section")}} element must not be a descendant of an {{HTMLElement("address")}} element.</td>
+  </tr>
+  <tr>
+   <th scope="row">Permitted ARIA roles</th>
+   <td>{{ARIARole("alert")}}, {{ARIARole("alertdialog")}}, {{ARIARole("application")}}, {{ARIARole("banner")}}, {{ARIARole("complementary")}}, {{ARIARole("contentinfo")}}, {{ARIARole("dialog")}}, {{ARIARole("document")}}, {{ARIARole("feed")}}, {{ARIARole("log")}}, {{ARIARole("main")}}, {{ARIARole("marquee")}}, {{ARIARole("navigation")}}, {{ARIARole("search")}}, {{ARIARole("status")}}, {{ARIARole("tabpanel")}}</td>
+  </tr>
+  <tr>
+   <th scope="row">DOM interface</th>
+   <td>{{domxref("HTMLElement")}}</td>
+  </tr>
+ </tbody>
+</table>
+
+<h2 id="Atrybuty">Atrybuty</h2>
+
+<p>Element zawiera tylko <a href="/en-US/docs/Web/HTML/Global_attributes">global attributes</a>.</p>
+
+<h2 id="Użycie">Użycie</h2>
+
+<ul>
+ <li>Każdy element <code>&lt;section&gt;</code> powinien zazwyczaj zawierać nagłówek ({{HTMLElement('h1')}}-{{HTMLElement('h6')}}) jako element potomny <code>&lt;section&gt;</code>.</li>
+ <li>Jeśli jest konieczne oddzielić podgrupy w treści elementu {{HTMLElement("section")}},  używa się elementów{{HTMLElement("article")}}.</li>
+ <li>Nie używa się elementu {{HTMLElement("section")}} w celu stworzenia ogólnego kontenera; do tego służy element {{HTMLElement("div")}}, szczególnie nie robi się tego jesli ma to służyć tylko do nadania stylów. Praktyczną zasadą jest to, że wsytąpeinie elementu &lt;section&gt; powinną być logiczne w schemacie dokumentu.</li>
+</ul>
+
+<h2 id="Przykład_1">Przykład 1</h2>
+
+<h3 id="Wcześniej">Wcześniej</h3>
+
+<pre class="brush: html">&lt;div&gt;
+  &lt;h1&gt;Heading&lt;/h1&gt;
+  &lt;p&gt;Bunch of awesome content&lt;/p&gt;
+&lt;/div&gt;</pre>
+
+<h3 id="Teraz">Teraz</h3>
+
+<pre class="brush: html">&lt;section&gt;
+  &lt;h1&gt;Heading&lt;/h1&gt;
+  &lt;p&gt;Bunch of awesome content&lt;/p&gt;
+&lt;/section&gt;
+</pre>
+
+<h2 id="Przykład_2">Przykład 2</h2>
+
+<h3 id="Wcześniej_2">Wcześniej</h3>
+
+<pre class="brush: html">&lt;div&gt;
+  &lt;h2&gt;Heading&lt;/h2&gt;
+  &lt;img src="bird.jpg" alt="bird"&gt;
+&lt;/div&gt;
+</pre>
+
+<h3 id="Teraz_2">Teraz</h3>
+
+<pre class="brush: html">&lt;section&gt;
+  &lt;h2&gt;Heading&lt;/h2&gt;
+  &lt;img src="bird.jpg" alt="bird"&gt;
+&lt;/section&gt;
+</pre>
+
+<h2 id="Specyfikacje">Specyfikacje</h2>
+
+<table class="standard-table">
+ <thead>
+  <tr>
+   <th scope="col">Specification</th>
+   <th scope="col">Status</th>
+   <th scope="col">Comments</th>
+  </tr>
+ </thead>
+ <tbody>
+  <tr>
+   <td>{{SpecName('HTML WHATWG', 'sections.html#the-section-element', '&lt;section&gt;')}}</td>
+   <td>{{Spec2('HTML WHATWG')}}</td>
+   <td> </td>
+  </tr>
+  <tr>
+   <td>{{SpecName('HTML5.1', 'sections.html#the-section-element', '&lt;section&gt;')}}</td>
+   <td>{{Spec2('HTML5.1')}}</td>
+   <td> </td>
+  </tr>
+  <tr>
+   <td>{{SpecName('HTML5 W3C', 'sections.html#the-section-element', '&lt;section&gt;')}}</td>
+   <td>{{Spec2('HTML5 W3C')}}</td>
+   <td> </td>
+  </tr>
+ </tbody>
+</table>
+
+<h2 id="Zgodność_z_przeglądarkami">Zgodność z przeglądarkami</h2>
+
+
+
+<p>{{Compat("html.elements.section")}}</p>
+
+<h2 id="Zobacz_również">Zobacz również</h2>
+
+<ul>
+ <li>Inne elementy dotyczące sekcji: {{HTMLElement("body")}}, {{HTMLElement("nav")}}, {{HTMLElement("article")}}, {{HTMLElement("aside")}}, {{HTMLElement("h1")}}, {{HTMLElement("h2")}}, {{HTMLElement("h3")}}, {{HTMLElement("h4")}}, {{HTMLElement("h5")}}, {{HTMLElement("h6")}}, {{HTMLElement("hgroup")}}, {{HTMLElement("header")}}, {{HTMLElement("footer")}}, {{HTMLElement("address")}};</li>
+ <li><a href="/en-US/docs/Sections_and_Outlines_of_an_HTML5_document">Sections and outlines of an HTML5 document</a>.</li>
+</ul>