IU-DATA

iOS Switch

1 - Presentation & features

This add-on based on the famous iOS switch allows you to add style and fluid animation to the ergonomics of the radio buttons in your FileMaker solutions!

Simply made with a web viewer, it is possible to configure the web viewer completely independently with a simple copy and paste. Responsive, the size is determined by the size of the web viewer.

Features :

2 - Installation / Configuration / Parameters

2.1 Automatic

To make it quicker and easier for you, IU-DATA provides a small FileMaker solution beside each add-ons that directly install the add-on inside the right directory of your computer.

  1. Run the file

  2. Click on Instal the Add-on

  3. In FileMaker Pro, open the solution in which you want to add the Add-On

  4. In layout mode, open the left side panel on the Add-ons tab, click on the add button  

  5. Under the IU-DATA category, select iOS Switch then click on Choose  

  6. Drag and drop the iOS Switch add-on on the layout

2.2 Manual

  1. Close FileMaker Pro

  2. Copy the IUD_iOSSwitch folder to the following directory :

     - macOs : ~/Library/Application Support/FileMaker/Extensions/AddonModules/
 - Windows : AppData\Local\FileMaker\Extensions\AddonModules\

  3. In FileMaker Pro, open the solution in which you want to add the Add-On

  4. In layout mode, open the left side panel on the Add-ons tab, click on the add button  

  5. Under the IU-DATA category, select iOS Switch then click on Choose  

  6. Drag and drop the iOS Switch add-on on the layout

2.3 Configuration

The add-on can work without any context thanks by using the global field IUD_iOSSwitch::gct_WV_FinalCode.

  1. Copy and paste the web viewer containing the add-on calculation formula on the desired model.

  2. Modify the _fieldName parameter in the web viewer calculation, to specify the field that will receive the color code.

  3. Modify the other parameters.

Example of code associated with the web viewer :

Let (
[
_fieldName = GetFieldName ( "**Copiez votre rubrique cible ici**" ) ;
_valueList = "0¶1" ;
_1stValue_Color = "#F1F1F1";
_2ndValue_Color = "#8ce196" ;
_showLabel = 0 ;
_background_Color = "#FFFFFF" ;
_orientation = "horizontal";
_verticalTextOrientation = "";

_fieldValue = GetField ( _fieldName ) ;

_1stValue_FontColor = IUDATA_DarkenColorHEX ( _1stValue_Color ; 100 );
_2ndValue_FontColor = IUDATA_DarkenColorHEX ( _2ndValue_Color ; 100 );
_1stValue = GetValue ( _valueList ; 1 ) ; 
_2ndValue = GetValue ( _valueList ; 2 ) ;
_1stValue_Label = Case ( _showLabel ; _1stValue ; "" ) ;
_2ndValue_Label = Case ( _showLabel ; _2ndValue ; "" ) ;  

_isChecked = Case ( 
	_fieldValue = _1stValue ; "0" ; 
	_fieldValue = _2ndValue ; "1" ; 
	"0"
);

_jsTab = "['" & _1stValue & "','" & _2ndValue & "']";

_Code = z_IUD_IOSSWITCH::gct_WV_FinalCode ;

_FinalCode = Substitute ( _Code ; 

				[ "{{fieldName}}" ; _fieldName ];
				[ "{{isChecked}}" ; _isChecked ];
				[ "{{listValue}}" ; _jsTab ] ;
				[ "{{leftValue}}" ; _1stValue_Label ] ;
				[ "{{rightValue}}" ; _2ndValue_Label ];

				[ "{{color1}}" ; _1stValue_Color ] ;
				[ "{{color2}}" ; _2ndValue_Color ];
				[ "{{fontColor1}}" ; _1stValue_FontColor ];
				[ "{{fontColor2}}" ; _2ndValue_FontColor ]; 

				[ "{{orientation}}" ; _orientation ];
				[ "{{vertical-text-orientation}}" ; _verticalTextOrientation ];

				[ "{{background_Color}}" ; _background_Color ] 
			)	
]
;
	Case (
		Get ( SystemPlatform )  = 4 ;
		"data:text/html;base64," & Base64EncodeRFC ( 4648 ; _FinalCode ) ;
		"data:text/html;charset=utf-8,¶" & _FinalCode

	)
)

Please note : If your database on which you want to install the add-on is hosted with FileMaker Server. You might need to refresh the globale calculation field IUD_iOSSwitch::gct_WV_FinalCode. Otherwise the webviewer that contains the add-on will remain empty. To refresh this field, you can set the field IUD_iOSSwitch::WV_HTML by it's own value inside a script that is launch at the start of your application.

2.2 Parameters

Editable parameter values :

⚠️   if you modify the names of the parameters, you will have to report your modifications to _finalCode if necessary

⚠️   Parameters not to be modified :

3 - Tables / Scripts / Custom functions / Value lists

3.1 - Tables

3.2 - Scripts

3.3 - Custom functions

Descriptions of the following functions can be found in their calculation definition.

3.4 - Value lists

No value list in this add-on.

4 - Dependencies

No dependencie in this add-on.

5 - Compatibility

Operating systems :

FileMaker :

FileMaker WebDirect :

Please note that on FileMaker Go 19 Switch activation inside the web viewer require a double tap.

6 - End User Licence Agreement

Important Note: Please read this EULA carefully. Downloading, installing, using or modifying this add-on signifies that the end user and their organization accept this EULA.

Definitions :

Contract terms :
IU-DATA authorizes the end user and his organization or household to use, modify, copy the add-on at their convenience. IU-DATA authorizes the end user and his organization to use for commercial purposes the add-on, when the add-on is an integral part of a solution whose spectrum of use is much wider than that defined by the functionalities of the add-on alone. On the other hand, IU-DATA does not authorize the end user and his organization to use for commercial or distribution purposes the add-on, modified or not as a final product.

The end user and his organization / household have free assistance for a period of 2 months from the date of purchase of this add-on, for any questions related to the use and configuration of this add-on.
Full access to FileMaker sources as well as to the source code used in the web viewer gives to the end user and his organization / household full control over modifying this add-on. It is therefore natural that we cannot intervene free of charge on the add-on whose code has been altered compared to the original version that IU-DATA delivered. Likewise, IU-DATA cannot be held responsible for any malfunction of any libraries mentioned in paragraph 4 - Dependencies, as well as malfunctions of the add-on following use on an operating system or a FileMaker platform other than those mentioned in paragraph 5 - Compatibility.

Contact :
For any questions, please contact us to this address: product@iu-data.com

7 - Credits

Creation and development :

Icon design :

8 - Change Log

01/01/2022 - iOS Switch v2.0.0 - Add orientation and vertical text orientation parameters and Webdirect compatibilty
16/02/2021 - iOS Switch v1.0.0 - 1st release


© IU-DATA 2022