Download the PHP package martin1982/mfconditionalfieldsbundle without Composer
On this page you can find all versions of the php package martin1982/mfconditionalfieldsbundle. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download martin1982/mfconditionalfieldsbundle
More information about martin1982/mfconditionalfieldsbundle
Files in martin1982/mfconditionalfieldsbundle
Package mfconditionalfieldsbundle
Short Description Symfony MF Conditional Fields bundle
License MIT
Informations about the package mfconditionalfieldsbundle
Prerequisites
Make sure you load the mf-conditional fields JS library in your
project on the pages where you use conditional fields. You can either use script or module, currently
the script is executed when mfConditionalFields
is available in the global namespace.
If you use a bundler (like Webpack), make sure to implement form initialization.
Example;
Installation
Make sure Composer is installed globally, as explained in the installation chapter of the Composer documentation.
Applications that use Symfony Flex
Open a command console, enter your project directory and execute:
Applications that don't use Symfony Flex
Step 1: Download the Bundle
Open a command console, enter your project directory and execute the following command to download the latest stable version of this bundle:
Step 2: Enable the Bundle
Then, enable the bundle by adding it to the list of registered bundles
in the config/bundles.php
file of your project:
Step 3: Enable the form theme
When using Twig you can initialize a form with conditional fields using a form_theme
setting in your twig config:
Usage
On your FormType class implement the ConditionalRulesInterface
for easy access to all options. When adding a field
using the FormBuilder you can make a field dependent by providing the conditional_options
option.
The following options are available:
Name | Type | Description |
---|---|---|
container | String | The container for the given action |
action | String | The action that needs to be performed when the rules apply |
logic | String | OR when only one condition needs to be met, AND when all need to be met |
rules | Array | Array of rules to check, with at least 1 rule |
The rules consist of these options:
Name | Type | Description |
---|---|---|
name | String | Field name to check |
operator | String | Operator used to check field |
value | String | Expected value for the rule to apply |
Example
In this example the code from the Symfony documentation is used to select if someone is attending. In addition, it'll show a reason text element when a user selects 'Maybe' as an option.
Future releases / Contribute
This bundle includes a basic implementation. If you would like to contribute all options of the mf-conditional-fields bundle can be added.
Special thanks
Special thanks to Ali Khallad for creating this JavaScript library.
All versions of mfconditionalfieldsbundle with dependencies
symfony/config Version ^7.0
symfony/dependency-injection Version ^7.0
symfony/form Version ^7.0
symfony/http-kernel Version ^7.0