Skip to content

Commit aabaddd

Browse files
frxncismorfrxncismor
frxncismor
authored and
frxncismor
committed
docs(docs-infra): translate component-styles.md
Translate the following topics: - Special selectors - :host - :host-context - (deprecated) /deep/, >>> and ::ng-deep Fix angular-hispano#334
1 parent 72ca465 commit aabaddd

File tree

1 file changed

+33
-44
lines changed

1 file changed

+33
-44
lines changed

Diff for: aio/content/guide/component-styles.md

+33-44
Original file line numberDiff line numberDiff line change
@@ -1,22 +1,22 @@
11
# Estilos de componentes
22

3-
Las aplicaciones de Angular son estilizadas con CSS estandar. Esto significa que puedes aplicar todo lo que sabes sobre hojas de estilo CSS, selectores, reglas y media queries directamente a las aplicaciones de Angular.
3+
Las aplicaciones de Angular son estilizadas con CSS estandar. Esto significa que usted puede aplicar todo lo que sabe sobre hojas de estilo CSS, selectores, reglas y media queries directamente a las aplicaciones de Angular.
44

55
Adicionalmente, Angular puede agrupar _estilos de componentes_ con componentes,
66
permitiendo un diseño mas modular que las hojas de estilo regulares.
77

88
Esta página describe como cargar y aplicar estos estilos de componentes.
99

10-
Puedes ejecutar el <live-example></live-example> en Stackblitz y descargar el codigo desde ahí.
10+
Puede ejecutar el <live-example></live-example> en Stackblitz y descargar el codigo desde ahí.
1111

1212
## Usando estilos de componentes
1313

14-
Para cada componente Angular que escribes, puedes definir no solo una plantilla HTML, sino también los estilos CSS que van con esa plantilla,
15-
especificando los selectores, reglas y media queries que necesites.
14+
Para cada componente Angular que escribe, puede definir no solo una plantilla HTML, sino también los estilos CSS que van con esa plantilla,
15+
especificando los selectores, reglas y media queries que necesite.
1616

1717
Una forma de hacer esto es estableciendo la propiedad `styles` en la metadata del componente.
1818
La propiedad `styles` toma un array de strings que contiene el codigo CSS.
19-
Usualmente tu le das una cadena de caracteres, como en el siguiente ejemplo:
19+
Usualmente usted le da una cadena de caracteres, como en el siguiente ejemplo:
2020

2121
<code-example path="component-styles/src/app/hero-app.component.ts" header="src/app/hero-app.component.ts"></code-example>
2222

@@ -35,91 +35,80 @@ no al `HeroMainComponent` anidado ni a las etiquetas `<h1>` en cualquier otro lu
3535

3636
Esta restricción de alcance es una **_característica modular de estilo_**.
3737

38-
- Puedes utilizar los selectores nombres de clase CSS que tengan más sentido en el contexto de cada componente.
38+
- Puede utilizar los selectores nombres de clase CSS que tengan más sentido en el contexto de cada componente.
3939

4040
- Los nombres de clase y los selectores son locales del componente y no chocan con
4141
clases y selectores utilizados en otras partes de la aplicación.
4242

4343
- Los cambios de estilos en otras partes de la aplicación no afectan los estilos del componente.
4444

45-
- Puedes ubicar el código CSS de cada componente con el código TypeScript y HTML del componente,
45+
- Puede ubicar el código CSS de cada componente con el código TypeScript y HTML del componente,
4646
lo que conduce a una estructura de proyecto ordenada y limpa.
4747

48-
- Puedes cambiar o eliminar el código CSS del componente sin buscar en el
48+
- Puede cambiar o eliminar el código CSS del componente sin buscar en el
4949
toda la aplicación para encontrar en dónde más se usa el código.
5050

5151
{@a special-selectors}
5252

5353
## Selectores especiales
5454

