Update documentation to customize components

This commit is contained in:
Javi Martín
2024-08-30 15:25:08 +02:00
parent 7a1f78ddf3
commit 19e12d9053
2 changed files with 8 additions and 4 deletions

View File

@@ -1,4 +1,4 @@
# Components
# Customizing components
For components, customization can be used to change both the logic (included in a `.rb` file) and the view (included in a `.erb` file). If you only want to customize the logic for, let's say, the `Admin::TableActionsComponent`, create a file named `app/components/custom/admin/table_actions_component.rb` with the following content:
@@ -10,6 +10,8 @@ class Admin::TableActionsComponent
end
```
Check the [models customization](models.md) section for more information about customizing Ruby classes.
If, on the other hand, you also want to customize the view, you need a small modification. Instead of the previous code, use:
```ruby
@@ -22,4 +24,4 @@ class Admin::TableActionsComponent
end
```
This will make the component use the view in `app/components/custom/admin/table_actions_component.html.erb`. You can create this file and customize it to your needs.
This will make the component use the view in `app/components/custom/admin/table_actions_component.html.erb`. You can create this file and customize it to your needs, the same way you can [customize views](views.md).

View File

@@ -1,4 +1,4 @@
# Componentes
# Personalización de componentes
En el caso de los componentes, la personalización puede utilizarse para cambiar tanto la lógica (incluida en un archivo `.rb`) como la vista (incluida en un archivo `.erb`). Si solo quieres personalizar la lógica, por ejemplo del componente `Admin::TableActionsComponent`, crea el archivo `app/components/custom/admin/table_actions_component.rb` con el siguiente contenido:
@@ -10,6 +10,8 @@ class Admin::TableActionsComponent
end
```
Consulta la sección de [personalización de modelos](models.md) para más información sobre personalizar clases de Ruby.
Si, por el contrario, también quieres personalizar la vista, necesitas una pequeña modificación. En lugar del código anterior, utiliza:
```ruby
@@ -22,4 +24,4 @@ class Admin::TableActionsComponent
end
```
Esto hará que el componente utilice la vista en `app/components/custom/admin/table_actions_component.html.erb`. Puedes crear este archivo y personalizarlo según tus necesidades.
Esto hará que el componente utilice la vista en `app/components/custom/admin/table_actions_component.html.erb`. Puedes crear este archivo y personalizarlo según tus necesidades, de la misma manera en que puedes [personalizar vistas](views.md).