Documentation

Dynamic iFrame

© 2010-2011 Hugo PEREIRA - FLUIID

Dynamic iFrame is licensed under the terms of the MIT Opensource License

Author: Hugo PEREIRA - FLUIID
Last update: 2011.09.13
Version: 1.7
Required concrete version: 5.2

English documentation

Dynamic iFrame is a concrete block, it can be used as a standard iFrame or like an iFrame that can automatically adjust its height to the height of the iFrame page, this only works if the page refers to a page that’s on the same domain.

Dynamic height limitation

To use the dynamic height, the iFrame URL should be sharing the same domain as the parent page like “/blog/index.php”, this because it’s impossible to access to properties of a page that’s on another domain.

Field list

URL (required)

Refer to another domain

Note that if you’re want to refer to another domain, the URL field should must contain the full address including http like “http://www.google.com” and the “Dynamic height” field must be “No”.

Refer to the same domain

When you want to refer to the same domain as the parent page, for example to display a Wordpress blog, use the following syntax “/link/to/page.php”. Be careful, you can not access to http://blog.mydomain.com/ from http://www.mydomain.com/index.php, there is not considered to be on the same domain.

Id (required)

Id of the iFrame.

Width (required)

Width of the iFrame, generally equal to “100%”, otherwise you can put the value in pixels egg.: “123px”.

Dynamic Height

When “Dynamic Height” is activated “Yes“ and when the user clicks on a link within the iFrame, the iFrame height is automatically recalculated.

If the URL field is not on the same domain, “Dynamic Height” must be “No”.

 

Force Dynamic Height

When “Dynamic Height” is activated “Yes“ and doesn't work, use Force Dynamic Height. This option parse all html element and get the height of the bigger element in the page.

Error Height (optional)

 

When “Dynamic Height” is activated if the control show URL is not on the same domain, you can set the default height instead of show the alert.

If the URL field is not on the same domain, “Dynamic Height” must be “No”.

Adjust Height (optional)

Enabled only if “Dynamic Height” is “Yes”. You can add or subtract a value to the iFrame calculated height, egg.: “10” or “-10”.

Height (optional)

Height in pixel of the iFrame. Enabled only if “Dynamic Height” is “No”.

Use GET query string from parent

If activated, automatically use the GET query string of the parent page.

Frame Border

Show or hide frame border.

Align

iFrame horizontal position (left, right or center).

Scrolling

Show or hide iFrame scrollbar.

Set to “Auto” to let the browser automacially show a scrollbar if necessary, “No” to never show a scrollbar or “Yes” to always show a scrollbar.

Margin Width (optional)

Horizontal margin.

Margin Height (optional)

Vertical margin.

Documentation en français

Dynamic Iframe est un contrôle IFrame, il peut être utilisé de comme un contrôle IFrame standard ou peut ajuster automatiquement sa hauteur, ceci uniquement si il fait référence à une page qui est dans le même domaine.

Limitation pour la hauteur automatique

Il ne peut ajuster sa hauteur que si il fait référence à une page du même domaine, ceci à cause des paramètres de sécurité des navigateur (ex.: url=/blog/index.php). Il est impossible d’accéder aux propriétés d’une page qui est sur un autre domaine.

Liste des champs

URL (obligatoire)

Faire référence à un autre domain

Noter que si vous faites référence à un autre domaine, le champ URL doit contenir l’adresse complète en incluant http, par exemple “http://www.google.com” et la valeur du champ “Dynamic height” doit être égale à “Non”.

Référence au même domaine

Quand vous faites référence aux même domaine, par exemple pour afficher un blog Worpress, utiliser la syntaxe suivante “/link/to/page.php”. Attention, vous ne pouvez pas accéder à “http://blog.mydomain.com/” depuis “http://www.mydomain.com/index.php”, cela n’est pas considéré comme le même domaine.

Id (obligatoire)

Identification de l’élément iFrame.

Largeur (obligatoire)

Largeur de l’iFrame, généralement égal à “100%”, sinon vous pouvez mettre la valeur en pixels ex.: “123px”.

Dynamic Height

Si “Dynamic Height” est activé et qui l’utilisateur clique sur un lien à l’intérieur de l’iFrame la hauteur du contrôle iFrame est automatiquement recalculer.

Si URL n’est pas sur le même domaine, “Dynamic Height» doit être «Non».

 

Force Dynamic Height

Si “Dynamic Height” ne fonctionne pas utiliser cette option, elle prend l'élément qui à la plus grande hauteur de toute la page.

 

Error Height (facultatif)

Si “Dynamic Height” est activé et que le navigateur affiche une erreur de domain, vous pouvez remplacer cette erreur avec une hauteur par defaut en remplissant ce champ.

Si URL n’est pas sur le même domaine, “Dynamic Height» doit être «Non».

Adjust Height (facultatif)

Activé uniquement si “Dynamic Height” est “Oui”. Vous pouvez ajouter ou soustraire une valeur à la hauteur calculée ex.: “10” ou “-10”.

Hauteur (facultatif)

Hauteur en pixel. Activé uniquement si “Dynamic Height” est “Non”.

Use GET query string from parent

Si il est activeé, prent automatiquement la QUERY STRING de la page parente.

Frame Border

Affiche ou masque la bordure de l’élément iFrame.

Align

Position horizontale de l’iFrame (gauche, droite ou centré).

Scrolling

Afficher ou masquer la barre de défilement de l’iFrame. Réglez sur “Auto” pour laisser le navigateur choisir automatiquement si elle doit être affichée, “Non” pour ne jamais l’afficher ou «Oui» pour toujours l’afficher.

Margin Width (facultatif)

Marge horizontale.

Margin Height (facultatif)

Marge verticale.