55-
Component styles have a few special _selectors_ from the world of shadow DOM style scoping
56-
(described in the [CSS Scoping Module Level 1](https://www.w3.org/TR/css-scoping-1) page on the
57-
[W3C](https://www.w3.org) site).
58-
The following sections describe these selectors.
55+
Los estilos de componentes tienen algunos _selectores_ especiales del mundo del alcance de estilos DOM de sombra (Shadow DOM)
56+
(descritos en la página [CSS Scoping Module Level 1](https://www.w3.org/TR/css-scoping-1) en el sitio [W3C](https://www.w3.org))
5957

58+
Las siguientes secciones describen estos selectores.
6059
### :host
6160

62-
Use the `:host` pseudo-class selector to target styles in the element that _hosts_ the component (as opposed to
63-
targeting elements _inside_ the component's template).
61+
Utilice el selector de pseudo clase `:host` para seleccionar estilos en el elemento que _aloja_ el componente (opuesto a los elementos seleccionados _dentro_ de la plantilla del componente).
6462

6563
<code-example path="component-styles/src/app/hero-details.component.css" region="host" header="src/app/hero-details.component.css"></code-example>
6664

67-
The `:host` selector is the only way to target the host element. You can't reach
68-
the host element from inside the component with other selectors because it's not part of the
69-
component's own template. The host element is in a parent component's template.
65+
El selector `:host` es la unica manera de seleccionar el elemento anfitrión. No puede alcanzar el elemento anfitrión desde adentro del componente con otros selectores porque no es parte de la propia plantilla del componente. El elemento anfitrión está en la plantilla de un componente principal.
7066

71-
Use the _function form_ to apply host styles conditionally by
72-
including another selector inside parentheses after `:host`.
67+
Utilice el _formulario de función_ para aplicar estilos de anfitrión condicionalmente incluyendo otro selector entre paréntesis después de `:host`
7368

74-
The next example targets the host element again, but only when it also has the `active` CSS class.
69+
El siguiente ejemplo selecciona el elemento anfitrión otra vez, pero solo cuando también tiene la clase CSS `active`.
7570

7671
<code-example path="component-styles/src/app/hero-details.component.css" region="hostfunction" header="src/app/hero-details.component.css"></code-example>
7772

7873
### :host-context
7974

80-
Sometimes it's useful to apply styles based on some condition _outside_ of a component's view.
81-
For example, a CSS theme class could be applied to the document `<body>` element, and
82-
you want to change how your component looks based on that.
75+
A veces es útil aplicar estilos basados en una condición _fuera_ de la vista de un componente.
76+
Por ejemplo, una clase de tema CSS puede ser aplicada al elemento del documento `<body>`, y usted quiere cambiar como su componente se ve en base a eso.
8377

84-
Use the `:host-context()` pseudo-class selector, which works just like the function
85-
form of `:host()`. The `:host-context()` selector looks for a CSS class in any ancestor of the component host element,
86-
up to the document root. The `:host-context()` selector is useful when combined with another selector.
78+
Utilice el selector de la pseudo-clase `:host-context()`, el cual trabaja como la función de forma de `:host()`. El selector `:host-context()` busca una clase CSS en cualquier antepasado del elemento host del componente,
79+
hasta la raíz del documento. El selector `: host-context ()` es útil cuando se combina con otro selector.
8780

88-
The following example applies a `background-color` style to all `<h2>` elements _inside_ the component, only
89-
if some ancestor element has the CSS class `theme-light`.
81+
El siguiente ejemplo aplica un estilo `background-color` a todos los elementos `<h2>` _dentro_ del componente, solo si algún elemento ancestro tiene la clase CSS `theme-light`.
9082

9183
<code-example path="component-styles/src/app/hero-details.component.css" region="hostcontext" header="src/app/hero-details.component.css"></code-example>
9284

93-
### (deprecated) `/deep/`, `>>>`, and `::ng-deep`
85+
### (obsoleto) `/deep/`, `>>>`, and `::ng-deep`
9486

95-
Component styles normally apply only to the HTML in the component's own template.
87+
Los estilos de componentes normalmente aplican solo al HTML en la propia plantilla del componente.
9688

97-
Applying the `::ng-deep` pseudo-class to any CSS rule completely disables view-encapsulation for
98-
that rule. Any style with `::ng-deep` applied becomes a global style. In order to scope the specified style
99-
to the current component and all its descendants, be sure to include the `:host` selector before
100-
`::ng-deep`. If the `::ng-deep` combinator is used without the `:host` pseudo-class selector, the style
101-
can bleed into other components.
89+
La acplicación de la pseudo-clase `::ng-deep` a cualquier regla de CSS deshabilita completamente la encapsulación de vistas para esa regla. Cualquier estilo con `::ng-deep` aplicado se convierte en un estilo global. Para alcanzar el estilo especificado al componente actual y todos sus descendientes, asegúrese de incluir el selector `:host` antes de `::ng-deep`. Si el combinador `:: ng-deep` se usa sin el selector de pseudoclase`: host`, el estilo puede salirse a otros componentes.
10290

103-
The following example targets all `<h3>` elements, from the host element down
104-
through this component to all of its child elements in the DOM.
91+
El siguiente ejemplo apunta a todos los elementos `<h3>`, desde el elemento host hacia abajo
92+
a través de este componente a todos sus elementos hijos en el DOM.
10593

10694
<code-example path="component-styles/src/app/hero-details.component.css" region="deep" header="src/app/hero-details.component.css"></code-example>
10795

108-
The `/deep/` combinator also has the aliases `>>>`, and `::ng-deep`.
96+
El combinador `/deep/` también tiene los alias `>>>` y `:: ng-deep`.
10997

11098
<div class="alert is-important">
11199

112-
Use `/deep/`, `>>>` and `::ng-deep` only with _emulated_ view encapsulation.
113-
Emulated is the default and most commonly used view encapsulation. For more information, see the
114-
[Controlling view encapsulation](guide/component-styles#view-encapsulation) section.
100+
Utilice `/deep/`, `>>>` y `::ng-deep` solo con la encapsulación de vista _emulada_.
101+
102+
Emulada es la encapsulación de vista predeterminada y más utilizada. Para obtener más información, consulte la sección [Controlar la encapsulación de vistas](guide/component-styles#view-encapsulation)
115103

116104
</div>
117105

118106
<div class="alert is-important">
119107

120-
The shadow-piercing descendant combinator is deprecated and [support is being removed from major browsers](https://www.chromestatus.com/features/6750456638341120) and tools.
121-
As such we plan to drop support in Angular (for all 3 of `/deep/`, `>>>` and `::ng-deep`).
122-
Until then `::ng-deep` should be preferred for a broader compatibility with the tools.
108+
El combinador descendiente que perfora las sombras está en desuso y se está eliminando el [soporte de los principales navegadores](https://www.chromestatus.com/features/6750456638341120) y herramientas.
109+
110+
Como tal, planeamos eliminar el soporte en Angular (para los 3 de `/ deep /`, `>>>` y `:: ng-deep`).
111+
Hasta entonces, se debería preferir `:: ng-deep` para una compatibilidad más amplia con las herramientas.
123112

124113
</div>
125114

0 commit comments

Comments
 (0)