Merge pull request #41 from Iconica-Development/update-component-documentation-workflow-correct

Add component-documentation.yml correct
This commit is contained in:
Freek van de Ven 2024-02-13 16:35:04 +01:00 committed by GitHub
commit 9a55bbb410
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
5 changed files with 31 additions and 17 deletions

View file

@ -0,0 +1,14 @@
name: Iconica Standard Component Documentation Workflow
# Workflow Caller version: 1.0.0
on:
release:
types: [published]
workflow_dispatch:
jobs:
call-iconica-component-documentation-workflow:
uses: Iconica-Development/.github/.github/workflows/component-documentation.yml@master
secrets: inherit
permissions: write-all

View file

@ -66,16 +66,16 @@ abstract class FlutterFormInputWidget<T> extends StatelessWidget {
/// },
/// ```
///
/// [checkPageDescription] is the same as checkPageTitle but for the
/// [checkPageDescription] is the same as checkPageTitle but for the
/// description. If null no description will be shown.
///
/// [onChanged] can be set to get the value whenever the user changes it.
/// [onChanged] can be set to get the value whenever the user changes it.
/// Should not be used to save the value.
///
/// [onSubmit] can be set to get the value whenever the user submits it.
/// [onSubmit] can be set to get the value whenever the user submits it.
/// Should not be used to save the value.
///
/// [onSaved] goes of when the save function is called for the page if
/// [onSaved] goes of when the save function is called for the page if
/// [onValidate] return null.
///
/// [onValidate] is used to validate the given input by the user.
@ -83,14 +83,14 @@ abstract class FlutterFormInputController<T> {
/// The [id] determines the key in the [Map] returned by the [FlutterForm].
String? id;
/// [value] is a way to set a initial value and will be the value when
/// [value] is a way to set a initial value and will be the value when
/// change by the user.
T? value;
/// [mandatory] determines if the input is mandatory.
bool mandatory = false;
/// [checkPageTitle] is a function where you can transform the value from the
/// [checkPageTitle] is a function where you can transform the value from the
/// input into something representable.
/// This value will be given when defining the check page widgets.
/// If this function is not set, the value will be used as is.
@ -102,20 +102,20 @@ abstract class FlutterFormInputController<T> {
/// ```
String Function(T? value)? checkPageTitle;
/// [checkPageDescription] is the same as checkPageTitle but for the
/// [checkPageDescription] is the same as checkPageTitle but for the
/// description.
/// If null no description will be shown.
String Function(T? value)? checkPageDescription;
/// [onChanged] can be set to get the value whenever the user changes it.
/// [onChanged] can be set to get the value whenever the user changes it.
/// Should not be used to save the value.
void Function(T? value)? onChanged;
/// [onSubmit] can be set to get the value whenever the user submits it.
/// [onSubmit] can be set to get the value whenever the user submits it.
/// Should not be used to save the value.
void Function(T? value)? onSubmit;
/// [onSaved] goes of when the save function is called for the page if
/// [onSaved] goes of when the save function is called for the page if
/// [onValidate] return null.
void onSaved(T? value);

View file

@ -42,7 +42,7 @@ class FlutterFormInputCarousel extends FlutterFormInputWidget<int> {
}
}
/// Controller for the carousel used by a [FlutterFormInputWidget] used in
/// Controller for the carousel used by a [FlutterFormInputWidget] used in
/// a [FlutterForm].
///
/// Mainly used by [FlutterFormInputCarousel].

View file

@ -64,7 +64,7 @@ class FlutterFormInputDateTime extends FlutterFormInputWidget<String> {
}
}
/// Controller for dates used by a [FlutterFormInputWidget] used in a
/// Controller for dates used by a [FlutterFormInputWidget] used in a
/// [FlutterForm].
///
/// Mainly used by [FlutterFormInputDateTime].

View file

@ -62,7 +62,7 @@ class FlutterFormPage {
}
/// [CheckPage] is used to set a check page at the end of a [FlutterForm].
/// A [CheckPage] is a page where the user can check all input values before
/// A [CheckPage] is a page where the user can check all input values before
/// commiting.
///
/// [title] is the widget shown at the top of the page.
@ -71,15 +71,15 @@ class FlutterFormPage {
///
/// [inputCheckWidget] determines how every input is represented on the page.
/// [title] is the value given in the input.
/// This input can be modified by setting the [checkPageTitle] of that input
/// This input can be modified by setting the [checkPageTitle] of that input
/// controller.
///
/// Same for the [description] but if the description is not set in the input
/// Same for the [description] but if the description is not set in the input
/// controller no description will be given.
///
/// [onPressed] can be set so that when the user triggers it the user will be
/// [onPressed] can be set so that when the user triggers it the user will be
/// sent back to the page including the input.
/// Here the user can modify the input and save it. Afterwards the user will be
/// Here the user can modify the input and save it. Afterwards the user will be
/// sent back to the check page.
class CheckPage {
const CheckPage({