Skip to content

Commit d522673

Browse files
AlexAlex
authored andcommitted
Update README.md
1 parent 8c091f5 commit d522673

File tree

1 file changed

+21
-21
lines changed

1 file changed

+21
-21
lines changed

README.md

Lines changed: 21 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -39,7 +39,7 @@
3939

4040
<h3 id="selectors">Селекторы</h3>
4141

42-
В объявлении правил, "селекторы", это части которые определяют к какому элементу DOM дерева будут применены правила стилей. Селекторы могут соответствовать HTML элементу, а так-же классу элемента, ID или любому другому атрибуту этого элемента. Вот несколько примеров:
42+
В объявлении правил "селекторы" - это части, которые определяют, к какому элементу DOM дерева будут применены правила стилей. Селекторы могут соответствовать HTML элементу, а также классу элемента, ID или любому другому атрибуту этого элемента. Вот несколько примеров:
4343

4444

4545
```css
@@ -54,7 +54,7 @@
5454

5555
<h3 id="properties">Свойства</h3>
5656

57-
И наконец свойства, которые придают выбранным элементам их стиль. Свойства объявляются в виде пары "ключ-значение" и объявления правил могут содержать одно или несколько свойств. Объявление свойств может выглядеть так:
57+
И, наконец, свойства, которые придают выбранным элементам их стиль. Свойства объявляются в виде пары "ключ-значение", объявления правил могут содержать одно или несколько свойств. Объявление свойств может выглядеть так:
5858

5959

6060
```css
@@ -68,14 +68,14 @@
6868

6969
<h3 id="formatting">Форматирование</h3>
7070

