|
1748 | 1748 | ### Рекомендации для именований
|
1749 | 1749 | ###### [Style [Y120](#style-y120)]
|
1750 | 1750 |
|
1751 |
| - - Используйте постоянные принципы именований для всех компонентов по шаблону, который описывает особенность(feature) компонента, а затем (опционально) его тип. Я рекомендую шаблон - `feature.type.js`. Существует два типа имен для большинства случаев: |
| 1751 | + - Используйте согласованные имена для всех компонентов по шаблону, который описывает особенность(feature) компонента, а затем (опционально) его тип. Я рекомендую шаблон - `feature.type.js`. Существует два типа имен для большинства случаев: |
1752 | 1752 | * имя файла (`avengers.controller.js`)
|
1753 | 1753 | * имя компонента, которое зарегистрировано Angular (`AvengersController`)
|
1754 | 1754 |
|
1755 | 1755 | *Почему?*: Соглашения об именованиях дает постояннный надежный способ поиска содержимого быстрым беглым взглядом. Согласованность в проекте жизненно важна. Согласованность в команде очень важна. Согласованность между компаниями дает огромную эффективность.
|
1756 | 1756 |
|
1757 | 1757 | *Почему?*: Соглашения об именованиях просто должны помочь найти вам свой код быстрее, и сделать его проще для понимания.
|
1758 |
| -### Feature File Names |
| 1758 | +### Характерные Имена Файлов |
1759 | 1759 | ###### [Style [Y121](#style-y121)]
|
1760 | 1760 |
|
1761 |
| - - Use consistent names for all components following a pattern that describes the component's feature then (optionally) its type. My recommended pattern is `feature.type.js`. |
| 1761 | + - Используйте согласованные имена для всех компонентов используя шаблон, который описывает компонентную особенность, затем опционально его тип. Я рекомендую шаблон - `feature.type.js`. |
1762 | 1762 |
|
1763 |
| - *Why?*: Provides a consistent way to quickly identify components. |
| 1763 | + *Почему?*: Это надежный способ для быстрой идентификации компонентов. |
1764 | 1764 |
|
1765 |
| - *Why?*: Provides pattern matching for any automated tasks. |
| 1765 | + *Почему?*: Автоматизирует рабочий процесс. |
1766 | 1766 |
|
1767 | 1767 | ```javascript
|
1768 | 1768 | /**
|
1769 |
| - * common options |
| 1769 | + * общие настройки |
1770 | 1770 | */
|
1771 | 1771 |
|
1772 |
| - // Controllers |
| 1772 | + // Контроллеры |
1773 | 1773 | avengers.js
|
1774 | 1774 | avengers.controller.js
|
1775 | 1775 | avengersController.js
|
1776 | 1776 |
|
1777 |
| - // Services/Factories |
| 1777 | + // Сервисы/Фабрики |
1778 | 1778 | logger.js
|
1779 | 1779 | logger.service.js
|
1780 | 1780 | loggerService.js
|
1781 | 1781 | ```
|
1782 | 1782 |
|
1783 | 1783 | ```javascript
|
1784 | 1784 | /**
|
1785 |
| - * recommended |
| 1785 | + * рекомендовано |
1786 | 1786 | */
|
1787 | 1787 |
|
1788 |
| - // controllers |
| 1788 | + // контроллеры |
1789 | 1789 | avengers.controller.js
|
1790 | 1790 | avengers.controller.spec.js
|
1791 | 1791 |
|
1792 |
| - // services/factories |
| 1792 | + // сервисы/фабрики |
1793 | 1793 | logger.service.js
|
1794 | 1794 | logger.service.spec.js
|
1795 | 1795 |
|
1796 |
| - // constants |
| 1796 | + // константы |
1797 | 1797 | constants.js
|
1798 | 1798 |
|
1799 |
| - // module definition |
| 1799 | + // определение модуля |
1800 | 1800 | avengers.module.js
|
1801 | 1801 |
|
1802 |
| - // routes |
| 1802 | + // маршруты |
1803 | 1803 | avengers.routes.js
|
1804 | 1804 | avengers.routes.spec.js
|
1805 | 1805 |
|
1806 |
| - // configuration |
| 1806 | + // конфигурация |
1807 | 1807 | avengers.config.js
|
1808 | 1808 |
|
1809 |
| - // directives |
| 1809 | + // директивы |
1810 | 1810 | avenger-profile.directive.js
|
1811 | 1811 | avenger-profile.directive.spec.js
|
1812 | 1812 | ```
|
1813 | 1813 |
|
1814 |
| - Note: Another common convention is naming controller files without the word `controller` in the file name such as `avengers.js` instead of `avengers.controller.js`. All other conventions still hold using a suffix of the type. Controllers are the most common type of component so this just saves typing and is still easily identifiable. I recommend you choose 1 convention and be consistent for your team. |
1815 |
| -
|
| 1814 | + Замечание: Другим общим соглашением является именование файлов контроллера без слова `controller`, например называем файл `avengers.js` вместо `avengers.controller.js`. Все остальные соглашения все же должны содержать суффикс типа. Просто контроллеры наиболее общий тип компонетов, и таким образом мы экономим на время на печатании имени, но контроллеры все равно прекрасно идентифицируются. Я рекомендую выбрать один тип соглашения и быть на одной волне со своей командой. |
| 1815 | + |
1816 | 1816 | ```javascript
|
1817 | 1817 | /**
|
1818 |
| - * recommended |
| 1818 | + * рекомендовано |
1819 | 1819 | */
|
1820 | 1820 | // Controllers
|
1821 | 1821 | avengers.js
|
1822 | 1822 | avengers.spec.js
|
1823 | 1823 | ```
|
1824 | 1824 |
|
1825 |
| -### Test File Names |
| 1825 | +### Имена Тестовых Файлов |
1826 | 1826 | ###### [Style [Y122](#style-y122)]
|
1827 | 1827 |
|
1828 | 1828 | - Name test specifications similar to the component they test with a suffix of `spec`.
|
|
0 commit comments