71-
* Используйте 2 пробела для отступов.
71+
* Используйте 2 пробела для отступа.
7272
* Предпочитайте подчеркивание CamelCase'у в именах классов.
7373
- Подчеркивания и PascalCasing допустимы, если вы используете БЭМ (смотри [Объектно-ориентированный CSS и БЭМ](#oocss-and-bem) далее)
7474
* Не используйте селекторы по ID.
75-
* Используя несколько селекторов в объявлении правила, переносите каждый селектор на отдельную строку.
75+
* Используя несколько селекторов в объявлении правила переносите каждый селектор на отдельную строку.
7676
<!--* Ставьте пробел перед открывающей скобкой `{`.
7777
* В свойствах ставьте пробел после двоеточия `:`, но не перед.
78-
* После объявления свойстав переносите закрывающую скобку `}` на новую строку.
78+
* После объявления свойства переносите закрывающую скобку `}` на новую строку.
7979
* Делайте отступ в одну строку между объявлениями правил.
8080
8181
**Плохо**
@@ -109,7 +109,7 @@
109109
110110
<h3 id="comments">Комментарии</h3>
111111
112-
* Предпочитайте однострочные (`//`) комментарии многострочным .
112+
* Предпочитайте однострочные (`//`) комментарии многострочным.
113113
* Рекомендуется писать комментарии в отдельные строки. Старайтесь избегать комментариев в конце строки.
114114
* Write detailed comments for code that isn't self-documenting:
115115
* Пишите детальные комментарии для незадокументированных частей кода:
@@ -126,15 +126,15 @@
126126
* Способствует созданию масштабируемых таблиц стилей.
127127
128128
129-
**OOCSS**, или "Объектно-ориентированный CSS", это подход к написанию CSS, который призывает думать о таблице стилей, как о коллекции "объектов": многоразовых, повторяемых фрагментах кода, которые могут использоваться независимо друг от друга на всём сайте.
129+
**OOCSS**, или "Объектно-ориентированный CSS" - это подход к написанию CSS, который призывает думать о таблице стилей как о коллекции "объектов": многоразовых, повторяемых фрагментах кода, которые могут использоваться независимо друг от друга на всём сайте.
130130
* Nicole Sullivan [OOCSS вики](https://github.com/stubbornella/oocss/wiki)
131131
* Smashing Magazine [Введение в Объектно-ориентированный CSS](http://www.smashingmagazine.com/2011/12/12/an-introduction-to-object-oriented-css-oocss/)
132132
133-
**БЭМ**, или "Блок-Элемент-Модификатор", это соглашение об именовании классов в HTML и CSS. Разработано Яндексом с прицелом на большие объёмы кода и масштабируемость. Может послужить как солидный набор правил для использования OOCSS.
133+
**БЭМ**, или "Блок-Элемент-Модификатор" - это соглашение об именовании классов в HTML и CSS. Разработано Яндексом с прицелом на большие объёмы кода и масштабируемость. Может послужить как солидный набор правил для использования OOCSS.
134134
* CSS Trick's [БЭМ 101](https://css-tricks.com/bem-101/)
135135
* Harry Roberts [Введение в БЭМ](http://csswizardry.com/2013/01/mindbemding-getting-your-head-round-bem-syntax/)
136136
137-
Мы рекомендуем вариант БЭМ в котором используется PascalCased "блоки", отлично работающие в связке с компонентами (например React).
137+
Мы рекомендуем вариант БЭМ, в котором используются PascalCased "блоки", отлично работающие в связке с компонентами (например React).
138138
Подчеркивания и тире по-прежнему используются для модификаторов и элементов.
139139
**Примеры**
140140
@@ -164,19 +164,19 @@ function ListingCard() {
164164
```
165165
166166
* `.ListingCard` является "блоком" и представляет родительский компонент
167-
* `.ListingCard__title` является "элементом" и представляет дочерний компонент `.ListingCard` который позволяет составить блок в целом.
167+
* `.ListingCard__title` является "элементом" и представляет дочерний компонент `.ListingCard`, который позволяет составить блок в целом.
168168
* `.ListingCard--featured` является "модификатором" и представляет разные состояния `.ListingCard`.
169169
170170
<h3 id="id-selectors">Селекторы по ID</h3>
171171
172-
Возможность выбирать элементы по ID в CSS является, как правило, плохой практикой. ID селекторы предоставляют неоправданно высокий уровень специфичности и невозможность многоразового использования.
172+
Возможность выбирать элементы по ID в CSS является, как правило, плохой практикой. ID селекторы предоставляют неоправданно высокий уровень специфичности и невозможность многоразового использования.
173173
Более подробная информация по этому вопросу: [Статья CSS Wizardry](http://csswizardry.com/2014/07/hacks-for-dealing-with-specificity/)
174174
175175
<h3 id="javascript-hooks">JavaScript хуки</h3>
176176
177-
Избегайте использования одинаковых имён классов в CSS и JavaScript. Использование одинаковых имён классов может привести, как минимум, к трате времени при рефакторинге, и как максимум к боязне разработчика сломать функционал вводом изменений.
177+
Избегайте использования одинаковых имён классов в CSS и JavaScript. Использование одинаковых имён классов может привести, как минимум, к потере времени при рефакторинге, и как максимум к боязне разработчика сломать функционал вводом изменений.
178178
179-
Мы реккомендуем создавать отдельные имена классов для JavaScript используя префикс `.js-`:
179+
Мы рекомендуем создавать отдельные имена классов для JavaScript используя префикс `.js-`:
180180
181181
```html
182182
<button class="btn btn-primary js-request-to-book">Request to Book</button>
@@ -206,7 +206,7 @@ Use `0` instead of `none` to specify that a style has no border.
206206
207207
<h3 id="syntax">Синтаксис</h3>
208208
209-
* Всегда используйте `.scss` синтаксис, и никогда, оригинальный `.sass` синтаксис.
209+
* Всегда используйте `.scss` синтаксис, и никогда оригинальный `.sass` синтаксис.
210210
* Упорядочивайте обычный CSS и `@include`-объявления логически.
211211
212212
<h3 id="ordering-of-property-declarations">Порядок объявления свойств</h3>
@@ -239,7 +239,7 @@ Use `0` instead of `none` to specify that a style has no border.
239239
3. Вложенные селекторы
240240
241241
Nested selectors, _if necessary_, go last, and nothing goes after them. Add whitespace between your rule declarations and nested selectors, as well as between adjacent nested selectors. Apply the same guidelines as above to your nested selectors.
242-
Вложенные селекторы, _если необходимо_, идут последними, и ничего не должно быть после них. Добавьте пробел между объявлением правила и вложенным селектором, а так-же между смежными вложенными селекторами. Применяйте эти принципы, к вашим вложенным селекторам.
242+
Вложенные селекторы, _если необходимо_, идут последними, и ничего не должно идти после них. Добавьте пробел между объявлением правила и вложенным селектором, а также между смежными вложенными селекторами. Применяйте эти принципы, к вашим вложенным селекторам.
243243
244244
```scss
245245
.btn {
@@ -256,19 +256,19 @@ Use `0` instead of `none` to specify that a style has no border.
256256
<h3 id="variables">Переменные</h3>
257257
258258
Prefer dash-cased variable names (e.g. `$my-variable`) over camelCased or snake_cased variable names. It is acceptable to prefix variable names that are intended to be used only within the same file with an underscore (e.g. `$_my-variable`).
259-
Отдавайте предпочтение именам переменных разделенных тире (например `$my-variable`). Допускается использование подчеркивания в виде префикса для имён которые будут использоваться в пределах одного файла (например `$_my-variable`).
259+
Отдавайте предпочтение именам переменных разделенных тире (например `$my-variable`). Допускается использование подчеркивания в виде префикса для имён, которые будут использоваться в пределах одного файла (например `$_my-variable`).
260260
261261
262262
<h3 id="mixins">Миксины</h3>
263263
264264
Mixins should be used to DRY up your code, add clarity, or abstract complexity--in much the same way as well-named functions. Mixins that accept no arguments can be useful for this, but note that if you are not compressing your payload (e.g. gzip), this may contribute to unnecessary code duplication in the resulting styles.
265-
Миксины должны использоваться для поддержания чистоты и ясности кода, или абстрактной сложности, во многом так же, как и хорошо названные функции. Миксины не принимающие никаких аргументов могут быть полезны для этого, но нужно иметь в виду что если вы не сжимаете свои файлы (например gzip), это может привести к лишнему повторению кода.
265+
Миксины должны использоваться для поддержания чистоты и ясности кода, или абстрактной сложности, во многом так же, как и хорошо названные функции. Миксины, не принимающие никаких аргументов, могут быть полезны для этого. Но нужно иметь в виду, что если вы не сжимаете свои файлы (например gzip), это может привести к лишнему повторению кода.
266266
267267
268268
<h3 id="extend-directive">Extend directive допилить</h3>
269269
270270
`@extend` should be avoided because it has unintuitive and potentially dangerous behavior, especially when used with nested selectors. Even extending top-level placeholder selectors can cause problems if the order of selectors ends up changing later (e.g. if they are in other files and the order the files are loaded shifts). Gzipping should handle most of the savings you would have gained by using `@extend`, and you can DRY up your stylesheets nicely with mixins.
271-
Использование `@extend` необходимо избегать из-за его неинтуитивного поведения и потенциальной опасности в поведение, особенно при использование вместе с вложенными селекторами. Даже *допилить* селекторов верхнего уровня может создать проблемы, если в будущем будет изменён порядок селекторов. Сжатие должно обрабатывать большую часть сбережений вы получили бы с помощью *допилить*.
271+
Использование `@extend` необходимо избегать из-за его неинтуитивности и потенциальной опасности в поведении, особенно при использование вместе со вложенными селекторами. Даже *допилить* селекторов верхнего уровня может создать проблемы, если в будущем будет изменён порядок селекторов. Сжатие должно обрабатывать большую часть сбережений вы получили бы с помощью *допилить*.
272272
273273
274274
### Вложенные селекторы
@@ -288,7 +288,7 @@ Mixins should be used to DRY up your code, add clarity, or abstract complexity--
288288
```
289289
290290
When selectors become this long, you're likely writing CSS that is:
291-
Когда селекторы становятся слишком длинными, скорее всего вы пишите CSS который:
291+
Когда селекторы становятся слишком длинными, скорее всего вы пишете CSS, который:
292292
293293
* Strongly coupled to the HTML (fragile) *—OR—*
294294
* Слишком сильно привязан к HTML (хрупкий) *—OR—*
@@ -301,12 +301,12 @@ When selectors become this long, you're likely writing CSS that is:
301301
Again: **never nest ID selectors!**
302302
И вновь: **никогда не используйте ID селекторы!**
303303
If you must use an ID selector in the first place (and you should really try not to), they should never be nested. If you find yourself doing this, you need to revisit your markup, or figure out why such strong specificity is needed. If you are writing well formed HTML and CSS, you should **never** need to do this.
304-
Если вы должны использовать ID селектор (вы действительно должно постараться этого не делать), он никогда не должен быть вложен. Если вы обнаружили это в своём коде, вам нужно пересмотреть разметку, или выяснить, почему нужна такая сильная специфика. Если вы пишете хорошо сформированные HTML и CSS, вы **никогда** не должны делать это.
304+
Если вы должны использовать ID селектор (вы действительно должно постараться этого не делать), он никогда не должен быть вложенным. Если вы обнаружили это в своём коде - вам нужно пересмотреть разметку или выяснить, почему нужна такая сильная специфика. Если вы пишете хорошо сформированные HTML и CSS, вы **никогда** не должны делать это.
305305
306306
307307
<h2 id="translations">Переводы</h2>
308308
309309
This style guide is also available in other languages:
310-
Этот гид по стилю так-же доступен в других языках:
310+
Этот гид по стилю также доступен в других языках:
311311
312312
- ![cn](https://raw.githubusercontent.com/gosquared/flags/master/flags/flags/shiny/24/China.png) **Chinese (Simplified)**: [Zhangjd/css-style-guide](https://github.com/Zhangjd/css-style-guide)

0 commit comments

Comments
 (0)